gtx-cli 1.2.3 → 1.2.4

package/dist/api/sendFiles.js

@@ -46,7 +46,7 @@ function sendFiles(files, options) {
             formData.append('targetLocales', JSON.stringify(options.locales));
             formData.append('projectId', options.projectId);
             formData.append('publish', String(options.publish));
-            formData.append('versionId', options.versionId || '');
+            formData.append('versionId', options._versionId || '');
             formData.append('description', options.description || '');
             const response = yield fetch(`${options.baseUrl}/v1/project/translations/files/upload`, {
                 method: 'POST',

package/dist/api/sendUpdates.d.ts

@@ -1,11 +1,10 @@
 import { Settings, SupportedLibraries, Updates } from '../types';
 import { DataFormat } from '../types/data';
 type ApiOptions = Settings & {
-    publish: boolean;
-    wait: boolean;
     timeout: string;
     dataFormat: DataFormat;
     description?: string;
+    requireApproval?: boolean;
 };
 /**
  * Sends updates to the API
@@ -14,6 +13,7 @@ type ApiOptions = Settings & {
  * @returns The versionId of the updated project
  */
 export declare function sendUpdates(updates: Updates, options: ApiOptions, library: SupportedLibraries): Promise<{
-    versionId: any;
-} | undefined>;
+    versionId: string;
+    locales: string[];
+}>;
 export {};

package/dist/api/sendUpdates.js

@@ -16,7 +16,6 @@ exports.sendUpdates = sendUpdates;
 const chalk_1 = __importDefault(require("chalk"));
 const console_1 = require("../console");
 const updateConfig_1 = __importDefault(require("../fs/config/updateConfig"));
-const waitForUpdates_1 = require("./waitForUpdates");
 /**
  * Sends updates to the API
  * @param updates - The updates to send
@@ -30,11 +29,12 @@ function sendUpdates(updates, options, library) {
         // If additionalLocales is provided, additionalLocales + project.current_locales will be translated
         // If not, then options.locales will be translated
         // If neither, then project.current_locales will be translated
-        const body = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ updates }, (options.locales && { locales: options.locales })), { metadata: globalMetadata, publish: options.publish }), (dataFormat && { dataFormat })), (options.versionId && { versionId: options.versionId })), (options.description && { description: options.description }));
+        const body = Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ updates }, (options.locales && { locales: options.locales })), { metadata: globalMetadata }), (dataFormat && { dataFormat })), (options.version && { versionId: options.version })), (options.description && { description: options.description })), (options.requireApproval && {
+            requireApproval: options.requireApproval,
+        }));
         const spinner = (0, console_1.createSpinner)('dots');
         spinner.start(`Sending ${library} updates to General Translation API...`);
         try {
-            const startTime = Date.now();
             const response = yield fetch(`${options.baseUrl}/v1/project/translations/update`, {
                 method: 'POST',
                 headers: Object.assign({ 'Content-Type': 'application/json' }, (apiKey && { 'x-gt-api-key': apiKey })),
@@ -44,27 +44,17 @@ function sendUpdates(updates, options, library) {
                 spinner.stop(chalk_1.default.red(yield response.text()));
                 process.exit(1);
             }
-            if (response.status === 204) {
-                spinner.stop(chalk_1.default.green('Sent updates'));
-                (0, console_1.logSuccess)(yield response.text());
-                return;
-            }
             const { versionId, message, locales } = yield response.json();
             spinner.stop(chalk_1.default.green('Sent updates'));
             (0, console_1.logSuccess)(message);
-            if (options.config)
+            if (options.config) {
                 yield (0, updateConfig_1.default)({
                     configFilepath: options.config,
                     _versionId: versionId,
                     locales,
                 });
-            // Wait for translations if wait is true
-            if (options.wait && locales) {
-                // timeout was validated earlier
-                const timeout = parseInt(options.timeout) * 1000;
-                yield (0, waitForUpdates_1.waitForUpdates)(apiKey, options.baseUrl, versionId, locales, startTime, timeout);
             }
-            return { versionId };
+            return { versionId, locales };
         }
         catch (error) {
             spinner.stop(chalk_1.default.red('Failed to send updates'));

package/dist/api/waitForUpdates.d.ts

@@ -8,4 +8,4 @@
  * @param timeoutDuration - The timeout duration for the wait
  * @returns True if all translations are deployed, false otherwise
  */
-export declare const waitForUpdates: (apiKey: string, baseUrl: string, versionId: string, locales: string[], startTime: number, timeoutDuration: number) => Promise<boolean>;
+export declare const waitForUpdates: (apiKey: string, baseUrl: string, versionId: string, startTime: number, timeoutDuration: number) => Promise<boolean>;

package/dist/api/waitForUpdates.js

@@ -26,11 +26,10 @@ const generaltranslation_1 = require("generaltranslation");
  * @param timeoutDuration - The timeout duration for the wait
  * @returns True if all translations are deployed, false otherwise
  */
-const waitForUpdates = (apiKey, baseUrl, versionId, locales, startTime, timeoutDuration) => __awaiter(void 0, void 0, void 0, function* () {
+const waitForUpdates = (apiKey, baseUrl, versionId, startTime, timeoutDuration) => __awaiter(void 0, void 0, void 0, function* () {
     console.log();
     const spinner = yield (0, console_1.createOraSpinner)();
     spinner.start('Waiting for translation...');
-    const availableLocales = [];
     const checkDeployment = () => __awaiter(void 0, void 0, void 0, function* () {
         try {
             const response = yield fetch(`${baseUrl}/v1/project/translations/status/${encodeURIComponent(versionId)}`, {
@@ -39,10 +38,14 @@ const waitForUpdates = (apiKey, baseUrl, versionId, locales, startTime, timeoutD
             });
             if (response.ok) {
                 const data = yield response.json();
-                if (data.availableLocales) {
-                    data.availableLocales.forEach((locale) => {
-                        if (!availableLocales.includes(locale) &&
-                            locales.includes(locale)) {
+                const { availableLocales, locales, localesWaitingForApproval } = data;
+                if (localesWaitingForApproval.length > 0) {
+                    spinner.text = `Waiting for approval for ${localesWaitingForApproval.length} locales`;
+                    return false;
+                }
+                if (availableLocales) {
+                    availableLocales.forEach((locale) => {
+                        if (!availableLocales.includes(locale)) {
                             availableLocales.push(locale);
                         }
                     });
@@ -54,7 +57,6 @@ const waitForUpdates = (apiKey, baseUrl, versionId, locales, startTime, timeoutD
                             return `Translation completed for ${chalk_1.default.green(localeProperties.name)} (${chalk_1.default.green(localeProperties.code)})`;
                         }),
                     ];
-                    // The new clack spinner doesn't have suffixText, just update the message
                     spinner.text = newSuffixText.join('\n');
                 }
                 if (locales.every((locale) => availableLocales.includes(locale))) {

package/dist/cli/base.d.ts

@@ -1,4 +1,13 @@
-import { Settings, SupportedLibraries, SetupOptions } from '../types';
+import { FilesOptions, Settings, SupportedLibraries, SetupOptions } from '../types';
+export type TranslateOptions = {
+    config?: string;
+    defaultLocale?: string;
+    locales?: string[];
+    files?: FilesOptions;
+    apiKey?: string;
+    projectId?: string;
+    dryRun: boolean;
+};
 export declare class BaseCLI {
     protected library: SupportedLibraries;
     protected additionalModules: SupportedLibraries[];
@@ -10,7 +19,7 @@ export declare class BaseCLI {
     protected setupInitCommand(): void;
     protected setupConfigureCommand(): void;
     protected setupSetupCommand(): void;
-    protected handleGenericTranslate(settings: Settings): Promise<void>;
+    protected handleGenericTranslate(settings: Settings & TranslateOptions): Promise<void>;
     protected handleSetupReactCommand(options: SetupOptions): Promise<void>;
     protected handleInitCommand(ranReactSetup: boolean): Promise<void>;
     protected handleLoginCommand(): Promise<void>;

package/dist/cli/base.js

@@ -91,10 +91,12 @@ class BaseCLI {
             .option('--project-id <id>', 'Project ID for the translation service', (0, utils_1.resolveProjectId)())
             .option('--default-language, --default-locale <locale>', 'Default locale (e.g., en)')
             .option('--new, --locales <locales...>', 'Space-separated list of locales (e.g., en fr es)')
-            .action((options) => __awaiter(this, void 0, void 0, function* () {
+            .option('--dry-run', 'Dry run, does not send updates to General Translation API', false)
+            .action((initOptions) => __awaiter(this, void 0, void 0, function* () {
             (0, console_1.displayHeader)('Starting translation...');
-            const settings = yield (0, generateSettings_1.generateSettings)(options);
-            yield this.handleGenericTranslate(settings);
+            const settings = yield (0, generateSettings_1.generateSettings)(initOptions);
+            const options = Object.assign(Object.assign({}, initOptions), settings);
+            yield this.handleGenericTranslate(options);
             (0, console_1.endCommand)('Done!');
         }));
     }
@@ -103,7 +105,7 @@ class BaseCLI {
             .command('auth')
             .description('Generate a General Translation API key and project ID')
             .option('-c, --config <path>', 'Filepath to config file, by default gt.config.json', (0, findFilepath_1.default)(['gt.config.json']))
-            .action((options) => __awaiter(this, void 0, void 0, function* () {
+            .action(() => __awaiter(this, void 0, void 0, function* () {
             (0, console_1.displayHeader)('Authenticating with General Translation...');
             yield this.handleLoginCommand();
             (0, console_1.endCommand)('Done!');
@@ -168,22 +170,6 @@ See the docs for more information: https://generaltranslation.com/docs/react/tut
     }
     handleGenericTranslate(settings) {
         return __awaiter(this, void 0, void 0, function* () {
-            // Validate required settings are present
-            if (!settings.locales) {
-                (0, console_1.logErrorAndExit)(console_1.noLocalesError);
-            }
-            if (!settings.defaultLocale) {
-                (0, console_1.logErrorAndExit)(console_1.noDefaultLocaleError);
-            }
-            if (!settings.files) {
-                (0, console_1.logErrorAndExit)(console_1.noFilesError);
-            }
-            if (!settings.apiKey) {
-                (0, console_1.logErrorAndExit)(console_1.noApiKeyError);
-            }
-            if (!settings.projectId) {
-                (0, console_1.logErrorAndExit)(console_1.noProjectIdError);
-            }
             // dataFormat for JSONs
             let dataFormat;
             if (this.library === 'next-intl') {
@@ -200,6 +186,9 @@ See the docs for more information: https://generaltranslation.com/docs/react/tut
             else {
                 dataFormat = 'JSX';
             }
+            if (!settings.files) {
+                return;
+            }
             const { resolvedPaths: sourceFiles, placeholderPaths, transformPaths, } = settings.files;
             // Process all file types at once with a single call
             yield (0, translate_1.translateFiles)(sourceFiles, placeholderPaths, transformPaths, dataFormat, settings);

package/dist/cli/next.d.ts

@@ -1,14 +1,10 @@
-import { WrapOptions, Options, Updates, SupportedFrameworks, SupportedLibraries } from '../types';
+import { WrapOptions, SupportedFrameworks, SupportedLibraries } from '../types';
 import { ReactCLI } from './react';
 export declare class NextCLI extends ReactCLI {
-    constructor(library: SupportedLibraries, additionalModules?: SupportedLibraries[]);
+    constructor(library: 'gt-next', additionalModules?: SupportedLibraries[]);
     init(): void;
     execute(): void;
-    protected scanForContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
+    protected wrapContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
         filesUpdated: string[];
     }>;
-    protected createInlineUpdates(options: Options): Promise<{
-        updates: Updates;
-        errors: string[];
-    }>;
 }

package/dist/cli/next.js

@@ -4,15 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NextCLI = void 0;
-const createInlineUpdates_1 = __importDefault(require("../react/parse/createInlineUpdates"));
 const react_1 = require("./react");
-const scanForContent_1 = __importDefault(require("../next/parse/scanForContent"));
+const wrapContent_1 = __importDefault(require("../next/parse/wrapContent"));
 const pkg = 'gt-next';
 class NextCLI extends react_1.ReactCLI {
     constructor(library, additionalModules) {
         super(library, additionalModules);
     }
     init() {
+        this.setupStageCommand();
         this.setupTranslateCommand();
         this.setupScanCommand();
         this.setupGenerateSourceCommand();
@@ -20,11 +20,8 @@ class NextCLI extends react_1.ReactCLI {
     execute() {
         super.execute();
     }
-    scanForContent(options, framework, errors, warnings) {
-        return (0, scanForContent_1.default)(options, pkg, errors, warnings);
-    }
-    createInlineUpdates(options) {
-        return (0, createInlineUpdates_1.default)(options, pkg);
+    wrapContent(options, framework, errors, warnings) {
+        return (0, wrapContent_1.default)(options, pkg, errors, warnings);
     }
 }
 exports.NextCLI = NextCLI;

package/dist/cli/react.d.ts

@@ -1,25 +1,18 @@
-import { Options, SupportedFrameworks, Updates, WrapOptions, GenerateSourceOptions, SupportedLibraries } from '../types';
+import { Options, SupportedFrameworks, WrapOptions, GenerateSourceOptions, SupportedLibraries } from '../types';
 import { BaseCLI } from './base';
 export declare class ReactCLI extends BaseCLI {
-    constructor(library: SupportedLibraries, additionalModules?: SupportedLibraries[]);
+    constructor(library: 'gt-react' | 'gt-next', additionalModules?: SupportedLibraries[]);
     init(): void;
     execute(): void;
-    protected scanForContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
+    protected wrapContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
         filesUpdated: string[];
     }>;
-    protected createDictionaryUpdates(options: Options, dictionaryPath: string, esbuildConfig?: any): Promise<Updates>;
-    protected createInlineUpdates(options: Options): Promise<{
-        updates: Updates;
-        errors: string[];
-    }>;
+    protected setupStageCommand(): void;
     protected setupTranslateCommand(): void;
     protected setupGenerateSourceCommand(): void;
     protected setupScanCommand(): void;
     protected handleGenerateSourceCommand(initOptions: GenerateSourceOptions): Promise<void>;
     protected handleScanCommand(options: WrapOptions): Promise<void>;
-    protected handleTranslateCommand(initOptions: Options): Promise<void>;
-    protected createUpdates(options: Options | GenerateSourceOptions, sourceDictionary: string | undefined): Promise<{
-        updates: Updates;
-        errors: string[];
-    }>;
+    protected handleStage(initOptions: Options): Promise<void>;
+    protected handleTranslate(initOptions: Options): Promise<void>;
 }

package/dist/cli/react.js

@@ -51,22 +51,19 @@ const commander_1 = require("commander");
 const console_1 = require("../console/console");
 const loadJSON_1 = __importDefault(require("../fs/loadJSON"));
 const findFilepath_1 = __importStar(require("../fs/findFilepath"));
-const createESBuildConfig_1 = __importDefault(require("../react/config/createESBuildConfig"));
 const chalk_1 = __importDefault(require("chalk"));
 const postProcess_1 = require("../hooks/postProcess");
-const fetchTranslations_1 = require("../api/fetchTranslations");
 const base_1 = require("./base");
-const scanForContent_1 = __importDefault(require("../react/parse/scanForContent"));
-const createDictionaryUpdates_1 = __importDefault(require("../react/parse/createDictionaryUpdates"));
-const createInlineUpdates_1 = __importDefault(require("../react/parse/createInlineUpdates"));
+const wrapContent_1 = __importDefault(require("../react/parse/wrapContent"));
 const utils_1 = require("../fs/utils");
-const sendUpdates_1 = require("../api/sendUpdates");
-const save_1 = require("../formats/gt/save");
 const generateSettings_1 = require("../config/generateSettings");
 const saveJSON_1 = require("../fs/saveJSON");
 const parseFilesConfig_1 = require("../fs/config/parseFilesConfig");
-const node_fs_1 = __importDefault(require("node:fs"));
 const errors_1 = require("../console/errors");
+const stage_1 = require("../translation/stage");
+const parse_1 = require("../translation/parse");
+const translate_1 = require("../translation/translate");
+const updateConfig_1 = __importDefault(require("../fs/config/updateConfig"));
 const DEFAULT_TIMEOUT = 600;
 const pkg = 'gt-react';
 class ReactCLI extends base_1.BaseCLI {
@@ -74,6 +71,7 @@ class ReactCLI extends base_1.BaseCLI {
         super(library, additionalModules);
     }
     init() {
+        this.setupStageCommand();
         this.setupTranslateCommand();
         this.setupScanCommand();
         this.setupGenerateSourceCommand();
@@ -81,19 +79,36 @@ class ReactCLI extends base_1.BaseCLI {
     execute() {
         super.execute();
     }
-    scanForContent(options, framework, errors, warnings) {
-        return (0, scanForContent_1.default)(options, pkg, framework, errors, warnings);
+    wrapContent(options, framework, errors, warnings) {
+        return (0, wrapContent_1.default)(options, pkg, framework, errors, warnings);
     }
-    createDictionaryUpdates(options, dictionaryPath, esbuildConfig) {
-        return (0, createDictionaryUpdates_1.default)(options, dictionaryPath, esbuildConfig);
-    }
-    createInlineUpdates(options) {
-        return (0, createInlineUpdates_1.default)(options, pkg);
+    setupStageCommand() {
+        commander_1.program
+            .command('stage')
+            .description('Submits the project to the General Translation API for translation. Translations created using this command will require human approval.')
+            .option('--config <path>', 'Filepath to config file, by default gt.config.json', (0, findFilepath_1.default)(['gt.config.json']))
+            .option('--api-key <key>', 'API key for General Translation cloud service')
+            .option('--project-id <id>', 'Project ID for the translation service', (0, utils_1.resolveProjectId)())
+            .option('--version-id <id>', 'Version ID for the translation service')
+            .option('--tsconfig, --jsconfig <path>', 'Path to jsconfig or tsconfig file', (0, findFilepath_1.default)(['./tsconfig.json', './jsconfig.json']))
+            .option('--dictionary <path>', 'Path to dictionary file')
+            .option('--src <paths...>', "Filepath to directory containing the app's source code, by default ./src || ./app || ./pages || ./components")
+            .option('--default-language, --default-locale <locale>', 'Default locale (e.g., en)')
+            .option('--new, --locales <locales...>', 'Space-separated list of locales (e.g., en fr es)')
+            .option('--inline', 'Include inline <T> tags in addition to dictionary file', true)
+            .option('--ignore-errors', 'Ignore errors encountered while scanning for <T> tags', false)
+            .option('--dry-run', 'Dry run, does not send updates to General Translation API', false)
+            .option('--timeout <seconds>', 'Timeout in seconds for waiting for updates to be deployed to the CDN', DEFAULT_TIMEOUT.toString())
+            .action((options) => __awaiter(this, void 0, void 0, function* () {
+            (0, console_1.displayHeader)('Staging project for translation with approval...');
+            yield this.handleStage(options);
+            (0, console_1.endCommand)('Done!');
+        }));
     }
     setupTranslateCommand() {
         commander_1.program
             .command('translate')
-            .description('Scans the project for a dictionary and/or <T> tags, and updates the General Translation remote dictionary with the latest content.')
+            .description('Scans the project for a dictionary and/or <T> tags, and sends the updates to the General Translation API for translation.')
             .option('--config <path>', 'Filepath to config file, by default gt.config.json', (0, findFilepath_1.default)(['gt.config.json']))
             .option('--api-key <key>', 'API key for General Translation cloud service')
             .option('--project-id <id>', 'Project ID for the translation service', (0, utils_1.resolveProjectId)())
@@ -106,15 +121,10 @@ class ReactCLI extends base_1.BaseCLI {
             .option('--inline', 'Include inline <T> tags in addition to dictionary file', true)
             .option('--ignore-errors', 'Ignore errors encountered while scanning for <T> tags', false)
             .option('--dry-run', 'Dry run, does not send updates to General Translation API', false)
-            .option('--no-wait', 'Do not wait for the updates to be deployed to the CDN before exiting', true // Default value of options.wait
-        )
-            .option('--publish', 'Publish updates to the CDN.', false // Default value of options.publish
-        )
-            .option('-t, --translations-dir, --translation-dir <path>', 'Path to directory where translations will be saved. If this flag is not provided, translations will not be saved locally.')
             .option('--timeout <seconds>', 'Timeout in seconds for waiting for updates to be deployed to the CDN', DEFAULT_TIMEOUT.toString())
             .action((options) => __awaiter(this, void 0, void 0, function* () {
             (0, console_1.displayHeader)('Translating project...');
-            yield this.handleTranslateCommand(options);
+            yield this.handleTranslate(options);
             (0, console_1.endCommand)('Done!');
         }));
     }
@@ -165,7 +175,7 @@ class ReactCLI extends base_1.BaseCLI {
             }
             // User has to provide a dictionary file
             // will not read from settings.files.resolvedPaths.json
-            const { updates, errors } = yield this.createUpdates(options, options.dictionary);
+            const { updates, errors } = yield (0, parse_1.createUpdates)(options, options.dictionary, this.library === 'gt-next' ? 'gt-next' : 'gt-react');
             if (errors.length > 0) {
                 if (options.ignoreErrors) {
                     (0, console_1.logWarning)(chalk_1.default.red(`CLI tool encountered errors while scanning for ${chalk_1.default.green('<T>')} tags. These components will not be translated.\n` +
@@ -190,10 +200,9 @@ class ReactCLI extends base_1.BaseCLI {
                     newData[hash] = source;
                 }
             }
-            const { placeholderPaths } = settings.files;
             // Save source file if files.json is provided
-            if (placeholderPaths.gt) {
-                const translationFiles = (0, parseFilesConfig_1.resolveLocaleFiles)(placeholderPaths, settings.defaultLocale);
+            if (settings.files && settings.files.placeholderPaths.gt) {
+                const translationFiles = (0, parseFilesConfig_1.resolveLocaleFiles)(settings.files.placeholderPaths, settings.defaultLocale);
                 if (!translationFiles.gt) {
                     (0, console_1.logError)(errors_1.noFilesError);
                     process.exit(1);
@@ -202,7 +211,7 @@ class ReactCLI extends base_1.BaseCLI {
                 (0, console_1.logStep)('Source file saved successfully!');
                 // Also save translations (after merging with existing translations)
                 for (const locale of settings.locales) {
-                    const translationsFile = (0, parseFilesConfig_1.resolveLocaleFiles)(placeholderPaths, locale);
+                    const translationsFile = (0, parseFilesConfig_1.resolveLocaleFiles)(settings.files.placeholderPaths, locale);
                     if (!translationsFile.gt) {
                         continue;
                     }
@@ -238,7 +247,7 @@ class ReactCLI extends base_1.BaseCLI {
             let errors = [];
             let warnings = [];
             // Wrap all JSX elements in the src directory with a <T> tag, with unique ids
-            const { filesUpdated } = yield this.scanForContent(options, 'react', errors, warnings);
+            const { filesUpdated } = yield this.wrapContent(options, 'react', errors, warnings);
             if (errors.length > 0) {
                 (0, console_1.logError)(chalk_1.default.red('Failed to write files:\n') + errors.join('\n'));
             }
@@ -259,156 +268,53 @@ class ReactCLI extends base_1.BaseCLI {
             }
         });
     }
-    handleTranslateCommand(initOptions) {
+    handleStage(initOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const settings = yield (0, generateSettings_1.generateSettings)(initOptions);
+            // First run the base class's handleTranslate method
+            const options = Object.assign(Object.assign({}, initOptions), settings);
+            if (!settings.stageTranslations) {
+                // Update settings.stageTranslations to true
+                settings.stageTranslations = true;
+                yield (0, updateConfig_1.default)({
+                    configFilepath: options.config,
+                    stageTranslations: true,
+                });
+            }
+            const pkg = this.library === 'gt-next' ? 'gt-next' : 'gt-react';
+            yield (0, stage_1.stageProject)(options, pkg);
+        });
+    }
+    handleTranslate(initOptions) {
         const _super = Object.create(null, {
             handleGenericTranslate: { get: () => super.handleGenericTranslate }
         });
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
             const settings = yield (0, generateSettings_1.generateSettings)(initOptions);
             // First run the base class's handleTranslate method
             const options = Object.assign(Object.assign({}, initOptions), settings);
-            if (!options.dryRun) {
-                try {
-                    yield _super.handleGenericTranslate.call(this, settings);
-                    // If the base class's handleTranslate completes successfully, continue with ReactCLI-specific code
-                }
-                catch (error) {
-                    // Continue with ReactCLI-specific code even if base handleTranslate failed
-                }
-            }
-            if (!options.dictionary) {
-                options.dictionary = (0, findFilepath_1.default)([
-                    './dictionary.js',
-                    './src/dictionary.js',
-                    './dictionary.json',
-                    './src/dictionary.json',
-                    './dictionary.ts',
-                    './src/dictionary.ts',
-                ]);
-            }
-            let sourceFile;
-            // If options.dictionary is provided, use options.dictionary as the source file
-            if (options.dictionary) {
-                sourceFile = options.dictionary;
-            }
-            // Separate defaultLocale from locales
-            options.locales = options.locales.filter((locale) => locale !== options.defaultLocale);
-            // validate timeout
-            const timeout = parseInt(options.timeout);
-            if (isNaN(timeout) || timeout < 0) {
-                (0, console_1.logErrorAndExit)(`Invalid timeout: ${options.timeout}. Must be a positive integer.`);
-            }
-            options.timeout = timeout.toString();
-            // ---- CREATING UPDATES ---- //
-            const { updates, errors } = yield this.createUpdates(options, sourceFile);
-            if (errors.length > 0) {
-                if (options.ignoreErrors) {
-                    (0, console_1.logWarning)(chalk_1.default.red(`CLI tool encountered errors while scanning for ${chalk_1.default.green('<T>')} tags. These components will not be translated.\n` +
-                        errors
-                            .map((error) => chalk_1.default.yellow('• Warning: ') + error + '\n')
-                            .join('')));
-                }
-                else {
-                    (0, console_1.logError)(chalk_1.default.red(`CLI tool encountered errors while scanning for ${chalk_1.default.green('<T>')} tags. ${chalk_1.default.gray('To ignore these errors, re-run with --ignore-errors')}\n` +
-                        errors
-                            .map((error) => chalk_1.default.red('• Error: ') + error + '\n')
-                            .join('')));
-                }
+            try {
+                yield _super.handleGenericTranslate.call(this, options);
+                // If the base class's handleTranslate completes successfully, continue with ReactCLI-specific code
             }
-            // If files.gt.output is not provided in the config, publish the translations
-            if (!((_b = (_a = settings.files) === null || _a === void 0 ? void 0 : _a.resolvedPaths) === null || _b === void 0 ? void 0 : _b.gt)) {
-                options.publish = true;
+            catch (error) {
+                // Continue with ReactCLI-specific code even if base handleTranslate failed
             }
-            if (options.dryRun) {
-                (0, console_1.logSuccess)('Dry run complete. No translations were sent to General Translation.');
-                process.exit(0);
-            }
-            // Send updates to General Translation API
-            if (updates.length) {
-                // Error if no API key at this point
-                if (!settings.apiKey) {
-                    (0, console_1.logError)(chalk_1.default.red('No General Translation API key found. Provide one via the --api-key flag or as the GT_API_KEY environment variable.'));
-                    process.exit(1);
-                }
-                // Error if no projectId at this point
-                if (!settings.projectId) {
-                    (0, console_1.logError)(chalk_1.default.red('No General Translation Project ID found. Provide one via the --project-id flag, gt.config.json, or the GT_PROJECT_ID environment variable.'));
-                    process.exit(1);
-                }
-                const updateResponse = yield (0, sendUpdates_1.sendUpdates)(updates, Object.assign(Object.assign({}, settings), { publish: options.publish, wait: options.wait, timeout: options.timeout, dataFormat: 'JSX' }), this.library);
-                const versionId = updateResponse === null || updateResponse === void 0 ? void 0 : updateResponse.versionId;
-                // Save translations to local directory if files.gt.output is provided
-                if (versionId && options.files.placeholderPaths.gt) {
-                    const translations = yield (0, fetchTranslations_1.fetchTranslations)(settings.baseUrl, settings.apiKey, versionId);
-                    yield (0, save_1.saveTranslations)(translations, options.files.placeholderPaths, 'JSX');
+            if (!settings.stageTranslations) {
+                // If stageTranslations is false, stage the project
+                const pkg = this.library === 'gt-next' ? 'gt-next' : 'gt-react';
+                const results = yield (0, stage_1.stageProject)(options, pkg);
+                if (results) {
+                    yield (0, translate_1.translate)(options, results.versionId);
                 }
             }
             else {
-                (0, console_1.logError)(chalk_1.default.red(`No in-line content or dictionaries were found for ${chalk_1.default.green(this.library)}. Are you sure you're running this command in the right directory?`));
-            }
-        });
-    }
-    createUpdates(options, sourceDictionary) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let updates = [];
-            let errors = [];
-            // Parse dictionary with esbuildConfig
-            if (sourceDictionary &&
-                node_fs_1.default.existsSync(sourceDictionary) &&
-                node_fs_1.default.statSync(sourceDictionary).isFile()) {
-                if (sourceDictionary.endsWith('.json')) {
-                    updates = [
-                        ...updates,
-                        ...(yield this.createDictionaryUpdates(options, sourceDictionary)),
-                    ];
-                }
-                else {
-                    let esbuildConfig;
-                    if (options.jsconfig) {
-                        const jsconfig = (0, loadJSON_1.default)(options.jsconfig);
-                        if (!jsconfig) {
-                            (0, console_1.logError)(`Failed to resolve jsconfig.json or tsconfig.json at provided filepath: "${options.jsconfig}"`);
-                            process.exit(1);
-                        }
-                        esbuildConfig = (0, createESBuildConfig_1.default)(jsconfig);
-                    }
-                    else {
-                        esbuildConfig = (0, createESBuildConfig_1.default)({});
-                    }
-                    updates = [
-                        ...updates,
-                        ...(yield this.createDictionaryUpdates(options, sourceDictionary, esbuildConfig)),
-                    ];
+                if (!settings._versionId) {
+                    (0, console_1.logError)(errors_1.noVersionIdError);
+                    process.exit(1);
                 }
+                yield (0, translate_1.translate)(options, settings._versionId);
             }
-            // Scan through project for <T> tags
-            if (options.inline) {
-                const { updates: newUpdates, errors: newErrors } = yield this.createInlineUpdates(options);
-                errors = [...errors, ...newErrors];
-                updates = [...updates, ...newUpdates];
-            }
-            // Metadata addition and validation
-            const idHashMap = new Map();
-            const duplicateIds = new Set();
-            updates = updates.map((update) => {
-                if (!update.metadata.id)
-                    return update;
-                const existingHash = idHashMap.get(update.metadata.id);
-                if (existingHash) {
-                    if (existingHash !== update.metadata.hash) {
-                        errors.push(`Hashes don't match on two components with the same id: ${chalk_1.default.blue(update.metadata.id)}. Check your ${chalk_1.default.green('<T>')} tags and dictionary entries and make sure you're not accidentally duplicating IDs.`);
-                        duplicateIds.add(update.metadata.id);
-                    }
-                }
-                else {
-                    idHashMap.set(update.metadata.id, update.metadata.hash);
-                }
-                return update;
-            });
-            // Filter out updates with duplicate IDs
-            updates = updates.filter((update) => !duplicateIds.has(update.metadata.id));
-            return { updates, errors };
         });
     }
 }

package/dist/config/generateSettings.js

@@ -30,7 +30,7 @@ const constants_1 = require("../utils/constants");
  */
 function generateSettings(options) {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a;
+        var _a, _b;
         // Load config file
         let gtConfig = {};
         if (options.config && !options.config.endsWith('.json')) {
@@ -79,19 +79,24 @@ function generateSettings(options) {
         // Display projectId if present
         if (mergedOptions.projectId)
             (0, console_1.displayProjectId)(mergedOptions.projectId);
+        // Add stageTranslations if not provided
+        // For human review, always stage the project
+        mergedOptions.stageTranslations = (_a = mergedOptions.stageTranslations) !== null && _a !== void 0 ? _a : false;
         // Populate src if not provided
         mergedOptions.src =
             mergedOptions.src ||
                 (0, findFilepath_1.findFilepaths)(['./src', './app', './pages', './components']);
         // Resolve all glob patterns in the files object
-        mergedOptions.files = (0, parseFilesConfig_1.resolveFiles)(mergedOptions.files || {}, mergedOptions.defaultLocale);
+        mergedOptions.files = mergedOptions.files
+            ? (0, parseFilesConfig_1.resolveFiles)(mergedOptions.files, mergedOptions.defaultLocale)
+            : undefined;
         // if there's no existing config file, creates one
         // does not include the API key to avoid exposing it
         if (!node_fs_1.default.existsSync(mergedOptions.config)) {
             yield (0, setupConfig_1.default)(mergedOptions.config, {
                 projectId: mergedOptions.projectId,
                 defaultLocale: mergedOptions.defaultLocale,
-                locales: ((_a = mergedOptions.locales) === null || _a === void 0 ? void 0 : _a.length) > 0 ? mergedOptions.locales : undefined,
+                locales: ((_b = mergedOptions.locales) === null || _b === void 0 ? void 0 : _b.length) > 0 ? mergedOptions.locales : undefined,
             });
         }
         (0, validateSettings_1.validateSettings)(mergedOptions);

package/dist/console/index.d.ts

@@ -14,3 +14,4 @@ export declare const noDataFormatError = "No data format found! Please make sure
 export declare const noSupportedDataFormatError = "Unsupported data format! Please make sure your translationsDir parameter ends with a supported file extension.";
 export declare const noApiKeyError = "No API key found! Please provide an API key using the --api-key flag or set the GT_API_KEY environment variable.";
 export declare const noProjectIdError = "No project ID found! Please provide a project ID using the --project-id flag, specify it in your gt.config.json file, or set the GT_PROJECT_ID environment variable.";
+export declare const noVersionIdError = "No version ID found! Please provide a version ID using the --version-id flag or specify it in your gt.config.json file as the _versionId property.";

package/dist/console/index.js

@@ -14,10 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.noProjectIdError = exports.noApiKeyError = exports.noSupportedDataFormatError = exports.noDataFormatError = exports.noSourceFileError = exports.noFilesError = exports.noDefaultLocaleError = exports.noLocalesError = exports.warnTernarySync = exports.warnTemplateLiteralSync = exports.warnNonStaticExpressionSync = exports.warnHasUnwrappedExpressionSync = exports.warnNoIdSync = exports.warnVariablePropSync = exports.warnApiKeyInConfigSync = void 0;
+exports.noVersionIdError = exports.noProjectIdError = exports.noApiKeyError = exports.noSupportedDataFormatError = exports.noDataFormatError = exports.noSourceFileError = exports.noFilesError = exports.noDefaultLocaleError = exports.noLocalesError = exports.warnTernarySync = exports.warnTemplateLiteralSync = exports.warnNonStaticExpressionSync = exports.warnHasUnwrappedExpressionSync = exports.warnNoIdSync = exports.warnVariablePropSync = exports.warnApiKeyInConfigSync = void 0;
 // Export all logging functions
 __exportStar(require("./logging"), exports);
-// Synchronous wrappers for backward compatibility 
+// Synchronous wrappers for backward compatibility
 const warnApiKeyInConfigSync = (optionsFilepath) => `Found apiKey in "${optionsFilepath}". Your API key is exposed! Please remove it from the file and include it as an environment variable.`;
 exports.warnApiKeyInConfigSync = warnApiKeyInConfigSync;
 const warnVariablePropSync = (file, attrName, value) => `Found <T> component in ${file} with variable ${attrName}: "${value}". Change "${attrName}" to ensure this content is translated.`;
@@ -41,3 +41,4 @@ exports.noDataFormatError = `No data format found! Please make sure your transla
 exports.noSupportedDataFormatError = `Unsupported data format! Please make sure your translationsDir parameter ends with a supported file extension.`;
 exports.noApiKeyError = `No API key found! Please provide an API key using the --api-key flag or set the GT_API_KEY environment variable.`;
 exports.noProjectIdError = `No project ID found! Please provide a project ID using the --project-id flag, specify it in your gt.config.json file, or set the GT_PROJECT_ID environment variable.`;
+exports.noVersionIdError = `No version ID found! Please provide a version ID using the --version-id flag or specify it in your gt.config.json file as the _versionId property.`;

package/dist/formats/files/translate.d.ts

@@ -1,5 +1,6 @@
 import { ResolvedFiles, Settings, TransformFiles } from '../../types';
 import { DataFormat } from '../../types/data';
+import { TranslateOptions } from '../../cli/base';
 /**
  * Sends multiple files to the API for translation
  * @param filePaths - Resolved file paths for different file types
@@ -10,4 +11,4 @@ import { DataFormat } from '../../types/data';
  * @param options - Translation options including API settings
  * @returns Promise that resolves when translation is complete
  */
-export declare function translateFiles(filePaths: ResolvedFiles, placeholderPaths: ResolvedFiles, transformPaths: TransformFiles, dataFormat: DataFormat | undefined, options: Settings): Promise<void>;
+export declare function translateFiles(filePaths: ResolvedFiles, placeholderPaths: ResolvedFiles, transformPaths: TransformFiles, dataFormat: DataFormat | undefined, options: Settings & TranslateOptions): Promise<void>;

package/dist/formats/files/translate.js

@@ -77,9 +77,26 @@ function translateFiles(filePaths_1, placeholderPaths_1, transformPaths_1) {
             }
         }
         if (allFiles.length === 0) {
-            (0, console_1.logError)('No files to translate');
+            (0, console_1.logError)('No files to translate were found. Please check your configuration and try again.');
             return;
         }
+        if (options.dryRun) {
+            (0, console_1.logSuccess)('Dry run: No files were sent to General Translation.');
+            return;
+        }
+        // Validate required settings are present
+        if (!options.locales) {
+            (0, console_1.logErrorAndExit)(console_1.noLocalesError);
+        }
+        if (!options.defaultLocale) {
+            (0, console_1.logErrorAndExit)(console_1.noDefaultLocaleError);
+        }
+        if (!options.apiKey) {
+            (0, console_1.logErrorAndExit)(console_1.noApiKeyError);
+        }
+        if (!options.projectId) {
+            (0, console_1.logErrorAndExit)(console_1.noProjectIdError);
+        }
         try {
             // Send all files in a single API call
             const response = yield (0, sendFiles_1.sendFiles)(allFiles, Object.assign(Object.assign({}, options), { publish: false, wait: true }));

package/dist/fs/config/updateConfig.d.ts

@@ -2,9 +2,10 @@
  * Update the config file version id, locales, and projectId (if necessary)
  * @param {Record<string, any>} configObject - The config object to write if the file does not exist.
  */
-export default function updateConfig({ configFilepath, projectId, _versionId, locales, }: {
+export default function updateConfig({ configFilepath, projectId, _versionId, locales, stageTranslations, }: {
     configFilepath: string;
     projectId?: string;
     _versionId?: string;
     locales?: string[];
+    stageTranslations?: boolean;
 }): Promise<void>;

package/dist/fs/config/updateConfig.js

@@ -20,9 +20,9 @@ const console_1 = require("../../console/console");
  * @param {Record<string, any>} configObject - The config object to write if the file does not exist.
  */
 function updateConfig(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ configFilepath, projectId, _versionId, locales, }) {
+    return __awaiter(this, arguments, void 0, function* ({ configFilepath, projectId, _versionId, locales, stageTranslations, }) {
         // Filter out empty string values from the config object
-        const newContent = Object.assign(Object.assign({}, (projectId && { projectId })), (_versionId && { _versionId }));
+        const newContent = Object.assign(Object.assign(Object.assign({}, (projectId && { projectId })), (_versionId && { _versionId })), (stageTranslations && { stageTranslations }));
         try {
             // if file exists
             let oldContent = {};

package/dist/next/parse/{scanForContent.d.ts → wrapContent.d.ts}

@@ -6,6 +6,6 @@ import { WrapOptions } from '../../types';
  * @param options - The options object
  * @returns An object containing the updates and errors
  */
-export default function scanForContentNext(options: WrapOptions, pkg: 'gt-next', errors: string[], warnings: string[]): Promise<{
+export default function wrapContentNext(options: WrapOptions, pkg: 'gt-next', errors: string[], warnings: string[]): Promise<{
     filesUpdated: string[];
 }>;

package/dist/next/parse/{scanForContent.js → wrapContent.js}

@@ -45,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = scanForContentNext;
+exports.default = wrapContentNext;
 const node_fs_1 = __importDefault(require("node:fs"));
 const t = __importStar(require("@babel/types"));
 const parser_1 = require("@babel/parser");
@@ -72,7 +72,7 @@ const IMPORT_MAP = {
  * @param options - The options object
  * @returns An object containing the updates and errors
  */
-function scanForContentNext(options, pkg, errors, warnings) {
+function wrapContentNext(options, pkg, errors, warnings) {
     return __awaiter(this, void 0, void 0, function* () {
         const srcDirectory = options.src || ['./'];
         const files = srcDirectory.flatMap((dir) => (0, findJsxFilepath_1.getFiles)(dir));

package/dist/react/parse/{scanForContent.d.ts → wrapContent.d.ts}

@@ -6,6 +6,6 @@ import { SupportedFrameworks, WrapOptions } from '../../types';
  * @param options - The options object
  * @returns An object containing the updates and errors
  */
-export default function scanForContentReact(options: WrapOptions, pkg: 'gt-react', framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
+export default function wrapContentReact(options: WrapOptions, pkg: 'gt-react', framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
     filesUpdated: string[];
 }>;

package/dist/react/parse/{scanForContent.js → wrapContent.js}

@@ -45,7 +45,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = scanForContentReact;
+exports.default = wrapContentReact;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const t = __importStar(require("@babel/types"));
@@ -72,7 +72,7 @@ const IMPORT_MAP = {
  * @param options - The options object
  * @returns An object containing the updates and errors
  */
-function scanForContentReact(options, pkg, framework, errors, warnings) {
+function wrapContentReact(options, pkg, framework, errors, warnings) {
     return __awaiter(this, void 0, void 0, function* () {
         const srcDirectory = options.src || ['./'];
         const files = srcDirectory.flatMap((dir) => (0, findJsxFilepath_1.getFiles)(dir));

package/dist/setup/wizard.js

@@ -23,8 +23,8 @@ const generateSettings_1 = require("../config/generateSettings");
 const postProcess_2 = require("../hooks/postProcess");
 const handleInitGT_1 = __importDefault(require("../next/parse/handleInitGT"));
 const packageJson_1 = require("../utils/packageJson");
-const scanForContent_1 = __importDefault(require("../react/parse/scanForContent"));
-const scanForContent_2 = __importDefault(require("../next/parse/scanForContent"));
+const wrapContent_1 = __importDefault(require("../react/parse/wrapContent"));
+const wrapContent_2 = __importDefault(require("../next/parse/wrapContent"));
 const packageManager_1 = require("../utils/packageManager");
 const installPackage_1 = require("../utils/installPackage");
 function handleSetupReactCommand(options) {
@@ -111,7 +111,7 @@ Please let us know what you would like to see supported at https://github.com/ge
             const spinner = (0, console_1.createSpinner)();
             spinner.start('Wrapping JSX content with <T> tags...');
             // Wrap all JSX elements in the src directory with a <T> tag, with unique ids
-            const { filesUpdated: filesUpdatedNext } = yield (0, scanForContent_2.default)(mergeOptions, 'gt-next', errors, warnings);
+            const { filesUpdated: filesUpdatedNext } = yield (0, wrapContent_2.default)(mergeOptions, 'gt-next', errors, warnings);
             filesUpdated = [...filesUpdated, ...filesUpdatedNext];
             spinner.stop(chalk_1.default.green(`Success! Added <T> tags and updated ${chalk_1.default.bold.cyan(filesUpdated.length)} files:\n`) + filesUpdated.map((file) => `${chalk_1.default.green('-')} ${file}`).join('\n'));
             if (addWithGTConfig) {
@@ -141,7 +141,7 @@ Please let us know what you would like to see supported at https://github.com/ge
             const spinner = (0, console_1.createSpinner)();
             spinner.start('Wrapping JSX content with <T> tags...');
             // Wrap all JSX elements in the src directory with a <T> tag, with unique ids
-            const { filesUpdated: filesUpdatedReact } = yield (0, scanForContent_1.default)(mergeOptions, 'gt-react', frameworkType, errors, warnings);
+            const { filesUpdated: filesUpdatedReact } = yield (0, wrapContent_1.default)(mergeOptions, 'gt-react', frameworkType, errors, warnings);
             filesUpdated = [...filesUpdated, ...filesUpdatedReact];
             spinner.stop(chalk_1.default.green(`Success! Added <T> tags and updated ${chalk_1.default.bold.cyan(filesUpdated.length)} files:\n`) + filesUpdated.map((file) => `${chalk_1.default.green('-')} ${file}`).join('\n'));
             if (errors.length > 0) {

package/dist/translation/parse.d.ts

@@ -0,0 +1,14 @@
+import { Options, GenerateSourceOptions, Updates } from '../types';
+/**
+ * Searches for gt-react or gt-next dictionary files and creates updates for them,
+ * as well as inline updates for <T> tags and useGT()/getGT() calls
+ *
+ * @param options - The options object
+ * @param sourceDictionary - The source dictionary file path
+ * @param pkg - The package name
+ * @returns An object containing the updates and errors
+ */
+export declare function createUpdates(options: Options | GenerateSourceOptions, sourceDictionary: string | undefined, pkg: 'gt-react' | 'gt-next'): Promise<{
+    updates: Updates;
+    errors: string[];
+}>;

package/dist/translation/parse.js

@@ -0,0 +1,93 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUpdates = createUpdates;
+const fs_1 = __importDefault(require("fs"));
+const logging_1 = require("../console/logging");
+const loadJSON_1 = __importDefault(require("../fs/loadJSON"));
+const createDictionaryUpdates_1 = __importDefault(require("../react/parse/createDictionaryUpdates"));
+const createInlineUpdates_1 = __importDefault(require("../react/parse/createInlineUpdates"));
+const createESBuildConfig_1 = __importDefault(require("../react/config/createESBuildConfig"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Searches for gt-react or gt-next dictionary files and creates updates for them,
+ * as well as inline updates for <T> tags and useGT()/getGT() calls
+ *
+ * @param options - The options object
+ * @param sourceDictionary - The source dictionary file path
+ * @param pkg - The package name
+ * @returns An object containing the updates and errors
+ */
+function createUpdates(options, sourceDictionary, pkg) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let updates = [];
+        let errors = [];
+        // Parse dictionary with esbuildConfig
+        if (sourceDictionary &&
+            fs_1.default.existsSync(sourceDictionary) &&
+            fs_1.default.statSync(sourceDictionary).isFile()) {
+            if (sourceDictionary.endsWith('.json')) {
+                updates = [
+                    ...updates,
+                    ...(yield (0, createDictionaryUpdates_1.default)(options, sourceDictionary)),
+                ];
+            }
+            else {
+                let esbuildConfig;
+                if (options.jsconfig) {
+                    const jsconfig = (0, loadJSON_1.default)(options.jsconfig);
+                    if (!jsconfig) {
+                        (0, logging_1.logError)(`Failed to resolve jsconfig.json or tsconfig.json at provided filepath: "${options.jsconfig}"`);
+                        process.exit(1);
+                    }
+                    esbuildConfig = (0, createESBuildConfig_1.default)(jsconfig);
+                }
+                else {
+                    esbuildConfig = (0, createESBuildConfig_1.default)({});
+                }
+                updates = [
+                    ...updates,
+                    ...(yield (0, createDictionaryUpdates_1.default)(options, sourceDictionary, esbuildConfig)),
+                ];
+            }
+        }
+        // Scan through project for <T> tags
+        if (options.inline) {
+            const { updates: newUpdates, errors: newErrors } = yield (0, createInlineUpdates_1.default)(options, pkg);
+            errors = [...errors, ...newErrors];
+            updates = [...updates, ...newUpdates];
+        }
+        // Metadata addition and validation
+        const idHashMap = new Map();
+        const duplicateIds = new Set();
+        updates = updates.map((update) => {
+            if (!update.metadata.id)
+                return update;
+            const existingHash = idHashMap.get(update.metadata.id);
+            if (existingHash) {
+                if (existingHash !== update.metadata.hash) {
+                    errors.push(`Hashes don't match on two components with the same id: ${chalk_1.default.blue(update.metadata.id)}. Check your ${chalk_1.default.green('<T>')} tags and dictionary entries and make sure you're not accidentally duplicating IDs.`);
+                    duplicateIds.add(update.metadata.id);
+                }
+            }
+            else {
+                idHashMap.set(update.metadata.id, update.metadata.hash);
+            }
+            return update;
+        });
+        // Filter out updates with duplicate IDs
+        updates = updates.filter((update) => !duplicateIds.has(update.metadata.id));
+        return { updates, errors };
+    });
+}

package/dist/translation/stage.d.ts

@@ -0,0 +1,5 @@
+import { Options, Settings } from '../types';
+export declare function stageProject(settings: Options & Settings, pkg: 'gt-react' | 'gt-next'): Promise<{
+    versionId: string;
+    locales: string[];
+} | null>;

package/dist/translation/stage.js

@@ -0,0 +1,84 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stageProject = stageProject;
+const errors_1 = require("../console/errors");
+const chalk_1 = __importDefault(require("chalk"));
+const findFilepath_1 = __importDefault(require("../fs/findFilepath"));
+const logging_1 = require("../console/logging");
+const parse_1 = require("./parse");
+const errors_2 = require("../console/errors");
+const sendUpdates_1 = require("../api/sendUpdates");
+function stageProject(settings, pkg) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!settings.dictionary) {
+            settings.dictionary = (0, findFilepath_1.default)([
+                './dictionary.js',
+                './src/dictionary.js',
+                './dictionary.json',
+                './src/dictionary.json',
+                './dictionary.ts',
+                './src/dictionary.ts',
+            ]);
+        }
+        // Separate defaultLocale from locales
+        settings.locales = settings.locales.filter((locale) => locale !== settings.defaultLocale);
+        // validate timeout
+        const timeout = parseInt(settings.timeout);
+        if (isNaN(timeout) || timeout < 0) {
+            (0, errors_1.logErrorAndExit)(`Invalid timeout: ${settings.timeout}. Must be a positive integer.`);
+        }
+        settings.timeout = timeout.toString();
+        // ---- CREATING UPDATES ---- //
+        const { updates, errors } = yield (0, parse_1.createUpdates)(settings, settings.dictionary, pkg);
+        if (errors.length > 0) {
+            if (settings.ignoreErrors) {
+                (0, logging_1.logWarning)(chalk_1.default.red(`CLI tool encountered errors while scanning for ${chalk_1.default.green('<T>')} tags. These components will not be translated.\n` +
+                    errors
+                        .map((error) => chalk_1.default.yellow('• Warning: ') + error + '\n')
+                        .join('')));
+            }
+            else {
+                (0, logging_1.logError)(chalk_1.default.red(`CLI tool encountered errors while scanning for ${chalk_1.default.green('<T>')} tags. ${chalk_1.default.gray('To ignore these errors, re-run with --ignore-errors')}\n` +
+                    errors
+                        .map((error) => chalk_1.default.red('• Error: ') + error + '\n')
+                        .join('')));
+            }
+        }
+        if (settings.dryRun) {
+            (0, logging_1.logSuccess)('Dry run: No translations were sent to General Translation.');
+            return null;
+        }
+        if (updates.length == 0) {
+            (0, logging_1.logError)(chalk_1.default.red(`No in-line content or dictionaries were found for ${chalk_1.default.green(pkg)}. Are you sure you're running this command in the right directory?`));
+            return null;
+        }
+        // Send updates to General Translation API
+        if (!settings.locales) {
+            (0, errors_1.logErrorAndExit)(errors_2.noLocalesError);
+        }
+        if (!settings.defaultLocale) {
+            (0, errors_1.logErrorAndExit)(errors_2.noDefaultLocaleError);
+        }
+        if (!settings.apiKey) {
+            (0, errors_1.logErrorAndExit)(errors_2.noApiKeyError);
+        }
+        if (!settings.projectId) {
+            (0, errors_1.logErrorAndExit)(errors_2.noProjectIdError);
+        }
+        const updateResponse = yield (0, sendUpdates_1.sendUpdates)(updates, Object.assign(Object.assign({}, settings), { timeout: settings.timeout, dataFormat: 'JSX' }), pkg);
+        const { versionId, locales } = updateResponse;
+        return { versionId, locales };
+    });
+}

package/dist/translation/translate.d.ts

@@ -0,0 +1,2 @@
+import { Options, Settings } from '../types';
+export declare function translate(settings: Options & Settings, versionId: string): Promise<void>;

package/dist/translation/translate.js

@@ -0,0 +1,31 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translate = translate;
+const fetchTranslations_1 = require("../api/fetchTranslations");
+const waitForUpdates_1 = require("../api/waitForUpdates");
+const save_1 = require("../formats/gt/save");
+function translate(settings, versionId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // timeout was validated earlier
+        const startTime = Date.now();
+        const timeout = parseInt(settings.timeout) * 1000;
+        const result = yield (0, waitForUpdates_1.waitForUpdates)(settings.apiKey, settings.baseUrl, versionId, startTime, timeout);
+        if (!result) {
+            process.exit(1);
+        }
+        const translations = yield (0, fetchTranslations_1.fetchTranslations)(settings.baseUrl, settings.apiKey, versionId);
+        // Save translations to local directory if files.gt.output is provided
+        if (settings.files && settings.files.placeholderPaths.gt) {
+            yield (0, save_1.saveTranslations)(translations, settings.files.placeholderPaths, 'JSX');
+        }
+    });
+}

package/dist/types/index.d.ts

@@ -26,9 +26,8 @@ export type Options = {
     inline?: boolean;
     ignoreErrors: boolean;
     dryRun: boolean;
-    wait: boolean;
     timeout: string;
-    publish: boolean;
+    stageTranslations?: boolean;
 };
 export type WrapOptions = {
     src: string[];
@@ -92,8 +91,10 @@ export type Settings = {
         resolvedPaths: ResolvedFiles;
         placeholderPaths: ResolvedFiles;
         transformPaths: TransformFiles;
-    };
-    versionId?: string;
+    } | undefined;
+    stageTranslations: boolean;
+    _versionId?: string;
+    version?: string;
     description?: string;
     src?: string[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gtx-cli",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "type": "commonjs",
   "main": "dist/index.js",
   "bin": "dist/main.js",