[{"data":1,"prerenderedAt":724},["ShallowReactive",2],{"navigation_docs":3,"-frameworks-generic":357,"-frameworks-generic-surround":721},[4,22,40,53,78,107,132,153,167,176,347],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Introduction","\u002Fintroduction","1.introduction",[9,13,17],{"title":10,"path":11,"stem":12},"Why the-i18n-kit","\u002Fintroduction\u002Fwhy","1.introduction\u002F1.why",{"title":14,"path":15,"stem":16},"Architecture","\u002Fintroduction\u002Farchitecture","1.introduction\u002F2.architecture",{"title":18,"path":19,"stem":20},"Built for Agents","\u002Fintroduction\u002Fbuilt-for-agents","1.introduction\u002F3.built-for-agents",false,{"title":23,"icon":24,"path":25,"stem":26,"children":27,"page":21},"ESLint Plugin","i-lucide-shield-check","\u002Feslint-plugin","10.eslint-plugin",[28,32,36],{"title":29,"path":30,"stem":31},"Install and Presets","\u002Feslint-plugin\u002Finstall","10.eslint-plugin\u002F1.install",{"title":33,"path":34,"stem":35},"The Rules","\u002Feslint-plugin\u002Frules","10.eslint-plugin\u002F2.rules",{"title":37,"path":38,"stem":39},"Layer-Aware Missing Keys","\u002Feslint-plugin\u002Flayer-aware","10.eslint-plugin\u002F3.layer-aware",{"title":41,"path":42,"stem":43,"children":44,"page":21},"Getting Started","\u002Fgetting-started","2.getting-started",[45,49],{"title":46,"path":47,"stem":48},"Set Up the MCP Server","\u002Fgetting-started\u002Fagent-setup","2.getting-started\u002F1.agent-setup",{"title":50,"path":51,"stem":52},"From an Unconfigured Repository to a Gated CI Job","\u002Fgetting-started\u002Fcold-start","2.getting-started\u002F2.cold-start",{"title":54,"path":55,"stem":56,"children":57,"page":21},"Monorepos","\u002Fmonorepos","3.monorepos",[58,62,66,70,74],{"title":59,"path":60,"stem":61},"Layers","\u002Fmonorepos\u002Flayers","3.monorepos\u002F1.layers",{"title":63,"path":64,"stem":65},"The Consumer Graph","\u002Fmonorepos\u002Fconsumer-graph","3.monorepos\u002F2.consumer-graph",{"title":67,"path":68,"stem":69},"The Shared Library Scenario","\u002Fmonorepos\u002Fshared-libraries","3.monorepos\u002F3.shared-libraries",{"title":71,"path":72,"stem":73},"Duplicates and Divergence","\u002Fmonorepos\u002Fduplicates-and-divergence","3.monorepos\u002F4.duplicates-and-divergence",{"title":75,"path":76,"stem":77},"Misplaced Usages","\u002Fmonorepos\u002Fmisplaced-usages","3.monorepos\u002F5.misplaced-usages",{"title":79,"path":80,"stem":81,"children":82,"page":21},"Frameworks","\u002Fframeworks","4.frameworks",[83,87,91,95,99,103],{"title":84,"path":85,"stem":86},"Detection","\u002Fframeworks\u002Fdetection","4.frameworks\u002F1.detection",{"title":88,"path":89,"stem":90},"Nuxt","\u002Fframeworks\u002Fnuxt","4.frameworks\u002F2.nuxt",{"title":92,"path":93,"stem":94},"Laravel","\u002Fframeworks\u002Flaravel","4.frameworks\u002F3.laravel",{"title":96,"path":97,"stem":98},"Vue","\u002Fframeworks\u002Fvue","4.frameworks\u002F4.vue",{"title":100,"path":101,"stem":102},"React \u002F Next.js","\u002Fframeworks\u002Freact-next","4.frameworks\u002F5.react-next",{"title":104,"path":105,"stem":106},"Generic","\u002Fframeworks\u002Fgeneric","4.frameworks\u002F6.generic",{"title":108,"path":109,"stem":110,"children":111,"page":21},"Configuration","\u002Fconfiguration","5.configuration",[112,116,120,124,128],{"title":113,"path":114,"stem":115},"Where Configuration Lives","\u002Fconfiguration\u002Fwhere-config-lives","5.configuration\u002F1.where-config-lives",{"title":117,"path":118,"stem":119},"Precedence and Conflicts","\u002Fconfiguration\u002Fprecedence","5.configuration\u002F2.precedence",{"title":121,"path":122,"stem":123},"Declared vs. Derived Configuration","\u002Fconfiguration\u002Fdeclared-vs-derived","5.configuration\u002F3.declared-vs-derived",{"title":125,"path":126,"stem":127},"Configuration Fields","\u002Fconfiguration\u002Freference","5.configuration\u002F4.reference",{"title":129,"path":130,"stem":131},"Referring to Locales","\u002Fconfiguration\u002Flocale-refs","5.configuration\u002F5.locale-refs",{"title":133,"path":134,"stem":135,"children":136,"page":21},"Nuxt Module","\u002Fnuxt-module","6.nuxt-module",[137,141,145,149],{"title":138,"path":139,"stem":140},"Install and Setup","\u002Fnuxt-module\u002Finstall","6.nuxt-module\u002F1.install",{"title":142,"path":143,"stem":144},"What It Publishes","\u002Fnuxt-module\u002Fwhat-it-publishes","6.nuxt-module\u002F2.what-it-publishes",{"title":146,"path":147,"stem":148},"What It Validates","\u002Fnuxt-module\u002Fvalidation","6.nuxt-module\u002F3.validation",{"title":150,"path":151,"stem":152},"Options and Limits","\u002Fnuxt-module\u002Foptions-and-limits","6.nuxt-module\u002F4.options-and-limits",{"title":154,"icon":155,"path":156,"stem":157,"children":158,"page":21},"CI\u002FCD","i-lucide-git-pull-request","\u002Fci-cd","7.ci-cd",[159,163],{"title":160,"path":161,"stem":162},"GitHub Actions","\u002Fci-cd\u002Fgithub-actions","7.ci-cd\u002F1.github-actions",{"title":164,"path":165,"stem":166},"GitLab CI","\u002Fci-cd\u002Fgitlab-ci","7.ci-cd\u002F2.gitlab-ci",{"title":168,"path":169,"stem":170,"children":171,"page":21},"Concepts","\u002Fconcepts","8.concepts",[172],{"title":173,"path":174,"stem":175},"Translation Modes","\u002Fconcepts\u002Ftranslation-modes","8.concepts\u002F1.translation-modes",{"title":177,"path":178,"stem":179,"children":180},"Reference","\u002Freference","9.reference",[181,183,261,339,343],{"title":177,"path":178,"stem":182},"9.reference\u002Findex",{"title":184,"path":185,"stem":186,"children":187},"CLI Commands","\u002Freference\u002Fcli","9.reference\u002F1.cli\u002Findex",[188,189,193,197,201,205,209,213,217,221,225,229,233,237,241,245,249,253,257],{"title":184,"path":185,"stem":186},{"title":190,"path":191,"stem":192},"add","\u002Freference\u002Fcli\u002Fadd","9.reference\u002F1.cli\u002Fadd",{"title":194,"path":195,"stem":196},"check","\u002Freference\u002Fcli\u002Fcheck","9.reference\u002F1.cli\u002Fcheck",{"title":198,"path":199,"stem":200},"find-duplicates","\u002Freference\u002Fcli\u002Ffind-duplicates","9.reference\u002F1.cli\u002Ffind-duplicates",{"title":202,"path":203,"stem":204},"get","\u002Freference\u002Fcli\u002Fget","9.reference\u002F1.cli\u002Fget",{"title":206,"path":207,"stem":208},"init","\u002Freference\u002Fcli\u002Finit","9.reference\u002F1.cli\u002Finit",{"title":210,"path":211,"stem":212},"missing","\u002Freference\u002Fcli\u002Fmissing","9.reference\u002F1.cli\u002Fmissing",{"title":214,"path":215,"stem":216},"move","\u002Freference\u002Fcli\u002Fmove","9.reference\u002F1.cli\u002Fmove",{"title":218,"path":219,"stem":220},"remove","\u002Freference\u002Fcli\u002Fremove","9.reference\u002F1.cli\u002Fremove",{"title":222,"path":223,"stem":224},"remove-orphans","\u002Freference\u002Fcli\u002Fremove-orphans","9.reference\u002F1.cli\u002Fremove-orphans",{"title":226,"path":227,"stem":228},"rename","\u002Freference\u002Fcli\u002Frename","9.reference\u002F1.cli\u002Frename",{"title":230,"path":231,"stem":232},"scaffold","\u002Freference\u002Fcli\u002Fscaffold","9.reference\u002F1.cli\u002Fscaffold",{"title":234,"path":235,"stem":236},"scan","\u002Freference\u002Fcli\u002Fscan","9.reference\u002F1.cli\u002Fscan",{"title":238,"path":239,"stem":240},"search","\u002Freference\u002Fcli\u002Fsearch","9.reference\u002F1.cli\u002Fsearch",{"title":242,"path":243,"stem":244},"status","\u002Freference\u002Fcli\u002Fstatus","9.reference\u002F1.cli\u002Fstatus",{"title":246,"path":247,"stem":248},"translate","\u002Freference\u002Fcli\u002Ftranslate","9.reference\u002F1.cli\u002Ftranslate",{"title":250,"path":251,"stem":252},"translate-key","\u002Freference\u002Fcli\u002Ftranslate-key","9.reference\u002F1.cli\u002Ftranslate-key",{"title":254,"path":255,"stem":256},"update","\u002Freference\u002Fcli\u002Fupdate","9.reference\u002F1.cli\u002Fupdate",{"title":258,"path":259,"stem":260},"write","\u002Freference\u002Fcli\u002Fwrite","9.reference\u002F1.cli\u002Fwrite",{"title":262,"path":263,"stem":264,"children":265},"MCP Tools","\u002Freference\u002Fmcp","9.reference\u002F2.mcp\u002Findex",[266,267,271,275,279,283,287,291,295,299,303,307,311,315,319,323,327,331,335],{"title":262,"path":263,"stem":264},{"title":268,"path":269,"stem":270},"discover","\u002Freference\u002Fmcp\u002Fdiscover","9.reference\u002F2.mcp\u002Fdiscover",{"title":272,"path":273,"stem":274},"find_duplicate_keys","\u002Freference\u002Fmcp\u002Ffind_duplicate_keys","9.reference\u002F2.mcp\u002Ffind_duplicate_keys",{"title":276,"path":277,"stem":278},"find_empty_translations","\u002Freference\u002Fmcp\u002Ffind_empty_translations","9.reference\u002F2.mcp\u002Ffind_empty_translations",{"title":280,"path":281,"stem":282},"find_orphan_keys","\u002Freference\u002Fmcp\u002Ffind_orphan_keys","9.reference\u002F2.mcp\u002Ffind_orphan_keys",{"title":284,"path":285,"stem":286},"find_undefined_keys","\u002Freference\u002Fmcp\u002Ffind_undefined_keys","9.reference\u002F2.mcp\u002Ffind_undefined_keys",{"title":288,"path":289,"stem":290},"get_missing_translations","\u002Freference\u002Fmcp\u002Fget_missing_translations","9.reference\u002F2.mcp\u002Fget_missing_translations",{"title":292,"path":293,"stem":294},"get_translation_status","\u002Freference\u002Fmcp\u002Fget_translation_status","9.reference\u002F2.mcp\u002Fget_translation_status",{"title":296,"path":297,"stem":298},"get_translations","\u002Freference\u002Fmcp\u002Fget_translations","9.reference\u002F2.mcp\u002Fget_translations",{"title":300,"path":301,"stem":302},"list_namespaces","\u002Freference\u002Fmcp\u002Flist_namespaces","9.reference\u002F2.mcp\u002Flist_namespaces",{"title":304,"path":305,"stem":306},"move_translation_key","\u002Freference\u002Fmcp\u002Fmove_translation_key","9.reference\u002F2.mcp\u002Fmove_translation_key",{"title":308,"path":309,"stem":310},"remove_orphan_keys","\u002Freference\u002Fmcp\u002Fremove_orphan_keys","9.reference\u002F2.mcp\u002Fremove_orphan_keys",{"title":312,"path":313,"stem":314},"remove_translations","\u002Freference\u002Fmcp\u002Fremove_translations","9.reference\u002F2.mcp\u002Fremove_translations",{"title":316,"path":317,"stem":318},"rename_translation_key","\u002Freference\u002Fmcp\u002Frename_translation_key","9.reference\u002F2.mcp\u002Frename_translation_key",{"title":320,"path":321,"stem":322},"scaffold_locale","\u002Freference\u002Fmcp\u002Fscaffold_locale","9.reference\u002F2.mcp\u002Fscaffold_locale",{"title":324,"path":325,"stem":326},"search_translations","\u002Freference\u002Fmcp\u002Fsearch_translations","9.reference\u002F2.mcp\u002Fsearch_translations",{"title":328,"path":329,"stem":330},"translate_key","\u002Freference\u002Fmcp\u002Ftranslate_key","9.reference\u002F2.mcp\u002Ftranslate_key",{"title":332,"path":333,"stem":334},"translate_missing","\u002Freference\u002Fmcp\u002Ftranslate_missing","9.reference\u002F2.mcp\u002Ftranslate_missing",{"title":336,"path":337,"stem":338},"write_translations","\u002Freference\u002Fmcp\u002Fwrite_translations","9.reference\u002F2.mcp\u002Fwrite_translations",{"title":340,"path":341,"stem":342},"GitHub Action","\u002Freference\u002Faction","9.reference\u002F3.action",{"title":344,"path":345,"stem":346},"Programmatic API","\u002Freference\u002Fprogrammatic-api","9.reference\u002F4.programmatic-api",{"title":348,"icon":349,"path":350,"stem":351,"children":352,"page":21},"Extra Topics","i-lucide-microscope","\u002Fextra-topics","91.extra-topics",[353],{"title":354,"path":355,"stem":356},"How Detection Scores Adapters","\u002Fextra-topics\u002Fdetection-scoring","91.extra-topics\u002F1.detection-scoring",{"id":358,"title":104,"body":359,"description":398,"extension":715,"links":716,"meta":717,"navigation":439,"path":105,"seo":718,"stem":106,"__hash__":720},"docs\u002F4.frameworks\u002F6.generic.md",{"type":360,"value":361,"toc":711},"minimark",[362,383,391,588,602,607,610,670,674,707],[363,364,365,366,370,371,374,375,379,380,382],"p",{},"The generic adapter runs any project whose locale files you can name: Svelte, Astro, Rails, a design system package, a monorepo of shared catalogs, or a framework the kit has never heard of. Declare both ",[367,368,369],"code",{},"localeDirs"," and ",[367,372,373],{},"defaultLocale"," in your ",[376,377,378],"a",{"href":114},"kit config"," — one key without the other does nothing — and those exact paths are used, resolved against the project directory. A path that does not exist is an error naming it. This is not a fallback the other adapters fall through to: declaring both keys on a Next.js or Vue project takes the project away from that framework's adapter, see ",[376,381,84],{"href":85},".",[363,384,385,386,390],{},"A ",[387,388,389],"strong",{},"layer"," is a scoped locale directory — a Nuxt layer, a workspace package, a shared UI library, or one app in a monorepo. You get one per entry, and this is the one adapter where you name them yourself:",[392,393,399],"pre",{"className":394,"code":395,"filename":396,"language":397,"meta":398,"style":398},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineI18nKitConfig } from '@the-i18n-kit\u002Fcli\u002Fconfig'\n\nexport default defineI18nKitConfig({\n  defaultLocale: 'en',\n  localeDirs: [\n    'apps\u002Fweb\u002Flocales',\n    { path: 'packages\u002Fui\u002Flocales', layer: 'ui' },\n    { path: 'packages\u002Femails\u002Flocales', layer: 'emails' },\n  ],\n})\n","i18n-kit.config.ts","ts","",[367,400,401,434,441,459,480,491,504,540,571,579],{"__ignoreMap":398},[402,403,406,410,414,418,421,424,427,431],"span",{"class":404,"line":405},"line",1,[402,407,409],{"class":408},"s7zQu","import",[402,411,413],{"class":412},"sMK4o"," {",[402,415,417],{"class":416},"sTEyZ"," defineI18nKitConfig",[402,419,420],{"class":412}," }",[402,422,423],{"class":408}," from",[402,425,426],{"class":412}," '",[402,428,430],{"class":429},"sfazB","@the-i18n-kit\u002Fcli\u002Fconfig",[402,432,433],{"class":412},"'\n",[402,435,437],{"class":404,"line":436},2,[402,438,440],{"emptyLinePlaceholder":439},true,"\n",[402,442,444,447,450,453,456],{"class":404,"line":443},3,[402,445,446],{"class":408},"export",[402,448,449],{"class":408}," default",[402,451,417],{"class":452},"s2Zo4",[402,454,455],{"class":416},"(",[402,457,458],{"class":412},"{\n",[402,460,462,466,469,471,474,477],{"class":404,"line":461},4,[402,463,465],{"class":464},"swJcz","  defaultLocale",[402,467,468],{"class":412},":",[402,470,426],{"class":412},[402,472,473],{"class":429},"en",[402,475,476],{"class":412},"'",[402,478,479],{"class":412},",\n",[402,481,483,486,488],{"class":404,"line":482},5,[402,484,485],{"class":464},"  localeDirs",[402,487,468],{"class":412},[402,489,490],{"class":416}," [\n",[402,492,494,497,500,502],{"class":404,"line":493},6,[402,495,496],{"class":412},"    '",[402,498,499],{"class":429},"apps\u002Fweb\u002Flocales",[402,501,476],{"class":412},[402,503,479],{"class":412},[402,505,507,510,513,515,517,520,522,525,528,530,532,535,537],{"class":404,"line":506},7,[402,508,509],{"class":412},"    {",[402,511,512],{"class":464}," path",[402,514,468],{"class":412},[402,516,426],{"class":412},[402,518,519],{"class":429},"packages\u002Fui\u002Flocales",[402,521,476],{"class":412},[402,523,524],{"class":412},",",[402,526,527],{"class":464}," layer",[402,529,468],{"class":412},[402,531,426],{"class":412},[402,533,534],{"class":429},"ui",[402,536,476],{"class":412},[402,538,539],{"class":412}," },\n",[402,541,543,545,547,549,551,554,556,558,560,562,564,567,569],{"class":404,"line":542},8,[402,544,509],{"class":412},[402,546,512],{"class":464},[402,548,468],{"class":412},[402,550,426],{"class":412},[402,552,553],{"class":429},"packages\u002Femails\u002Flocales",[402,555,476],{"class":412},[402,557,524],{"class":412},[402,559,527],{"class":464},[402,561,468],{"class":412},[402,563,426],{"class":412},[402,565,566],{"class":429},"emails",[402,568,476],{"class":412},[402,570,539],{"class":412},[402,572,574,577],{"class":404,"line":573},9,[402,575,576],{"class":416},"  ]",[402,578,479],{"class":412},[402,580,582,585],{"class":404,"line":581},10,[402,583,584],{"class":412},"}",[402,586,587],{"class":416},")\n",[363,589,590,591,594,595,598,599,382],{},"Those names are what ",[367,592,593],{},"--layer"," accepts and what per-layer reports are keyed by, so choose them deliberately. A plain string entry is named ",[367,596,597],{},"default",". The same shape works in ",[367,600,601],{},".i18n-mcp.json",[603,604,606],"h2",{"id":605},"overrides","Overrides",[363,608,609],{},"Beyond the two required keys:",[611,612,613,626],"table",{},[614,615,616],"thead",{},[617,618,619,623],"tr",{},[620,621,622],"th",{},"What you want",[620,624,625],{},"How",[627,628,629,640,650],"tbody",{},[617,630,631,635],{},[632,633,634],"td",{},"A fixed locale list instead of discovery",[632,636,637],{},[367,638,639],{},"locales",[617,641,642,645],{},[632,643,644],{},"Pin the adapter, so a later dependency change cannot move the project",[632,646,647],{},[367,648,649],{},"framework: 'generic'",[617,651,652,655],{},[632,653,654],{},"Authoring context for translation",[632,656,657,660,661,660,664,660,667],{},[367,658,659],{},"context",", ",[367,662,663],{},"glossary",[367,665,666],{},"localeNotes",[367,668,669],{},"translationPrompt",[603,671,673],{"id":672},"limits","Limits",[675,676,677,692,701],"ul",{},[678,679,680,683,684,687,688,691],"li",{},[387,681,682],{},"The file format is inferred from the first locale directory only."," A set of directories in mixed formats resolves as whatever the first one looks like, and ",[367,685,686],{},"localeFileFormat"," is honored by the ",[376,689,690],{"href":93},"Laravel adapter",", not this one.",[678,693,694,697,698,700],{},[387,695,696],{},"Locale codes are unioned across directories."," A directory holding a deliberate subset needs ",[367,699,639],{}," declared, or its absent codes are reported as missing.",[678,702,703,706],{},[387,704,705],{},"Paths resolve against the project directory."," Commit relative paths; an absolute path in a committed config works for its author only.",[708,709,710],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":398,"searchDepth":443,"depth":443,"links":712},[713,714],{"id":605,"depth":436,"text":606},{"id":672,"depth":436,"text":673},"md",null,{},{"description":719,"title":104},"How to point the kit at any project by declaring locale directories, how layers are named, and how the file format is inferred.","H3PM9u5MaNUEkV9gVnquzG1UrYjVXKoN6OEdmLvuiZU",[722,723],{"title":100,"path":101,"stem":102,"description":398,"children":-1},{"title":113,"path":114,"stem":115,"description":398,"children":-1},1787604650989]