gt 2.14.62 → 2.14.63

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # gtx-cli
 
+## 2.14.63
+
+### Patch Changes
+
+- [#1867](https://github.com/generaltranslation/gt/pull/1867) [`a7aea57`](https://github.com/generaltranslation/gt/commit/a7aea57b1c6ecdc3edc0ace4cb21a859ac6ef508) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Fix `<T $context="...">` and `<T $id="...">` string-literal props being dropped from hashing and registration. Context-carrying `<T>` components were registered under context-less hashes that the runtime never looks up, so their file translations always missed; `gt translate` now registers them under the same context-aware hashes the runtime and compiler compute.
+
+- [#1890](https://github.com/generaltranslation/gt/pull/1890) [`6feb7b7`](https://github.com/generaltranslation/gt/commit/6feb7b79f0320d54d341f06b1482a9153e69d909) Thanks [@bgub](https://github.com/bgub)! - Inline single-use derive-expression adapters in the CLI string parser to reduce pass-through indirection.
+
+- [#1882](https://github.com/generaltranslation/gt/pull/1882) [`288a47d`](https://github.com/generaltranslation/gt/commit/288a47dccfa7572b381bf76cc0bfc863436ae4a4) Thanks [@ErnestM1234](https://github.com/ErnestM1234)! - Warn when GT React packages before version 11 may use incompatible ID-based translation keys, with an explicit suppression flag.
+
+- Updated dependencies [[`5d93858`](https://github.com/generaltranslation/gt/commit/5d9385872eb041af0991fc273d5eddd7a032e584), [`5721267`](https://github.com/generaltranslation/gt/commit/57212672a595c8c8578366636767bcbfe8ab6e57), [`8b9b440`](https://github.com/generaltranslation/gt/commit/8b9b4404b703b552b9aa327dc0ae85fce584c97c)]:
+  - generaltranslation@9.0.2
+  - @generaltranslation/python-extractor@0.2.29
+  - @generaltranslation/supported-locales@2.1.9
+
 ## 2.14.62
 
 ### Patch Changes

package/dist/cli/base.js

@@ -33,10 +33,20 @@ import { handleEnqueue } from "./commands/enqueue.js";
 import { splitMintlifyLanguageRefs } from "../utils/splitMintlifyLanguageRefs.js";
 import { runMergeDriver } from "../git/mergeDrivers.js";
 import { setupGitMergeDrivers } from "../git/setupMergeDrivers.js";
+import { warnReactPackageCompatibility } from "../utils/reactPackageCompatibility.js";
 import chalk from "chalk";
 import path from "node:path";
 import fs from "node:fs";
 //#region src/cli/base.ts
+const ID_COMPATIBILITY_WARNING_COMMANDS = new Set([
+	"download",
+	"enqueue",
+	"generate",
+	"setup",
+	"stage",
+	"translate",
+	"validate"
+]);
 var BaseCLI = class {
 	library;
 	additionalModules;
@@ -46,6 +56,12 @@ var BaseCLI = class {
 		this.library = library;
 		this.additionalModules = additionalModules || [];
 		this.program.option("--skip-version-check", "Skip the monorepo GT package version consistency check");
+		this.program.option("--suppress-id-compatibility-warning", "Suppress the React package ID compatibility warning");
+		this.program.hook("preAction", async (thisCommand, actionCommand) => {
+			if (actionCommand.parent !== thisCommand) return;
+			if (!ID_COMPATIBILITY_WARNING_COMMANDS.has(actionCommand.name())) return;
+			await warnReactPackageCompatibility(Boolean(this.program.opts().suppressIdCompatibilityWarning));
+		});
 		this.setupInitCommand();
 		this.setupConfigureCommand();
 		this.setupUploadCommand();

package/dist/cli/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","names":[],"sources":["../../src/cli/base.ts"],"sourcesContent":["import { Command } from 'commander';\nimport {\n  DEFAULT_TRANSLATIONS_DIR,\n  DEFAULT_VITE_TRANSLATIONS_DIR,\n} from '../utils/constants.js';\nimport { createOrUpdateConfig } from '../fs/config/setupConfig.js';\nimport findFilepath from '../fs/findFilepath.js';\nimport {\n  displayHeader,\n  promptText,\n  logErrorAndExit,\n  exitSync,\n  promptConfirm,\n  promptMultiSelect,\n  promptSelect,\n  promptGlobPatterns,\n} from '../console/logging.js';\nimport { logger } from '../console/logger.js';\nimport { parseGlobPatterns } from '../console/promptParsing.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport {\n  FilesOptions,\n  Settings,\n  SupportedLibraries,\n  SetupOptions,\n  TranslateFlags,\n  SharedFlags,\n} from '../types/index.js';\nimport { generateSettings } from '../config/generateSettings.js';\nimport chalk from 'chalk';\nimport { FILE_EXT_TO_EXT_LABEL } from '../formats/files/supportedFiles.js';\nimport { handleSetupReactCommand } from '../setup/wizard.js';\nimport {\n  isPackageInstalled,\n  searchForPackageJson,\n} from '../utils/packageJson.js';\nimport { getDesiredLocales } from '../setup/userInput.js';\nimport { installPackage } from '../utils/installPackage.js';\nimport { getPackageManager } from '../utils/packageManager.js';\nimport { retrieveCredentials, setCredentials } from '../utils/credentials.js';\nimport { areCredentialsSet } from '../utils/credentials.js';\nimport { upload } from './commands/upload.js';\nimport { attachSharedFlags, attachTranslateFlags } from './flags.js';\nimport { handleStage } from './commands/stage.js';\nimport { handleSetupProject } from './commands/setupProject.js';\nimport { handleDownload } from './commands/download.js';\nimport {\n  handleTranslate,\n  postProcessTranslations,\n} from './commands/translate.js';\nimport {\n  getNeedsPostprocessing,\n  clearDownloaded,\n} from '../state/recentDownloads.js';\nimport { clearWarnings } from '../state/translateWarnings.js';\nimport { displayTranslateSummary } from '../console/displayTranslateSummary.js';\nimport updateConfig from '../fs/config/updateConfig.js';\nimport { createLoadTranslationsFile } from '../fs/createLoadTranslationsFile.js';\nimport { saveLocalEdits } from '../api/saveLocalEdits.js';\nimport processSharedStaticAssets, {\n  mirrorAssetsToLocales,\n} from '../utils/sharedStaticAssets.js';\nimport { setupLocadex } from '../locadex/setupFlow.js';\nimport { detectFramework } from '../setup/detectFramework.js';\nimport {\n  getFrameworkDisplayName,\n  getReactFrameworkLibrary,\n} from '../setup/frameworkUtils.js';\nimport { INLINE_LIBRARIES } from '../types/libraries.js';\nimport { handleEnqueue } from './commands/enqueue.js';\nimport { splitMintlifyLanguageRefs } from '../utils/splitMintlifyLanguageRefs.js';\nimport { runMergeDriver, type MergeDriverName } from '../git/mergeDrivers.js';\nimport { setupGitMergeDrivers } from '../git/setupMergeDrivers.js';\n\nexport type UploadOptions = {\n  config?: string;\n  apiKey?: string;\n  projectId?: string;\n  defaultLocale?: string;\n};\n\nexport type LoginOptions = {\n  config?: string;\n  keyType?: 'development' | 'production' | 'all';\n};\n\nexport type GitSetupOptions = {\n  config?: string;\n  dryRun?: boolean;\n  omitConfigIds?: boolean;\n  driverCommand?: string;\n};\n\nexport class BaseCLI {\n  protected library: SupportedLibraries;\n  protected additionalModules: SupportedLibraries[];\n  protected program: Command;\n  // Constructor is shared amongst all CLI class types\n  public constructor(\n    program: Command,\n    library: SupportedLibraries,\n    additionalModules?: SupportedLibraries[]\n  ) {\n    this.program = program;\n    this.library = library;\n    this.additionalModules = additionalModules || [];\n\n    this.program.option(\n      '--skip-version-check',\n      'Skip the monorepo GT package version consistency check'\n    );\n\n    this.setupInitCommand();\n    this.setupConfigureCommand();\n    this.setupUploadCommand();\n    this.setupLoginCommand();\n    this.setupSendDiffsCommand();\n    this.setupGitCommand();\n  }\n  // Init is never called in a child class\n  public init() {\n    this.setupSetupProjectCommand();\n    this.setupStageCommand();\n    this.setupTranslateCommand();\n    this.setupDownloadCommand();\n    this.setupEnqueueCommand();\n  }\n  // Execute is called by the main program\n  public execute() {\n    // If no command is specified, run 'init'\n    if (process.argv.length <= 2) {\n      process.argv.push('init');\n    }\n  }\n\n  protected setupSetupProjectCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('setup')\n        .description(\n          'Upload source files and setup the project for translation'\n        )\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Uploading source files and setting up project...');\n      await this.handleSetupProject(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupStageCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('stage')\n        .description(\n          'Submits the project to the General Translation API for translation. Translations created using this command will require human approval.'\n        )\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader(\n        'Staging project for translation with approval required...'\n      );\n      await this.handleStage(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  /**\n   * Enqueues translations for a given set of files\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected setupEnqueueCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('enqueue')\n        .description('Enqueues translations for a given set of files')\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Enqueuing translations...');\n      await this.handleEnqueue(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  /**\n   * Downloads translations that were originally staged\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected setupDownloadCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('download')\n        .description('Download translations that were originally staged')\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Downloading translations...');\n      await this.handleDownload(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupTranslateCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('translate')\n        .description('Translate your project using General Translation')\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Starting translation...');\n      await this.handleTranslate(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupSendDiffsCommand(): void {\n    attachSharedFlags(\n      this.program\n        .command('save-local')\n        .description(\n          'Save local edits for all configured files by sending diffs (no translation enqueued)'\n        )\n    )\n      .option('--publish', 'Publish translations to the CDN', false)\n      .action(async (initOptions: SharedFlags) => {\n        displayHeader('Saving local edits...');\n        const settings = await generateSettings(initOptions, undefined, {\n          requireConfig: true,\n        });\n        await saveLocalEdits(settings);\n        logger.endCommand('Saved local edits');\n      });\n  }\n\n  protected setupGitCommand(): void {\n    const gitCommand = this.program\n      .command('git')\n      .description('Configure Git integrations for General Translation');\n\n    gitCommand\n      .command('setup')\n      .description('Set up GT merge drivers for generated translation files')\n      .option(\n        '-c, --config <path>',\n        'Filepath to config file, by default gt.config.json',\n        findFilepath(['gt.config.json'])\n      )\n      .option('--dry-run', 'Print changes without writing files', false)\n      .option(\n        '--omit-config-ids',\n        'Persist omitConfigIds and remove generated config IDs'\n      )\n      .option(\n        '--driver-command <command>',\n        'Command Git should use to invoke gt, e.g. \"pnpm exec gt\"'\n      )\n      .action(async (options: GitSetupOptions) => {\n        displayHeader('Setting up GT Git merge drivers...');\n        const settings = await generateSettings(options, undefined, {\n          requireConfig: true,\n        });\n        const omitConfigIds = await this.resolveGitSetupOmitConfigIds(\n          options,\n          settings\n        );\n        const result = await setupGitMergeDrivers(settings, {\n          dryRun: options.dryRun,\n          omitConfigIds,\n          driverCommand: options.driverCommand,\n        });\n\n        for (const line of result.addedAttributes) {\n          logger.step(\n            `${options.dryRun ? 'Would add' : 'Added'} ${chalk.cyan(\n              line\n            )} to ${chalk.cyan(result.gitattributesPath)}`\n          );\n        }\n        if (result.addedAttributes.length === 0) {\n          logger.info(`${chalk.cyan('.gitattributes')} is already configured.`);\n        }\n\n        for (const args of result.gitConfigCommands) {\n          logger.step(\n            `${options.dryRun ? 'Would run' : 'Configured'} ${chalk.cyan(\n              `git config --local ${args.join(' ')}`\n            )}`\n          );\n        }\n\n        if (result.updatedConfig) {\n          logger.step(\n            `${options.dryRun ? 'Would persist' : 'Persisted'} ${chalk.cyan(\n              'omitConfigIds: true'\n            )} in ${chalk.cyan(settings.config)}`\n          );\n        } else if (options.dryRun && !settings.omitConfigIds) {\n          logger.info(\n            `Run without ${chalk.cyan('--dry-run')} to be prompted to persist ${chalk.cyan(\n              'omitConfigIds: true'\n            )}, or pass ${chalk.cyan('--omit-config-ids')}.`\n          );\n        }\n\n        for (const warning of result.warnings) {\n          logger.warn(chalk.yellow(warning));\n        }\n\n        logger.endCommand(\n          options.dryRun\n            ? 'Dry run complete.'\n            : 'GT Git merge drivers configured.'\n        );\n      });\n\n    gitCommand\n      .command('merge-driver', { hidden: true })\n      .argument('<driver>', 'Merge driver name')\n      .argument('<base>', 'Common ancestor file')\n      .argument('<ours>', 'Current branch file')\n      .argument('<theirs>', 'Incoming branch file')\n      .argument('[path]', 'Merged path')\n      .action((driver: string, base: string, ours: string, theirs: string) => {\n        if (driver !== 'gt-lock' && driver !== 'gtjson') {\n          logger.error(`Unknown GT merge driver: ${driver}`);\n          exitSync(1);\n        }\n        const result = runMergeDriver(\n          driver as MergeDriverName,\n          base,\n          ours,\n          theirs\n        );\n        if (!result.ok) {\n          logger.error(result.reason);\n          exitSync(1);\n        }\n      });\n  }\n\n  protected async resolveGitSetupOmitConfigIds(\n    options: GitSetupOptions,\n    settings: Settings\n  ): Promise<boolean> {\n    if (options.omitConfigIds) return true;\n    // Already opted in: persist again so stale config IDs still get removed\n    if (settings.omitConfigIds) return true;\n    if (options.dryRun || !process.stdin.isTTY || !process.stdout.isTTY) {\n      return false;\n    }\n    return promptConfirm({\n      message:\n        'Also set omitConfigIds: true to reduce gt.config.json merge conflicts?',\n      defaultValue: true,\n    });\n  }\n\n  protected async handleSetupProject(\n    initOptions: TranslateFlags\n  ): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n\n    // Preprocess shared static assets if configured (move + rewrite sources)\n    await processSharedStaticAssets(settings);\n\n    await handleSetupProject(initOptions, settings, this.library);\n  }\n\n  protected async handleStage(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n\n    // Preprocess shared static assets if configured (move + rewrite sources)\n    await processSharedStaticAssets(settings);\n\n    if (!settings.stageTranslations) {\n      // Update settings.stageTranslations to true\n      settings.stageTranslations = true;\n      await updateConfig(settings.config, {\n        stageTranslations: true,\n      });\n    }\n    await handleStage(initOptions, settings, this.library, true);\n  }\n\n  /**\n   * Enqueues translations for a given set of files\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected async handleEnqueue(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n    await handleEnqueue(initOptions, settings, this.library);\n  }\n\n  /**\n   * Downloads translations that were originally staged\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected async handleDownload(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n    await handleDownload(initOptions, settings, this.library);\n  }\n\n  protected async handleTranslate(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n\n    // Preprocess shared static assets if configured (move + rewrite sources)\n    await processSharedStaticAssets(settings);\n\n    if (!settings.stageTranslations) {\n      const results = await handleStage(\n        initOptions,\n        settings,\n        this.library,\n        false\n      );\n      if (results) {\n        await handleTranslate(\n          initOptions,\n          settings,\n          results.fileVersionData,\n          results.jobData,\n          results.branchData,\n          results.publishMap\n        );\n      }\n    } else {\n      await handleDownload(initOptions, settings, this.library);\n    }\n    // Only postprocess files downloaded in this run\n    const include = getNeedsPostprocessing();\n    if (include.size > 0) {\n      await postProcessTranslations(settings, include);\n    }\n    // Split Mintlify language entries into $ref files to keep docs.json small\n    await splitMintlifyLanguageRefs(settings);\n    // Mirror assets after translations are downloaded and locale dirs are populated\n    await mirrorAssetsToLocales(settings);\n    clearDownloaded();\n    displayTranslateSummary();\n    clearWarnings();\n  }\n\n  protected setupUploadCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('upload')\n        .description(\n          'Upload source files and translations to the General Translation platform'\n        )\n    ).action(async (initOptions: UploadOptions) => {\n      displayHeader('Starting upload...');\n      const settings = await generateSettings(initOptions, undefined, {\n        requireConfig: true,\n      });\n\n      const options = { ...initOptions, ...settings };\n\n      await this.handleUploadCommand(options);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupLoginCommand(): void {\n    this.program\n      .command('auth')\n      .description('Generate General Translation API keys and project ID')\n      .option(\n        '-c, --config <path>',\n        'Filepath to config file, by default gt.config.json',\n        findFilepath(['gt.config.json'])\n      )\n      .option(\n        '-t, --key-type <type>',\n        'Type of key to generate, production | development | all'\n      )\n      .action(async (options: LoginOptions) => {\n        displayHeader('Authenticating with General Translation...');\n        if (!options.keyType) {\n          options.keyType = await promptSelect<\n            'development' | 'production' | 'all'\n          >({\n            message: 'What type of API key would you like to generate?',\n            options: [\n              { value: 'development', label: 'Development' },\n              { value: 'production', label: 'Production' },\n              { value: 'all', label: 'Both' },\n            ],\n            defaultValue: 'all',\n          });\n        } else {\n          if (\n            options.keyType !== 'development' &&\n            options.keyType !== 'production' &&\n            options.keyType !== 'all'\n          ) {\n            logErrorAndExit(\n              'Invalid key type, must be development, production, or all'\n            );\n          }\n        }\n        await this.handleLoginCommand(options);\n        logger.endCommand(\n          `Done! ${options.keyType} keys have been generated and saved to your .env.local file.`\n        );\n      });\n  }\n\n  protected setupInitCommand(): void {\n    this.program\n      .command('init')\n      .description(\n        'Run the setup wizard to configure your project for General Translation'\n      )\n      .option(\n        '--src <paths...>',\n        \"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}'\"\n      )\n      .option(\n        '-c, --config <path>',\n        'Filepath to config file, by default gt.config.json',\n        findFilepath(['gt.config.json'])\n      )\n      .action(async (options: SetupOptions) => {\n        const settings = await generateSettings(options);\n        displayHeader('Running setup wizard...');\n\n        const framework = await detectFramework();\n\n        const useAgent = await (async () => {\n          let useAgentMessage;\n          if (framework.name === 'mintlify') {\n            useAgentMessage = `Mintlify project detected. Would you like to connect to GitHub so that the Locadex AI Agent can translate your project automatically?`;\n          }\n          if (framework.name === 'next-app') {\n            useAgentMessage = `Next.js App Router detected. Would you like to connect to GitHub so that the Locadex AI Agent can set up your project automatically?`;\n          }\n          if (useAgentMessage) {\n            return await promptConfirm({\n              message: useAgentMessage,\n              defaultValue: false,\n            });\n          }\n          return false;\n        })();\n\n        if (useAgent) {\n          await setupLocadex(settings);\n          logger.endCommand(\n            'Once installed, Locadex will open a PR to your repository. See the docs for more information: https://generaltranslation.com/docs/locadex'\n          );\n        } else {\n          // Get framework display info for the defaults message\n          const frameworkDisplayName =\n            framework.type === 'react'\n              ? getFrameworkDisplayName(framework)\n              : null;\n          const library =\n            framework.type === 'react'\n              ? getReactFrameworkLibrary(framework)\n              : null;\n\n          // Build defaults description based on detected framework\n          const defaultTranslationsDir =\n            framework.name === 'vite'\n              ? DEFAULT_VITE_TRANSLATIONS_DIR\n              : DEFAULT_TRANSLATIONS_DIR;\n\n          const defaultsDescription =\n            framework.type === 'react'\n              ? `${library} & GTProvider, ${frameworkDisplayName}, Files saved locally in ${defaultTranslationsDir}`\n              : `Files saved locally in ${defaultTranslationsDir}`;\n\n          // Ask if user wants to use defaults\n          const useDefaults = await promptConfirm({\n            message: `Would you like to use the recommended General Translation defaults? ${chalk.dim(`(${defaultsDescription})`)}`,\n            defaultValue: true,\n          });\n\n          let ranReactSetup = false;\n\n          // so that people can run init in non-js projects\n          if (framework.type === 'react') {\n            const wrap = useDefaults\n              ? true\n              : await promptConfirm({\n                  message: `Would you like to install ${library} and add the GTProvider? See the docs for more information: https://generaltranslation.com/docs/react/tutorials/quickstart`,\n                  defaultValue: true,\n                });\n\n            if (wrap) {\n              logger.info(\n                `${chalk.yellow('[EXPERIMENTAL]')} Configuring project...`\n              );\n              await handleSetupReactCommand(options, framework, useDefaults);\n              logger.endCommand(\n                `Done! Since this wizard is experimental, please review the changes and make modifications as needed.\n\\nNext step: start internationalizing! See the docs for more information: https://generaltranslation.com/docs/react/tutorials/quickstart`\n              );\n              ranReactSetup = true;\n            }\n          }\n\n          if (ranReactSetup) {\n            logger.startCommand('Setting up project config...');\n          }\n          // Configure gt.config.json\n          await this.handleInitCommand(\n            ranReactSetup,\n            useDefaults,\n            framework.name === 'vite'\n          );\n\n          logger.endCommand(\n            'Done! Check out our docs for more information on how to use General Translation: https://generaltranslation.com/docs'\n          );\n        }\n      });\n  }\n\n  protected setupConfigureCommand(): void {\n    this.program\n      .command('configure')\n      .description(\n        'Configure your project for General Translation. This will create a gt.config.json file in your codebase.'\n      )\n      .action(async () => {\n        displayHeader('Configuring project...');\n\n        logger.info(\n          '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.'\n        );\n\n        // Configure gt.config.json\n        const framework = await detectFramework();\n        await this.handleInitCommand(false, false, framework.name === 'vite');\n\n        logger.endCommand(\n          'Done! Make sure you have an API key and project ID to use General Translation. Get them on the dashboard: https://generaltranslation.com/dashboard'\n        );\n      });\n  }\n\n  protected async handleUploadCommand(\n    settings: Settings & UploadOptions\n  ): Promise<void> {\n    if (!settings.files) {\n      return;\n    }\n\n    // Process all file types at once with a single call\n    await upload(settings);\n  }\n\n  // Wizard for configuring gt.config.json\n  protected async handleInitCommand(\n    ranReactSetup: boolean,\n    useDefaults: boolean = false,\n    isVite: boolean = false\n  ): Promise<void> {\n    const { defaultLocale, locales } = await getDesiredLocales(); // Locales should still be asked for even if using defaults\n\n    const packageJson = await searchForPackageJson();\n\n    // Ask if using another i18n library\n    const gtInstalled =\n      !!packageJson &&\n      INLINE_LIBRARIES.some((lib) => isPackageInstalled(lib, packageJson));\n    const isUsingGT = ranReactSetup || gtInstalled;\n\n    // Ask where the translations are stored\n    const usingCDN = await (async () => {\n      if (!isUsingGT) return false;\n      if (useDefaults) return false; // Default to local\n      const selectedValue = await promptSelect({\n        message: `Would you like to save translation files locally or use the General Translation CDN to store them?`,\n        options: [\n          { value: 'local', label: 'Save locally' },\n          { value: 'cdn', label: 'Use CDN' },\n        ],\n        defaultValue: 'local',\n      });\n      return selectedValue === 'cdn';\n    })();\n\n    const defaultTranslationsDir = isVite\n      ? DEFAULT_VITE_TRANSLATIONS_DIR\n      : DEFAULT_TRANSLATIONS_DIR;\n\n    // Ask where the translations are stored\n    const translationsDir =\n      isUsingGT && !usingCDN\n        ? useDefaults\n          ? defaultTranslationsDir\n          : await promptText({\n              message:\n                'What is the path to the directory where you would like to store your translation files?',\n              defaultValue: defaultTranslationsDir,\n            })\n        : null;\n\n    // Determine final translations directory with fallback\n    const finalTranslationsDir =\n      translationsDir?.trim() || defaultTranslationsDir;\n\n    if (isUsingGT && !usingCDN) {\n      // Create loadTranslations.js file for local translations\n      await createLoadTranslationsFile(\n        process.cwd(),\n        finalTranslationsDir,\n        locales\n      );\n      logger.message(\n        `Created ${chalk.cyan('loadTranslations.js')} file for local translations.\nMake sure to add this function to your app configuration.\nSee https://generaltranslation.com/en/docs/next/guides/local-tx`\n      );\n    }\n\n    const message = !isUsingGT\n      ? '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.'\n      : `Do you have any additional files in this project to translate? For example, Markdown files for docs. ${chalk.dim(\n          '(To continue without selecting press Enter)'\n        )}`;\n    const fileExtensions =\n      useDefaults && isUsingGT\n        ? [] // Skip for GT projects when using defaults\n        : await promptMultiSelect({\n            message,\n            options: [\n              { value: 'json', label: FILE_EXT_TO_EXT_LABEL.json },\n              { value: 'md', label: FILE_EXT_TO_EXT_LABEL.md },\n              { value: 'mdx', label: FILE_EXT_TO_EXT_LABEL.mdx },\n              { value: 'ts', label: FILE_EXT_TO_EXT_LABEL.ts },\n              { value: 'js', label: FILE_EXT_TO_EXT_LABEL.js },\n              { value: 'yaml', label: FILE_EXT_TO_EXT_LABEL.yaml },\n              // TWILIO_CONTENT_JSON not supported in CLI init as its too niche\n            ],\n            required: !isUsingGT,\n          });\n\n    const files: FilesOptions = {};\n    for (const fileExtension of fileExtensions) {\n      const label = FILE_EXT_TO_EXT_LABEL[fileExtension];\n      const paths = await promptGlobPatterns({\n        label,\n        message: `${chalk.cyan(FILE_EXT_TO_EXT_LABEL[fileExtension])}: 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.`,\n        defaultValue: `./**/[locale]/*.${fileExtension}`,\n      });\n\n      files[fileExtension] = {\n        include: parseGlobPatterns(paths),\n      };\n    }\n\n    // Add GT translations if using GT and storing locally\n    if (isUsingGT && !usingCDN) {\n      files.gt = {\n        output: path.join(finalTranslationsDir, `[locale].json`),\n      };\n    }\n\n    let configFilepath = 'gt.config.json';\n    if (fs.existsSync('src/gt.config.json')) {\n      configFilepath = 'src/gt.config.json';\n    }\n\n    // Create gt.config.json\n    await createOrUpdateConfig(configFilepath, {\n      defaultLocale,\n      locales,\n      files: Object.keys(files).length > 0 ? files : undefined,\n      publish: isUsingGT && usingCDN,\n    });\n\n    logger.success(\n      `Edit ${chalk.cyan(\n        configFilepath\n      )} to customize your translation setup. Docs: https://generaltranslation.com/docs/cli/reference/config`\n    );\n\n    // Install gt if not installed\n    const isCLIInstalled = packageJson\n      ? isPackageInstalled('gt', packageJson, true, true)\n      : true; // if no package.json, we can't install it\n\n    if (!isCLIInstalled) {\n      const packageManager = await getPackageManager();\n      const spinner = logger.createSpinner();\n      spinner.start(\n        `Installing gt as a dev dependency with ${packageManager.name}...`\n      );\n      await installPackage('gt', packageManager, true);\n      spinner.stop(chalk.green('Installed gt.'));\n    }\n\n    // Set credentials\n    if (!areCredentialsSet()) {\n      const loginQuestion = useDefaults\n        ? true\n        : await promptConfirm({\n            message:\n              'Would you like the wizard to automatically generate API keys and a project ID for you?',\n            defaultValue: true,\n          });\n      if (loginQuestion) {\n        const settings = await generateSettings({});\n        const keyType = useDefaults\n          ? 'all'\n          : await promptSelect<'development' | 'production' | 'all'>({\n              message: 'What type of API key would you like to generate?',\n              options: [\n                { value: 'development', label: 'Development' },\n                { value: 'production', label: 'Production' },\n                { value: 'all', label: 'Both' },\n              ],\n              defaultValue: 'all',\n            });\n        const credentials = await retrieveCredentials(settings, keyType);\n        await setCredentials(credentials, settings.framework);\n      }\n    }\n  }\n  protected async handleLoginCommand(options: LoginOptions): Promise<void> {\n    const settings = await generateSettings({ config: options.config });\n    const keyType = options.keyType || 'all';\n    const credentials = await retrieveCredentials(settings, keyType);\n    await setCredentials(credentials, settings.framework);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"base.js","names":[],"sources":["../../src/cli/base.ts"],"sourcesContent":["import { Command } from 'commander';\nimport {\n  DEFAULT_TRANSLATIONS_DIR,\n  DEFAULT_VITE_TRANSLATIONS_DIR,\n} from '../utils/constants.js';\nimport { createOrUpdateConfig } from '../fs/config/setupConfig.js';\nimport findFilepath from '../fs/findFilepath.js';\nimport {\n  displayHeader,\n  promptText,\n  logErrorAndExit,\n  exitSync,\n  promptConfirm,\n  promptMultiSelect,\n  promptSelect,\n  promptGlobPatterns,\n} from '../console/logging.js';\nimport { logger } from '../console/logger.js';\nimport { parseGlobPatterns } from '../console/promptParsing.js';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport {\n  FilesOptions,\n  Settings,\n  SupportedLibraries,\n  SetupOptions,\n  TranslateFlags,\n  SharedFlags,\n} from '../types/index.js';\nimport { generateSettings } from '../config/generateSettings.js';\nimport chalk from 'chalk';\nimport { FILE_EXT_TO_EXT_LABEL } from '../formats/files/supportedFiles.js';\nimport { handleSetupReactCommand } from '../setup/wizard.js';\nimport {\n  isPackageInstalled,\n  searchForPackageJson,\n} from '../utils/packageJson.js';\nimport { getDesiredLocales } from '../setup/userInput.js';\nimport { installPackage } from '../utils/installPackage.js';\nimport { getPackageManager } from '../utils/packageManager.js';\nimport { retrieveCredentials, setCredentials } from '../utils/credentials.js';\nimport { areCredentialsSet } from '../utils/credentials.js';\nimport { upload } from './commands/upload.js';\nimport { attachSharedFlags, attachTranslateFlags } from './flags.js';\nimport { handleStage } from './commands/stage.js';\nimport { handleSetupProject } from './commands/setupProject.js';\nimport { handleDownload } from './commands/download.js';\nimport {\n  handleTranslate,\n  postProcessTranslations,\n} from './commands/translate.js';\nimport {\n  getNeedsPostprocessing,\n  clearDownloaded,\n} from '../state/recentDownloads.js';\nimport { clearWarnings } from '../state/translateWarnings.js';\nimport { displayTranslateSummary } from '../console/displayTranslateSummary.js';\nimport updateConfig from '../fs/config/updateConfig.js';\nimport { createLoadTranslationsFile } from '../fs/createLoadTranslationsFile.js';\nimport { saveLocalEdits } from '../api/saveLocalEdits.js';\nimport processSharedStaticAssets, {\n  mirrorAssetsToLocales,\n} from '../utils/sharedStaticAssets.js';\nimport { setupLocadex } from '../locadex/setupFlow.js';\nimport { detectFramework } from '../setup/detectFramework.js';\nimport {\n  getFrameworkDisplayName,\n  getReactFrameworkLibrary,\n} from '../setup/frameworkUtils.js';\nimport { INLINE_LIBRARIES } from '../types/libraries.js';\nimport { handleEnqueue } from './commands/enqueue.js';\nimport { splitMintlifyLanguageRefs } from '../utils/splitMintlifyLanguageRefs.js';\nimport { runMergeDriver, type MergeDriverName } from '../git/mergeDrivers.js';\nimport { setupGitMergeDrivers } from '../git/setupMergeDrivers.js';\nimport { warnReactPackageCompatibility } from '../utils/reactPackageCompatibility.js';\n\nconst ID_COMPATIBILITY_WARNING_COMMANDS = new Set([\n  'download',\n  'enqueue',\n  'generate',\n  'setup',\n  'stage',\n  'translate',\n  'validate',\n]);\n\nexport type UploadOptions = {\n  config?: string;\n  apiKey?: string;\n  projectId?: string;\n  defaultLocale?: string;\n};\n\nexport type LoginOptions = {\n  config?: string;\n  keyType?: 'development' | 'production' | 'all';\n};\n\nexport type GitSetupOptions = {\n  config?: string;\n  dryRun?: boolean;\n  omitConfigIds?: boolean;\n  driverCommand?: string;\n};\n\nexport class BaseCLI {\n  protected library: SupportedLibraries;\n  protected additionalModules: SupportedLibraries[];\n  protected program: Command;\n  // Constructor is shared amongst all CLI class types\n  public constructor(\n    program: Command,\n    library: SupportedLibraries,\n    additionalModules?: SupportedLibraries[]\n  ) {\n    this.program = program;\n    this.library = library;\n    this.additionalModules = additionalModules || [];\n\n    this.program.option(\n      '--skip-version-check',\n      'Skip the monorepo GT package version consistency check'\n    );\n    this.program.option(\n      '--suppress-id-compatibility-warning',\n      'Suppress the React package ID compatibility warning'\n    );\n    this.program.hook('preAction', async (thisCommand, actionCommand) => {\n      // Nested commands (e.g. `gt git setup`) can share leaf names with\n      // translation commands; only direct children of the root qualify\n      if (actionCommand.parent !== thisCommand) return;\n      if (!ID_COMPATIBILITY_WARNING_COMMANDS.has(actionCommand.name())) return;\n      await warnReactPackageCompatibility(\n        Boolean(this.program.opts().suppressIdCompatibilityWarning)\n      );\n    });\n\n    this.setupInitCommand();\n    this.setupConfigureCommand();\n    this.setupUploadCommand();\n    this.setupLoginCommand();\n    this.setupSendDiffsCommand();\n    this.setupGitCommand();\n  }\n  // Init is never called in a child class\n  public init() {\n    this.setupSetupProjectCommand();\n    this.setupStageCommand();\n    this.setupTranslateCommand();\n    this.setupDownloadCommand();\n    this.setupEnqueueCommand();\n  }\n  // Execute is called by the main program\n  public execute() {\n    // If no command is specified, run 'init'\n    if (process.argv.length <= 2) {\n      process.argv.push('init');\n    }\n  }\n\n  protected setupSetupProjectCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('setup')\n        .description(\n          'Upload source files and setup the project for translation'\n        )\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Uploading source files and setting up project...');\n      await this.handleSetupProject(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupStageCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('stage')\n        .description(\n          'Submits the project to the General Translation API for translation. Translations created using this command will require human approval.'\n        )\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader(\n        'Staging project for translation with approval required...'\n      );\n      await this.handleStage(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  /**\n   * Enqueues translations for a given set of files\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected setupEnqueueCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('enqueue')\n        .description('Enqueues translations for a given set of files')\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Enqueuing translations...');\n      await this.handleEnqueue(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  /**\n   * Downloads translations that were originally staged\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected setupDownloadCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('download')\n        .description('Download translations that were originally staged')\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Downloading translations...');\n      await this.handleDownload(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupTranslateCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('translate')\n        .description('Translate your project using General Translation')\n    ).action(async (initOptions: TranslateFlags) => {\n      displayHeader('Starting translation...');\n      await this.handleTranslate(initOptions);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupSendDiffsCommand(): void {\n    attachSharedFlags(\n      this.program\n        .command('save-local')\n        .description(\n          'Save local edits for all configured files by sending diffs (no translation enqueued)'\n        )\n    )\n      .option('--publish', 'Publish translations to the CDN', false)\n      .action(async (initOptions: SharedFlags) => {\n        displayHeader('Saving local edits...');\n        const settings = await generateSettings(initOptions, undefined, {\n          requireConfig: true,\n        });\n        await saveLocalEdits(settings);\n        logger.endCommand('Saved local edits');\n      });\n  }\n\n  protected setupGitCommand(): void {\n    const gitCommand = this.program\n      .command('git')\n      .description('Configure Git integrations for General Translation');\n\n    gitCommand\n      .command('setup')\n      .description('Set up GT merge drivers for generated translation files')\n      .option(\n        '-c, --config <path>',\n        'Filepath to config file, by default gt.config.json',\n        findFilepath(['gt.config.json'])\n      )\n      .option('--dry-run', 'Print changes without writing files', false)\n      .option(\n        '--omit-config-ids',\n        'Persist omitConfigIds and remove generated config IDs'\n      )\n      .option(\n        '--driver-command <command>',\n        'Command Git should use to invoke gt, e.g. \"pnpm exec gt\"'\n      )\n      .action(async (options: GitSetupOptions) => {\n        displayHeader('Setting up GT Git merge drivers...');\n        const settings = await generateSettings(options, undefined, {\n          requireConfig: true,\n        });\n        const omitConfigIds = await this.resolveGitSetupOmitConfigIds(\n          options,\n          settings\n        );\n        const result = await setupGitMergeDrivers(settings, {\n          dryRun: options.dryRun,\n          omitConfigIds,\n          driverCommand: options.driverCommand,\n        });\n\n        for (const line of result.addedAttributes) {\n          logger.step(\n            `${options.dryRun ? 'Would add' : 'Added'} ${chalk.cyan(\n              line\n            )} to ${chalk.cyan(result.gitattributesPath)}`\n          );\n        }\n        if (result.addedAttributes.length === 0) {\n          logger.info(`${chalk.cyan('.gitattributes')} is already configured.`);\n        }\n\n        for (const args of result.gitConfigCommands) {\n          logger.step(\n            `${options.dryRun ? 'Would run' : 'Configured'} ${chalk.cyan(\n              `git config --local ${args.join(' ')}`\n            )}`\n          );\n        }\n\n        if (result.updatedConfig) {\n          logger.step(\n            `${options.dryRun ? 'Would persist' : 'Persisted'} ${chalk.cyan(\n              'omitConfigIds: true'\n            )} in ${chalk.cyan(settings.config)}`\n          );\n        } else if (options.dryRun && !settings.omitConfigIds) {\n          logger.info(\n            `Run without ${chalk.cyan('--dry-run')} to be prompted to persist ${chalk.cyan(\n              'omitConfigIds: true'\n            )}, or pass ${chalk.cyan('--omit-config-ids')}.`\n          );\n        }\n\n        for (const warning of result.warnings) {\n          logger.warn(chalk.yellow(warning));\n        }\n\n        logger.endCommand(\n          options.dryRun\n            ? 'Dry run complete.'\n            : 'GT Git merge drivers configured.'\n        );\n      });\n\n    gitCommand\n      .command('merge-driver', { hidden: true })\n      .argument('<driver>', 'Merge driver name')\n      .argument('<base>', 'Common ancestor file')\n      .argument('<ours>', 'Current branch file')\n      .argument('<theirs>', 'Incoming branch file')\n      .argument('[path]', 'Merged path')\n      .action((driver: string, base: string, ours: string, theirs: string) => {\n        if (driver !== 'gt-lock' && driver !== 'gtjson') {\n          logger.error(`Unknown GT merge driver: ${driver}`);\n          exitSync(1);\n        }\n        const result = runMergeDriver(\n          driver as MergeDriverName,\n          base,\n          ours,\n          theirs\n        );\n        if (!result.ok) {\n          logger.error(result.reason);\n          exitSync(1);\n        }\n      });\n  }\n\n  protected async resolveGitSetupOmitConfigIds(\n    options: GitSetupOptions,\n    settings: Settings\n  ): Promise<boolean> {\n    if (options.omitConfigIds) return true;\n    // Already opted in: persist again so stale config IDs still get removed\n    if (settings.omitConfigIds) return true;\n    if (options.dryRun || !process.stdin.isTTY || !process.stdout.isTTY) {\n      return false;\n    }\n    return promptConfirm({\n      message:\n        'Also set omitConfigIds: true to reduce gt.config.json merge conflicts?',\n      defaultValue: true,\n    });\n  }\n\n  protected async handleSetupProject(\n    initOptions: TranslateFlags\n  ): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n\n    // Preprocess shared static assets if configured (move + rewrite sources)\n    await processSharedStaticAssets(settings);\n\n    await handleSetupProject(initOptions, settings, this.library);\n  }\n\n  protected async handleStage(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n\n    // Preprocess shared static assets if configured (move + rewrite sources)\n    await processSharedStaticAssets(settings);\n\n    if (!settings.stageTranslations) {\n      // Update settings.stageTranslations to true\n      settings.stageTranslations = true;\n      await updateConfig(settings.config, {\n        stageTranslations: true,\n      });\n    }\n    await handleStage(initOptions, settings, this.library, true);\n  }\n\n  /**\n   * Enqueues translations for a given set of files\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected async handleEnqueue(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n    await handleEnqueue(initOptions, settings, this.library);\n  }\n\n  /**\n   * Downloads translations that were originally staged\n   * @param initOptions - The options for the command\n   * @returns The results of the command\n   */\n  protected async handleDownload(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n    await handleDownload(initOptions, settings, this.library);\n  }\n\n  protected async handleTranslate(initOptions: TranslateFlags): Promise<void> {\n    const settings = await generateSettings(initOptions, undefined, {\n      requireConfig: true,\n    });\n\n    // Preprocess shared static assets if configured (move + rewrite sources)\n    await processSharedStaticAssets(settings);\n\n    if (!settings.stageTranslations) {\n      const results = await handleStage(\n        initOptions,\n        settings,\n        this.library,\n        false\n      );\n      if (results) {\n        await handleTranslate(\n          initOptions,\n          settings,\n          results.fileVersionData,\n          results.jobData,\n          results.branchData,\n          results.publishMap\n        );\n      }\n    } else {\n      await handleDownload(initOptions, settings, this.library);\n    }\n    // Only postprocess files downloaded in this run\n    const include = getNeedsPostprocessing();\n    if (include.size > 0) {\n      await postProcessTranslations(settings, include);\n    }\n    // Split Mintlify language entries into $ref files to keep docs.json small\n    await splitMintlifyLanguageRefs(settings);\n    // Mirror assets after translations are downloaded and locale dirs are populated\n    await mirrorAssetsToLocales(settings);\n    clearDownloaded();\n    displayTranslateSummary();\n    clearWarnings();\n  }\n\n  protected setupUploadCommand(): void {\n    attachTranslateFlags(\n      this.program\n        .command('upload')\n        .description(\n          'Upload source files and translations to the General Translation platform'\n        )\n    ).action(async (initOptions: UploadOptions) => {\n      displayHeader('Starting upload...');\n      const settings = await generateSettings(initOptions, undefined, {\n        requireConfig: true,\n      });\n\n      const options = { ...initOptions, ...settings };\n\n      await this.handleUploadCommand(options);\n      logger.endCommand('Done!');\n    });\n  }\n\n  protected setupLoginCommand(): void {\n    this.program\n      .command('auth')\n      .description('Generate General Translation API keys and project ID')\n      .option(\n        '-c, --config <path>',\n        'Filepath to config file, by default gt.config.json',\n        findFilepath(['gt.config.json'])\n      )\n      .option(\n        '-t, --key-type <type>',\n        'Type of key to generate, production | development | all'\n      )\n      .action(async (options: LoginOptions) => {\n        displayHeader('Authenticating with General Translation...');\n        if (!options.keyType) {\n          options.keyType = await promptSelect<\n            'development' | 'production' | 'all'\n          >({\n            message: 'What type of API key would you like to generate?',\n            options: [\n              { value: 'development', label: 'Development' },\n              { value: 'production', label: 'Production' },\n              { value: 'all', label: 'Both' },\n            ],\n            defaultValue: 'all',\n          });\n        } else {\n          if (\n            options.keyType !== 'development' &&\n            options.keyType !== 'production' &&\n            options.keyType !== 'all'\n          ) {\n            logErrorAndExit(\n              'Invalid key type, must be development, production, or all'\n            );\n          }\n        }\n        await this.handleLoginCommand(options);\n        logger.endCommand(\n          `Done! ${options.keyType} keys have been generated and saved to your .env.local file.`\n        );\n      });\n  }\n\n  protected setupInitCommand(): void {\n    this.program\n      .command('init')\n      .description(\n        'Run the setup wizard to configure your project for General Translation'\n      )\n      .option(\n        '--src <paths...>',\n        \"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}'\"\n      )\n      .option(\n        '-c, --config <path>',\n        'Filepath to config file, by default gt.config.json',\n        findFilepath(['gt.config.json'])\n      )\n      .action(async (options: SetupOptions) => {\n        const settings = await generateSettings(options);\n        displayHeader('Running setup wizard...');\n\n        const framework = await detectFramework();\n\n        const useAgent = await (async () => {\n          let useAgentMessage;\n          if (framework.name === 'mintlify') {\n            useAgentMessage = `Mintlify project detected. Would you like to connect to GitHub so that the Locadex AI Agent can translate your project automatically?`;\n          }\n          if (framework.name === 'next-app') {\n            useAgentMessage = `Next.js App Router detected. Would you like to connect to GitHub so that the Locadex AI Agent can set up your project automatically?`;\n          }\n          if (useAgentMessage) {\n            return await promptConfirm({\n              message: useAgentMessage,\n              defaultValue: false,\n            });\n          }\n          return false;\n        })();\n\n        if (useAgent) {\n          await setupLocadex(settings);\n          logger.endCommand(\n            'Once installed, Locadex will open a PR to your repository. See the docs for more information: https://generaltranslation.com/docs/locadex'\n          );\n        } else {\n          // Get framework display info for the defaults message\n          const frameworkDisplayName =\n            framework.type === 'react'\n              ? getFrameworkDisplayName(framework)\n              : null;\n          const library =\n            framework.type === 'react'\n              ? getReactFrameworkLibrary(framework)\n              : null;\n\n          // Build defaults description based on detected framework\n          const defaultTranslationsDir =\n            framework.name === 'vite'\n              ? DEFAULT_VITE_TRANSLATIONS_DIR\n              : DEFAULT_TRANSLATIONS_DIR;\n\n          const defaultsDescription =\n            framework.type === 'react'\n              ? `${library} & GTProvider, ${frameworkDisplayName}, Files saved locally in ${defaultTranslationsDir}`\n              : `Files saved locally in ${defaultTranslationsDir}`;\n\n          // Ask if user wants to use defaults\n          const useDefaults = await promptConfirm({\n            message: `Would you like to use the recommended General Translation defaults? ${chalk.dim(`(${defaultsDescription})`)}`,\n            defaultValue: true,\n          });\n\n          let ranReactSetup = false;\n\n          // so that people can run init in non-js projects\n          if (framework.type === 'react') {\n            const wrap = useDefaults\n              ? true\n              : await promptConfirm({\n                  message: `Would you like to install ${library} and add the GTProvider? See the docs for more information: https://generaltranslation.com/docs/react/tutorials/quickstart`,\n                  defaultValue: true,\n                });\n\n            if (wrap) {\n              logger.info(\n                `${chalk.yellow('[EXPERIMENTAL]')} Configuring project...`\n              );\n              await handleSetupReactCommand(options, framework, useDefaults);\n              logger.endCommand(\n                `Done! Since this wizard is experimental, please review the changes and make modifications as needed.\n\\nNext step: start internationalizing! See the docs for more information: https://generaltranslation.com/docs/react/tutorials/quickstart`\n              );\n              ranReactSetup = true;\n            }\n          }\n\n          if (ranReactSetup) {\n            logger.startCommand('Setting up project config...');\n          }\n          // Configure gt.config.json\n          await this.handleInitCommand(\n            ranReactSetup,\n            useDefaults,\n            framework.name === 'vite'\n          );\n\n          logger.endCommand(\n            'Done! Check out our docs for more information on how to use General Translation: https://generaltranslation.com/docs'\n          );\n        }\n      });\n  }\n\n  protected setupConfigureCommand(): void {\n    this.program\n      .command('configure')\n      .description(\n        'Configure your project for General Translation. This will create a gt.config.json file in your codebase.'\n      )\n      .action(async () => {\n        displayHeader('Configuring project...');\n\n        logger.info(\n          '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.'\n        );\n\n        // Configure gt.config.json\n        const framework = await detectFramework();\n        await this.handleInitCommand(false, false, framework.name === 'vite');\n\n        logger.endCommand(\n          'Done! Make sure you have an API key and project ID to use General Translation. Get them on the dashboard: https://generaltranslation.com/dashboard'\n        );\n      });\n  }\n\n  protected async handleUploadCommand(\n    settings: Settings & UploadOptions\n  ): Promise<void> {\n    if (!settings.files) {\n      return;\n    }\n\n    // Process all file types at once with a single call\n    await upload(settings);\n  }\n\n  // Wizard for configuring gt.config.json\n  protected async handleInitCommand(\n    ranReactSetup: boolean,\n    useDefaults: boolean = false,\n    isVite: boolean = false\n  ): Promise<void> {\n    const { defaultLocale, locales } = await getDesiredLocales(); // Locales should still be asked for even if using defaults\n\n    const packageJson = await searchForPackageJson();\n\n    // Ask if using another i18n library\n    const gtInstalled =\n      !!packageJson &&\n      INLINE_LIBRARIES.some((lib) => isPackageInstalled(lib, packageJson));\n    const isUsingGT = ranReactSetup || gtInstalled;\n\n    // Ask where the translations are stored\n    const usingCDN = await (async () => {\n      if (!isUsingGT) return false;\n      if (useDefaults) return false; // Default to local\n      const selectedValue = await promptSelect({\n        message: `Would you like to save translation files locally or use the General Translation CDN to store them?`,\n        options: [\n          { value: 'local', label: 'Save locally' },\n          { value: 'cdn', label: 'Use CDN' },\n        ],\n        defaultValue: 'local',\n      });\n      return selectedValue === 'cdn';\n    })();\n\n    const defaultTranslationsDir = isVite\n      ? DEFAULT_VITE_TRANSLATIONS_DIR\n      : DEFAULT_TRANSLATIONS_DIR;\n\n    // Ask where the translations are stored\n    const translationsDir =\n      isUsingGT && !usingCDN\n        ? useDefaults\n          ? defaultTranslationsDir\n          : await promptText({\n              message:\n                'What is the path to the directory where you would like to store your translation files?',\n              defaultValue: defaultTranslationsDir,\n            })\n        : null;\n\n    // Determine final translations directory with fallback\n    const finalTranslationsDir =\n      translationsDir?.trim() || defaultTranslationsDir;\n\n    if (isUsingGT && !usingCDN) {\n      // Create loadTranslations.js file for local translations\n      await createLoadTranslationsFile(\n        process.cwd(),\n        finalTranslationsDir,\n        locales\n      );\n      logger.message(\n        `Created ${chalk.cyan('loadTranslations.js')} file for local translations.\nMake sure to add this function to your app configuration.\nSee https://generaltranslation.com/en/docs/next/guides/local-tx`\n      );\n    }\n\n    const message = !isUsingGT\n      ? '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.'\n      : `Do you have any additional files in this project to translate? For example, Markdown files for docs. ${chalk.dim(\n          '(To continue without selecting press Enter)'\n        )}`;\n    const fileExtensions =\n      useDefaults && isUsingGT\n        ? [] // Skip for GT projects when using defaults\n        : await promptMultiSelect({\n            message,\n            options: [\n              { value: 'json', label: FILE_EXT_TO_EXT_LABEL.json },\n              { value: 'md', label: FILE_EXT_TO_EXT_LABEL.md },\n              { value: 'mdx', label: FILE_EXT_TO_EXT_LABEL.mdx },\n              { value: 'ts', label: FILE_EXT_TO_EXT_LABEL.ts },\n              { value: 'js', label: FILE_EXT_TO_EXT_LABEL.js },\n              { value: 'yaml', label: FILE_EXT_TO_EXT_LABEL.yaml },\n              // TWILIO_CONTENT_JSON not supported in CLI init as its too niche\n            ],\n            required: !isUsingGT,\n          });\n\n    const files: FilesOptions = {};\n    for (const fileExtension of fileExtensions) {\n      const label = FILE_EXT_TO_EXT_LABEL[fileExtension];\n      const paths = await promptGlobPatterns({\n        label,\n        message: `${chalk.cyan(FILE_EXT_TO_EXT_LABEL[fileExtension])}: 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.`,\n        defaultValue: `./**/[locale]/*.${fileExtension}`,\n      });\n\n      files[fileExtension] = {\n        include: parseGlobPatterns(paths),\n      };\n    }\n\n    // Add GT translations if using GT and storing locally\n    if (isUsingGT && !usingCDN) {\n      files.gt = {\n        output: path.join(finalTranslationsDir, `[locale].json`),\n      };\n    }\n\n    let configFilepath = 'gt.config.json';\n    if (fs.existsSync('src/gt.config.json')) {\n      configFilepath = 'src/gt.config.json';\n    }\n\n    // Create gt.config.json\n    await createOrUpdateConfig(configFilepath, {\n      defaultLocale,\n      locales,\n      files: Object.keys(files).length > 0 ? files : undefined,\n      publish: isUsingGT && usingCDN,\n    });\n\n    logger.success(\n      `Edit ${chalk.cyan(\n        configFilepath\n      )} to customize your translation setup. Docs: https://generaltranslation.com/docs/cli/reference/config`\n    );\n\n    // Install gt if not installed\n    const isCLIInstalled = packageJson\n      ? isPackageInstalled('gt', packageJson, true, true)\n      : true; // if no package.json, we can't install it\n\n    if (!isCLIInstalled) {\n      const packageManager = await getPackageManager();\n      const spinner = logger.createSpinner();\n      spinner.start(\n        `Installing gt as a dev dependency with ${packageManager.name}...`\n      );\n      await installPackage('gt', packageManager, true);\n      spinner.stop(chalk.green('Installed gt.'));\n    }\n\n    // Set credentials\n    if (!areCredentialsSet()) {\n      const loginQuestion = useDefaults\n        ? true\n        : await promptConfirm({\n            message:\n              'Would you like the wizard to automatically generate API keys and a project ID for you?',\n            defaultValue: true,\n          });\n      if (loginQuestion) {\n        const settings = await generateSettings({});\n        const keyType = useDefaults\n          ? 'all'\n          : await promptSelect<'development' | 'production' | 'all'>({\n              message: 'What type of API key would you like to generate?',\n              options: [\n                { value: 'development', label: 'Development' },\n                { value: 'production', label: 'Production' },\n                { value: 'all', label: 'Both' },\n              ],\n              defaultValue: 'all',\n            });\n        const credentials = await retrieveCredentials(settings, keyType);\n        await setCredentials(credentials, settings.framework);\n      }\n    }\n  }\n  protected async handleLoginCommand(options: LoginOptions): Promise<void> {\n    const settings = await generateSettings({ config: options.config });\n    const keyType = options.keyType || 'all';\n    const credentials = await retrieveCredentials(settings, keyType);\n    await setCredentials(credentials, settings.framework);\n  }\n}\n"],"mappings":"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"}

package/dist/console/index.d.ts

@@ -8,6 +8,7 @@ export declare const warnNestedTComponent: (file: string, location?: string) =>
 export declare const warnNestedInternalTComponent: (file: string, location?: string) => string;
 export declare const warnNonStaticExpressionSync: (file: string, attrName: string, value: string, location?: string) => string;
 export declare const warnInvalidMaxCharsSync: (file: string, value: string, location?: string) => string;
+export declare const warnDeprecatedTSugarPropsSync: (locations: string[]) => string;
 export declare const warnInvalidFormatSync: (file: string, value: string, location?: string) => string;
 export declare const warnInvalidRequiresReviewSync: (file: string, value: string, location?: string) => string;
 export declare const warnInvalidIcuSync: (file: string, value: string, error: string, location?: string) => string;

package/dist/console/index.js

@@ -1,6 +1,7 @@
 import { BRANCH_COMPONENT } from "../react/jsx/utils/constants.js";
 import { colorizeComponent, colorizeContent, colorizeFilepath, colorizeFunctionName, colorizeIdString, colorizeLine } from "./colors.js";
 import { formatCodeClamp } from "./formatting.js";
+import { createDiagnosticMessage } from "generaltranslation/internal";
 //#region src/console/index.ts
 const withWillErrorInNextVersion = (message) => `${message} (This will become an error in the next major version of the CLI.)`;
 const withDeriveComponentError = (message) => `<Derive> rules violation: ${message}`;
@@ -14,7 +15,11 @@ const warnFailedToConstructJsxTreeSync = (file, code, location) => withLocation(
 const warnNestedTComponent = (file, location) => withLocation(file, `Found nested <T> component. <T> components cannot be directly nested.`, location);
 const warnNestedInternalTComponent = (file, location) => withLocation(file, `DEBUG: Found nested <GtInternalTranslateJsx> component. <GtInternalTranslateJsx> components cannot be directly nested.`, location);
 const warnNonStaticExpressionSync = (file, attrName, value, location) => withLocation(file, `Found non-static expression for attribute ${colorizeIdString(attrName)}: ${colorizeContent(value)}. Change "${colorizeIdString(attrName)}" to ensure this content is translated.`, location);
-const warnInvalidMaxCharsSync = (file, value, location) => withLocation(file, `Found invalid maxChars value: ${colorizeContent(value)}. Change the value to a valid number to ensure this content is translated.`, location);
+const warnInvalidMaxCharsSync = (file, value, location) => withLocation(file, `Found invalid maxChars value: ${colorizeContent(value)}. maxChars must be a numeric literal, e.g. maxChars={10}, to ensure this content is translated.`, location);
+const warnDeprecatedTSugarPropsSync = (locations) => createDiagnosticMessage({
+	whatHappened: `Found ${locations.length} deprecated ${colorizeIdString("$")}-prefixed prop${locations.length === 1 ? "" : "s"} on ${colorizeComponent("<T>")} components`,
+	fix: `Use the unprefixed forms instead (${colorizeIdString("context")}, ${colorizeIdString("id")}, ${colorizeIdString("maxChars")}, ${colorizeIdString("requiresReview")}); support for the ${colorizeIdString("$")}-prefixed forms will be removed in the next major version`
+}) + "\n" + locations.map((location) => `  ${colorizeLine(location)}`).join("\n");
 const warnInvalidFormatSync = (file, value, location) => withLocation(file, `Found invalid $format value: ${colorizeContent(value)}. Must be one of: 'ICU', 'STRING', 'I18NEXT'.`, location);
 const warnInvalidRequiresReviewSync = (file, value, location) => withLocation(file, `Found invalid requiresReview value: ${colorizeContent(value)}. Must be a boolean literal (true or false) — strings and dynamic expressions are not allowed.`, location);
 const warnInvalidIcuSync = (file, value, error, location) => withWillErrorInNextVersion(withLocation(file, `Found invalid ICU string: ${colorizeContent(value)}. Change the value to a valid ICU to ensure this content is translated. Error message: ${error}.`, location));
@@ -52,6 +57,6 @@ const invalidConfigurationError = `The files configuration cannot be used for th
 const branchResolutionError = `The current git branch could not be resolved. Specify a branch explicitly or run the command from a git worktree with branch metadata available.`;
 const withOriginalError = (message, error) => error != null ? `${message} Original error: ${String(error)}` : message;
 //#endregion
-export { branchResolutionError, devApiKeyError, invalidConfigurationError, noApiKeyError, noDefaultLocaleError, noFilesError, noLocalesError, noProjectIdError, noSourceFileError, warnApiKeyInConfigSync, warnAsyncUseGT, warnAutoderiveNoResultsSync, warnDataAttrOnBranch, warnDeriveCircularSpreadSync, warnDeriveDestructuringSync, warnDeriveFunctionNoResultsSync, warnDeriveFunctionNotWrappedSync, warnDeriveNonConstVariableSync, warnDeriveOptionalChainingSync, warnDeriveUnresolvableValueSync, warnDuplicateFunctionDefinitionSync, warnFailedToConstructJsxTreeSync, warnFunctionNotFoundSync, warnHasUnwrappedExpressionSync, warnInvalidDeclareVarNameSync, warnInvalidDeriveInitSync, warnInvalidFormatSync, warnInvalidIcuSync, warnInvalidMaxCharsSync, warnInvalidRequiresReviewSync, warnInvalidReturnSync, warnMissingReturnSync, warnNestedInternalTComponent, warnNestedTComponent, warnNonStaticExpressionSync, warnNonStringSync, warnRecursiveFunctionCallSync, warnSyncGetGT, warnTemplateLiteralSync, warnTernarySync, warnUnresolvedImportSync, warnVariablePropSync, withLocation, withOriginalError };
+export { branchResolutionError, devApiKeyError, invalidConfigurationError, noApiKeyError, noDefaultLocaleError, noFilesError, noLocalesError, noProjectIdError, noSourceFileError, warnApiKeyInConfigSync, warnAsyncUseGT, warnAutoderiveNoResultsSync, warnDataAttrOnBranch, warnDeprecatedTSugarPropsSync, warnDeriveCircularSpreadSync, warnDeriveDestructuringSync, warnDeriveFunctionNoResultsSync, warnDeriveFunctionNotWrappedSync, warnDeriveNonConstVariableSync, warnDeriveOptionalChainingSync, warnDeriveUnresolvableValueSync, warnDuplicateFunctionDefinitionSync, warnFailedToConstructJsxTreeSync, warnFunctionNotFoundSync, warnHasUnwrappedExpressionSync, warnInvalidDeclareVarNameSync, warnInvalidDeriveInitSync, warnInvalidFormatSync, warnInvalidIcuSync, warnInvalidMaxCharsSync, warnInvalidRequiresReviewSync, warnInvalidReturnSync, warnMissingReturnSync, warnNestedInternalTComponent, warnNestedTComponent, warnNonStaticExpressionSync, warnNonStringSync, warnRecursiveFunctionCallSync, warnSyncGetGT, warnTemplateLiteralSync, warnTernarySync, warnUnresolvedImportSync, warnVariablePropSync, withLocation, withOriginalError };
 
 //# sourceMappingURL=index.js.map

package/dist/console/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/console/index.ts"],"sourcesContent":["import { BRANCH_COMPONENT } from '../react/jsx/utils/constants.js';\nimport {\n  colorizeFilepath,\n  colorizeComponent,\n  colorizeIdString,\n  colorizeContent,\n  colorizeLine,\n  colorizeFunctionName,\n} from './colors.js';\nimport { formatCodeClamp } from './formatting.js';\n\nconst withWillErrorInNextVersion = (message: string): string =>\n  `${message} (This will become an error in the next major version of the CLI.)`;\n\n// Derive function related errors\nconst withDeriveComponentError = (message: string): string =>\n  `<Derive> rules violation: ${message}`;\n\nconst withDeriveFunctionError = (message: string): string =>\n  `derive() rules violation: ${message}`;\n// Synchronous wrappers for backward compatibility\nexport const warnApiKeyInConfigSync = (optionsFilepath: string): string =>\n  `${colorizeFilepath(\n    optionsFilepath\n  )}: Your API key is exposed! Remove it from the file and include it as an environment variable.`;\n\nexport const warnVariablePropSync = (\n  file: string,\n  attrName: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `${colorizeComponent('<T>')} component has dynamic attribute ${colorizeIdString(attrName)} with value: ${colorizeContent(\n      value\n    )}. Change ${colorizeIdString(attrName)} to ensure this content is translated.`,\n    location\n  );\n\nexport const warnInvalidReturnSync = (\n  file: string,\n  functionName: string,\n  expression: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveComponentError(\n      `Function ${colorizeFunctionName(functionName)} does not return a derivable (statically analyzable) expression. ${colorizeFunctionName(functionName)} must return either (1) a derivable string literal, (2) another derivable function invocation, (3) derivable JSX content, or (4) a ternary expression. Instead got:\\n${colorizeContent(expression)}`\n    ),\n    location\n  );\n\n// TODO: this is temporary until we handle implicit returns\nexport const warnMissingReturnSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Function ${colorizeFunctionName(functionName)} is wrapped in ${colorizeComponent('<Derive>')} tags but does not have an explicit return statement. Derivable functions must have an explicit return statement.`,\n    location\n  );\n\nexport const warnHasUnwrappedExpressionSync = (\n  file: string,\n  unwrappedExpressions: string[],\n  id?: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `${colorizeComponent('<T>')} component${\n      id ? ` with id ${colorizeIdString(id)}` : ''\n    } has children that could change at runtime. Use a variable component like ${colorizeComponent(\n      '<Var>'\n    )} to ensure this content is translated.\\n${colorizeContent(\n      unwrappedExpressions.join('\\n')\n    )}`,\n    location\n  );\n\nexport const warnFailedToConstructJsxTreeSync = (\n  file: string,\n  code: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Failed to construct JsxTree! Call expression is not a valid createElement call: ${colorizeContent(code)}`,\n    location\n  );\n\nexport const warnNestedTComponent = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    `Found nested <T> component. <T> components cannot be directly nested.`,\n    location\n  );\n\nexport const warnNestedInternalTComponent = (\n  file: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `DEBUG: Found nested <GtInternalTranslateJsx> component. <GtInternalTranslateJsx> components cannot be directly nested.`,\n    location\n  );\n\nexport const warnNonStaticExpressionSync = (\n  file: string,\n  attrName: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found non-static expression for attribute ${colorizeIdString(\n      attrName\n    )}: ${colorizeContent(value)}. Change \"${colorizeIdString(attrName)}\" to ensure this content is translated.`,\n    location\n  );\n\nexport const warnInvalidMaxCharsSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid maxChars value: ${colorizeContent(value)}. Change the value to a valid number to ensure this content is translated.`,\n    location\n  );\n\nexport const warnInvalidFormatSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid $format value: ${colorizeContent(value)}. Must be one of: 'ICU', 'STRING', 'I18NEXT'.`,\n    location\n  );\n\nexport const warnInvalidRequiresReviewSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid requiresReview value: ${colorizeContent(value)}. Must be a boolean literal (true or false) — strings and dynamic expressions are not allowed.`,\n    location\n  );\n\nexport const warnInvalidIcuSync = (\n  file: string,\n  value: string,\n  error: string,\n  location?: string\n): string =>\n  withWillErrorInNextVersion(\n    withLocation(\n      file,\n      `Found invalid ICU string: ${colorizeContent(value)}. Change the value to a valid ICU to ensure this content is translated. Error message: ${error}.`,\n      location\n    )\n  );\n\nexport const warnTemplateLiteralSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found template literal with quasis (${colorizeContent(value)}). Change the template literal to a string to ensure this content is translated.`,\n    location\n  );\n\nexport const warnNonStringSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found non-string literal (${colorizeContent(value)}). Change the value to a string literal to ensure this content is translated.`,\n    location\n  );\n\nexport const warnAsyncUseGT = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    `Found useGT() in an async function. Use getGT() instead, or make the function synchronous.`,\n    location\n  );\n\nexport const warnSyncGetGT = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    `Found getGT() in a synchronous function. Use useGT() instead, or make the function async.`,\n    location\n  );\n\nexport const warnTernarySync = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    'Found ternary expression. A Branch component may be more appropriate here.',\n    location\n  );\n\nexport const withLocation = (\n  file: string,\n  message: string,\n  location?: string\n): string =>\n  `${colorizeFilepath(file)}${location ? ` (${colorizeLine(location)})` : ''}: ${message}`;\n\nexport const warnFunctionNotFoundSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Function ${colorizeFunctionName(functionName)} definition could not be resolved. This might affect translation resolution for this ${colorizeComponent('<T>')} component.`,\n    location\n  );\n\nexport const warnInvalidDeclareVarNameSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid declareVar() $name tag. Must be a derivable (statically analyzable) expression. Received: ${colorizeContent(value)}.`,\n    location\n  );\n\nexport const warnDuplicateFunctionDefinitionSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Function ${colorizeFunctionName(functionName)} is defined multiple times. Only the first definition will be used.`,\n    location\n  );\n\nexport const warnInvalidDeriveInitSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveComponentError(\n      `The definition for ${colorizeFunctionName(functionName)} could not be resolved. When using arrow syntax to define a derivable (statically analyzable) function, the right hand side or the assignment MUST only contain the arrow function itself and no other expressions.\nExample: ${colorizeContent(`const ${colorizeFunctionName(functionName)} = () => { ... }`)}\nInvalid: ${colorizeContent(`const ${colorizeFunctionName(functionName)} = [() => { ... }][0]`)}`\n    ),\n    location\n  );\n\nexport const warnDataAttrOnBranch = (\n  file: string,\n  attrName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `${colorizeComponent(`<${BRANCH_COMPONENT}>`)} component ignores attributes prefixed with ${colorizeIdString('\"data-\"')}. Found ${colorizeIdString(attrName)}. Remove it or use a different attribute name.`,\n    location\n  );\n\nexport const warnRecursiveFunctionCallSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveComponentError(\n      `Recursive function call detected: ${colorizeFunctionName(functionName)}. A derivable (statically analyzable) function cannot use recursive calls to construct its result.`\n    ),\n    location\n  );\n\nexport const warnDeriveFunctionNotWrappedSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Could not resolve ${colorizeFunctionName(formatCodeClamp(functionName))}. This call is not wrapped in derive(). Ensure the function is properly wrapped with derive() and does not have circular import dependencies.`\n    ),\n    location\n  );\n\nexport const warnDeriveNonConstVariableSync = (\n  file: string,\n  varName: string,\n  kind: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Variable ${colorizeFunctionName(varName)} is declared with '${kind}' but only 'const' declarations can be resolved statically. Change it to 'const'.`\n    ),\n    location\n  );\n\nexport const warnDeriveFunctionNoResultsSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Could not resolve ${colorizeFunctionName(formatCodeClamp(functionName))}. derive() can only receive function invocations and cannot use undefined values or looped calls to construct its result.`\n    ),\n    location\n  );\n\nexport const warnAutoderiveNoResultsSync = (\n  file: string,\n  expression: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Autoderive could not resolve ${colorizeFunctionName(formatCodeClamp(expression))}. Only function calls with statically determinable return values can be used directly in t(). Consider wrapping with derive() for explicit derivation, or use an interpolation variable instead.`,\n    location\n  );\n\nexport const warnDeriveUnresolvableValueSync = (\n  file: string,\n  key: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Object property ${colorizeFunctionName(formatCodeClamp(key))} could not be resolved to a static string value. Only string literals, template literals, conditionals, and function calls returning strings are supported.`\n    ),\n    location\n  );\n\nexport const warnDeriveCircularSpreadSync = (\n  file: string,\n  varName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Circular spread detected involving ${colorizeFunctionName(varName)}. Spread references that form a cycle cannot be resolved statically.`\n    ),\n    location\n  );\n\nexport const warnDeriveDestructuringSync = (\n  file: string,\n  varName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Variable ${colorizeFunctionName(varName)} uses destructuring syntax, which is not yet supported in derive(). Assign the value to a const variable directly instead.`\n    ),\n    location\n  );\n\nexport const warnDeriveOptionalChainingSync = (\n  file: string,\n  code: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Optional chaining (${colorizeFunctionName(formatCodeClamp(code))}) is not supported in derive(). Optional chaining implies the value could be undefined, which cannot be resolved statically. Use a non-optional access instead.`\n    ),\n    location\n  );\n\nexport const warnUnresolvedImportSync = (\n  file: string,\n  functionName: string,\n  importPath: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Could not resolve import ${colorizeFunctionName(importPath)} for function ${colorizeFunctionName(functionName)}. Translation strings inside this function will not be extracted.`,\n    location\n  );\n\n// Re-export error messages\nexport const noLocalesError = `No target locales were found. Add locales to gt.config.json or pass them with the --locales flag.`;\nexport const noDefaultLocaleError = `No default locale was found. Add defaultLocale to gt.config.json or pass it with --default-locale.`;\nexport const noFilesError = `The files configuration is missing or invalid. Check the files section in gt.config.json and try again.`;\nexport const noSourceFileError = `No source translation file was found. Check your translations directory and default locale configuration.`;\nexport const noApiKeyError = `No API key was found. Pass --api-key or set the GT_API_KEY environment variable.`;\nexport const devApiKeyError = `Development API keys cannot be used with the General Translation API. Use a production API key instead.\\nGenerate a production API key with: npx gt auth -t production`;\nexport const noProjectIdError = `No project ID was found. Pass --project-id, add projectId to gt.config.json, or set the GT_PROJECT_ID environment variable.`;\nexport const invalidConfigurationError = `The files configuration cannot be used for this operation. Provide a valid download configuration or set --publish true to upload translations to the CDN.`;\nexport const branchResolutionError = `The current git branch could not be resolved. Specify a branch explicitly or run the command from a git worktree with branch metadata available.`;\n\nexport const withOriginalError = (message: string, error: unknown): string =>\n  error != null ? `${message} Original error: ${String(error)}` : message;\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/console/index.ts"],"sourcesContent":["import { createDiagnosticMessage } from 'generaltranslation/internal';\nimport { BRANCH_COMPONENT } from '../react/jsx/utils/constants.js';\nimport {\n  colorizeFilepath,\n  colorizeComponent,\n  colorizeIdString,\n  colorizeContent,\n  colorizeLine,\n  colorizeFunctionName,\n} from './colors.js';\nimport { formatCodeClamp } from './formatting.js';\n\nconst withWillErrorInNextVersion = (message: string): string =>\n  `${message} (This will become an error in the next major version of the CLI.)`;\n\n// Derive function related errors\nconst withDeriveComponentError = (message: string): string =>\n  `<Derive> rules violation: ${message}`;\n\nconst withDeriveFunctionError = (message: string): string =>\n  `derive() rules violation: ${message}`;\n// Synchronous wrappers for backward compatibility\nexport const warnApiKeyInConfigSync = (optionsFilepath: string): string =>\n  `${colorizeFilepath(\n    optionsFilepath\n  )}: Your API key is exposed! Remove it from the file and include it as an environment variable.`;\n\nexport const warnVariablePropSync = (\n  file: string,\n  attrName: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `${colorizeComponent('<T>')} component has dynamic attribute ${colorizeIdString(attrName)} with value: ${colorizeContent(\n      value\n    )}. Change ${colorizeIdString(attrName)} to ensure this content is translated.`,\n    location\n  );\n\nexport const warnInvalidReturnSync = (\n  file: string,\n  functionName: string,\n  expression: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveComponentError(\n      `Function ${colorizeFunctionName(functionName)} does not return a derivable (statically analyzable) expression. ${colorizeFunctionName(functionName)} must return either (1) a derivable string literal, (2) another derivable function invocation, (3) derivable JSX content, or (4) a ternary expression. Instead got:\\n${colorizeContent(expression)}`\n    ),\n    location\n  );\n\n// TODO: this is temporary until we handle implicit returns\nexport const warnMissingReturnSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Function ${colorizeFunctionName(functionName)} is wrapped in ${colorizeComponent('<Derive>')} tags but does not have an explicit return statement. Derivable functions must have an explicit return statement.`,\n    location\n  );\n\nexport const warnHasUnwrappedExpressionSync = (\n  file: string,\n  unwrappedExpressions: string[],\n  id?: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `${colorizeComponent('<T>')} component${\n      id ? ` with id ${colorizeIdString(id)}` : ''\n    } has children that could change at runtime. Use a variable component like ${colorizeComponent(\n      '<Var>'\n    )} to ensure this content is translated.\\n${colorizeContent(\n      unwrappedExpressions.join('\\n')\n    )}`,\n    location\n  );\n\nexport const warnFailedToConstructJsxTreeSync = (\n  file: string,\n  code: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Failed to construct JsxTree! Call expression is not a valid createElement call: ${colorizeContent(code)}`,\n    location\n  );\n\nexport const warnNestedTComponent = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    `Found nested <T> component. <T> components cannot be directly nested.`,\n    location\n  );\n\nexport const warnNestedInternalTComponent = (\n  file: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `DEBUG: Found nested <GtInternalTranslateJsx> component. <GtInternalTranslateJsx> components cannot be directly nested.`,\n    location\n  );\n\nexport const warnNonStaticExpressionSync = (\n  file: string,\n  attrName: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found non-static expression for attribute ${colorizeIdString(\n      attrName\n    )}: ${colorizeContent(value)}. Change \"${colorizeIdString(attrName)}\" to ensure this content is translated.`,\n    location\n  );\n\nexport const warnInvalidMaxCharsSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid maxChars value: ${colorizeContent(value)}. maxChars must be a numeric literal, e.g. maxChars={10}, to ensure this content is translated.`,\n    location\n  );\n\nexport const warnDeprecatedTSugarPropsSync = (locations: string[]): string =>\n  createDiagnosticMessage({\n    whatHappened: `Found ${locations.length} deprecated ${colorizeIdString(\n      '$'\n    )}-prefixed prop${locations.length === 1 ? '' : 's'} on ${colorizeComponent(\n      '<T>'\n    )} components`,\n    fix: `Use the unprefixed forms instead (${colorizeIdString(\n      'context'\n    )}, ${colorizeIdString('id')}, ${colorizeIdString('maxChars')}, ${colorizeIdString(\n      'requiresReview'\n    )}); support for the ${colorizeIdString('$')}-prefixed forms will be removed in the next major version`,\n  }) +\n  '\\n' +\n  locations.map((location) => `  ${colorizeLine(location)}`).join('\\n');\n\nexport const warnInvalidFormatSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid $format value: ${colorizeContent(value)}. Must be one of: 'ICU', 'STRING', 'I18NEXT'.`,\n    location\n  );\n\nexport const warnInvalidRequiresReviewSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid requiresReview value: ${colorizeContent(value)}. Must be a boolean literal (true or false) — strings and dynamic expressions are not allowed.`,\n    location\n  );\n\nexport const warnInvalidIcuSync = (\n  file: string,\n  value: string,\n  error: string,\n  location?: string\n): string =>\n  withWillErrorInNextVersion(\n    withLocation(\n      file,\n      `Found invalid ICU string: ${colorizeContent(value)}. Change the value to a valid ICU to ensure this content is translated. Error message: ${error}.`,\n      location\n    )\n  );\n\nexport const warnTemplateLiteralSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found template literal with quasis (${colorizeContent(value)}). Change the template literal to a string to ensure this content is translated.`,\n    location\n  );\n\nexport const warnNonStringSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found non-string literal (${colorizeContent(value)}). Change the value to a string literal to ensure this content is translated.`,\n    location\n  );\n\nexport const warnAsyncUseGT = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    `Found useGT() in an async function. Use getGT() instead, or make the function synchronous.`,\n    location\n  );\n\nexport const warnSyncGetGT = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    `Found getGT() in a synchronous function. Use useGT() instead, or make the function async.`,\n    location\n  );\n\nexport const warnTernarySync = (file: string, location?: string): string =>\n  withLocation(\n    file,\n    'Found ternary expression. A Branch component may be more appropriate here.',\n    location\n  );\n\nexport const withLocation = (\n  file: string,\n  message: string,\n  location?: string\n): string =>\n  `${colorizeFilepath(file)}${location ? ` (${colorizeLine(location)})` : ''}: ${message}`;\n\nexport const warnFunctionNotFoundSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Function ${colorizeFunctionName(functionName)} definition could not be resolved. This might affect translation resolution for this ${colorizeComponent('<T>')} component.`,\n    location\n  );\n\nexport const warnInvalidDeclareVarNameSync = (\n  file: string,\n  value: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Found invalid declareVar() $name tag. Must be a derivable (statically analyzable) expression. Received: ${colorizeContent(value)}.`,\n    location\n  );\n\nexport const warnDuplicateFunctionDefinitionSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Function ${colorizeFunctionName(functionName)} is defined multiple times. Only the first definition will be used.`,\n    location\n  );\n\nexport const warnInvalidDeriveInitSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveComponentError(\n      `The definition for ${colorizeFunctionName(functionName)} could not be resolved. When using arrow syntax to define a derivable (statically analyzable) function, the right hand side or the assignment MUST only contain the arrow function itself and no other expressions.\nExample: ${colorizeContent(`const ${colorizeFunctionName(functionName)} = () => { ... }`)}\nInvalid: ${colorizeContent(`const ${colorizeFunctionName(functionName)} = [() => { ... }][0]`)}`\n    ),\n    location\n  );\n\nexport const warnDataAttrOnBranch = (\n  file: string,\n  attrName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `${colorizeComponent(`<${BRANCH_COMPONENT}>`)} component ignores attributes prefixed with ${colorizeIdString('\"data-\"')}. Found ${colorizeIdString(attrName)}. Remove it or use a different attribute name.`,\n    location\n  );\n\nexport const warnRecursiveFunctionCallSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveComponentError(\n      `Recursive function call detected: ${colorizeFunctionName(functionName)}. A derivable (statically analyzable) function cannot use recursive calls to construct its result.`\n    ),\n    location\n  );\n\nexport const warnDeriveFunctionNotWrappedSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Could not resolve ${colorizeFunctionName(formatCodeClamp(functionName))}. This call is not wrapped in derive(). Ensure the function is properly wrapped with derive() and does not have circular import dependencies.`\n    ),\n    location\n  );\n\nexport const warnDeriveNonConstVariableSync = (\n  file: string,\n  varName: string,\n  kind: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Variable ${colorizeFunctionName(varName)} is declared with '${kind}' but only 'const' declarations can be resolved statically. Change it to 'const'.`\n    ),\n    location\n  );\n\nexport const warnDeriveFunctionNoResultsSync = (\n  file: string,\n  functionName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Could not resolve ${colorizeFunctionName(formatCodeClamp(functionName))}. derive() can only receive function invocations and cannot use undefined values or looped calls to construct its result.`\n    ),\n    location\n  );\n\nexport const warnAutoderiveNoResultsSync = (\n  file: string,\n  expression: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Autoderive could not resolve ${colorizeFunctionName(formatCodeClamp(expression))}. Only function calls with statically determinable return values can be used directly in t(). Consider wrapping with derive() for explicit derivation, or use an interpolation variable instead.`,\n    location\n  );\n\nexport const warnDeriveUnresolvableValueSync = (\n  file: string,\n  key: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Object property ${colorizeFunctionName(formatCodeClamp(key))} could not be resolved to a static string value. Only string literals, template literals, conditionals, and function calls returning strings are supported.`\n    ),\n    location\n  );\n\nexport const warnDeriveCircularSpreadSync = (\n  file: string,\n  varName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Circular spread detected involving ${colorizeFunctionName(varName)}. Spread references that form a cycle cannot be resolved statically.`\n    ),\n    location\n  );\n\nexport const warnDeriveDestructuringSync = (\n  file: string,\n  varName: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Variable ${colorizeFunctionName(varName)} uses destructuring syntax, which is not yet supported in derive(). Assign the value to a const variable directly instead.`\n    ),\n    location\n  );\n\nexport const warnDeriveOptionalChainingSync = (\n  file: string,\n  code: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    withDeriveFunctionError(\n      `Optional chaining (${colorizeFunctionName(formatCodeClamp(code))}) is not supported in derive(). Optional chaining implies the value could be undefined, which cannot be resolved statically. Use a non-optional access instead.`\n    ),\n    location\n  );\n\nexport const warnUnresolvedImportSync = (\n  file: string,\n  functionName: string,\n  importPath: string,\n  location?: string\n): string =>\n  withLocation(\n    file,\n    `Could not resolve import ${colorizeFunctionName(importPath)} for function ${colorizeFunctionName(functionName)}. Translation strings inside this function will not be extracted.`,\n    location\n  );\n\n// Re-export error messages\nexport const noLocalesError = `No target locales were found. Add locales to gt.config.json or pass them with the --locales flag.`;\nexport const noDefaultLocaleError = `No default locale was found. Add defaultLocale to gt.config.json or pass it with --default-locale.`;\nexport const noFilesError = `The files configuration is missing or invalid. Check the files section in gt.config.json and try again.`;\nexport const noSourceFileError = `No source translation file was found. Check your translations directory and default locale configuration.`;\nexport const noApiKeyError = `No API key was found. Pass --api-key or set the GT_API_KEY environment variable.`;\nexport const devApiKeyError = `Development API keys cannot be used with the General Translation API. Use a production API key instead.\\nGenerate a production API key with: npx gt auth -t production`;\nexport const noProjectIdError = `No project ID was found. Pass --project-id, add projectId to gt.config.json, or set the GT_PROJECT_ID environment variable.`;\nexport const invalidConfigurationError = `The files configuration cannot be used for this operation. Provide a valid download configuration or set --publish true to upload translations to the CDN.`;\nexport const branchResolutionError = `The current git branch could not be resolved. Specify a branch explicitly or run the command from a git worktree with branch metadata available.`;\n\nexport const withOriginalError = (message: string, error: unknown): string =>\n  error != null ? `${message} Original error: ${String(error)}` : message;\n"],"mappings":";;;;;AAYA,MAAM,8BAA8B,YAClC,GAAG,QAAQ;AAGb,MAAM,4BAA4B,YAChC,6BAA6B;AAE/B,MAAM,2BAA2B,YAC/B,6BAA6B;AAE/B,MAAa,0BAA0B,oBACrC,GAAG,iBACD,gBACD,CAAC;AAEJ,MAAa,wBACX,MACA,UACA,OACA,aAEA,aACE,MACA,GAAG,kBAAkB,MAAM,CAAC,mCAAmC,iBAAiB,SAAS,CAAC,eAAe,gBACvG,MACD,CAAC,WAAW,iBAAiB,SAAS,CAAC,yCACxC,SACD;AAEH,MAAa,yBACX,MACA,cACA,YACA,aAEA,aACE,MACA,yBACE,YAAY,qBAAqB,aAAa,CAAC,mEAAmE,qBAAqB,aAAa,CAAC,uKAAuK,gBAAgB,WAAW,GACxV,EACD,SACD;AAGH,MAAa,yBACX,MACA,cACA,aAEA,aACE,MACA,YAAY,qBAAqB,aAAa,CAAC,iBAAiB,kBAAkB,WAAW,CAAC,oHAC9F,SACD;AAEH,MAAa,kCACX,MACA,sBACA,IACA,aAEA,aACE,MACA,GAAG,kBAAkB,MAAM,CAAC,YAC1B,KAAK,YAAY,iBAAiB,GAAG,KAAK,GAC3C,4EAA4E,kBAC3E,QACD,CAAC,0CAA0C,gBAC1C,qBAAqB,KAAK,KAAK,CAChC,IACD,SACD;AAEH,MAAa,oCACX,MACA,MACA,aAEA,aACE,MACA,mFAAmF,gBAAgB,KAAK,IACxG,SACD;AAEH,MAAa,wBAAwB,MAAc,aACjD,aACE,MACA,yEACA,SACD;AAEH,MAAa,gCACX,MACA,aAEA,aACE,MACA,0HACA,SACD;AAEH,MAAa,+BACX,MACA,UACA,OACA,aAEA,aACE,MACA,6CAA6C,iBAC3C,SACD,CAAC,IAAI,gBAAgB,MAAM,CAAC,YAAY,iBAAiB,SAAS,CAAC,0CACpE,SACD;AAEH,MAAa,2BACX,MACA,OACA,aAEA,aACE,MACA,iCAAiC,gBAAgB,MAAM,CAAC,kGACxD,SACD;AAEH,MAAa,iCAAiC,cAC5C,wBAAwB;CACtB,cAAc,SAAS,UAAU,OAAO,cAAc,iBACpD,IACD,CAAC,gBAAgB,UAAU,WAAW,IAAI,KAAK,IAAI,MAAM,kBACxD,MACD,CAAC;CACF,KAAK,qCAAqC,iBACxC,UACD,CAAC,IAAI,iBAAiB,KAAK,CAAC,IAAI,iBAAiB,WAAW,CAAC,IAAI,iBAChE,iBACD,CAAC,qBAAqB,iBAAiB,IAAI,CAAC;CAC9C,CAAC,GACF,OACA,UAAU,KAAK,aAAa,KAAK,aAAa,SAAS,GAAG,CAAC,KAAK,KAAK;AAEvE,MAAa,yBACX,MACA,OACA,aAEA,aACE,MACA,gCAAgC,gBAAgB,MAAM,CAAC,gDACvD,SACD;AAEH,MAAa,iCACX,MACA,OACA,aAEA,aACE,MACA,uCAAuC,gBAAgB,MAAM,CAAC,iGAC9D,SACD;AAEH,MAAa,sBACX,MACA,OACA,OACA,aAEA,2BACE,aACE,MACA,6BAA6B,gBAAgB,MAAM,CAAC,yFAAyF,MAAM,IACnJ,SACD,CACF;AAEH,MAAa,2BACX,MACA,OACA,aAEA,aACE,MACA,uCAAuC,gBAAgB,MAAM,CAAC,mFAC9D,SACD;AAEH,MAAa,qBACX,MACA,OACA,aAEA,aACE,MACA,6BAA6B,gBAAgB,MAAM,CAAC,gFACpD,SACD;AAEH,MAAa,kBAAkB,MAAc,aAC3C,aACE,MACA,8FACA,SACD;AAEH,MAAa,iBAAiB,MAAc,aAC1C,aACE,MACA,6FACA,SACD;AAEH,MAAa,mBAAmB,MAAc,aAC5C,aACE,MACA,8EACA,SACD;AAEH,MAAa,gBACX,MACA,SACA,aAEA,GAAG,iBAAiB,KAAK,GAAG,WAAW,KAAK,aAAa,SAAS,CAAC,KAAK,GAAG,IAAI;AAEjF,MAAa,4BACX,MACA,cACA,aAEA,aACE,MACA,YAAY,qBAAqB,aAAa,CAAC,uFAAuF,kBAAkB,MAAM,CAAC,cAC/J,SACD;AAEH,MAAa,iCACX,MACA,OACA,aAEA,aACE,MACA,2GAA2G,gBAAgB,MAAM,CAAC,IAClI,SACD;AAEH,MAAa,uCACX,MACA,cACA,aAEA,aACE,MACA,YAAY,qBAAqB,aAAa,CAAC,sEAC/C,SACD;AAEH,MAAa,6BACX,MACA,cACA,aAEA,aACE,MACA,yBACE,sBAAsB,qBAAqB,aAAa,CAAC;WACpD,gBAAgB,SAAS,qBAAqB,aAAa,CAAC,kBAAkB,CAAC;WAC/E,gBAAgB,SAAS,qBAAqB,aAAa,CAAC,uBAAuB,GACzF,EACD,SACD;AAEH,MAAa,wBACX,MACA,UACA,aAEA,aACE,MACA,GAAG,kBAAkB,IAAI,iBAAiB,GAAG,CAAC,8CAA8C,iBAAiB,YAAU,CAAC,UAAU,iBAAiB,SAAS,CAAC,iDAC7J,SACD;AAEH,MAAa,iCACX,MACA,cACA,aAEA,aACE,MACA,yBACE,qCAAqC,qBAAqB,aAAa,CAAC,oGACzE,EACD,SACD;AAEH,MAAa,oCACX,MACA,cACA,aAEA,aACE,MACA,wBACE,qBAAqB,qBAAqB,gBAAgB,aAAa,CAAC,CAAC,+IAC1E,EACD,SACD;AAEH,MAAa,kCACX,MACA,SACA,MACA,aAEA,aACE,MACA,wBACE,YAAY,qBAAqB,QAAQ,CAAC,qBAAqB,KAAK,mFACrE,EACD,SACD;AAEH,MAAa,mCACX,MACA,cACA,aAEA,aACE,MACA,wBACE,qBAAqB,qBAAqB,gBAAgB,aAAa,CAAC,CAAC,2HAC1E,EACD,SACD;AAEH,MAAa,+BACX,MACA,YACA,aAEA,aACE,MACA,gCAAgC,qBAAqB,gBAAgB,WAAW,CAAC,CAAC,mMAClF,SACD;AAEH,MAAa,mCACX,MACA,KACA,aAEA,aACE,MACA,wBACE,mBAAmB,qBAAqB,gBAAgB,IAAI,CAAC,CAAC,6JAC/D,EACD,SACD;AAEH,MAAa,gCACX,MACA,SACA,aAEA,aACE,MACA,wBACE,sCAAsC,qBAAqB,QAAQ,CAAC,sEACrE,EACD,SACD;AAEH,MAAa,+BACX,MACA,SACA,aAEA,aACE,MACA,wBACE,YAAY,qBAAqB,QAAQ,CAAC,4HAC3C,EACD,SACD;AAEH,MAAa,kCACX,MACA,MACA,aAEA,aACE,MACA,wBACE,sBAAsB,qBAAqB,gBAAgB,KAAK,CAAC,CAAC,iKACnE,EACD,SACD;AAEH,MAAa,4BACX,MACA,cACA,YACA,aAEA,aACE,MACA,4BAA4B,qBAAqB,WAAW,CAAC,gBAAgB,qBAAqB,aAAa,CAAC,oEAChH,SACD;AAGH,MAAa,iBAAiB;AAC9B,MAAa,uBAAuB;AACpC,MAAa,eAAe;AAC5B,MAAa,oBAAoB;AACjC,MAAa,gBAAgB;AAC7B,MAAa,iBAAiB;AAC9B,MAAa,mBAAmB;AAChC,MAAa,4BAA4B;AACzC,MAAa,wBAAwB;AAErC,MAAa,qBAAqB,SAAiB,UACjD,SAAS,OAAO,GAAG,QAAQ,mBAAmB,OAAO,MAAM,KAAK"}

package/dist/generated/version.d.ts

@@ -1 +1 @@
-export declare const PACKAGE_VERSION = "2.14.62";
+export declare const PACKAGE_VERSION = "2.14.63";

package/dist/generated/version.js

@@ -1,5 +1,5 @@
 //#region src/generated/version.ts
-const PACKAGE_VERSION = "2.14.62";
+const PACKAGE_VERSION = "2.14.63";
 //#endregion
 export { PACKAGE_VERSION };
 

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../../src/generated/version.ts"],"sourcesContent":["// This file is auto-generated. Do not edit manually.\nexport const PACKAGE_VERSION = '2.14.62';\n"],"mappings":";AACA,MAAa,kBAAkB"}
+{"version":3,"file":"version.js","names":[],"sources":["../../src/generated/version.ts"],"sourcesContent":["// This file is auto-generated. Do not edit manually.\nexport const PACKAGE_VERSION = '2.14.63';\n"],"mappings":";AACA,MAAa,kBAAkB"}

package/dist/react/jsx/utils/jsxParsing/addGTIdentifierToSyntaxTree.js

@@ -1,7 +1,7 @@
 import { DATA_ATTR_PREFIX } from "../constants.js";
 import { defaultVariableNames, getVariableName, minifyVariableType } from "../../../utils/getVariableName.js";
-import { HTML_CONTENT_PROPS } from "@generaltranslation/format/types";
 import { isAcceptedPluralForm } from "generaltranslation/internal";
+import { HTML_CONTENT_PROPS } from "@generaltranslation/format/types";
 //#region src/react/jsx/utils/jsxParsing/addGTIdentifierToSyntaxTree.ts
 /**
 * Construct the data-_gt prop

package/dist/react/jsx/utils/jsxParsing/parseJsx.d.ts

@@ -21,6 +21,8 @@ type OutputCollector = {
     errors: string[];
     warnings: Set<string>;
     unwrappedExpressions: string[];
+    /** Deprecated $-prefixed <T> prop occurrences (file:line:column), warned once per scan */
+    sugarPropLocations?: string[];
 };
 /**
  * Entry point for JSX parsing

package/dist/react/jsx/utils/jsxParsing/parseJsx.js

@@ -19,10 +19,10 @@ import { randomUUID } from "node:crypto";
 import path from "node:path";
 import fs from "node:fs";
 import * as t from "@babel/types";
+import { isAcceptedPluralForm } from "generaltranslation/internal";
 import { parse } from "@babel/parser";
 import generateModule from "@babel/generator";
 import { HTML_CONTENT_PROPS } from "@generaltranslation/format/types";
-import { isAcceptedPluralForm } from "generaltranslation/internal";
 import traverseModule from "@babel/traverse";
 //#region src/react/jsx/utils/jsxParsing/parseJsx.ts
 const generate = generateModule.default || generateModule;
@@ -321,7 +321,8 @@ function parseJSXElement({ node, originalName, scopeNode, updates, config, state
 		openingElement,
 		metadata,
 		componentErrors,
-		file: config.file
+		file: config.file,
+		sugarPropLocations: output.sugarPropLocations
 	});
 	const derivableTracker = { isDerivable: false };
 	const treeResult = buildJSXTree({