@geml/geml 1.5.1 → 1.7.0

package/dist/render.js

@@ -538,6 +538,42 @@ export class RenderCtx {
                 const classes = classAttr(["text", ...b.classes]);
                 return `<div class="${classes}"${idAttr}>\n${inner}\n</div>`;
             }
+            case "data": {
+                // GEP-0005: the page shows a PREVIEW under the same row discipline
+                // tables use (opts.tableRows, default 500) — the MODEL always keeps
+                // everything. Direction follows the format's reading order: jsonl is
+                // an append-log, so the newest (last) lines are the preview; json is
+                // one value and reads from the top.
+                const limit = this.opts.tableRows ?? 500;
+                const src = typeof b.attrs["src"] === "string" ? b.attrs["src"] : undefined;
+                const fmt = typeof b.attrs["format"] === "string" ? b.attrs["format"]
+                    : src !== undefined && /\.jsonl$/i.test(src) ? "jsonl" : "json";
+                let lines = b.raw ?? [];
+                if (lines.every((l) => l.trim() === "")) {
+                    if (b.value !== undefined) {
+                        // src= content loaded at build time: preview the canonical form.
+                        lines = fmt === "jsonl" && Array.isArray(b.value)
+                            ? b.value.map((v) => JSON.stringify(v))
+                            : JSON.stringify(b.value, null, 2).split("\n");
+                    }
+                    else if (src !== undefined) {
+                        // §9.4: a render-time source (http, or no resolver at build).
+                        const cap0 = caption ? `<figcaption>${esc(caption)}</figcaption>` : "";
+                        return `<figure${idAttr}><p class="table-note">external data <code>${esc(src)}</code> — loaded at render time</p>${cap0}</figure>`;
+                    }
+                }
+                const tail = fmt === "jsonl" && lines.length > limit;
+                const shown = tail ? lines.slice(-limit) : lines.slice(0, limit);
+                const omitted = lines.length - shown.length;
+                const note = omitted > 0
+                    ? `<p class="table-note">${tail
+                        ? `showing the last ${shown.length} of ${lines.length} lines — earlier lines are in the document source`
+                        : `showing the first ${shown.length} of ${lines.length} lines — the complete data is in the document source`}</p>`
+                    : "";
+                const cap = caption ? `<figcaption>${esc(caption)}</figcaption>` : "";
+                const pre = `<pre class="data-src" data-format="${escAttr(fmt)}">${esc(shown.join("\n"))}</pre>`;
+                return `<figure${idAttr}>${tail ? note + pre : pre + note}${cap}</figure>`;
+            }
             case "table":
                 return b.table ? this.table(b.table, b.id, caption) : `<p class="render-error">table failed to parse</p>`;
             case "diagram":
@@ -1229,143 +1265,143 @@ function trunc(s, n) {
 // ---------------------------------------------------------------------------
 // Page shell, inline CSS, inline interactivity JS
 // ---------------------------------------------------------------------------
-export const CSS = `
-:root { --fg:#1f2328; --muted:#656d76; --bd:#d0d7de; --bg:#fff; --accent:#2563eb; --code-bg:#f6f8fa; }
-* { box-sizing: border-box; }
-body { margin:0; color:var(--fg); background:#fafbfc; font:16px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,"PingFang SC","Microsoft Yahei",sans-serif; }
-main { max-width: 860px; margin: 0 auto; padding: 48px 24px 96px; background:var(--bg); }
-h1,h2,h3,h4,h5,h6 { line-height:1.25; margin:1.6em 0 .6em; scroll-margin-top:16px; }
-h1 { font-size:2em; border-bottom:1px solid var(--bd); padding-bottom:.3em; }
-h2 { font-size:1.5em; border-bottom:1px solid var(--bd); padding-bottom:.3em; }
-h3 { font-size:1.25em; } h4 { font-size:1em; }
-p { margin:.7em 0; }
-a { color:var(--accent); text-decoration:none; } a:hover { text-decoration:underline; }
-code { background:var(--code-bg); padding:.15em .35em; border-radius:6px; font:.88em ui-monospace,SFMono-Regular,Menlo,Consolas,monospace; }
-pre { background:var(--code-bg); padding:14px 16px; border-radius:8px; overflow:auto; }
-pre code { background:none; padding:0; font-size:.85em; }
-pre.output { background:#0d1117; color:#e6edf3; }
-pre.output code { color:inherit; }
-ul,ol { padding-left:1.6em; } li { margin:.2em 0; }
-ul.task-list { list-style:none; padding-left:.2em; }
-li.task input[type=checkbox] { appearance:none; -webkit-appearance:none; width:1.1em; height:1.1em; margin:0 .5em 0 0; vertical-align:-.2em; border:1.5px solid #c8ccd0; border-radius:4px; background:#fff; position:relative; opacity:1; cursor:default; box-sizing:border-box; }
-li.task input[type=checkbox]:checked { background-color:#1f883d; border-color:#1f883d; }
-li.task input[type=checkbox]:checked::after { content:"✓"; position:absolute; top:0; right:0; bottom:0; left:0; display:flex; align-items:center; justify-content:center; color:#fff; font-size:.8em; line-height:1; font-weight:700; }
-aside.callout { border-left:4px solid var(--accent); background:#f0f6ff; padding:.4em 16px; border-radius:0 8px 8px 0; margin:1em 0; }
-aside.aside { border-left-color:#8b949e; background:#f6f8fa; }
-aside.warning { border-left-color:#d97706; background:#fff8f0; }
-aside.callout > :first-child { margin-top:0; } aside.callout > :last-child { margin-bottom:0; }
-figure { margin:1.2em 0; }
-figcaption { color:var(--muted); font-size:.86em; text-align:center; margin-top:.5em; }
-table.geml-table { border-collapse:collapse; width:100%; font-size:.92em; }
-table.geml-table th, table.geml-table td { border:1px solid var(--bd); padding:6px 12px; }
-table.geml-table thead th { background:var(--code-bg); cursor:pointer; user-select:none; white-space:nowrap; }
-table.geml-table thead th::after { content:" \\2195"; color:var(--muted); font-size:.8em; }
-table.geml-table thead th.asc::after { content:" \\2191"; color:var(--accent); }
-table.geml-table thead th.desc::after { content:" \\2193"; color:var(--accent); }
-table.geml-table tbody tr:nth-child(2n) { background:#fafbfc; }
-table.geml-table td.computed { color:#0a7c52; }
-table.geml-table tfoot td { background:var(--code-bg); font-weight:600; border-top:2px solid var(--bd); }
-.table-tools { margin-bottom:6px; } .table-filter { width:240px; max-width:100%; padding:5px 9px; border:1px solid var(--bd); border-radius:7px; font-size:.85em; }
-.table-figure details > summary { cursor:pointer; color:var(--muted); font-size:.86em; padding:4px 0; }
-.table-note { color:var(--muted); font-size:.82em; margin:6px 0 0; }
-.geml-chart { width:100%; height:auto; background:var(--bg); border:1px solid var(--bd); border-radius:8px; }
-.c-title { font-size:15px; font-weight:600; fill:var(--fg); }
-.c-grid { stroke:#eaecef; } .c-axis { stroke:#aab1b8; } .c-tick { font-size:11px; fill:var(--muted); } .c-legend { font-size:12px; fill:var(--fg); }
-.media { max-width:100%; border-radius:8px; }
-.diagram-src { color:var(--muted); } .render-error { color:#cf222e; }
-.math-block { overflow-x:auto; padding:.4em 0; }
-sup.fn a { font-size:.75em; }
-.geml-footer { max-width:860px; margin:0 auto; padding:16px 24px 40px; color:var(--muted); font-size:.82em; }
-.geml-footer code { font-size:.95em; }
-.code-graph { margin:1.4em 0; }
-.cg-mount { border:1px solid var(--bd); border-radius:8px; padding:10px 12px; background:var(--bg); }
-.cg-scroll { overflow:auto; min-height:52vh; max-height:72vh; }
-.cg-svg { display:block; }
-.cg-search-wrap { position:relative; display:inline-block; }
-.cg-search { font:12px/1.4 inherit; padding:2px 7px; border:1px solid var(--bd); border-radius:4px; background:var(--bg); color:var(--fg); min-width:13ch; }
-.cg-search-menu { position:absolute; z-index:30; top:calc(100% + 2px); left:0; min-width:24ch; max-width:52ch; max-height:52vh; overflow:auto; background:var(--bg); border:1px solid var(--bd); border-radius:6px; box-shadow:0 6px 20px rgba(0,0,0,.18); }
-.cg-search-row { display:block; width:100%; text-align:left; padding:4px 9px 4px 18px; border:0; background:none; color:var(--fg); cursor:pointer; font:12px/1.4 inherit; }
-.cg-search-row:hover { background:var(--bd); }
-.cg-search-count { position:sticky; top:0; padding:4px 9px; font-size:11px; opacity:.65; background:var(--bg); border-bottom:1px solid var(--bd); }
-.cg-search-grp { padding:6px 9px 2px; font-size:11px; font-weight:600; opacity:.7; border-top:1px solid var(--bd); }
-.cg-search-grp:first-of-type { border-top:0; }
-.cg-stage { display:flex; gap:10px; align-items:flex-start; }
-.cg-stage .cg-scroll { flex:1 1 auto; min-width:0; }
-.cg-src { flex:0 0 42%; max-width:46%; display:flex; flex-direction:column; border:1px solid var(--bd); border-radius:6px; overflow:hidden; background:var(--bg); }
-.cg-src-hd { display:flex; gap:8px; align-items:center; justify-content:space-between; padding:4px 8px; border-bottom:1px solid var(--bd); color:var(--muted); font:.76em ui-monospace,Consolas,monospace; word-break:break-all; }
-.cg-src-hd button { font:inherit; border:1px solid var(--bd); border-radius:5px; background:transparent; color:var(--muted); cursor:pointer; padding:0 6px; }
-.cg-src-body { margin:0; padding:8px 10px; overflow:auto; max-height:72vh; color:var(--fg); font:12px/1.5 ui-monospace,Consolas,monospace; white-space:pre; }
-.cg-src-note { color:var(--muted); font-style:italic; white-space:pre-wrap; }
-.cg-bar { display:flex; gap:8px; align-items:center; flex-wrap:wrap; font-size:.82em; color:var(--muted); margin-bottom:6px; }
-.cg-bar button { font:inherit; padding:1px 8px; border:1px solid var(--bd); border-radius:5px; background:transparent; cursor:pointer; }
-.cg-crumb .cg-seg { border:0; border-radius:0; padding:0; background:none; color:var(--accent); cursor:pointer; font:inherit; }
-.cg-crumb .cg-seg:hover { text-decoration:underline; }
-.cg-frame { display:block; width:100%; height:72vh; border:0; background:var(--bg); }
-.cg-flash { color:#b42318; }
-.cg-legend { display:flex; gap:14px; align-items:center; justify-content:space-between; flex-wrap:wrap; font-size:.75em; color:var(--muted); margin-top:6px; }
-.cg-upbtn { cursor:pointer; }
-.cg-upbtn circle { fill:#fff; stroke:#94a3b8; }
-.cg-upbtn text { font-size:11px; fill:#57606a; }
-.cg-upbtn:hover circle { stroke:var(--accent); stroke-width:1.6; }
-.cg-upbtn:hover text { fill:var(--accent); }
-.cg-uplink { fill:none; stroke:#94a3b8; stroke-dasharray:3 2.5; pointer-events:none; }
-.cg-groups { display:flex; flex-wrap:wrap; gap:4px 12px; margin-top:6px; font-size:.75em; color:var(--muted); }
-.cg-chip { display:inline-flex; align-items:center; gap:4px; }
-.cg-chip i { width:10px; height:10px; border-radius:2px; border:1px solid #94a3b8; display:inline-block; }
-.cg-note { font-size:.8em; color:#9a6700; }
-.cg-n rect { fill:#eef2f7; stroke:#94a3b8; }
-.cg-n text { font-size:12px; fill:var(--fg); font-family:ui-monospace,Consolas,monospace; }
-.cg-n { cursor:pointer; }
-.cg-n.root rect { fill:#dbeafe; stroke:#2563eb; stroke-width:2; }
-.cg-n.leaf { opacity:.45; }
-.cg-n.test rect { stroke-dasharray:3 2; }
-.cg-n.grp rect { stroke-width:1.8; }
-.cg-e { fill:none; stroke:#94a3b8; stroke-width:.9; }
-.cg-e.cand { stroke-dasharray:2 3; }
-.cg-e.back { stroke:#dc2626; stroke-dasharray:5 3; }
-.cg-e.http { stroke:#0891b2; stroke-width:1.5; stroke-dasharray:5 2; } /* cross-stack API link */
-.cg-e.soft { opacity:.55; }
-.cg-svg.hl .cg-n { opacity:.22; }
-.cg-svg.hl .cg-e { opacity:.1; }
-.cg-svg.hl .cg-n.hl { opacity:1; }
-.cg-svg.hl .cg-e.hl { opacity:1; stroke-width:1.6; }
+export const CSS = `
+:root { --fg:#1f2328; --muted:#656d76; --bd:#d0d7de; --bg:#fff; --accent:#2563eb; --code-bg:#f6f8fa; }
+* { box-sizing: border-box; }
+body { margin:0; color:var(--fg); background:#fafbfc; font:16px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,"PingFang SC","Microsoft Yahei",sans-serif; }
+main { max-width: 860px; margin: 0 auto; padding: 48px 24px 96px; background:var(--bg); }
+h1,h2,h3,h4,h5,h6 { line-height:1.25; margin:1.6em 0 .6em; scroll-margin-top:16px; }
+h1 { font-size:2em; border-bottom:1px solid var(--bd); padding-bottom:.3em; }
+h2 { font-size:1.5em; border-bottom:1px solid var(--bd); padding-bottom:.3em; }
+h3 { font-size:1.25em; } h4 { font-size:1em; }
+p { margin:.7em 0; }
+a { color:var(--accent); text-decoration:none; } a:hover { text-decoration:underline; }
+code { background:var(--code-bg); padding:.15em .35em; border-radius:6px; font:.88em ui-monospace,SFMono-Regular,Menlo,Consolas,monospace; }
+pre { background:var(--code-bg); padding:14px 16px; border-radius:8px; overflow:auto; }
+pre code { background:none; padding:0; font-size:.85em; }
+pre.output { background:#0d1117; color:#e6edf3; }
+pre.output code { color:inherit; }
+ul,ol { padding-left:1.6em; } li { margin:.2em 0; }
+ul.task-list { list-style:none; padding-left:.2em; }
+li.task input[type=checkbox] { appearance:none; -webkit-appearance:none; width:1.1em; height:1.1em; margin:0 .5em 0 0; vertical-align:-.2em; border:1.5px solid #c8ccd0; border-radius:4px; background:#fff; position:relative; opacity:1; cursor:default; box-sizing:border-box; }
+li.task input[type=checkbox]:checked { background-color:#1f883d; border-color:#1f883d; }
+li.task input[type=checkbox]:checked::after { content:"✓"; position:absolute; top:0; right:0; bottom:0; left:0; display:flex; align-items:center; justify-content:center; color:#fff; font-size:.8em; line-height:1; font-weight:700; }
+aside.callout { border-left:4px solid var(--accent); background:#f0f6ff; padding:.4em 16px; border-radius:0 8px 8px 0; margin:1em 0; }
+aside.aside { border-left-color:#8b949e; background:#f6f8fa; }
+aside.warning { border-left-color:#d97706; background:#fff8f0; }
+aside.callout > :first-child { margin-top:0; } aside.callout > :last-child { margin-bottom:0; }
+figure { margin:1.2em 0; }
+figcaption { color:var(--muted); font-size:.86em; text-align:center; margin-top:.5em; }
+table.geml-table { border-collapse:collapse; width:100%; font-size:.92em; }
+table.geml-table th, table.geml-table td { border:1px solid var(--bd); padding:6px 12px; }
+table.geml-table thead th { background:var(--code-bg); cursor:pointer; user-select:none; white-space:nowrap; }
+table.geml-table thead th::after { content:" \\2195"; color:var(--muted); font-size:.8em; }
+table.geml-table thead th.asc::after { content:" \\2191"; color:var(--accent); }
+table.geml-table thead th.desc::after { content:" \\2193"; color:var(--accent); }
+table.geml-table tbody tr:nth-child(2n) { background:#fafbfc; }
+table.geml-table td.computed { color:#0a7c52; }
+table.geml-table tfoot td { background:var(--code-bg); font-weight:600; border-top:2px solid var(--bd); }
+.table-tools { margin-bottom:6px; } .table-filter { width:240px; max-width:100%; padding:5px 9px; border:1px solid var(--bd); border-radius:7px; font-size:.85em; }
+.table-figure details > summary { cursor:pointer; color:var(--muted); font-size:.86em; padding:4px 0; }
+.table-note { color:var(--muted); font-size:.82em; margin:6px 0 0; }
+.geml-chart { width:100%; height:auto; background:var(--bg); border:1px solid var(--bd); border-radius:8px; }
+.c-title { font-size:15px; font-weight:600; fill:var(--fg); }
+.c-grid { stroke:#eaecef; } .c-axis { stroke:#aab1b8; } .c-tick { font-size:11px; fill:var(--muted); } .c-legend { font-size:12px; fill:var(--fg); }
+.media { max-width:100%; border-radius:8px; }
+.diagram-src { color:var(--muted); } .render-error { color:#cf222e; }
+.math-block { overflow-x:auto; padding:.4em 0; }
+sup.fn a { font-size:.75em; }
+.geml-footer { max-width:860px; margin:0 auto; padding:16px 24px 40px; color:var(--muted); font-size:.82em; }
+.geml-footer code { font-size:.95em; }
+.code-graph { margin:1.4em 0; }
+.cg-mount { border:1px solid var(--bd); border-radius:8px; padding:10px 12px; background:var(--bg); }
+.cg-scroll { overflow:auto; min-height:52vh; max-height:72vh; }
+.cg-svg { display:block; }
+.cg-search-wrap { position:relative; display:inline-block; }
+.cg-search { font:12px/1.4 inherit; padding:2px 7px; border:1px solid var(--bd); border-radius:4px; background:var(--bg); color:var(--fg); min-width:13ch; }
+.cg-search-menu { position:absolute; z-index:30; top:calc(100% + 2px); left:0; min-width:24ch; max-width:52ch; max-height:52vh; overflow:auto; background:var(--bg); border:1px solid var(--bd); border-radius:6px; box-shadow:0 6px 20px rgba(0,0,0,.18); }
+.cg-search-row { display:block; width:100%; text-align:left; padding:4px 9px 4px 18px; border:0; background:none; color:var(--fg); cursor:pointer; font:12px/1.4 inherit; }
+.cg-search-row:hover { background:var(--bd); }
+.cg-search-count { position:sticky; top:0; padding:4px 9px; font-size:11px; opacity:.65; background:var(--bg); border-bottom:1px solid var(--bd); }
+.cg-search-grp { padding:6px 9px 2px; font-size:11px; font-weight:600; opacity:.7; border-top:1px solid var(--bd); }
+.cg-search-grp:first-of-type { border-top:0; }
+.cg-stage { display:flex; gap:10px; align-items:flex-start; }
+.cg-stage .cg-scroll { flex:1 1 auto; min-width:0; }
+.cg-src { flex:0 0 42%; max-width:46%; display:flex; flex-direction:column; border:1px solid var(--bd); border-radius:6px; overflow:hidden; background:var(--bg); }
+.cg-src-hd { display:flex; gap:8px; align-items:center; justify-content:space-between; padding:4px 8px; border-bottom:1px solid var(--bd); color:var(--muted); font:.76em ui-monospace,Consolas,monospace; word-break:break-all; }
+.cg-src-hd button { font:inherit; border:1px solid var(--bd); border-radius:5px; background:transparent; color:var(--muted); cursor:pointer; padding:0 6px; }
+.cg-src-body { margin:0; padding:8px 10px; overflow:auto; max-height:72vh; color:var(--fg); font:12px/1.5 ui-monospace,Consolas,monospace; white-space:pre; }
+.cg-src-note { color:var(--muted); font-style:italic; white-space:pre-wrap; }
+.cg-bar { display:flex; gap:8px; align-items:center; flex-wrap:wrap; font-size:.82em; color:var(--muted); margin-bottom:6px; }
+.cg-bar button { font:inherit; padding:1px 8px; border:1px solid var(--bd); border-radius:5px; background:transparent; cursor:pointer; }
+.cg-crumb .cg-seg { border:0; border-radius:0; padding:0; background:none; color:var(--accent); cursor:pointer; font:inherit; }
+.cg-crumb .cg-seg:hover { text-decoration:underline; }
+.cg-frame { display:block; width:100%; height:72vh; border:0; background:var(--bg); }
+.cg-flash { color:#b42318; }
+.cg-legend { display:flex; gap:14px; align-items:center; justify-content:space-between; flex-wrap:wrap; font-size:.75em; color:var(--muted); margin-top:6px; }
+.cg-upbtn { cursor:pointer; }
+.cg-upbtn circle { fill:#fff; stroke:#94a3b8; }
+.cg-upbtn text { font-size:11px; fill:#57606a; }
+.cg-upbtn:hover circle { stroke:var(--accent); stroke-width:1.6; }
+.cg-upbtn:hover text { fill:var(--accent); }
+.cg-uplink { fill:none; stroke:#94a3b8; stroke-dasharray:3 2.5; pointer-events:none; }
+.cg-groups { display:flex; flex-wrap:wrap; gap:4px 12px; margin-top:6px; font-size:.75em; color:var(--muted); }
+.cg-chip { display:inline-flex; align-items:center; gap:4px; }
+.cg-chip i { width:10px; height:10px; border-radius:2px; border:1px solid #94a3b8; display:inline-block; }
+.cg-note { font-size:.8em; color:#9a6700; }
+.cg-n rect { fill:#eef2f7; stroke:#94a3b8; }
+.cg-n text { font-size:12px; fill:var(--fg); font-family:ui-monospace,Consolas,monospace; }
+.cg-n { cursor:pointer; }
+.cg-n.root rect { fill:#dbeafe; stroke:#2563eb; stroke-width:2; }
+.cg-n.leaf { opacity:.45; }
+.cg-n.test rect { stroke-dasharray:3 2; }
+.cg-n.grp rect { stroke-width:1.8; }
+.cg-e { fill:none; stroke:#94a3b8; stroke-width:.9; }
+.cg-e.cand { stroke-dasharray:2 3; }
+.cg-e.back { stroke:#dc2626; stroke-dasharray:5 3; }
+.cg-e.http { stroke:#0891b2; stroke-width:1.5; stroke-dasharray:5 2; } /* cross-stack API link */
+.cg-e.soft { opacity:.55; }
+.cg-svg.hl .cg-n { opacity:.22; }
+.cg-svg.hl .cg-e { opacity:.1; }
+.cg-svg.hl .cg-n.hl { opacity:1; }
+.cg-svg.hl .cg-e.hl { opacity:1; stroke-width:1.6; }
 `;
-export const JS = `
-(function () {
-  function cmp(a, b) {
-    var na = a.dataset.sort, nb = b.dataset.sort;
-    if (na !== undefined && nb !== undefined) return parseFloat(na) - parseFloat(nb);
-    return (a.textContent || "").localeCompare(b.textContent || "");
-  }
-  document.querySelectorAll("table.geml-table").forEach(function (table) {
-    var tbody = table.tBodies[0];
-    if (!tbody) return;
-    // Sort on header click.
-    var ths = table.tHead ? table.tHead.rows[0].cells : [];
-    Array.prototype.forEach.call(ths, function (th, col) {
-      th.addEventListener("click", function () {
-        var dir = th.classList.contains("asc") ? "desc" : "asc";
-        Array.prototype.forEach.call(ths, function (h) { h.classList.remove("asc", "desc"); });
-        th.classList.add(dir);
-        var rows = Array.prototype.slice.call(tbody.rows);
-        rows.sort(function (r1, r2) {
-          var c = cmp(r1.cells[col], r2.cells[col]);
-          return dir === "asc" ? c : -c;
-        });
-        rows.forEach(function (r) { tbody.appendChild(r); });
-      });
-    });
-    // Filter rows.
-    var fig = table.closest(".table-figure");
-    var input = fig ? fig.querySelector(".table-filter") : null;
-    if (input) input.addEventListener("input", function () {
-      var q = input.value.toLowerCase();
-      Array.prototype.forEach.call(tbody.rows, function (r) {
-        r.style.display = (r.textContent || "").toLowerCase().indexOf(q) >= 0 ? "" : "none";
-      });
-    });
-  });
-})();
+export const JS = `
+(function () {
+  function cmp(a, b) {
+    var na = a.dataset.sort, nb = b.dataset.sort;
+    if (na !== undefined && nb !== undefined) return parseFloat(na) - parseFloat(nb);
+    return (a.textContent || "").localeCompare(b.textContent || "");
+  }
+  document.querySelectorAll("table.geml-table").forEach(function (table) {
+    var tbody = table.tBodies[0];
+    if (!tbody) return;
+    // Sort on header click.
+    var ths = table.tHead ? table.tHead.rows[0].cells : [];
+    Array.prototype.forEach.call(ths, function (th, col) {
+      th.addEventListener("click", function () {
+        var dir = th.classList.contains("asc") ? "desc" : "asc";
+        Array.prototype.forEach.call(ths, function (h) { h.classList.remove("asc", "desc"); });
+        th.classList.add(dir);
+        var rows = Array.prototype.slice.call(tbody.rows);
+        rows.sort(function (r1, r2) {
+          var c = cmp(r1.cells[col], r2.cells[col]);
+          return dir === "asc" ? c : -c;
+        });
+        rows.forEach(function (r) { tbody.appendChild(r); });
+      });
+    });
+    // Filter rows.
+    var fig = table.closest(".table-figure");
+    var input = fig ? fig.querySelector(".table-filter") : null;
+    if (input) input.addEventListener("input", function () {
+      var q = input.value.toLowerCase();
+      Array.prototype.forEach.call(tbody.rows, function (r) {
+        r.style.display = (r.textContent || "").toLowerCase().indexOf(q) >= 0 ? "" : "none";
+      });
+    });
+  });
+})();
 `;
 // geml-code-graph runtime: layered layout AT DRAW TIME (GEP-0003 / v2-D8) so
 // clicking a node re-roots the view inside the embedded slice. Algorithm as

package/dist/selector.d.ts

@@ -0,0 +1,55 @@
+export interface Span {
+    start: number;
+    end: number;
+}
+export interface Unit {
+    span: Span;
+    kind: "block" | "heading" | "footnote";
+    type?: string;
+    id?: string;
+    level?: number;
+    text?: string;
+}
+export type Selector = {
+    form: "list";
+} | {
+    form: "id";
+    raw: string;
+} | {
+    form: "type";
+    type: string;
+} | {
+    form: "content";
+    type?: string;
+    hex: string;
+    nth: number;
+} | {
+    form: "attr";
+    type: string;
+    key: string;
+};
+export declare function sha8(text: string): string;
+export declare function parseSelector(raw: string | undefined, attrsIdOf: (braces: string) => string | undefined): Selector;
+export interface Addressed {
+    unit: Unit;
+    hex: string;
+    nth: number;
+}
+export declare function addressUnits(units: Unit[], textOf: (u: Unit) => string): Addressed[];
+export declare function shortestAddress(a: Addressed, all: Addressed[]): string;
+export type ContentHit = {
+    ok: true;
+    unit: Unit;
+} | {
+    ok: false;
+    why: "no-match";
+} | {
+    ok: false;
+    why: "wrong-type";
+    found: string;
+};
+export declare function matchContent(sel: Extract<Selector, {
+    form: "content";
+}>, all: Addressed[]): ContentHit;
+export declare function discoveryHint(where: string): string;
+export declare function matchType(type: string, all: Addressed[]): Unit[];

package/dist/selector.js

@@ -0,0 +1,112 @@
+// Block selectors — the one syntax `get`, `set` and `history get` all address
+// blocks with (design: docs/design/specs/2026-08-04-geml-get-set-selector-design-change.md).
+//
+// §2's rule: a selector is a FILTER over blocks, `{…}` holds keys, and the same
+// abbreviation rule applies twice — `#id` is `{#id}` short, `@<hex>` is
+// `{@<hex>}` short. Both are keys; they differ only in selectivity.
+//
+// This module is PURE: it parses selector text and matches it against a unit
+// index the caller supplies. It deliberately imports nothing from geml.ts —
+// that module runs the CLI dispatch on import, so depending on it here would
+// turn `import { parseSelector }` into "run the CLI". The scan that produces
+// `Unit[]` therefore stays in geml.ts (one walk, several sinks) and the
+// selector logic stays here, where it can be unit-tested on plain data.
+import { createHash } from "node:crypto";
+// The content address's hash. Same spelling as the `.gemlhistory` unit key
+// (history.ts:112) because both answer the same question — how to address a
+// unit that carries no id. The VALUES are deliberately not promised to match:
+// history hashes a tile (trailing blank lines included), this hashes a block's
+// span (§3.3). Do not port an address from one layer to the other.
+export function sha8(text) {
+    return createHash("sha256").update(Buffer.from(text, "utf8")).digest("hex").slice(0, 8);
+}
+const FENCE_SEL = /^={3,}[ \t]*([A-Za-z][A-Za-z0-9_-]*)[ \t]*(@[0-9a-fA-F]{1,}(?:~\d+)?)?[ \t]*(\{.*\})?[ \t]*$/;
+const BARE_AT = /^@([0-9a-fA-F]+)(?:~(\d+))?$/;
+// Parse selector TEXT. Never touches a document: every form is decided by
+// lexis alone, which is also what keeps the two selector namespaces on
+// `history get <file> <rev> <selector>` from overlapping (history design §10.2).
+// `attrsIdOf` lets the caller reuse its own `{…}` parser (parseAttrs) rather
+// than this module growing a second one.
+export function parseSelector(raw, attrsIdOf) {
+    if (raw === undefined || raw.trim() === "")
+        return { form: "list" };
+    const s = raw.trim();
+    const bare = BARE_AT.exec(s);
+    if (bare)
+        return { form: "content", hex: bare[1].toLowerCase(), nth: bare[2] ? Number(bare[2]) : 0 };
+    const fence = FENCE_SEL.exec(s);
+    if (fence) {
+        const type = fence[1];
+        const at = fence[2];
+        const braces = fence[3];
+        if (braces !== undefined) {
+            // `=== type {#id}` is the id key written out in full — redundant but
+            // legal (§2). Any OTHER key is the declared-not-implemented form.
+            const id = attrsIdOf(braces);
+            if (id !== undefined)
+                return { form: "id", raw: `#${id}` };
+            return { form: "attr", type, key: firstKey(braces) };
+        }
+        if (at !== undefined) {
+            const m = BARE_AT.exec(at);
+            return { form: "content", type, hex: m[1].toLowerCase(), nth: m[2] ? Number(m[2]) : 0 };
+        }
+        return { form: "type", type };
+    }
+    // Anything else is an id or a pasted heading line; the caller resolves it.
+    return { form: "id", raw: s };
+}
+// The first key inside `{…}`, for the §7 error message. Best-effort: it only
+// has to name what the caller typed, and a class (`.warn`) is reported as
+// written so the message does not claim a key that is not there.
+function firstKey(braces) {
+    const inner = braces.replace(/^\{/, "").replace(/\}$/, "").trim();
+    const m = /^([.#]?[A-Za-z_][A-Za-z0-9_-]*)/.exec(inner);
+    return m ? m[1] : inner.split(/[\s=]/)[0] ?? "";
+}
+export function addressUnits(units, textOf) {
+    const seen = new Map();
+    return units.map((unit) => {
+        // LF-normalized so a CRLF checkout and an LF one address the same block.
+        const hex = sha8(textOf(unit).replace(/\r\n?/g, "\n"));
+        const nth = seen.get(hex) ?? 0;
+        seen.set(hex, nth + 1);
+        return { unit, hex, nth };
+    });
+}
+// §6.1 — the SHORTEST address that identifies this unit uniquely, which is what
+// the listing prints. `#id` when it has one; else the bare type when the
+// document holds exactly one block of it; else the content address. The three
+// cases are one rule ("shortest unique"), not three rules.
+export function shortestAddress(a, all) {
+    const u = a.unit;
+    if (u.id !== undefined)
+        return `#${u.id}`;
+    if (u.type === undefined)
+        return `@${a.hex}${a.nth ? `~${a.nth}` : ""}`;
+    const sameType = all.filter((x) => x.unit.type === u.type).length;
+    if (sameType === 1)
+        return `=== ${u.type}`;
+    return `=== ${u.type}@${a.hex}${a.nth ? `~${a.nth}` : ""}`;
+}
+export function matchContent(sel, all) {
+    const hit = all.find((a) => a.hex === sel.hex && a.nth === sel.nth);
+    if (!hit)
+        return { ok: false, why: "no-match" };
+    if (sel.type !== undefined && hit.unit.type !== sel.type) {
+        return { ok: false, why: "wrong-type", found: hit.unit.type ?? hit.unit.kind };
+    }
+    return { ok: true, unit: hit.unit };
+}
+// Where to send a caller whose selector found nothing: the listing IS the
+// discovery command, and every address it prints pastes straight back (§6.2).
+// One place, so `get`, `set` and `history get` all point at the same next step.
+export function discoveryHint(where) {
+    return ` — run \`geml get ${where}\` to list every addressable block`;
+}
+// Match a type filter: every block of that type in document order. Blocks that
+// carry an id are INCLUDED — the selector says nothing about ids, so filtering
+// by whether one is present would be a rule nobody wrote down (§2).
+export function matchType(type, all) {
+    return all.filter((a) => a.unit.type === type).map((a) => a.unit);
+}

package/dist/serialize.js

@@ -174,6 +174,18 @@ function serTypedBlock(b) {
     else if (b.mode === "data") {
         body = Object.entries(b.data ?? {}).map(([k, v]) => `${k} = ${serDataValue(v)}`);
     }
+    else if (b.type === "data" && b.value !== undefined && b.attrs["src"] === undefined) {
+        // src= content lives in the FILE: a value loaded from it must never be
+        // inlined into the document by a re-format — the body stays as authored
+        // (normally empty), or the source of truth would silently fork.
+        // GEP-0005 canonical form — legal because this is DATA, not verbatim text
+        // (code stays byte-preserved): json pretty-prints at two spaces, jsonl is
+        // one compact value per line. Engine-less bodies (yaml/toml/unknown)
+        // never reach here (no `value`) and fall through byte-preserved.
+        body = String(b.attrs["format"] ?? "json") === "jsonl" && Array.isArray(b.value)
+            ? b.value.map((v) => JSON.stringify(v))
+            : JSON.stringify(b.value, null, 2).split("\n");
+    }
     else {
         body = b.raw ?? [];
     }

package/dist/table.js

@@ -60,6 +60,27 @@ function parseDelimited(body, sep, header) {
     const width = rows.reduce((m, r) => Math.max(m, r.length), 0);
     return { columns: letters(width), align: [], header: false, cells: rows };
 }
+// The character a data body splits on: the format's natural delimiter unless
+// `delim=` names another single one — `;` for a European CSV, `|` for a
+// pipe-delimited export (§6). Measured in code points, so an astral character
+// counts as one. §4 attribute values carry no escape syntax, so a tab
+// delimiter is spelled `format=tsv`, never `delim="\t"`; a value that is not
+// exactly one character is an error and the natural delimiter is used, which
+// keeps the rest of the table readable.
+function resolveDelim(fmt, raw, diagnostics) {
+    const natural = fmt === "tsv" ? "\t" : ",";
+    if (raw === undefined)
+        return natural;
+    const d = String(raw);
+    if ([...d].length === 1)
+        return d;
+    diagnostics.push({
+        severity: "error",
+        code: "bad-table-delimiter",
+        message: `\`delim="${d}"\` must be exactly one character (for a tab use \`format=tsv\`); split on ${fmt === "tsv" ? "a tab" : "`,`"} instead`,
+    });
+    return natural;
+}
 function letters(n) {
     const out = [];
     for (let i = 0; i < n; i++)
@@ -271,11 +292,16 @@ export function parseTable(body, attrs, line, sink) {
     if (fmt === "csv" || fmt === "tsv") {
         const headerAttr = attrs["header"];
         const header = headerAttr === undefined ? true : headerAttr === true || headerAttr === 1 || headerAttr === "1";
-        raw = parseDelimited(body, fmt === "tsv" ? "\t" : ",", header);
+        raw = parseDelimited(body, resolveDelim(fmt, attrs["delim"], diagnostics), header);
     }
     else {
         if (fmt !== undefined)
             diagnostics.push({ severity: "warning", code: "unknown-table-format", message: `unknown table format \`${fmt}\`; parsed as visual grid` });
+        // `delim` refines the data form; it does not select it. Silently dropping it
+        // would leave a `=== table {delim=";"}` parsed as a one-column visual grid
+        // with nothing to say why.
+        if (attrs["delim"] !== undefined)
+            diagnostics.push({ severity: "warning", code: "ignored-table-delimiter", message: "`delim` applies to a data body (`format=csv`/`tsv`); this body was parsed as a visual grid, so it is ignored" });
         raw = parseVisual(body);
     }
     const columns = [...raw.columns];

package/dist/to-md.js

@@ -144,6 +144,11 @@ function typedToMd(b, notes) {
     const raw = b.raw ?? [];
     if (b.type === "code")
         return fence(attr(b, "lang") ?? "", raw);
+    // GEP-0005: a data block projects as a fenced code block in its format —
+    // the nearest GFM shape (Markdown has no verified-data construct; that loss
+    // is the usual --to md lossiness, not a defect of the projection).
+    if (b.type === "data")
+        return fence(attr(b, "format") ?? "json", raw);
     if (b.type === "math")
         return ["$$", ...raw, "$$"].join("\n");
     if (b.type === "table" && b.table)