fluent-transpiler

Transpile Fluent (ftl) files into optimized, tree-shakable, JavaScript EcmaScript Modules (esm).

Install

1npm i -D fluent-transpiler

CLI

1Usage: ftl [options] <input>
2
3Compile Fluent (.ftl) files to JavaScript (.js or .mjs)
4
5Arguments:
6  input                                   Path to the Fluent file to compile
7
8Options:
9  --locale <locale...>                    What locale(s) to be used. Multiple can be set to allow for fallback. i.e. en-CA
10  --comments                              Include comments in output file.
11  --variable-notation <variableNotation>  What variable notation to use with exports (choices: "camelCase", "pascalCase", "constantCase",
12                                          "snakeCase", default: "camelCase")
13  --disable-minify                        If disabled, all exported messages will have the same interface `(params) => ({value, attributes})`.
14  --use-isolating                         Wrap placeable with \u2068 and \u2069.
15  -o, --output <output>                   Path to store the resulting JavaScript file. Will be in ESM.
16  -h, --help                              display help for command

NodeJS

Option	Description
locale	What locale(s) to be used. Multiple can be set to allow for fallback. i.e. en-CA
comments	Include comments in output file. Default: true
disableMinify	If disabled, all exported messages will have the same interface (params) => ({value, attributes}). Default: each exported message could be a different type based on what is needed to generate the message (string, object, () => '', () => ({}))
errorOnJunk	Throw error when Junk is parsed. Default: true
variableNotation	What variable notation to use with exports. Default: camelCase
useIsolating	Wrap placeable with \u2068 and \u2069. Default: false
exportDefault	Allows the overwriting of the export default to allow for custom uses. Default: See code

1import { readFile, writeFile } from 'node:fs/promises'
2import fluentTranspiler from 'fluent-transpiler'
3
4const ftl = await readFile('./path/to/en.ftl', { encoding: 'utf8' })
5const js = fluentTranspiler(ftl, { locale: 'en-CA' })
6await writeFile('./path/to/en.mjs', js, 'utf8')