egatari 0.0.0-stage → 0.6.4

package/kit/core/narration-parse.mjs

@@ -0,0 +1,225 @@
+// 台本の解析。発表者ビューでも共有する、環境・外部モジュールに依存しない部分。
+// スライドの鍵（docs/contract.md §4、format spec §8.1）：section の id、なければ見出しの正規化
+// （タグを除き、  を空白とみなし、空白をすべて除いたもの）
+export function normalizeKey(s) {
+  return String(s).replace(/<[^>]*>/g, '').replace(/&nbsp;/g, ' ').replace(/\s+/g, '');
+}
+
+// スライドの id：英字で始まり、英数字・_・- が続く 64 字まで。作るときは s- と base32 の小文字 6 字（乱数）
+export const SLIDE_ID = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+export const isSlideId = (s) => typeof s === 'string' && SLIDE_ID.test(s);
+const B32 = 'abcdefghijklmnopqrstuvwxyz234567';
+// taken：使ってはいけない id（文書の中のすべての id と、スライドの鍵）。has(x) を持つもの（Set・Map）
+// rand(n)：n バイトの乱数（Uint8Array）。既定は Web Crypto（Node 22 とブラウザの globalThis.crypto）
+export function newSlideId(taken = new Set(), rand = (n) => globalThis.crypto.getRandomValues(new Uint8Array(n))) {
+  for (let tries = 0; tries < 1000; tries++) {
+    const id = 's-' + [...rand(6)].map((b) => B32[b & 31]).join('');
+    if (!taken.has(id)) return id;
+  }
+  throw new Error('newSlideId: no free id');
+}
+// 段階の番号：0〜999 の 10 進（先頭の 0 なし）か concl
+export const STEP_KEY = /^(?:0|[1-9]\d{0,2}|concl)$/;
+export const isStepKey = (s) => STEP_KEY.test(String(s));
+
+// 見出しの行（## の後ろ）→ {key, id, heading}。末尾の {#id} があればその id が鍵（見出しの文字列より強い）。
+// なければ見出しの正規化（id と同じ文字列の見出し「## s-k3f9q2」は、正規化してもそのまま id になる）
+// id が規則に合わないときも鍵には使い、badId を立てる（品質チェックが知らせる）
+const HEAD_ID = /^(.*?)\s*\{#([^{}\s]+)\}$/;
+export function parseHeading(text) {
+  const t = String(text).trim();
+  const m = t.match(HEAD_ID);
+  if (m) return { key: m[2], id: m[2], heading: m[1], badId: !isSlideId(m[2]) };
+  return { key: normalizeKey(t), id: null, heading: t, badId: false };
+}
+const HEAD = /^##\s+(.+?)\s*$/;
+// 見出しにする文字列：1 行・タグなし・よくある文字参照をほどく（{#id} の前に置く）
+export function headingText(html) {
+  return String(html ?? '').replace(/<br\s*\/?>/gi, ' ').replace(/<[^>]*>/g, '').replace(/\\\(|\\\)/g, '')
+    .replace(/&nbsp;/g, ' ').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#39;|&apos;/g, "'").replace(/&amp;/g, '&')
+    .replace(/\{#/g, '{ #').replace(/\s+/g, ' ').trim();
+}
+// 新しい節の見出しの行。slide は鍵の文字列か {key, id, heading}
+export function headingLine(slide) {
+  if (typeof slide === 'string') return `## ${slide}`;
+  const h = headingText(slide.heading ?? '');
+  if (slide.id && slide.key === slide.id) return h && h !== slide.id ? `## ${h} {#${slide.id}}` : `## ${slide.id}`;
+  return `## ${h && normalizeKey(h) === slide.key ? h : slide.key}`;
+}
+
+const ROLE = /^(Expert|Novice|E|N)\s*[:：]\s*/;
+
+// 拡張の行（format spec §8.2・§9A）：段階の中の「@x-<名前>-<欄> <値>」。名前に - は入らない。
+// 発言・表示・TTS・区切り・hash のどれにも入らず、段階ごとの ext: [{name, field, value, line}] として返す。
+// 書き換え（rewriteNarration）でも行はそのまま残す
+export const EXT_LINE = /^\s*@x-([a-z][a-z0-9]{0,31})-([a-z][a-z0-9-]{0,31})(?:[ \t]+(.*))?$/;
+export function parseExtLine(ln) {
+  const m = String(ln).match(EXT_LINE);
+  return m ? { name: m[1], field: m[2], value: m[3] ?? '' } : null;
+}
+
+// 段階の中の区切り：{cue}（部品の同期点）と {mark:…}（注目の演出、docs/contract.md §7）。
+// どちらも TTS では区切りになり、tts/synth.py がその時刻を cues に記録する
+const BOUND = /\{(cue|mark:[^{}]*)\}/g;
+const READING = /\{([^{}|]+)\|([^{}]+)\}/g;
+export const MARK_EFFECTS = ['underline', 'circle', 'box', 'spot', 'laser'];
+
+// "cue" / "mark:ID|effect|hold=2" / "mark:clear" → {type:'cue'} / {type:'mark', id, effect, hold} / {type:'clear'}
+export function parseBound(tok) {
+  if (tok === 'cue') return { type: 'cue' };
+  const [id, ...opts] = tok.slice(5).split('|').map((x) => x.trim());
+  if (id === 'clear') return { type: 'clear' };
+  const b = { type: 'mark', id, effect: 'underline', hold: null };
+  for (const o of opts) {
+    const h = o.match(/^hold\s*=\s*([\d.]+)$/);
+    if (h) b.hold = +h[1];
+    else if (o) b.effect = o;
+  }
+  return b;
+}
+
+// 発表者への指示。最初の } までで、入れ子は不可。読み・区切りより先に除く。
+export const NOTE = /\{note:([^{}]*)\}/g;
+export function stripNotes(raw) { return String(raw).replace(NOTE, ''); }
+// 本文に紛れた { と、閉じ忘れを検査。最初の } は終端なので、その直後の余分な } も知らせる。
+export function noteProblems(raw) {
+  const out = [];
+  for (const m of String(raw).matchAll(/\{note:([^}]*)(\}|$)/g)) {
+    if (!m[2] || m[1].includes('{') || raw[m.index + m[0].length] === '}') out.push({ text: m[0], offset: m.index });
+  }
+  return out;
+}
+// 発表者専用：指示の位置を保った表示の部品（HTML にせず、表示時にエスケープする）。
+function presenterText(raw) { return raw.replace(BOUND, '').replace(READING, '$1').replace(/\s{2,}/g, ' '); }
+export function presenterParts(raw) {
+  const out = [];
+  let at = 0;
+  for (const m of raw.matchAll(NOTE)) {
+    out.push({ text: presenterText(raw.slice(at, m.index)) }, { note: m[1] });
+    at = m.index + m[0].length;
+  }
+  out.push({ text: presenterText(raw.slice(at)) });
+  return out;
+}
+
+// 表示用（字幕・発表者ノート）と TTS 用の文字列を作る
+//   {φ|ファイ} → 表示 φ / TTS ファイ、{cue} {mark:…} → 表示なし / TTS では区切り（bounds に順に記録）
+export function renderText(raw) {
+  raw = stripNotes(raw);
+  const display = raw.replace(BOUND, '').replace(READING, '$1').replace(/\s{2,}/g, ' ').trim();
+  const pieces = raw.split(/\{(cue|mark:[^{}]*)\}/);   // 奇数番目が区切りの中身
+  const parts = [], bounds = [];
+  pieces.forEach((p, j) => {
+    if (j % 2) bounds.push(parseBound(p));
+    else parts.push(p.replace(READING, '$2').trim());
+  });
+  return { display, tts: parts.join(''), ttsParts: parts, bounds };
+}
+
+// 続きの行を前の行に繋ぐ。境目の両側が CJK 以外（英字・数字・記号）なら空白 1 つを挟み、
+// どちらかが CJK（かな・漢字・全角の記号）なら詰める（日本語の原稿は従来どおり）
+const CJK = /[\u3000-\u303f\u3040-\u30ff\u31f0-\u31ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff\uff00-\uffef]/;
+export function joinLines(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.test(x) || CJK.test(y)) return a + b;
+  return a + ' ' + b;
+}
+
+// narration.md → [{slideKey, stepKey, line, turns:[{role, raw, display, tts, ttsParts}]}]
+// 同じ段階（slideKey:stepKey）が 2 回あれば後のものを使い、返す配列の warnings に書く
+// 返す配列の sections は節（## 見出し）の一覧 [{key, id, heading, line}]（段階のない節も入る）
+// 段階の番号は 0〜999 の 10 進（先頭の 0 なし）か concl。[01] や [1000] は使わず warnings に書く（その中身も捨てる）
+export function parseNarration(text) {
+  const out = [];
+  const sections = [], warnings = [];
+  let slideKey = null, cur = null, turn = null;
+  const lines = text.split(/\r?\n/);
+  let inComment = false;
+  lines.forEach((ln, idx) => {
+    if (inComment) { if (ln.includes('-->')) inComment = false; return; }
+    if (/^\s*<!--/.test(ln) && !ln.includes('-->')) { inComment = true; return; }
+    if (/^\s*<!--.*-->\s*$/.test(ln)) return;
+    const h = ln.match(HEAD);
+    if (h) {
+      const p = parseHeading(h[1]);
+      slideKey = p.key; cur = null; turn = null;
+      sections.push({ key: p.key, id: p.id, heading: p.heading, line: idx + 1 });
+      if (p.badId) warnings.push(`narration.md ${idx + 1} 行目: id「${p.id}」が規則（英字で始まり英数字・_・- の 64 字まで）に合わない`);
+      return;
+    }
+    if (/^#\s/.test(ln)) return;
+    const m = ln.match(/^\s*\[(\d+|concl)\]\s*(.*)$/);
+    if (m && slideKey !== null && !isStepKey(m[1])) {
+      warnings.push(`narration.md ${idx + 1} 行目: 段階の番号「[${m[1]}]」は使えない（0〜999、先頭の 0 なし）。この段階は読まない`);
+      cur = null; turn = null; return;
+    }
+    if (m && slideKey !== null) {
+      cur = { slideKey, stepKey: m[1], line: idx + 1, end: idx + 1, turns: [], ext: [] };   // end：この段階の最後の行（空行を除く）
+      out.push(cur); turn = null;
+      if (m[2].trim()) addLine(m[2]);
+      return;
+    }
+    // 拡張の行：発言には入れない（前の発言の続きにもしない）。段階の外のものは使わない
+    const x = parseExtLine(ln);
+    if (x) {
+      if (cur) { cur.ext.push({ ...x, line: idx + 1 }); cur.end = idx + 1; }
+      else if (slideKey !== null) warnings.push(`narration.md ${idx + 1} 行目: 拡張の行が段階（[k]）の外にある（使わない）`);
+      return;
+    }
+    if (cur && ln.trim()) { addLine(ln.trim()); cur.end = idx + 1; }  // 空行は飛ばす（同じ段階の続き）
+  });
+  function addLine(s) {
+    const r = s.match(ROLE);
+    if (r || !turn) {
+      const role = r ? (r[1][0] === 'N' ? 'novice' : 'expert') : 'expert';
+      turn = { role, raw: r ? s.slice(r[0].length) : s };
+      cur.turns.push(turn);
+    } else {
+      turn.raw = joinLines(turn.raw, s);
+    }
+  }
+  // 同じ段階が重なったら後のものだけ残す（字幕・音声・注目の演出がどれも同じものを使うように）
+  const last = new Map();
+  out.forEach((seg, j) => {
+    const key = `${seg.slideKey}:${seg.stepKey}`;
+    if (last.has(key)) warnings.push(`narration.md ${seg.line} 行目: 段階「${key}」が重複（${out[last.get(key)].line} 行目を上書き）`);
+    last.set(key, j);
+  });
+  const uniq = out.filter((seg, j) => last.get(`${seg.slideKey}:${seg.stepKey}`) === j);
+  for (const seg of uniq) {
+    for (const t of seg.turns) Object.assign(t, renderText(t.raw));
+    // 段階の区切りの並び（ターンをまたいで順に）。synth.py の cues と 1 対 1 に対応する
+    seg.bounds = seg.turns.flatMap((t) => t.bounds);
+  }
+  uniq.warnings = warnings;
+  uniq.sections = sections;
+  return uniq;
+}
+
+
+// {slideKey: {stepKey: [{role, text, ttsParts}]}}（deck.js の DECK.NARRATION。format spec §4 の deck-narration）
+// ttsParts：読みを当てた話す部品（renderText の ttsParts。inputHash に入るのと同じ値、§5.4）。端末の読み上げ（§5.6）が使う。
+// withTts を false にすると表示の文だけ（字の絞り込みなど、見える字だけを数えるとき）
+// 鍵は原稿の文字列なので、__proto__ などでも壊れないよう原型のない object を使う
+export function narrationMap(segs, withLines = false, withTts = true) {
+  const m = Object.create(null);
+  for (const s of segs) {
+    (m[s.slideKey] ||= Object.create(null))[s.stepKey] = s.turns.map((t) => {
+      const o = { role: t.role, text: t.display };
+      if (withTts) o.ttsParts = t.ttsParts.slice();
+      if (withLines) o.line = s.line;
+      return o;
+    });
+  }
+  return m;
+}
+
+// {"slideKey:stepKey": bounds}（deck.js の DECK.MARKS）。{mark} を含む段階だけ
+export function marksMap(segs) {
+  const m = Object.create(null);
+  for (const s of segs) if (s.bounds.some((b) => b.type !== 'cue')) m[`${s.slideKey}:${s.stepKey}`] = s.bounds;
+  return m;
+}
+

package/kit/core/new-deck.mjs

@@ -0,0 +1,247 @@
+// 新規作成の選び方（backlog #99・#124、handoff/parts-map-2026-10-24.html の 7・9、handoff/parts-tiers-2026-10-27.md §2）と、教材のシード値（format spec §8.4、backlog #104）。
+// Node にもブラウザにも依存しない（純粋な ESM）。画面は app/llm.js
+//
+// 大分類（構成を決める場面）→ 小分類（構成の型）。④ はパーツの一覧：パーツを「伝えたいこと」でまとめて並べ、教科にしかない形（地図・国語・英語・音楽）は
+// 最後の「教科の形」に（授業（小・中・高）では一番上に）。パーツの段（標準・専門・特殊）と束はパーツライブラリ 2.0 の manifest の tier・set
+// （kit/core/llm-pack.mjs の TIERS。tools/make-llm-guide.mjs が写す）。特殊（extra）のパーツは一覧に出さない。
+// 初めの選び方：標準のパーツは全部、専門のパーツは、場面の小分類の表（SUB_SETS）か ② の言葉の表（WORDS）に当たった束だけ（理由を添える）。
+// プランが変えるのは指示の大きさの上限（capKb）と詳しさ（無料のプランは中核の 4 つのほかの標準のパーツを一覧の 1 行だけに。kit/core/llm-pack.mjs の partsPackOpts）。
+// 選べる数は限らない。越えたら外す候補を出す：trimCandidates。
+//
+//   CATEGORIES                         [{id, label: {en, ja}, subs: [{id, label, structure, show}], structure?, show?}]
+//   SET_LABELS                         [{set, label: {en, ja}, inside: {en, ja}}]（スライドの挿入の「指示の全体も付ける」の束の名前。新規作成では使わない）
+//   SUBJECT_SETS                       教科の形の束（この順に並べる）
+//   SUB_SETS                           小分類 → おすすめの束（§2.3）
+//   WORDS                              {ja|en: {束: [言葉]}}（§2.4。英語の画面では英語の表）
+//   partsList(sub)                     → [{id, label: {ja, en}, parts: [タグ]}]（④ の並び。id は伝えたいことの id か 'subject'）
+//   recommend({sub, text, lang})       → [{set, sub?, word?}]（おすすめの束と理由。小分類が先、それから言葉。束ごとに 1 つ）
+//   initialParts(rec)                  → 初めに選んでおくパーツ（標準の全部とおすすめの束のパーツ。一覧の順）
+//   partsOfSet(set)                    → 束のパーツ（一覧に出るものだけ）
+//   AI_PLANS・DEFAULT_PLAN             お使いの AI：'free'（無料のプラン。既定）| 'paid'（有料のプラン）
+//   planOf(choice)                     → 'free' | 'paid'（ない・知らない値は 'free'）
+//   capKb(plan)                        指示の大きさの上限（KB。kit/core/llm-pack.mjs の PACK_CAP_KB：無料 free、有料 paid）
+//   trimCandidates(ticked, {sizeOf, capBytes, keep})  上限を越えたときの外す候補（keep を除き、大きい順に、越えた分に届くまで）
+//   fitPlan(ticked, plan, {sizeOf, capBytes})  → {short, candidates}：無料のプランで越えたら、まず中核の 4 つの説明を短くし（short）、
+//                                      それでも越えれば専門のパーツだけを外す候補に（標準のパーツは外さない）。kit/core/llm-pack.mjs から出し直す
+//   choiceRequest(choice, P, lang)     頼みたいことの後ろに付ける節（場面・構成の型・見せ方と、choice.purposesOff があれば外した伝えたいこと。P は PURPOSES）。何もなければ ''。
+//                                      外した伝えたいことの行が名前を出す部品は choice.parts（指示に入るパーツ）にあるものだけ
+//                                      「その他」は何も書かず、小分類の「この中にない」（subcategory: null）は場面の行だけ（構成の型・見せ方は書かない）
+//   withChoice(configText, choice)     egatari.json の studio.newDeck に選んだものを書く（kit/core/config-file.mjs の updateConfig。ほかの項目はバイトのまま）
+//   choiceOf(configText)               → studio.newDeck | null
+//   choice の形：{plan, category, subcategory, parts: [タグ]}（category・subcategory は id か null。parts は選んだパーツ。
+//   前の記録（subjects・tools・purposesOff）は読むだけで、新しく書くものには入れない）
+//
+// 見せ方（variant。format spec §8.4）は名前だけで選ぶ。教材のシード値（data-egatari-seed）はなくなった：書かない。前の原稿にあれば、そのまま残す（誰も読まない）
+import { updateConfig, merge, configObject } from './config-file.mjs';
+import { TIERS, PACK_CAP_KB } from './llm-pack.mjs';
+import { partOrder } from './part-labels.mjs';
+import { componentsOff } from './purposes.mjs';
+
+export const CATEGORIES = [
+  { id: 'teaching', label: { ja: '授業・研修', en: 'Teaching' }, subs: [
+    { id: 'class', label: { ja: '授業（小・中・高）', en: 'School lesson' },
+      structure: { ja: '導入（注意を引く・目標・前の学習の想起）→ 展開 → まとめ', en: 'introduction (gain attention, state the goal, recall prior learning) → development → summary' },
+      show: { ja: '1 画面に 1 つのこと。ステップで段階的に見せる。文字は台本に任せ、飾らない。国語は縦書き、隠して音読', en: 'one thing per screen; reveal step by step; leave the words to the narration; no decoration; Japanese language arts in vertical text, hidden for reading aloud' } },
+    { id: 'lecture', label: { ja: '大学の講義', en: 'University lecture' },
+      structure: { ja: '導入 → 展開 → まとめ。式と図を積み上げる', en: 'introduction → development → summary, building up equations and figures' },
+      show: { ja: '見出しは主張の文にして図で示す。ステップで積み上げ、前のステップは残す', en: 'headings state the claim and a figure shows it; build up step by step and keep earlier steps on screen' } },
+    { id: 'training', label: { ja: '研修・使い方の説明', en: 'Training and how-to' },
+      structure: { ja: '手順を 1 つずつ', en: 'one procedure step at a time' },
+      show: { ja: '手順の図、画面の切り抜き', en: 'process diagrams and screen captures' } },
+  ] },
+  { id: 'research', label: { ja: '研究発表', en: 'Research' }, subs: [
+    { id: 'conference', label: { ja: '学会の口頭発表', en: 'Conference talk' },
+      structure: { ja: '背景 → 目的 → 方法 → 結果 → 考察 → 結論（背景・方法・結果でおよそ 3 分の 1 ずつ）', en: 'background → aim → method → results → discussion → conclusion (background, method and results about a third each)' },
+      show: { ja: '見出しは主張の文、図が証拠。箇条書きを減らす。1 分に 1 枚ほど', en: 'headings are claims and figures the evidence; few bullet lists; about one slide per minute' } },
+    { id: 'seminar', label: { ja: 'ゼミ・進捗報告', en: 'Seminar or progress report' },
+      structure: { ja: '学会の口頭発表と同じ流れを短く', en: 'the conference structure, shorter' },
+      show: { ja: '密度は高くてよい', en: 'denser slides are fine' } },
+    { id: 'talk', label: { ja: '招待講演・一般向け', en: 'Invited or public talk' },
+      structure: { ja: '今の姿とありうる姿を行き来し、最後に呼びかける', en: 'alternate between what is and what could be; end with a call to action' },
+      show: { ja: '大きな絵、文字はごく少なく', en: 'large pictures, very little text' } },
+  ] },
+  { id: 'business', label: { ja: 'ビジネス', en: 'Business' }, subs: [
+    { id: 'report', label: { ja: '報告', en: 'Report' },
+      structure: { ja: '結論を先に（PREP。空・雨・傘）、ピラミッド構造', en: 'conclusion first (PREP; situation, interpretation, action), pyramid structure' },
+      show: { ja: '見出しは結論の文。印刷しても読める密度', en: 'headings state conclusions; dense enough to read when printed' } },
+    { id: 'proposal', label: { ja: '提案・意思決定', en: 'Proposal and decision' },
+      structure: { ja: '状況 → 問題 → 問い → 答え（SCQA）', en: 'situation → complication → question → answer (SCQA)' },
+      show: { ja: '少人数で決める会議室向け。図表は濃く', en: 'for a small meeting that decides; dense charts' } },
+    { id: 'pitch', label: { ja: 'ピッチ', en: 'Pitch' },
+      structure: { ja: '目的 → 課題 → 解決 → なぜ今 → 市場 → 競合 → 製品 → 事業モデル → チーム → 数字 → お願い', en: 'purpose → problem → solution → why now → market → competition → product → business model → team → financials → the ask' },
+      show: { ja: '10 枚ほど、大きな字、1 枚に 1 つのこと', en: 'about 10 slides, large text, one thing per slide' } },
+    { id: 'intro', label: { ja: '紹介・広報', en: 'Introduction and publicity' },
+      structure: { ja: '今の姿とありうる姿を行き来する', en: 'alternate between what is and what could be' },
+      show: { ja: '大きな絵、文字は少なく', en: 'large pictures, little text' } },
+  ] },
+  { id: 'guides', label: { ja: '手引き', en: 'Guides' }, subs: [
+    { id: 'manual', label: { ja: 'マニュアル', en: 'Manual' },
+      structure: { ja: '目的（何ができるようになるか）→ 手順を 1 つずつ → つまずきやすいところ', en: 'goal (what you will be able to do) → the steps, one at a time → common pitfalls' },
+      show: { ja: '1 枚に 1 つの手順。画面の切り抜きや手順の図', en: 'one step per slide; screen captures and process diagrams' } },
+    { id: 'rules', label: { ja: '決まりの説明（規程・法令）', en: 'Rules and regulations' },
+      structure: { ja: '何についての決まりか → だれに・いつ当てはまるか → しなければならないこと → 原典の文とその日付', en: 'what the rules are about → who they apply to and when → what you must do → the original text and its date' },
+      show: { ja: '原典の文をそのまま引くか添付し、いつの時点の内容かを必ず書く', en: 'quote or attach the original text as it is, and always state the date the content is valid for' } },
+    { id: 'info', label: { ja: '案内（ごみの出し方・図書館・避難・履修登録など）', en: 'Information (waste sorting, library, evacuation, course registration…)' },
+      structure: { ja: 'どんな場面か → 品目や場面から引ける一覧 → わからないときの問い合わせ先', en: 'the situation → a list to look up by item or situation → where to ask' },
+      show: { ja: 'ごみの分別・図書館の使い方・避難経路・新入生や新人の案内・履修登録など。見出しで引けるように分ける', en: 'waste sorting, using the library, evacuation routes, orientation for new students or staff, course registration; organised so that headings can be looked up' } },
+  ],
+    structure: { ja: '一度通して説明し、あとは場面や品目から引けるように分ける', en: 'explain once from start to end, organised so that readers can look things up later by situation or item' },
+    show: { ja: '規程・法令などの原典の文を添え、いつの時点の内容かを必ず書く', en: 'quote the source text (rules, laws) and always state the date the content is valid for' } },
+  { id: 'other', label: { ja: 'その他', en: 'Other' }, subs: [] },
+];
+
+// スライドの挿入の「指示の全体も付ける」で出す束の名前（label は教科・用途、inside は中の図）。新規作成の ④ は束でなくパーツの一覧（partsList）。
+// 束そのものは manifest の set から読む（ここにない束は、名前のまま出す）
+export const SET_LABELS = [
+  { set: 'stats', label: { ja: '統計の図', en: 'Statistics charts' }, inside: { ja: 'ヒストグラム・箱ひげ図・ヒートマップ', en: 'Histograms, box plots, heatmaps' } },
+  { set: 'math', label: { ja: '算数・数学', en: 'Arithmetic and mathematics' }, inside: { ja: '筆算・数直線・テープ図・関数', en: 'Column arithmetic, number lines, tape diagrams, functions' } },
+  { set: 'maps', label: { ja: '地図', en: 'Maps' }, inside: { ja: '日本地図・世界地図', en: 'Maps of Japan and the world' } },
+  { set: 'kokugo', label: { ja: '国語', en: 'Japanese language arts' }, inside: { ja: '漢文・古文・現代文・書き順・縦書き', en: 'Kanbun, kobun, modern texts, stroke order, vertical writing' } },
+  { set: 'english', label: { ja: '英語', en: 'English (foreign language)' }, inside: { ja: '英文の構造（S V O C M・句と節）', en: 'Sentence structure (S V O C M, phrases, clauses)' } },
+  { set: 'music', label: { ja: '音楽', en: 'Music' }, inside: { ja: '鍵盤・楽譜（音階・和音）', en: 'Keyboard and score (scales, chords)' } },
+  { set: 'business', label: { ja: 'ビジネス', en: 'Business' }, inside: { ja: '市場規模の円・お金の流れ', en: 'Market size circles, money flows' } },
+  { set: 'tools', label: { ja: '道具', en: 'Classroom tools' }, inside: { ja: 'タイマー', en: 'Timer' } },
+  { set: 'science', label: { ja: '理科', en: 'Science' }, inside: { ja: '月の満ち欠け', en: 'Phases of the Moon' } },
+];
+
+// ---------------------------------------------------------------- ④ パーツの一覧（handoff/parts-tiers-2026-10-27.md §2）
+// 束の名前は中の名前（画面には出さない）。束そのものは manifest の set から読む（ここに書くのは、教科の形の束と、おすすめの表だけ）
+export const SUBJECT_SETS = ['maps', 'kokugo', 'english', 'music'];
+const SUBJECT_GROUP = { id: 'subject', label: { ja: '教科の形', en: 'For specific subjects' } };
+const OTHER_GROUP = { id: 'other', label: { ja: 'その他', en: 'Other' } };
+// 小分類 → おすすめの束（§2.3。ない小分類はなし）。授業（小・中・高）は束を決めず、教科の形を一覧の一番上に出す（SUBJECT_FIRST）
+export const SUB_SETS = Object.freeze({
+  lecture: ['stats'], training: ['tools'], conference: ['stats'], seminar: ['stats'],
+  report: ['business'], proposal: ['business'], pitch: ['business'], info: ['maps'],
+});
+const SUBJECT_FIRST = ['class'];
+// 言葉の表（§2.4）。日本語は字の並びで、英語は語の切れ目で探す（大文字・小文字は区別しない）。
+// 1 字の言葉は、ほかの語の一部に当たりやすいので除く並びを添える（{w, not}：not は前後にあればその所は当たりにしない）。毎晩の評価で当たり外れを測って直す
+export const WORDS = Object.freeze({
+  ja: {
+    stats: ['分布', '統計', 'データ', 'ヒストグラム', '箱ひげ', '相関', 'ベイズ', '推定', '検定'],
+    math: ['筆算', 'わり算', '割り算', 'かけ算', '掛け算', '分数', '割合', '数直線', 'テープ図', '関数'],
+    maps: ['地図', '都道府県', '地方', '世界', { w: '国', not: ['国語'] }, '人口', '地域'],
+    kokugo: ['国語', '漢文', '漢詩', '古文', '現代文', '評論', '小説', '書き順', 'ひらがな'],
+    english: ['英文', '文型', '英語', { w: '句', not: ['俳句', '語句', '文句', '句読点'] }, { w: '節', not: ['季節', '関節', '節約', '節分', '調節'] }, '関係詞'],
+    music: ['音階', '和音', { w: 'コード', not: ['ソースコード', 'バーコード', 'QRコード', 'コーディング'] }, '鍵盤', '楽譜'],
+    business: ['市場', 'KPI', '売上', '事業', 'ピッチ'],
+    tools: ['タイマー', 'ワークショップ', '演習時間', 'グループワーク'],
+  },
+  en: {
+    stats: ['distribution', 'distributions', 'statistics', 'statistical', 'data', 'histogram', 'histograms', 'box plot', 'box plots', 'correlation', 'Bayes', 'Bayesian', 'estimation', 'hypothesis test', 'hypothesis testing'],
+    math: ['long division', 'column addition', 'multiplication', 'division', 'fraction', 'fractions', 'ratio', 'ratios', 'percentage', 'percentages', 'number line', 'tape diagram', 'function', 'functions'],
+    maps: ['map', 'maps', 'prefecture', 'prefectures', 'region', 'regions', 'world', 'country', 'countries', 'population'],
+    kokugo: ['kanbun', 'kobun', 'kanshi', 'classical Japanese', 'classical Chinese', 'stroke order', 'hiragana', 'katakana', 'kanji'],
+    english: ['English grammar', 'sentence structure', 'sentence pattern', 'sentence patterns', 'phrase', 'phrases', 'clause', 'clauses', 'relative pronoun', 'relative pronouns'],
+    music: ['musical scale', 'major scale', 'minor scale', 'chord', 'chords', 'keyboard', 'piano', 'sheet music', 'musical score'],
+    business: ['market', 'markets', 'KPI', 'KPIs', 'sales', 'revenue', 'business', 'pitch'],
+    tools: ['timer', 'workshop', 'exercise time', 'group work'],
+  },
+});
+
+const PARTS = TIERS.parts;
+const shown = (t) => PARTS[t] && PARTS[t].tier !== 'extra';
+// 伝えたいことの id → まとめる先（manifest の tile.into：順位は「比べる」に）
+const intoOf = (id) => { const p = TIERS.purposes.find((x) => x.id === id); return p && p.into ? p.into : id; };
+const groupOf = (t) => {
+  const c = PARTS[t];
+  if (c.set && SUBJECT_SETS.includes(c.set)) return 'subject';
+  const p = (c.purposes || [])[0];
+  return p && TIERS.purposes.some((x) => x.id === intoOf(p)) ? intoOf(p) : 'other';
+};
+const byTier = (a, b) => (PARTS[a].tier === 'standard' ? 0 : 1) - (PARTS[b].tier === 'standard' ? 0 : 1);
+export function partsList(sub) {
+  const tags = partOrder(Object.keys(PARTS).filter(shown));
+  const groups = TIERS.purposes.filter((p) => !p.into).map((p) => ({ id: p.id, label: p.label, parts: tags.filter((t) => groupOf(t) === p.id).sort(byTier) }));
+  const other = { ...OTHER_GROUP, parts: tags.filter((t) => groupOf(t) === 'other').sort(byTier) };
+  const subject = { ...SUBJECT_GROUP, parts: SUBJECT_SETS.flatMap((s) => tags.filter((t) => groupOf(t) === 'subject' && PARTS[t].set === s)) };
+  const list = [...groups, other].filter((g) => g.parts.length);
+  if (!subject.parts.length) return list;
+  return SUBJECT_FIRST.includes(sub) ? [subject, ...list] : [...list, subject];
+}
+const LISTED = () => partsList(null).flatMap((g) => g.parts);
+export const partsOfSet = (set) => LISTED().filter((t) => PARTS[t].set === set);
+const SETS = () => [...new Set(LISTED().map((t) => PARTS[t].set).filter(Boolean))];
+
+const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+// 言葉が text のどこかに（除く並びの中でなく）あれば、その言葉を返す
+function findWord(text, word, lang) {
+  const w = typeof word === 'string' ? word : word.w, not = typeof word === 'string' ? [] : word.not || [];
+  const re = lang === 'en' ? new RegExp(`\\b${esc(w)}\\b`, 'gi') : new RegExp(esc(w), 'gi');
+  for (const m of text.matchAll(re)) {
+    const at = m.index;
+    const inside = not.some((n) => { const k = n.toLowerCase().indexOf(w.toLowerCase()); return k >= 0 && text.slice(at - k, at - k + n.length).toLowerCase() === n.toLowerCase(); });
+    if (!inside) return m[0];
+  }
+  return null;
+}
+export function recommend({ sub = null, text = '', lang = 'ja' } = {}) {
+  const L = lang === 'en' ? 'en' : 'ja', t = String(text || ''), have = SETS(), out = [];
+  for (const set of SUB_SETS[sub] || []) if (have.includes(set)) out.push({ set, sub });
+  for (const [set, words] of Object.entries(WORDS[L])) {
+    if (!have.includes(set) || out.some((r) => r.set === set)) continue;
+    for (const w of words) { const hit = findWord(t, w, L); if (hit) { out.push({ set, word: hit }); break; } }
+  }
+  return out;
+}
+export function initialParts(rec = []) {
+  const sets = new Set(rec.map((r) => r.set));
+  return LISTED().filter((t) => PARTS[t].tier === 'standard' || sets.has(PARTS[t].set));
+}
+
+// お使いの AI（無料のプラン・有料のプラン）。変えるのは指示の大きさの上限と詳しさ
+export const AI_PLANS = ['free', 'paid'];
+export const DEFAULT_PLAN = 'free';
+export const planOf = (choice) => (choice && choice.plan === 'paid' ? 'paid' : DEFAULT_PLAN);
+export const capKb = (plan) => (plan === 'paid' ? PACK_CAP_KB.paid : PACK_CAP_KB.free);
+// 外す候補（trimCandidates）と目安に収める決め方（fitPlan）は kit/core/llm-pack.mjs にある（コマンドの kit/llm-pack.mjs と同じ関数）
+export { trimCandidates, fitPlan } from './llm-pack.mjs';
+
+const catOf = (id) => CATEGORIES.find((c) => c.id === id) || null;
+export function subOf(category, sub) { const c = catOf(category); return (c && c.subs.find((s) => s.id === sub)) || null; }
+
+export function choiceRequest(choice, P, lang) {
+  const L = lang === 'ja' ? 'ja' : 'en';
+  const c = catOf(choice && choice.category);
+  const s = c && subOf(c.id, choice.subcategory);
+  const rows = [];
+  if (c && c.id !== 'other') {
+    rows.push(L === 'ja' ? `- 場面：${c.label.ja}${s ? '／' + s.label.ja : ''}` : `- Kind: ${c.label.en}${s ? ' / ' + s.label.en : ''}`);
+    // 構成の型と見せ方は小分類から。小分類のある大分類で「この中にない」（subcategory: null）なら書かない（「その他」と同じ）
+    const t = s || (c.subs.length ? null : c);
+    const st = t && t.structure, sh = t && t.show;
+    if (st) rows.push(L === 'ja' ? `- 構成の型：${st.ja}` : `- Structure: ${st.en}`);
+    if (sh) rows.push(L === 'ja' ? `- 見せ方：${sh.ja}` : `- Presentation: ${sh.en}`);
+  }
+  const offIds = new Set((choice && choice.purposesOff) || []);
+  const off = P && P.list ? P.list.filter((p) => offIds.has(p.id)) : [];
+  if (off.length) {
+    // 名前を出すのは指示に入る部品だけ（choice.parts。なければ外した伝えたいことのすべての部品）
+    const loaded = Array.isArray(choice.parts) ? new Set(choice.parts) : null;
+    const comps = componentsOff([...offIds], P).filter((t) => !loaded || loaded.has(t));
+    rows.push(L === 'ja'
+      ? `- 使わない言いたいこと（作者が外した）：${off.map((p) => p.name.ja).join('・')}。その表し方${comps.length ? `（${comps.map((t) => '`' + t + '`').join('・')}）` : ''}は使わない`
+      : `- Purposes turned off by the author: ${off.map((p) => p.name.en).join(', ')}. Do not use their representations${comps.length ? ` (${comps.map((t) => '`' + t + '`').join(', ')})` : ''}.`);
+  }
+  return rows.join('\n');
+}
+
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const clean = (choice) => ({
+  v: 1,
+  plan: planOf(choice),
+  category: catOf(choice.category) ? choice.category : null,
+  subcategory: subOf(choice.category, choice.subcategory) ? choice.subcategory : null,
+  parts: Object.keys(PARTS).filter((t) => (choice.parts || []).includes(t)).sort(),
+});
+export function withChoice(configText, choice) {
+  return updateConfig(configText || null, { studio: merge({ newDeck: clean(choice || {}) }) });
+}
+export function choiceOf(configText) {
+  let c;
+  try { c = configObject(configText); } catch { return null; }
+  const n = isObj(c.studio) ? c.studio.newDeck : null;
+  if (!isObj(n) || n.v !== 1) return null;
+  return { ...n, plan: planOf(n) };   // plan のない前の記録は無料のプラン
+}

package/kit/core/part-labels.mjs

@@ -0,0 +1,61 @@
+// 部品の画面の名前と絵と 1 行の説明（新規作成 ④ のパーツの一覧）。
+// 部品庫の manifest（vendor/components/manifest.json）には画面の名前がないので、ここにだけ置く。icon は app/llm.js の ICONS の名前。
+// 表にない部品は、名前は m-… のまま、絵は汎用（部品庫に部品が増えたら、ここに 1 行足す）
+//   PART_LABELS                 {タグ: {ja, en, icon, desc: {ja, en}}}（desc：新規作成 ④ のパーツの一覧の 1 行の説明。何を描くか）
+//   partLabel(tag, lang)        → 画面の名前
+//   partDesc(tag, lang)         → 1 行の説明（表にない部品は ''）
+//   partIcon(tag)               → 絵の名前
+//   standardParts(lang)         → 標準パーツ（FREE_CORE。無料のプランの共通の本体が説明する部品）の名前の並び
+//   partOrder(tags)             → 並べる順（標準パーツ、それから表の順）
+import { FREE_CORE } from './llm-pack-assemble.mjs';
+
+export const PART_LABELS = Object.freeze({
+  'm-bars': { ja: '棒グラフ', en: 'Bar chart', icon: 'bars', desc: { ja: '棒の長さで量を比べる', en: 'Compares amounts by bar length' } },
+  'm-flow': { ja: '流れ図', en: 'Flow diagram', icon: 'flow', desc: { ja: '手順や工程を矢印でつなぐ', en: 'Steps of a process joined by arrows' } },
+  'm-menu': { ja: '目次', en: 'Contents', icon: 'menu', desc: { ja: 'スライドへのリンクの札を並べた目次', en: 'A contents page of links to slides' } },
+  'm-curves': { ja: '折れ線グラフ', en: 'Line chart', icon: 'line', desc: { ja: '時間とともに変わる量を線で', en: 'Values that change over time, as lines' } },
+  'm-kpi': { ja: '数字の札', en: 'Key numbers', icon: 'kpi', desc: { ja: '大事な数字を大きく見せる', en: 'Shows one important number, large' } },
+  'm-quad': { ja: 'マトリックス', en: 'Matrix', icon: 'matrix', desc: { ja: '2 つの軸で 4 つに分けて置く', en: 'Places items in four quadrants on two axes' } },
+  'm-compare': { ja: '比べる表', en: 'Comparison table', icon: 'compare', desc: { ja: '2 つ（3 つまで）を並べて項目ごとに比べる', en: 'Compares two (or three) side by side, row by row' } },
+  'm-pie': { ja: '円グラフ', en: 'Pie chart', icon: 'part', desc: { ja: '全体の中の割合', en: 'Shares of a whole' } },
+  'm-cycle': { ja: '循環', en: 'Cycle', icon: 'cycle', desc: { ja: 'くり返す流れを輪にする', en: 'Stages that repeat, in a ring' } },
+  'm-fishbone': { ja: '特性要因図', en: 'Fishbone diagram', icon: 'cause', desc: { ja: '結果に効く原因を魚の骨の形に', en: 'Causes of a result, as a fishbone' } },
+  'm-scatter': { ja: '散布図', en: 'Scatter plot', icon: 'scatter', desc: { ja: '2 つの量の関係を点で', en: 'How two quantities relate, as dots' } },
+  'm-timeline': { ja: '年表', en: 'Timeline', icon: 'timeline', desc: { ja: '出来事や期間を時間の軸に並べる', en: 'Events and periods along a time axis' } },
+  'm-tree': { ja: '階層の木', en: 'Tree', icon: 'tree', desc: { ja: '上から枝分かれする階層や分類', en: 'A hierarchy or classification, branching down' } },
+  'm-venn': { ja: 'ベン図', en: 'Venn diagram', icon: 'venn', desc: { ja: '集合の重なり', en: 'How sets overlap' } },
+  'm-collect': { ja: '回答のまとめ', en: 'Grouping answers', icon: 'collect', desc: { ja: '回答をまとめて分ける', en: 'Gathers answers and sorts them into groups' } },
+  'm-sweep': { ja: 'パラメータを動かす', en: 'Parameter sweep', icon: 'sweep', desc: { ja: 'パラメータを動かして関数の形の変化を見せる', en: 'Moves a parameter to show how a function changes' } },
+  'm-market': { ja: '市場規模の円', en: 'Market size circles', icon: 'market', desc: { ja: '市場規模（TAM・SAM・SOM）を入れ子の円で', en: 'Market size (TAM, SAM, SOM) as nested circles' } },
+  'm-kanbun': { ja: '漢文', en: 'Kanbun', icon: 'kanbun', desc: { ja: '返り点を付けて訓読の順にたどり、書き下す', en: 'Return marks, reading order and the rendered text' } },
+  'm-kobun': { ja: '古文', en: 'Kobun', icon: 'kobun', desc: { ja: '語に切って品詞を色分けし、現代語訳と並べる', en: 'Words split and coloured by part of speech, with a modern translation' } },
+  'm-gendai': { ja: '現代文の読解', en: 'Modern text reading', icon: 'gendai', desc: { ja: '傍線・指す内容への矢印・段落の役割を図にする', en: 'Underlines, arrows to what words refer to, and paragraph roles' } },
+  'm-codetree': { ja: '符号の木', en: 'Code tree', icon: 'codetree', desc: { ja: '符号を木の枝でたどる', en: 'Codes traced along the branches of a tree' } },
+  'm-map-japan': { ja: '日本地図', en: 'Map of Japan', icon: 'map', desc: { ja: '都道府県を塗り分け、点や矢印を置く', en: 'Prefectures shaded, with points and arrows' } },
+  'm-predict': { ja: '予想と答え', en: 'Predict and check', icon: 'predict', desc: { ja: '予想を聞いてから答えを見せる', en: 'Asks for a guess, then shows the answer' } },
+  'm-timer': { ja: 'タイマー', en: 'Timer', icon: 'timer', desc: { ja: '演習やグループワークの残り時間', en: 'Time left for an exercise or group work' } },
+  'm-hist': { ja: 'ヒストグラム', en: 'Histogram', icon: 'hist', desc: { ja: 'データの分布を柱で', en: 'The distribution of data, as columns' } },
+  'm-boxplot': { ja: '箱ひげ図', en: 'Box plot', icon: 'boxplot', desc: { ja: '分布を箱とひげで比べる', en: 'Compares distributions with boxes and whiskers' } },
+  'm-seq': { ja: '分布の更新', en: 'Updating distribution', icon: 'dist', desc: { ja: '観測を加えるたびに分布が変わるようす', en: 'A distribution updated with each observation' } },
+  'm-hissan': { ja: '筆算', en: 'Column arithmetic', icon: 'hissan', desc: { ja: '筆算を 1 けたずつ', en: 'Column arithmetic, one digit at a time' } },
+  'm-numberline': { ja: '数直線', en: 'Number line', icon: 'numberline', desc: { ja: '数の位置と動きを数直線に', en: 'Numbers and moves on a number line' } },
+  'm-tape': { ja: 'テープ図', en: 'Tape diagram', icon: 'tape', desc: { ja: '量の関係をテープ図・線分図で', en: 'Quantities as tape or line diagrams' } },
+  'm-kakijun': { ja: '書き順', en: 'Stroke order', icon: 'kakijun', desc: { ja: '漢字の書き順を 1 画ずつ', en: 'Stroke order, one stroke at a time' } },
+  'm-keyboard': { ja: '鍵盤', en: 'Keyboard', icon: 'keyboard', desc: { ja: '鍵盤で音階や和音を示す', en: 'Scales and chords on a piano keyboard' } },
+  'm-syntax': { ja: '英文の構造', en: 'Sentence structure', icon: 'syntax', desc: { ja: '英文の S V O C M と句・節', en: 'S V O C M, phrases and clauses of a sentence' } },
+  'm-heatmap': { ja: 'ヒートマップ', en: 'Heatmap', icon: 'heatmap', desc: { ja: '表の値を色の濃さで', en: 'Values in a grid, as shades' } },
+  'm-map-world': { ja: '世界地図', en: 'World map', icon: 'mapworld', desc: { ja: '国や地域を塗り分け、点や矢印を置く', en: 'Countries shaded, with points and arrows' } },
+  'm-cards': { ja: 'カード', en: 'Cards', icon: 'menu', desc: { ja: 'アイコン付きのカードを並べて 1 枚ずつ出す', en: 'Cards with icons, shown one at a time' } },
+  'm-score': { ja: '楽譜', en: 'Score', icon: 'keyboard', desc: { ja: '五線譜を 1 音ずつ出して鳴らす', en: 'Staff notation, one note at a time, with sound' } },
+  'm-orbit': { ja: '月の満ち欠け', en: 'Moon phases', icon: 'cycle', desc: { ja: '月の位置と見える形を並べて動かす', en: 'The Moon’s position and its visible shape, moving together' } },
+});
+export const partLabel = (tag, lang) => (PART_LABELS[tag] ? PART_LABELS[tag][lang === 'ja' ? 'ja' : 'en'] : tag);
+export const partDesc = (tag, lang) => (PART_LABELS[tag] && PART_LABELS[tag].desc ? PART_LABELS[tag].desc[lang === 'ja' ? 'ja' : 'en'] : '');
+export const partIcon = (tag) => (PART_LABELS[tag] ? PART_LABELS[tag].icon : 'other');
+export const standardParts = (lang) => FREE_CORE.map((t) => partLabel(t, lang));
+// 並べる順：標準パーツ（FREE_CORE）、それから表の順（表にない部品は最後に名前の順）
+const ORDER = [...FREE_CORE, ...Object.keys(PART_LABELS).filter((t) => !FREE_CORE.includes(t))];
+export const partOrder = (tags) => [...tags].sort((a, b) => {
+  const i = ORDER.indexOf(a), j = ORDER.indexOf(b);
+  return (i < 0 ? ORDER.length : i) - (j < 0 ? ORDER.length : j) || (a < b ? -1 : a > b ? 1 : 0);
+});