If you're intending to publish a library with external dependencies, you should also include the runtime as a dependency:
npm install @messageformat/runtime
Usage
npx messageformat [options] [input]
input should consist of one or more files or directories, unless defined in a configuration file.
Directories are recursively scanned for .json, .json5, .yaml, .yml and .properties files.
With multiple input files, shared parts of the start of their paths are dropped out of the generated module's structure.
Options
In addition to defining options on the command line, options may also be set in the "messageformat" object in your package.json file, or in a messageformat.rc.{js,json,yaml} configuration file, using the long-form option names as keys.
Input files and directories may also be given as an "include" array in a configuration file.
Command-line options override configuration files.
Option
Short
Description
delimiters
-d
Set of characters by which the file path is split into output object. Default value is ._/\.
extensions
-e
Array or comma-separated list of file extensions to parse as source files. Default: ['.json', '.json5', '.yaml', '.yml', '.properties']
locale=lc
-l
The locale(s) lc to include; if multiple, first is default and others are selected by matching message key. If not set or empty, path keys matching any locale code will set the active locale, starting with a default en locale.
options
Options to pass to the MessageFormat constructor via its second argument. On the command line, use dot-notation to set values, e.g. --options.currency=EUR. For custom formatters, string values will be require()'d based on the current working directory.
outfile=of
-o
Write output to the file . If unspecified or , prints to stdout.
Examples
With messages/strings.json, compile it into an ES module using the default English locale:
With messages/en.json and messages/fr.json, combine both into an ES module, with the default export's top-level keys en and fr containing functions that each use the correct language's pluralization rules:
Simplify the output object structure, by dropping intermediate keys when those keys are shared across all objects at that level, in addition to the default filtering-out of shared keys at the root of the object.