mirror of
https://github.com/4gray/iptvnator.git
synced 2026-10-09 01:16:15 -08:00
4grayandClaude Opus 5.5
0768ae5ea2
* ci(i18n): fail on new English-identical translations The drift check only warned about locale values identical to English, so untranslated strings kept landing. It now fails on any such value that tools/i18n/identical-en-baseline.json does not record for that locale and key. The baseline captures today's 2,015 entries: legitimately identical values (brand and technical names, language autonyms, PIN) and the existing debt. An entry only covers the English text it recorded, so copying reworded English into a locale fails too. Baseline entries that are no longer identical are reported, not fatal. `pnpm run i18n:baseline:update` rewrites the baseline deliberately; CI runs `pnpm run i18n:validate` (node tests, then the check) and never rewrites it. `--fail-on-identical` remains as a strict audit. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * fix(i18n): keep the baseline intact on failed updates and strict audits `--update-baseline` now writes nothing while any locale is unreadable or has missing or extra keys, so an incomplete translation cannot reshape the baseline. `--fail-on-identical` no longer reads the baseline it ignores, so a damaged file cannot block a strict audit. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
82 lines
3.0 KiB
Markdown
82 lines
3.0 KiB
Markdown
# i18n fill-missing tool
|
|
|
|
One-shot helper for bringing every locale file in `apps/web/src/assets/i18n/`
|
|
to full coverage of `en.json`.
|
|
|
|
## How it works
|
|
|
|
`en.json` is the source of truth. For every other locale, the script:
|
|
|
|
1. Walks `en.json` in order (top-level + nested).
|
|
2. For each leaf key:
|
|
- Keeps the locale's existing translation if present.
|
|
- Otherwise pulls the translation from `tools/i18n/patches/<lang>.json`
|
|
(a flat object keyed by dotted path).
|
|
- If neither exists, leaves the key absent and exits non-zero.
|
|
3. Writes the merged tree back to the locale file with 4-space indent and a
|
|
trailing newline.
|
|
|
|
Existing translations are never overwritten.
|
|
|
|
## Workflow
|
|
|
|
```bash
|
|
# 1. Generate one missing-strings dump per locale (flat dotted-path → EN string)
|
|
node tools/i18n/fill-missing.mjs --emit-missing
|
|
# → tools/i18n/missing/<lang>.json
|
|
|
|
# 2. Translate each missing/<lang>.json into the equivalent patch file
|
|
# in tools/i18n/patches/<lang>.json (same shape: { dotted.path: translated }).
|
|
|
|
# 3. Merge patches into the locale files
|
|
node tools/i18n/fill-missing.mjs
|
|
|
|
# 4. Verify
|
|
node -e "
|
|
const fs=require('fs');
|
|
const en=JSON.parse(fs.readFileSync('apps/web/src/assets/i18n/en.json','utf8'));
|
|
const collect=(d,p='')=>Object.entries(d).flatMap(([k,v])=>v&&typeof v==='object'?collect(v,p?p+'.'+k:k):[p?p+'.'+k:k]);
|
|
const enKeys=new Set(collect(en));
|
|
for(const f of fs.readdirSync('apps/web/src/assets/i18n').filter(x=>x.endsWith('.json')&&x!=='en.json')){
|
|
const k=new Set(collect(JSON.parse(fs.readFileSync('apps/web/src/assets/i18n/'+f,'utf8'))));
|
|
console.log(f,'missing:',[...enKeys].filter(x=>!k.has(x)).length,'extra:',[...k].filter(x=>!enKeys.has(x)).length);
|
|
}"
|
|
```
|
|
|
|
For a non-mutating CI/agent check, run:
|
|
|
|
```bash
|
|
pnpm run i18n:check
|
|
```
|
|
|
|
The check fails on missing or extra keys against `en.json`, and on values that
|
|
are identical to English unless `identical-en-baseline.json` lists that exact
|
|
English text for the locale and key. Do not copy English into a locale as a
|
|
placeholder: translate it. The contract, including when an entry stops
|
|
covering a key, is in the
|
|
[validation map](../../docs/architecture/validation-map.md#i18n).
|
|
|
|
Baseline entries that are no longer identical are reported, not fatal. After
|
|
translating baselined values, or for a value that is legitimately the same in a
|
|
language (a brand, a technical name, a loanword), rewrite the baseline and
|
|
review every added entry in the diff:
|
|
|
|
```bash
|
|
pnpm run i18n:baseline:update
|
|
```
|
|
|
|
The checker's own tests run with `pnpm run i18n:test`; CI runs both through
|
|
`pnpm run i18n:validate`. For a full audit that ignores the baseline, run:
|
|
|
|
```bash
|
|
node tools/i18n/check-drift.mjs --fail-on-identical
|
|
```
|
|
|
|
## Translation rules
|
|
|
|
- Preserve `{{interpolation}}` placeholders verbatim.
|
|
- Preserve any inline HTML tags.
|
|
- Match the locale's existing punctuation, casing, and terminology.
|
|
- Keep brand names (IPTVnator, Xtream, Stalker, M3U, EPG, MPV, VLC) untranslated.
|
|
- Short UI strings stay short — no length blow-up.
|