egatari 0.0.0-stage → 0.6.4

package/kit/core/position.mjs

@@ -0,0 +1,46 @@
+// 位置の置き場（PositionStore）：(スライド i, 段階 k, 段階の t) と再生の状態、リンクの「戻る」の跡（trail）を 1 か所に持ち、
+// 知らせるときに購読者へ配る純ロジック。窓（ペイン）の仕組みの Phase 0（挙動を変えない抽出）
+// - DOM・時計（performance.now・setTimeout・requestAnimationFrame）・node: に触れない（kit/core の約束。編集アプリと共有する）
+// - 実行系では build（kit/core/build-core.mjs の classicModule）が deck.js の前に入れ、DECK.PositionStore（この関数）になる。
+//   Node からはそのまま import する（tools/test-position.mjs）
+// - いまの持ち主は舞台（kit/deck.js）：描いた位置（i, k）は seek のたびに at() で書き（知らせない。1 コマごとには配らない）、
+//   知らせる（publish）のは、deck.js がこれまで位置を送っていた時（段階を決めたとき・自動再生を止めたとき・発表者ビューがつながったとき）だけ。
+//   購読者（deck.js の broadcast：発表者ビュー・埋め込みの親・deck:pos）は、そのときの写し（snapshot）を受け取る
+// - t は位置の知らせに載せる段階の t：動きの初めから描くなら 0、最終状態なら null（Player P8 の position の t）
+// - cause は位置が変わったわけ（control・link・seek・play）。null なら知らせでは control
+// - trail の項目は中身を見ない（deck.js は {i, k, el} を積む。el はキーボードで押したリンク）
+export function createPositionStore() {
+  let i = 0, k = 0, t = null, playing = false, cause = null;
+  const trail = [], subs = [];
+  function top() { return trail.length ? trail[trail.length - 1] : null; }
+  function snapshot() { return { i, k, t, playing, cause, depth: trail.length, top: top() }; }
+  const store = {
+    get i() { return i; },
+    get k() { return k; },
+    get t() { return t; },
+    get playing() { return playing; },
+    get cause() { return cause; },
+    get depth() { return trail.length; },
+    // 描いた位置（知らせない）
+    at(ni, nk) { i = ni; k = nk; },
+    setT(v) { t = v; },
+    setPlaying(on) { playing = !!on; },
+    setCause(c) { cause = c == null ? null : c; },
+    // リンクの「戻る」の跡（Store に 1 本だけ。どの窓・ペインも共有する）
+    push(entry) { trail.push(entry); return trail.length; },
+    pop() { return trail.length ? trail.pop() : null; },
+    top,
+    snapshot,
+    // 購読：fn(snapshot)。戻り値で購読をやめる
+    subscribe(fn) {
+      subs.push(fn);
+      return function () { const j = subs.indexOf(fn); if (j >= 0) subs.splice(j, 1); };
+    },
+    // 今の位置を購読者に配る（登録の順。例外はそのまま呼んだ側へ）
+    publish() {
+      const p = snapshot();
+      subs.slice().forEach(function (fn) { fn(p); });
+    },
+  };
+  return store;
+}

package/kit/core/purposes.mjs

@@ -0,0 +1,183 @@
+// 言いたいこと（purpose）→ 表し方 → パーツ（backlog #99、handoff/parts-map-2026-10-24.html の 8・9・10）。Node にもブラウザにも依存しない（純粋な ESM）
+// 新規作成の「言いたいこと」の札（app/llm.js）と、AI への指示の本体の表（組み立てのときに kit/core/llm-pack-assemble.mjs が作る）が同じ材料を使う。
+//
+// 札は部品庫の manifest の purposes から作る（部品庫 v1.6.0 から。札の名前・絵・小さな字が manifest にある）：
+//   tile: "own"           その id で札を 1 つ作る（label が札の名前、examples が札の小さな字、icon が札の絵＝app/llm.js の ICONS の名前）
+//   tile: {"into": id}    その札に入る（ranking → compare）。札を外すと、入っている id もみな外れる
+//   tile: "none"          札を作らない（grouping・text-structure・parameter。その部品は分野（パーツの組）から入る）。reserved の id も札にしない
+// manifest に tile が 1 つもない（部品庫 v1.5.0 までの manifest）ときは、決めた表 TILES（v1.6.0 の札と同じ 15 個）に写し、gen が警告を出す。
+// 札の並びは manifest の purposes の順（表のときは TILES の順）。札の数は manifest しだい（v1.6.0 は 15：2026-10-24 の 14 個と spatial「場所・地図」）。
+// spatial のパーツ（m-map-japan）は分野「地図（社会）」（系列 social）にだけある。入っていなければ、ほかのパーツのない札と同じく AI が HTML で描く。
+//
+// 材料の出どころ：部品庫のリリースの manifest.json（components:update が vendor/components/manifest.json に置く）の
+//   purposes：順のある配列 [{id, ja, en, steps: {ja, en}, reserved?, tile?, label?, examples?, icon?}]（reserved が真なら、まだ使う部品がない。札にも表にも使わない）
+//   components.<名前>：{tag?, purposes: [id …]（主なものが先）, variants: [名前 …]（0 番目がシード値 0 の見せ方。なければ []）}。tag がなければ 'm-' + 名前
+// 形の合わない項目は 1 つずつ落として warnings に書く（全部を捨てない）。表に写すときは、札ごとに写る manifest の id が 1 つもなければ決めた表の文を使う。
+// 部品の言いたいことは manifest にあればそれ、なければ部品庫 v1.1.0 の README の purposes:（FALLBACK_COMPONENTS）。
+//
+//   TILES                               [{id, ids: [manifest の id …], label, sub, name, steps}]（文はどれも {en, ja}）。manifest に tile がないときの札
+//   purposesFrom(manifest | null, {vendored?})
+//       → {source: 'manifest' | 'fallback', tiles: 'manifest' | 'table', list: 札 [{id, ids, label, sub, name, steps, icon?}], components: {タグ: [札の id …]},
+//          variants: {タグ: [名前 …]}, unmapped: [札のない manifest の id …], warnings: [文 …]}
+//       vendored：組み立てに入る部品のタグ（Set か配列）。あれば、それ以外の部品は components に入れない（写していない部品の名前を AI に出さない）
+//   componentsOff(off, P)               外した言いたいこと（札の id）だけに使う部品。並びは名前の順
+//   purposesTable(P, parts, lang, src, {exclude, sets, off})
+//       指示の本体の表（Markdown）。parts：材料の部品 [{tag, set}]（set は 'standard' か束の名前）。sets：入っている束（null ならすべて）。
+//       外した札の行は出さない。exclude の部品と、入っていない束の部品は出さない（説明のない部品を指さない）。
+//       行に部品がなければ「近い部品か HTML・インラインの SVG」。入っていない束は、何に使えるかだけを最後の 1 行に（束と部品の名前は出さない）
+
+const T = (ja, en) => ({ ja, en });
+export const TILES = [
+  { id: 'compare', ids: ['compare', 'ranking'], label: T('比べる（量・特徴）', 'Compare (amounts, features)'), sub: T('棒・並べた棒・比べる図', 'bars, sorted bars, comparison'), name: T('量を比べる', 'compare amounts'), steps: T('1 つの組、次に差', 'one group, then the difference') },
+  { id: 'change', ids: ['change'], label: T('変化', 'Change'), sub: T('折れ線・縦棒', 'line, columns'), name: T('時間での変化', 'change over time'), steps: T('線を 1 本ずつ', 'one line at a time') },
+  { id: 'part-whole', ids: ['part-whole'], label: T('内訳', 'Part of a whole'), sub: T('積み上げ棒・円・入れ子の円', 'stacked bars, pie, nested circles'), name: T('全体と内訳', 'part of a whole'), steps: T('全体を一度に', 'whole at once') },
+  { id: 'key-number', ids: ['key-number'], label: T('数字を見せる', 'Key number'), sub: T('大きな数字', 'big number'), name: T('1 つの大事な数字', 'one key number'), steps: T('全体を一度に', 'whole at once') },
+  { id: 'process', ids: ['process'], label: T('手順', 'Steps'), sub: T('流れ図', 'flow chart'), name: T('手順・工程', 'steps of a process'), steps: T('1 段ずつ', 'one step at a time') },
+  { id: 'timeline', ids: ['timeline'], label: T('年表・予定', 'Timeline'), sub: T('年表', 'timeline'), name: T('年表・予定', 'timeline'), steps: T('出来事を 1 つずつ', 'one event at a time') },
+  { id: 'cause-effect', ids: ['cause-effect'], label: T('原因と結果', 'Cause and effect'), sub: T('特性要因図', 'fishbone'), name: T('原因と結果', 'cause and effect'), steps: T('原因、次に結果', 'causes, then the effect') },
+  { id: 'cycle', ids: ['cycle'], label: T('循環', 'Cycle'), sub: T('サイクル', 'cycle'), name: T('循環', 'cycle'), steps: T('段階を 1 つずつ', 'one stage at a time') },
+  { id: 'hierarchy', ids: ['hierarchy'], label: T('階層・分類', 'Hierarchy'), sub: T('木', 'tree'), name: T('階層・分類', 'hierarchy'), steps: T('上から下へ', 'top down') },
+  { id: 'position', ids: ['position'], label: T('位置づけ', 'Position'), sub: T('4 象限・2 軸の地図', '4 quadrants, 2-axis map'), name: T('2 軸での位置づけ', 'position on 2 axes'), steps: T('軸、次に項目', 'axes, then items') },
+  { id: 'overlap', ids: ['overlap'], label: T('重なり', 'Overlap'), sub: T('ベン図', 'Venn diagram'), name: T('重なり', 'overlap'), steps: T('集合、次に重なり', 'sets, then the overlap') },
+  { id: 'correlation', ids: ['correlation'], label: T('2 つの量の関係', 'Two quantities'), sub: T('散布図', 'scatter plot'), name: T('2 つの量の関係', 'two quantities'), steps: T('点、次に傾向', 'points, then the trend') },
+  { id: 'spread', ids: ['spread'], label: T('ばらつき', 'Spread'), sub: T('ヒストグラム', 'histogram'), name: T('ばらつき', 'spread'), steps: T('全体を一度に', 'whole at once') },
+  { id: 'contents', ids: ['contents'], label: T('目次', 'Contents'), sub: T('札の格子', 'grid of cards'), name: T('目次', 'contents'), steps: T('全体を一度に', 'whole at once') },
+  { id: 'spatial', ids: ['spatial'], label: T('場所・地図', 'Place / map'), sub: T('日本地図・塗り分け・地点と矢印', 'map of Japan, choropleth, points and arrows'), name: T('場所・地図', 'place, map'), steps: T('地図、それから地域・点・矢印を 1 つずつ', 'the map, then regions, points and arrows one at a time') },
+];
+export const FALLBACK = TILES;
+// manifest の id → 札の id
+const TILE_OF = Object.fromEntries(TILES.flatMap((t) => t.ids.map((id) => [id, t.id])));
+// 部品庫 v1.1.0 の部品の言いたいこと（部品庫の README の purposes: と同じ。manifest にその部品の purposes がないときに使う）
+const FALLBACK_COMPONENTS = {
+  'm-bars': ['compare', 'ranking', 'change', 'part-whole'], 'm-curves': ['change'], 'm-flow': ['process'], 'm-menu': ['contents'],
+  'm-kpi': ['key-number'], 'm-market': ['part-whole'], 'm-quad': ['position'], 'm-sweep': ['parameter'], 'm-seq': ['spread'],
+  'm-collect': ['grouping'], 'm-kanbun': ['text-structure'], 'm-kobun': ['text-structure'], 'm-gendai': ['text-structure'], 'm-codetree': ['hierarchy', 'process'],
+};
+// 表の「パーツ」の欄に添える一言（札:部品）
+const NOTES = {
+  'compare:m-bars': T('順位は並べ替え', 'sorted for ranking'),
+  'change:m-bars': T('点が少ないとき', 'few points'),
+  'part-whole:m-bars': T('積み上げ', 'stacked'),
+  'part-whole:m-market': T('入れ子', 'nested'),
+  'hierarchy:m-codetree': T('符号の木だけ', 'code trees only'),
+  'process:m-codetree': T('符号の木で復号', 'decoding with a code tree'),
+};
+
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const str2 = (v) => (isObj(v) && typeof v.en === 'string' && v.en.trim() && typeof v.ja === 'string' && v.ja.trim() ? { en: v.en, ja: v.ja } : null);
+const ID = /^[a-z][a-z0-9-]*$/;
+const strs = (a) => (Array.isArray(a) ? a.filter((x) => typeof x === 'string') : []);
+const uniq = (a) => [...new Set(a)];
+
+export function purposesFrom(manifest, { vendored = null } = {}) {
+  const warnings = [];
+  const keep = vendored ? new Set(vendored) : null;
+  // 部品：tag がなければ 'm-' + 名前（部品庫の release.mjs と同じ決め方）
+  const comps = isObj(manifest) && isObj(manifest.components) ? Object.entries(manifest.components).filter(([, c]) => isObj(c)).map(([dir, c]) => ({ ...c, tag: typeof c.tag === 'string' ? c.tag : 'm-' + dir })) : [];
+  const variants = Object.fromEntries(comps.filter((c) => !keep || keep.has(c.tag)).map((c) => [c.tag, strs(c.variants)]));
+  // purposes：1 つずつ確かめる
+  const rows = [];
+  const seen = new Set();
+  const raw = isObj(manifest) ? manifest.purposes : undefined;
+  if (raw !== undefined && !Array.isArray(raw)) warnings.push('manifest.json: purposes is not an array (the decided table is used)');
+  (Array.isArray(raw) ? raw : []).forEach((r, i) => {
+    const bad = !isObj(r) ? 'not an object' : typeof r.id !== 'string' || !ID.test(r.id) ? 'id is not a lowercase id' : typeof r.ja !== 'string' || typeof r.en !== 'string' ? 'ja or en is not a string' : seen.has(r.id) ? 'duplicate id' : null;
+    if (bad) { warnings.push(`manifest.json: purposes[${i}] dropped (${bad})`); return; }
+    seen.add(r.id);
+    if (!r.reserved) rows.push(r);
+  });
+  const fromManifest = rows.some((r) => r.tile !== undefined);
+  const unmapped = [];
+  let list, any;
+  const tileOf = {};
+  if (fromManifest) {
+    // 札を manifest から：own の順に札、into はその札に、none は札なし
+    list = [];
+    for (const r of rows) {
+      if (r.tile !== 'own') continue;
+      const label = str2(r.label), sub = str2(r.examples);
+      if (!label || !sub) { warnings.push(`manifest.json: purpose "${r.id}" has tile "own" without label or examples (no tile)`); unmapped.push(r.id); continue; }
+      list.push({ id: r.id, ids: [r.id], label, sub, name: { ja: r.ja, en: r.en }, steps: str2(r.steps) || (TILES.find((t) => t.id === r.id) || {}).steps || T('', ''), ...(typeof r.icon === 'string' && ID.test(r.icon) ? { icon: r.icon } : {}) });
+      tileOf[r.id] = r.id;
+    }
+    for (const r of rows) {
+      if (r.tile === 'own') continue;
+      const into = isObj(r.tile) && typeof r.tile.into === 'string' ? list.find((t) => t.id === r.tile.into) : null;
+      if (into) { into.ids.push(r.id); tileOf[r.id] = into.id; continue; }
+      if (r.tile !== 'none') warnings.push(`manifest.json: purpose "${r.id}" has tile ${JSON.stringify(r.tile === undefined ? null : r.tile)}, not "own", {"into": <a tile>} or "none" (no tile)`);
+      unmapped.push(r.id);
+    }
+    any = list.length > 0;
+  } else {
+    // 部品庫 v1.5.0 までの manifest：決めた表（TILES）に写す
+    if (rows.length) warnings.push('manifest.json: purposes have no tile fields (components before v1.6.0); the tiles come from the decided table');
+    const ok = {};
+    for (const r of rows) {
+      if (!TILE_OF[r.id]) { unmapped.push(r.id); warnings.push(`manifest.json: purpose "${r.id}" has no tile; its parts come only through their subject part set`); continue; }
+      ok[r.id] = { name: { ja: r.ja, en: r.en }, steps: str2(r.steps) };
+    }
+    list = TILES.map((t) => {
+      const m = t.ids.map((id) => ok[id]).find(Boolean);   // 札の主な id から
+      return m ? { ...t, ids: [...t.ids], name: m.name, steps: m.steps || t.steps } : { ...t, ids: [...t.ids] };
+    });
+    Object.assign(tileOf, TILE_OF);
+    any = Object.keys(ok).length > 0;
+  }
+  // 部品の言いたいこと → 札
+  const components = {};
+  const tags = uniq([...Object.keys(FALLBACK_COMPONENTS), ...comps.map((c) => c.tag)]);
+  for (const tag of tags) {
+    if (keep && !keep.has(tag)) continue;
+    const c = comps.find((x) => x.tag === tag);
+    const ids = c && Array.isArray(c.purposes) ? strs(c.purposes) : FALLBACK_COMPONENTS[tag] || [];
+    const tiles = uniq(ids.map((id) => tileOf[id]).filter(Boolean));
+    if (tiles.length) components[tag] = tiles;
+  }
+  return { source: any ? 'manifest' : 'fallback', tiles: fromManifest ? 'manifest' : 'table', list, components, variants, unmapped, warnings };
+}
+
+export function componentsOff(off, P) {
+  const offSet = new Set(off || []);
+  if (!offSet.size) return [];
+  const on = new Set(P.list.map((p) => p.id).filter((id) => !offSet.has(id)));
+  return Object.keys(P.components).sort().filter((t) => P.components[t].length && P.components[t].every((id) => !on.has(id)));
+}
+
+const cell = (s) => String(s).replace(/\|/g, '\\|');
+// parts：材料の部品 [{tag, set}]（set は 'standard' か束の名前）。sets：入っている束（null ならすべて）
+export function purposesTable(P, parts, lang, src, { exclude = [], sets = null, off = [] } = {}) {
+  const L = lang === 'ja' ? 'ja' : 'en';
+  const ex = new Set(exclude), offs = new Set(off);
+  const inPack = (c) => c.set === 'standard' || !sets || sets.includes(c.set);
+  const usable = parts.filter((c) => !ex.has(c.tag));
+  const here = new Set(usable.filter(inPack).map((c) => c.tag));
+  const elsewhere = usable.filter((c) => !inPack(c));
+  const part = (id, t) => {
+    const note = NOTES[`${id}:${t}`];
+    return '`' + t + '`' + (note ? (L === 'ja' ? `（${note[L]}）` : ` (${note[L]})`) : '');
+  };
+  const none = L === 'ja' ? 'まだない：近いパーツか、HTML・インラインの SVG' : 'none yet: the nearest part, or HTML or inline SVG';
+  const notHere = L === 'ja' ? 'この文にはない：近いパーツか、HTML・インラインの SVG' : 'not in this text: the nearest part, or HTML or inline SVG';
+  const serves = (t, id) => (P.components[t] || []).includes(id);
+  const order = (id) => (a, b) => P.components[a].indexOf(id) - P.components[b].indexOf(id) || a.localeCompare(b);
+  const used = new Set();
+  const rows = [];
+  for (const p of P.list) {
+    if (offs.has(p.id)) continue;
+    const ts = [...here].filter((t) => serves(t, p.id)).sort(order(p.id));
+    ts.forEach((t) => used.add(t));
+    const cellText = ts.length ? ts.map((t) => part(p.id, t)).join(L === 'ja' ? '、' : ', ') : elsewhere.some((c) => serves(c.tag, p.id)) ? notHere : none;
+    rows.push(`| ${cell(p.name[L])} | ${cellText} | ${cell(p.steps[L])} |`);
+  }
+  const rest = [...here].filter((t) => !used.has(t)).sort();
+  if (rest.length) rows.push(`| ${L === 'ja' ? 'その他のパーツ' : 'other parts'} | ${rest.map((t) => part('', t)).join(L === 'ja' ? '、' : ', ')} | ${L === 'ja' ? 'その説明のとおり' : 'as described'} |`);
+  const head = L === 'ja' ? '| 言いたいこと | パーツ | ステップ |\n|---|---|---|' : '| purpose | parts | steps |\n|---|---|---|';
+  // 入っていない束：何に使えるかだけ（束の名前も部品の名前も出さない。説明のない部品の属性を AI に推させない。束の名前は画面に出ない）
+  const what = uniq(elsewhere.flatMap((c) => (P.components[c.tag] || []).filter((id) => !offs.has(id))))
+    .map((id) => P.list.find((p) => p.id === id)).filter(Boolean).map((p) => p.name[L]);
+  const other = elsewhere.length ? '\n\n' + (L === 'ja'
+    ? `この指示に入っていないパーツもある${what.length ? `（${what.join('・')}など）` : ''}。使わない。合いそうなら、何を見せたいかを 1 行のメモで伝える（作る人が新規作成でパーツを足せる）`
+    : `Some parts are not included in these instructions${what.length ? ` (for ${what.join(', ')}, and more)` : ''}. Do not use them; if one would fit, say in a one-line note what you would show (the author can add parts when making a new lesson).`) : '';
+  const url = src ? '\n\n' + (L === 'ja' ? `各パーツの説明（版を固定）：${src}<名前>/README.md（名前は \`m-\` を除いたもの）` : `Each part's description (pinned version): ${src}<name>/README.md (the name without \`m-\`)`) : '';
+  return head + '\n' + rows.join('\n') + other + url;
+}

package/kit/core/read-aloud.mjs

@@ -0,0 +1,166 @@
+// 読み上げで聞く（端末の声。format spec §5.6、backlog #89）の純ロジック：読む文を作り、端末の中の声を選び、読む・止める
+// - 音声ファイルにはならない：何も書かず、タイムラインにも (i, k, t) の描画にも動画のモードにも入らない（呼ぶ側も書かない）
+// - 声は端末の中の声（Web Speech API の localService === true）だけ。ネットワークの声は文を端末の外へ送るので、どんなときも選ばない
+// - 読む文は TTS と同じ：読み {x|y} は y を読み、{cue}・{mark:…} と @x- の行は読まない。日本語は読み辞書（kit/core/yomi.mjs の applyYomi。
+//   呼ぶ側が渡す）を当て、最後に TTS と同じ前処理（kit/core/tts-normalize.mjs の normalizeTtsText、join-num-counter）
+// - import なし・DOM と node: に触れない：再生器では build（kit/core/build-core.mjs の classicNamespace）が DECK.ReadAloud にし、
+//   編集アプリ（app/read-aloud.js）は ES モジュールとして読む。実際の speechSynthesis と SpeechSynthesisUtterance は呼ぶ側が渡す
+//
+//   spokenTurns(turns, {lang, terms, applyYomi, normalize}) → [{role, text}]（読む文のある発言だけ）
+//     turns：parseNarration の発言（ttsParts）、書いたままの発言（{role, raw}）、deck-narration の発言（{role, text, ttsParts?}。ttsParts があればそれを、なければ表示の文を読む）、または文字列
+//   spokenText(raw, opts) → 文字列（1 つの語や選んだ文。上と同じ処理）
+//   localVoices(voices, lang) → 端末の中の声のうち、言語の合うもの（地域まで合う声・既定の声・自然な声が先、機械らしい声・遊びの声は後）
+//   pickVoices(voices, lang) → {expert, novice}（声がなければ null。2 つあれば話す人ごとに別の声、1 つなら同じ声。機械らしい声は Novice にも選ばない）
+//   createReader({synth, Utterance}) → {speak(turns, lang, {onend}) → {ok, reason?, voices}, cancel(), speaking()}
+//   whenVoices(synth, ms) → Promise<voices>（Chrome は声の一覧を後から読み込む。voiceschanged か ms ミリ秒まで待つ）
+
+// 段階の中の区切りと読み（kit/core/narration-core.mjs の BOUND・READING と同じ式）、拡張の行（同 EXT_LINE）
+const NOTE_RE = /\{note:[^{}]*\}/g;
+const BOUND_RE = /\{(cue|mark:[^{}]*)\}/g;
+const READING_RE = /\{([^{}|]+)\|([^{}]+)\}/g;
+const EXT_RE = /^\s*@x-[a-z][a-z0-9]{0,31}-[a-z][a-z0-9-]{0,31}(?:[ \t].*)?$/;
+const ROLE_RE = /^(Expert|Novice|E|N)\s*[:：]\s*/;
+// 境目の両側が CJK 以外なら空白 1 つで、どちらかが CJK なら詰めてつなぐ（narration-core.mjs の joinLines と同じ字の範囲）
+const CJK_RE = /[　-〿぀-ヿㇰ-ㇿ㐀-䶿一-鿿豈-﫿＀-￯]/;
+function join(a, b) {
+  if (!a) return b;
+  if (!b) return a;
+  const x = a[a.length - 1], y = b[0];
+  if (/\s/.test(x) || /\s/.test(y) || CJK_RE.test(x) || CJK_RE.test(y)) return a + b;
+  return a + ' ' + b;
+}
+
+const isJa = (lang) => /^ja\b/i.test(String(lang || ''));
+
+// 書いたままの文 → 読む文の部品（区切りで分けて、読みを当てる）。@x- の行は捨てる
+function rawParts(raw) {
+  const lines = String(raw).split(/\r?\n/).filter((ln) => !EXT_RE.test(ln));
+  const text = lines.map((ln) => ln.trim()).filter(Boolean).reduce((a, b) => join(a, b), '');
+  return text.replace(NOTE_RE, '').split(BOUND_RE).filter((_, j) => j % 2 === 0).map((p) => p.replace(READING_RE, '$2').trim());
+}
+
+function finish(parts, o) {
+  let text = parts.map((p) => String(p).trim()).filter(Boolean).reduce((a, b) => join(a, b), '');
+  if (isJa(o.lang) && typeof o.applyYomi === 'function') text = o.applyYomi(text, o.terms || []).text;
+  if (typeof o.normalize === 'function') text = o.normalize(text);
+  return text.replace(/\s{2,}/g, ' ').trim();
+}
+
+export function spokenText(raw, o = {}) {
+  return finish(rawParts(raw), o);
+}
+
+export function spokenTurns(turns, o = {}) {
+  const list = typeof turns === 'string' ? [turns] : Array.isArray(turns) ? turns : [];
+  const out = [];
+  for (const t of list) {
+    let role = 'expert', parts;
+    if (typeof t === 'string') {
+      const m = t.match(ROLE_RE);
+      if (m && m[1][0] === 'N') role = 'novice';
+      parts = rawParts(m ? t.slice(m[0].length) : t);
+    } else if (t && typeof t === 'object') {
+      role = t.role === 'novice' ? 'novice' : 'expert';
+      if (Array.isArray(t.ttsParts)) parts = t.ttsParts;
+      else if (typeof t.raw === 'string') parts = rawParts(t.raw);
+      else if (typeof t.text === 'string') parts = rawParts(t.text);
+      else continue;
+    } else continue;
+    const text = finish(parts, o);
+    if (text) out.push({ role, text });
+  }
+  return out;
+}
+
+// 言語の札：小文字・_ を - に。主の部分（ja・en）が合えば使える
+function tag(s) { return String(s || '').replace(/_/g, '-').toLowerCase(); }
+// 声の並べ方：地域（ja-JP）まで合う声 → 既定の声 → 高品質（Premium・Enhanced）→ よく知られた自然な声（この順）→ そのほか →
+// 機械らしい声（macOS の Eloquence：Eddy・Flo…）→ 遊びの声（Bad News・Zarvox… Chrome は en-US として並べる）。名前は最初の語で見る
+const NATURAL = ['kyoko', 'otoya', 'o-ren', 'hattori', 'haruka', 'ayumi', 'ichiro', 'sayaka', 'nanami', 'keita',
+  'samantha', 'alex', 'ava', 'allison', 'tom', 'susan', 'zoe', 'evan', 'nathan', 'joelle', 'noelle', 'daniel', 'serena', 'kate', 'oliver', 'karen', 'lee', 'moira', 'tessa', 'rishi', 'fiona', 'veena',
+  'zira', 'david', 'mark', 'aria', 'jenny', 'guy'];
+const ROBOTIC = ['eddy', 'flo', 'grandma', 'grandpa', 'reed', 'rocko', 'sandy', 'shelley'];
+const NOVELTY = ['albert', 'bad', 'bahh', 'bells', 'boing', 'bubbles', 'cellos', 'deranged', 'good', 'hysterical', 'jester', 'junior', 'organ', 'pipe', 'superstar', 'trinoids', 'whisper', 'wobble', 'zarvox', 'fred', 'ralph', 'kathy',
+  'ささやき声', 'オルガン', 'スーパースター', 'トリノイド', 'ベル', '道化', '震え', 'ボイン', 'バブル', 'チェロ'];
+function tier(v) {
+  const n = String(v.name || '').toLowerCase(), first = n.split(/[\s(（]/)[0];
+  if (v.default) return 0;
+  if (/premium|enhanced|プレミアム|拡張|neural|natural/.test(n)) return 1;
+  const i = NATURAL.indexOf(first);
+  if (i >= 0) return 2 + i / 100;
+  if (NOVELTY.indexOf(first) >= 0) return 5;
+  if (ROBOTIC.indexOf(first) >= 0) return 4;
+  return 3;
+}
+export function localVoices(voices, lang) {
+  const want = tag(lang || 'ja'), main = want.split('-')[0];
+  const list = [];
+  for (const v of (voices && typeof voices.length === 'number' ? Array.prototype.slice.call(voices) : [])) {
+    // 端末の中の声だけ（localService が true と決まっているもの。undefined やほかの値は外す）
+    if (!v || v.localService !== true) continue;
+    const l = tag(v.lang);
+    if (l.split('-')[0] !== main) continue;
+    list.push({ v, region: l === want ? 0 : 1, tier: tier(v), at: list.length });
+  }
+  return list.sort((a, b) => a.region - b.region || a.tier - b.tier || a.at - b.at).map((x) => x.v);
+}
+
+export function pickVoices(voices, lang) {
+  const list = localVoices(voices, lang);
+  if (!list.length) return { expert: null, novice: null };
+  const expert = list[0];
+  // Novice の声：Expert と別の声。ただし Expert より機械らしい声・遊びの声にはしない（なければ同じ声で読む）
+  const lim = Math.max(Math.floor(tier(expert)), 3);
+  const novice = list.find((v) => v !== expert && v.name !== expert.name && tier(v) < lim + 1) || expert;
+  return { expert, novice };
+}
+
+export function whenVoices(synth, ms = 1500) {
+  return new Promise((resolve) => {
+    let done = false;
+    const get = () => { try { return synth.getVoices() || []; } catch (e) { return []; } };
+    const now = get();
+    if (now.length) { resolve(now); return; }
+    const fin = () => { if (done) return; done = true; try { synth.removeEventListener('voiceschanged', fin); } catch (e) { /* 古いブラウザ */ } resolve(get()); };
+    try { synth.addEventListener('voiceschanged', fin); } catch (e) { /* 古いブラウザ */ }
+    setTimeout(fin, ms);
+  });
+}
+
+export function createReader(env) {
+  const synth = env && env.synth, Utterance = env && env.Utterance;
+  let gen = 0, active = false;
+  function cancel() {
+    gen++;
+    const was = active;
+    active = false;
+    if (synth) { try { synth.cancel(); } catch (e) { /* 止められなくても先へ */ } }
+    return was;
+  }
+  // turns は spokenTurns の結果（[{role, text}]）。声がなければ読まずに {ok: false, reason: 'no-voice'}
+  function speak(turns, lang, cb = {}) {
+    cancel();
+    if (!synth || typeof Utterance !== 'function') return { ok: false, reason: 'no-synth' };
+    const list = (turns || []).filter((t) => t && t.text);
+    if (!list.length) return { ok: false, reason: 'no-text' };
+    let all = [];
+    try { all = synth.getVoices() || []; } catch (e) { all = []; }
+    const vs = pickVoices(all, lang);
+    if (!vs.expert) return { ok: false, reason: 'no-voice' };
+    const my = gen;
+    active = true;
+    list.forEach((t, j) => {
+      const v = t.role === 'novice' ? vs.novice : vs.expert;
+      const u = new Utterance(t.text);
+      u.voice = v;
+      u.lang = v.lang || lang;
+      if (j === list.length - 1) {
+        const end = (ev) => { if (my !== gen) return; active = false; if (cb.onend) cb.onend(ev && ev.type === 'error' ? 'error' : 'end'); };
+        u.onend = end; u.onerror = end;
+      }
+      synth.speak(u);
+    });
+    return { ok: true, voices: vs };
+  }
+  return { speak, cancel, speaking: () => active };
+}

package/kit/core/ref-voice.mjs

@@ -0,0 +1,75 @@
+// 参照音声（AI 音声が声をまねる元の録音）：教材に入れない（format spec §5 の recipe。持ち主の決定 2026-10-28）。
+// 教材（Egatari ファイル）が運ぶのは、その声で合成した台本の音声だけ。人の声の録音が教材の写しと一緒に広がらないように。
+// node: も fs も使わない（Node とブラウザの編集アプリが共有する。読み書きは渡された env を通す）
+//
+//   referenceVoices(env, deckDir, {refDir?})  → [{abs, rel, size, load()}]：作業フォルダの中にある参照音声
+//     voice.json の expert・novice（tts/synth.py と同じ読み方）：パス（/ を含むか .wav で終わる。相対なら作業フォルダから）はそのファイル。
+//     名前（bob）は <refDir>/<名前>.wav と <名前>_<言語>.wav（refDir は IRODORI_REF_DIR。コマンドだけ）。役がなければ既定の名前（bob・alice）。
+//     作業フォルダの外のものは数えない（そもそも組み立ても書き出しも読まない）
+//   matchReference(refs, rel, bytes?)        → 当たった参照音声（場所が同じか、中身のバイトが同じ）か null
+//   REFERENCE_VOICE_RULE                     知らせに添える決まりの言葉（英語。画面は app/i18n.js・kit/check-messages.mjs）
+
+export const REFERENCE_VOICE_RULE = 'a lesson does not carry the reference recording a voice was cloned from, only the narration audio made with it (Egatari §5, recipe)';
+const DEFAULT_NAMES = Object.freeze({ expert: 'bob', novice: 'alice' });
+const isPathForm = (v) => /[\\/]/.test(v) || /\.wav$/i.test(v);
+const fold = (p) => p.normalize('NFC').toLowerCase();
+
+export function referenceVoices(env, deckDir, opts = {}) {
+  const P = env.path;
+  const root = P.resolve(deckDir);
+  const inDeck = (p) => env.within(p, root);
+  const rel = (p) => P.relative(root, p).split(P.sep).join('/');
+  let vj = {};
+  const vPath = P.join(root, 'voice.json');
+  try { if (env.exists(vPath) && inDeck(vPath)) { const v = JSON.parse(env.readText(vPath)); if (v && typeof v === 'object' && !Array.isArray(v)) vj = v; } } catch { /* 読めない voice.json：声の指定はないものとする */ }
+  const roles = {};
+  for (const [k, v] of Object.entries(vj)) if ((k.toLowerCase() === 'expert' || k.toLowerCase() === 'novice') && typeof v === 'string' && v.trim()) roles[k.toLowerCase()] = v.trim();
+  for (const r of Object.keys(DEFAULT_NAMES)) if (!roles[r]) roles[r] = DEFAULT_NAMES[r];
+  const cands = new Set();
+  const refDir = typeof opts.refDir === 'string' && opts.refDir ? P.resolve(root, opts.refDir) : null;
+  for (const v of Object.values(roles)) {
+    if (isPathForm(v)) {
+      if (/^~/.test(v)) continue;   // 家のフォルダ：作業フォルダの外
+      cands.add(P.resolve(root, v));
+    } else if (refDir && inDeck(refDir)) {
+      cands.add(P.join(refDir, v + '.wav'));
+      // 言語の付いた声（<名前>_<言語>.wav。tts/synth.py は日本語以外の教材でこれを選ぶ）
+      if (typeof env.listFiles === 'function') {
+        try {
+          const re = new RegExp(`^${v.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}_[A-Za-z]{2,3}\\.wav$`, 'i');
+          for (const f of env.listFiles(refDir) || []) if (P.dirname(f) === refDir && re.test(P.basename(f))) cands.add(f);
+        } catch { /* 一覧できない */ }
+      }
+    }
+  }
+  const out = [];
+  for (const abs of [...cands].sort()) {
+    if (!inDeck(abs) || abs === root) continue;
+    let ok = false;
+    try { ok = env.exists(abs) && (typeof env.isFile !== 'function' || env.isFile(abs)); } catch { ok = false; }
+    if (!ok) continue;
+    // 中身は比べるときにだけ読む（同じ大きさのファイルがあったとき。名前を変えた写しも見つける）
+    let size = null, bytes;
+    try { const n = typeof env.size === 'function' ? env.size(abs) : null; size = Number.isFinite(n) ? n : null; } catch { size = null; }
+    const load = () => {
+      if (bytes === undefined) {
+        try { bytes = env.readBytes ? env.readBytes(abs) : Uint8Array.from(atob(env.readBase64(abs)), (c) => c.charCodeAt(0)); } catch { bytes = null; }
+      }
+      return bytes;
+    };
+    out.push({ abs, rel: rel(abs), size, load });
+  }
+  return out;
+}
+
+const sameBytes = (a, b) => {
+  if (!a || !b || a.length !== b.length) return false;
+  for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return false;
+  return true;
+};
+export function matchReference(refs, relPath, bytes = null) {
+  const f = fold(relPath);
+  for (const r of refs) if (fold(r.rel) === f) return r;
+  if (bytes) for (const r of refs) if ((r.size === null || r.size === bytes.length) && sameBytes(r.load(), bytes)) return r;
+  return null;
+}

package/kit/core/sha1.mjs

@@ -0,0 +1,34 @@
+// SHA-1（16 進）。Node の crypto がない場所（ブラウザ）でも同期で同じ値を出す
+// build の data-src-h・開発サーバーの衝突の確認（短い hash）に使う。文字列は UTF-8 で数える
+const enc = new TextEncoder();
+export function sha1Hex(input) {
+  const msg = typeof input === 'string' ? enc.encode(input) : input;
+  const len = msg.length;
+  const nBlocks = ((len + 8) >> 6) + 1;
+  const w = new Uint32Array(nBlocks * 16);
+  for (let i = 0; i < len; i++) w[i >> 2] |= msg[i] << (24 - (i & 3) * 8);
+  w[len >> 2] |= 0x80 << (24 - (len & 3) * 8);
+  // 長さ（ビット）。2^32 を超える分も上の語に入れる
+  w[nBlocks * 16 - 1] = (len * 8) >>> 0;
+  w[nBlocks * 16 - 2] = Math.floor(len / 0x20000000);
+  let h0 = 0x67452301, h1 = 0xefcdab89, h2 = 0x98badcfe, h3 = 0x10325476, h4 = 0xc3d2e1f0;
+  const x = new Uint32Array(80);
+  for (let b = 0; b < nBlocks; b++) {
+    for (let t = 0; t < 16; t++) x[t] = w[b * 16 + t];
+    for (let t = 16; t < 80; t++) { const v = x[t - 3] ^ x[t - 8] ^ x[t - 14] ^ x[t - 16]; x[t] = (v << 1) | (v >>> 31); }
+    let a = h0, bb = h1, c = h2, d = h3, e = h4;
+    for (let t = 0; t < 80; t++) {
+      let f, k;
+      if (t < 20) { f = (bb & c) | (~bb & d); k = 0x5a827999; }
+      else if (t < 40) { f = bb ^ c ^ d; k = 0x6ed9eba1; }
+      else if (t < 60) { f = (bb & c) | (bb & d) | (c & d); k = 0x8f1bbcdc; }
+      else { f = bb ^ c ^ d; k = 0xca62c1d6; }
+      const tmp = (((a << 5) | (a >>> 27)) + f + e + k + x[t]) >>> 0;
+      e = d; d = c; c = (bb << 30) | (bb >>> 2); bb = a; a = tmp;
+    }
+    h0 = (h0 + a) >>> 0; h1 = (h1 + bb) >>> 0; h2 = (h2 + c) >>> 0; h3 = (h3 + d) >>> 0; h4 = (h4 + e) >>> 0;
+  }
+  return [h0, h1, h2, h3, h4].map((v) => v.toString(16).padStart(8, '0')).join('');
+}
+// 8 桁の短い hash（kit/build.mjs と server/dev.mjs の short() と同じ値）
+export const short = (s) => sha1Hex(s).slice(0, 8);