[{"data":1,"prerenderedAt":632},["ShallowReactive",2],{"navigation_docs":3,"-configuration-precedence":357,"-configuration-precedence-surround":629},[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":117,"body":359,"description":373,"extension":622,"links":623,"meta":624,"navigation":625,"path":118,"seo":626,"stem":119,"__hash__":628},"docs\u002F5.configuration\u002F2.precedence.md",{"type":360,"value":361,"toc":615},"minimark",[362,366,390,398,405,420,425,428,510,513,517,531,545,551,562,577,581,603,611],[363,364,365],"p",{},"Declare the same key in both config files and the kit stops and names both\nrather than picking a winner. No merge, no \"the typed config wins\", no order to\nremember. Delete the duplicate from one of them.",[367,368,374],"pre",{"className":369,"code":370,"filename":371,"language":372,"meta":373,"style":373},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","the-i18n-cli status\n","Terminal","bash","",[375,376,377],"code",{"__ignoreMap":373},[378,379,382,386],"span",{"class":380,"line":381},"line",1,[378,383,385],{"class":384},"sBMFI","the-i18n-cli",[378,387,389],{"class":388},"sfazB"," status\n",[367,391,396],{"className":392,"code":394,"language":395,"meta":373},[393],"language-text"," ERROR  defaultLocale is declared in both\n  \u002Fapp\u002Fi18n-kit.config.ts\n  \u002Fapp\u002F.i18n-mcp.json\nNeither wins — a reader cannot tell which one took effect. Delete the duplicate from one of them.\n","text",[375,397,394],{"__ignoreMap":373},[363,399,400,401,404],{},"The command exits 1 without doing any work, and the same message comes back as a\nmachine-readable error object carrying the code ",[375,402,403],{},"CONFIG_ERROR",", so an agent gets\nthe file paths rather than a truncated stack.",[363,406,407,408,411,412,415,416,419],{},"Two files may both exist. What is rejected is the same key in both — the check\ncompares the keys that are actually present, ignoring the JSON-only ",[375,409,410],{},"$schema",".\nSplit by key and both files are read: ",[375,413,414],{},"glossary"," in one and ",[375,417,418],{},"protectedLocales","\nin the other works, because the two sets are disjoint and there is nothing to\nchoose between.",[421,422,424],"h2",{"id":423},"where-precedence-is-resolved","Where Precedence Is Resolved",[363,426,427],{},"Two hand-written files are at the same level, so neither wins. Precedence is\nresolved only between sources at different levels:",[429,430,431,447],"table",{},[432,433,434],"thead",{},[435,436,437,441,444],"tr",{},[438,439,440],"th",{},"Sources",[438,442,443],{},"Winner",[438,445,446],{},"Why the ordering is obvious",[448,449,450,473,484,499],"tbody",{},[435,451,452,467,470],{},[453,454,455,458,459,462,463,466],"td",{},[375,456,457],{},"--baseUrl"," flag, ",[375,460,461],{},"I18N_BASE_URL",", ",[375,464,465],{},"providerBaseUrl"," in config",[453,468,469],{},"Flag, then env var, then config",[453,471,472],{},"A flag is typed for this run; config is the standing default",[435,474,475,478,481],{},[453,476,477],{},"Declared config vs. a value read out of a framework's config file",[453,479,480],{},"Declared",[453,482,483],{},"You wrote one of them for the kit specifically",[435,485,486,489,492],{},[453,487,488],{},"A config in an app directory vs. one in the repository root",[453,490,491],{},"The nearest one, outright",[453,493,494,495,498],{},"The same rule ESLint and ",[375,496,497],{},"tsconfig.json"," use",[435,500,501,504,507],{},[453,502,503],{},"Locale directory probing vs. a directory named in a framework config",[453,505,506],{},"The framework config",[453,508,509],{},"It states where the files are; probing guesses",[363,511,512],{},"Blank values count as unset in the base URL chain, so an unset shell variable\nexpanding to an empty string does not shadow the config below it.",[421,514,516],{"id":515},"nuxt-checked-at-build-time","Nuxt: Checked at Build Time",[363,518,519,522,523,526,527,530],{},[375,520,521],{},"@the-i18n-kit\u002Fnuxt"," validates your config during the build, where a diagnostic\nlands next to the code that caused it. It reads every place policy can be\ndeclared — both ",[375,524,525],{},"i18n-kit.config.*"," and ",[375,528,529],{},".i18n-mcp.json"," — so a key declared\ntwice fails the build rather than being discovered later by a command.",[363,532,533,534,462,537,540,541,544],{},"The module also rejects the keys it derives. ",[375,535,536],{},"locales",[375,538,539],{},"localeDirs"," and\n",[375,542,543],{},"defaultLocale"," in a hand-written config are an error in a Nuxt project, because\nNuxt already answers them and keeping both means two sources of truth with no\nway to tell which won:",[367,546,549],{"className":547,"code":548,"language":395,"meta":373},[393],"ERROR  \"defaultLocale\" is derived from your Nuxt config. Remove it from\n.i18n-mcp.json — this module publishes what Nuxt resolved.\n",[375,550,548],{"__ignoreMap":373},[363,552,553,554,557,558,561],{},"The build then fails, listing every problem it found. Set\n",[375,555,556],{},"i18nKit.failOnInvalidConfig"," to ",[375,559,560],{},"false"," to report without failing — the\ndiagnostics are still printed; the flag only decides whether they stop you.",[563,564,565,566,569,570,526,573,576],"note",{},"Policy itself is not declared in ",[375,567,568],{},"nuxt.config.ts",". The module's options are\n",[375,571,572],{},"enabled",[375,574,575],{},"failOnInvalidConfig","; everything else lives in one of the two\nconfig files, which the CLI reads directly.",[421,578,580],{"id":579},"limits","Limits",[582,583,584,591,594,600],"ul",{},[585,586,587,588,590],"li",{},"The conflict check is per key, not per subkey. Declaring ",[375,589,414],{}," in both\nfiles is an error even when the two objects contain different terms; there is\nno per-term merge.",[585,592,593],{},"The error names the two files and the offending keys, not the line numbers.",[585,595,596,597,599],{},"Multiple ",[375,598,525],{}," files in one directory are a warning rather than\nan error: the first by extension order is used and the others are named as\nignored.",[585,601,602],{},"Nothing checks across directories. A config in an app directory shadows the\nroot one silently — the root file is not read at all, so a key in it cannot\nconflict with anything.",[363,604,605,606,610],{},"Next: which values the kit reads out of your framework's own files rather than\nyou writing them — see\n",[607,608,609],"a",{"href":122},"declared vs. derived config",".",[612,613,614],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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":373,"searchDepth":616,"depth":616,"links":617},3,[618,620,621],{"id":423,"depth":619,"text":424},2,{"id":515,"depth":619,"text":516},{"id":579,"depth":619,"text":580},"md",null,{},true,{"description":627,"title":117},"A key declared in two places is an error naming both, not a silent merge — and where the kit does resolve precedence instead.","fH0bXeMvGmqtWGkEw4yrM4y_zDlCFd-Sz62Ot_3CH0U",[630,631],{"title":113,"path":114,"stem":115,"description":373,"children":-1},{"title":121,"path":122,"stem":123,"description":373,"children":-1},1787604651263]