gtx-cli 2.3.6-alpha.2 → 2.3.6

package/dist/cli/base.js

@@ -0,0 +1,335 @@
+import { createOrUpdateConfig } from '../fs/config/setupConfig.js';
+import findFilepath from '../fs/findFilepath.js';
+import { displayHeader, promptText, logErrorAndExit, endCommand, promptConfirm, promptMultiSelect, logSuccess, logInfo, startCommand, createSpinner, logMessage, } from '../console/logging.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import { generateSettings } from '../config/generateSettings.js';
+import chalk from 'chalk';
+import { FILE_EXT_TO_EXT_LABEL } from '../formats/files/supportedFiles.js';
+import { handleSetupReactCommand } from '../setup/wizard.js';
+import { isPackageInstalled, searchForPackageJson, } from '../utils/packageJson.js';
+import { getDesiredLocales } from '../setup/userInput.js';
+import { installPackage } from '../utils/installPackage.js';
+import { getPackageManager } from '../utils/packageManager.js';
+import { retrieveCredentials, setCredentials } from '../utils/credentials.js';
+import { areCredentialsSet } from '../utils/credentials.js';
+import { upload } from '../formats/files/upload.js';
+import { attachTranslateFlags } from './flags.js';
+import { handleStage } from './commands/stage.js';
+import { handleDownload, handleTranslate, postProcessTranslations, } from './commands/translate.js';
+import updateConfig from '../fs/config/updateConfig.js';
+import { createLoadTranslationsFile } from '../fs/createLoadTranslationsFile.js';
+export class BaseCLI {
+    library;
+    additionalModules;
+    program;
+    // Constructor is shared amongst all CLI class types
+    constructor(program, library, additionalModules) {
+        this.program = program;
+        this.library = library;
+        this.additionalModules = additionalModules || [];
+        this.setupInitCommand();
+        this.setupConfigureCommand();
+        this.setupSetupCommand();
+        this.setupUploadCommand();
+        this.setupLoginCommand();
+    }
+    // Init is never called in a child class
+    init() {
+        this.setupTranslateCommand();
+    }
+    // Execute is called by the main program
+    execute() {
+        // If no command is specified, run 'init'
+        if (process.argv.length <= 2) {
+            process.argv.push('init');
+        }
+    }
+    setupStageCommand() {
+        attachTranslateFlags(this.program
+            .command('stage')
+            .description('Submits the project to the General Translation API for translation. Translations created using this command will require human approval.')).action(async (initOptions) => {
+            displayHeader('Staging project for translation with approval required...');
+            await this.handleStage(initOptions);
+            endCommand('Done!');
+        });
+    }
+    setupTranslateCommand() {
+        attachTranslateFlags(this.program
+            .command('translate')
+            .description('Translate your project using General Translation')).action(async (initOptions) => {
+            displayHeader('Starting translation...');
+            await this.handleTranslate(initOptions);
+            endCommand('Done!');
+        });
+    }
+    async handleStage(initOptions) {
+        const settings = await generateSettings(initOptions);
+        if (!settings.stageTranslations) {
+            // Update settings.stageTranslations to true
+            settings.stageTranslations = true;
+            await updateConfig({
+                configFilepath: settings.config,
+                stageTranslations: true,
+            });
+        }
+        await handleStage(initOptions, settings, this.library, true);
+    }
+    async handleTranslate(initOptions) {
+        const settings = await generateSettings(initOptions);
+        if (!settings.stageTranslations) {
+            const results = await handleStage(initOptions, settings, this.library, false);
+            if (results) {
+                await handleTranslate(initOptions, settings, results);
+            }
+        }
+        else {
+            await handleDownload(initOptions, settings);
+        }
+        await postProcessTranslations(settings);
+    }
+    setupUploadCommand() {
+        this.program
+            .command('upload')
+            .description('Upload source files and translations to the General Translation platform')
+            .option('-c, --config <path>', 'Filepath to config file, by default gt.config.json', findFilepath(['gt.config.json']))
+            .option('--api-key <key>', 'API key for General Translation cloud service')
+            .option('--project-id <id>', 'Project ID for the translation service')
+            .option('--default-language, --default-locale <locale>', 'Default locale (e.g., en)')
+            .action(async (initOptions) => {
+            displayHeader('Starting upload...');
+            const settings = await generateSettings(initOptions);
+            const options = { ...initOptions, ...settings };
+            await this.handleUploadCommand(options);
+            endCommand('Done!');
+        });
+    }
+    setupLoginCommand() {
+        this.program
+            .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', findFilepath(['gt.config.json']))
+            .option('-t, --key-type <type>', 'Type of key to generate, production | development')
+            .action(async (options) => {
+            displayHeader('Authenticating with General Translation...');
+            if (!options.keyType) {
+                const packageJson = await searchForPackageJson();
+                const isUsingGTNext = packageJson
+                    ? isPackageInstalled('gt-next', packageJson)
+                    : false;
+                const isUsingGTReact = packageJson
+                    ? isPackageInstalled('gt-react', packageJson)
+                    : false;
+                if (isUsingGTNext || isUsingGTReact) {
+                    options.keyType = 'development';
+                }
+                else {
+                    options.keyType = 'production';
+                }
+            }
+            else {
+                if (options.keyType !== 'development' &&
+                    options.keyType !== 'production') {
+                    logErrorAndExit('Invalid key type, must be development or production');
+                }
+            }
+            await this.handleLoginCommand(options);
+            endCommand(`Done! A ${options.keyType} key has been generated and saved to your .env.local file.`);
+        });
+    }
+    setupInitCommand() {
+        this.program
+            .command('init')
+            .description('Run the setup wizard to configure your project for General Translation')
+            .option('--src <paths...>', "Space-separated list of glob patterns containing the app's source code, by default 'src/**/*.{js,jsx,ts,tsx}' 'app/**/*.{js,jsx,ts,tsx}' 'pages/**/*.{js,jsx,ts,tsx}' 'components/**/*.{js,jsx,ts,tsx}'")
+            .option('-c, --config <path>', 'Filepath to config file, by default gt.config.json', findFilepath(['gt.config.json']))
+            .action(async (options) => {
+            displayHeader('Running setup wizard...');
+            const packageJson = await searchForPackageJson();
+            let ranReactSetup = false;
+            // so that people can run init in non-js projects
+            if (packageJson && isPackageInstalled('react', packageJson)) {
+                const wrap = await promptConfirm({
+                    message: `Detected that this project is using React. Would you like to run the React setup wizard?\nThis will install gt-react|gt-next as a dependency and internationalize your app.`,
+                    defaultValue: true,
+                });
+                if (wrap) {
+                    logInfo(`${chalk.yellow('[EXPERIMENTAL]')} Running React setup wizard...`);
+                    await this.handleSetupReactCommand(options);
+                    endCommand(`Done! Since this wizard is experimental, please review the changes and make modifications as needed.
+Certain aspects of your app may still need manual setup.
+See the docs for more information: https://generaltranslation.com/docs/react/tutorials/quickstart`);
+                    ranReactSetup = true;
+                }
+            }
+            if (ranReactSetup) {
+                startCommand('Setting up project config...');
+            }
+            // Configure gt.config.json
+            await this.handleInitCommand(ranReactSetup);
+            endCommand('Done! Check out our docs for more information on how to use General Translation: https://generaltranslation.com/docs');
+        });
+    }
+    setupConfigureCommand() {
+        this.program
+            .command('configure')
+            .description('Configure your project for General Translation. This will create a gt.config.json file in your codebase.')
+            .action(async () => {
+            displayHeader('Configuring project...');
+            logInfo('Welcome! This tool will help you configure your gt.config.json file. See the docs: https://generaltranslation.com/docs/cli/reference/config for more information.');
+            // Configure gt.config.json
+            await this.handleInitCommand(false);
+            endCommand('Done! Make sure you have an API key and project ID to use General Translation. Get them on the dashboard: https://generaltranslation.com/dashboard');
+        });
+    }
+    setupSetupCommand() {
+        this.program
+            .command('setup')
+            .description('Run the setup to configure your Next.js or React project for General Translation')
+            .option('--src <paths...>', "Space-separated list of glob patterns containing the app's source code, by default 'src/**/*.{js,jsx,ts,tsx}' 'app/**/*.{js,jsx,ts,tsx}' 'pages/**/*.{js,jsx,ts,tsx}' 'components/**/*.{js,jsx,ts,tsx}'")
+            .option('-c, --config <path>', 'Filepath to config file, by default gt.config.json', findFilepath(['gt.config.json']))
+            .action(async (options) => {
+            displayHeader('Running React setup wizard...');
+            await this.handleSetupReactCommand(options);
+            endCommand("Done! Take advantage of all of General Translation's features by signing up for a free account! https://generaltranslation.com/signup");
+        });
+    }
+    async handleUploadCommand(settings) {
+        // dataFormat for JSONs
+        let dataFormat;
+        if (this.library === 'next-intl') {
+            dataFormat = 'ICU';
+        }
+        else if (this.library === 'i18next') {
+            if (this.additionalModules.includes('i18next-icu')) {
+                dataFormat = 'ICU';
+            }
+            else {
+                dataFormat = 'I18NEXT';
+            }
+        }
+        else {
+            dataFormat = 'JSX';
+        }
+        if (!settings.files) {
+            return;
+        }
+        const { resolvedPaths: sourceFiles, placeholderPaths, transformPaths, } = settings.files;
+        // Process all file types at once with a single call
+        await upload(sourceFiles, placeholderPaths, transformPaths, dataFormat, settings);
+    }
+    async handleSetupReactCommand(options) {
+        await handleSetupReactCommand(options);
+    }
+    // Wizard for configuring gt.config.json
+    async handleInitCommand(ranReactSetup) {
+        const { defaultLocale, locales } = await getDesiredLocales();
+        const packageJson = await searchForPackageJson();
+        const isUsingGTNext = packageJson
+            ? isPackageInstalled('gt-next', packageJson)
+            : false;
+        const isUsingGTReact = packageJson
+            ? isPackageInstalled('gt-react', packageJson)
+            : false;
+        // Ask if using another i18n library
+        const isUsingGT = isUsingGTNext || isUsingGTReact || ranReactSetup;
+        // Ask where the translations are stored
+        const usingCDN = isUsingGT
+            ? await promptConfirm({
+                message: `Auto-detected that you're using gt-next or gt-react. Would you like to use the General Translation CDN to store your translations?\nSee ${isUsingGTNext
+                    ? 'https://generaltranslation.com/en/docs/next/guides/local-tx'
+                    : 'https://generaltranslation.com/en/docs/react/guides/local-tx'} for more information.\nIf you answer no, we'll configure the CLI tool to download completed translations.`,
+                defaultValue: true,
+            })
+            : false;
+        // Ask where the translations are stored
+        const translationsDir = isUsingGT && !usingCDN
+            ? await promptText({
+                message: 'What is the path to the directory where you would like to locally store your translations?',
+                defaultValue: './public/_gt',
+            })
+            : null;
+        // Determine final translations directory with fallback
+        const finalTranslationsDir = translationsDir?.trim() || './public/_gt';
+        if (isUsingGT && !usingCDN) {
+            // Create loadTranslations.js file for local translations
+            await createLoadTranslationsFile(process.cwd(), finalTranslationsDir);
+            logMessage(`Created ${chalk.cyan('loadTranslations.js')} file for local translations.
+Make sure to add this function to your app configuration.
+See https://generaltranslation.com/en/docs/next/guides/local-tx`);
+        }
+        const message = !isUsingGT
+            ? 'What is the format of your language resource files? Select as many as applicable.\nAdditionally, you can translate any other files you have in your project.'
+            : `${chalk.dim('(Optional)')} Do you have any separate files you would like to translate? For example, extra Markdown files for docs.`;
+        const fileExtensions = await promptMultiSelect({
+            message,
+            options: [
+                { value: 'json', label: FILE_EXT_TO_EXT_LABEL.json },
+                { value: 'md', label: FILE_EXT_TO_EXT_LABEL.md },
+                { value: 'mdx', label: FILE_EXT_TO_EXT_LABEL.mdx },
+                { value: 'ts', label: FILE_EXT_TO_EXT_LABEL.ts },
+                { value: 'js', label: FILE_EXT_TO_EXT_LABEL.js },
+                { value: 'yaml', label: FILE_EXT_TO_EXT_LABEL.yaml },
+            ],
+            required: !isUsingGT,
+        });
+        const files = {};
+        for (const fileExtension of fileExtensions) {
+            const paths = await promptText({
+                message: `${chalk.cyan(FILE_EXT_TO_EXT_LABEL[fileExtension])}: Please enter a space-separated list of glob patterns matching the location of the ${FILE_EXT_TO_EXT_LABEL[fileExtension]} files you would like to translate.\nMake sure to include [locale] in the patterns.\nSee https://generaltranslation.com/docs/cli/reference/config#include for more information.`,
+                defaultValue: `./**/[locale]/*.${fileExtension}`,
+            });
+            files[fileExtension] = {
+                include: paths.split(' '),
+            };
+        }
+        // Add GT translations if using GT and storing locally
+        if (isUsingGT && !usingCDN) {
+            files.gt = {
+                output: path.join(finalTranslationsDir, `[locale].json`),
+            };
+        }
+        let configFilepath = 'gt.config.json';
+        if (fs.existsSync('src/gt.config.json')) {
+            configFilepath = 'src/gt.config.json';
+        }
+        // Create gt.config.json
+        await createOrUpdateConfig(configFilepath, {
+            defaultLocale,
+            locales,
+            files: Object.keys(files).length > 0 ? files : undefined,
+            publish: isUsingGT && usingCDN,
+        });
+        logSuccess(`Feel free to edit ${chalk.cyan(configFilepath)} to customize your translation setup. Docs: https://generaltranslation.com/docs/cli/reference/config`);
+        // Install gtx-cli if not installed
+        const isCLIInstalled = packageJson
+            ? isPackageInstalled('gtx-cli', packageJson, true, true)
+            : true; // if no package.json, we can't install it
+        if (!isCLIInstalled) {
+            const packageManager = await getPackageManager();
+            const spinner = createSpinner();
+            spinner.start(`Installing gtx-cli as a dev dependency with ${packageManager.name}...`);
+            await installPackage('gtx-cli', packageManager, true);
+            spinner.stop(chalk.green('Installed gtx-cli.'));
+        }
+        // Set credentials
+        if (!areCredentialsSet()) {
+            const loginQuestion = await promptConfirm({
+                message: `Would you like the wizard to automatically generate a ${isUsingGT ? 'development' : 'production'} API key and project ID for you?`,
+                defaultValue: true,
+            });
+            if (loginQuestion) {
+                const settings = await generateSettings({});
+                const keyType = isUsingGT ? 'development' : 'production';
+                const credentials = await retrieveCredentials(settings, keyType);
+                await setCredentials(credentials, keyType, settings.framework);
+            }
+        }
+    }
+    async handleLoginCommand(options) {
+        const settings = await generateSettings({});
+        const keyType = options.keyType || 'production';
+        const credentials = await retrieveCredentials(settings, keyType);
+        await setCredentials(credentials, keyType, settings.framework);
+    }
+}

package/dist/cli/commands/stage.d.ts

@@ -0,0 +1,5 @@
+import { Settings, SupportedLibraries, TranslateFlags } from '../../types/index.js';
+import { SendFilesResult } from '../../api/sendFiles.js';
+export declare const TEMPLATE_FILE_NAME = "__INTERNAL_GT_TEMPLATE_NAME__";
+export declare const TEMPLATE_FILE_ID: string;
+export declare function handleStage(options: TranslateFlags, settings: Settings, library: SupportedLibraries, stage: boolean): Promise<SendFilesResult | undefined>;

package/dist/cli/commands/stage.js

@@ -0,0 +1,100 @@
+import { logErrorAndExit, logSuccess } from '../../console/logging.js';
+import { noLocalesError, noDefaultLocaleError, noApiKeyError, noProjectIdError, devApiKeyError, invalidConfigurationError, } from '../../console/index.js';
+import { aggregateFiles } from '../../formats/files/translate.js';
+import { aggregateReactTranslations } from '../../translation/stage.js';
+import { sendFiles } from '../../api/sendFiles.js';
+import { updateVersions } from '../../fs/config/updateVersions.js';
+import updateConfig from '../../fs/config/updateConfig.js';
+import { hashStringSync } from '../../utils/hash.js';
+export const TEMPLATE_FILE_NAME = '__INTERNAL_GT_TEMPLATE_NAME__';
+export const TEMPLATE_FILE_ID = hashStringSync(TEMPLATE_FILE_NAME);
+export async function handleStage(options, settings, library, stage) {
+    // Validate required settings are present if not in dry run
+    if (!options.dryRun) {
+        if (!settings.locales) {
+            logErrorAndExit(noLocalesError);
+        }
+        if (!settings.defaultLocale) {
+            logErrorAndExit(noDefaultLocaleError);
+        }
+        if (!settings.apiKey) {
+            logErrorAndExit(noApiKeyError);
+        }
+        if (settings.apiKey.startsWith('gtx-dev-')) {
+            logErrorAndExit(devApiKeyError);
+        }
+        if (!settings.projectId) {
+            logErrorAndExit(noProjectIdError);
+        }
+    }
+    // Aggregate files
+    const allFiles = await aggregateFiles(settings);
+    // Parse for React components
+    let reactComponents = 0;
+    if (library === 'gt-react' || library === 'gt-next') {
+        const updates = await aggregateReactTranslations(options, settings, library);
+        if (updates.length > 0) {
+            if (!options.dryRun &&
+                !settings.publish &&
+                !settings.files?.placeholderPaths.gt) {
+                logErrorAndExit(invalidConfigurationError);
+            }
+            reactComponents = updates.length;
+            // Convert updates to a file object
+            const fileData = {};
+            const fileMetadata = {};
+            // Convert updates to the proper data format
+            for (const update of updates) {
+                const { source, metadata, dataFormat } = update;
+                metadata.dataFormat = dataFormat; // add the data format to the metadata
+                const { hash, id } = metadata;
+                if (id) {
+                    fileData[id] = source;
+                    fileMetadata[id] = metadata;
+                }
+                else {
+                    fileData[hash] = source;
+                    fileMetadata[hash] = metadata;
+                }
+            }
+            allFiles.push({
+                fileName: TEMPLATE_FILE_NAME,
+                content: JSON.stringify(fileData),
+                fileFormat: 'GTJSON',
+                formatMetadata: fileMetadata,
+            });
+        }
+    }
+    // Dry run
+    if (options.dryRun) {
+        const fileNames = allFiles
+            .map((file) => {
+            if (file.fileName === TEMPLATE_FILE_NAME) {
+                return `- <React Elements> (${reactComponents})`;
+            }
+            return `- ${file.fileName}`;
+        })
+            .join('\n');
+        logSuccess(`Dry run: No files were sent to General Translation. Found files:\n${fileNames}`);
+        return undefined;
+    }
+    // Send translations to General Translation
+    let filesTranslationResponse;
+    if (allFiles.length > 0) {
+        filesTranslationResponse = await sendFiles(allFiles, options, settings);
+        if (stage) {
+            await updateVersions({
+                configDirectory: settings.configDirectory,
+                versionData: filesTranslationResponse.data,
+            });
+        }
+        const templateData = filesTranslationResponse.data[TEMPLATE_FILE_ID];
+        if (templateData?.versionId) {
+            await updateConfig({
+                configFilepath: settings.config,
+                _versionId: templateData.versionId,
+            });
+        }
+    }
+    return filesTranslationResponse;
+}

package/dist/cli/commands/translate.d.ts

@@ -0,0 +1,6 @@
+import { SendFilesResult } from '../../api/sendFiles.js';
+import { TranslateFlags } from '../../types/index.js';
+import { Settings } from '../../types/index.js';
+export declare function handleTranslate(options: TranslateFlags, settings: Settings, filesTranslationResponse: SendFilesResult | undefined): Promise<void>;
+export declare function handleDownload(options: TranslateFlags, settings: Settings): Promise<void>;
+export declare function postProcessTranslations(settings: Settings): Promise<void>;

package/dist/cli/commands/translate.js

@@ -0,0 +1,63 @@
+import { checkFileTranslations } from '../../api/checkFileTranslations.js';
+import { createFileMapping } from '../../formats/files/fileMapping.js';
+import { logError } from '../../console/logging.js';
+import { getStagedVersions } from '../../fs/config/updateVersions.js';
+import copyFile from '../../fs/copyFile.js';
+import flattenJsonFiles from '../../utils/flattenJsonFiles.js';
+import localizeStaticUrls from '../../utils/localizeStaticUrls.js';
+import processAnchorIds from '../../utils/processAnchorIds.js';
+import { noFilesError, noVersionIdError } from '../../console/index.js';
+import localizeStaticImports from '../../utils/localizeStaticImports.js';
+// Downloads translations that were completed
+export async function handleTranslate(options, settings, filesTranslationResponse) {
+    if (filesTranslationResponse && settings.files) {
+        const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
+        const fileMapping = createFileMapping(resolvedPaths, placeholderPaths, transformPaths, settings.locales, settings.defaultLocale);
+        const { data } = filesTranslationResponse;
+        // Check for remaining translations
+        await checkFileTranslations(data, settings.locales, options.timeout, (sourcePath, locale) => fileMapping[locale][sourcePath] ?? null, settings, options.force);
+    }
+}
+// Downloads translations that were originally staged
+export async function handleDownload(options, settings) {
+    if (!settings._versionId) {
+        logError(noVersionIdError);
+        process.exit(1);
+    }
+    if (!settings.files) {
+        logError(noFilesError);
+        process.exit(1);
+    }
+    // Files
+    const { resolvedPaths, placeholderPaths, transformPaths } = settings.files;
+    const fileMapping = createFileMapping(resolvedPaths, placeholderPaths, transformPaths, settings.locales, settings.defaultLocale);
+    const stagedVersionData = await getStagedVersions(settings.configDirectory);
+    // Check for remaining translations
+    await checkFileTranslations(stagedVersionData, settings.locales, options.timeout, (sourcePath, locale) => fileMapping[locale][sourcePath] ?? null, settings, false // force is not applicable for downloading staged translations
+    );
+}
+export async function postProcessTranslations(settings) {
+    // Localize static urls (/docs -> /[locale]/docs) and preserve anchor IDs for non-default locales
+    // Default locale is processed earlier in the flow in base.ts
+    if (settings.options?.experimentalLocalizeStaticUrls) {
+        const nonDefaultLocales = settings.locales.filter((locale) => locale !== settings.defaultLocale);
+        if (nonDefaultLocales.length > 0) {
+            await localizeStaticUrls(settings, nonDefaultLocales);
+        }
+        // Add explicit anchor IDs to translated MDX/MD files to preserve navigation
+        // Uses inline {#id} format by default, or div wrapping if experimentalAddHeaderAnchorIds is 'mintlify'
+        await processAnchorIds(settings);
+    }
+    // Localize static imports (import Snippet from /snippets/file.mdx -> import Snippet from /snippets/[locale]/file.mdx)
+    if (settings.options?.experimentalLocalizeStaticImports) {
+        await localizeStaticImports(settings);
+    }
+    // Flatten json files into a single file
+    if (settings.options?.experimentalFlattenJsonFiles) {
+        await flattenJsonFiles(settings);
+    }
+    // Copy files to the target locale
+    if (settings.options?.copyFiles) {
+        await copyFile(settings);
+    }
+}

package/dist/cli/flags.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function attachTranslateFlags(command: Command): Command;
+export declare function attachAdditionalReactTranslateFlags(command: Command): Command;

package/dist/cli/flags.js

@@ -0,0 +1,38 @@
+import findFilepath from '../fs/findFilepath.js';
+const DEFAULT_TIMEOUT = 600;
+export function attachTranslateFlags(command) {
+    command
+        .option('-c, --config <path>', 'Filepath to config file, by default gt.config.json', findFilepath(['gt.config.json']))
+        .option('--api-key <key>', 'API key for General Translation cloud service')
+        .option('--project-id <id>', 'General Translation project ID')
+        .option('--version-id <id>', 'General Translation version ID')
+        .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('--dry-run', 'Dry run, do not send updates to the General Translation API', false)
+        .option('--timeout <seconds>', 'Translation wait timeout in seconds', (value) => {
+        const parsedValue = parseInt(value, 10);
+        if (isNaN(parsedValue)) {
+            throw new Error('Not a number.');
+        }
+        if (parsedValue < 0) {
+            throw new Error('Timeout must be a positive number.');
+        }
+        return parsedValue;
+    }, DEFAULT_TIMEOUT)
+        .option('--publish', 'Publish translations to the CDN', false)
+        .option('--experimental-localize-static-urls', 'Triggering this will run a script after the cli tool that localizes all urls in content files. Currently only supported for md and mdx files.', false)
+        .option('--experimental-hide-default-locale', 'When localizing static locales, hide the default locale from the path', false)
+        .option('--experimental-flatten-json-files', 'Triggering this will flatten the json files into a single file. This is useful for projects that have a lot of json files.', false)
+        .option('--experimental-localize-static-imports', 'Triggering this will run a script after the cli tool that localizes all static imports in content files. Currently only supported for md and mdx files.', false)
+        .option('--force', 'Force a retranslation, invalidating all existing cached translations if they exist.', false);
+    return command;
+}
+export function attachAdditionalReactTranslateFlags(command) {
+    command
+        .option('--tsconfig, --jsconfig <path>', 'Path to custom jsconfig or tsconfig file', findFilepath(['./tsconfig.json', './jsconfig.json']))
+        .option('--dictionary <path>', 'Path to dictionary file')
+        .option('--src <paths...>', "Space-separated list of glob patterns containing the app's source code, by default 'src/**/*.{js,jsx,ts,tsx}' 'app/**/*.{js,jsx,ts,tsx}' 'pages/**/*.{js,jsx,ts,tsx}' 'components/**/*.{js,jsx,ts,tsx}'")
+        .option('--inline', 'Include inline <T> tags in addition to dictionary file', true)
+        .option('--ignore-errors', 'Ignore errors encountered while scanning for <T> tags', false);
+    return command;
+}

package/dist/cli/next.d.ts

@@ -0,0 +1,11 @@
+import { WrapOptions, SupportedFrameworks, SupportedLibraries } from '../types/index.js';
+import { ReactCLI } from './react.js';
+import { Command } from 'commander';
+export declare class NextCLI extends ReactCLI {
+    constructor(command: Command, library: 'gt-next', additionalModules?: SupportedLibraries[]);
+    init(): void;
+    execute(): void;
+    protected wrapContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
+        filesUpdated: string[];
+    }>;
+}

package/dist/cli/next.js

@@ -0,0 +1,20 @@
+import { ReactCLI } from './react.js';
+import { wrapContentNext } from '../next/parse/wrapContent.js';
+const pkg = 'gt-next';
+export class NextCLI extends ReactCLI {
+    constructor(command, library, additionalModules) {
+        super(command, library, additionalModules);
+    }
+    init() {
+        this.setupStageCommand();
+        this.setupTranslateCommand();
+        this.setupGenerateSourceCommand();
+        this.setupValidateCommand();
+    }
+    execute() {
+        super.execute();
+    }
+    wrapContent(options, framework, errors, warnings) {
+        return wrapContentNext(options, pkg, errors, warnings);
+    }
+}

package/dist/cli/react.d.ts

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+import { Options, SupportedFrameworks, WrapOptions, SupportedLibraries, TranslateFlags } from '../types/index.js';
+import { BaseCLI } from './base.js';
+export declare class ReactCLI extends BaseCLI {
+    constructor(command: Command, library: 'gt-react' | 'gt-next', additionalModules?: SupportedLibraries[]);
+    init(): void;
+    execute(): void;
+    protected wrapContent(options: WrapOptions, framework: SupportedFrameworks, errors: string[], warnings: string[]): Promise<{
+        filesUpdated: string[];
+    }>;
+    protected setupStageCommand(): void;
+    protected setupTranslateCommand(): void;
+    protected setupValidateCommand(): void;
+    protected setupGenerateSourceCommand(): void;
+    protected handleGenerateSourceCommand(initOptions: TranslateFlags): Promise<void>;
+    protected handleScanCommand(options: WrapOptions): Promise<void>;
+    protected handleValidate(initOptions: Options, files?: string[]): Promise<void>;
+}