@formatjs/cli-lib 5.1.8 → 5.1.10

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":["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":["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

@@ -1,6 +1,6 @@
 {
   "name": "@formatjs/cli-lib",
-  "version": "5.1.8",
+  "version": "5.1.10",
   "description": "Lib for CLI for formatjs.",
   "keywords": [
     "intl",

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":["cli.ts"],"names":[],"mappings":"AAUA,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,iBAoOjC;AACD,eAAe,IAAI,CAAA"}

package/src/cli.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const commander_1 = require("commander");
+const loud_rejection_1 = tslib_1.__importDefault(require("loud-rejection"));
+const extract_1 = tslib_1.__importDefault(require("./extract"));
+const compile_1 = tslib_1.__importDefault(require("./compile"));
+const compile_folder_1 = tslib_1.__importDefault(require("./compile_folder"));
+const fast_glob_1 = require("fast-glob");
+const console_utils_1 = require("./console_utils");
+const KNOWN_COMMANDS = ['extract'];
+async function main(argv) {
+    (0, loud_rejection_1.default)();
+    commander_1.program
+        // TODO: fix this
+        .version('5.0.6', '-v, --version')
+        .usage('<command> [flags]')
+        .action(command => {
+        if (!KNOWN_COMMANDS.includes(command)) {
+            commander_1.program.help();
+        }
+    });
+    commander_1.program
+        .command('help', { isDefault: true })
+        .description('Show this help message.')
+        .action(() => 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.
+The 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\`.
+The formatter file must export a function called \`format\` with the signature
+\`\`\`
+type FormatFn = <T = Record<string, MessageDescriptor>>(
+  msgs: Record<string, MessageDescriptor>
+) => T
+\`\`\` 
+This is especially useful to convert from our extracted format to a TMS-specific format.
+`)
+        .option('--out-file <path>', `The target file path where the plugin will output an aggregated 
+\`.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
+generate IDs for them. Default to \`[sha512:contenthash:base64:6]\` where \`contenthash\` is the hash of
+\`defaultMessage\` and \`description\`.
+See 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 
+extracted. If \`true\`, then \`file\`, \`start\`, and \`end\` fields will exist for each 
+extracted 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'\`. 
+**NOTE**: By default we check for the fact that \`FormattedMessage\` 
+is imported from \`moduleSourceName\` to make sure variable alias 
+works. This option does not do that so it's less safe.`, (val) => val.split(','))
+        .option('--additional-function-names <comma-separated-names>', `Additional function names to extract messages from, e.g: \`'$t'\`.`, (val) => 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:
+
+      \`\`\`
+      // @intl-meta project:my-custom-project
+      import {FormattedMessage} from 'react-intl';
+
+      <FormattedMessage defaultMessage="foo" id="bar" />;
+      \`\`\`
+
+      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:
+"I have {count, plural, one{a dog} other{many dogs}}"
+becomes "{count, plural, one{I have a dog} other{I have many dogs}}".
+The goal is to provide as many full sentences as possible since fragmented
+sentences are not translator-friendly.`)
+        .action(async (filePatterns, cmdObj) => {
+        (0, console_utils_1.debug)('File pattern:', filePatterns);
+        (0, console_utils_1.debug)('Options:', cmdObj);
+        const files = (0, fast_glob_1.sync)(filePatterns, {
+            ignore: cmdObj.ignore,
+        });
+        (0, console_utils_1.debug)('Files to extract:', files);
+        await (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,
+        });
+        process.exit(0);
+    });
+    commander_1.program
+        .command('compile [translation_files...]')
+        .description(`Compile extracted translation file into react-intl consumable JSON
+We also verify that the messages are valid ICU and not malformed. 
+<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>\`
+so we can compile. The file must export a function named \`compile\` with the signature:
+\`\`\`
+type CompileFn = <T = Record<string, MessageDescriptor>>(
+  msgs: T
+) => Record<string, string>;
+\`\`\`
+This is especially useful to convert from a TMS-specific format back to react-intl format
+`)
+        .option('--out-file <path>', `Compiled translation output file.
+If 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
+for 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. 
+"--ast" is required for this to work.`)
+        .action(async (filePatterns, opts) => {
+        (0, console_utils_1.debug)('File pattern:', filePatterns);
+        (0, console_utils_1.debug)('Options:', opts);
+        const files = (0, fast_glob_1.sync)(filePatterns);
+        if (!files.length) {
+            throw new Error(`No input file found with pattern ${filePatterns}`);
+        }
+        (0, console_utils_1.debug)('Files to compile:', files);
+        await (0, compile_1.default)(files, opts);
+    });
+    commander_1.program
+        .command('compile-folder <folder> <outFolder>')
+        .description(`Batch compile all extracted translation JSON files in <folder> to <outFolder> containing
+react-intl consumable JSON. We also verify that the messages are 
+valid ICU and not malformed.`)
+        .option('--format <path>', `Path to a formatter file that converts JSON files in \`<folder>\` to \`Record<string, string>\`
+so we can compile. The file must export a function named \`compile\` with the signature:
+\`\`\`
+type CompileFn = <T = Record<string, MessageDescriptor>>(
+  msgs: T
+) => Record<string, string>;
+\`\`\`
+This is especially useful to convert from a TMS-specific format back to react-intl format
+`)
+        .option('--ast', `Whether to compile to AST. See https://formatjs.io/docs/guides/advanced-usage#pre-parsing-messages
+for more information`)
+        .action(async (folder, outFolder, opts) => {
+        (0, console_utils_1.debug)('Folder:', folder);
+        (0, console_utils_1.debug)('Options:', opts);
+        // fast-glob expect `/` in Windows as well
+        const files = (0, fast_glob_1.sync)(`${folder}/*.json`);
+        if (!files.length) {
+            throw new Error(`No JSON file found in ${folder}`);
+        }
+        (0, console_utils_1.debug)('Files to compile:', files);
+        await (0, compile_folder_1.default)(files, outFolder, opts);
+    });
+    if (argv.length < 3) {
+        commander_1.program.help();
+    }
+    else {
+        commander_1.program.parse(argv);
+    }
+}
+exports.default = main;

package/src/compile.d.ts

@@ -0,0 +1,48 @@
+import { Formatter } from './formatters';
+export type CompileFn = (msgs: any) => Record<string, string>;
+export 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":["compile.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0B,SAAS,EAAC,MAAM,cAAc,CAAA;AAS/D,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE7D,MAAM,MAAM,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,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compile = void 0;
+const tslib_1 = require("tslib");
+const icu_messageformat_parser_1 = require("@formatjs/icu-messageformat-parser");
+const fs_extra_1 = require("fs-extra");
+const json_stable_stringify_1 = tslib_1.__importDefault(require("json-stable-stringify"));
+const console_utils_1 = require("./console_utils");
+const formatters_1 = require("./formatters");
+const 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
+ */
+async function compile(inputFiles, opts = {}) {
+    (0, console_utils_1.debug)('Compiling files:', inputFiles);
+    const { ast, format, pseudoLocale, skipErrors } = opts;
+    const formatter = await (0, formatters_1.resolveBuiltinFormatter)(format);
+    const messages = {};
+    const messageAsts = {};
+    const idsWithFileName = {};
+    const compiledFiles = await Promise.all(inputFiles.map(f => (0, fs_extra_1.readJSON)(f).then(formatter.compile)));
+    (0, console_utils_1.debug)('Compiled files:', compiledFiles);
+    for (let i = 0; i < inputFiles.length; i++) {
+        const inputFile = inputFiles[i];
+        (0, console_utils_1.debug)('Processing file:', inputFile);
+        const compiled = compiledFiles[i];
+        for (const id in compiled) {
+            if (messages[id] && messages[id] !== compiled[id]) {
+                throw new Error(`Conflicting ID "${id}" with different translation found in these 2 files:
+ID: ${id}
+Message from ${idsWithFileName[id]}: ${messages[id]}
+Message from ${compiled[id]}: ${inputFile}
+`);
+            }
+            try {
+                const 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 (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
+ */
+async function compileAndWrite(inputFiles, compileOpts = {}) {
+    const { outFile, ...opts } = compileOpts;
+    const serializedResult = await compile(inputFiles, opts);
+    if (outFile) {
+        (0, console_utils_1.debug)('Writing output file:', outFile);
+        return (0, fs_extra_1.outputFile)(outFile, serializedResult);
+    }
+    await (0, console_utils_1.writeStdout)(serializedResult);
+    await (0, console_utils_1.writeStdout)('\n');
+}
+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":["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,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const compile_1 = require("./compile");
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+async function compileFolder(files, outFolder, opts = {}) {
+    const results = await Promise.all(files.map(f => (0, compile_1.compile)([f], opts)));
+    const outFiles = files.map(f => (0, path_1.join)(outFolder, (0, path_1.basename)(f)));
+    return Promise.all(outFiles.map((outFile, i) => (0, fs_extra_1.outputFile)(outFile, results[i])));
+}
+exports.default = compileFolder;

package/src/console_utils.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+/// <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":["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,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStdinAsString = exports.error = exports.warn = exports.debug = exports.clearLine = exports.writeStdout = exports.writeStderr = void 0;
+const tslib_1 = require("tslib");
+const chalk_1 = require("chalk");
+const readline_1 = tslib_1.__importDefault(require("readline"));
+const util_1 = require("util");
+const 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);
+const nativeClearLine = (0, util_1.promisify)(readline_1.default.clearLine).bind(readline_1.default);
+const 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
+async function clearLine(terminal) {
+    if (!chalk_1.supportsColor) {
+        if (terminal.isTTY) {
+            // terminal
+            if (terminal.columns > 0) {
+                await (0, exports.writeStderr)(`\r${' '.repeat(terminal.columns - 1)}`);
+            }
+            await (0, exports.writeStderr)(`\r`);
+        }
+        // ignore piping to file
+    }
+    else {
+        await nativeClearLine(terminal, CLEAR_WHOLE_LINE);
+        await nativeCursorTo(terminal, 0, undefined);
+    }
+}
+exports.clearLine = clearLine;
+const LEVEL_COLORS = {
+    debug: chalk_1.green,
+    warn: chalk_1.yellow,
+    error: chalk_1.red,
+};
+function label(level, message) {
+    return `[@formatjs/cli] [${LEVEL_COLORS[level](level.toUpperCase())}] ${message}`;
+}
+async function debug(message, ...args) {
+    if (process.env.LOG_LEVEL !== 'debug') {
+        return;
+    }
+    await clearLine(process.stderr);
+    await (0, exports.writeStderr)((0, util_1.format)(label('debug', message), ...args));
+    await (0, exports.writeStderr)('\n');
+}
+exports.debug = debug;
+async function warn(message, ...args) {
+    await clearLine(process.stderr);
+    await (0, exports.writeStderr)((0, util_1.format)(label('warn', message), ...args));
+    await (0, exports.writeStderr)('\n');
+}
+exports.warn = warn;
+async function error(message, ...args) {
+    await clearLine(process.stderr);
+    await (0, exports.writeStderr)((0, util_1.format)(label('error', message), ...args));
+    await (0, exports.writeStderr)('\n');
+}
+exports.error = error;
+function getStdinAsString() {
+    let result = '';
+    return new Promise(resolve => {
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('readable', () => {
+            let chunk;
+            while ((chunk = process.stdin.read())) {
+                result += chunk;
+            }
+        });
+        process.stdin.on('end', () => {
+            resolve(result);
+        });
+    });
+}
+exports.getStdinAsString = getStdinAsString;

package/src/extract.d.ts

@@ -0,0 +1,75 @@
+import { Opts, MessageDescriptor } from '@formatjs/ts-transformer';
+import { Formatter } from './formatters';
+export interface ExtractionResult<M = Record<string, string>> {
+    /**
+     * List of extracted messages
+     */
+    messages: MessageDescriptor[];
+    /**
+     * Metadata extracted w/ `pragma`
+     */
+    meta?: M;
+}
+export interface ExtractedMessageDescriptor extends MessageDescriptor {
+    /**
+     * Line number
+     */
+    line?: number;
+    /**
+     * Column number
+     */
+    col?: number;
+    /**
+     * Metadata extracted from pragma
+     */
+    meta?: Record<string, string>;
+}
+export type ExtractCLIOptions = Omit<ExtractOpts, 'overrideIdFn' | 'onMsgExtracted' | 'onMetaExtracted'> & {
+    /**
+     * Output File
+     */
+    outFile?: string;
+    /**
+     * Ignore file glob pattern
+     */
+    ignore?: string[];
+};
+export type ExtractOpts = Opts & {
+    /**
+     * Whether to throw an error if we had any issues with
+     * 1 of the source files
+     */
+    throws?: boolean;
+    /**
+     * Message ID interpolation pattern
+     */
+    idInterpolationPattern?: string;
+    /**
+     * Whether we read from stdin instead of a file
+     */
+    readFromStdin?: boolean;
+    /**
+     * Path to a formatter file that controls the shape of JSON file from `outFile`.
+     */
+    format?: string | Formatter;
+    /**
+     * Whether to hoist selectors & flatten sentences
+     */
+    flatten?: boolean;
+} & Pick<Opts, 'onMsgExtracted' | 'onMetaExtracted'>;
+/**
+ * Extract strings from source files
+ * @param files list of files
+ * @param extractOpts extract options
+ * @returns messages serialized as JSON string since key order
+ * matters for some `format`
+ */
+export declare function extract(files: readonly string[], extractOpts: ExtractOpts): Promise<string>;
+/**
+ * Extract strings from source files, also writes to a file.
+ * @param files list of files
+ * @param extractOpts extract options
+ * @returns A Promise that resolves if output file was written successfully
+ */
+export default function extractAndWrite(files: readonly string[], extractOpts: ExtractCLIOptions): Promise<void>;
+//# sourceMappingURL=extract.d.ts.map

package/src/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["extract.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,IAAI,EACJ,iBAAiB,EAClB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAA0B,SAAS,EAAC,MAAM,cAAc,CAAA;AAM/D,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAC1D;;OAEG;IACH,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,CAAA;CACT;AAED,MAAM,WAAW,0BAA2B,SAAQ,iBAAiB;IACnE;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,WAAW,EACX,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CACtD,GAAG;IACF;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,CAAA;AAqFpD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,WAAW,mBAmFzB;AAED;;;;;GAKG;AACH,wBAA8B,eAAe,CAC3C,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,iBAAiB,iBAS/B"}