poly-lexis 0.9.2 → 0.11.0

package/dist/scripts/generate-schema.js

@@ -378,6 +378,14 @@ var TRANSLATION_CONFIG_SCHEMA = {
         type: "string"
       },
       default: [".ts", ".tsx", ".js", ".jsx", ".vue", ".svelte"]
+    },
+    protectedTerms: {
+      type: "array",
+      description: "List of terms that should never be translated (e.g. brand names, technical terms)",
+      items: {
+        type: "string"
+      },
+      default: []
     }
   },
   required: ["translationsPath", "languages", "sourceLanguage"],

package/dist/scripts/generate-schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/scripts/generate-schema.ts","../../src/translations/core/schema.ts"],"sourcesContent":["/**\n * Generate JSON schema file from TypeScript schema definition\n * This ensures the JSON schema stays in sync with the TypeScript source\n */\nimport { writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { TRANSLATION_CONFIG_SCHEMA } from '../translations/core/schema.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Write to src directory, not dist\n// When compiled to dist/scripts/, we need to go up 2 levels to get to project root\nconst projectRoot = join(__dirname, '../..');\nconst SCHEMA_OUTPUT_PATH = join(projectRoot, 'src/translations/core/translations-config.schema.json');\n\nconst schemaWithMeta = {\n  $schema: 'http://json-schema.org/draft-07/schema#',\n  $id: 'https://raw.githubusercontent.com/designedhead/lexis/main/src/translations/core/translations-config.schema.json',\n  ...TRANSLATION_CONFIG_SCHEMA\n};\n\nwriteFileSync(SCHEMA_OUTPUT_PATH, `${JSON.stringify(schemaWithMeta, null, 2)}\\n`);\n\nconsole.log('✅ Generated translations-config.schema.json');\n","/**\n * Translation provider types\n */\nexport const TRANSLATION_PROVIDERS = ['deepl', 'google'] as const;\nexport type TranslationProviderType = (typeof TRANSLATION_PROVIDERS)[number];\n\n/**\n * DeepL supported target languages\n * Based on DeepL API v2 documentation\n */\nexport const DEEPL_LANGUAGES = [\n  'ar', // Arabic\n  'bg', // Bulgarian\n  'cs', // Czech\n  'da', // Danish\n  'de', // German\n  'el', // Greek\n  'en', // English (unspecified)\n  'en_gb', // English (British)\n  'en_us', // English (American)\n  'es', // Spanish\n  'es_419', // Spanish (Latin American)\n  'et', // Estonian\n  'fi', // Finnish\n  'fr', // French\n  'he', // Hebrew (next-gen models only)\n  'hu', // Hungarian\n  'id', // Indonesian\n  'it', // Italian\n  'ja', // Japanese\n  'ko', // Korean\n  'lt', // Lithuanian\n  'lv', // Latvian\n  'nb', // Norwegian Bokmål\n  'nl', // Dutch\n  'pl', // Polish\n  'pt', // Portuguese (unspecified)\n  'pt_br', // Portuguese (Brazilian)\n  'pt_pt', // Portuguese (excluding Brazilian)\n  'ro', // Romanian\n  'ru', // Russian\n  'sk', // Slovak\n  'sl', // Slovenian\n  'sv', // Swedish\n  'th', // Thai (next-gen models only)\n  'tr', // Turkish\n  'uk', // Ukrainian\n  'vi', // Vietnamese (next-gen models only)\n  'zh', // Chinese (unspecified)\n  'zh_hans', // Chinese (simplified)\n  'zh_hant' // Chinese (traditional)\n] as const;\n\n/**\n * Google Translate supported languages\n * Based on Google Cloud Translation API v2\n * Reference: https://docs.cloud.google.com/translate/docs/languages\n */\nexport const GOOGLE_LANGUAGES = [\n  'af', // Afrikaans\n  'sq', // Albanian\n  'am', // Amharic\n  'ar', // Arabic\n  'hy', // Armenian\n  'az', // Azerbaijani\n  'eu', // Basque\n  'be', // Belarusian\n  'bn', // Bengali\n  'bs', // Bosnian\n  'bg', // Bulgarian\n  'ca', // Catalan\n  'ceb', // Cebuano\n  'zh', // Chinese (Simplified)\n  'zh_cn', // Chinese (Simplified)\n  'zh_tw', // Chinese (Traditional)\n  'co', // Corsican\n  'hr', // Croatian\n  'cs', // Czech\n  'da', // Danish\n  'nl', // Dutch\n  'en', // English\n  'eo', // Esperanto\n  'et', // Estonian\n  'fi', // Finnish\n  'fr', // French\n  'fy', // Frisian\n  'gl', // Galician\n  'ka', // Georgian\n  'de', // German\n  'el', // Greek\n  'gu', // Gujarati\n  'ht', // Haitian Creole\n  'ha', // Hausa\n  'haw', // Hawaiian\n  'he', // Hebrew\n  'hi', // Hindi\n  'hmn', // Hmong\n  'hu', // Hungarian\n  'is', // Icelandic\n  'ig', // Igbo\n  'id', // Indonesian\n  'ga', // Irish\n  'it', // Italian\n  'ja', // Japanese\n  'jv', // Javanese\n  'kn', // Kannada\n  'kk', // Kazakh\n  'km', // Khmer\n  'rw', // Kinyarwanda\n  'ko', // Korean\n  'ku', // Kurdish\n  'ky', // Kyrgyz\n  'lo', // Lao\n  'la', // Latin\n  'lv', // Latvian\n  'lt', // Lithuanian\n  'lb', // Luxembourgish\n  'mk', // Macedonian\n  'mg', // Malagasy\n  'ms', // Malay\n  'ml', // Malayalam\n  'mt', // Maltese\n  'mi', // Maori\n  'mr', // Marathi\n  'mn', // Mongolian\n  'my', // Myanmar (Burmese)\n  'ne', // Nepali\n  'no', // Norwegian\n  'ny', // Nyanja (Chichewa)\n  'or', // Odia (Oriya)\n  'ps', // Pashto\n  'fa', // Persian\n  'pl', // Polish\n  'pt', // Portuguese\n  'pt_br', // Portuguese (Brazil)\n  'pa', // Punjabi\n  'ro', // Romanian\n  'ru', // Russian\n  'sm', // Samoan\n  'gd', // Scots Gaelic\n  'sr', // Serbian\n  'st', // Sesotho\n  'sn', // Shona\n  'sd', // Sindhi\n  'si', // Sinhala (Sinhalese)\n  'sk', // Slovak\n  'sl', // Slovenian\n  'so', // Somali\n  'es', // Spanish\n  'su', // Sundanese\n  'sw', // Swahili\n  'sv', // Swedish\n  'tl', // Tagalog (Filipino)\n  'tg', // Tajik\n  'ta', // Tamil\n  'tt', // Tatar\n  'te', // Telugu\n  'th', // Thai\n  'tr', // Turkish\n  'tk', // Turkmen\n  'uk', // Ukrainian\n  'ur', // Urdu\n  'ug', // Uyghur\n  'uz', // Uzbek\n  'vi', // Vietnamese\n  'cy', // Welsh\n  'xh', // Xhosa\n  'yi', // Yiddish\n  'yo', // Yoruba\n  'zu' // Zulu\n] as const;\n\n/**\n * All supported language codes (union of DeepL and Google Translate)\n */\nexport const SUPPORTED_LANGUAGES = Array.from(\n  new Set([...DEEPL_LANGUAGES, ...GOOGLE_LANGUAGES])\n).sort() as readonly string[];\n\nexport type DeepLLanguage = (typeof DEEPL_LANGUAGES)[number];\nexport type GoogleLanguage = (typeof GOOGLE_LANGUAGES)[number];\nexport type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];\n\n/**\n * JSON Schema for .translationsrc.json\n */\nexport const TRANSLATION_CONFIG_SCHEMA = {\n  title: 'Translation Configuration',\n  description: 'Configuration for the translation management system',\n  type: 'object',\n  properties: {\n    $schema: {\n      type: 'string',\n      description: 'JSON Schema reference'\n    },\n    translationsPath: {\n      type: 'string',\n      description: 'Path to the translations directory relative to project root',\n      default: 'public/static/locales',\n      examples: ['public/static/locales', 'src/locales', 'locales']\n    },\n    languages: {\n      type: 'array',\n      description: 'List of language codes to support',\n      items: {\n        type: 'string',\n        enum: SUPPORTED_LANGUAGES\n      },\n      minItems: 1,\n      uniqueItems: true,\n      default: ['en']\n    },\n    sourceLanguage: {\n      type: 'string',\n      description: 'Source language for translations (usually \"en\")',\n      enum: SUPPORTED_LANGUAGES,\n      default: 'en'\n    },\n    typesOutputPath: {\n      type: 'string',\n      description: 'Path to output TypeScript types file',\n      default: 'src/types/i18nTypes.ts',\n      examples: ['src/types/i18nTypes.ts', 'src/types/translations.ts']\n    },\n    provider: {\n      type: 'string',\n      description: 'Translation provider to use (deepl or google)',\n      enum: TRANSLATION_PROVIDERS,\n      default: 'deepl'\n    },\n    useFallbackLanguages: {\n      type: 'boolean',\n      description: 'Enable automatic language fallback for unsupported regional variants (e.g., de_at -> de)',\n      default: false\n    },\n    searchPaths: {\n      type: 'array',\n      description: 'Directories to search for translation key usage',\n      items: {\n        type: 'string'\n      },\n      default: ['src', 'app', 'pages', 'components']\n    },\n    searchExtensions: {\n      type: 'array',\n      description: 'File extensions to search for key usage',\n      items: {\n        type: 'string'\n      },\n      default: ['.ts', '.tsx', '.js', '.jsx', '.vue', '.svelte']\n    }\n  },\n  required: ['translationsPath', 'languages', 'sourceLanguage'],\n  additionalProperties: false\n};\n\n/**\n * Validate if a language code is supported\n */\nexport function isValidLanguage(lang: string): lang is SupportedLanguage {\n  return SUPPORTED_LANGUAGES.includes(lang as SupportedLanguage);\n}\n\n/**\n * Validate if a language is supported by DeepL\n */\nexport function isValidDeepLLanguage(lang: string): lang is DeepLLanguage {\n  return DEEPL_LANGUAGES.includes(lang as DeepLLanguage);\n}\n\n/**\n * Validate if a language is supported by Google Translate\n */\nexport function isValidGoogleLanguage(lang: string): lang is GoogleLanguage {\n  return GOOGLE_LANGUAGES.includes(lang as GoogleLanguage);\n}\n\n/**\n * Validate if a language is supported by a specific provider\n */\nexport function isValidLanguageForProvider(lang: string, provider: TranslationProviderType): boolean {\n  switch (provider) {\n    case 'deepl':\n      return isValidDeepLLanguage(lang);\n    case 'google':\n      return isValidGoogleLanguage(lang);\n    default:\n      return false;\n  }\n}\n\n/**\n * Validate languages array\n */\nexport function validateLanguages(languages: string[]): {\n  valid: boolean;\n  invalid: string[];\n} {\n  const invalid = languages.filter((lang) => !isValidLanguage(lang));\n  return {\n    valid: !invalid.length,\n    invalid\n  };\n}\n\n/**\n * Validate languages array for a specific provider\n */\nexport function validateLanguagesForProvider(\n  languages: string[],\n  provider: TranslationProviderType\n): {\n  valid: boolean;\n  invalid: string[];\n} {\n  const invalid = languages.filter((lang) => !isValidLanguageForProvider(lang, provider));\n  return {\n    valid: !invalid.length,\n    invalid\n  };\n}\n\n/**\n * Get supported languages for a specific provider\n */\nexport function getSupportedLanguages(provider: TranslationProviderType): readonly string[] {\n  switch (provider) {\n    case 'deepl':\n      return DEEPL_LANGUAGES;\n    case 'google':\n      return GOOGLE_LANGUAGES;\n    default:\n      return [];\n  }\n}\n\n/**\n * Re-export language fallback utilities for convenience\n */\nexport {\n  getFallbackMappings,\n  type LanguageFallbackResult,\n  logLanguageFallback,\n  resolveLanguageWithFallback\n} from '../utils/language-fallback.js';\n"],"mappings":";AAIA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;;;ACHvB,IAAM,wBAAwB,CAAC,SAAS,QAAQ;AAOhD,IAAM,kBAAkB;AAAA,EAC7B;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF;AAOO,IAAM,mBAAmB;AAAA,EAC9B;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF;AAKO,IAAM,sBAAsB,MAAM;AAAA,EACvC,oBAAI,IAAI,CAAC,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AACnD,EAAE,KAAK;AASA,IAAM,4BAA4B;AAAA,EACvC,OAAO;AAAA,EACP,aAAa;AAAA,EACb,MAAM;AAAA,EACN,YAAY;AAAA,IACV,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,IACA,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU,CAAC,yBAAyB,eAAe,SAAS;AAAA,IAC9D;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,MACA,UAAU;AAAA,MACV,aAAa;AAAA,MACb,SAAS,CAAC,IAAI;AAAA,IAChB;AAAA,IACA,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA,iBAAiB;AAAA,MACf,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU,CAAC,0BAA0B,2BAA2B;AAAA,IAClE;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA,sBAAsB;AAAA,MACpB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,MACR;AAAA,MACA,SAAS,CAAC,OAAO,OAAO,SAAS,YAAY;AAAA,IAC/C;AAAA,IACA,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,MACR;AAAA,MACA,SAAS,CAAC,OAAO,QAAQ,OAAO,QAAQ,QAAQ,SAAS;AAAA,IAC3D;AAAA,EACF;AAAA,EACA,UAAU,CAAC,oBAAoB,aAAa,gBAAgB;AAAA,EAC5D,sBAAsB;AACxB;;;ADrPA,IAAMA,cAAa,cAAc,YAAY,GAAG;AAChD,IAAMC,aAAY,QAAQD,WAAU;AAIpC,IAAM,cAAc,KAAKC,YAAW,OAAO;AAC3C,IAAM,qBAAqB,KAAK,aAAa,uDAAuD;AAEpG,IAAM,iBAAiB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AAAA,EACL,GAAG;AACL;AAEA,cAAc,oBAAoB,GAAG,KAAK,UAAU,gBAAgB,MAAM,CAAC,CAAC;AAAA,CAAI;AAEhF,QAAQ,IAAI,kDAA6C;","names":["__filename","__dirname"]}
+{"version":3,"sources":["../../src/scripts/generate-schema.ts","../../src/translations/core/schema.ts"],"sourcesContent":["/**\n * Generate JSON schema file from TypeScript schema definition\n * This ensures the JSON schema stays in sync with the TypeScript source\n */\nimport { writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { TRANSLATION_CONFIG_SCHEMA } from '../translations/core/schema.js';\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Write to src directory, not dist\n// When compiled to dist/scripts/, we need to go up 2 levels to get to project root\nconst projectRoot = join(__dirname, '../..');\nconst SCHEMA_OUTPUT_PATH = join(projectRoot, 'src/translations/core/translations-config.schema.json');\n\nconst schemaWithMeta = {\n  $schema: 'http://json-schema.org/draft-07/schema#',\n  $id: 'https://raw.githubusercontent.com/designedhead/lexis/main/src/translations/core/translations-config.schema.json',\n  ...TRANSLATION_CONFIG_SCHEMA\n};\n\nwriteFileSync(SCHEMA_OUTPUT_PATH, `${JSON.stringify(schemaWithMeta, null, 2)}\\n`);\n\nconsole.log('✅ Generated translations-config.schema.json');\n","/**\n * Translation provider types\n */\nexport const TRANSLATION_PROVIDERS = ['deepl', 'google'] as const;\nexport type TranslationProviderType = (typeof TRANSLATION_PROVIDERS)[number];\n\n/**\n * DeepL supported target languages\n * Based on DeepL API v2 documentation\n */\nexport const DEEPL_LANGUAGES = [\n  'ar', // Arabic\n  'bg', // Bulgarian\n  'cs', // Czech\n  'da', // Danish\n  'de', // German\n  'el', // Greek\n  'en', // English (unspecified)\n  'en_gb', // English (British)\n  'en_us', // English (American)\n  'es', // Spanish\n  'es_419', // Spanish (Latin American)\n  'et', // Estonian\n  'fi', // Finnish\n  'fr', // French\n  'he', // Hebrew (next-gen models only)\n  'hu', // Hungarian\n  'id', // Indonesian\n  'it', // Italian\n  'ja', // Japanese\n  'ko', // Korean\n  'lt', // Lithuanian\n  'lv', // Latvian\n  'nb', // Norwegian Bokmål\n  'nl', // Dutch\n  'pl', // Polish\n  'pt', // Portuguese (unspecified)\n  'pt_br', // Portuguese (Brazilian)\n  'pt_pt', // Portuguese (excluding Brazilian)\n  'ro', // Romanian\n  'ru', // Russian\n  'sk', // Slovak\n  'sl', // Slovenian\n  'sv', // Swedish\n  'th', // Thai (next-gen models only)\n  'tr', // Turkish\n  'uk', // Ukrainian\n  'vi', // Vietnamese (next-gen models only)\n  'zh', // Chinese (unspecified)\n  'zh_hans', // Chinese (simplified)\n  'zh_hant' // Chinese (traditional)\n] as const;\n\n/**\n * Google Translate supported languages\n * Based on Google Cloud Translation API v2\n * Reference: https://docs.cloud.google.com/translate/docs/languages\n */\nexport const GOOGLE_LANGUAGES = [\n  'af', // Afrikaans\n  'sq', // Albanian\n  'am', // Amharic\n  'ar', // Arabic\n  'hy', // Armenian\n  'az', // Azerbaijani\n  'eu', // Basque\n  'be', // Belarusian\n  'bn', // Bengali\n  'bs', // Bosnian\n  'bg', // Bulgarian\n  'ca', // Catalan\n  'ceb', // Cebuano\n  'zh', // Chinese (Simplified)\n  'zh_cn', // Chinese (Simplified)\n  'zh_tw', // Chinese (Traditional)\n  'co', // Corsican\n  'hr', // Croatian\n  'cs', // Czech\n  'da', // Danish\n  'nl', // Dutch\n  'en', // English\n  'eo', // Esperanto\n  'et', // Estonian\n  'fi', // Finnish\n  'fr', // French\n  'fy', // Frisian\n  'gl', // Galician\n  'ka', // Georgian\n  'de', // German\n  'el', // Greek\n  'gu', // Gujarati\n  'ht', // Haitian Creole\n  'ha', // Hausa\n  'haw', // Hawaiian\n  'he', // Hebrew\n  'hi', // Hindi\n  'hmn', // Hmong\n  'hu', // Hungarian\n  'is', // Icelandic\n  'ig', // Igbo\n  'id', // Indonesian\n  'ga', // Irish\n  'it', // Italian\n  'ja', // Japanese\n  'jv', // Javanese\n  'kn', // Kannada\n  'kk', // Kazakh\n  'km', // Khmer\n  'rw', // Kinyarwanda\n  'ko', // Korean\n  'ku', // Kurdish\n  'ky', // Kyrgyz\n  'lo', // Lao\n  'la', // Latin\n  'lv', // Latvian\n  'lt', // Lithuanian\n  'lb', // Luxembourgish\n  'mk', // Macedonian\n  'mg', // Malagasy\n  'ms', // Malay\n  'ml', // Malayalam\n  'mt', // Maltese\n  'mi', // Maori\n  'mr', // Marathi\n  'mn', // Mongolian\n  'my', // Myanmar (Burmese)\n  'ne', // Nepali\n  'no', // Norwegian\n  'ny', // Nyanja (Chichewa)\n  'or', // Odia (Oriya)\n  'ps', // Pashto\n  'fa', // Persian\n  'pl', // Polish\n  'pt', // Portuguese\n  'pt_br', // Portuguese (Brazil)\n  'pa', // Punjabi\n  'ro', // Romanian\n  'ru', // Russian\n  'sm', // Samoan\n  'gd', // Scots Gaelic\n  'sr', // Serbian\n  'st', // Sesotho\n  'sn', // Shona\n  'sd', // Sindhi\n  'si', // Sinhala (Sinhalese)\n  'sk', // Slovak\n  'sl', // Slovenian\n  'so', // Somali\n  'es', // Spanish\n  'su', // Sundanese\n  'sw', // Swahili\n  'sv', // Swedish\n  'tl', // Tagalog (Filipino)\n  'tg', // Tajik\n  'ta', // Tamil\n  'tt', // Tatar\n  'te', // Telugu\n  'th', // Thai\n  'tr', // Turkish\n  'tk', // Turkmen\n  'uk', // Ukrainian\n  'ur', // Urdu\n  'ug', // Uyghur\n  'uz', // Uzbek\n  'vi', // Vietnamese\n  'cy', // Welsh\n  'xh', // Xhosa\n  'yi', // Yiddish\n  'yo', // Yoruba\n  'zu' // Zulu\n] as const;\n\n/**\n * All supported language codes (union of DeepL and Google Translate)\n */\nexport const SUPPORTED_LANGUAGES = Array.from(\n  new Set([...DEEPL_LANGUAGES, ...GOOGLE_LANGUAGES])\n).sort() as readonly string[];\n\nexport type DeepLLanguage = (typeof DEEPL_LANGUAGES)[number];\nexport type GoogleLanguage = (typeof GOOGLE_LANGUAGES)[number];\nexport type SupportedLanguage = (typeof SUPPORTED_LANGUAGES)[number];\n\n/**\n * JSON Schema for .translationsrc.json\n */\nexport const TRANSLATION_CONFIG_SCHEMA = {\n  title: 'Translation Configuration',\n  description: 'Configuration for the translation management system',\n  type: 'object',\n  properties: {\n    $schema: {\n      type: 'string',\n      description: 'JSON Schema reference'\n    },\n    translationsPath: {\n      type: 'string',\n      description: 'Path to the translations directory relative to project root',\n      default: 'public/static/locales',\n      examples: ['public/static/locales', 'src/locales', 'locales']\n    },\n    languages: {\n      type: 'array',\n      description: 'List of language codes to support',\n      items: {\n        type: 'string',\n        enum: SUPPORTED_LANGUAGES\n      },\n      minItems: 1,\n      uniqueItems: true,\n      default: ['en']\n    },\n    sourceLanguage: {\n      type: 'string',\n      description: 'Source language for translations (usually \"en\")',\n      enum: SUPPORTED_LANGUAGES,\n      default: 'en'\n    },\n    typesOutputPath: {\n      type: 'string',\n      description: 'Path to output TypeScript types file',\n      default: 'src/types/i18nTypes.ts',\n      examples: ['src/types/i18nTypes.ts', 'src/types/translations.ts']\n    },\n    provider: {\n      type: 'string',\n      description: 'Translation provider to use (deepl or google)',\n      enum: TRANSLATION_PROVIDERS,\n      default: 'deepl'\n    },\n    useFallbackLanguages: {\n      type: 'boolean',\n      description: 'Enable automatic language fallback for unsupported regional variants (e.g., de_at -> de)',\n      default: false\n    },\n    searchPaths: {\n      type: 'array',\n      description: 'Directories to search for translation key usage',\n      items: {\n        type: 'string'\n      },\n      default: ['src', 'app', 'pages', 'components']\n    },\n    searchExtensions: {\n      type: 'array',\n      description: 'File extensions to search for key usage',\n      items: {\n        type: 'string'\n      },\n      default: ['.ts', '.tsx', '.js', '.jsx', '.vue', '.svelte']\n    },\n    protectedTerms: {\n      type: 'array',\n      description: 'List of terms that should never be translated (e.g. brand names, technical terms)',\n      items: {\n        type: 'string'\n      },\n      default: []\n    }\n  },\n  required: ['translationsPath', 'languages', 'sourceLanguage'],\n  additionalProperties: false\n};\n\n/**\n * Validate if a language code is supported\n */\nexport function isValidLanguage(lang: string): lang is SupportedLanguage {\n  return SUPPORTED_LANGUAGES.includes(lang as SupportedLanguage);\n}\n\n/**\n * Validate if a language is supported by DeepL\n */\nexport function isValidDeepLLanguage(lang: string): lang is DeepLLanguage {\n  return DEEPL_LANGUAGES.includes(lang as DeepLLanguage);\n}\n\n/**\n * Validate if a language is supported by Google Translate\n */\nexport function isValidGoogleLanguage(lang: string): lang is GoogleLanguage {\n  return GOOGLE_LANGUAGES.includes(lang as GoogleLanguage);\n}\n\n/**\n * Validate if a language is supported by a specific provider\n */\nexport function isValidLanguageForProvider(lang: string, provider: TranslationProviderType): boolean {\n  switch (provider) {\n    case 'deepl':\n      return isValidDeepLLanguage(lang);\n    case 'google':\n      return isValidGoogleLanguage(lang);\n    default:\n      return false;\n  }\n}\n\n/**\n * Validate languages array\n */\nexport function validateLanguages(languages: string[]): {\n  valid: boolean;\n  invalid: string[];\n} {\n  const invalid = languages.filter((lang) => !isValidLanguage(lang));\n  return {\n    valid: !invalid.length,\n    invalid\n  };\n}\n\n/**\n * Validate languages array for a specific provider\n */\nexport function validateLanguagesForProvider(\n  languages: string[],\n  provider: TranslationProviderType\n): {\n  valid: boolean;\n  invalid: string[];\n} {\n  const invalid = languages.filter((lang) => !isValidLanguageForProvider(lang, provider));\n  return {\n    valid: !invalid.length,\n    invalid\n  };\n}\n\n/**\n * Get supported languages for a specific provider\n */\nexport function getSupportedLanguages(provider: TranslationProviderType): readonly string[] {\n  switch (provider) {\n    case 'deepl':\n      return DEEPL_LANGUAGES;\n    case 'google':\n      return GOOGLE_LANGUAGES;\n    default:\n      return [];\n  }\n}\n\n/**\n * Re-export language fallback utilities for convenience\n */\nexport {\n  getFallbackMappings,\n  type LanguageFallbackResult,\n  logLanguageFallback,\n  resolveLanguageWithFallback\n} from '../utils/language-fallback.js';\n"],"mappings":";AAIA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;;;ACHvB,IAAM,wBAAwB,CAAC,SAAS,QAAQ;AAOhD,IAAM,kBAAkB;AAAA,EAC7B;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF;AAOO,IAAM,mBAAmB;AAAA,EAC9B;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AAAA,EACA;AAAA;AACF;AAKO,IAAM,sBAAsB,MAAM;AAAA,EACvC,oBAAI,IAAI,CAAC,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AACnD,EAAE,KAAK;AASA,IAAM,4BAA4B;AAAA,EACvC,OAAO;AAAA,EACP,aAAa;AAAA,EACb,MAAM;AAAA,EACN,YAAY;AAAA,IACV,SAAS;AAAA,MACP,MAAM;AAAA,MACN,aAAa;AAAA,IACf;AAAA,IACA,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU,CAAC,yBAAyB,eAAe,SAAS;AAAA,IAC9D;AAAA,IACA,WAAW;AAAA,MACT,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,MACA,UAAU;AAAA,MACV,aAAa;AAAA,MACb,SAAS,CAAC,IAAI;AAAA,IAChB;AAAA,IACA,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA,iBAAiB;AAAA,MACf,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,MACT,UAAU,CAAC,0BAA0B,2BAA2B;AAAA,IAClE;AAAA,IACA,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,MAAM;AAAA,MACN,SAAS;AAAA,IACX;AAAA,IACA,sBAAsB;AAAA,MACpB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,MACR;AAAA,MACA,SAAS,CAAC,OAAO,OAAO,SAAS,YAAY;AAAA,IAC/C;AAAA,IACA,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,MACR;AAAA,MACA,SAAS,CAAC,OAAO,QAAQ,OAAO,QAAQ,QAAQ,SAAS;AAAA,IAC3D;AAAA,IACA,gBAAgB;AAAA,MACd,MAAM;AAAA,MACN,aAAa;AAAA,MACb,OAAO;AAAA,QACL,MAAM;AAAA,MACR;AAAA,MACA,SAAS,CAAC;AAAA,IACZ;AAAA,EACF;AAAA,EACA,UAAU,CAAC,oBAAoB,aAAa,gBAAgB;AAAA,EAC5D,sBAAsB;AACxB;;;AD7PA,IAAMA,cAAa,cAAc,YAAY,GAAG;AAChD,IAAMC,aAAY,QAAQD,WAAU;AAIpC,IAAM,cAAc,KAAKC,YAAW,OAAO;AAC3C,IAAM,qBAAqB,KAAK,aAAa,uDAAuD;AAEpG,IAAM,iBAAiB;AAAA,EACrB,SAAS;AAAA,EACT,KAAK;AAAA,EACL,GAAG;AACL;AAEA,cAAc,oBAAoB,GAAG,KAAK,UAAU,gBAAgB,MAAM,CAAC,CAAC;AAAA,CAAI;AAEhF,QAAQ,IAAI,kDAA6C;","names":["__filename","__dirname"]}

package/dist/scripts/verify-translations.js

@@ -2,11 +2,85 @@
 #!/usr/bin/env node
 
 // src/translations/cli/validate.ts
-import * as path3 from "path";
+import * as path4 from "path";
 
-// src/translations/utils/utils.ts
+// src/translations/utils/metadata.ts
+import { createHash } from "crypto";
 import * as fs from "fs";
 import * as path from "path";
+var METADATA_FILE_NAME = ".translations-meta.json";
+var CURRENT_VERSION = 1;
+function emptyMetadata() {
+  return { version: CURRENT_VERSION, languages: {} };
+}
+function hashSourceValue(value) {
+  return createHash("sha256").update(value).digest("hex").slice(0, 16);
+}
+function getMetadataPath(translationsPath) {
+  return path.join(translationsPath, METADATA_FILE_NAME);
+}
+function metadataExists(translationsPath) {
+  return fs.existsSync(getMetadataPath(translationsPath));
+}
+function readMetadata(translationsPath) {
+  const metadataPath = getMetadataPath(translationsPath);
+  if (!fs.existsSync(metadataPath)) {
+    return emptyMetadata();
+  }
+  try {
+    const parsed = JSON.parse(fs.readFileSync(metadataPath, "utf-8"));
+    return {
+      version: parsed.version ?? CURRENT_VERSION,
+      languages: parsed.languages ?? {}
+    };
+  } catch {
+    return emptyMetadata();
+  }
+}
+function writeMetadata(translationsPath, metadata) {
+  if (!fs.existsSync(translationsPath)) {
+    fs.mkdirSync(translationsPath, { recursive: true });
+  }
+  const metadataPath = getMetadataPath(translationsPath);
+  fs.writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}
+`, "utf-8");
+}
+function getSourceHash(metadata, language, namespace, key) {
+  return metadata.languages[language]?.[namespace]?.[key];
+}
+function pruneMetadata(metadata, sourceKeysByNamespace) {
+  let changed = false;
+  for (const language of Object.keys(metadata.languages)) {
+    const namespaces = metadata.languages[language];
+    for (const namespace of Object.keys(namespaces)) {
+      const sourceKeys = sourceKeysByNamespace[namespace];
+      if (!sourceKeys) {
+        delete namespaces[namespace];
+        changed = true;
+        continue;
+      }
+      for (const key of Object.keys(namespaces[namespace])) {
+        if (!sourceKeys.has(key)) {
+          delete namespaces[namespace][key];
+          changed = true;
+        }
+      }
+      if (Object.keys(namespaces[namespace]).length === 0) {
+        delete namespaces[namespace];
+        changed = true;
+      }
+    }
+    if (Object.keys(namespaces).length === 0) {
+      delete metadata.languages[language];
+      changed = true;
+    }
+  }
+  return changed;
+}
+
+// src/translations/utils/utils.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
 function flattenObject(obj, prefix = "") {
   const result = {};
   for (const [key, value] of Object.entries(obj)) {
@@ -23,16 +97,16 @@ function isNestedObject(obj) {
   return Object.values(obj).some((value) => typeof value === "object" && value !== null);
 }
 function readTranslations(translationsPath, language) {
-  const langPath = path.join(translationsPath, language);
-  if (!fs.existsSync(langPath)) {
+  const langPath = path2.join(translationsPath, language);
+  if (!fs2.existsSync(langPath)) {
     return {};
   }
-  const files = fs.readdirSync(langPath).filter((f) => f.endsWith(".json"));
+  const files = fs2.readdirSync(langPath).filter((f) => f.endsWith(".json"));
   const translations = {};
   for (const file of files) {
-    const namespace = path.basename(file, ".json");
-    const filePath = path.join(langPath, file);
-    const content = fs.readFileSync(filePath, "utf-8");
+    const namespace = path2.basename(file, ".json");
+    const filePath = path2.join(langPath, file);
+    const content = fs2.readFileSync(filePath, "utf-8");
     const parsed = JSON.parse(content);
     if (isNestedObject(parsed)) {
       translations[namespace] = flattenObject(parsed);
@@ -43,35 +117,35 @@ function readTranslations(translationsPath, language) {
   return translations;
 }
 function writeTranslation(translationsPath, language, namespace, translations) {
-  const langPath = path.join(translationsPath, language);
-  if (!fs.existsSync(langPath)) {
-    fs.mkdirSync(langPath, { recursive: true });
+  const langPath = path2.join(translationsPath, language);
+  if (!fs2.existsSync(langPath)) {
+    fs2.mkdirSync(langPath, { recursive: true });
   }
-  const filePath = path.join(langPath, `${namespace}.json`);
-  fs.writeFileSync(filePath, `${JSON.stringify(translations, null, 2)}
+  const filePath = path2.join(langPath, `${namespace}.json`);
+  fs2.writeFileSync(filePath, `${JSON.stringify(translations, null, 2)}
 `, "utf-8");
 }
 function getAvailableLanguages(translationsPath) {
-  if (!fs.existsSync(translationsPath)) {
+  if (!fs2.existsSync(translationsPath)) {
     return [];
   }
-  return fs.readdirSync(translationsPath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+  return fs2.readdirSync(translationsPath, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
 }
 function getNamespaces(translationsPath, language) {
-  const langPath = path.join(translationsPath, language);
-  if (!fs.existsSync(langPath)) {
+  const langPath = path2.join(translationsPath, language);
+  if (!fs2.existsSync(langPath)) {
     return [];
   }
-  return fs.readdirSync(langPath).filter((f) => f.endsWith(".json")).map((f) => path.basename(f, ".json"));
+  return fs2.readdirSync(langPath).filter((f) => f.endsWith(".json")).map((f) => path2.basename(f, ".json"));
 }
 function ensureTranslationsStructure(translationsPath, languages) {
-  if (!fs.existsSync(translationsPath)) {
-    fs.mkdirSync(translationsPath, { recursive: true });
+  if (!fs2.existsSync(translationsPath)) {
+    fs2.mkdirSync(translationsPath, { recursive: true });
   }
   for (const lang of languages) {
-    const langPath = path.join(translationsPath, lang);
-    if (!fs.existsSync(langPath)) {
-      fs.mkdirSync(langPath, { recursive: true });
+    const langPath = path2.join(translationsPath, lang);
+    if (!fs2.existsSync(langPath)) {
+      fs2.mkdirSync(langPath, { recursive: true });
     }
   }
 }
@@ -102,8 +176,8 @@ function syncTranslationStructure(translationsPath, languages, sourceLanguage) {
     const targetNamespaces = getNamespaces(translationsPath, language);
     for (const namespace of targetNamespaces) {
       if (!sourceNamespaces.includes(namespace)) {
-        const filePath = path.join(translationsPath, language, `${namespace}.json`);
-        fs.unlinkSync(filePath);
+        const filePath = path2.join(translationsPath, language, `${namespace}.json`);
+        fs2.unlinkSync(filePath);
         result.removedNamespaces.push({
           language,
           namespace,
@@ -112,9 +186,9 @@ function syncTranslationStructure(translationsPath, languages, sourceLanguage) {
       }
     }
     for (const namespace of sourceNamespaces) {
-      const filePath = path.join(translationsPath, language, `${namespace}.json`);
+      const filePath = path2.join(translationsPath, language, `${namespace}.json`);
       const sourceFile = sourceTranslations[namespace] || {};
-      if (fs.existsSync(filePath)) {
+      if (fs2.existsSync(filePath)) {
         const targetFile = targetTranslations[namespace] || {};
         let hasOrphanedKeys = false;
         const cleanedFile = {};
@@ -154,12 +228,22 @@ function syncTranslationStructure(translationsPath, languages, sourceLanguage) {
       });
     }
   }
+  if (metadataExists(translationsPath)) {
+    const sourceKeysByNamespace = {};
+    for (const namespace of sourceNamespaces) {
+      sourceKeysByNamespace[namespace] = new Set(Object.keys(sourceTranslations[namespace] || {}));
+    }
+    const metadata = readMetadata(translationsPath);
+    if (pruneMetadata(metadata, sourceKeysByNamespace)) {
+      writeMetadata(translationsPath, metadata);
+    }
+  }
   return result;
 }
 
 // src/translations/cli/init.ts
-import * as fs2 from "fs";
-import * as path2 from "path";
+import * as fs3 from "fs";
+import * as path3 from "path";
 
 // src/translations/core/schema.ts
 var DEEPL_LANGUAGES = [
@@ -499,8 +583,8 @@ var DEFAULT_CONFIG = {
 function detectExistingTranslations(projectRoot) {
   const possiblePaths = ["public/static/locales", "public/locales", "src/locales", "locales", "i18n", "translations"];
   for (const possiblePath of possiblePaths) {
-    const fullPath = path2.join(projectRoot, possiblePath);
-    if (fs2.existsSync(fullPath)) {
+    const fullPath = path3.join(projectRoot, possiblePath);
+    if (fs3.existsSync(fullPath)) {
       const languages = getAvailableLanguages(fullPath);
       if (languages.length > 0) {
         return { path: possiblePath, languages };
@@ -510,8 +594,8 @@ function detectExistingTranslations(projectRoot) {
   return { path: null, languages: [] };
 }
 function loadConfig(projectRoot) {
-  const configPath = path2.join(projectRoot, ".translationsrc.json");
-  if (!fs2.existsSync(configPath)) {
+  const configPath = path3.join(projectRoot, ".translationsrc.json");
+  if (!fs3.existsSync(configPath)) {
     const existing = detectExistingTranslations(projectRoot);
     if (existing.path && existing.languages.length > 0) {
       console.log(`\u2139\uFE0F  No config found, but detected translations at ${existing.path}`);
@@ -523,7 +607,7 @@ function loadConfig(projectRoot) {
     }
     return DEFAULT_CONFIG;
   }
-  const configContent = fs2.readFileSync(configPath, "utf-8");
+  const configContent = fs3.readFileSync(configPath, "utf-8");
   const config = JSON.parse(configContent);
   if (config.languages) {
     const validation = validateLanguages(config.languages);
@@ -538,13 +622,15 @@ function loadConfig(projectRoot) {
 // src/translations/cli/validate.ts
 function validateTranslations(projectRoot = process.cwd()) {
   const config = loadConfig(projectRoot);
-  const translationsPath = path3.join(projectRoot, config.translationsPath);
+  const translationsPath = path4.join(projectRoot, config.translationsPath);
   const sourceLanguage = config.sourceLanguage;
   const missing = [];
   const empty = [];
   const orphaned = [];
+  const stale = [];
   const sourceTranslations = readTranslations(translationsPath, sourceLanguage);
   const sourceNamespaces = getNamespaces(translationsPath, sourceLanguage);
+  const metadata = readMetadata(translationsPath);
   const languages = config.languages.filter((lang) => lang !== sourceLanguage);
   const syncResult = syncTranslationStructure(translationsPath, config.languages, sourceLanguage);
   if (syncResult.createdFiles.length > 0) {
@@ -581,6 +667,17 @@ function validateTranslations(projectRoot = process.cwd()) {
             language,
             sourceValue
           });
+        } else if (typeof targetValue === "string") {
+          const recordedHash = getSourceHash(metadata, language, namespace, key);
+          if (recordedHash !== void 0 && recordedHash !== hashSourceValue(sourceValue)) {
+            stale.push({
+              namespace,
+              key,
+              language,
+              sourceValue,
+              currentValue: targetValue
+            });
+          }
         }
       }
       for (const [key, targetValue] of Object.entries(targetKeys)) {
@@ -596,7 +693,7 @@ function validateTranslations(projectRoot = process.cwd()) {
     }
   }
   const valid = !missing.length && !empty.length && !orphaned.length;
-  if (valid) {
+  if (valid && !stale.length) {
     console.log("\u2713 All translations are valid!");
   } else {
     if (missing.length > 0) {
@@ -629,9 +726,22 @@ function validateTranslations(projectRoot = process.cwd()) {
         console.log(`  ... and ${orphaned.length - 10} more`);
       }
     }
+    if (stale.length > 0) {
+      console.log(
+        `
+\u26A0 Found ${stale.length} potentially outdated translations (source value changed since translation):`
+      );
+      for (const item of stale.slice(0, 10)) {
+        console.log(`  ${item.language}/${item.namespace}.json -> ${item.key}`);
+      }
+      if (stale.length > 10) {
+        console.log(`  ... and ${stale.length - 10} more`);
+      }
+      console.log("  Run auto-fill with --retranslate-changed to update them.");
+    }
   }
   console.log("=====");
-  return { valid, missing, empty, orphaned };
+  return { valid, missing, empty, orphaned, stale };
 }
 
 // src/scripts/verify-translations.ts