Claude CodeでICUのplural・selectを訳文で壊さない検査を書く

// 使い方: node scripts/check-icu.mjs <locales/xx/file.json>...
// 引数が無ければ、hook の stdin(JSON)から tool_input.file_path を読む。終了コード 2 = 違反あり
import fs from 'node:fs';
import path from 'node:path';
import { parse, TYPE } from '@formatjs/icu-messageformat-parser';
 
const BASE = 'en';
let files = process.argv.slice(2);
if (files.length === 0) {
  const input = JSON.parse(fs.readFileSync(0, 'utf8'));
  files = [input.tool_input?.file_path].filter(Boolean);
}
 
const flatten = (o, p = '') => Object.entries(o).flatMap(([k, v]) =>
  v && typeof v === 'object' ? flatten(v, `${p}${k}.`) : [[`${p}${k}`, String(v)]]);
 
// plural / select を再帰的に集める(入れ子の選択肢も辿る)
function collect(ast, out = []) {
  for (const el of ast) {
    if (el.type === TYPE.plural || el.type === TYPE.select) {
      out.push(el);
      for (const opt of Object.values(el.options)) collect(opt.value, out);
    } else if (el.type === TYPE.tag) collect(el.children, out);
  }
  return out;
}
 
// 引用符で波括弧が文字として読まれた箇所(l'{count} のような ASCII アポストロフィ)を探す
function literals(ast, out = []) {
  for (const el of ast) {
    if (el.type === TYPE.literal) out.push(el.value);
    else if (el.type === TYPE.plural || el.type === TYPE.select) Object.values(el.options).forEach((o) => literals(o.value, out));
    else if (el.type === TYPE.tag) literals(el.children, out);
  }
  return out;
}
 
let problems = 0;
const report = (msg) => { console.error(msg); problems++; };
 
for (const file of files) {
  const m = file.match(/locales\/([^/]+)\//);
  if (!m || !file.endsWith('.json') || !fs.existsSync(file)) continue;
  const lng = m[1];
  const rel = path.relative(process.cwd(), file);
  const read = (f) => new Map(flatten(JSON.parse(fs.readFileSync(f, 'utf8'))));
  const dst = read(file);
  const baseFile = file.replace(`locales/${lng}/`, `locales/${BASE}/`);
  const src = lng !== BASE && fs.existsSync(baseFile) ? read(baseFile) : new Map();
 
  for (const [key, msg] of dst) {
    let ast;
    try {
      ast = parse(msg, { requiresOtherClause: true });
    } catch (e) {
      report(`[${rel}] ${key}: ICU構文エラー: ${e.message.split('\n')[0]}`);
      continue;
    }
    for (const lit of literals(ast)) {
      if (/[{}]/.test(lit)) report(`[${rel}] ${key}: 引用符のせいで波括弧が文字として読まれています: ${lit.trim()}`);
    }
    for (const el of collect(ast)) {
      if (el.type !== TYPE.plural) continue;
      const type = el.pluralType === 'ordinal' ? 'ordinal' : 'cardinal';
      const need = new Set(new Intl.PluralRules(lng, { type }).resolvedOptions().pluralCategories);
      const have = Object.keys(el.options).filter((k) => !k.startsWith('='));
      const miss = [...need].filter((c) => !have.includes(c));
      const extra = have.filter((c) => !need.has(c));
      if (miss.length) report(`[${rel}] ${key}: {${el.value}, plural} に ${lng} の ${type} カテゴリ ${miss.join('/')} がありません`);
      if (extra.length) report(`[${rel}] ${key}: {${el.value}, plural} に ${lng} で使われない ${extra.join('/')} があります`);
    }
    // 基準言語と、plural / select の引数名・select の選択肢キーワードを比べる
    const base = src.get(key);
    if (base !== undefined) {
      try {
        const sig = (a) => collect(a)
          .map((e) => (e.type === TYPE.select ? `select:${e.value}:${Object.keys(e.options).sort()}` : `plural:${e.value}`)).sort().join(' | ');
        const a = sig(parse(base)), b = sig(ast);
        if (a !== b) report(`[${rel}] ${key}: 選択構造が基準言語と違います\n    基準: ${a}\n    訳文: ${b}`);
      } catch { /* 基準側の不備はここでは扱わない */ }
    }
  }
}
process.exit(problems ? 2 : 0);

[locales/ar/cart.json] items: {count, plural} に ar の cardinal カテゴリ few/many/two/zero がありません
exit=2

[locales/ja/cart.json] items: {count, plural} に ja で使われない one があります
[locales/ja/cart.json] invite: 選択構造が基準言語と違います
    基準: select:gender:female,male,other
    訳文: select:gender:female,other,男性
[locales/ja/cart.json] msg: ICU構文エラー: EXPECT_ARGUMENT_CLOSING_BRACE

[locales/ru/cart.json] items: ICU構文エラー: MISSING_OTHER_CLAUSE

{ "a": "l'{count} élément" }

[locales/fr/f.json] a: 引用符のせいで波括弧が文字として読まれています: l{count} élément

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "node \"$CLAUDE_PROJECT_DIR/scripts/check-icu.mjs\""
          }
        ]
      }
    ]
  }
}

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "sh -c 'node scripts/check-icu.mjs locales/*/*.json >&2 || exit 2'"
          }
        ]
      }
    ]
  }
}

## 翻訳(ICU MessageFormat)
 
- 基準言語は `locales/en/`。訳は `locales/<言語>/` に同じキー構造で書く
- `{count, plural, ...}` の `plural` / `select` と引数名、`select` の
  キーワード(`male` `female` `other`)は訳さない
- `plural` には、その言語が必要とするカテゴリをすべて書く。
  必要なカテゴリは `new Intl.PluralRules("<言語>").resolvedOptions().pluralCategories`
  で調べる。英語の `one` / `other` の形を写さない
- 選択肢の中は、断片ではなく完全な文で訳す
- 人が読む文のアポストロフィは `’`(U+2019)を使う。ASCIIの `'` はICU構文の引用専用
- 書き終えたら `node scripts/check-icu.mjs locales/<言語>/*.json` を実行し、
  出力が空になるまで直す