feedback5 W5S: tParts() for a sentence with markup inside (the translation split at its placeholders, vnode params kept); tools/i18n.mjs extracts its msgids; docs/I18N.md

docs/I18N.md

@@ -24,11 +24,16 @@ t('还剩 {n} 秒', { n });                 // params: {name}; arrays fill {0},
 t('同盟密钥为 {ROOM_CODE_LEN} 位字母或数字', { ROOM_CODE_LEN });
 tc('toggle', '关闭');                    // context: the key 'toggle::关闭' ("Off"), else '关闭' ("Close")
 const TABLE = { a: N_('独立模拟') };     // module level: N_ only marks it; call t(TABLE.a) where it is shown
+html`<span>${tParts('第 {r} 回合 · 最终攻势', { r: html`<b class="num">${r}</b>` })}</span>`; // markup inside a sentence
 ```
 
 - **Placeholders** are the same in the msgid and the translation: `{name}`, positional `{0}`, and one plural form for
   English, `{n|one|other}` (`'{n} {n|round|rounds}'`). A value that is an array renders as a list (`、` / `, `). A
   missing value leaves the placeholder as it is (official templates such as `{0}博士…` pass through untouched).
+- **Markup inside a sentence** (a number in `<b>`, a `<kbd>`): `tParts(msgid, params)` returns the translation split at
+  its placeholders, with a param that is markup (a vnode, or an array of vnodes) kept as it is — the translator gets the
+  whole sentence and its word order, the Chinese pieces are the text around the markup exactly as before. Do not split
+  such a sentence into fragments (`第` … `回合`).
 - **Game-data names** inside a message are marked `dn(name)` (`{ dn: '…' }`) and translated through the localized data
   (`tName(name)` does the same for a bare name). **Player names are never translated** — pass them as plain strings.
 - **Data texts are not msgids**: `getChess(id).name`, `getMode(id).desc`, `data.get('config').tips` … already come in the
@@ -59,8 +64,9 @@ present. Use the official EN terms of the game (the EN client's own wording, e.g
 
 ### Tools: `node tools/i18n.mjs`
 
-- `extract [paths] [--list]` — per file: the msgids in `t()` / `tc()` / `N_()` / `msg()`, and the Chinese literals still
-  shown untranslated; the total says how many of those already have a translation (ready for the codemod).
+- `extract [paths] [--list]` — per file: the msgids in `t()` / `tc()` / `tParts()` / `N_()` / `msg()`, and the Chinese
+  literals still shown untranslated; the total says how many of those already have a translation (ready for the
+  codemod).
 - `check [paths] [--strict] [--stale]` — msgids the code uses that `public/i18n/en.json` lacks (`--strict` exits 1;
   `--stale` lists entries no code uses yet).
 - `codemod <files> [--write]` — wraps a file's Chinese literals: html`` text and attribute values → `${t('…')}`, strings →