egatari 0.0.0-stage → 0.6.4

package/kit/core/live-results.mjs

@@ -0,0 +1,239 @@
+// 授業の部屋の結果（拡張 live の §3 Results。形は egatari/live の PROTOCOL.md の results、写しは FORMAT.LIVE_VENDOR_DIR の schema.json の $defs/results）。
+// 部屋のサービスから先生がダウンロードした JSON を、先生の教材に役割 data の添付（format spec §3.8）として足すための純ロジック。
+// Node にもブラウザにも依存しない（DOM・fs・時計に触れない）
+//
+//   parseResults(bytes)          → {ok: true, results, skipped} | {ok: false, code, errors}。code：'too-large' | 'not-utf8' | 'not-json' | 'not-results'
+//                                  （写しの Schema と同じ形か。tools/test-live-results.mjs が ajv と比べる）
+//                                  読み手は知らない項目と種類を無視する（拡張 live §3：Results readers MUST ignore unknown members and unknown kinds）。
+//                                  results からは落とし、skipped に {members: [名前…], kinds: {種類: 件数}} で数える（読んだ字そのまま。表示は skippedNotice）。
+//                                  知っている項目の形が壊れていれば今までどおり断る。取り込むときの JSON の bytes はそのまま残す（呼ぶ側が bytes を書く）
+//   isLiveResults(bytes)         結果のファイルか（中身で見分ける。名前を替えても分かる）
+//   summarizeResults(results)    {questions, responses, polls: [{id, step, prompt, choices, counts, total}]}（投票は活動の並び、その後に活動にない投票）
+//   resultsDate(results)         開いた日（window.from の日付。その時刻の時間帯のまま）
+//   roomMatch(results, live)     'match' | 'mismatch' | 'none'（教材の extensions.live に部屋がない）
+//   liveResultsWarning(paths)    1 ファイルに結果が入るときの知らせ（コマンド）
+//   resultsRecord(results, lang, taken)  添付の項目 {path, role: 'data', title, description}（題は部屋と日付だけ。学ぶ人の字も件数も入れない）
+//
+// 結果には学ぶ人が打った字（質問・名前）が入る。教材のファイルには残すが、学ぶ人に渡すもの（再生専用の派生・学ぶ人向けの添付）には入れない
+// （拡張 live §3：Results are never written into play-only derivatives）。表示は必ず文字として（textContent）
+import { FORMAT } from './format.mjs';
+
+export const RESULTS_MAX_BYTES = 10 * 1024 * 1024;   // 添付 1 つの上限（kit/core/attachments.mjs の ATTACH_LIMITS.fileBytes。§3.8）
+
+// 写しの Schema の $defs と同じ形（room・pid・activityId・stepKey・itemId・datetime）と上限
+const RE = {
+  room: /^r-[a-z2-7]{8}$/,
+  pid: /^[A-Za-z0-9_-]{16,43}$/,
+  activity: /^[A-Za-z0-9_-]{1,32}$/,
+  step: /^(\*|[^\u0000-\u001f\u007f:]{1,80}:[^\u0000-\u001f\u007f:]{1,16})$/,
+  item: /^q-[a-z2-7]{10}$/,
+  group: /^g-[a-z2-7]{10}$/,
+  sha256: /^[0-9a-f]{64}$/,
+  datetime: /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})$/,
+};
+const MAX = { prompt: 300, choice: 100, choices: 12, name: 40, text: 500, choiceIndex: 11, label: 80, reply: 200, strokes: 20, strokePoints: 500 };
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const own = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+const str = (v) => typeof v === 'string';
+// JSON Schema の maxLength は Unicode の符号位置で数える
+const cps = (s) => { let n = 0; for (const _ of s) n++; return n; };
+const short = (s, n) => str(s) && cps(s) <= n;
+const onlyKeys = (o, keys, at, e) => { for (const k of Object.keys(o)) if (!keys.includes(k)) e.push(`${at}: unknown member "${k.slice(0, 40)}"`); };
+const need = (o, keys, at, e) => { for (const k of keys) if (!own(o, k)) e.push(`${at}: "${k}" is missing`); };
+
+// 知らない項目・種類を落とす（読み手は無視する。拡張 live §3）。知っている形が壊れているかは resultsErrors が見る。
+// 返すもの：{value, skipped: {members: [名前…], kinds: {種類: 件数}}}。入れ物の形が違うところ（オブジェクトでない等）は触らず検査に任せる
+const SKIP_MAX = 50;
+const KEYS = {
+  results: ['v', 'room', 'window', 'activities', 'responses', 'exportedAt'], window: ['from', 'to'],
+  qa: ['id', 'kind', 'label'], confused: ['id', 'kind', 'label'], poll: ['id', 'kind', 'prompt', 'choices', 'label'],
+  rqa: ['kind', 'activity', 'step', 'pid', 'at', 'id', 'text', 'read', 'answered', 'shown', 'hidden', 'name', 'strokes', 'sourceSha256', 'group', 'reply'],
+  rconfused: ['kind', 'activity', 'step', 'pid', 'at'], rpoll: ['kind', 'activity', 'step', 'pid', 'at', 'choice', 'name'],
+};
+const KINDS = ['qa', 'confused', 'poll'];
+export function tolerate(v) {
+  const skipped = { members: [], kinds: {} };
+  const member = (k) => { if (skipped.members.length < SKIP_MAX && !skipped.members.includes(k)) skipped.members.push(k); };
+  const kind = (k) => { if (own(skipped.kinds, k) || Object.keys(skipped.kinds).length < SKIP_MAX) skipped.kinds[k] = (skipped.kinds[k] || 0) + 1; };
+  const strip = (o, keys) => { const out = {}; for (const k of Object.keys(o)) { if (keys.includes(k)) out[k] = o[k]; else member(k); } return out; };
+  // 種類が文字なのに知らないものは落として数える（種類がない・文字でないものは壊れているので残して検査で断る）
+  const known = (x, kinds) => !(isObj(x) && str(x.kind) && x.kind !== '' && !kinds.includes(x.kind) && (kind(x.kind), true));
+  if (!isObj(v)) return { value: v, skipped };
+  const out = strip(v, KEYS.results);
+  if (isObj(out.window)) out.window = strip(out.window, KEYS.window);
+  if (isObj(out.activities)) {
+    const acts = {};
+    for (const [step, list] of Object.entries(out.activities)) {
+      acts[step] = Array.isArray(list) ? list.filter((a) => known(a, KINDS)).map((a) => (isObj(a) && KINDS.includes(a.kind) ? strip(a, KEYS[a.kind]) : a)) : list;
+    }
+    out.activities = acts;
+  }
+  if (Array.isArray(out.responses)) out.responses = out.responses.filter((r) => known(r, KINDS)).map((r) => (isObj(r) && KINDS.includes(r.kind) ? strip(r, KEYS['r' + r.kind]) : r));
+  return { value: out, skipped };
+}
+export const hasSkipped = (s) => !!s && (s.members.length > 0 || Object.keys(s.kinds).length > 0);
+const clip = (x) => { const t = String(x).replace(/[\u0000-\u001f\u007f]/g, ' '); return cps(t) > 40 ? [...t].slice(0, 40).join('') + '…' : t; };
+// 知らなかった項目の知らせ（1 行。名前は読んだ字をそのまま出すので、呼ぶ側は必ず textContent / 文字として出す）。なければ null
+export function skippedNotice(s, lang) {
+  if (!hasSkipped(s)) return null;
+  const names = [...s.members.map(clip), ...Object.entries(s.kinds).map(([k, n]) => `${clip(k)} ×${n}`)];
+  const shown = names.slice(0, 10), more = names.length - shown.length;
+  const list = shown.join(lang === 'en' ? ', ' : '・') + (more > 0 ? (lang === 'en' ? `, and ${more} more` : `・ほか ${more} 件`) : '');
+  return lang === 'en'
+    ? `Items this Studio version doesn't know (${list}) were not imported. The file itself is kept as it is.`
+    : `この版の Studio が知らない項目（${list}）は取り込みませんでした。ファイルそのものはそのまま残します`;
+}
+
+function checkActivity(a, at, e) {
+  if (!isObj(a)) { e.push(`${at}: not an object`); return; }
+  // label：ステップの表示名（任意）。confused：「わからない」の一押し（文なし）
+  if (a.kind === 'qa' || a.kind === 'confused') { onlyKeys(a, ['id', 'kind', 'label'], at, e); need(a, ['id', 'kind'], at, e); }
+  else if (a.kind === 'poll') {
+    onlyKeys(a, ['id', 'kind', 'prompt', 'choices', 'label'], at, e); need(a, ['id', 'kind'], at, e);
+    if (own(a, 'prompt') && !short(a.prompt, MAX.prompt)) e.push(`${at}.prompt: not a string of at most ${MAX.prompt} characters`);
+    if (own(a, 'choices') && !(Array.isArray(a.choices) && a.choices.length <= MAX.choices && a.choices.every((c) => short(c, MAX.choice)))) e.push(`${at}.choices: not a list of at most ${MAX.choices} strings of at most ${MAX.choice} characters`);
+  } else { e.push(`${at}.kind: not "qa", "confused" or "poll"`); return; }
+  if (own(a, 'label') && !short(a.label, MAX.label)) e.push(`${at}.label: not a string of at most ${MAX.label} characters`);
+  if (own(a, 'id') && !(str(a.id) && RE.activity.test(a.id))) e.push(`${at}.id: not an activity id`);
+}
+// 囲んだところ（写しの $defs/strokes）：1〜20 本、1 本 2〜500 点、点は舞台の座標 [x (0–1280), y (0–720)]
+const isPoint = (p) => Array.isArray(p) && p.length === 2 && typeof p[0] === 'number' && typeof p[1] === 'number' && p[0] >= 0 && p[0] <= 1280 && p[1] >= 0 && p[1] <= 720;
+const isStrokes = (v) => Array.isArray(v) && v.length >= 1 && v.length <= MAX.strokes && v.every((s) => Array.isArray(s) && s.length >= 2 && s.length <= MAX.strokePoints && s.every(isPoint));
+function checkResponse(r, at, e) {
+  if (!isObj(r)) { e.push(`${at}: not an object`); return; }
+  const common = ['kind', 'activity', 'step', 'pid', 'at'];
+  if (r.kind === 'qa') {
+    const req = [...common, 'id', 'text', 'read', 'answered', 'shown', 'hidden'];
+    onlyKeys(r, [...req, 'name', 'strokes', 'sourceSha256', 'group', 'reply'], at, e); need(r, req, at, e);
+    if (own(r, 'id') && !(str(r.id) && RE.item.test(r.id))) e.push(`${at}.id: not a question id`);
+    if (own(r, 'strokes') && !isStrokes(r.strokes)) e.push(`${at}.strokes: not a circled region (strokes in stage coordinates)`);
+    if (own(r, 'sourceSha256') && !(str(r.sourceSha256) && RE.sha256.test(r.sourceSha256))) e.push(`${at}.sourceSha256: not a sha256`);
+    if (own(r, 'group') && !(str(r.group) && RE.group.test(r.group))) e.push(`${at}.group: not a group id`);
+    if (own(r, 'reply')) {
+      const y = r.reply;
+      if (!isObj(y) || Object.keys(y).some((k) => !['text', 'at', 'public'].includes(k)) || !(str(y.text) && cps(y.text) >= 1 && cps(y.text) <= MAX.reply) || !(str(y.at) && RE.datetime.test(y.at)) || typeof y.public !== 'boolean') e.push(`${at}.reply: not a reply {text, at, public}`);
+    }
+    if (own(r, 'text') && !short(r.text, MAX.text)) e.push(`${at}.text: not a string of at most ${MAX.text} characters`);
+    for (const k of ['read', 'answered', 'shown', 'hidden']) if (own(r, k) && typeof r[k] !== 'boolean') e.push(`${at}.${k}: not true or false`);
+  } else if (r.kind === 'poll') {
+    const req = [...common, 'choice'];
+    onlyKeys(r, [...req, 'name'], at, e); need(r, req, at, e);
+    if (own(r, 'choice') && !(Number.isInteger(r.choice) && r.choice >= 0 && r.choice <= MAX.choiceIndex)) e.push(`${at}.choice: not an integer from 0 to ${MAX.choiceIndex}`);
+  } else if (r.kind === 'confused') {
+    onlyKeys(r, common, at, e); need(r, common, at, e);
+  } else { e.push(`${at}.kind: not "qa", "confused" or "poll"`); return; }
+  if (own(r, 'activity') && !(str(r.activity) && RE.activity.test(r.activity))) e.push(`${at}.activity: not an activity id`);
+  if (own(r, 'step') && !(str(r.step) && RE.step.test(r.step))) e.push(`${at}.step: not a step key`);
+  if (own(r, 'pid') && !(str(r.pid) && RE.pid.test(r.pid))) e.push(`${at}.pid: not a participant id`);
+  if (own(r, 'at') && !(str(r.at) && RE.datetime.test(r.at))) e.push(`${at}.at: not an RFC 3339 time`);
+  if (own(r, 'name') && !short(r.name, MAX.name)) e.push(`${at}.name: not a string of at most ${MAX.name} characters`);
+}
+// 写しの Schema の $defs/results と同じ判定。返すもの：エラーの配列（[] なら正しい。多すぎるときは始めの 20）
+export function resultsErrors(v) {
+  const e = [];
+  if (!isObj(v)) return ['not an object'];
+  const keys = ['v', 'room', 'window', 'activities', 'responses', 'exportedAt'];
+  onlyKeys(v, keys, 'results', e); need(v, keys, 'results', e);
+  if (own(v, 'v') && v.v !== 1) e.push('v: not 1');
+  if (own(v, 'room') && !(str(v.room) && RE.room.test(v.room))) e.push('room: not a room id (r- and 8 characters)');
+  if (own(v, 'window')) {
+    const w = v.window;
+    if (!isObj(w)) e.push('window: not an object');
+    else { onlyKeys(w, ['from', 'to'], 'window', e); need(w, ['from', 'to'], 'window', e); for (const k of ['from', 'to']) if (own(w, k) && !(str(w[k]) && RE.datetime.test(w[k]))) e.push(`window.${k}: not an RFC 3339 time`); }
+  }
+  if (own(v, 'exportedAt') && !(str(v.exportedAt) && RE.datetime.test(v.exportedAt))) e.push('exportedAt: not an RFC 3339 time');
+  if (own(v, 'activities')) {
+    if (!isObj(v.activities)) e.push('activities: not an object');
+    else for (const [k, list] of Object.entries(v.activities)) {
+      if (!RE.step.test(k)) e.push(`activities: "${k.slice(0, 40)}" is not a step key`);
+      if (!Array.isArray(list)) { e.push(`activities["${k.slice(0, 40)}"]: not a list`); continue; }
+      list.forEach((a, i) => checkActivity(a, `activities["${k.slice(0, 40)}"][${i}]`, e));
+      if (e.length > 20) break;
+    }
+  }
+  if (own(v, 'responses')) {
+    if (!Array.isArray(v.responses)) e.push('responses: not a list');
+    else for (let i = 0; i < v.responses.length && e.length <= 20; i++) checkResponse(v.responses[i], `responses[${i}]`, e);
+  }
+  return e.slice(0, 20);
+}
+
+// bytes（Uint8Array）を読む：上限・UTF-8（BOM は除く）・JSON・Schema の形
+export function parseResults(bytes) {
+  const b = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes || []);
+  if (b.length > RESULTS_MAX_BYTES) return { ok: false, code: 'too-large', errors: [`${b.length} bytes, over the limit of ${RESULTS_MAX_BYTES}`], n: b.length };
+  let text;
+  try { text = new TextDecoder('utf-8', { fatal: true }).decode(b); } catch { return { ok: false, code: 'not-utf8', errors: ['not UTF-8 text'] }; }
+  let v;
+  try { v = JSON.parse(text.replace(/^/, '')); } catch (err) { return { ok: false, code: 'not-json', errors: [String((err && err.message) || err).slice(0, 200)] }; }
+  const { value, skipped } = tolerate(v);
+  const errors = resultsErrors(value);
+  if (errors.length) return { ok: false, code: 'not-results', errors };
+  return { ok: true, results: value, skipped };
+}
+// 中身で見分ける（JSON で、結果の形のもの）。大きなものは JSON にする前に、先頭の印で外す
+export function isLiveResults(bytes) {
+  const b = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes || []);
+  if (!b.length || b.length > RESULTS_MAX_BYTES) return false;
+  const head = new TextDecoder('utf-8').decode(b.subarray(0, 64)).replace(/^/, '').trimStart();
+  if (head[0] !== '{') return false;
+  return parseResults(b).ok;
+}
+
+// 投票ごとの数と、質問の数。投票の並びは活動（その段階の順、"*" が先）、その後に活動にない投票（結果から推した部屋は choices がない）
+export function summarizeResults(r) {
+  const polls = new Map();
+  const acts = isObj(r.activities) ? r.activities : {};
+  const keys = Object.keys(acts).sort((a, b) => (a === '*' ? -1 : b === '*' ? 1 : 0));
+  for (const step of keys) for (const a of acts[step] || []) if (a.kind === 'poll' && !polls.has(a.id)) polls.set(a.id, { id: a.id, step, prompt: str(a.prompt) ? a.prompt : '', choices: Array.isArray(a.choices) ? a.choices.slice() : [], counts: [], total: 0 });
+  let questions = 0;
+  for (const x of r.responses || []) {
+    if (x.kind === 'qa') { questions++; continue; }
+    if (x.kind !== 'poll') continue;
+    if (!polls.has(x.activity)) polls.set(x.activity, { id: x.activity, step: x.step, prompt: '', choices: [], counts: [], total: 0 });
+    const p = polls.get(x.activity);
+    p.counts[x.choice] = (p.counts[x.choice] || 0) + 1;
+    p.total++;
+  }
+  for (const p of polls.values()) { const n = Math.max(p.choices.length, p.counts.length); p.counts = Array.from({ length: n }, (_, i) => p.counts[i] || 0); }
+  return { questions, responses: (r.responses || []).length, polls: [...polls.values()] };
+}
+// 1 行の短い要約（添付の一覧に出す。字は呼ぶ側が textContent で出す）
+export function summaryLines(s, lang) {
+  const en = lang === 'en';
+  const lines = [en ? `Questions: ${s.questions}` : `質問 ${s.questions} 件`];
+  for (const p of s.polls) {
+    const parts = p.counts.map((n, i) => `${p.choices[i] !== undefined && p.choices[i] !== '' ? p.choices[i] : '#' + (i + 1)}: ${n}`);
+    const head = (en ? 'Poll ' : '投票 ') + p.id + (p.prompt ? (en ? ` “${p.prompt}”` : `「${p.prompt}」`) : '');
+    lines.push(`${head} — ${parts.length ? parts.join(' · ') : (en ? 'no votes' : '投票なし')}`);
+  }
+  return lines;
+}
+
+export const resultsDate = (r) => r.window.from.slice(0, 10);
+// 教材の設定（FORMAT.CONFIG_FILE の extensions.live。鍵なし）の部屋と比べる
+export function roomMatch(r, live) {
+  if (isObj(live) && Number.isInteger(live.v) && live.v > 1) return 'none';
+  const room = isObj(live) && str(live.room) ? live.room : null;
+  if (!room) return 'none';
+  return room === r.room ? 'match' : 'mismatch';
+}
+const TXT = {
+  ja: { title: (room, d) => `ライブの結果（${room}、${d}）`, desc: '参加者がライブで送った質問と投票の答え（名前を書いた人はその名前も）が入っています。人に渡すときは外してください' },
+  en: { title: (room, d) => `Live results (${room}, ${d})`, desc: 'Contains the questions and poll answers participants sent in the Live (and names, if they typed one). Remove it before giving the file to others' },
+};
+// 添付の項目。taken(path) → bool：もうある名前（同じ部屋と日付を 2 度取り込むときは -2・-3 …）
+export function resultsRecord(r, lang, taken = () => false) {
+  const X = TXT[lang === 'en' ? 'en' : 'ja'];
+  const d = resultsDate(r);
+  const base = `${FORMAT.ATTACH_DIR}/live-${r.room}-${d}`;
+  let path = base + '.json';
+  for (let n = 2; taken(path); n++) path = `${base}-${n}.json`;
+  return { path, role: 'data', title: X.title(r.room, d), description: X.desc };
+}
+
+// 1 ファイル（.ega.html）に結果が入るときの知らせ（コマンド。編集アプリは書き出す前に尋ねる）。paths：exportPortable の stats.liveResults
+export function liveResultsWarning(paths) {
+  if (!Array.isArray(paths) || !paths.length) return null;
+  return `this file contains live session results (${paths.map((x) => `"${x}"`).join(', ')}): participants' questions and answers. Remove them before giving it to others (export with --without-live-results)`;
+}

package/kit/core/live.mjs

@@ -0,0 +1,262 @@
+// 授業の部屋（拡張 live。format spec の extensions/live.md）を、再生専用の派生（§3.7）に付ける書き手の側。Node と編集アプリが共有する
+// （node: の読み込み・fs を使わない。再生器のスクリプトの字は呼ぶ側が渡す：Node は kit/build.mjs、編集アプリは tools/build-app.mjs が同梱したもの）
+//
+//   addLive(playOnlyHtml, live, runtime)   部屋を付けた派生（live.sourceSha256 があれば拡張のブロックに入れる：質問を教材の版に結び付ける）：ファイルの決まり（CSP の <meta>。
+//                                          format spec §4.2）の connect-src に endpoint を足す（決まりがあればその場で書き換え、なければ <head> の開始タグの直後に入れる）・
+//                                          拡張のブロック（#LIVE_BLOCK_ID）・再生器（kit/live.js）。live は鍵を含む完全なもの（validate {key:true}）
+//   liveCsp(endpoint)                      派生の CSP（ファイルの決まりの基準に、connect-src として endpoint の https: と wss: だけを足したもの）
+//   liveRuntime(policySrc, clientSrc)      再生器の <script>（kit/core/live-policy.mjs を DECK.LivePolicy にして、kit/live.js を続ける）
+//   parseRoomBlock(text)                   教員のページの「コピー」の字（{v, endpoint, room, key, window, activities?}）→ その object（違えば Error）
+//   lessonLive(live)                       教材（作業フォルダの FORMAT.CONFIG_FILE と索引の extensions.live）に残す形：鍵を除く
+//   mergeLive(lesson, room)                教材の設定と部屋の字を合わせる（部屋・鍵・窓・endpoint は部屋の字、活動は教材にあれば教材）
+//   activitiesText(live)                   教員のページに渡す活動の JSON（部屋は同じ活動を知っている必要がある）
+//   localToRfc3339(value, offsetMin)       <input type="datetime-local"> の値と、その時の時差（Date#getTimezoneOffset の符号を反転したもの）→ RFC 3339
+//   stepLabel(stepKey, slides, lang)       活動の表示名（label）：「4 枚目『XML の壁』・段階 1」/ "Slide 4 'XML の壁', step 1"。slides は [{key, heading}]
+//                                          （スライドの順）。番号は 1 から。見出しは約 24 字で切り、なければ鍵。* は「教材全体」。スライドが見つからなければ stepFallback
+//   stepFallback(stepKey, lang)            label のない活動の表示：「s-xxx · 段階 1」（<slide>:<k> の k が数なら k + 1）。* は「教材全体」
+//   stepText(stepKey, label, lang)         表示する字：label があればそれ、なければ stepFallback
+//
+// エディタからの一方向の設定（format spec の extensions/live.md §4、egatari/live の PROTOCOL.md §2.1）。どれも要求を出さない（乱数は crypto.getRandomValues、ハッシュは crypto.subtle）
+//   newLiveSetup(rand?)                    → Promise<{setup, room, key}>：setup は 32 バイトの乱数（base64url 43 字）、room と key はそこから SHA-256 で導く
+//   liveSetupIds(setup)                    → Promise<{room, key}>：導き方（サービスも同じ計算で確かめる。教材ファイルには setup が入らないので、ファイルだけでは部屋を作れない）
+//   liveSetupString(live)                  {endpoint, room, key, setup, window, activities} → ホストのページに 1 回貼る 1 本の文字列（FORMAT.LIVE_SETUP_PREFIX + base64url(JSON)）
+//   parseLiveSetupString(text)             その逆（空白・改行は無視）。形が違えば Error（message は 'prefix' | 'decode' | 'shape'）
+//
+// 部屋を付けない派生には、どれも触れない（今と同じバイト）
+import { parse } from 'parse5';
+import { LivePolicy } from './live-policy.mjs';
+import { classicModule, jsonScript } from './build-core.mjs';
+import { FORMAT } from './format.mjs';
+import { SCRIPTING } from './code-scan.mjs';
+import { policyText, policyMeta, findPolicies, parsePolicy, policyDiff, BASELINE } from './file-policy.mjs';
+
+const LP = LivePolicy();
+const LP_DEV = LivePolicy({ allowLoopback: true });
+const LOOPBACK_LINE = 'var LOOPBACK = false;';
+export const LIVE_BLOCK_ID = 'deck-extensions';   // 再生専用の派生で、再生器が読む拡張のブロック（{live: …}。索引は派生にないので）
+export const LIVE_EXT = 'live';
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const own = (o, k) => o != null && Object.prototype.hasOwnProperty.call(o, k);
+
+// extra.frame：ファイルの決まりが既に持つ frame-src の行き先（拡張 embed）。そのまま残す
+export function liveCsp(endpoint, opts = {}, extra = {}) {
+  const cs = (opts.devLoopback ? LP_DEV : LP).connectSrc(endpoint);
+  if (!cs) throw new Error(`live: endpoint "${endpoint}" is not an https origin`);
+  // ファイルの決まりの基準（kit/core/file-policy.mjs）：埋め込んだスクリプトと CSS（inline）、data: と blob: の画像・字・音声と動画、
+  // 発表者ビューの枠（同じファイルを ?view= で開く。file:// では file: ）。外へ出るのは endpoint だけ。eval・フォーム・<base>・object は使わない
+  return policyText({ connect: cs.split(' '), frame: extra.frame || [] });
+}
+// 今の決まり（ファイルの決まり）が基準（＋ frame-src の行き先）だけか。そうなら足した行き先 {frame} を、違えば null
+function baselineExtras(content) {
+  const p = parsePolicy(content);
+  const base = new Set(BASELINE.find(([d]) => d === 'frame-src')[1]);
+  const frame = (p.directives.get('frame-src') || []).filter((x) => !base.has(x));
+  return policyDiff(content, policyText({ frame })).length ? null : { frame };
+}
+
+const scriptSafe = (t) => String(t).replace(/<\/script/gi, '<\\/script').replace(/<!--/g, '<\\!--');
+// opts.devLoopback：開発版の再生器（ループバックの http: の部屋につなげる）。試験だけが使う。既定の再生器は https: だけ
+export function liveRuntime(policySrc, clientSrc, opts = {}) {
+  let src = String(policySrc);
+  if (src.split(LOOPBACK_LINE).length !== 2) throw new Error('live: the player policy has no single LOOPBACK switch');
+  if (opts.devLoopback) src = src.replace(LOOPBACK_LINE, 'var LOOPBACK = true;');
+  policySrc = src;
+  const cfg = JSON.stringify({ storePrefix: FORMAT.LIVE_STORE_PREFIX, blockId: LIVE_BLOCK_ID });
+  return `<script>\nwindow.DECK = window.DECK || {}; DECK.LIVE_CFG = ${cfg};\n${scriptSafe(classicModule(policySrc, 'LivePolicy'))}\n${scriptSafe(clientSrc)}\n</script>`;
+}
+
+// <head> の開始タグの終わり（本物の要素。注釈や <template> の中の字ではない）
+function headEnd(html) {
+  const doc = parse(html, { sourceCodeLocationInfo: true, scriptingEnabled: SCRIPTING });
+  const h = (doc.childNodes || []).find((n) => n.tagName === 'html');
+  const head = h && (h.childNodes || []).find((n) => n.tagName === 'head');
+  const st = head && head.sourceCodeLocation && head.sourceCodeLocation.startTag;
+  return st ? st.endOffset : -1;
+}
+
+// opts.devLoopback：ループバックの http: の endpoint を許す（開発版。runtime も liveRuntime(…, {devLoopback: true}) のもの）
+export function addLive(html, live, runtime, opts = {}) {
+  const future = isObj(live) && Number.isInteger(live.v) && live.v > 1;
+  const errs = future ? [] : (opts.devLoopback ? LP_DEV : LP).validate(live, { key: true });
+  if (errs.length) throw new Error('live: ' + errs.join('; '));
+  if (!future && (typeof runtime !== 'string' || !runtime.startsWith('<script>'))) throw new Error('live: no player runtime');
+  const text = String(html);
+  if (text.includes(`id="${FORMAT.INDEX_ID}"`)) throw new Error('live: a live session is added only to a play-only derivative (this file still has its index)');
+  // 拡張のブロック（deck-extensions）が既にあれば（拡張 embed。spec §4）、そこに live を足す。live が既にあれば断る
+  const blockRe = new RegExp(`<script type="application/json" id="${LIVE_BLOCK_ID}">([^<]*)</script>`);
+  const ex0 = blockRe.exec(text);
+  let others = {};
+  if (ex0) {
+    try { others = JSON.parse(ex0[1]); } catch { throw new Error('live: the extension block is not JSON'); }
+    if (!isObj(others)) throw new Error('live: the extension block is not an object');
+    if (text.split(`id="${LIVE_BLOCK_ID}"`).length !== 2) throw new Error('live: more than one extension block');
+    if (future && JSON.stringify(others.live) === JSON.stringify(live)) return text;
+    if (own(others, LIVE_EXT)) throw new Error('live: the file already carries a live session');
+  } else if (text.includes(`id="${LIVE_BLOCK_ID}"`)) throw new Error('live: the file already carries a live session');
+  const at = headEnd(text);
+  if (at < 0) throw new Error('live: no <head>');
+  // Higher versions round-trip as data only: no runtime and no policy change (§9A).
+  if (future) {
+    const block = jsonScript(LIVE_BLOCK_ID, { ...others, [LIVE_EXT]: live });
+    const meta = /<script type="application\/json" id="deck-meta">[^<]*<\/script>/.exec(text);
+    if (!meta) throw new Error('live: no deck-meta');
+    const pos = ex0 ? ex0.index : meta.index + meta[0].length;
+    return text.slice(0, pos) + '\n' + block + text.slice(ex0 ? pos + ex0[0].length : pos);
+  }
+  // ファイルの決まり（format spec §4.2）：1.0 の形のファイルは基準の決まりを持つ。connect-src に endpoint を足して、その場で書き換える
+  // （置き場所は変えない）。基準と違う決まり（緩めたもの・ほかの拡張の行き先）には足さない。決まりのない前の草案の派生には、今までどおり入れる
+  const pol = findPolicies(text);
+  if (pol.length > 1) throw new Error('live: the file has more than one content security policy');
+  let edit;
+  if (pol.length) {
+    const ex = baselineExtras(pol[0].content);
+    if (!ex) throw new Error('live: the file policy is not the baseline (§4.2); refusing to add the live endpoint to it');
+    edit = [pol[0].start, pol[0].end, policyMeta(liveCsp(live.endpoint, opts, ex))];
+  } else {
+    if (/<script/i.test(text.slice(0, at))) throw new Error('live: a script comes before <head>; the policy must come first');
+    edit = [at, at, '\n' + policyMeta(liveCsp(live.endpoint, opts))];
+  }
+  // 拡張のブロックと再生器：deck-meta の直後（実行系の前。再生器は deck:ready を待つ）。ブロックが既にあれば、それを置き換えてその後ろに
+  const m = /<script type="application\/json" id="deck-meta">[^<]*<\/script>/.exec(text);
+  if (!m || m.index < at) throw new Error('live: no deck-meta');
+  const ix = ex0 ? ex0.index : m.index + m[0].length, ixEnd = ex0 ? ex0.index + ex0[0].length : ix;
+  // sourceSha256（あれば）：教材の版。再生専用の派生の deck-meta からは消える（format spec §3.7）ので、質問を教材のその版に結び付けるためにここに入れる（拡張 live §1）
+  const data = { ...live };
+  const block = (ex0 ? '' : '\n') + jsonScript(LIVE_BLOCK_ID, { ...others, [LIVE_EXT]: data }) + '\n' + runtime;
+  if (edit[1] > ix) throw new Error('live: the policy comes after deck-meta');
+  return text.slice(0, edit[0]) + edit[2] + text.slice(edit[1], ix) + block + text.slice(ixEnd);
+}
+
+export function parseRoomBlock(input, opts = {}) {
+  const s = String(input || '').trim();
+  if (/[#&?]admin=|"adminKey"/.test(s)) throw new Error('admin');   // 教員の鍵（教員のリンク）は貼らない
+  let o;
+  try { o = JSON.parse(s.slice(s.indexOf('{'), s.lastIndexOf('}') + 1)); } catch { throw new Error('json'); }
+  if (!isObj(o)) throw new Error('json');
+  const out = { ...o, v: o.v === undefined ? 1 : o.v };
+  if (isObj(o.activities)) out.activities = o.activities;
+  const errs = (opts.devLoopback ? LP_DEV : LP).validate({ ...out, activities: out.activities || {} }, { key: true });
+  if (errs.length) { const e = new Error('invalid'); e.details = errs; throw e; }
+  return out;
+}
+
+// ---------------------------------------------------------------- 一方向の設定（PROTOCOL.md §2.1）
+const B32 = 'abcdefghijklmnopqrstuvwxyz234567';
+const RE_SETUP = /^[A-Za-z0-9_-]{42}[AEIMQUYcgkosw048]$/;
+function b64url(bytes) {
+  let bin = '';
+  for (const b of bytes) bin += String.fromCharCode(b);
+  return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+function fromB64url(s) {
+  const bin = atob(s.replace(/-/g, '+').replace(/_/g, '/') + '==='.slice((s.length + 3) % 4));
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+}
+// 5 バイト → base32 8 字（RFC 4648 の字、小文字）
+function b32of5(b) {
+  let s = '', bits = 0, acc = 0;
+  for (const x of b.slice(0, 5)) {
+    acc = (acc << 8) | x; bits += 8;
+    while (bits >= 5) { bits -= 5; s += B32[(acc >> bits) & 31]; }
+    acc &= (1 << bits) - 1;
+  }
+  return s;
+}
+async function sha256(text) {
+  return new Uint8Array(await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(text)));
+}
+export async function liveSetupIds(setup) {
+  if (typeof setup !== 'string' || !RE_SETUP.test(setup)) throw new Error('live: setup must be 43 base64url characters (32 random bytes)');
+  const room = 'r-' + b32of5(await sha256(`${FORMAT.NAME}-live/v1/room:` + setup));
+  const key = b64url((await sha256(`${FORMAT.NAME}-live/v1/key:` + setup)).slice(0, 16));
+  return { room, key };
+}
+export async function newLiveSetup(rand = (n) => globalThis.crypto.getRandomValues(new Uint8Array(n))) {
+  const bytes = rand(32);
+  if (!(bytes instanceof Uint8Array) || bytes.length !== 32) throw new Error('live: the random source gave no 32 bytes');
+  const setup = b64url(bytes);
+  return { setup, ...(await liveSetupIds(setup)) };
+}
+const SETUP_MEMBERS = ['v', 'endpoint', 'room', 'key', 'setup', 'window', 'activities'];
+export function liveSetupString(live) {
+  const L = isObj(live) ? live : {};
+  if (typeof L.setup !== 'string' || !RE_SETUP.test(L.setup)) throw new Error('live: no setup secret');
+  const data = { v: 1, endpoint: L.endpoint, room: L.room, key: L.key, setup: L.setup,
+    window: isObj(L.window) ? { from: L.window.from, to: L.window.to } : L.window, activities: isObj(L.activities) ? L.activities : {} };
+  return FORMAT.LIVE_SETUP_PREFIX + b64url(new TextEncoder().encode(JSON.stringify(data)));
+}
+export function parseLiveSetupString(text) {
+  const s = String(text || '').replace(/\s+/g, '');
+  const at = s.indexOf(FORMAT.LIVE_SETUP_PREFIX);
+  if (at < 0) throw new Error('prefix');
+  const body = s.slice(at + FORMAT.LIVE_SETUP_PREFIX.length);
+  let o;
+  try {
+    if (!/^[A-Za-z0-9_-]+$/.test(body)) throw new Error('decode');
+    o = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(fromB64url(body)));
+  } catch { throw new Error('decode'); }
+  if (!isObj(o) || o.v !== 1 || Object.keys(o).some((k) => !SETUP_MEMBERS.includes(k)) || SETUP_MEMBERS.some((k) => !own(o, k)) || !RE_SETUP.test(String(o.setup))) throw new Error('shape');
+  return o;
+}
+
+export function lessonLive(live) {
+  if (!isObj(live)) return null;
+  if (live.v !== 1) return live;
+  const { key, sourceSha256, ...out } = live;
+  return out;
+}
+
+export function mergeLive(lesson, room) {
+  const L = isObj(lesson) ? lesson : {}, R = isObj(room) ? room : {};
+  if (Number.isInteger(L.v) && L.v > 1) return L;
+  if (Number.isInteger(R.v) && R.v > 1) return R;
+  const acts = isObj(L.activities) && Object.keys(L.activities).length ? L.activities : isObj(R.activities) ? R.activities : {};
+  return { ...L, ...R, v: 1, endpoint: R.endpoint || L.endpoint || FORMAT.LIVE_ENDPOINT, room: R.room || L.room, key: R.key, window: isObj(R.window) ? { ...L.window, ...R.window } : L.window, activities: acts };
+}
+
+export function activitiesText(live) {
+  return JSON.stringify(isObj(live) && isObj(live.activities) ? live.activities : {}, null, 2);
+}
+
+export function localToRfc3339(value, offsetMin) {
+  const m = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})(?::(\d{2}))?$/.exec(String(value || ''));
+  if (!m || !Number.isInteger(offsetMin)) return '';
+  const sign = offsetMin >= 0 ? '+' : '-', a = Math.abs(offsetMin);
+  return `${m[1]}T${m[2]}:${m[3] || '00'}${sign}${String(Math.floor(a / 60)).padStart(2, '0')}:${String(a % 60).padStart(2, '0')}`;
+}
+
+// 活動の表示名（label。egatari/live の PROTOCOL.md §1：80 字まで、表示だけの字）。鍵はそのまま
+const LABEL_MAX = LP.LIMITS.label;
+const HEADING_MAX = 24;
+const WORDS = {
+  ja: { whole: '教材全体', step: (k) => `ステップ ${k}`, concl: '結論', slide: (n, h, st) => `${n} 枚目『${h}』・${st}`, fb: (s, st) => `${s} · ${st}` },
+  en: { whole: 'whole lesson', step: (k) => `step ${k}`, concl: 'conclusion', slide: (n, h, st) => `Slide ${n} '${h}', ${st}`, fb: (s, st) => `${s} · ${st}` },
+};
+const words = (lang) => WORDS[lang === 'en' ? 'en' : 'ja'];
+const cut = (t, n) => { const c = [...t]; return c.length <= n ? t : c.slice(0, n - 1).join('').trimEnd() + '…'; };
+function splitStep(stepKey) {
+  const s = String(stepKey || ''), i = s.lastIndexOf(':');
+  return i > 0 ? { slide: s.slice(0, i), k: s.slice(i + 1) } : null;
+}
+function stepPart(W, k) { return /^\d+$/.test(k) ? W.step(Number(k) + 1) : k === 'concl' ? W.concl : W.step(k); }
+export function stepFallback(stepKey, lang) {
+  const W = words(lang);
+  if (stepKey === '*') return W.whole;
+  const p = splitStep(stepKey);
+  return p ? W.fb(p.slide, stepPart(W, p.k)) : String(stepKey || '');
+}
+export function stepLabel(stepKey, slides, lang) {
+  const W = words(lang);
+  if (stepKey === '*') return W.whole;
+  const p = splitStep(stepKey);
+  const list = Array.isArray(slides) ? slides : [];
+  const i = p ? list.findIndex((x) => x && x.key === p.slide) : -1;
+  if (i < 0) return cut(stepFallback(stepKey, lang), LABEL_MAX);
+  const h = cut(String(list[i].heading || '').replace(/\s+/g, ' ').trim() || p.slide, HEADING_MAX);
+  return cut(W.slide(i + 1, h, stepPart(W, p.k)), LABEL_MAX);
+}
+export function stepText(stepKey, label, lang) {
+  return typeof label === 'string' && label.trim() ? label.trim() : stepFallback(stepKey, lang);
+}