@formatjs/cli-lib 5.0.3

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2021 FormatJS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# @formatjs/cli
+
+We've migrated the docs to https://formatjs.io/docs/tooling/cli.

package/index.d.ts

@@ -0,0 +1,8 @@
+export { default as extractAndWrite, extract } from './src/extract';
+export type { ExtractCLIOptions, ExtractOpts } from './src/extract';
+export type { MessageDescriptor } from '@formatjs/ts-transformer';
+export type { FormatFn, CompileFn } from './src/formatters/default';
+export type { Element, Comparator } from 'json-stable-stringify';
+export { default as compileAndWrite, compile } from './src/compile';
+export type { CompileCLIOpts, Opts as CompileOpts } from './src/compile';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/cli-lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,IAAI,eAAe,EAAE,OAAO,EAAC,MAAM,eAAe,CAAA;AACjE,YAAY,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,eAAe,CAAA;AACjE,YAAY,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAA;AAC/D,YAAY,EAAC,QAAQ,EAAE,SAAS,EAAC,MAAM,0BAA0B,CAAA;AACjE,YAAY,EAAC,OAAO,EAAE,UAAU,EAAC,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAC,OAAO,IAAI,eAAe,EAAE,OAAO,EAAC,MAAM,eAAe,CAAA;AACjE,YAAY,EAAC,cAAc,EAAE,IAAI,IAAI,WAAW,EAAC,MAAM,eAAe,CAAA"}

package/index.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compile = exports.compileAndWrite = exports.extract = exports.extractAndWrite = void 0;
+var extract_1 = require("./src/extract");
+Object.defineProperty(exports, "extractAndWrite", { enumerable: true, get: function () { return __importDefault(extract_1).default; } });
+Object.defineProperty(exports, "extract", { enumerable: true, get: function () { return extract_1.extract; } });
+var compile_1 = require("./src/compile");
+Object.defineProperty(exports, "compileAndWrite", { enumerable: true, get: function () { return __importDefault(compile_1).default; } });
+Object.defineProperty(exports, "compile", { enumerable: true, get: function () { return compile_1.compile; } });

package/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+//# sourceMappingURL=main.d.ts.map

package/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../../packages/cli-lib/main.ts"],"names":[],"mappings":""}

package/main.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict';
+require('./src/cli').default(process.argv);

package/package.json

@@ -0,0 +1,64 @@
+{
+    "name": "@formatjs/cli-lib",
+    "version": "5.0.3",
+    "description": "Lib for CLI for formatjs.",
+    "keywords": [
+        "intl",
+        "i18n",
+        "internationalization",
+        "locale",
+        "localization",
+        "globalization",
+        "react",
+        "react-intl",
+        "reactjs",
+        "format",
+        "formatjs",
+        "formatting",
+        "translate",
+        "translation",
+        "cli"
+    ],
+    "author": "Linjie Ding <linjie@airtable.com>",
+    "homepage": "https://github.com/formatjs/formatjs",
+    "license": "MIT",
+    "main": "index.js",
+    "repository": {
+        "type": "git",
+        "url": "git+ssh://git@github.com/formatjs/formatjs.git"
+    },
+    "bugs": {
+        "url": "https://github.com/formatjs/formatjs/issues"
+    },
+    "dependencies": {
+        "@formatjs/icu-messageformat-parser": "2.1.4",
+        "@formatjs/ts-transformer": "3.9.9",
+        "@types/estree": "^0.0.50",
+        "@types/fs-extra": "^9.0.1",
+        "@types/json-stable-stringify": "^1.0.32",
+        "@types/node": "14 || 16 || 17",
+        "chalk": "^4.0.0",
+        "commander": "8",
+        "fast-glob": "^3.2.7",
+        "fs-extra": "10",
+        "json-stable-stringify": "^1.0.1",
+        "loud-rejection": "^2.2.0",
+        "tslib": "2.4.0",
+        "typescript": "^4.5"
+    },
+    "peerDependencies": {
+        "@vue/compiler-core": "^3.2.23",
+        "@vue/compiler-sfc": "^3.2.34"
+    },
+    "peerDependenciesMeta": {
+        "@vue/compiler-sfc": {
+            "optional": true
+        },
+        "@vue/compiler-core": {
+            "optional": true
+        }
+    },
+    "engines": {
+        "node": ">= 16.5.0"
+    }
+}

package/src/cli.d.ts

@@ -0,0 +1,3 @@
+declare function main(argv: string[]): Promise<void>;
+export default main;
+//# sourceMappingURL=cli.d.ts.map

package/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli-lib/src/cli.ts"],"names":[],"mappings":"AAWA,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,iBAmOjC;AACD,eAAe,IAAI,CAAA"}

package/src/cli.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var tslib_1 = require("tslib");
+var commander_1 = require("commander");
+var loud_rejection_1 = (0, tslib_1.__importDefault)(require("loud-rejection"));
+var extract_1 = (0, tslib_1.__importDefault)(require("./extract"));
+var compile_1 = (0, tslib_1.__importDefault)(require("./compile"));
+var compile_folder_1 = (0, tslib_1.__importDefault)(require("./compile_folder"));
+var fast_glob_1 = require("fast-glob");
+var console_utils_1 = require("./console_utils");
+var package_json_1 = require("../package.json");
+var KNOWN_COMMANDS = ['extract'];
+function main(argv) {
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        var _this = this;
+        return (0, tslib_1.__generator)(this, function (_a) {
+            (0, loud_rejection_1.default)();
+            commander_1.program
+                .version(package_json_1.version, '-v, --version')
+                .usage('<command> [flags]')
+                .action(function (command) {
+                if (!KNOWN_COMMANDS.includes(command)) {
+                    commander_1.program.help();
+                }
+            });
+            commander_1.program
+                .command('help', { isDefault: true })
+                .description('Show this help message.')
+                .action(function () { return commander_1.program.help(); });
+            // Long text wrapping to available terminal columns: https://github.com/tj/commander.js/pull/956
+            // NOTE: please keep the help text in sync with babel-plugin-formatjs documentation.
+            commander_1.program
+                .command('extract [files...]')
+                .description("Extract string messages from React components that use react-intl.\nThe input language is expected to be TypeScript or ES2017 with JSX.")
+                .option('--format <path>', "Path to a formatter file that controls the shape of JSON file from `--out-file`.\nThe formatter file must export a function called `format` with the signature\n```\ntype FormatFn = <T = Record<string, MessageDescriptor>>(\n  msgs: Record<string, MessageDescriptor>\n) => T\n``` \nThis is especially useful to convert from our extracted format to a TMS-specific format.\n")
+                .option('--out-file <path>', "The target file path where the plugin will output an aggregated \n`.json` file of all the translations from the `files` supplied.")
+                .option('--id-interpolation-pattern <pattern>', "If certain message descriptors don't have id, this `pattern` will be used to automatically\ngenerate IDs for them. Default to `[sha512:contenthash:base64:6]` where `contenthash` is the hash of\n`defaultMessage` and `description`.\nSee https://github.com/webpack/loader-utils#interpolatename for sample patterns", '[sha512:contenthash:base64:6]')
+                .option('--extract-source-location', "Whether the metadata about the location of the message in the source file should be \nextracted. If `true`, then `file`, `start`, and `end` fields will exist for each \nextracted message descriptors.", false)
+                .option('--remove-default-message', 'Remove `defaultMessage` field in generated js after extraction', false)
+                .option('--additional-component-names <comma-separated-names>', "Additional component names to extract messages from, e.g: `'FormattedFooBarMessage'`. \n**NOTE**: By default we check for the fact that `FormattedMessage` \nis imported from `moduleSourceName` to make sure variable alias \nworks. This option does not do that so it's less safe.", function (val) { return val.split(','); })
+                .option('--additional-function-names <comma-separated-names>', "Additional function names to extract messages from, e.g: `'$t'`.", function (val) { return val.split(','); })
+                .option('--ignore <files...>', 'List of glob paths to **not** extract translations from.')
+                .option('--throws', 'Whether to throw an exception when we fail to process any file in the batch.')
+                .option('--pragma <pragma>', "parse specific additional custom pragma. This allows you to tag certain file with metadata such as `project`. For example with this file:\n\n      ```\n      // @intl-meta project:my-custom-project\n      import {FormattedMessage} from 'react-intl';\n\n      <FormattedMessage defaultMessage=\"foo\" id=\"bar\" />;\n      ```\n\n      and with option `{pragma: \"intl-meta\"}`, we'll parse out `// @intl-meta project:my-custom-project` into `{project: 'my-custom-project'}` in the result file.")
+                .option('--preserve-whitespace', 'Whether to preserve whitespace and newlines.')
+                .option('--flatten', "Whether to hoist selectors & flatten sentences as much as possible. E.g:\n\"I have {count, plural, one{a dog} other{many dogs}}\"\nbecomes \"{count, plural, one{I have a dog} other{I have many dogs}}\".\nThe goal is to provide as many full sentences as possible since fragmented\nsentences are not translator-friendly.")
+                .action(function (filePatterns, cmdObj) { return (0, tslib_1.__awaiter)(_this, void 0, void 0, function () {
+                var files;
+                return (0, tslib_1.__generator)(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            (0, console_utils_1.debug)('File pattern:', filePatterns);
+                            (0, console_utils_1.debug)('Options:', cmdObj);
+                            files = (0, fast_glob_1.sync)(filePatterns, {
+                                ignore: cmdObj.ignore,
+                            });
+                            (0, console_utils_1.debug)('Files to extract:', files);
+                            return [4 /*yield*/, (0, extract_1.default)(files, {
+                                    outFile: cmdObj.outFile,
+                                    idInterpolationPattern: cmdObj.idInterpolationPattern || '[sha1:contenthash:base64:6]',
+                                    extractSourceLocation: cmdObj.extractSourceLocation,
+                                    removeDefaultMessage: cmdObj.removeDefaultMessage,
+                                    additionalComponentNames: cmdObj.additionalComponentNames,
+                                    additionalFunctionNames: cmdObj.additionalFunctionNames,
+                                    throws: cmdObj.throws,
+                                    pragma: cmdObj.pragma,
+                                    format: cmdObj.format,
+                                    // It is possible that the glob pattern does NOT match anything.
+                                    // But so long as the glob pattern is provided, don't read from stdin.
+                                    readFromStdin: filePatterns.length === 0,
+                                    preserveWhitespace: cmdObj.preserveWhitespace,
+                                    flatten: cmdObj.flatten,
+                                })];
+                        case 1:
+                            _a.sent();
+                            process.exit(0);
+                            return [2 /*return*/];
+                    }
+                });
+            }); });
+            commander_1.program
+                .command('compile [translation_files...]')
+                .description("Compile extracted translation file into react-intl consumable JSON\nWe also verify that the messages are valid ICU and not malformed. \n<translation_files> can be a glob like \"foo/**/en.json\"")
+                .option('--format <path>', "Path to a formatter file that converts `<translation_file>` to `Record<string, string>`\nso we can compile. The file must export a function named `compile` with the signature:\n```\ntype CompileFn = <T = Record<string, MessageDescriptor>>(\n  msgs: T\n) => Record<string, string>;\n```\nThis is especially useful to convert from a TMS-specific format back to react-intl format\n")
+                .option('--out-file <path>', "Compiled translation output file.\nIf this is not provided, result will be printed to stdout")
+                .option('--ast', "Whether to compile to AST. See https://formatjs.io/docs/guides/advanced-usage#pre-parsing-messages\nfor more information")
+                .option('--skip-errors', "Whether to continue compiling messages after encountering an error. Any keys with errors will not be included in the output file.")
+                .option('--pseudo-locale <pseudoLocale>', "Whether to generate pseudo-locale files. See https://formatjs.io/docs/tooling/cli#--pseudo-locale-pseudolocale for possible values. \n\"--ast\" is required for this to work.")
+                .action(function (filePatterns, opts) { return (0, tslib_1.__awaiter)(_this, void 0, void 0, function () {
+                var files;
+                return (0, tslib_1.__generator)(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            (0, console_utils_1.debug)('File pattern:', filePatterns);
+                            (0, console_utils_1.debug)('Options:', opts);
+                            files = (0, fast_glob_1.sync)(filePatterns);
+                            if (!files.length) {
+                                throw new Error("No input file found with pattern ".concat(filePatterns));
+                            }
+                            (0, console_utils_1.debug)('Files to compile:', files);
+                            return [4 /*yield*/, (0, compile_1.default)(files, opts)];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/];
+                    }
+                });
+            }); });
+            commander_1.program
+                .command('compile-folder <folder> <outFolder>')
+                .description("Batch compile all extracted translation JSON files in <folder> to <outFolder> containing\nreact-intl consumable JSON. We also verify that the messages are \nvalid ICU and not malformed.")
+                .option('--format <path>', "Path to a formatter file that converts JSON files in `<folder>` to `Record<string, string>`\nso we can compile. The file must export a function named `compile` with the signature:\n```\ntype CompileFn = <T = Record<string, MessageDescriptor>>(\n  msgs: T\n) => Record<string, string>;\n```\nThis is especially useful to convert from a TMS-specific format back to react-intl format\n")
+                .option('--ast', "Whether to compile to AST. See https://formatjs.io/docs/guides/advanced-usage#pre-parsing-messages\nfor more information")
+                .action(function (folder, outFolder, opts) { return (0, tslib_1.__awaiter)(_this, void 0, void 0, function () {
+                var files;
+                return (0, tslib_1.__generator)(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            (0, console_utils_1.debug)('Folder:', folder);
+                            (0, console_utils_1.debug)('Options:', opts);
+                            files = (0, fast_glob_1.sync)("".concat(folder, "/*.json"));
+                            if (!files.length) {
+                                throw new Error("No JSON file found in ".concat(folder));
+                            }
+                            (0, console_utils_1.debug)('Files to compile:', files);
+                            return [4 /*yield*/, (0, compile_folder_1.default)(files, outFolder, opts)];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/];
+                    }
+                });
+            }); });
+            if (argv.length < 3) {
+                commander_1.program.help();
+            }
+            else {
+                commander_1.program.parse(argv);
+            }
+            return [2 /*return*/];
+        });
+    });
+}
+exports.default = main;

package/src/compile.d.ts

@@ -0,0 +1,48 @@
+import { Formatter } from './formatters';
+export declare type CompileFn = (msgs: any) => Record<string, string>;
+export declare type PseudoLocale = 'xx-LS' | 'xx-AC' | 'xx-HA' | 'en-XA' | 'en-XB';
+export interface CompileCLIOpts extends Opts {
+    /**
+     * The target file that contains compiled messages.
+     */
+    outFile?: string;
+}
+export interface Opts {
+    /**
+     * Whether to compile message into AST instead of just string
+     */
+    ast?: boolean;
+    /**
+     * Whether to continue compiling messages after encountering an error.
+     * Any keys with errors will not be included in the output file.
+     */
+    skipErrors?: boolean;
+    /**
+     * Path to a formatter file that converts <translation_files> to
+     * `Record<string, string>` so we can compile.
+     */
+    format?: string | Formatter;
+    /**
+     * Whether to compile to pseudo locale
+     */
+    pseudoLocale?: PseudoLocale;
+}
+/**
+ * Aggregate `inputFiles` into a single JSON blob and compile.
+ * Also checks for conflicting IDs.
+ * Then returns the serialized result as a `string` since key order
+ * makes a difference in some vendor.
+ * @param inputFiles Input files
+ * @param opts Options
+ * @returns serialized result in string format
+ */
+export declare function compile(inputFiles: string[], opts?: Opts): Promise<string>;
+/**
+ * Aggregate `inputFiles` into a single JSON blob and compile.
+ * Also checks for conflicting IDs and write output to `outFile`.
+ * @param inputFiles Input files
+ * @param compileOpts options
+ * @returns A `Promise` that resolves if file was written successfully
+ */
+export default function compileAndWrite(inputFiles: string[], compileOpts?: CompileCLIOpts): Promise<void>;
+//# sourceMappingURL=compile.d.ts.map

package/src/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli-lib/src/compile.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,SAAS,EAAC,MAAM,cAAc,CAAA;AAS/D,oBAAY,SAAS,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE7D,oBAAY,YAAY,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAE1E,MAAM,WAAW,cAAe,SAAQ,IAAI;IAC1C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AACD,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAA;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,IAAS,mBAkElE;AAED;;;;;;GAMG;AACH,wBAA8B,eAAe,CAC3C,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,GAAE,cAAmB,iBAUjC"}

package/src/compile.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compile = void 0;
+var tslib_1 = require("tslib");
+var icu_messageformat_parser_1 = require("@formatjs/icu-messageformat-parser");
+var fs_extra_1 = require("fs-extra");
+var json_stable_stringify_1 = (0, tslib_1.__importDefault)(require("json-stable-stringify"));
+var console_utils_1 = require("./console_utils");
+var formatters_1 = require("./formatters");
+var pseudo_locale_1 = require("./pseudo_locale");
+/**
+ * Aggregate `inputFiles` into a single JSON blob and compile.
+ * Also checks for conflicting IDs.
+ * Then returns the serialized result as a `string` since key order
+ * makes a difference in some vendor.
+ * @param inputFiles Input files
+ * @param opts Options
+ * @returns serialized result in string format
+ */
+function compile(inputFiles, opts) {
+    if (opts === void 0) { opts = {}; }
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        var ast, format, pseudoLocale, skipErrors, formatter, messages, messageAsts, idsWithFileName, compiledFiles, i, inputFile, compiled, id, msgAst;
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    (0, console_utils_1.debug)('Compiling files:', inputFiles);
+                    ast = opts.ast, format = opts.format, pseudoLocale = opts.pseudoLocale, skipErrors = opts.skipErrors;
+                    return [4 /*yield*/, (0, formatters_1.resolveBuiltinFormatter)(format)];
+                case 1:
+                    formatter = _a.sent();
+                    messages = {};
+                    messageAsts = {};
+                    idsWithFileName = {};
+                    return [4 /*yield*/, Promise.all(inputFiles.map(function (f) { return (0, fs_extra_1.readJSON)(f).then(formatter.compile); }))];
+                case 2:
+                    compiledFiles = _a.sent();
+                    (0, console_utils_1.debug)('Compiled files:', compiledFiles);
+                    for (i = 0; i < inputFiles.length; i++) {
+                        inputFile = inputFiles[i];
+                        (0, console_utils_1.debug)('Processing file:', inputFile);
+                        compiled = compiledFiles[i];
+                        for (id in compiled) {
+                            if (messages[id] && messages[id] !== compiled[id]) {
+                                throw new Error("Conflicting ID \"".concat(id, "\" with different translation found in these 2 files:\nID: ").concat(id, "\nMessage from ").concat(idsWithFileName[id], ": ").concat(messages[id], "\nMessage from ").concat(compiled[id], ": ").concat(inputFile, "\n"));
+                            }
+                            try {
+                                msgAst = (0, icu_messageformat_parser_1.parse)(compiled[id]);
+                                messages[id] = compiled[id];
+                                switch (pseudoLocale) {
+                                    case 'xx-LS':
+                                        messageAsts[id] = (0, pseudo_locale_1.generateXXLS)(msgAst);
+                                        break;
+                                    case 'xx-AC':
+                                        messageAsts[id] = (0, pseudo_locale_1.generateXXAC)(msgAst);
+                                        break;
+                                    case 'xx-HA':
+                                        messageAsts[id] = (0, pseudo_locale_1.generateXXHA)(msgAst);
+                                        break;
+                                    case 'en-XA':
+                                        messageAsts[id] = (0, pseudo_locale_1.generateENXA)(msgAst);
+                                        break;
+                                    case 'en-XB':
+                                        messageAsts[id] = (0, pseudo_locale_1.generateENXB)(msgAst);
+                                        break;
+                                    default:
+                                        messageAsts[id] = msgAst;
+                                        break;
+                                }
+                                idsWithFileName[id] = inputFile;
+                            }
+                            catch (e) {
+                                (0, console_utils_1.warn)('Error validating message "%s" with ID "%s" in file "%s"', compiled[id], id, inputFile);
+                                if (!skipErrors) {
+                                    throw e;
+                                }
+                            }
+                        }
+                    }
+                    return [2 /*return*/, (0, json_stable_stringify_1.default)(ast ? messageAsts : messages, {
+                            space: 2,
+                            cmp: formatter.compareMessages || undefined,
+                        })];
+            }
+        });
+    });
+}
+exports.compile = compile;
+/**
+ * Aggregate `inputFiles` into a single JSON blob and compile.
+ * Also checks for conflicting IDs and write output to `outFile`.
+ * @param inputFiles Input files
+ * @param compileOpts options
+ * @returns A `Promise` that resolves if file was written successfully
+ */
+function compileAndWrite(inputFiles, compileOpts) {
+    if (compileOpts === void 0) { compileOpts = {}; }
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        var outFile, opts, serializedResult;
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    outFile = compileOpts.outFile, opts = (0, tslib_1.__rest)(compileOpts, ["outFile"]);
+                    return [4 /*yield*/, compile(inputFiles, opts)];
+                case 1:
+                    serializedResult = _a.sent();
+                    if (outFile) {
+                        (0, console_utils_1.debug)('Writing output file:', outFile);
+                        return [2 /*return*/, (0, fs_extra_1.outputFile)(outFile, serializedResult)];
+                    }
+                    return [4 /*yield*/, (0, console_utils_1.writeStdout)(serializedResult)];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, (0, console_utils_1.writeStdout)('\n')];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.default = compileAndWrite;

package/src/compile_folder.d.ts

@@ -0,0 +1,3 @@
+import { Opts } from './compile';
+export default function compileFolder(files: string[], outFolder: string, opts?: Opts): Promise<void[]>;
+//# sourceMappingURL=compile_folder.d.ts.map

package/src/compile_folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile_folder.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli-lib/src/compile_folder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAU,MAAM,WAAW,CAAA;AAGvC,wBAA8B,aAAa,CACzC,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,IAAS,mBAQhB"}

package/src/compile_folder.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var tslib_1 = require("tslib");
+var compile_1 = require("./compile");
+var path_1 = require("path");
+var fs_extra_1 = require("fs-extra");
+function compileFolder(files, outFolder, opts) {
+    if (opts === void 0) { opts = {}; }
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        var results, outFiles;
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, Promise.all(files.map(function (f) { return (0, compile_1.compile)([f], opts); }))];
+                case 1:
+                    results = _a.sent();
+                    outFiles = files.map(function (f) { return (0, path_1.join)(outFolder, (0, path_1.basename)(f)); });
+                    return [2 /*return*/, Promise.all(outFiles.map(function (outFile, i) { return (0, fs_extra_1.outputFile)(outFile, results[i]); }))];
+            }
+        });
+    });
+}
+exports.default = compileFolder;

package/src/console_utils.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="node" />
+export declare const writeStderr: (arg1: string | Uint8Array) => Promise<void>;
+export declare const writeStdout: (arg1: string | Uint8Array) => Promise<void>;
+export declare function clearLine(terminal: typeof process['stderr']): Promise<void>;
+export declare function debug(message: string, ...args: any[]): Promise<void>;
+export declare function warn(message: string, ...args: any[]): Promise<void>;
+export declare function error(message: string, ...args: any[]): Promise<void>;
+export declare function getStdinAsString(): Promise<string>;
+//# sourceMappingURL=console_utils.d.ts.map

package/src/console_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console_utils.d.ts","sourceRoot":"","sources":["../../../../../../packages/cli-lib/src/console_utils.ts"],"names":[],"mappings":";AAMA,eAAO,MAAM,WAAW,8CAAuD,CAAA;AAC/E,eAAO,MAAM,WAAW,8CAAuD,CAAA;AAO/E,wBAAsB,SAAS,CAAC,QAAQ,EAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,iBAcjE;AAcD,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,iBAO1D;AAED,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,iBAIzD;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,iBAI1D;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAclD"}

package/src/console_utils.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStdinAsString = exports.error = exports.warn = exports.debug = exports.clearLine = exports.writeStdout = exports.writeStderr = void 0;
+var tslib_1 = require("tslib");
+var chalk_1 = require("chalk");
+var readline_1 = (0, tslib_1.__importDefault)(require("readline"));
+var util_1 = require("util");
+var CLEAR_WHOLE_LINE = 0;
+exports.writeStderr = (0, util_1.promisify)(process.stderr.write).bind(process.stderr);
+exports.writeStdout = (0, util_1.promisify)(process.stdout.write).bind(process.stdout);
+var nativeClearLine = (0, util_1.promisify)(readline_1.default.clearLine).bind(readline_1.default);
+var nativeCursorTo = (0, util_1.promisify)(readline_1.default.cursorTo).bind(readline_1.default);
+// From:
+// https://github.com/yarnpkg/yarn/blob/53d8004229f543f342833310d5af63a4b6e59c8a/src/reporters/console/util.js
+function clearLine(terminal) {
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (!!chalk_1.supportsColor) return [3 /*break*/, 5];
+                    if (!terminal.isTTY) return [3 /*break*/, 4];
+                    if (!(terminal.columns > 0)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, (0, exports.writeStderr)("\r".concat(' '.repeat(terminal.columns - 1)))];
+                case 1:
+                    _a.sent();
+                    _a.label = 2;
+                case 2: return [4 /*yield*/, (0, exports.writeStderr)("\r")];
+                case 3:
+                    _a.sent();
+                    _a.label = 4;
+                case 4: return [3 /*break*/, 8];
+                case 5: return [4 /*yield*/, nativeClearLine(terminal, CLEAR_WHOLE_LINE)];
+                case 6:
+                    _a.sent();
+                    return [4 /*yield*/, nativeCursorTo(terminal, 0, undefined)];
+                case 7:
+                    _a.sent();
+                    _a.label = 8;
+                case 8: return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.clearLine = clearLine;
+var LEVEL_COLORS = {
+    debug: chalk_1.green,
+    warn: chalk_1.yellow,
+    error: chalk_1.red,
+};
+function label(level, message) {
+    return "[@formatjs/cli] [".concat(LEVEL_COLORS[level](level.toUpperCase()), "] ").concat(message);
+}
+function debug(message) {
+    var args = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args[_i - 1] = arguments[_i];
+    }
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (process.env.LOG_LEVEL !== 'debug') {
+                        return [2 /*return*/];
+                    }
+                    return [4 /*yield*/, clearLine(process.stderr)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, (0, exports.writeStderr)(util_1.format.apply(void 0, (0, tslib_1.__spreadArray)([label('debug', message)], args, false)))];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, (0, exports.writeStderr)('\n')];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.debug = debug;
+function warn(message) {
+    var args = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args[_i - 1] = arguments[_i];
+    }
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, clearLine(process.stderr)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, (0, exports.writeStderr)(util_1.format.apply(void 0, (0, tslib_1.__spreadArray)([label('warn', message)], args, false)))];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, (0, exports.writeStderr)('\n')];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.warn = warn;
+function error(message) {
+    var args = [];
+    for (var _i = 1; _i < arguments.length; _i++) {
+        args[_i - 1] = arguments[_i];
+    }
+    return (0, tslib_1.__awaiter)(this, void 0, void 0, function () {
+        return (0, tslib_1.__generator)(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, clearLine(process.stderr)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, (0, exports.writeStderr)(util_1.format.apply(void 0, (0, tslib_1.__spreadArray)([label('error', message)], args, false)))];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, (0, exports.writeStderr)('\n')];
+                case 3:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+exports.error = error;
+function getStdinAsString() {
+    var result = '';
+    return new Promise(function (resolve) {
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('readable', function () {
+            var chunk;
+            while ((chunk = process.stdin.read())) {
+                result += chunk;
+            }
+        });
+        process.stdin.on('end', function () {
+            resolve(result);
+        });
+    });
+}
+exports.getStdinAsString = getStdinAsString;