gt 2.19.0 → 2.20.0

package/dist/config/generateSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateSettings.js","names":[],"sources":["../../src/config/generateSettings.ts"],"sourcesContent":["import {\n  displayProjectId,\n  exitSync,\n  logErrorAndExit,\n  warnApiKeyInConfig,\n  warnDeprecatedField,\n} from '../console/logging.js';\nimport { loadConfig } from '../fs/config/loadConfig.js';\nimport { FilesOptions, Settings } from '../types/index.js';\nimport {\n  defaultBaseUrl,\n  libraryDefaultLocale,\n} from 'generaltranslation/internal';\nimport { resolveFiles } from '../fs/config/parseFilesConfig.js';\nimport { validateSettings } from './validateSettings.js';\nimport {\n  DEFAULT_GIT_REMOTE_NAME,\n  GT_DASHBOARD_URL,\n} from '../utils/constants.js';\nimport { resolveProjectId } from '../fs/utils.js';\nimport crypto from 'node:crypto';\nimport { execSync } from 'node:child_process';\nimport path from 'node:path';\nimport chalk from 'chalk';\nimport { resolveConfig } from './resolveConfig.js';\nimport { gt } from '../utils/gt.js';\nimport { generatePreset } from './optionPresets.js';\nimport { GT_PARSING_FLAGS_DEFAULT } from './defaults.js';\nimport { normalizeFilesOptions } from '../formats/files/transformFormat.js';\nimport { determineLibrary } from '../fs/determineFramework/index.js';\nimport { logger } from '../console/logger.js';\n\nexport const DEFAULT_SRC_PATTERNS = [\n  'src/**/*.{js,jsx,ts,tsx}',\n  'app/**/*.{js,jsx,ts,tsx}',\n  'pages/**/*.{js,jsx,ts,tsx}',\n  'components/**/*.{js,jsx,ts,tsx}',\n];\n\nexport const DEFAULT_PYTHON_SRC_PATTERNS = ['**/*.py'];\nexport const DEFAULT_PYTHON_SRC_EXCLUDES = [\n  'venv/**',\n  '.venv/**',\n  '__pycache__/**',\n  '**/migrations/**',\n  '**/tests/**',\n  '**/test_*.py',\n  '**/*_test.py',\n];\n\ntype GenerateSettingsInput = Partial<Omit<Settings, 'tag'>> & {\n  config?: string;\n  projectId?: string;\n  locales?: string[];\n  options?: Settings['options'];\n  files?: unknown;\n  publish?: boolean;\n  omitConfigIds?: boolean;\n  tag?: string | boolean;\n  message?: string;\n  branch?: string;\n  enableBranching?: boolean;\n  disableBranchDetection?: boolean;\n  remoteName?: string;\n  experimentalLocalizeStaticImports?: boolean;\n  experimentalLocalizeStaticUrls?: boolean;\n  experimentalLocalizeRelativeAssets?: boolean;\n  experimentalHideDefaultLocale?: boolean;\n  experimentalFlattenJsonFiles?: boolean;\n  experimentalClearLocaleDirs?: boolean;\n  clearLocaleDirsExclude?: string[];\n  [key: string]: unknown;\n};\n\nfunction hasConfiguredTranslationFiles(files: unknown): boolean {\n  if (!files || typeof files !== 'object' || Array.isArray(files)) {\n    return false;\n  }\n  return Object.keys(files).some((key) => key !== 'gt');\n}\n\n/**\n * Generates settings from any\n * @param flags - The CLI flags to generate settings from\n * @param cwd - The current working directory\n * @param options - Additional options\n * @param options.requireConfig - If true, exit with an error when no config file is found\n * @returns The generated settings\n */\nexport async function generateSettings(\n  flags: GenerateSettingsInput,\n  cwd: string = process.cwd(),\n  options?: { requireConfig?: boolean }\n): Promise<Settings> {\n  // Load config file\n  let gtConfig: GenerateSettingsInput = {};\n\n  if (flags.config && !flags.config.endsWith('.json')) {\n    flags.config = `${flags.config}.json`;\n  }\n  if (flags.config) {\n    gtConfig = loadConfig(flags.config);\n  } else {\n    const config = resolveConfig(cwd);\n    if (config) {\n      gtConfig = config.config as GenerateSettingsInput;\n      flags.config = config.path;\n    } else {\n      if (options?.requireConfig) {\n        return logErrorAndExit(\n          'No gt.config.json file was found. Run `npx gt init` to create one, pass --config, or run this command from your project root.'\n        );\n      }\n      gtConfig = {};\n    }\n  }\n\n  // Warn if apiKey is present in gt.config.json\n  if (gtConfig.apiKey) {\n    warnApiKeyInConfig(flags.config ?? 'gt.config.json');\n    exitSync(1);\n  }\n  const projectIdEnv = resolveProjectId();\n  // Resolve mismatched projectIds\n  if (\n    gtConfig.projectId &&\n    flags.projectId &&\n    gtConfig.projectId !== flags.projectId\n  ) {\n    logErrorAndExit(\n      `Project ID mismatch: gt.config.json uses ${chalk.green(gtConfig.projectId)}, but the CLI flag uses ${chalk.green(flags.projectId)}. Use the same projectId in all configs.`\n    );\n  } else if (\n    gtConfig.projectId &&\n    projectIdEnv &&\n    gtConfig.projectId !== projectIdEnv\n  ) {\n    logErrorAndExit(\n      `Project ID mismatch: gt.config.json uses ${chalk.green(gtConfig.projectId)}, but GT_PROJECT_ID uses ${chalk.green(projectIdEnv)}. Use the same projectId in all configs.`\n    );\n  }\n\n  if (\n    flags.options?.docsUrlPattern &&\n    !flags.options?.docsUrlPattern.includes('[locale]')\n  ) {\n    logErrorAndExit(\n      'Static URLs could not be localized because the URL pattern is missing \"[locale]\". Add \"[locale]\" where the locale should appear in the generated URL.'\n    );\n  }\n\n  if (\n    flags.options?.docsImportPattern &&\n    !flags.options?.docsImportPattern.includes('[locale]')\n  ) {\n    logErrorAndExit(\n      'Static imports could not be localized because the import pattern is missing \"[locale]\". Add \"[locale]\" where the locale should appear in the generated import path.'\n    );\n  }\n\n  if (flags.options?.copyFiles) {\n    for (const file of flags.options.copyFiles) {\n      if (!file.includes('[locale]')) {\n        logErrorAndExit(\n          'Files could not be copied because the file path is missing \"[locale]\". Add \"[locale]\" where the locale should appear in the copied path.'\n        );\n      }\n    }\n  }\n\n  // Warn on deprecated includeSourceCodeContext\n  const configuredFiles = gtConfig.files as FilesOptions | undefined;\n  if (configuredFiles?.gt?.includeSourceCodeContext != null) {\n    warnDeprecatedField(\n      'files.gt.includeSourceCodeContext',\n      'files.gt.parsingFlags.includeSourceCodeContext'\n    );\n  }\n\n  // merge options\n  const mergedOptions: Settings = { ...gtConfig, ...flags } as Settings;\n\n  if (\n    determineLibrary().library === 'base' &&\n    !hasConfiguredTranslationFiles(mergedOptions.files)\n  ) {\n    logger.warn(\n      chalk.yellow(\n        'No package.json or Python project file found in the current directory. Run this command from the root of your project.'\n      )\n    );\n  }\n\n  // Add defaultLocale if not provided\n  mergedOptions.defaultLocale =\n    mergedOptions.defaultLocale || libraryDefaultLocale;\n\n  // merge locales\n  mergedOptions.locales = Array.from(\n    new Set([...(gtConfig.locales || []), ...(flags.locales || [])])\n  );\n  // Separate defaultLocale from locales\n  mergedOptions.locales = mergedOptions.locales.filter(\n    (locale) => locale !== mergedOptions.defaultLocale\n  );\n\n  // Add apiKey if not provided\n  mergedOptions.apiKey = mergedOptions.apiKey || process.env.GT_API_KEY;\n\n  // Add projectId if not provided\n  mergedOptions.projectId = mergedOptions.projectId || resolveProjectId();\n\n  // Add baseUrl if not provided\n  mergedOptions.baseUrl = mergedOptions.baseUrl || defaultBaseUrl;\n\n  // Add dashboardUrl if not provided\n  mergedOptions.dashboardUrl = mergedOptions.dashboardUrl || GT_DASHBOARD_URL;\n\n  // Add locales if not provided\n  mergedOptions.locales = mergedOptions.locales || [];\n\n  // Only set config path if one was actually found or explicitly provided.\n  // Do not default to a phantom path — that would cause downstream writes\n  // (e.g. updateConfig) to silently create a config file.\n  if (!mergedOptions.config) {\n    mergedOptions.config = '';\n  }\n\n  // Display projectId if present\n  if (mergedOptions.projectId) displayProjectId(mergedOptions.projectId);\n\n  // Add stageTranslations if not provided\n  // For human review, always stage the project\n  mergedOptions.stageTranslations = mergedOptions.stageTranslations ?? false;\n\n  // Top-level default for whether translated files require approval before use.\n  // Effective policy is hash-changing, so reject anything but a real boolean.\n  if (\n    mergedOptions.requiresReview !== undefined &&\n    typeof mergedOptions.requiresReview !== 'boolean'\n  ) {\n    logErrorAndExit(\n      'requiresReview in gt.config.json must be a boolean. Use files.<type>.requiresReview for glob-scoped overrides.'\n    );\n  }\n  mergedOptions.requiresReview = mergedOptions.requiresReview ?? false;\n\n  // Add publish — only set if explicitly configured or passed via flag.\n  // When neither is set, leave undefined so the publish step knows\n  // there is no global publish intent.\n  if (flags.publish) {\n    mergedOptions.publish = true;\n  } else if (gtConfig.publish !== undefined) {\n    mergedOptions.publish = gtConfig.publish;\n  } else {\n    mergedOptions.publish = undefined;\n  }\n\n  mergedOptions.omitConfigIds =\n    flags.omitConfigIds === true || gtConfig.omitConfigIds === true;\n\n  // Don't default src here — each pipeline (JS/Python) has its own defaults.\n  // Only set src if the user explicitly provided it via flags or config.\n\n  // Resolve all glob patterns in the files object\n  const compositePatterns = Object.entries(\n    mergedOptions.options?.jsonSchema || {}\n  )\n    .filter(([, schema]) => schema.composite)\n    .map(([key]) => key);\n  mergedOptions.files = mergedOptions.files\n    ? resolveFiles(\n        normalizeFilesOptions(mergedOptions.files as FilesOptions),\n        mergedOptions.defaultLocale,\n        mergedOptions.locales,\n        cwd,\n        compositePatterns,\n        mergedOptions.requiresReview\n      )\n    : {\n        resolvedPaths: {},\n        placeholderPaths: {},\n        transformPaths: {},\n        transformFormats: {},\n        publishPaths: new Set<string>(),\n        unpublishPaths: new Set<string>(),\n        requiresReviewPaths: new Set<string>(),\n        parsingFlags: {},\n        gtJson: {\n          parsingFlags: GT_PARSING_FLAGS_DEFAULT,\n        },\n      };\n\n  mergedOptions.options = {\n    ...mergedOptions.options,\n    mintlify: {\n      ...mergedOptions.options?.mintlify,\n      inferTitleFromFilename:\n        gtConfig.options?.mintlify?.inferTitleFromFilename ||\n        mergedOptions.options?.mintlify?.inferTitleFromFilename,\n    },\n    experimentalLocalizeStaticImports:\n      gtConfig.options?.experimentalLocalizeStaticImports ||\n      flags.experimentalLocalizeStaticImports,\n    experimentalLocalizeStaticUrls:\n      gtConfig.options?.experimentalLocalizeStaticUrls ||\n      flags.experimentalLocalizeStaticUrls,\n    experimentalLocalizeRelativeAssets:\n      gtConfig.options?.experimentalLocalizeRelativeAssets ||\n      flags.experimentalLocalizeRelativeAssets,\n    experimentalHideDefaultLocale:\n      gtConfig.options?.experimentalHideDefaultLocale ||\n      flags.experimentalHideDefaultLocale,\n    experimentalFlattenJsonFiles:\n      gtConfig.options?.experimentalFlattenJsonFiles ||\n      flags.experimentalFlattenJsonFiles,\n    experimentalClearLocaleDirs:\n      gtConfig.options?.experimentalClearLocaleDirs ||\n      flags.experimentalClearLocaleDirs,\n    clearLocaleDirsExclude:\n      gtConfig.options?.clearLocaleDirsExclude || flags.clearLocaleDirsExclude,\n  };\n\n  if (\n    mergedOptions.omitConfigIds &&\n    (mergedOptions.publish === true ||\n      mergedOptions.files.gtJson.publish === true)\n  ) {\n    logger.warn(\n      chalk.yellow(\n        'Config IDs will be omitted even though CDN publishing is enabled. Remote cache/CDN consumers may load the latest available translations instead of a pinned version.'\n      )\n    );\n  }\n\n  // Add additional options if provided\n  if (mergedOptions.options) {\n    if (mergedOptions.options.jsonSchema) {\n      for (const fileGlob of Object.keys(mergedOptions.options.jsonSchema)) {\n        const jsonSchema = mergedOptions.options.jsonSchema[fileGlob];\n        if (jsonSchema.preset) {\n          mergedOptions.options.jsonSchema[fileGlob] = {\n            ...generatePreset(jsonSchema.preset, 'json'),\n            ...jsonSchema,\n          };\n        }\n      }\n    }\n    if (mergedOptions.options.yamlSchema) {\n      for (const fileGlob of Object.keys(mergedOptions.options.yamlSchema)) {\n        const yamlSchema = mergedOptions.options.yamlSchema[fileGlob];\n        if (yamlSchema.preset) {\n          mergedOptions.options.yamlSchema[fileGlob] = {\n            ...generatePreset(yamlSchema.preset, 'yaml'),\n            ...yamlSchema,\n          };\n        }\n      }\n    }\n  }\n\n  // Add parsing options if not provided\n  mergedOptions.parsingOptions = mergedOptions.parsingOptions || {};\n  mergedOptions.parsingOptions.conditionNames = mergedOptions.parsingOptions\n    .conditionNames || [\n    'development',\n    'browser',\n    'module',\n    'import',\n    'require',\n    'default',\n  ];\n\n  // Add branch options if not provided\n  const branchOptions = mergedOptions.branchOptions || {};\n  // If --branch is set, enable branching\n  branchOptions.enabled =\n    flags.enableBranching ??\n    gtConfig.branchOptions?.enabled ??\n    (flags.branch ? true : false);\n  branchOptions.currentBranch =\n    flags.branch ?? gtConfig.branchOptions?.currentBranch ?? undefined;\n  branchOptions.autoDetectBranches = flags.disableBranchDetection\n    ? false\n    : (gtConfig.branchOptions?.autoDetectBranches ?? true);\n  branchOptions.remoteName =\n    flags.remoteName ??\n    gtConfig.branchOptions?.remoteName ??\n    DEFAULT_GIT_REMOTE_NAME;\n  mergedOptions.branchOptions = branchOptions;\n\n  // Map -m/--message flag to tagMessage\n  if (flags.message) {\n    mergedOptions.tagMessage = flags.message;\n  }\n\n  // Resolve tag:\n  // --tag (bare) or -m without --tag: try git SHA, fall back to random hex\n  // --tag <value>: use as-is\n  // No flags: no tag\n  if (flags.tag === true || (!flags.tag && mergedOptions.tagMessage)) {\n    try {\n      mergedOptions.tag = execSync('git rev-parse --short HEAD', {\n        encoding: 'utf-8',\n      }).trim();\n      // If no message provided, use git commit message\n      if (!mergedOptions.tagMessage) {\n        mergedOptions.tagMessage = execSync('git log -1 --format=%s', {\n          encoding: 'utf-8',\n        }).trim();\n      }\n    } catch {\n      // Not in a git repo or git unavailable — fall back to random hex\n      mergedOptions.tag = crypto.randomBytes(4).toString('hex');\n    }\n  }\n\n  mergedOptions.configDirectory = path.join(cwd, '.gt');\n\n  validateSettings(mergedOptions);\n\n  // Set up GT instance\n  gt.setConfig({\n    projectId: mergedOptions.projectId,\n    apiKey: mergedOptions.apiKey,\n    baseUrl: mergedOptions.baseUrl,\n    sourceLocale: mergedOptions.defaultLocale,\n    customMapping: mergedOptions.customMapping,\n  });\n\n  return mergedOptions;\n}\n"],"mappings":"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"}
+{"version":3,"file":"generateSettings.js","names":[],"sources":["../../src/config/generateSettings.ts"],"sourcesContent":["import {\n  displayProjectId,\n  exitSync,\n  logErrorAndExit,\n  warnApiKeyInConfig,\n  warnDeprecatedField,\n} from '../console/logging.js';\nimport { loadConfig } from '../fs/config/loadConfig.js';\nimport { FilesOptions, Settings } from '../types/index.js';\nimport {\n  defaultBaseUrl,\n  libraryDefaultLocale,\n} from 'generaltranslation/internal';\nimport { resolveFiles } from '../fs/config/parseFilesConfig.js';\nimport { validateSettings } from './validateSettings.js';\nimport {\n  DEFAULT_GIT_REMOTE_NAME,\n  GT_DASHBOARD_URL,\n} from '../utils/constants.js';\nimport { resolveProjectId } from '../fs/utils.js';\nimport crypto from 'node:crypto';\nimport { execSync } from 'node:child_process';\nimport path from 'node:path';\nimport chalk from 'chalk';\nimport { resolveConfig } from './resolveConfig.js';\nimport { configureApiClient } from '../utils/api.js';\nimport { gt } from '../utils/gt.js';\nimport { generatePreset } from './optionPresets.js';\nimport { GT_PARSING_FLAGS_DEFAULT } from './defaults.js';\nimport { normalizeFilesOptions } from '../formats/files/transformFormat.js';\nimport { determineLibrary } from '../fs/determineFramework/index.js';\nimport { logger } from '../console/logger.js';\n\nexport const DEFAULT_SRC_PATTERNS = [\n  'src/**/*.{js,jsx,ts,tsx}',\n  'app/**/*.{js,jsx,ts,tsx}',\n  'pages/**/*.{js,jsx,ts,tsx}',\n  'components/**/*.{js,jsx,ts,tsx}',\n];\n\nexport const DEFAULT_PYTHON_SRC_PATTERNS = ['**/*.py'];\nexport const DEFAULT_PYTHON_SRC_EXCLUDES = [\n  'venv/**',\n  '.venv/**',\n  '__pycache__/**',\n  '**/migrations/**',\n  '**/tests/**',\n  '**/test_*.py',\n  '**/*_test.py',\n];\n\ntype GenerateSettingsInput = Partial<Omit<Settings, 'tag'>> & {\n  config?: string;\n  projectId?: string;\n  locales?: string[];\n  options?: Settings['options'];\n  files?: unknown;\n  publish?: boolean;\n  omitConfigIds?: boolean;\n  tag?: string | boolean;\n  message?: string;\n  branch?: string;\n  enableBranching?: boolean;\n  disableBranchDetection?: boolean;\n  remoteName?: string;\n  experimentalLocalizeStaticImports?: boolean;\n  experimentalLocalizeStaticUrls?: boolean;\n  experimentalLocalizeRelativeAssets?: boolean;\n  experimentalHideDefaultLocale?: boolean;\n  experimentalFlattenJsonFiles?: boolean;\n  experimentalClearLocaleDirs?: boolean;\n  clearLocaleDirsExclude?: string[];\n  [key: string]: unknown;\n};\n\nfunction hasConfiguredTranslationFiles(files: unknown): boolean {\n  if (!files || typeof files !== 'object' || Array.isArray(files)) {\n    return false;\n  }\n  return Object.keys(files).some((key) => key !== 'gt');\n}\n\n/**\n * Generates settings from any\n * @param flags - The CLI flags to generate settings from\n * @param cwd - The current working directory\n * @param options - Additional options\n * @param options.requireConfig - If true, exit with an error when no config file is found\n * @returns The generated settings\n */\nexport async function generateSettings(\n  flags: GenerateSettingsInput,\n  cwd: string = process.cwd(),\n  options?: { requireConfig?: boolean }\n): Promise<Settings> {\n  // Load config file\n  let gtConfig: GenerateSettingsInput = {};\n\n  if (flags.config && !flags.config.endsWith('.json')) {\n    flags.config = `${flags.config}.json`;\n  }\n  if (flags.config) {\n    gtConfig = loadConfig(flags.config);\n  } else {\n    const config = resolveConfig(cwd);\n    if (config) {\n      gtConfig = config.config as GenerateSettingsInput;\n      flags.config = config.path;\n    } else {\n      if (options?.requireConfig) {\n        return logErrorAndExit(\n          'No gt.config.json file was found. Run `npx gt init` to create one, pass --config, or run this command from your project root.'\n        );\n      }\n      gtConfig = {};\n    }\n  }\n\n  // Warn if apiKey is present in gt.config.json\n  if (gtConfig.apiKey) {\n    warnApiKeyInConfig(flags.config ?? 'gt.config.json');\n    exitSync(1);\n  }\n  const projectIdEnv = resolveProjectId();\n  // Resolve mismatched projectIds\n  if (\n    gtConfig.projectId &&\n    flags.projectId &&\n    gtConfig.projectId !== flags.projectId\n  ) {\n    logErrorAndExit(\n      `Project ID mismatch: gt.config.json uses ${chalk.green(gtConfig.projectId)}, but the CLI flag uses ${chalk.green(flags.projectId)}. Use the same projectId in all configs.`\n    );\n  } else if (\n    gtConfig.projectId &&\n    projectIdEnv &&\n    gtConfig.projectId !== projectIdEnv\n  ) {\n    logErrorAndExit(\n      `Project ID mismatch: gt.config.json uses ${chalk.green(gtConfig.projectId)}, but GT_PROJECT_ID uses ${chalk.green(projectIdEnv)}. Use the same projectId in all configs.`\n    );\n  }\n\n  if (\n    flags.options?.docsUrlPattern &&\n    !flags.options?.docsUrlPattern.includes('[locale]')\n  ) {\n    logErrorAndExit(\n      'Static URLs could not be localized because the URL pattern is missing \"[locale]\". Add \"[locale]\" where the locale should appear in the generated URL.'\n    );\n  }\n\n  if (\n    flags.options?.docsImportPattern &&\n    !flags.options?.docsImportPattern.includes('[locale]')\n  ) {\n    logErrorAndExit(\n      'Static imports could not be localized because the import pattern is missing \"[locale]\". Add \"[locale]\" where the locale should appear in the generated import path.'\n    );\n  }\n\n  if (flags.options?.copyFiles) {\n    for (const file of flags.options.copyFiles) {\n      if (!file.includes('[locale]')) {\n        logErrorAndExit(\n          'Files could not be copied because the file path is missing \"[locale]\". Add \"[locale]\" where the locale should appear in the copied path.'\n        );\n      }\n    }\n  }\n\n  // Warn on deprecated includeSourceCodeContext\n  const configuredFiles = gtConfig.files as FilesOptions | undefined;\n  if (configuredFiles?.gt?.includeSourceCodeContext != null) {\n    warnDeprecatedField(\n      'files.gt.includeSourceCodeContext',\n      'files.gt.parsingFlags.includeSourceCodeContext'\n    );\n  }\n\n  // merge options\n  const mergedOptions: Settings = { ...gtConfig, ...flags } as Settings;\n\n  if (\n    determineLibrary().library === 'base' &&\n    !hasConfiguredTranslationFiles(mergedOptions.files)\n  ) {\n    logger.warn(\n      chalk.yellow(\n        'No package.json or Python project file found in the current directory. Run this command from the root of your project.'\n      )\n    );\n  }\n\n  // Add defaultLocale if not provided\n  mergedOptions.defaultLocale =\n    mergedOptions.defaultLocale || libraryDefaultLocale;\n\n  // merge locales\n  mergedOptions.locales = Array.from(\n    new Set([...(gtConfig.locales || []), ...(flags.locales || [])])\n  );\n  // Separate defaultLocale from locales\n  mergedOptions.locales = mergedOptions.locales.filter(\n    (locale) => locale !== mergedOptions.defaultLocale\n  );\n\n  // Add apiKey if not provided\n  mergedOptions.apiKey = mergedOptions.apiKey || process.env.GT_API_KEY;\n\n  // Add projectId if not provided\n  mergedOptions.projectId = mergedOptions.projectId || resolveProjectId();\n\n  // Add baseUrl if not provided\n  mergedOptions.baseUrl = mergedOptions.baseUrl || defaultBaseUrl;\n\n  // Add dashboardUrl if not provided\n  mergedOptions.dashboardUrl = mergedOptions.dashboardUrl || GT_DASHBOARD_URL;\n\n  // Add locales if not provided\n  mergedOptions.locales = mergedOptions.locales || [];\n\n  // Only set config path if one was actually found or explicitly provided.\n  // Do not default to a phantom path — that would cause downstream writes\n  // (e.g. updateConfig) to silently create a config file.\n  if (!mergedOptions.config) {\n    mergedOptions.config = '';\n  }\n\n  // Display projectId if present\n  if (mergedOptions.projectId) {\n    displayProjectId(mergedOptions.projectId);\n  }\n\n  // Add stageTranslations if not provided\n  // For human review, always stage the project\n  mergedOptions.stageTranslations = mergedOptions.stageTranslations ?? false;\n\n  // Top-level default for whether translated files require approval before use.\n  // Effective policy is hash-changing, so reject anything but a real boolean.\n  if (\n    mergedOptions.requiresReview !== undefined &&\n    typeof mergedOptions.requiresReview !== 'boolean'\n  ) {\n    logErrorAndExit(\n      'requiresReview in gt.config.json must be a boolean. Use files.<type>.requiresReview for glob-scoped overrides.'\n    );\n  }\n  mergedOptions.requiresReview = mergedOptions.requiresReview ?? false;\n\n  // Add publish — only set if explicitly configured or passed via flag.\n  // When neither is set, leave undefined so the publish step knows\n  // there is no global publish intent.\n  if (flags.publish) {\n    mergedOptions.publish = true;\n  } else if (gtConfig.publish !== undefined) {\n    mergedOptions.publish = gtConfig.publish;\n  } else {\n    mergedOptions.publish = undefined;\n  }\n\n  mergedOptions.omitConfigIds =\n    flags.omitConfigIds === true || gtConfig.omitConfigIds === true;\n\n  // Don't default src here — each pipeline (JS/Python) has its own defaults.\n  // Only set src if the user explicitly provided it via flags or config.\n\n  // Resolve all glob patterns in the files object\n  const compositePatterns = Object.entries(\n    mergedOptions.options?.jsonSchema || {}\n  )\n    .filter(([, schema]) => schema.composite)\n    .map(([key]) => key);\n  mergedOptions.files = mergedOptions.files\n    ? resolveFiles(\n        normalizeFilesOptions(mergedOptions.files as FilesOptions),\n        mergedOptions.defaultLocale,\n        mergedOptions.locales,\n        cwd,\n        compositePatterns,\n        mergedOptions.requiresReview\n      )\n    : {\n        resolvedPaths: {},\n        placeholderPaths: {},\n        transformPaths: {},\n        transformFormats: {},\n        publishPaths: new Set<string>(),\n        unpublishPaths: new Set<string>(),\n        requiresReviewPaths: new Set<string>(),\n        parsingFlags: {},\n        gtJson: {\n          parsingFlags: GT_PARSING_FLAGS_DEFAULT,\n        },\n      };\n\n  mergedOptions.options = {\n    ...mergedOptions.options,\n    mintlify: {\n      ...mergedOptions.options?.mintlify,\n      inferTitleFromFilename:\n        gtConfig.options?.mintlify?.inferTitleFromFilename ||\n        mergedOptions.options?.mintlify?.inferTitleFromFilename,\n    },\n    experimentalLocalizeStaticImports:\n      gtConfig.options?.experimentalLocalizeStaticImports ||\n      flags.experimentalLocalizeStaticImports,\n    experimentalLocalizeStaticUrls:\n      gtConfig.options?.experimentalLocalizeStaticUrls ||\n      flags.experimentalLocalizeStaticUrls,\n    experimentalLocalizeRelativeAssets:\n      gtConfig.options?.experimentalLocalizeRelativeAssets ||\n      flags.experimentalLocalizeRelativeAssets,\n    experimentalHideDefaultLocale:\n      gtConfig.options?.experimentalHideDefaultLocale ||\n      flags.experimentalHideDefaultLocale,\n    experimentalFlattenJsonFiles:\n      gtConfig.options?.experimentalFlattenJsonFiles ||\n      flags.experimentalFlattenJsonFiles,\n    experimentalClearLocaleDirs:\n      gtConfig.options?.experimentalClearLocaleDirs ||\n      flags.experimentalClearLocaleDirs,\n    clearLocaleDirsExclude:\n      gtConfig.options?.clearLocaleDirsExclude || flags.clearLocaleDirsExclude,\n  };\n\n  if (\n    mergedOptions.omitConfigIds &&\n    (mergedOptions.publish === true ||\n      mergedOptions.files.gtJson.publish === true)\n  ) {\n    logger.warn(\n      chalk.yellow(\n        'Config IDs will be omitted even though CDN publishing is enabled. Remote cache/CDN consumers may load the latest available translations instead of a pinned version.'\n      )\n    );\n  }\n\n  // Add additional options if provided\n  if (mergedOptions.options) {\n    if (mergedOptions.options.jsonSchema) {\n      for (const fileGlob of Object.keys(mergedOptions.options.jsonSchema)) {\n        const jsonSchema = mergedOptions.options.jsonSchema[fileGlob];\n        if (jsonSchema.preset) {\n          mergedOptions.options.jsonSchema[fileGlob] = {\n            ...generatePreset(jsonSchema.preset, 'json'),\n            ...jsonSchema,\n          };\n        }\n      }\n    }\n    if (mergedOptions.options.yamlSchema) {\n      for (const fileGlob of Object.keys(mergedOptions.options.yamlSchema)) {\n        const yamlSchema = mergedOptions.options.yamlSchema[fileGlob];\n        if (yamlSchema.preset) {\n          mergedOptions.options.yamlSchema[fileGlob] = {\n            ...generatePreset(yamlSchema.preset, 'yaml'),\n            ...yamlSchema,\n          };\n        }\n      }\n    }\n  }\n\n  // Add parsing options if not provided\n  mergedOptions.parsingOptions = mergedOptions.parsingOptions || {};\n  mergedOptions.parsingOptions.conditionNames = mergedOptions.parsingOptions\n    .conditionNames || [\n    'development',\n    'browser',\n    'module',\n    'import',\n    'require',\n    'default',\n  ];\n\n  // Add branch options if not provided\n  const branchOptions = mergedOptions.branchOptions || {};\n  // If --branch is set, enable branching\n  branchOptions.enabled =\n    flags.enableBranching ??\n    gtConfig.branchOptions?.enabled ??\n    (flags.branch ? true : false);\n  branchOptions.currentBranch =\n    flags.branch ?? gtConfig.branchOptions?.currentBranch ?? undefined;\n  branchOptions.autoDetectBranches = flags.disableBranchDetection\n    ? false\n    : (gtConfig.branchOptions?.autoDetectBranches ?? true);\n  branchOptions.remoteName =\n    flags.remoteName ??\n    gtConfig.branchOptions?.remoteName ??\n    DEFAULT_GIT_REMOTE_NAME;\n  mergedOptions.branchOptions = branchOptions;\n\n  // Map -m/--message flag to tagMessage\n  if (flags.message) {\n    mergedOptions.tagMessage = flags.message;\n  }\n\n  // Resolve tag:\n  // --tag (bare) or -m without --tag: try git SHA, fall back to random hex\n  // --tag <value>: use as-is\n  // No flags: no tag\n  if (flags.tag === true || (!flags.tag && mergedOptions.tagMessage)) {\n    try {\n      mergedOptions.tag = execSync('git rev-parse --short HEAD', {\n        encoding: 'utf-8',\n      }).trim();\n      // If no message provided, use git commit message\n      if (!mergedOptions.tagMessage) {\n        mergedOptions.tagMessage = execSync('git log -1 --format=%s', {\n          encoding: 'utf-8',\n        }).trim();\n      }\n    } catch {\n      // Not in a git repo or git unavailable — fall back to random hex\n      mergedOptions.tag = crypto.randomBytes(4).toString('hex');\n    }\n  }\n\n  mergedOptions.configDirectory = path.join(cwd, '.gt');\n\n  validateSettings(mergedOptions);\n\n  // Keep both clients on the same resolved credentials while consumers migrate.\n  configureApiClient({\n    projectId: mergedOptions.projectId,\n    apiKey: mergedOptions.apiKey,\n    baseUrl: mergedOptions.baseUrl,\n    customMapping: mergedOptions.customMapping,\n  });\n  gt.setConfig({\n    projectId: mergedOptions.projectId,\n    apiKey: mergedOptions.apiKey,\n    baseUrl: mergedOptions.baseUrl,\n    sourceLocale: mergedOptions.defaultLocale,\n    customMapping: mergedOptions.customMapping,\n  });\n\n  return mergedOptions;\n}\n"],"mappings":"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"}

package/dist/console/index.d.ts

@@ -45,4 +45,5 @@ export declare const invalidConfigurationError = "The files configuration cannot
 export declare const lottieTranslateError = "Lottie translations are processed asynchronously, so the translate command cannot complete them in one run. Use the stage and download flow instead:\n  1. Stage the files for translation: npx gt stage\n  2. Fetch the finished translations: npx gt download\nTranslations that are still processing are skipped, so re-run npx gt download until all of them have been downloaded.";
 export declare 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.";
 export declare const lottieExpressionsError: (files: string[]) => string;
+export declare const fileEncodingSkipReason: (error: unknown) => string;
 export declare const withOriginalError: (message: string, error: unknown) => string;

package/dist/console/index.js

@@ -58,8 +58,9 @@ const invalidConfigurationError = `The files configuration cannot be used for th
 const lottieTranslateError = `Lottie translations are processed asynchronously, so the translate command cannot complete them in one run. Use the stage and download flow instead:\n  1. Stage the files for translation: npx gt stage\n  2. Fetch the finished translations: npx gt download\nTranslations that are still processing are skipped, so re-run npx gt download until all of them have been downloaded.`;
 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 lottieExpressionsError = (files) => `The following Lottie file(s) use After Effects expressions, which contain executable code and are not supported yet:\n${files.map((file) => `  - ${file}`).join("\n")}\nRe-export the animation with expressions baked into keyframes (or removed), then try again.`;
+const fileEncodingSkipReason = (error) => `File could not be decoded: ${error instanceof Error ? error.message : String(error)}`;
 const withOriginalError = (message, error) => error != null ? `${message} Original error: ${String(error)}` : message;
 //#endregion
-export { branchResolutionError, devApiKeyError, invalidConfigurationError, lottieExpressionsError, lottieTranslateError, noApiKeyError, noDefaultLocaleError, noFilesError, noLocalesError, noProjectIdError, noSourceFileError, noVersionIdError, 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 };
+export { branchResolutionError, devApiKeyError, fileEncodingSkipReason, invalidConfigurationError, lottieExpressionsError, lottieTranslateError, noApiKeyError, noDefaultLocaleError, noFilesError, noLocalesError, noProjectIdError, noSourceFileError, noVersionIdError, 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 { 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 noVersionIdError = `No version ID was found. Pass --version-id or add _versionId to gt.config.json.`;\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 lottieTranslateError = `Lottie translations are processed asynchronously, so the translate command cannot complete them in one run. Use the stage and download flow instead:\\n  1. Stage the files for translation: npx gt stage\\n  2. Fetch the finished translations: npx gt download\\nTranslations that are still processing are skipped, so re-run npx gt download until all of them have been downloaded.`;\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 lottieExpressionsError = (files: string[]): string =>\n  `The following Lottie file(s) use After Effects expressions, which contain executable code and are not supported yet:\\n${files\n    .map((file) => `  - ${file}`)\n    .join(\n      '\\n'\n    )}\\nRe-export the animation with expressions baked into keyframes (or removed), then try again.`;\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,mBAAmB;AAChC,MAAa,4BAA4B;AACzC,MAAa,uBAAuB;AACpC,MAAa,wBAAwB;AAErC,MAAa,0BAA0B,UACrC,yHAAyH,MACtH,KAAK,SAAS,OAAO,OAAO,CAC5B,KACC,KACD,CAAC;AAEN,MAAa,qBAAqB,SAAiB,UACjD,SAAS,OAAO,GAAG,QAAQ,mBAAmB,OAAO,MAAM,KAAK"}
+{"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 noVersionIdError = `No version ID was found. Pass --version-id or add _versionId to gt.config.json.`;\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 lottieTranslateError = `Lottie translations are processed asynchronously, so the translate command cannot complete them in one run. Use the stage and download flow instead:\\n  1. Stage the files for translation: npx gt stage\\n  2. Fetch the finished translations: npx gt download\\nTranslations that are still processing are skipped, so re-run npx gt download until all of them have been downloaded.`;\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 lottieExpressionsError = (files: string[]): string =>\n  `The following Lottie file(s) use After Effects expressions, which contain executable code and are not supported yet:\\n${files\n    .map((file) => `  - ${file}`)\n    .join(\n      '\\n'\n    )}\\nRe-export the animation with expressions baked into keyframes (or removed), then try again.`;\n\nexport const fileEncodingSkipReason = (error: unknown): string =>\n  `File could not be decoded: ${error instanceof Error ? error.message : String(error)}`;\n\nexport const withOriginalError = (message: string, error: unknown): string =>\n  error != null ? `${message} Original error: ${String(error)}` : message;\n"],"mappings":"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"}

package/dist/formats/files/aggregateFiles.js

@@ -2,10 +2,11 @@ import { logger } from "../../console/logger.js";
 import { hashStringSync, hashVersionId } from "../../utils/hash.js";
 import { logErrorAndExit } from "../../console/logging.js";
 import { getRelative, readBinaryFileBase64, readFile } from "../../fs/findFilepath.js";
-import { lottieExpressionsError } from "../../console/index.js";
+import { fileEncodingSkipReason, lottieExpressionsError } from "../../console/index.js";
 import { SUPPORTED_FILE_EXTENSIONS } from "./supportedFiles.js";
 import { getTransformFormatProperty } from "./transformFormat.js";
 import { determineLibrary } from "../../fs/determineFramework/index.js";
+import { readFileContent } from "../../fs/fileContent.js";
 import { flattenJson } from "../json/flattenJson.js";
 import { recordWarning } from "../../state/translateWarnings.js";
 import { buildPublishMap } from "../../utils/resolvePublish.js";
@@ -17,7 +18,6 @@ import { validateYamlSchema } from "../yaml/utils.js";
 import parseYaml from "../yaml/parseYaml.js";
 import { preprocessContent } from "./preprocessContent.js";
 import { parseKeyedMetadata } from "../parseKeyedMetadata.js";
-import { isBinaryFileFormat } from "generaltranslation/types";
 import YAML from "yaml";
 //#region src/formats/files/aggregateFiles.ts
 /**
@@ -214,10 +214,17 @@ async function aggregateFiles(settings) {
 		["androidStrings", "ANDROID_STRINGS"]
 	]) {
 		if (!filePaths[fileType]) continue;
-		const readsRawBytes = isBinaryFileFormat(fileFormat);
 		const verbatimFiles = filePaths[fileType].map((filePath) => {
-			const content = readsRawBytes ? readBinaryFileBase64(filePath) : readFile(filePath);
 			const relativePath = getRelative(filePath);
+			let content;
+			try {
+				content = readFileContent(filePath, fileFormat);
+			} catch (error) {
+				const reason = fileEncodingSkipReason(error);
+				logger.warn(`Skipping ${relativePath}: ${reason}`);
+				recordWarning("skipped_file", relativePath, reason);
+				return null;
+			}
 			return {
 				content,
 				fileName: relativePath,
@@ -228,14 +235,15 @@ async function aggregateFiles(settings) {
 				locale: settings.defaultLocale
 			};
 		}).filter((file) => {
-			if (!(readsRawBytes ? Buffer.from(file.content, "base64").toString("utf8") : file.content).trim()) {
+			if (!file) return false;
+			if (!file.content.trim()) {
 				logger.warn(`Skipping ${file.fileName}: File is empty`);
 				recordWarning("skipped_file", file.fileName, "File is empty");
 				return false;
 			}
 			return true;
 		});
-		files.push(...verbatimFiles);
+		files.push(...verbatimFiles.filter((file) => file !== null));
 	}
 	for (const fileType of SUPPORTED_FILE_EXTENSIONS) {
 		if (fileType === "json" || fileType === "yaml" || fileType === "twilioContentJson" || fileType === "lottie" || fileType === "dotStrings" || fileType === "dotStringsdict" || fileType === "androidStrings") continue;

package/dist/formats/files/aggregateFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregateFiles.js","names":[],"sources":["../../../src/formats/files/aggregateFiles.ts"],"sourcesContent":["import { logger } from '../../console/logger.js';\nimport { logErrorAndExit } from '../../console/logging.js';\nimport { lottieExpressionsError } from '../../console/index.js';\nimport { recordWarning } from '../../state/translateWarnings.js';\nimport { lottieHasExpressions } from './detectLottieExpressions.js';\nimport {\n  getRelative,\n  readFile,\n  readBinaryFileBase64,\n} from '../../fs/findFilepath.js';\nimport { isBinaryFileFormat } from 'generaltranslation/types';\nimport { Settings } from '../../types/index.js';\nimport type { FileFormat, DataFormat, FileToUpload } from '../../types/data.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from './supportedFiles.js';\nimport { parseJson } from '../json/parseJson.js';\nimport {\n  resolveMintlifyRefs,\n  shouldResolveRefs,\n} from '../../utils/resolveMintlifyRefs.js';\nimport { storeRefMap } from '../../state/mintlifyRefMap.js';\nimport parseYaml from '../yaml/parseYaml.js';\nimport { validateYamlSchema } from '../yaml/utils.js';\nimport { flattenJson } from '../json/flattenJson.js';\nimport type { JSONObject } from '../../types/data/json.js';\nimport YAML from 'yaml';\nimport { determineLibrary } from '../../fs/determineFramework/index.js';\nimport { hashStringSync, hashVersionId } from '../../utils/hash.js';\nimport { preprocessContent } from './preprocessContent.js';\nimport {\n  parseKeyedMetadata,\n  type KeyedMetadata,\n} from '../parseKeyedMetadata.js';\nimport { buildPublishMap } from '../../utils/resolvePublish.js';\nimport { getTransformFormatProperty } from './transformFormat.js';\n\n/**\n * Checks if a file path is a metadata companion file (e.g. foo.metadata.json)\n * AND its corresponding source file (e.g. foo.json) exists in the file list.\n * If both conditions are true, the metadata file should be skipped as a translation source.\n */\nfunction isCompanionMetadataFile(\n  filePath: string,\n  allFilePaths: string[]\n): boolean {\n  const metadataPattern = /\\.metadata\\.(json|yaml|yml)$/;\n  if (!metadataPattern.test(filePath)) return false;\n\n  // Derive the source file path: foo.metadata.json -> foo.json\n  const sourceFilePath = filePath.replace(\n    /\\.metadata\\.(json|yaml|yml)$/,\n    '.$1'\n  );\n  return allFilePaths.includes(sourceFilePath);\n}\n\nexport async function aggregateFiles(\n  settings: Settings\n): Promise<{ files: FileToUpload[]; publishMap: Map<string, boolean> }> {\n  // Aggregate all files to translate\n  const files: FileToUpload[] = [];\n  if (\n    !settings.files ||\n    (Object.keys(settings.files.placeholderPaths).length === 1 &&\n      settings.files.placeholderPaths.gt)\n  ) {\n    return { files, publishMap: new Map<string, boolean>() };\n  }\n\n  const { resolvedPaths: filePaths } = settings.files;\n  // Tolerate partially-constructed settings from programmatic callers\n  const requiresReviewPaths =\n    settings.files.requiresReviewPaths ?? new Set<string>();\n  const skipValidation = settings.options?.skipFileValidation;\n\n  // Build publish map upfront from resolved paths.\n  const publishMap = buildPublishMap(filePaths, settings);\n\n  // Process JSON files\n  if (filePaths.json) {\n    const { library, additionalModules } = determineLibrary();\n\n    // Determine dataFormat for JSONs\n    let dataFormat: DataFormat;\n    if (library === 'next-intl') {\n      dataFormat = 'ICU';\n    } else if (library === 'i18next') {\n      if (additionalModules.includes('i18next-icu')) {\n        dataFormat = 'ICU';\n      } else {\n        dataFormat = 'I18NEXT';\n      }\n    } else {\n      dataFormat = 'STRING';\n    }\n\n    const jsonFiles = filePaths.json\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.json!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        // Resolve $ref before parsing if configured\n        let contentForParsing = content;\n        if (shouldResolveRefs(filePath, settings.options)) {\n          try {\n            const json = JSON.parse(content);\n            const { resolved, refMap } = resolveMintlifyRefs(json, filePath);\n            storeRefMap(refMap);\n            contentForParsing = JSON.stringify(resolved, null, 2);\n          } catch {\n            // JSON parse errors are handled below by parseJson\n          }\n        }\n\n        const parsedJson = parseJson(\n          contentForParsing,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        let parsedContent: JSONObject | undefined;\n        try {\n          parsedContent = JSON.parse(content) as JSONObject;\n        } catch {\n          // Content not parsable — skip metadata detection\n        }\n        if (parsedContent) {\n          const rawMetadata = parseKeyedMetadata(filePath, parsedContent);\n          if (rawMetadata) {\n            // Run metadata through the same include/composite schema as the source\n            // so key paths align at translation time\n            const transformed = parseJson(\n              JSON.stringify(rawMetadata),\n              filePath,\n              settings.options || {},\n              settings.defaultLocale,\n              false\n            );\n            const transformedMetadata = JSON.parse(transformed);\n\n            // Filter metadata to only keep keys that exist in the transformed source\n            // This prevents misaligned entries from wide JSONPath patterns\n            const sourceKeys = new Set(Object.keys(JSON.parse(parsedJson)));\n            const filtered = Object.fromEntries(\n              Object.entries(transformedMetadata).filter(([k]) =>\n                sourceKeys.has(k)\n              )\n            ) as KeyedMetadata;\n\n            if (Object.keys(filtered).length > 0) {\n              keyedMetadata = filtered;\n            } else {\n              logger.warn(\n                `Companion metadata found for ${relativePath} but no keys aligned with the JSON schema — metadata was not attached`\n              );\n            }\n          }\n        }\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'JSON' as const,\n          ...getTransformFormatProperty(settings, 'json'),\n          dataFormat,\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...jsonFiles.filter((file) => file !== null));\n  }\n\n  // Process YAML files\n  if (filePaths.yaml) {\n    const yamlFiles = filePaths.yaml\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.yaml!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate YAML parseability\n        if (!skipValidation?.yaml) {\n          try {\n            YAML.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: YAML file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'YAML file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const { content: parsedYaml, fileFormat } = parseYaml(\n          content,\n          filePath,\n          settings.options || {}\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        try {\n          const parsedYamlContent = YAML.parse(content);\n          const rawMetadata = parseKeyedMetadata(filePath, parsedYamlContent);\n          if (rawMetadata) {\n            const yamlSchema = validateYamlSchema(\n              settings.options || {},\n              filePath\n            );\n            if (yamlSchema?.include) {\n              // Flatten metadata through the same include schema as the source\n              const flattened = flattenJson(rawMetadata, yamlSchema.include);\n              // Filter to only keep keys that exist in the transformed source\n              const sourceKeys = new Set(Object.keys(JSON.parse(parsedYaml)));\n              const filtered = Object.fromEntries(\n                Object.entries(flattened).filter(([k]) => sourceKeys.has(k))\n              ) as KeyedMetadata;\n              if (Object.keys(filtered).length > 0) {\n                keyedMetadata = filtered;\n              } else {\n                logger.warn(\n                  `Companion metadata found for ${relativePath} but no keys aligned with the YAML schema — metadata was not attached`\n                );\n              }\n            } else {\n              keyedMetadata = rawMetadata;\n            }\n          }\n        } catch {\n          // Content not parsable as YAML — skip metadata detection\n        }\n\n        return {\n          content: parsedYaml,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, 'yaml'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedYaml,\n            requiresReviewPaths.has(filePath)\n          ),\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file || typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(\n            `Skipping ${file?.fileName ?? 'unknown'}: YAML file is empty`\n          );\n          recordWarning(\n            'skipped_file',\n            file?.fileName ?? 'unknown',\n            'YAML file is empty'\n          );\n          return false;\n        }\n        return true;\n      });\n    files.push(...yamlFiles.filter((file) => file !== null));\n  }\n\n  // Process Twilio Content JSON files\n  if (filePaths.twilioContentJson) {\n    const twilioContentJsonFiles = filePaths.twilioContentJson\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const parsedJson = parseJson(\n          content,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'TWILIO_CONTENT_JSON' as const,\n          ...getTransformFormatProperty(settings, 'twilioContentJson'),\n          dataFormat: 'STRING' as const,\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...twilioContentJsonFiles.filter((file) => file !== null));\n  }\n\n  // Process Lottie files (binary zip bundles). Content is read as raw bytes and\n  // carried base64-encoded end-to-end; the downloaded translation is written\n  // back as bytes. No text parsing/merge.\n  if (filePaths.lottie) {\n    // Lottie files carrying After Effects expressions (executable JS) are\n    // rejected outright — collect every offender, then fail once with all of\n    // them named rather than aborting on the first.\n    const expressionOffenders: string[] = [];\n    const lottieFiles = filePaths.lottie\n      .map((filePath) => {\n        const content = readBinaryFileBase64(filePath);\n        const relativePath = getRelative(filePath);\n        if (!content) {\n          logger.warn(`Skipping ${relativePath}: file is empty or unreadable`);\n          recordWarning(\n            'skipped_file',\n            relativePath,\n            'File is empty or unreadable'\n          );\n          return null;\n        }\n        if (lottieHasExpressions(content)) {\n          expressionOffenders.push(relativePath);\n          return null;\n        }\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat: 'LOTTIE' as const,\n          ...getTransformFormatProperty(settings, 'lottie'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashStringSync(content),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => file !== null);\n    if (expressionOffenders.length > 0) {\n      logErrorAndExit(lottieExpressionsError(expressionOffenders));\n    }\n    files.push(...lottieFiles);\n  }\n\n  // These formats are uploaded verbatim. Their backslash escapes and format\n  // specifiers must survive byte-for-byte, so they skip the generic\n  // markdown-oriented preprocessing below.\n  for (const [fileType, fileFormat] of [\n    ['dotStrings', 'DOT_STRINGS'],\n    ['dotStringsdict', 'DOT_STRINGSDICT'],\n    ['androidStrings', 'ANDROID_STRINGS'],\n  ] as const) {\n    if (!filePaths[fileType]) continue;\n    // Content must already be base64 exactly when the format is binary, or the\n    // upload path encodes it a second time. Only .strings qualifies today: its\n    // UTF-16 bytes reach an API decoder that reads the byte order mark.\n    // .stringsdict has no such decoder yet, and strings.xml is always UTF-8.\n    const readsRawBytes = isBinaryFileFormat(fileFormat);\n    const verbatimFiles = filePaths[fileType]\n      .map((filePath) => {\n        const content = readsRawBytes\n          ? readBinaryFileBase64(filePath)\n          : readFile(filePath);\n        const relativePath = getRelative(filePath);\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, fileType),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(content, requiresReviewPaths.has(filePath)),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        // Blank check only; the content itself travels untouched. A UTF-16\n        // file reads as non-blank here, which is the safe default — the API\n        // decodes it properly.\n        const text = readsRawBytes\n          ? Buffer.from(file.content, 'base64').toString('utf8')\n          : file.content;\n        if (!text.trim()) {\n          logger.warn(`Skipping ${file.fileName}: File is empty`);\n          recordWarning('skipped_file', file.fileName, 'File is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...verbatimFiles);\n  }\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (\n      fileType === 'json' ||\n      fileType === 'yaml' ||\n      fileType === 'twilioContentJson' ||\n      fileType === 'lottie' ||\n      fileType === 'dotStrings' ||\n      fileType === 'dotStringsdict' ||\n      fileType === 'androidStrings'\n    )\n      continue;\n    if (filePaths[fileType]) {\n      const parsed = filePaths[fileType]\n        .map((filePath) => {\n          const content = readFile(filePath);\n          const relativePath = getRelative(filePath);\n\n          const processed = preprocessContent(\n            content,\n            relativePath,\n            fileType,\n            settings\n          );\n\n          if (typeof processed !== 'string') {\n            logger.warn(`Skipping ${relativePath}: ${processed.skip}`);\n            recordWarning('skipped_file', relativePath, processed.skip);\n            return null;\n          }\n\n          return {\n            content: processed,\n            fileName: relativePath,\n            fileFormat: fileType.toUpperCase() as FileFormat,\n            ...getTransformFormatProperty(settings, fileType),\n            fileId: hashStringSync(relativePath),\n            versionId: hashVersionId(\n              processed,\n              requiresReviewPaths.has(filePath)\n            ),\n            locale: settings.defaultLocale,\n          } satisfies FileToUpload;\n        })\n        .filter((file) => {\n          if (\n            !file ||\n            typeof file.content !== 'string' ||\n            !file.content.trim()\n          ) {\n            logger.warn(\n              `Skipping ${file?.fileName ?? 'unknown'}: File is empty after sanitization`\n            );\n            recordWarning(\n              'skipped_file',\n              file?.fileName ?? 'unknown',\n              'File is empty after sanitization'\n            );\n            return false;\n          }\n          return true;\n        });\n      files.push(...parsed.filter((file) => file !== null));\n    }\n  }\n\n  // Remove stale entries for files that were skipped during validation\n  const validFileIds = new Set(files.map((f) => f.fileId));\n  for (const fileId of publishMap.keys()) {\n    if (!validFileIds.has(fileId)) {\n      publishMap.delete(fileId);\n    }\n  }\n\n  return { files, publishMap };\n}\n"],"mappings":"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"}
+{"version":3,"file":"aggregateFiles.js","names":[],"sources":["../../../src/formats/files/aggregateFiles.ts"],"sourcesContent":["import { logger } from '../../console/logger.js';\nimport { logErrorAndExit } from '../../console/logging.js';\nimport {\n  fileEncodingSkipReason,\n  lottieExpressionsError,\n} from '../../console/index.js';\nimport { recordWarning } from '../../state/translateWarnings.js';\nimport { lottieHasExpressions } from './detectLottieExpressions.js';\nimport {\n  getRelative,\n  readFile,\n  readBinaryFileBase64,\n} from '../../fs/findFilepath.js';\nimport { readFileContent } from '../../fs/fileContent.js';\nimport { Settings } from '../../types/index.js';\nimport type { FileFormat, DataFormat, FileToUpload } from '../../types/data.js';\nimport { SUPPORTED_FILE_EXTENSIONS } from './supportedFiles.js';\nimport { parseJson } from '../json/parseJson.js';\nimport {\n  resolveMintlifyRefs,\n  shouldResolveRefs,\n} from '../../utils/resolveMintlifyRefs.js';\nimport { storeRefMap } from '../../state/mintlifyRefMap.js';\nimport parseYaml from '../yaml/parseYaml.js';\nimport { validateYamlSchema } from '../yaml/utils.js';\nimport { flattenJson } from '../json/flattenJson.js';\nimport type { JSONObject } from '../../types/data/json.js';\nimport YAML from 'yaml';\nimport { determineLibrary } from '../../fs/determineFramework/index.js';\nimport { hashStringSync, hashVersionId } from '../../utils/hash.js';\nimport { preprocessContent } from './preprocessContent.js';\nimport {\n  parseKeyedMetadata,\n  type KeyedMetadata,\n} from '../parseKeyedMetadata.js';\nimport { buildPublishMap } from '../../utils/resolvePublish.js';\nimport { getTransformFormatProperty } from './transformFormat.js';\n\n/**\n * Checks if a file path is a metadata companion file (e.g. foo.metadata.json)\n * AND its corresponding source file (e.g. foo.json) exists in the file list.\n * If both conditions are true, the metadata file should be skipped as a translation source.\n */\nfunction isCompanionMetadataFile(\n  filePath: string,\n  allFilePaths: string[]\n): boolean {\n  const metadataPattern = /\\.metadata\\.(json|yaml|yml)$/;\n  if (!metadataPattern.test(filePath)) return false;\n\n  // Derive the source file path: foo.metadata.json -> foo.json\n  const sourceFilePath = filePath.replace(\n    /\\.metadata\\.(json|yaml|yml)$/,\n    '.$1'\n  );\n  return allFilePaths.includes(sourceFilePath);\n}\n\nexport async function aggregateFiles(\n  settings: Settings\n): Promise<{ files: FileToUpload[]; publishMap: Map<string, boolean> }> {\n  // Aggregate all files to translate\n  const files: FileToUpload[] = [];\n  if (\n    !settings.files ||\n    (Object.keys(settings.files.placeholderPaths).length === 1 &&\n      settings.files.placeholderPaths.gt)\n  ) {\n    return { files, publishMap: new Map<string, boolean>() };\n  }\n\n  const { resolvedPaths: filePaths } = settings.files;\n  // Tolerate partially-constructed settings from programmatic callers\n  const requiresReviewPaths =\n    settings.files.requiresReviewPaths ?? new Set<string>();\n  const skipValidation = settings.options?.skipFileValidation;\n\n  // Build publish map upfront from resolved paths.\n  const publishMap = buildPublishMap(filePaths, settings);\n\n  // Process JSON files\n  if (filePaths.json) {\n    const { library, additionalModules } = determineLibrary();\n\n    // Determine dataFormat for JSONs\n    let dataFormat: DataFormat;\n    if (library === 'next-intl') {\n      dataFormat = 'ICU';\n    } else if (library === 'i18next') {\n      if (additionalModules.includes('i18next-icu')) {\n        dataFormat = 'ICU';\n      } else {\n        dataFormat = 'I18NEXT';\n      }\n    } else {\n      dataFormat = 'STRING';\n    }\n\n    const jsonFiles = filePaths.json\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.json!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        // Resolve $ref before parsing if configured\n        let contentForParsing = content;\n        if (shouldResolveRefs(filePath, settings.options)) {\n          try {\n            const json = JSON.parse(content);\n            const { resolved, refMap } = resolveMintlifyRefs(json, filePath);\n            storeRefMap(refMap);\n            contentForParsing = JSON.stringify(resolved, null, 2);\n          } catch {\n            // JSON parse errors are handled below by parseJson\n          }\n        }\n\n        const parsedJson = parseJson(\n          contentForParsing,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        let parsedContent: JSONObject | undefined;\n        try {\n          parsedContent = JSON.parse(content) as JSONObject;\n        } catch {\n          // Content not parsable — skip metadata detection\n        }\n        if (parsedContent) {\n          const rawMetadata = parseKeyedMetadata(filePath, parsedContent);\n          if (rawMetadata) {\n            // Run metadata through the same include/composite schema as the source\n            // so key paths align at translation time\n            const transformed = parseJson(\n              JSON.stringify(rawMetadata),\n              filePath,\n              settings.options || {},\n              settings.defaultLocale,\n              false\n            );\n            const transformedMetadata = JSON.parse(transformed);\n\n            // Filter metadata to only keep keys that exist in the transformed source\n            // This prevents misaligned entries from wide JSONPath patterns\n            const sourceKeys = new Set(Object.keys(JSON.parse(parsedJson)));\n            const filtered = Object.fromEntries(\n              Object.entries(transformedMetadata).filter(([k]) =>\n                sourceKeys.has(k)\n              )\n            ) as KeyedMetadata;\n\n            if (Object.keys(filtered).length > 0) {\n              keyedMetadata = filtered;\n            } else {\n              logger.warn(\n                `Companion metadata found for ${relativePath} but no keys aligned with the JSON schema — metadata was not attached`\n              );\n            }\n          }\n        }\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'JSON' as const,\n          ...getTransformFormatProperty(settings, 'json'),\n          dataFormat,\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...jsonFiles.filter((file) => file !== null));\n  }\n\n  // Process YAML files\n  if (filePaths.yaml) {\n    const yamlFiles = filePaths.yaml\n      .filter((filePath) => !isCompanionMetadataFile(filePath, filePaths.yaml!))\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate YAML parseability\n        if (!skipValidation?.yaml) {\n          try {\n            YAML.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: YAML file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'YAML file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const { content: parsedYaml, fileFormat } = parseYaml(\n          content,\n          filePath,\n          settings.options || {}\n        );\n\n        // Detect companion metadata file\n        let keyedMetadata: KeyedMetadata | undefined;\n        try {\n          const parsedYamlContent = YAML.parse(content);\n          const rawMetadata = parseKeyedMetadata(filePath, parsedYamlContent);\n          if (rawMetadata) {\n            const yamlSchema = validateYamlSchema(\n              settings.options || {},\n              filePath\n            );\n            if (yamlSchema?.include) {\n              // Flatten metadata through the same include schema as the source\n              const flattened = flattenJson(rawMetadata, yamlSchema.include);\n              // Filter to only keep keys that exist in the transformed source\n              const sourceKeys = new Set(Object.keys(JSON.parse(parsedYaml)));\n              const filtered = Object.fromEntries(\n                Object.entries(flattened).filter(([k]) => sourceKeys.has(k))\n              ) as KeyedMetadata;\n              if (Object.keys(filtered).length > 0) {\n                keyedMetadata = filtered;\n              } else {\n                logger.warn(\n                  `Companion metadata found for ${relativePath} but no keys aligned with the YAML schema — metadata was not attached`\n                );\n              }\n            } else {\n              keyedMetadata = rawMetadata;\n            }\n          }\n        } catch {\n          // Content not parsable as YAML — skip metadata detection\n        }\n\n        return {\n          content: parsedYaml,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, 'yaml'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedYaml,\n            requiresReviewPaths.has(filePath)\n          ),\n          locale: settings.defaultLocale,\n          ...(keyedMetadata && {\n            formatMetadata: { keyedMetadata },\n          }),\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file || typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(\n            `Skipping ${file?.fileName ?? 'unknown'}: YAML file is empty`\n          );\n          recordWarning(\n            'skipped_file',\n            file?.fileName ?? 'unknown',\n            'YAML file is empty'\n          );\n          return false;\n        }\n        return true;\n      });\n    files.push(...yamlFiles.filter((file) => file !== null));\n  }\n\n  // Process Twilio Content JSON files\n  if (filePaths.twilioContentJson) {\n    const twilioContentJsonFiles = filePaths.twilioContentJson\n      .map((filePath) => {\n        const content = readFile(filePath);\n        const relativePath = getRelative(filePath);\n\n        // Pre-validate JSON parseability\n        if (!skipValidation?.json) {\n          try {\n            JSON.parse(content);\n          } catch {\n            logger.warn(`Skipping ${relativePath}: JSON file is not parsable`);\n            recordWarning(\n              'skipped_file',\n              relativePath,\n              'JSON file is not parsable'\n            );\n            return null;\n          }\n        }\n\n        const parsedJson = parseJson(\n          content,\n          filePath,\n          settings.options || {},\n          settings.defaultLocale\n        );\n\n        return {\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(\n            parsedJson,\n            requiresReviewPaths.has(filePath)\n          ),\n          content: parsedJson,\n          fileName: relativePath,\n          fileFormat: 'TWILIO_CONTENT_JSON' as const,\n          ...getTransformFormatProperty(settings, 'twilioContentJson'),\n          dataFormat: 'STRING' as const,\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (typeof file.content !== 'string' || !file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: JSON file is empty`);\n          recordWarning('skipped_file', file.fileName, 'JSON file is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...twilioContentJsonFiles.filter((file) => file !== null));\n  }\n\n  // Process Lottie files (binary zip bundles). Content is read as raw bytes and\n  // carried base64-encoded end-to-end; the downloaded translation is written\n  // back as bytes. No text parsing/merge.\n  if (filePaths.lottie) {\n    // Lottie files carrying After Effects expressions (executable JS) are\n    // rejected outright — collect every offender, then fail once with all of\n    // them named rather than aborting on the first.\n    const expressionOffenders: string[] = [];\n    const lottieFiles = filePaths.lottie\n      .map((filePath) => {\n        const content = readBinaryFileBase64(filePath);\n        const relativePath = getRelative(filePath);\n        if (!content) {\n          logger.warn(`Skipping ${relativePath}: file is empty or unreadable`);\n          recordWarning(\n            'skipped_file',\n            relativePath,\n            'File is empty or unreadable'\n          );\n          return null;\n        }\n        if (lottieHasExpressions(content)) {\n          expressionOffenders.push(relativePath);\n          return null;\n        }\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat: 'LOTTIE' as const,\n          ...getTransformFormatProperty(settings, 'lottie'),\n          fileId: hashStringSync(relativePath),\n          versionId: hashStringSync(content),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => file !== null);\n    if (expressionOffenders.length > 0) {\n      logErrorAndExit(lottieExpressionsError(expressionOffenders));\n    }\n    files.push(...lottieFiles);\n  }\n\n  // These formats are uploaded verbatim. Their backslash escapes and format\n  // specifiers must survive byte-for-byte, so they skip the generic\n  // markdown-oriented preprocessing below.\n  for (const [fileType, fileFormat] of [\n    ['dotStrings', 'DOT_STRINGS'],\n    ['dotStringsdict', 'DOT_STRINGSDICT'],\n    ['androidStrings', 'ANDROID_STRINGS'],\n  ] as const) {\n    if (!filePaths[fileType]) continue;\n    const verbatimFiles = filePaths[fileType]\n      .map((filePath) => {\n        const relativePath = getRelative(filePath);\n        // Reading is the one place an encoding is resolved; from here on the\n        // content is a UTF-8 string like every other format's.\n        let content: string;\n        try {\n          content = readFileContent(filePath, fileFormat);\n        } catch (error) {\n          // One unreadable file should not abort the whole run: skip it and\n          // report it in the summary\n          const reason = fileEncodingSkipReason(error);\n          logger.warn(`Skipping ${relativePath}: ${reason}`);\n          recordWarning('skipped_file', relativePath, reason);\n          return null;\n        }\n        return {\n          content,\n          fileName: relativePath,\n          fileFormat,\n          ...getTransformFormatProperty(settings, fileType),\n          fileId: hashStringSync(relativePath),\n          versionId: hashVersionId(content, requiresReviewPaths.has(filePath)),\n          locale: settings.defaultLocale,\n        } satisfies FileToUpload;\n      })\n      .filter((file) => {\n        if (!file) return false;\n        if (!file.content.trim()) {\n          logger.warn(`Skipping ${file.fileName}: File is empty`);\n          recordWarning('skipped_file', file.fileName, 'File is empty');\n          return false;\n        }\n        return true;\n      });\n    files.push(...verbatimFiles.filter((file) => file !== null));\n  }\n\n  for (const fileType of SUPPORTED_FILE_EXTENSIONS) {\n    if (\n      fileType === 'json' ||\n      fileType === 'yaml' ||\n      fileType === 'twilioContentJson' ||\n      fileType === 'lottie' ||\n      fileType === 'dotStrings' ||\n      fileType === 'dotStringsdict' ||\n      fileType === 'androidStrings'\n    )\n      continue;\n    if (filePaths[fileType]) {\n      const parsed = filePaths[fileType]\n        .map((filePath) => {\n          const content = readFile(filePath);\n          const relativePath = getRelative(filePath);\n\n          const processed = preprocessContent(\n            content,\n            relativePath,\n            fileType,\n            settings\n          );\n\n          if (typeof processed !== 'string') {\n            logger.warn(`Skipping ${relativePath}: ${processed.skip}`);\n            recordWarning('skipped_file', relativePath, processed.skip);\n            return null;\n          }\n\n          return {\n            content: processed,\n            fileName: relativePath,\n            fileFormat: fileType.toUpperCase() as FileFormat,\n            ...getTransformFormatProperty(settings, fileType),\n            fileId: hashStringSync(relativePath),\n            versionId: hashVersionId(\n              processed,\n              requiresReviewPaths.has(filePath)\n            ),\n            locale: settings.defaultLocale,\n          } satisfies FileToUpload;\n        })\n        .filter((file) => {\n          if (\n            !file ||\n            typeof file.content !== 'string' ||\n            !file.content.trim()\n          ) {\n            logger.warn(\n              `Skipping ${file?.fileName ?? 'unknown'}: File is empty after sanitization`\n            );\n            recordWarning(\n              'skipped_file',\n              file?.fileName ?? 'unknown',\n              'File is empty after sanitization'\n            );\n            return false;\n          }\n          return true;\n        });\n      files.push(...parsed.filter((file) => file !== null));\n    }\n  }\n\n  // Remove stale entries for files that were skipped during validation\n  const validFileIds = new Set(files.map((f) => f.fileId));\n  for (const fileId of publishMap.keys()) {\n    if (!validFileIds.has(fileId)) {\n      publishMap.delete(fileId);\n    }\n  }\n\n  return { files, publishMap };\n}\n"],"mappings":"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"}

package/dist/fs/fileContent.d.ts

@@ -0,0 +1,65 @@
+import { type FileFormat } from 'generaltranslation/types';
+/**
+ * How file content crosses the disk boundary.
+ *
+ * This is the only module in the CLI that knows a file may be stored in
+ * something other than UTF-8. `readFileContent` is the single ingress point and
+ * `encodeFileContent` the single egress point; in between, content is a UTF-8
+ * string and nothing else has to reason about encodings.
+ */
+/**
+ * On-disk byte layouts Foundation accepts for `.strings` and `.stringsdict`.
+ *
+ * A byte order mark is the only signal. Foundation does not sniff UTF-16 from
+ * interleaved NUL bytes, so an unmarked file is UTF-8 even when its bytes are
+ * plainly UTF-16 — `plutil` rejects those files, and guessing would translate
+ * content Foundation itself cannot read.
+ */
+export type FileEncoding = 'utf8' | 'utf8-bom' | 'utf16le' | 'utf16be' | 'utf32le' | 'utf32be';
+/**
+ * Ingress. Reads a file as the content the pipeline carries for its format:
+ * base64 for binary formats, otherwise UTF-8 text decoded from whatever
+ * encoding the file happens to be stored in.
+ *
+ * A file that cannot be read throws rather than reading as empty, which the
+ * pipeline cannot tell apart from a file that is genuinely empty and would
+ * upload as a deletion of every string in it.
+ * @param {string} filePath - The path to the file to read.
+ * @param {FileFormat} fileFormat - The format the file is configured as.
+ * @returns {string} - The content.
+ */
+export declare function readFileContent(filePath: string, fileFormat: FileFormat): string;
+/**
+ * Egress. Renders translated content for disk in the encoding `sourcePath` is
+ * stored in, so a repository of UTF-16 files stays UTF-16 rather than showing
+ * every one of them as rewritten.
+ *
+ * The source file is the record of that encoding, which is why it is re-read
+ * here rather than carried from ingress: the download that writes this file is
+ * usually a different process run from the upload that read it, so there is no
+ * value to carry. Nothing has to be persisted in the lockfile or on the server.
+ *
+ * A source moved or deleted since it was uploaded leaves the translation
+ * already on disk as the only remaining record, so `outputPath` is read next.
+ * Defaulting straight to UTF-8 would rewrite every UTF-16 file and, for
+ * `.stringsdict`, strand a UTF-16 XML declaration over unmarked UTF-8 bytes —
+ * the one combination Foundation rejects.
+ * @param {string} content - The translated content, as UTF-8 text.
+ * @param {FileFormat} fileFormat - The format being written.
+ * @param {string} sourcePath - The source file this translation came from.
+ * @param {string} [outputPath] - Where the translation is about to be written.
+ * @returns The value to hand to `writeFile`.
+ */
+export declare function encodeFileContent(content: string, fileFormat: FileFormat | undefined, sourcePath: string, outputPath?: string): string | Buffer;
+/** Reads the byte order mark, defaulting to UTF-8 when there is none. */
+export declare function detectFileEncoding(bytes: Buffer): FileEncoding;
+/**
+ * Decodes a `.strings` or `.stringsdict` file to text, dropping the byte order
+ * mark. The encoding is returned so the writer can restore both on the way out.
+ */
+export declare function decodeFileText(bytes: Buffer): {
+    text: string;
+    encoding: FileEncoding;
+};
+/** Re-encodes text into the given layout, byte order mark included. */
+export declare function encodeFileText(text: string, encoding: FileEncoding): Buffer;