egatari 0.0.0-stage → 0.6.4

package/kit/core/sounds.mjs

@@ -0,0 +1,149 @@
+// 部品の音（format spec §8.4）。DOM・通信・音声ファイルなし。時刻は秒、PCM はモノラル。
+// 不正なイベントは捨て、同じ時刻の順は保つ。呼び手の配列は変えない。
+export function midiPitch(value) {
+  if (Number.isInteger(value) && value >= 0 && value <= 127) return value;
+  if (typeof value !== 'string') return null;
+  const p = /^([A-G])([#b♯♭]?)(-?\d+)$/i.exec(value);
+  if (!p) return null;
+  const n = (Number(p[3]) + 1) * 12 + { C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11 }[p[1].toUpperCase()]
+    + (p[2] === '#' || p[2] === '♯' ? 1 : p[2] ? -1 : 0);
+  return Number.isInteger(n) && n >= 0 && n <= 127 ? n : null;
+}
+
+export function normalize(events) {
+  const out = [];
+  if (!Array.isArray(events)) return out;
+  for (const e of events) {
+    if (!e || !Number.isFinite(e.t) || e.t < 0) continue;
+    if (e.sound === 'bell') {
+      const count = e.count === undefined ? 1 : e.count;
+      if (Number.isInteger(count) && count >= 1 && count <= 3) out.push({ t: e.t, sound: 'bell', count });
+    } else if (e.sound === 'chime') out.push({ t: e.t, sound: 'chime' });
+    else if (e.sound === 'note') {
+      const pitch = midiPitch(e.pitch);
+      if (pitch !== null && Number.isFinite(e.dur) && e.dur > 0 && Number.isFinite(e.vel) && e.vel >= 0 && e.vel <= 1
+        && Number.isFinite(e.t + e.dur)) out.push({ t: e.t, sound: 'note', pitch, dur: e.dur, vel: e.vel });
+    }
+  }
+  return out.sort((a, b) => a.t - b.t);
+}
+
+// 通常の再生だけで (tPrev, tNow] を拾う。初回の 0 秒は tPrev = -1 で拾える。
+// 時刻だけでは跳んだかは判らない。跳ぶ・シークのときは {jump:true} / {seek:true}、または tPrev = null。
+export function crossed(events, tPrev, tNow, opts = {}) {
+  if (opts.jump || opts.seek || !Number.isFinite(tPrev) || !Number.isFinite(tNow) || tNow <= tPrev) return [];
+  return normalize(events).filter((e) => e.t > tPrev && e.t <= tNow);
+}
+
+// ライブの延長：倍率、または {duration: 元の長さ, extension: 延長の合計秒}。
+// 開始時刻だけを比例して動かす。音の長さ・ベルの間隔は変えず、毎回作者のイベントから計算する。
+export function retime(events, timing) {
+  let factor = timing;
+  if (timing && typeof timing === 'object') {
+    const { duration, extension } = timing;
+    if (!Number.isFinite(duration) || duration <= 0 || !Number.isFinite(extension)) throw new RangeError('invalid sound extension');
+    factor = Math.max(0, duration + extension) / duration;
+  }
+  if (!Number.isFinite(factor) || factor < 0) throw new RangeError('invalid sound timing factor');
+  return normalize(normalize(events).map((e) => ({ ...e, t: e.t * factor })));
+}
+
+// Web Audio と PCM で同じ音色・包絡を使う。ベルは倍音が整数倍でない短い打音。
+function voices(events) {
+  const out = [];
+  const add = (t, dur, freq, amp, type = 'sine', decay = false) => {
+    out.push({ t, dur, freq, amp, type, decay, attack: Math.min(.008, dur / 4), release: Math.min(.04, dur / 4) });
+  };
+  for (const e of normalize(events)) {
+    if (e.sound === 'note') {
+      const f = 440 * 2 ** ((e.pitch - 69) / 12);
+      add(e.t, e.dur, f, .12 * e.vel);
+      add(e.t, e.dur, f, .025 * e.vel, 'triangle');
+    } else if (e.sound === 'bell') {
+      for (let n = 0; n < e.count; n++) {
+        add(e.t + n * .6, .95, 660, .13, 'sine', true);
+        add(e.t + n * .6, .65, 660 * 2.76, .055, 'sine', true);
+        add(e.t + n * .6, .4, 660 * 5.4, .025, 'sine', true);
+      }
+    } else {
+      add(e.t, .55, 880, .12, 'sine', true);
+      add(e.t + .12, .7, 1174.659, .12, 'sine', true);
+    }
+  }
+  return out;
+}
+
+// 普通の和音はそのまま加算。密な和音でも波形を切らず、重なる音の振幅の上限で全体を下げる。
+function headroom(vs) {
+  const edges = vs.flatMap((v) => [[v.t, v.amp], [v.t + v.dur, -v.amp]]).sort((a, b) => a[0] - b[0] || a[1] - b[1]);
+  let sum = 0, peak = 0;
+  for (const [, amp] of edges) { sum += amp; peak = Math.max(peak, sum); }
+  return peak > .9 ? .9 / peak : 1;
+}
+
+function envelope(v, t) {
+  if (t < 0 || t >= v.dur) return 0;
+  if (t < v.attack) return t / v.attack;
+  const end = v.dur - v.release;
+  if (t >= end) return (v.decay ? .001 : 1) * (v.dur - t) / v.release;
+  return v.decay ? .001 ** ((t - v.attack) / (end - v.attack)) : 1;
+}
+
+// when はイベントの 0 秒に当たる AudioContext の時刻。ctx を作る・resume するのは呼び手（P3）。
+// opts: {destination, gain:0..1, offset:開始位置の秒}。offset より前から続く音も途中から鳴らす。
+// 通常の次の段階では stop しない。戻る・跳ぶ・シーク・ミュートでは保持している全ハンドルを stop する。
+export function schedule(ctx, events, when = ctx.currentTime, opts = {}) {
+  if (!Number.isFinite(when)) throw new RangeError('invalid sound start');
+  const offset = opts.offset ?? 0, volume = opts.gain ?? 1;
+  if (!Number.isFinite(offset) || offset < 0 || !Number.isFinite(volume) || volume < 0 || volume > 1) throw new RangeError('invalid sound options');
+  const vs = voices(events).filter((v) => v.freq < ctx.sampleRate / 2);
+  const scale = headroom(vs) * volume, active = new Set();
+  for (const v of vs) {
+    const origin = when + v.t - offset, end = origin + v.dur, start = Math.max(ctx.currentTime, origin);
+    if (end <= start || !scale || !v.amp) continue;
+    const osc = ctx.createOscillator(), gain = ctx.createGain();
+    osc.type = v.type; osc.frequency.setValueAtTime(v.freq, start);
+    const amp = v.amp * scale, age = start - origin, attackEnd = origin + v.attack, releaseStart = end - v.release;
+    gain.gain.setValueAtTime(amp * envelope(v, age), start);
+    if (start < attackEnd) gain.gain.linearRampToValueAtTime(amp, attackEnd);
+    if (start < releaseStart) {
+      if (v.decay) gain.gain.exponentialRampToValueAtTime(amp * .001, releaseStart);
+      else gain.gain.setValueAtTime(amp, releaseStart);
+    }
+    gain.gain.linearRampToValueAtTime(0, end);
+    osc.connect(gain); gain.connect(opts.destination || ctx.destination);
+    const node = { osc, gain };
+    active.add(node);
+    osc.onended = () => { active.delete(node); osc.disconnect(); gain.disconnect(); };
+    osc.start(start); osc.stop(end);
+  }
+  return { stop() {
+    for (const { osc, gain } of active) {
+      gain.gain.cancelScheduledValues(ctx.currentTime);
+      gain.gain.setValueAtTime(0, ctx.currentTime);
+      osc.stop(ctx.currentTime);
+    }
+    active.clear();
+  } };
+}
+
+// 返り値は Float32Array。既定では 0 秒から最後の余韻まで（ceil で標本数を決める）。
+// {start, duration} で区間を書き出せる。同じ全イベントを渡せば、段階の境目でも位相と音量が続く。
+export function renderPCM(events, sampleRate, opts = {}) {
+  if (!Number.isInteger(sampleRate) || sampleRate < 1 || sampleRate > 384000) throw new RangeError('invalid sound sample rate');
+  const all = voices(events), vs = all.filter((v) => v.freq < sampleRate / 2);
+  const start = opts.start ?? 0, duration = opts.duration ?? Math.max(0, all.reduce((end, v) => Math.max(end, v.t + v.dur), 0) - start);
+  if (!Number.isFinite(start) || start < 0 || !Number.isFinite(duration) || duration < 0) throw new RangeError('invalid sound PCM window');
+  const out = new Float32Array(Math.ceil(duration * sampleRate)), scale = headroom(vs);
+  for (const v of vs) {
+    const lo = Math.max(0, Math.ceil((v.t - start) * sampleRate));
+    const hi = Math.min(out.length, Math.ceil((v.t + v.dur - start) * sampleRate));
+    for (let i = lo; i < hi; i++) {
+      const age = start + i / sampleRate - v.t, phase = 2 * Math.PI * v.freq * age;
+      const wave = v.type === 'triangle' ? 2 / Math.PI * Math.asin(Math.sin(phase)) : Math.sin(phase);
+      out[i] += wave * v.amp * scale * envelope(v, age);
+    }
+  }
+  return out;
+}
+

package/kit/core/template-text.mjs

@@ -0,0 +1,88 @@
+// スライドの雛形の決まった文字（編集アプリのスライド一覧が足す雛形。kit/core/slide-ops.mjs）と、口述原稿の仮の行の印。1 か所だけに書く
+// Node にもブラウザにも依存しない（読み込むのは parse5 と narration-core だけ）。品質チェック（kit/check.mjs と編集アプリ）・TTS（tools/narration-json.mjs）・
+// 書き出し（kit/build.mjs の --portable / --play-only と編集アプリ）が読み、直し忘れを知らせる（警告。止めない）
+//
+//   PLACEHOLDER_MARK・placeholderLine(hint)・isPlaceholder(text)   口述原稿の仮の行：「✎ 」で始まる 1 行（TTS がそのまま読まないよう、直し忘れを見つける印）
+//   TEMPLATE_TEXT[lang][kind]                                       雛形の見出し・本文・結論の行・仮の口述原稿の言葉（ja・en）
+//   TEMPLATE_DEFAULTS                                               スライドに出る雛形の字（両方の言葉。比べるときは空白をそろえる）
+//   placeholderSteps(narration)  → [{slideKey, stepKey, line, text}]  仮の行が残っている段階
+//   templateTextIn(deck)         → [{index, key, texts: [字…]}]      雛形のままの字が残っているスライド
+//   draftLeftovers(deck, narration) → {steps, slides}               上の 2 つ（書き出しと TTS の前に見せる）
+import { parse } from 'parse5';
+import { parseNarration } from './narration-core.mjs';
+import { analyzeSlideIds } from './build-core.mjs';
+
+export const PLACEHOLDER_MARK = '✎';
+export const placeholderLine = (hint) => `${PLACEHOLDER_MARK} ${hint}`;
+export const isPlaceholder = (text) => String(text ?? '').trimStart().startsWith(PLACEHOLDER_MARK);
+
+// 雛形の字。h：見出し、そのほかはスライドに出る字。n・ni・nc：仮の口述原稿（placeholderLine で包む）
+export const TEMPLATE_TEXT = Object.freeze({
+  ja: {
+    'title-body': { h: '新しいスライドの見出し', li: ['1 つ目の項目', '2 つ目の項目'], concl: '⇒ このスライドの結論', n: 'このスライドで話すことを書く', ni: ['1 つ目の項目で話すことを書く', '2 つ目の項目で話すことを書く'], nc: '結論の行で話すことを書く' },
+    'two-cols': { h: '2 つを比べる見出し', a: '左の列の見出し', b: '右の列の見出し', la: '左の列の項目', lb: '右の列の項目', concl: '⇒ 比べて分かること', n: '左と右を比べて話すことを書く', nc: '結論の行で話すことを書く' },
+    figure: { h: '図の題', fig: '図をここに', cap: '図 1：図の説明', concl: '→ 図から読み取れること', n: '図を指しながら話すことを書く', nc: '結論の行で話すことを書く' },
+    section: { h: '新しい章の題', lead: 'この章で話すこと', n: 'この章で話すことを書く' },
+    quote: { h: '引用の題', q: '「引用する文をここに書きます」', cite: '— 出典', n: '引用を読み上げ、何を言っているかを書く' },
+  },
+  en: {
+    'title-body': { h: 'New slide heading', li: ['First point', 'Second point'], concl: '⇒ The point of this slide', n: 'Write what you say on this slide', ni: ['Write what you say with the first point', 'Write what you say with the second point'], nc: 'Write what you say with the conclusion line' },
+    'two-cols': { h: 'Heading for the comparison', a: 'Left column heading', b: 'Right column heading', la: 'Left column point', lb: 'Right column point', concl: '⇒ What the comparison shows', n: 'Write how you compare the left and the right', nc: 'Write what you say with the conclusion line' },
+    figure: { h: 'Figure title', fig: 'Figure goes here', cap: 'Figure 1: what it shows', concl: '→ What the figure shows', n: 'Write what you say while pointing at the figure', nc: 'Write what you say with the conclusion line' },
+    section: { h: 'New chapter title', lead: 'What this chapter covers', n: 'Write what this chapter covers' },
+    quote: { h: 'Quote title', q: '“Write the quoted text here.”', cite: '— Source', n: 'Read the quote and write what it means' },
+  },
+});
+const NARR_KEYS = new Set(['n', 'ni', 'nc']);
+const norm = (s) => String(s ?? '').replace(/\s+/g, ' ').trim();
+export const TEMPLATE_DEFAULTS = Object.freeze([...new Set(Object.values(TEMPLATE_TEXT).flatMap((L) => Object.values(L).flatMap((t) =>
+  Object.entries(t).filter(([k]) => !NARR_KEYS.has(k)).flatMap(([, v]) => [].concat(v)).map(norm))))]);
+const DEFAULTS = new Set(TEMPLATE_DEFAULTS);
+
+export function placeholderSteps(narration) {
+  if (narration == null) return [];
+  const out = [];
+  for (const g of parseNarration(String(narration))) {
+    const t = g.turns.find((x) => isPlaceholder(x.raw));
+    if (t) out.push({ slideKey: g.slideKey, stepKey: g.stepKey, line: g.line, text: norm(t.raw).slice(0, 80) });
+  }
+  return out;
+}
+
+function walk(node, fn) {
+  fn(node);
+  for (const c of node.childNodes || []) walk(c, fn);
+  if (node.content) walk(node.content, fn);
+}
+const textOf = (n) => { let s = ''; walk(n, (x) => { if (x.nodeName === '#text') s += x.value; }); return s; };
+const isSlide = (n) => n.tagName === 'section' && ((n.attrs || []).find((a) => a.name === 'class')?.value || '').split(/\s+/).includes('slide');
+const ENT = { amp: '&', lt: '<', gt: '>', quot: '"', '#39': "'", nbsp: ' ' };
+
+export function templateTextIn(deck) {
+  const keys = analyzeSlideIds(String(deck)).slides;
+  const out = [];
+  let n = 0;
+  walk(parse(String(deck)), (node) => {
+    if (!node.tagName || !isSlide(node)) return;
+    const i = n++, found = new Set();
+    walk(node, (x) => {
+      if (!x.tagName || x === node) return;
+      const t = norm(textOf(x).replace(/&(amp|lt|gt|quot|#39|nbsp);/g, (m, e) => ENT[e]));
+      if (t && DEFAULTS.has(t)) found.add(t);
+    });
+    if (found.size) out.push({ index: i, key: keys[i] ? keys[i].key : `s${i + 1}`, texts: [...found] });
+  });
+  return out;
+}
+
+export function draftLeftovers(deck, narration) {
+  return { steps: placeholderSteps(narration), slides: deck == null ? [] : templateTextIn(deck) };
+}
+
+// コマンド（kit/build.mjs の --portable / --play-only）が出す行（英語と日本語の両方）。編集アプリは app/i18n.js の言葉で出す
+export function leftoverLines(left) {
+  const out = [];
+  for (const s of left.slides) out.push(`slide ${s.index + 1} (${s.key}): template text left / 雛形の字のまま: ${s.texts.map((x) => `“${x}”`).join(', ')}`);
+  for (const p of left.steps) out.push(`narration.md line ${p.line} (${p.slideKey}:${p.stepKey}): template placeholder (✎) left / 仮の口述原稿のまま: “${p.text}”`);
+  return out;
+}

package/kit/core/theme-metrics.mjs

@@ -0,0 +1,112 @@
+// テーマの寸法の宣言（theme.json の metrics。docs/contract.md §12、format spec §6、backlog #76）
+// テーマが体裁の箱（本文・結論の行・縦組みの列）を CSS で動かすとき、検査がどこを限りにするかをこの値で知る。
+// 描くのは CSS だけ（再生器・実行系は metrics を読まない）。値は 1280×720 の舞台の px
+//
+//   DEFAULT_METRICS                 今の kit/layouts.css の箱（metrics のないテーマはこれ。限りは今までの 565・680・1236・1162・124・44）
+//   applyMetrics(base, raw, name)   → {metrics, declared, warnings}   1 つの層（theme.json）の metrics を親の値（base）に重ねる
+//   limitsOf(M)                     → 検査の限り（layout-scan.mjs の中と同じ式。余裕の 6・4 は検査の方針で、metrics では変えない）
+//   sameMetrics(a, b)               既定と同じか（知らせに限りの値を添えるかの判断）
+//
+// 検証：metrics が object でない・v が 1 でない → その層を使わない（親の値）。知らない項目 → 無視。数でない・有限でない・
+// 範囲の外（x は 0〜1280、y は 0〜720）→ その項目だけ親の値。互いに合わない（本文の上端が結論の行より下など）→ その層を使わない。
+// どれも組み立ての警告（「theme-metrics: …」）で、誤りにはしない。Node の読み込み・fs を使わない（kit/core）
+
+export const METRICS_VERSION = 1;
+export const STAGE = Object.freeze({ width: 1280, height: 720 });
+
+export const DEFAULT_METRICS = Object.freeze({
+  v: 1,
+  body: Object.freeze({ left: 48, right: 48, top: 122, floor: 680, line: 46 }),
+  concl: Object.freeze({ top: 571, height: 72 }),
+  // tate.rule：layouts.css の縦の見出しの罫は 1166.25px に描かれる（右 48px、43px × 1.25 の列 + padding 10px + 罫 2px）。既定は 1166 のまま
+  // （1167 にすると縦組みの右の限りが 1px 動き、既定のテーマの結果が変わる）。ずれの確かめ（layout-scan.mjs の metricsProbe）は、描いた値そのもの
+  // （0.01px に丸めただけ）を宣言の値と比べるので、既定のテーマの余裕は 1px の許しに対して 0.25px（1px まるごとではない）。
+  // tools/theme-metrics.mjs measure は、塊を写す書き手のために限りが緩くなる側へ外向きに丸めるので、既定のテーマでも 1167 と出す
+  tate: Object.freeze({ rule: 1166, conclRight: 120, left: 48, floor: 680 }),
+});
+
+// 項目と、その値の範囲（x：横の座標・距離、y：縦の座標・高さ）
+export const METRICS_FIELDS = Object.freeze({
+  body: { left: 'x', right: 'x', top: 'y', floor: 'y', line: 'h' },
+  concl: { top: 'y', height: 'h' },
+  tate: { rule: 'x', conclRight: 'x', left: 'x', floor: 'y' },
+});
+const RANGE = { x: [0, STAGE.width, true], y: [0, STAGE.height, true], h: [0, STAGE.height, false] };   // [下, 上, 下を含むか]
+
+// 余裕（検査の方針。テーマでは変えない）：結論の行の上 6px、横の限りの外 4px
+const CONCL_GAP = 6, EDGE = 4;
+// 本文の幅の下限（本文が狭すぎる宣言は読み違いとみなす）
+const MIN_BODY_WIDTH = 320;
+
+const clone = (m) => ({ v: 1, body: { ...m.body }, concl: { ...m.concl }, tate: { ...m.tate } });
+const isObj = (x) => !!x && typeof x === 'object' && !Array.isArray(x);
+const show = (x) => { try { return JSON.stringify(x); } catch { return String(x); } };
+
+export function limitsOf(M) {
+  return {
+    conclBottom: M.concl.top - CONCL_GAP,          // 結論の行があるとき（565）
+    floor: M.body.floor,                            // 結論の行がないとき（680）
+    right: STAGE.width - M.body.right + EDGE,       // 横組みの右（1236）
+    tateFloor: M.tate.floor,                        // 縦組みの地（680）
+    tateRight: M.tate.rule - EDGE,                  // 縦組みの見出しの罫の手前（1162）
+    tateLeftConcl: M.tate.conclRight + EDGE,        // 縦組みの結論の列の外（124）
+    tateLeft: M.tate.left - EDGE,                   // 縦組みで結論のないとき（44）
+  };
+}
+
+export function sameMetrics(a, b = DEFAULT_METRICS) {
+  for (const g of Object.keys(METRICS_FIELDS)) for (const f of Object.keys(METRICS_FIELDS[g])) if (a[g][f] !== b[g][f]) return false;
+  return true;
+}
+
+// 互いの整合。崩れていれば理由の文字列
+function inconsistency(M) {
+  if (!(M.body.top < M.concl.top - CONCL_GAP)) return `body.top (${M.body.top}) must be above concl.top − ${CONCL_GAP} (${M.concl.top - CONCL_GAP})`;
+  if (!(M.concl.top + M.concl.height <= STAGE.height)) return `concl.top + concl.height (${M.concl.top + M.concl.height}) must be at most ${STAGE.height}`;
+  if (!(M.body.top < M.body.floor)) return `body.top (${M.body.top}) must be above body.floor (${M.body.floor})`;
+  if (!(M.body.left + MIN_BODY_WIDTH <= STAGE.width - M.body.right)) return `the body must be at least ${MIN_BODY_WIDTH}px wide (body.left ${M.body.left}, body.right ${M.body.right})`;
+  if (!(M.tate.conclRight < M.tate.rule)) return `tate.conclRight (${M.tate.conclRight}) must be left of tate.rule (${M.tate.rule})`;
+  if (!(M.tate.left < M.tate.rule)) return `tate.left (${M.tate.left}) must be left of tate.rule (${M.tate.rule})`;
+  return null;
+}
+
+// 1 つの層を重ねる。base は親の値（なければ DEFAULT_METRICS）。raw === undefined（書いていない）なら親のまま
+export function applyMetrics(base, raw, name = 'theme') {
+  const parent = clone(base || DEFAULT_METRICS);
+  const warnings = [];
+  const w = (t, tail) => warnings.push(`theme-metrics: theme "${name}": ${t}${tail === undefined ? '' : tail}`);
+  if (raw === undefined) return { metrics: parent, declared: false, warnings };
+  if (!isObj(raw)) { w(`"metrics" must be an object (got ${show(raw)})`, '; the whole block is ignored and the parent values are used'); return { metrics: parent, declared: false, warnings }; }
+  if (raw.v !== METRICS_VERSION) { w(`metrics.v must be ${METRICS_VERSION} (got ${show(raw.v)})`, '; the whole block is ignored and the parent values are used'); return { metrics: parent, declared: false, warnings }; }
+  const M = clone(parent);
+  for (const g of Object.keys(raw)) {
+    if (g === 'v') continue;
+    if (!Object.prototype.hasOwnProperty.call(METRICS_FIELDS, g)) { w(`unknown field metrics.${g}`, ' (ignored)'); continue; }
+    const grp = raw[g];
+    if (!isObj(grp)) { w(`metrics.${g} must be an object (got ${show(grp)})`, '; the parent values are used'); continue; }
+    for (const f of Object.keys(grp)) {
+      const kind = METRICS_FIELDS[g][f];
+      if (!kind) { w(`unknown field metrics.${g}.${f}`, ' (ignored)'); continue; }
+      const v = grp[f], [lo, hi, incl] = RANGE[kind];
+      if (typeof v !== 'number' || !Number.isFinite(v) || v > hi || (incl ? v < lo : v <= lo)) {
+        w(`metrics.${g}.${f} must be a number ${incl ? `from ${lo}` : `above ${lo}`} to ${hi} (stage pixels of 1280×720; got ${show(v)})`, `; the parent value ${parent[g][f]} is used`);
+        continue;
+      }
+      M[g][f] = v;
+    }
+  }
+  const bad = inconsistency(M);
+  if (bad) { w(`the values do not fit together: ${bad}`, '; the whole block is ignored and the parent values are used'); return { metrics: parent, declared: false, warnings }; }
+  return { metrics: M, declared: true, warnings };
+}
+
+// 層を親から順に（[根の親, …, 子]）。どこかの層が有効な metrics を書いていれば declared
+export function resolveMetrics(layers) {
+  let m = clone(DEFAULT_METRICS), declared = false;
+  const warnings = [];
+  for (const L of layers || []) {
+    const r = applyMetrics(m, L && L.metrics, L && L.name);
+    m = r.metrics; declared = declared || r.declared; warnings.push(...r.warnings);
+  }
+  return { metrics: m, declared, warnings };
+}

package/kit/core/theme-shapes.mjs

@@ -0,0 +1,78 @@
+// テーマの形（見出し・表紙・結論の行）の決まった CSS の断片（#129、テーマを作る画面 #58 第 2 版 handoff/theme-builder-v2-2026-10-27.md）。
+// 同梱のテーマはこの断片をそのまま tokens.css に写し、どれを選んだかを theme.json の look に書く（{"heading": "band", "cover": "left-bar", "concl": "left-rule"}）。
+// テーマを作る画面は同じ断片を並べるだけで、選んだ形のテーマを書き出せる。tools/test-themes.mjs が、tokens.css の中の断片がここと同じかを確かめる。
+// 断片はテーマのファイルに写す（組み立てはここを読まない）ので、ここを変えても出したテーマの見た目と hash は変わらない（変えたら写したテーマの版を上げる）。
+//
+// 決まり：
+//   - 箱（本文・結論の行・見出しの行）の位置と大きさは変えない（はみ出しの検査が変わらない）。見出しの帯は、見出しの行の上の余白に広げるだけ
+//   - 色はテーマの変数だけ（--base・--emph・--rule・--sec-fg・--base-wash・--base-tint）
+//   - 組み込みの規則（kit/layouts.css。.slide h2 は 0,1,1）と同じ以上の詳細度で書く。:where() で包まない
+//     （包むと詳細度が 0 になり、色や下線のような一部の宣言だけが組み込みの規則に負ける。帯の上に --title の紺の字が乗る、など）
+//   - 縦書き（layout-tate）・表紙・章の扉の見出しには掛けない（:not(.cover):not(.sec):not(.layout-tate)）
+//
+// 断片の印：tokens.css では `/* look <key>: <id> */` の行の次から `/* /look */` の行の前までが断片（間を書き換えない）
+const H = '.slide:not(.cover):not(.sec):not(.layout-tate) > h2';
+
+export const SHAPES = Object.freeze({
+  heading: Object.freeze({
+    // 下線（既定。kit/layouts.css のまま）
+    underline: '',
+    // 太い下線と、題の前の四角（常盤）
+    'thick-square': `${H}{border-bottom-width:5px;padding-left:34px}\n${H}::before{content:"";position:absolute;left:0;top:14px;width:20px;height:20px;background:var(--base)}`,
+    // 左の縦の帯、下線なし（江戸紫）
+    'left-bar': `${H}{border-bottom:0;border-left:10px solid var(--base);padding:4px 0 4px 18px}`,
+    // 二重線（焦茶）
+    double: `${H}{border-bottom:6px double var(--base)}`,
+    // 淡い地の角丸、下線なし（浅葱）
+    soft: `${H}{border-bottom:0;background:var(--base-wash);border-radius:16px;padding:8px 22px}`,
+    // 基調色の帯に白抜き、下に --rule の線（墨）
+    band: `${H}{left:0;right:0;top:0;padding:26px 48px 18px;background:var(--base);color:var(--sec-fg,#fff);border-bottom:4px solid var(--rule)}`,
+  }),
+  cover: Object.freeze({
+    // 中央・上に細い帯（既定。kit/layouts.css のまま）
+    'top-band': '',
+    // 中央・上に太い帯（常盤）
+    'top-band-wide': '.slide.cover::before{height:22px}',
+    // 左寄せと左の縦線。章の扉も左寄せで、題の左に縦線（墨）
+    'left-bar': [
+      '.slide.cover{text-align:left}',
+      '.slide.cover::before{left:0;right:auto;top:0;bottom:0;width:18px;height:auto;background:var(--rule)}',
+      '.slide.cover h1{left:96px;color:var(--fg)}',
+      '.slide.cover .venue,.slide.cover .au{left:96px}',
+      '.slide.sec h1,.slide.sec h2,.slide.sec .lead{text-align:left;left:96px}',
+      '.slide.sec h1,.slide.sec h2{border-left:10px solid var(--rule);padding-left:24px;margin-left:-34px}',
+    ].join('\n'),
+    // 下に帯（江戸紫）
+    'bottom-band': '.slide.cover::before{top:auto;bottom:0;height:120px}\n.slide.cover .au{top:420px}',
+    // 細い枠（焦茶）
+    frame: '.slide.cover::before{left:28px;right:28px;top:28px;bottom:28px;height:auto;background:transparent;border:2px solid var(--base)}',
+    // 右上の角に大きな丸（浅葱）
+    circle: '.slide.cover::before{left:auto;right:-80px;top:-80px;width:300px;height:300px;border-radius:50%;background:var(--base-tint)}',
+  }),
+  concl: Object.freeze({
+    // 左の縦線（既定。themes/default/tokens.css 1.2.0）
+    'left-rule': '',
+    // 角丸の枠（浅葱）
+    rounded: '.slide:not(.layout-tate) .concl{border:2.3px solid var(--emph);border-radius:36px;padding-left:24px}',
+  }),
+});
+// 名前のない形（look を書かないテーマ）は既定の形
+export const DEFAULT_LOOK = Object.freeze({ heading: 'underline', cover: 'top-band', concl: 'left-rule' });
+
+// look → tokens.css に写す断片（印の行も含む）。既定の形（空の断片）は書かない
+export function lookCss(look) {
+  const out = [];
+  for (const key of Object.keys(DEFAULT_LOOK)) {
+    const id = (look && look[key]) || DEFAULT_LOOK[key];
+    const css = SHAPES[key] && SHAPES[key][id];
+    if (css === undefined) throw new Error(`theme look: unknown ${key} "${id}"`);
+    if (css) out.push(`/* look ${key}: ${id} */\n${css}\n/* /look */`);
+  }
+  return out.join('\n');
+}
+// tokens.css から断片を読み出す：{key: {id, css}}。改行は LF にそろえてから（Windows の checkout は CRLF）
+export function lookIn(tokensCss) {
+  const out = {};
+  for (const m of String(tokensCss).replace(/\r\n?/g, '\n').matchAll(/\/\* look (\w+): ([\w-]+) \*\/\n([\s\S]*?)\n\/\* \/look \*\//g)) out[m[1]] = { id: m[2], css: m[3] };
+  return out;
+}

package/kit/core/themes-list.mjs

@@ -0,0 +1,23 @@
+// 同梱のテーマのうち、新しく選べるもの（#129）：画面に出す順・見せる名前（和色の名前）・小さく添える「向き」。
+// 編集アプリ（新規作成のテーマの段・「テーマを変更…」）と npm run new が使う。名前（value）は themes/<名前>/ と <html data-theme>。
+// RETIRED：同梱のまま（版を記録した教材・data-theme に書いた教材は前の見た目で組める）だが、新しくは選べないもの
+export const CHOOSABLE = Object.freeze([
+  { name: 'default', label: { ja: '藍', en: 'Indigo' }, note: { ja: '研究・講義向け', en: 'For research and classes' } },
+  { name: 'sumi', label: { ja: '墨', en: 'Ink' }, note: { ja: '報告・提案向け', en: 'For reports and proposals' } },
+  { name: 'kokugo', label: { ja: '国語', en: 'Kokugo' }, note: { ja: '国語・和の題材向け', en: 'For Japanese language arts' } },
+  { name: 'tokiwa', label: { ja: '常盤', en: 'Evergreen' }, note: { ja: '理科・自然・学校向け', en: 'For science, nature and schools' } },
+  { name: 'murasaki', label: { ja: '江戸紫', en: 'Edo purple' }, note: { ja: '研究・一般の講演向け', en: 'For research and public talks' } },
+  { name: 'kogecha', label: { ja: '焦茶', en: 'Dark brown' }, note: { ja: '人文・歴史・地域向け', en: 'For humanities, history and local studies' } },
+  { name: 'asagi', label: { ja: '浅葱', en: 'Teal' }, note: { ja: '小学校・広報・案内向け', en: 'For primary schools, publicity and guides' } },
+].map((t) => Object.freeze(t)));
+export const RETIRED = Object.freeze(['business']);
+// 選べなくしたテーマの見せる名前（その教材を開いたときの「テーマを変更…」の今のテーマ）
+export const RETIRED_LABEL = Object.freeze({ business: { ja: 'ビジネス', en: 'Business' } });
+export const RETIRED_NOTE = Object.freeze({ ja: '新しくは選べない', en: 'No longer offered for new lessons' });
+// 同梱のテーマの名前の並び（have：同梱のテーマの名前）→ 選べるものを画面の順に。同梱にあって一覧にないもの（RETIRED を除く）は後ろに名前の順
+export function choosableOf(have) {
+  const set = new Set(have);
+  return [...CHOOSABLE.filter((t) => set.has(t.name)).map((t) => t.name), ...[...set].filter((n) => !CHOOSABLE.some((t) => t.name === n) && !RETIRED.includes(n)).sort()];
+}
+export const themeLabel = (name, lang) => { const t = CHOOSABLE.find((x) => x.name === name); const l = lang === 'en' ? 'en' : 'ja'; return t ? t.label[l] : RETIRED_LABEL[name] ? RETIRED_LABEL[name][l] : name; };
+export const themeNote = (name, lang) => { const t = CHOOSABLE.find((x) => x.name === name); const l = lang === 'en' ? 'en' : 'ja'; return t ? t.note[l] : RETIRED.includes(name) ? RETIRED_NOTE[l] : ''; };

package/kit/core/themes-lock.mjs

@@ -0,0 +1,150 @@
+// 同梱のテーマ（themes/<名前>/）の版と、前の版の写し（vendor/themes/<名前>/<版>/）の固定（themes.lock.json）
+//   部品庫の部品の固定（components.lock.json・kit/core/components-lock.mjs）と同じ考え方：前の版で組んだ教材を、黙って新しい見た目にしない。
+//   今の版：themes/<名前>/（theme.json の version）　　前の版：vendor/themes/<名前>/<版>/（その版のテーマのファイルをバイトのまま。直さない）
+//   固定：themes.lock.json（手で書く。npm run themes:check が写しと hash を確かめる）
+//     { "themes": { "<名前>": { "current": "1.1.0", "versions": ["1.0.0", "1.1.0"],
+//                                "sha256": { "1.0.0": "<テーマの同一性の sha256>", "1.1.0": "…" },
+//                                "changes": { "1.1.0": { "date": "2026-10-24", "reason": "…",
+//                                                         "tokens": [{ "token": "--emph", "from": "#C50516", "to": "#BE3012" }] } } } } }
+//     sha256 は、書き出し（kit/core/portable.mjs）が index.themes に書くものと同じ：テーマのファイルごとの「<相対パス>\t<sha256>\n」を
+//     パスの順に並べたものの sha256（format spec §6。字のファイルは改行をそろえる。kit/core/identity-hash.mjs）。
+//     changes.<版> は、その版で変わった色（ふつうの画面で描かれる色。from は 1 つ前の版）。編集アプリの「テーマを更新」の知らせに出す
+// 文書が記録したテーマ（index.themes の {name, version, sha256}）は sha256 の合う版に結ぶ（themeVersionForSha）。
+// 作業フォルダは設定のファイル（FORMAT.CONFIG_FILE）の themes（{名前: 版}）で固定する（展開が書く。部品の components と同じ）。
+// 組み立て（build-core）・持ち運べる 1 ファイル（portable）・編集アプリが共有する。node: の読み込み・fs・process を使わない（読み書きは env を通す）
+import { NAME_RE, VERSION_RE } from './components-lock.mjs';
+
+export const THEMES_LOCK_FILE = 'themes.lock.json';
+// テーマのフォルダの最上位の文書（README*・LICENSE*・*.md）：テーマの一部でない（format spec §6：テーマの sha256 は組み立てが読むファイル＝
+// スタイルシート・宣言のファイル・参照する資源だけ）。rel はテーマのフォルダからの相対パス。2 つの決まりを分ける：
+//   excludedFromThemeHash：hash に入れない・組み立てで読まない（ロゴに書いても）。README*・LICENSE*・*.md
+//   excludedFromThemeCopy：利用者のテーマを 1 ファイルに入れるとき写さない。README* と *.md だけ。LICENSE* は写す
+//     （書体・機関のロゴの使用条件は、資源を配り直す先に付いていく。§3.3 の閉包）
+const topLevel = (rel) => { const r = String(rel).replace(/\\/g, '/').replace(/^\.\//, ''); return r.includes('/') ? null : r; };
+export const isThemeLicense = (rel) => { const r = topLevel(rel); return r !== null && /^licen[cs]e/i.test(r); };
+export function excludedFromThemeHash(rel) {
+  const r = topLevel(rel);
+  return r !== null && (/^(?:readme|licen[cs]e)/i.test(r) || /\.md$/i.test(r));
+}
+export function excludedFromThemeCopy(rel) {
+  const r = topLevel(rel);
+  return r !== null && !isThemeLicense(r) && (/^readme/i.test(r) || /\.md$/i.test(r));
+}
+export const VENDOR_THEMES = ['vendor', 'themes'];
+const SHA_RE = /^[0-9a-f]{64}$/;
+const COLOR_RE = /^#[0-9A-Fa-f]{6}$/;
+const isObj = (x) => x !== null && typeof x === 'object' && !Array.isArray(x);
+const own = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+const cmpVer = (a, b) => { const x = a.split(/[.-]/).map(Number), y = b.split(/[.-]/).map(Number); for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] - y[i]; return 0; };
+
+// 固定のファイルの中身を確かめる。返すもの：問題の配列（空なら正しい）
+export function themesLockProblems(lock) {
+  if (!isObj(lock)) return ['not an object'];
+  if (!isObj(lock.themes)) return ['themes: not an object'];
+  const e = [];
+  for (const [name, t] of Object.entries(lock.themes)) {
+    const w = `themes.${name}`;
+    if (!NAME_RE.test(name)) e.push(`${w}: not a registry name`);
+    if (!isObj(t)) { e.push(`${w}: not an object`); continue; }
+    if (!Array.isArray(t.versions) || !t.versions.length) { e.push(`${w}.versions: not a non-empty array`); continue; }
+    for (const v of t.versions) if (typeof v !== 'string' || !VERSION_RE.test(v)) e.push(`${w}.versions: "${v}" is not a version`);
+    if (new Set(t.versions).size !== t.versions.length) e.push(`${w}.versions: duplicates`);
+    if (!t.versions.includes(t.current)) e.push(`${w}.current: "${t.current}" is not in versions`);
+    else if (t.versions.some((v) => VERSION_RE.test(v) && cmpVer(v, t.current) > 0)) e.push(`${w}.current: "${t.current}" is not the latest version`);
+    if (!isObj(t.sha256)) { e.push(`${w}.sha256: not an object`); continue; }
+    for (const v of t.versions) if (!(own(t.sha256, v) && SHA_RE.test(t.sha256[v]))) e.push(`${w}.sha256.${v}: not a sha256`);
+    for (const v of Object.keys(t.sha256)) if (!t.versions.includes(v)) e.push(`${w}.sha256.${v}: not in versions`);
+    if (own(t, 'changes')) {
+      if (!isObj(t.changes)) { e.push(`${w}.changes: not an object`); continue; }
+      for (const [v, c] of Object.entries(t.changes)) {
+        const cw = `${w}.changes.${v}`;
+        if (!t.versions.includes(v)) e.push(`${cw}: not in versions`);
+        if (!isObj(c)) { e.push(`${cw}: not an object`); continue; }
+        if (typeof c.date !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(c.date)) e.push(`${cw}.date: not YYYY-MM-DD`);
+        if (typeof c.reason !== 'string' || !c.reason || c.reason.length > 500) e.push(`${cw}.reason: not a short text`);
+        if (!Array.isArray(c.tokens)) { e.push(`${cw}.tokens: not an array`); continue; }
+        c.tokens.forEach((x, i) => {
+          if (!isObj(x) || typeof x.token !== 'string' || !/^--[a-z0-9-]{1,64}$/.test(x.token) || !COLOR_RE.test(String(x.from)) || !COLOR_RE.test(String(x.to))) e.push(`${cw}.tokens[${i}]: not {token: "--name", from: "#RRGGBB", to: "#RRGGBB"}`);
+        });
+      }
+    }
+  }
+  return e;
+}
+
+export function parseThemesLock(text) {
+  let lock;
+  try { lock = JSON.parse(text); } catch (err) { throw new Error(`${THEMES_LOCK_FILE}: ${err.message}`); }
+  const e = themesLockProblems(lock);
+  if (e.length) throw new Error(`${THEMES_LOCK_FILE}: ${e.join('; ')}`);
+  return lock;
+}
+// env（build-core の env）から読む。なければ null（版の固定はない：同梱のテーマはいつも今の版）
+export function readThemesLock(env, root) {
+  const f = env.path.join(root, THEMES_LOCK_FILE);
+  if (!env.exists(f)) return null;
+  return parseThemesLock(env.readText(f));
+}
+// 前の版の写しのフォルダ（<root>/vendor/themes）
+export const themesVendorDir = (P, root) => P.join(root, ...VENDOR_THEMES);
+const entry = (lock, name) => (lock && isObj(lock.themes) && own(lock.themes, name) && isObj(lock.themes[name]) ? lock.themes[name] : null);
+export const currentThemeVersion = (lock, name) => entry(lock, name)?.current || null;
+
+// 文書が記録したテーマの sha256 に合う版（なければ null）。prefer（記録の版）が合えばそれ、次に今の版、次に新しい版から
+export function themeVersionForSha(lock, name, sha, prefer) {
+  const t = entry(lock, name);
+  if (!t || typeof sha !== 'string') return null;
+  const m = t.sha256;
+  if (typeof prefer === 'string' && t.versions.includes(prefer) && m[prefer] === sha) return prefer;
+  if (m[t.current] === sha) return t.current;
+  for (const v of [...t.versions].reverse()) if (m[v] === sha) return v;
+  return null;
+}
+// 文書の索引のテーマ（index.themes）から、組み直しで使う版の固定を作る：{名前: 版}。今の版と同じものも入れる（部品の pinsForIndex と同じ）。
+// 固定のファイルにあるテーマで、合う版がないものは missing に
+export function themePinsForIndex(lock, themes) {
+  const pins = {}, missing = [];
+  for (const t of Array.isArray(themes) ? themes : []) {
+    if (!isObj(t) || t.source !== 'registry' || typeof t.name !== 'string' || !NAME_RE.test(t.name) || !entry(lock, t.name)) continue;
+    const v = themeVersionForSha(lock, t.name, t.sha256, t.version);
+    if (v) pins[t.name] = v; else missing.push(t);
+  }
+  return { pins, missing };
+}
+// 作業フォルダの設定のファイル（FORMAT.CONFIG_FILE）の themes：{名前: 版}。形が違うものは捨てる
+export function configThemePins(conf) {
+  if (!isObj(conf) || !isObj(conf.themes)) return {};
+  const out = {};
+  for (const [k, v] of Object.entries(conf.themes)) if (NAME_RE.test(k) && typeof v === 'string' && VERSION_RE.test(v)) out[k] = v;
+  return out;
+}
+// 使う版を決める：want（固定）が今の版なら今の版（themes/<名前>/）、前の版で写しがあればその版、なければ今の版と知らせ。
+// 返すもの：{version, pinned: boolean（前の版の写しを使う）, note}。固定のファイルにないテーマは version: null
+export function pickThemeVersion(lock, name, want) {
+  const t = entry(lock, name);
+  if (!t) return { version: null, pinned: false, note: null };
+  if (want === undefined || want === null || want === t.current) return { version: t.current, pinned: false, note: null };
+  if (typeof want === 'string' && t.versions.includes(want)) return { version: want, pinned: true, note: null };
+  return { version: t.current, pinned: false, note: `theme ${name}: version "${String(want).slice(0, 40)}" is not in ${THEMES_LOCK_FILE}; using ${t.current}` };
+}
+// 前の版 from から今の版までに変わった色：{name, from, to, date, reasons: [文字列], tokens: [{token, from, to}]}（同じ token は最初の from と最後の to）。
+// 変わりがなければ tokens は空
+export function themeUpdate(lock, name, from) {
+  const t = entry(lock, name);
+  if (!t || !t.versions.includes(from)) return null;
+  const later = t.versions.filter((v) => cmpVer(v, from) > 0 && cmpVer(v, t.current) <= 0).sort(cmpVer);
+  const tok = new Map(), reasons = [];
+  let date = null;
+  for (const v of later) {
+    const c = isObj(t.changes) && isObj(t.changes[v]) ? t.changes[v] : null;
+    if (!c) continue;
+    reasons.push(`${v}: ${c.reason}`); date = c.date;
+    for (const x of c.tokens) tok.set(x.token, { token: x.token, from: tok.has(x.token) ? tok.get(x.token).from : x.from, to: x.to });
+  }
+  return { name, from, to: t.current, date, reasons, tokens: [...tok.values()].filter((x) => x.from.toLowerCase() !== x.to.toLowerCase()) };
+}
+// 知らせの 1 行（CLI と編集アプリの警告の板）
+export function themePinnedWarning(u) {
+  const list = u.tokens.map((x) => `${x.token} ${x.from} → ${x.to}`).join(', ');
+  return `theme pinned: ${u.name} ${u.from} is the version this lesson recorded; the current ${u.name} is ${u.to}${list ? ` (${list})` : ''}. It is built with ${u.from}, never restyled silently. To update: in the editor press 「テーマを更新」 / Update theme; on the command line rebuild with --update-themes, or set "${u.name}": "${u.to}" under themes in egatari.json / 記録した版のテーマで組む。黙って新しい色にしない`;
+}