egatari 0.0.0-stage → 0.6.4

package/vendor/components/sha256/53b1444a08ae15e397f41c7b88b32b2085bdef447bdcb5bcc0030490203b938c/README.md

@@ -0,0 +1,52 @@
+---
+name: base
+version: 1.0.0
+kind: library
+summary: 2.0 の要素のパーツが使う土台（基底のクラス MotionElement と、SVG・時間・見せ方の補助）。データの形は mount の前に確かめる。教材の作者が直接は書かない
+requires: shape@1.0.0
+---
+
+**2.0 alpha (branch `c2-base`; not for lessons).** A library part (Egatari spec §6.1): it defines no element. Element parts
+of components 2.0 require it as `requires: {base: "1.0.0"}` and receive what its factory returns:
+
+```js
+egatariParts.define({name: "bars", version: "2.0.0", requires: {base: "1.0.0"}, element: "m-bars"},
+  ({base}) => class extends base.MotionElement { /* … */ });
+```
+
+| Member | What it is | 1.x equivalent |
+|---|---|---|
+| `MotionElement` | the base class: `steps` (attribute `steps`, else `static steps`, else 1), `from` (`data-from`, default 1), `props` (attributes read by `static props`, cached), `data` (the one child `<script type="application/json">`, parsed, cached; two or more → `null` with a warning), and the empty `mount(ctx)`, `render(k, t, ctx)`, `duration(k)` = 0, `cues(k)` = null. It checks the part's data before the part counts its steps or mounts (below) | `DECK.MotionElement` |
+| `el(tag, attrs, parent?)` | an SVG element; `fill` / `stroke` / `color` / `stop-color` values with `var(` go to `style` | `DECK.el` |
+| `lerp(a, b, e)` | `a + (b − a)·e` | `DECK.lerp` |
+| `prog(t, start, dur)` | eased progress 0…1 of a motion from `start` lasting `dur` (1 at `t = ∞`); `prog(x, 0, 1)` is deck.js's `ease(x)` | `DECK.prog` (`DECK.ease`) |
+| `clamp(x)` | `x` limited to 0…1 | `DECK.clamp01` |
+| `mtext(parent, x, y, str, attrs?)` | SVG `<text>` with `*italic*`, `_sub`, `^sup` (24 px; a run-time helper, not the build-time `tex` of spec §6.2) | `DECK.mtext` |
+| `variant(el, names?)` | the presentation variant: the `variant` attribute when it is one of `names` (default `el.constructor.variants`), else the first; an unknown name warns | `VARIANT.of(el)` (tools/variant.js) |
+| `previewOpacity(el)` | the theme's `--preview-opacity` seen from `el`, or 0.45 when unset or outside 0…1 | the inline `getComputedStyle` read |
+
+**Data shapes** (spec §6.1; players no longer validate component data). Every `MotionElement` checks, once, its `static
+shape` (`{schema, example}`, `{text: true}` or `{links: true}`) and the `shape` of its `json` props with the `shape` part,
+as deck.js did before mount. When the data does not fit, `steps` is the `steps` attribute (else 0), `mount(ctx)` calls
+`ctx.report(code, "[<name>] data (<kind>): <summary>")` once and shows deck.js's placeholder (`<div class="m-error"
+role="note">`, in Japanese when `ctx.lang` is `ja`), and `render`, `duration`, `cues` draw nothing. With data that fits,
+nothing changes. The code is from spec §8.4's vocabulary (`reportCode(kind)`): `attr` for a problem with an attribute
+value (kind `attr`, `attrJson`), `data` for every other kind (`shape`, `missing`, `json`, `notText`, `empty`, `notLinks`,
+`noLinks`). The message keeps the kind and deck.js's English summary, after the part's name as in containment reports,
+e.g. `[bars] data (shape): groups: expected array, got object`. Base's own console warnings (a `steps` or `data-from`
+attribute that is not a non-negative integer, two JSON children) start with `[base]`.
+
+**Containment** (spec §6.1). An exception the part throws while the player calls it (`steps`, `mount`, `render`,
+`layout`, and also `duration` and `cues`) never escapes. The first one is the instance's fault: it is reported once,
+through `ctx.report("error", "[<name>] <phase>: <error>")` (`<name>` is the class's `static partName`, which an
+element part declares equal to its define meta name, else the tag without `m-`, else the whole tag; `steps`, `duration` and
+`cues` get no ctx, so their fault is reported at the next `mount`, `render` or `layout`), the element shows
+`<div class="m-error" role="note" data-part-failure="error">` with its text equivalent (`aria-label`, else its own
+text), `steps` becomes the `steps` attribute (else 0), and the part is not called again. Handlers the part registers
+itself (event listeners) are not wrapped.
+
+Dependencies: base → shape only (shape needs nothing from base, so there is no cycle). `plot` requires base.
+
+`MotionElement`, `el`, `mtext`, `lerp`, `prog`, `clamp` and the data check are copied from Egatari Studio's
+`kit/deck.js` (MIT, the same owner; see NOTICE) and give the same DOM and messages (but for the `[base]` and `[<name>]` prefixes and the report codes above): `tools/test-base.mjs` compares each
+with the pinned Studio's `DECK`. Nothing here reads `DECK` or any other global of a player.

package/vendor/components/sha256/53b1444a08ae15e397f41c7b88b32b2085bdef447bdcb5bcc0030490203b938c/index.js

@@ -0,0 +1,282 @@
+// base 1.0.0: the shared base class and helpers of Egatari components 2.0 (a library part, Egatari spec §6.1).
+// Element parts require it ({base: "1.0.0"}) and receive what this factory returns:
+//   {MotionElement, el, lerp, prog, clamp, mtext, variant, previewOpacity}
+// It uses no import, no network and no global of the player (spec §6.1): only the DOM, getComputedStyle and console.
+// It requires shape (the data-shape checker): MotionElement checks the part's data against its declared shape before the
+// part counts its steps or mounts (spec §6.1 "Data shapes"; players no longer do). The dependency runs base → shape only:
+// shape is pure and needs nothing from base, so there is no cycle.
+//
+// Provenance: MotionElement, el, mtext, lerp, prog and clamp (with the private ease and stepInt) are copied from
+// Egatari Studio's kit/deck.js (https://github.com/egatari/egatari-studio, commit 03eaf0607598b993eb020f8e619caa53526bc771,
+// where they are DECK.MotionElement, DECK.el, DECK.mtext, DECK.lerp, DECK.prog and DECK.clamp01), MIT License,
+// Copyright (c) 2026 Gendo Kumoi, the same owner and licence as this repository. They are kept as close to that code as
+// possible so that a part moved from DECK to base draws the same DOM (tools/test-base.mjs compares them with the pinned
+// Studio's DECK). variant is tools/variant.js's VARIANT.of, taking the names instead of looking the tag up again;
+// previewOpacity is the --preview-opacity read the parts used to write themselves. The data check (compText, compProblem,
+// compSummary, compPlaceholder) is deck.js's, with DECK.shape → the shape part and DECK.ja → ctx.lang. Differences: base's
+// own warnings start "[base] " (deck.js: "deck.js: ", "[deck] "), and a data problem is reported with a spec §8.4 code
+// (reportCode) and the part's "[<name>] " prefix.
+egatariParts.define({name: "base", version: "1.0.0", requires: {shape: "1.0.0"}}, function(deps){
+"use strict";
+var NS = "http://www.w3.org/2000/svg";
+var SH = deps.shape;
+
+// ---------------------------------------------------------------- 時間の部品 (kit/deck.js)
+function clamp01(x){ return x < 0 ? 0 : x > 1 ? 1 : x; }
+function ease(x){ x = clamp01(x); return x < .5 ? 2 * x * x : 1 - Math.pow(-2 * x + 2, 2) / 2; }
+// t 秒のときの、start から dur 秒かける動きの進み具合（0〜1、イージング付き）
+function prog(t, start, dur){ if (t === Infinity) return 1; if (dur <= 0) return t >= start ? 1 : 0; return ease((t - start) / dur); }
+function lerp(a, b, e){ return a + (b - a) * e; }
+// 段階の番号（steps / data-from）：有限の整数で min 以上。そうでなければ警告して null
+function stepInt(v, what, min){
+  if (v === null || v === undefined) return null;
+  var n = typeof v === "number" ? v : String(v).trim() === "" ? NaN : +v;
+  if (!isFinite(n) || n !== Math.floor(n) || n < (min || 0)){ console.warn("[base] " + what + "=" + JSON.stringify(v) + " は 0 以上の整数でないので無視 / ignored (not a non-negative integer)"); return null; }
+  return n;
+}
+
+// ---------------------------------------------------------------- SVG の部品 (kit/deck.js)
+// 色は CSS 変数で書けるように、fill / stroke / color に var( があれば style に回す（属性では var() が効かない）
+function el(tag, attrs, parent){
+  var e = document.createElementNS(NS, tag), st = "";
+  for (var k in attrs){
+    var v = attrs[k];
+    if ((k === "fill" || k === "stroke" || k === "color" || k === "stop-color") && String(v).indexOf("var(") >= 0) st += k + ":" + v + ";";
+    else e.setAttribute(k, v);
+  }
+  if (st) e.setAttribute("style", st + (attrs.style || ""));
+  if (parent) parent.appendChild(e);
+  return e;
+}
+// SVG の中の簡単な数式記法：*..* は斜体、_x は下付き、^x は上付き（本格的な式は組み立てのときに描く。spec §6.2）
+function mtext(parent, x, y, str, attrs){
+  var t = el("text", Object.assign({x: x, y: y, "font-size": 24}, attrs || {}), parent);
+  var it = false, i = 0, buf = "";
+  function flush(extra){
+    if (!buf) return;
+    var s = el("tspan", extra || {}, t);
+    if (it){ s.setAttribute("font-style", "italic"); s.setAttribute("class", "mi"); }
+    s.textContent = buf; buf = "";
+  }
+  while (i < str.length){
+    var c = str[i];
+    if (c === "*"){ flush(); it = !it; i++; }
+    else if ((c === "_" || c === "^") && i + 1 < str.length){
+      flush(); buf = str[i + 1];
+      flush({"baseline-shift": c === "_" ? "sub" : "super", "font-size": "17"});
+      i += 2;
+    } else { buf += c; i++; }
+  }
+  flush();
+  return t;
+}
+
+// ---------------------------------------------------------------- 部品のデータの形 (kit/deck.js; spec §6.1 Data shapes)
+// static shape（形は shape パーツが確かめる）と、static props の json の値の shape。違えば知らせの札を出し、描かない
+function compText(c){
+  var t = "";
+  [].forEach.call(c.childNodes, function(n){ if (!(n.nodeType === 1 && n.localName === "script")) t += n.textContent; });
+  return t.trim();
+}
+function compProblem(c){
+  var C = c.constructor, decl = C.props || {}, sh = C.shape;
+  for (var name in decl){
+    var d = decl[name], a = c.getAttribute(name);
+    if (d.type !== "json" || a === null) continue;
+    var v;
+    try { v = JSON.parse(a); } catch (e) { return {kind: "attrJson", attr: name, msg: String(e && e.message || e), example: JSON.stringify(d.default)}; }
+    var ea = d.shape && SH ? SH.check(d.shape, v) : null;
+    if (ea) return Object.assign({kind: "attr", attr: name, example: JSON.stringify(d.example !== undefined ? d.example : d.default)}, ea);
+  }
+  var data;
+  try { data = c.data; } catch (e) { return {kind: "json", msg: String(e && e.message || e)}; }
+  if (!sh || !SH) return null;
+  if (sh.text){ if (data !== null) return {kind: "notText"}; if (!compText(c)) return {kind: "empty"}; return null; }
+  if (sh.links){ if (data !== null) return {kind: "notLinks"}; if (!c.querySelector("a[href]")) return {kind: "noLinks"}; return null; }
+  if (sh.schema){
+    if (data === null) return {kind: "missing"};
+    var e2 = SH.check(sh.schema, data);
+    if (e2 && e2.path === "" && e2.why === "type" && SH.typeOf(data) === "object" && [].concat(sh.schema.type)[0] === "array"){
+      // 配列のはずが object：よくある書き方（{"series": [...], "xr": [...]}）なら、どれが属性で、どの配列が中身かを言う
+      var ks = Object.keys(data);
+      e2.keys = ks;
+      e2.attrKeys = ks.filter(function(k){ return Object.prototype.hasOwnProperty.call(decl, k); });
+      // 中身らしい配列：object の並び（{"series": [{…}]}）を先に、なければ属性でない配列
+      var arr = ks.filter(function(k){ return Array.isArray(data[k]); });
+      e2.arrayKey = arr.filter(function(k){ return SH.typeOf(data[k][0]) === "object"; })[0] || arr.filter(function(k){ return e2.attrKeys.indexOf(k) < 0; })[0] || null;
+      var it = e2.arrayKey && data[e2.arrayKey][0];
+      if (it && SH.typeOf(it) === "object" && sh.schema.items){ var ei = SH.check(sh.schema.items, it, "[0]"); if (ei) e2.inner = ei; }
+    }
+    if (e2) return Object.assign({kind: "shape"}, e2);
+  }
+  return null;
+}
+function compSummary(r, ja){
+  var at = r.path ? r.path : (ja ? "データ" : "data");
+  switch (r.kind){
+    case "shape": return r.why === "required" ? (ja ? at + " がない（" + r.expected + "）" : at + " is missing (" + r.expected + ")")
+      : r.why === "unknown" ? (ja ? "知らない欄 " + r.key : "unknown field " + r.key)
+      : r.why === "anyOf" ? (ja ? (r.path || "データ") + " に " + r.expected + " がない" : (r.path || "data") + " needs " + r.expected)
+      : (ja ? at + "：" + r.expected + " のはずが " + r.got : at + ": expected " + r.expected + ", got " + r.got);
+    case "missing": return ja ? "データ（子の <script type=\"application/json\">）がない" : "no data (child <script type=\"application/json\">)";
+    case "json": return (ja ? "データの JSON が読めない：" : "the data is not valid JSON: ") + r.msg;
+    case "attrJson": return (ja ? "属性 " + r.attr + " の JSON が読めない：" : "attribute " + r.attr + " is not valid JSON: ") + r.msg;
+    case "attr": return (ja ? "属性 " + r.attr + (r.path ? " の " + r.path : "") + "：" + r.expected + " のはずが " + r.got : "attribute " + r.attr + (r.path ? " at " + r.path : "") + ": expected " + r.expected + ", got " + r.got);
+    case "notText": return ja ? "JSON ではなく要素の中の字で書く" : "write it as text inside the element, not JSON";
+    case "empty": return ja ? "中身の字がない" : "no text inside";
+    case "notLinks": return ja ? "JSON ではなく子の <a href> で書く" : "write it as child <a href> links, not JSON";
+    case "noLinks": return ja ? "子の <a href> がない" : "no child <a href> links";
+    default: return (ja ? "描けない：" : "cannot draw: ") + r.msg;
+  }
+}
+// The ctx.report code of a data problem (spec §8.4 vocabulary): an attribute value (attr, attrJson) → attr, anything else
+// about the element's data (shape, missing, json, notText, empty, notLinks, noLinks) → data. The problem's own kind stays in
+// the message: "[<name>] data (<kind>): <summary>"
+function reportCode(kind){ return kind === "attr" || kind === "attrJson" ? "attr" : "data"; }
+function compPlaceholder(c, r, ja){
+  [].slice.call(c.childNodes).forEach(function(n){ if (!(n.nodeType === 1 && n.localName === "script")) c.removeChild(n); });
+  var box = document.createElement("div");
+  box.className = "m-error"; box.setAttribute("role", "note");
+  box.textContent = "<" + r.tag + "> " + (ja ? "のデータの形が違う：" : "data problem: ") + compSummary(r, ja);
+  c.appendChild(box);
+}
+
+// The element's data problem (compProblem with the record fields deck.js's compFail added), checked once, or null
+function dataProblem(e){
+  if (e._shapeDone) return e._shapeProblem;
+  e._shapeDone = true;
+  var p = compProblem(e);
+  if (p){
+    var sh = e.constructor.shape || {};
+    p = Object.assign({tag: e.tagName.toLowerCase(), label: e.getAttribute("aria-label") || "", phase: "data"}, p);
+    if (sh.schema && p.shape === undefined) p.shape = SH.brief(sh.schema);
+    if (sh.example !== undefined && p.example === undefined) p.example = typeof sh.example === "string" ? sh.example : JSON.stringify(sh.example);
+  }
+  return (e._shapeProblem = p || null);
+}
+function up(e, name){ return Reflect.get(Object.getPrototypeOf(e), name, e); }
+
+// ---------------------------------------------------------------- containment (spec §6.1 Containment)
+// An exception thrown by the part while the player calls it (steps, mount, render, layout; also duration and cues) does not
+// escape: the first one is kept as the instance's fault, reported once through ctx.report("error", "[<name>] <phase>: <error>")
+// as soon as a ctx is at hand (steps, duration and cues get none: it is reported at the next mount, render or layout), and
+// the element then shows the .m-error placeholder with its text equivalent (aria-label, else its own text). From then on
+// steps is the steps attribute (else 0), and the part is not called again. <name> is the registry name the class declares
+// (static partName, = its define meta's name; lint checks it), else the tag without m-, else the whole tag.
+function partName(e){
+  var n = e.constructor.partName, t = e.tagName.toLowerCase();
+  if (typeof n === "string" && n) return n;
+  return t.indexOf("m-") === 0 ? t.slice(2) : t;
+}
+function errText(x){ return x && x.message !== undefined ? (x.name && x.name !== "Error" ? x.name + ": " : "") + x.message : String(x); }
+function fallbackSteps(e){ var n = stepInt(e.getAttribute("steps"), e.tagName.toLowerCase() + " steps"); return n !== null ? n : 0; }
+function textEquivalent(e){
+  var label = e.getAttribute("aria-label");
+  if (label && label.trim()) return label.trim();
+  var t = compText(e).replace(/\s+/g, " ");
+  return t || "<" + e.tagName.toLowerCase() + ">";
+}
+function fault(e, phase, x, ctx){
+  if (!e._fault) e._fault = {phase: phase, msg: errText(x)};
+  if (ctx) showFault(e, ctx);
+}
+function showFault(e, ctx){
+  if (e._faultShown) return;
+  e._faultShown = true;
+  var text = textEquivalent(e);
+  try { if (ctx && typeof ctx.report === "function") ctx.report("error", "[" + partName(e) + "] " + e._fault.phase + ": " + e._fault.msg); } catch (x) { /* a player's report must not undo containment */ }
+  [].slice.call(e.childNodes).forEach(function(n){ if (!(n.nodeType === 1 && n.localName === "script")) e.removeChild(n); });
+  var box = document.createElement("div");
+  box.className = "m-error"; box.setAttribute("role", "note"); box.setAttribute("data-part-failure", "error");
+  box.textContent = text;
+  e.appendChild(box);
+}
+// Installed on every instance (own properties, so they come before the part's own steps, mount, render, duration, cues,
+// layout): with data that fits, they pass to the part inside try/catch (containment, above); otherwise steps is the
+// attribute steps (else 0), mount reports the problem once through ctx.report(reportCode(kind), "[<name>] data (<kind>): …") and shows the placeholder
+// (like deck.js), and the rest draws nothing
+function guard(e){
+  Object.defineProperty(e, "steps", {configurable: true, get: function(){
+    if (dataProblem(e) || e._fault) return fallbackSteps(e);
+    try { return up(e, "steps"); } catch (x) { fault(e, "steps", x, null); return fallbackSteps(e); }
+  }});
+  e.mount = function(ctx){
+    var p = dataProblem(e);
+    if (!p){
+      if (e._fault) return showFault(e, ctx);
+      try { return up(e, "mount").call(e, ctx); } catch (x) { fault(e, "mount", x, ctx); return; }
+    }
+    if (!e._shapeReported){ e._shapeReported = true; if (ctx && typeof ctx.report === "function") ctx.report(reportCode(p.kind), "[" + partName(e) + "] data (" + p.kind + "): " + compSummary(p, false)); }
+    compPlaceholder(e, p, /^ja\b/i.test((ctx && ctx.lang) || "ja"));
+  };
+  e.render = function(k, t, ctx){
+    if (dataProblem(e)) return;
+    if (e._fault) return showFault(e, ctx);
+    try { return up(e, "render").call(e, k, t, ctx); } catch (x) { fault(e, "render", x, ctx); }
+  };
+  e.duration = function(k){
+    if (dataProblem(e) || e._fault) return 0;
+    try { return up(e, "duration").call(e, k); } catch (x) { fault(e, "duration", x, null); return 0; }
+  };
+  e.cues = function(k){
+    if (dataProblem(e) || e._fault) return null;
+    try { return up(e, "cues").call(e, k); } catch (x) { fault(e, "cues", x, null); return null; }
+  };
+  // layout(ctx) is optional (spec §8.4 Layout): wrapped only when the part has one, so that a player sees none otherwise
+  if (typeof up(e, "layout") === "function") e.layout = function(ctx){
+    if (dataProblem(e)) return;
+    if (e._fault) return showFault(e, ctx);
+    try { return up(e, "layout").call(e, ctx); } catch (x) { fault(e, "layout", x, ctx); }
+  };
+}
+
+// ---------------------------------------------------------------- 部品の基底クラス (kit/deck.js)
+class MotionElement extends HTMLElement {
+  constructor(){ super(); guard(this); }
+  get steps(){ var a = stepInt(this.getAttribute("steps"), this.tagName.toLowerCase() + " steps"); return a !== null ? a : (this.constructor.steps || 1); }
+  get from(){ var a = stepInt(this.getAttribute("data-from"), this.tagName.toLowerCase() + " data-from", 1); return a !== null ? a : 1; }
+  // static props の宣言に従って属性を読む
+  get props(){
+    if (this._props) return this._props;
+    var decl = this.constructor.props || {}, out = {};
+    for (var name in decl){
+      var d = decl[name], a = this.getAttribute(name);
+      if (a === null){ out[name] = d.default; continue; }
+      out[name] = d.type === "number" ? +a : d.type === "bool" ? a !== "false" : d.type === "json" ? JSON.parse(a) : a;
+    }
+    return (this._props = out);
+  }
+  // 子の <script type="application/json"> の中身。type の前後の空白を除いて大文字小文字を区別せずに application/json、id によらない。
+  // 子に 2 つ以上あれば、どれを使うか決められないので使わない（null）
+  get data(){
+    if (this._data !== undefined) return this._data;
+    var c = [].filter.call(this.children, function(x){ return x.localName === "script" && String(x.getAttribute("type") || "").trim().toLowerCase() === "application/json"; });
+    if (c.length > 1) console.warn("[base] " + this.tagName.toLowerCase() + ": more than one <script type=\"application/json\"> child (ignored)");
+    return (this._data = c.length === 1 ? JSON.parse(c[0].textContent) : null);
+  }
+  mount(ctx){}
+  render(k, t, ctx){}
+  duration(k){ return 0; }
+  cues(k){ return null; }
+}
+
+// ---------------------------------------------------------------- 見せ方 (tools/variant.js VARIANT.of; spec §8.4 Presentation variants)
+// The variant is the element's `variant` attribute when it names one of `names`, otherwise the first name. names defaults
+// to the class's `static variants`. No seed; an unknown name warns and gives the first.
+function variant(e, names){
+  var tag = e.tagName.toLowerCase(), v = e.getAttribute("variant");
+  if (!names) names = e.constructor.variants || [];
+  if (v !== null && names.indexOf(v) >= 0) return v;
+  if (v !== null) console.warn(tag + ' variant="' + v + '" is not one of ' + names.join(", ") + " (the first, " + (names[0] || "none") + ", is used)");
+  return names[0] || null;
+}
+
+// ---------------------------------------------------------------- 先を薄く見せる濃さ (spec §8.4 Theme colours: --preview-opacity)
+// The theme's --preview-opacity as seen from the element (a number in 0…1), or 0.45 when it is not set or not in 0…1
+function previewOpacity(e){
+  var pv = parseFloat(getComputedStyle(e).getPropertyValue("--preview-opacity"));
+  return pv >= 0 && pv <= 1 ? pv : 0.45;
+}
+
+return {MotionElement: MotionElement, el: el, lerp: lerp, prog: prog, clamp: clamp01, mtext: mtext, variant: variant, previewOpacity: previewOpacity};
+});

package/vendor/components/sha256/5527ee1f708c8ef7d071c273c68fd4f3a014784391a44c7aa650335721bfe25c/README.md

@@ -0,0 +1,48 @@
+---
+name: m-menu
+series: common
+summary: スライドへのリンクの札を格子に並べる（目次・単元の選び方）。札はふつうの <a href="#<スライドの id>">、行ったスライドの札に「見た」の印
+steps: ceil(札の数 / per-step)（既定の per-step="0" なら 0：初めから全部）
+purposes: contents
+props: cols, per-step, size, fade, stagger, visited
+---
+
+目次、授業の単元の選び方、「どこから見るか」を選ばせる 1 枚に使う。
+<!-- llm: omit -->
+札は子に書いたふつうのリンクで、部品は見た目（格子・丸の字・副題・印）を整えるだけ。押したときの動きは実行系（`kit/deck.js`）が受け持つ
+（[format spec §9.1A](https://github.com/egatari/egatari-spec/blob/main/egatari-1.0.md#91a-links-to-slides)、`docs/contract.md` §9）。
+
+<!-- llm: end -->
+```html
+<m-menu cols="3" aria-label="今日の内容">
+  <a href="#s-njd4kp" data-icon="一" data-sub="孟浩然">春暁</a>
+  <a href="#s-uhqygr:2" data-icon="二" data-sub="読む順から">春望</a>
+  <a href="lesson2.ega.html" data-sub="次の課">返り点の練習</a>
+</m-menu>
+```
+
+- 子の `<a href>` 1 つが札 1 枚。`href` は `#<スライドの id>`（その段階 0）か `#<id>:<段階の鍵>`（`0`・`1`・… か `concl`）。id は `npm run ids` が付けたもの。中身（文字・`<b>` など）が札の題になる
+- `data-icon`：題の左の丸に入れる短い字（`一`・`1`・`A` など。色は `--term`）。`data-sub`：題の下の副題（`--muted`）
+<!-- llm: omit -->
+- ほかのファイルへのリンク（`other.ega.html#s-…`）はふつうのリンクで、札の右下に「別のファイル」の印。そのファイルは 1 ファイル（.ega.html）には入らない
+- 押すと：発表ではその段階の最終状態へ、自動再生中ならそこから再生を続ける。行った先の左上に「戻る」（Backspace・Alt+←・ブラウザの戻る）
+- 「見た」の印：このセッションで札の行き先のスライドを開いたら、札の右上に ✓（保存しない。開き直すと消える）。動画では付けず、印刷に出ない。
+  発表の操作の側の表示で `DECK.seek(i, k, t)` の外（`m-kobun` の札と同じ扱い）。`visited="false"` で付けない
+<!-- llm: end -->
+- 段階：`per-step="n"` なら札が n 枚ずつ段階ごとに出る（`data-from` から。同じ段階の中は `stagger` 秒ずつずれる）。まだ出ていない札は押せず、Tab でも選べず、読み上げない。
+  `per-step="0"`（既定）なら初めから全部（段階を使わない）。段階は (k, t) だけで決まる
+- 並び：`cols`（既定は札の数から：3 枚までは 1 行、4 枚は 2 列、それより多ければ 3 列）。札の高さの下限は CSS の `--mm-h`（既定 104px）、間は `--mm-gap`（18px）。
+  本文いっぱいに置いて縦の真ん中にそろえるなら `style="height:100%;align-content:center;--mm-h:150px"`
+<!-- llm: omit -->
+- 字の大きさ：題は `size`（既定 34px）、副題はその 0.8 倍（本文の下限の 27px より小さくしない）
+<!-- llm: end -->
+
+見本は `demo.html`（4 枚、2 枚ずつ出る目次）と `examples/kokugo-kanbun` の 2 枚目（6 枚の目次）。
+
+<!-- llm: omit -->
+注意
+
+- スクリプトなしで開いたとき（1 ファイル（.ega.html）の読める層、印刷の前の HTML）は、ふつうのリンクの並びとして読める
+- 部品は札の中身を組み替える（題・副題・丸の字を `span` で包む）が、`<a>` とその `href` は書いたまま
+- CSS の transition は使わない（実時間で動くので、画面が (k, t) で決まらなくなる）
+<!-- llm: end -->

package/vendor/components/sha256/5527ee1f708c8ef7d071c273c68fd4f3a014784391a44c7aa650335721bfe25c/demo.html

@@ -0,0 +1,60 @@
+<!DOCTYPE html>
+<html lang="ja" data-theme="default">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>m-menu の見本</title>
+<!-- 組み方：node kit/build.mjs components/menu/demo.html -o components/menu/out/demo.html。札はふつうの <a href="#<スライドの id>"> -->
+</head>
+<body>
+<div id="stage">
+
+<section class="slide noconcl" id="s-menu01">
+  <h2>今日の内容</h2>
+  <div class="body">
+    <m-menu per-step="2" aria-label="今日の内容">
+      <a href="#s-part01" data-icon="1" data-sub="何を確かめたいか">問い</a>
+      <a href="#s-part02" data-icon="2" data-sub="集め方と人数">方法</a>
+      <a href="#s-part03" data-icon="3" data-sub="図と数字">結果</a>
+      <a href="#s-part03:2" data-icon="4" data-sub="結果の 2 段目から">効果の大きさ</a>
+    </m-menu>
+  </div>
+</section>
+
+<section class="slide" id="s-part01">
+  <h2>問い</h2>
+  <div class="body">
+    <ul>
+      <li>短い復習は、次の週の小テストの点を上げるか</li>
+      <li>上がるなら、どのくらいか</li>
+    </ul>
+    <p><a href="#s-menu01">目次へ</a></p>
+  </div>
+  <div class="concl"><span>確かめたいのは、効果の有無と大きさ</span></div>
+</section>
+
+<section class="slide" id="s-part02">
+  <h2>方法</h2>
+  <div class="body">
+    <ul>
+      <li>2 つの組（各 30 人）で、片方だけ毎回 5 分の復習</li>
+      <li>4 週の小テストの平均を比べる</li>
+    </ul>
+  </div>
+  <div class="concl"><span>違いは復習の有無だけにそろえる</span></div>
+</section>
+
+<section class="slide" id="s-part03">
+  <h2>結果</h2>
+  <div class="body">
+    <ul>
+      <li>復習した組の平均は 72 点、しなかった組は 66 点</li>
+      <li>差は 6 点（数字は見本のための架空のもの）</li>
+    </ul>
+  </div>
+  <div class="concl"><span>短い復習でも、点に差が出た</span></div>
+</section>
+
+</div>
+</body>
+</html>

package/vendor/components/sha256/5527ee1f708c8ef7d071c273c68fd4f3a014784391a44c7aa650335721bfe25c/index.js

@@ -0,0 +1,113 @@
+// m-menu：スライドへのリンクの札を格子に並べる（目次・単元の選び方・「どこから見るか」）
+// <m-menu cols="3">
+//   <a href="#s-njd4kp" data-icon="一" data-sub="孟浩然">春暁</a>      ← スライドへ（その段階 0）
+//   <a href="#s-uhqygr:2" data-sub="杜甫（読む順から）">春望</a>       ← スライドの段階へ（#<id>:<段階の鍵>）
+//   <a href="lesson2.ega.html" data-sub="次の課">返り点の練習</a>       ← ほかのファイル：ふつうのリンク
+// </m-menu>
+// 札はふつうの <a href>（format spec §9.1A：スクリプトのないリンクで、Core の文書に入れてよい）。部品は見た目を整えるだけで、
+// 押したときの動き（発表では最終状態へ、自動再生中はそこから続ける、「戻る」）は実行系（kit/deck.js）が受け持つ。
+// 段階：per-step="n" なら札が n 枚ずつ段階ごとに出る（data-from から）。0（既定）なら初めから全部（段階を使わない）。
+// 「見た」の印：このセッションで札の行き先のスライドを開いたら、札の右上に印（保存しない。動画では付けない、印刷に出ない）。
+// 印は発表の操作の側の表示で、DECK.seek(i, k, t) の外（m-kobun の札と同じ扱い）。visited="false" で付けない
+// 大きさ：札の高さの下限は --mm-h（既定 104px）、間は --mm-gap。CSS の transition は使わない（実時間で動くので、画面が (k, t) で決まらなくなる）
+(function(){
+"use strict";
+var D = window.DECK;
+var CSS =
+  "m-menu{display:grid;gap:var(--mm-gap,18px);grid-template-columns:repeat(var(--mm-cols,3),minmax(0,1fr));grid-auto-rows:minmax(var(--mm-h,104px),auto);align-content:start}" +
+  "m-menu>a{position:relative;display:flex;align-items:center;gap:18px;padding:14px 22px;box-sizing:border-box;" +
+  "border:2px solid var(--line);border-radius:14px;background:var(--bg);color:var(--fg);text-decoration:none;cursor:pointer}" +
+  "m-menu>a:hover{border-color:var(--term);box-shadow:0 3px 14px color-mix(in srgb,var(--term) 18%,transparent)}" +
+  "m-menu>a:focus{outline:none}m-menu>a:focus-visible{outline:3px solid var(--term);outline-offset:3px}" +
+  "m-menu .mm-icon{flex:none;display:grid;place-items:center;width:1.9em;height:1.9em;border-radius:50%;background:var(--term);color:var(--bg);font-weight:700;line-height:1}" +
+  "m-menu .mm-text{display:flex;flex-direction:column;gap:4px;min-width:0}" +
+  "m-menu .mm-title{font-weight:700;line-height:1.25}" +
+  "m-menu .mm-sub{font-size:max(27px,.8em);line-height:1.3;color:var(--muted)}" +
+  "m-menu .mm-ext{position:absolute;right:12px;bottom:10px;width:20px;height:20px;color:var(--muted)}" +
+  "m-menu .mm-seen{position:absolute;right:10px;top:10px;display:none;width:26px;height:26px;border-radius:50%;background:var(--muted);color:var(--bg)}" +
+  "m-menu>a.mm-visited{border-color:color-mix(in srgb,var(--muted) 55%,var(--line))}" +
+  "m-menu>a.mm-visited .mm-seen{display:block}" +
+  "m-menu svg{fill:none;stroke:currentColor;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round}" +
+  ".printing m-menu .mm-seen{display:none!important}@media print{m-menu .mm-seen{display:none!important}}" +
+  ".mm-sr{position:absolute!important;width:1px;height:1px;margin:-1px;padding:0;border:0;overflow:hidden;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap}";
+var CHECK = '<svg class="mm-seen" viewBox="0 0 26 26" aria-hidden="true"><path d="M7.5 13.5l3.6 3.6 7.4-8"/></svg>';
+var EXT = '<svg class="mm-ext" viewBox="0 0 20 20" aria-hidden="true"><path d="M8 4H4v12h12v-4M11 3h6v6M17 3l-8 8"/></svg>';
+function cards(el){ return [].filter.call(el.children, function(x){ return x.localName === "a" && x.hasAttribute("href"); }); }
+
+D.define("m-menu", class extends D.MotionElement {
+  // データの形（kit/shape.js）：JSON ではなく、子のリンク <a href="#<スライドの id>">題</a>
+  static shape = {links: true, example: '<a href="#s-abc123" data-sub="副題">題</a>'};
+  static props = {
+    cols:       {type: "number", default: 0, doc: "列の数（0 なら札の数から：3 枚までは 1 行、4 枚は 2 列、それより多ければ 3 列）"},
+    "per-step": {type: "number", default: 0, doc: "1 段階に出す札の数（0 なら初めから全部出し、段階を使わない）"},
+    size:       {type: "number", default: 34, doc: "札の題の字の大きさ（px）。副題はその 0.8 倍（本文の下限の 27px より小さくしない）"},
+    fade:       {type: "number", default: 0.4, doc: "札が出る秒数"},
+    stagger:    {type: "number", default: 0.12, doc: "同じ段階の札どうしの出るずれ（秒）"},
+    visited:    {type: "bool", default: true, doc: "このセッションで行き先のスライドを開いた札に「見た」の印を付ける"},
+  };
+  get steps(){
+    var a = this.getAttribute("steps");
+    if (a !== null && /^\d+$/.test(a.trim())) return +a;
+    var per = +this.getAttribute("per-step") || 0;
+    return per > 0 ? Math.ceil(cards(this).length / per) : 0;
+  }
+  mount(ctx){
+    var P = this.props, self = this, list = cards(this), n = list.length;
+    if (!document.getElementById("m-menu-css")){ var st = document.createElement("style"); st.id = "m-menu-css"; st.textContent = CSS; document.head.appendChild(st); }
+    var cols = P.cols > 0 ? P.cols : n <= 3 ? Math.max(1, n) : n === 4 ? 2 : 3;
+    this.style.setProperty("--mm-cols", cols);
+    this.style.fontSize = P.size + "px";
+    var per = P["per-step"] > 0 ? P["per-step"] : 0;
+    this.cards = list.map(function(a, j){
+      // 書いた中身（文字・<b> など）を題にし、data-icon と data-sub から丸の字と副題を足す（リンクはそのまま）
+      var title = document.createElement("span"); title.className = "mm-title";
+      while (a.firstChild) title.appendChild(a.firstChild);
+      var text = document.createElement("span"); text.className = "mm-text"; text.appendChild(title);
+      var sub = a.getAttribute("data-sub");
+      if (sub){ var sp = document.createElement("span"); sp.className = "mm-sub"; sp.textContent = sub; text.appendChild(sp); }
+      var icon = a.getAttribute("data-icon");
+      if (icon){ var ic = document.createElement("span"); ic.className = "mm-icon"; ic.setAttribute("aria-hidden", "true"); ic.textContent = icon; a.appendChild(ic); }
+      a.appendChild(text);
+      var href = a.getAttribute("href"), inDoc = href.charAt(0) === "#";
+      a.insertAdjacentHTML("beforeend", CHECK + (inDoc ? "" : EXT));
+      var sr = document.createElement("span"); sr.className = "mm-sr"; a.appendChild(sr);
+      return {a: a, sr: sr, frag: inDoc ? href.slice(1) : null, ext: !inDoc, step: per ? Math.floor(j / per) + 1 : 0, at: per ? (j % per) * P.stagger : 0};
+    });
+    this.visitedOn = P.visited && ctx.mode !== "video";
+    if (this.visitedOn){
+      var upd = function(){ self.markVisited(); };
+      document.addEventListener("deck:pos", upd);
+      upd();
+    }
+  }
+  // 「見た」の印（発表の操作の側の表示。DECK.seek の外）
+  markVisited(){
+    var ja = D.ja !== false;
+    this.cards.forEach(function(c){
+      var v = false;
+      if (c.frag !== null && D.resolveFragment && D.visited){ var r = D.resolveFragment(c.frag); v = !r.error && D.visited(r.i); }
+      c.a.classList.toggle("mm-visited", v);
+      c.sr.textContent = (v ? (ja ? "（見た）" : " (visited)") : "") + (c.ext ? (ja ? "（別のファイル）" : " (another file)") : "");
+    });
+  }
+  duration(k){
+    var d = 0, F = this.props.fade;
+    this.cards.forEach(function(c){ if (c.step === k) d = Math.max(d, c.at + F); });
+    return d;
+  }
+  render(k, t, ctx){
+    var F = this.props.fade, lecture = ctx && ctx.mode === "lecture";
+    this.cards.forEach(function(c){
+      var p = c.step < k ? 1 : c.step > k ? 0 : D.prog(t, c.at, F);
+      if (lecture && p < 1) p = Math.max(p, c.step > k ? 0.28 : p);
+      c.a.style.opacity = p.toFixed(3);
+      c.a.style.transform = p < 1 && !lecture ? "translateY(" + ((1 - p) * 14).toFixed(2) + "px)" : "";
+      // 見えていない札は押せない・選べない・読み上げない
+      var off = p <= 0;
+      c.a.style.pointerEvents = off ? "none" : "";
+      if (off){ c.a.setAttribute("tabindex", "-1"); c.a.setAttribute("aria-hidden", "true"); }
+      else { c.a.removeAttribute("tabindex"); c.a.removeAttribute("aria-hidden"); }
+    });
+  }
+});
+})();

package/vendor/components/sha256/5781a99da9e199697d25fe4a80b62a003362ae23f91130afa10e436bbf69f56b/README.md

@@ -0,0 +1,32 @@
+---
+name: m-hist
+series: academic
+summary: ヒストグラム・度数折れ線・ドットプロット。平均値・中央値・最頻値の線も
+steps: 分布（系列 1 つ = 1 段階）→ 度数折れ線 → 代表値を 1 つずつ
+purposes: spread
+variants: fade, grow
+props: xr, yr, xt, yt, xf, yf, xl, yl, unit, digits, polygon, relative, cumulative, kind, marks, build, dur
+---
+
+子の JSON：`{"values": [...], "bins": {"start", "width"}}`（部品が数える）か `{"table": [{"from", "to", "count"}]}`。2 組なら `"series": [{"label", "values" か "table"}]`（重ねる）。
+
+- 階級は start 以上 start＋width 未満
+- `kind="dots"`：ドットプロット（values が要る）
+- `polygon` `relative` `cumulative`：`"on"`
+- `marks="mean,median,mode"`：代表値の線
+- `build="values"`：値を 1 つずつ積む。`"bins"`：階級を 1 つずつ
+
+<!-- llm: omit -->
+作る人向けの注
+
+- **`style="dots"` ではなく `kind="dots"`**：`style` は要素の大きさ（`style="height:420px"`）に使う HTML の属性なので、見た目の種類は `kind` にした。`style="dots"` と書かれたときは `kind` として読み、`console.warn` で知らせる（大きさは失われる）
+- 2 組（`series`）は**重ねる**：横に並べると棒の幅が半分になり、隙間のない柱状グラフでなくなる。重ねる方が分布の形のずれが見やすい。1 組目は実線、2 組目は破線の枠、塗りは薄く（色だけに頼らない）。名前は図の上に右寄せで、2 つともいつも出す（label が無ければ「1 組目」「2 組目」にして `console.warn`）。棒の枠には `class="outline"` を付け、tools/test-contrast.mjs が、後ろの棒の塗りに対して 3:1 以上あることを確かめる。棒の上の度数は書かない（重なるので）。代表値は組ごとにその組の色で
+- 階級の数を書かなければ、およそ 1＋log₂n 個の切りのよい幅にし、`console.warn` で知らせる。値が `bins.start` より小さければ誤り。表の階級は等しい幅で続いていること（2 つの表は同じ階級）
+- 代表値：平均値と中央値は生の値があればそこから正確に、表だけなら Σ(階級値×度数)÷n と「中央値の階級」（真ん中の 2 つが別の階級ならその境の値）。最頻値は、点を値の上に積むドットプロット（`bins` なし）なら値から（同数なら全部、どれも 1 回なら印を出さない）、階級でまとめるとき（柱状グラフ、`bins` のあるドットプロット）は度数がいちばん多い階級の階級値（教科書の決まり）。`digits` を書かなければ値の桁＋1 桁まで（終わりの 0 は値の桁まで落とす）
+- 印の線は軸から図の上の名前の行まで伸び、名前は線の頭の右か左。名前がほかの線にかからない側を選び、かかる線の名前はそれより下の行に置く（tools/test-components.mjs の重なりの検査）。線は平均値＝実線・中央値＝長い破線・最頻値＝点線（1 組なら `--emph` `--accent2` `--fg`）
+- 度数折れ線は両端に度数 0 の階級を足して階級値を結ぶ（その分だけ横軸を広げ、足した両端には目盛りの数を書かない）。累積度数では各階級の右の端を結ぶ。折れ線があれば、棒の上の度数は折れ線が通らない側に寄せる
+- `build="values"`：値は書いた順に、階級の上へ落ちて積もる（棒が 1 つ分ずつ伸び、度数の数字も数え上がる）。落ちる間隔は 9 個までは 0.3 秒、それより多ければ 1 段階が約 3 秒に収まるように詰める（2.5÷(n−1) 秒。多いときは何個かがまとめて落ちる）。間隔が 0.2 秒以上なら落ちる箱にその値を書く。表だけのときは `bins` に替える（`console.warn`）。ドットプロットでは点が 1 つずつ落ちる（`bins` は柱状グラフだけ）
+- 見せ方：`fade`（0）は棒・点・線がフェード、`grow` は棒が下から伸び（同じ時間、棒の高さより遠くへは動かない）、点は下の段から順に現れ、折れ線は左から引き、印の線は軸から上へ伸びる。段階の数・長さ・最後の中身は同じ
+- 授業の表示（`ctx.preview`）では先の段階を 0.45 で見せる
+- 字は 24 px（棒の上の度数と名前は地の色の縁取りで線と分ける）。数はすべてデータから計算する
+<!-- llm: end -->