@gyral/core 0.1.0 → 0.3.0

package/dist/view/render/raw.js

@@ -0,0 +1,68 @@
+// `raw(html)` (view/02-bindings.md "`raw(html)`"): trusted markup parsed in a child hole, kept
+// as a node range after a start anchor and re-parsed only when the string changes. Its result
+// carries `commitRaw`, so apps that never call `raw` don't bundle this module.
+import { DEV } from '#view-dev';
+import { EMPTY, RAW } from './child-part.js';
+import { removeRange } from './nodes.js';
+import { report } from './seen.js';
+import { MARKUP } from './values.js';
+import { warnRaw } from './warn.js';
+/** Parsed `raw()` markup: the start anchor, the last node, and the string. */
+export class RawRange {
+    constructor(start, end, html) {
+        this.start = start;
+        this.end = end;
+        this.html = html;
+    }
+    first() {
+        return this.start;
+    }
+    last() {
+        return this.end;
+    }
+    remove() {
+        removeRange(this.start, this.end);
+    }
+}
+let parser;
+/** `html` parsed by a <template> (its content is reused: read it before the next call). */
+export function parse(html) {
+    parser ??= document.createElement('template');
+    parser.innerHTML = html;
+    return parser.content;
+}
+/** Commits `raw()` markup into `part`. */
+function commitRaw(part, html) {
+    if (DEV)
+        warnRaw();
+    report({ html });
+    if (part.kind === RAW) {
+        const range = part.content;
+        if (range.html === html)
+            return;
+        if (range.end !== range.start)
+            removeRange(range.start.nextSibling, range.end);
+        const frag = parse(html);
+        range.end = frag.lastChild ?? range.start;
+        range.html = html;
+        range.start.after(frag);
+        return;
+    }
+    if (part.kind !== EMPTY)
+        part.clear();
+    const start = document.createComment('');
+    const frag = parse(html);
+    const end = frag.lastChild ?? start;
+    frag.prepend(start);
+    part.parent().insertBefore(frag, part.end());
+    part.kind = RAW;
+    part.content = new RawRange(start, end, html);
+}
+/**
+ * Trusted markup from your own code (Markdown output, JSON-LD), parsed in a child hole and
+ * re-parsed only when the string changes. Never pass user input.
+ */
+export function raw(html) {
+    return { [MARKUP]: commitRaw, html };
+}
+//# sourceMappingURL=raw.js.map

package/dist/view/render/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../../src/view/render/raw.ts"],"names":[],"mappings":"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","sourcesContent":["// `raw(html)` (view/02-bindings.md \"`raw(html)`\"): trusted markup parsed in a child hole, kept\n// as a node range after a start anchor and re-parsed only when the string changes. Its result\n// carries `commitRaw`, so apps that never call `raw` don't bundle this module.\nimport { DEV } from '#view-dev';\nimport { EMPTY, RAW, type ChildPart } from './child-part.js';\nimport { removeRange } from './nodes.js';\nimport { report } from './seen.js';\nimport { MARKUP, type RawResult } from './values.js';\nimport { warnRaw } from './warn.js';\n\n/** Parsed `raw()` markup: the start anchor, the last node, and the string. */\nexport class RawRange {\n  constructor(\n    readonly start: Comment,\n    public end: Node,\n    public html: string,\n  ) {}\n\n  first(): Node {\n    return this.start;\n  }\n\n  last(): Node {\n    return this.end;\n  }\n\n  remove(): void {\n    removeRange(this.start, this.end);\n  }\n}\n\nlet parser: HTMLTemplateElement | undefined;\n\n/** `html` parsed by a <template> (its content is reused: read it before the next call). */\nexport function parse(html: string): DocumentFragment {\n  parser ??= document.createElement('template');\n  parser.innerHTML = html;\n  return parser.content;\n}\n\n/** Commits `raw()` markup into `part`. */\nfunction commitRaw(part: ChildPart, html: string): void {\n  if (DEV) warnRaw();\n  report({ html });\n  if (part.kind === RAW) {\n    const range = part.content as RawRange;\n    if (range.html === html) return;\n    if (range.end !== range.start) removeRange(range.start.nextSibling as Node, range.end);\n    const frag = parse(html);\n    range.end = frag.lastChild ?? range.start;\n    range.html = html;\n    range.start.after(frag);\n    return;\n  }\n  if (part.kind !== EMPTY) part.clear();\n  const start = document.createComment('');\n  const frag = parse(html);\n  const end = frag.lastChild ?? start;\n  frag.prepend(start);\n  part.parent().insertBefore(frag, part.end());\n  part.kind = RAW;\n  part.content = new RawRange(start, end, html);\n}\n\n/**\n * Trusted markup from your own code (Markdown output, JSON-LD), parsed in a child hole and\n * re-parsed only when the string changes. Never pass user input.\n */\nexport function raw(html: string): RawResult {\n  return { [MARKUP]: commitRaw, html };\n}\n"]}

package/dist/view/render/render.d.ts

@@ -0,0 +1,12 @@
+import { ChildPart } from './child-part.js';
+import { type SeenMarkup } from './seen.js';
+import type { ChildValue } from './values.js';
+/** Runs `fn` (one scheduler flush) with one shared row-check budget for every render in it. */
+export declare function renderBatch(fn: () => void): void;
+/**
+ * Renders `value` into `root`, updating what an earlier call rendered there. `seen` is told
+ * about each template the render instantiates (seen.ts).
+ */
+export declare function render(value: ChildValue, root: Element | ShadowRoot | DocumentFragment, seen?: SeenMarkup): void;
+/** Hydration (hydrate.ts): `part`, built over server DOM, is `root`'s part from now on. */
+export declare function setRootPart(root: Node, part: ChildPart): void;

package/dist/view/render/render.js

@@ -0,0 +1,60 @@
+// `render(value, root)`: the client renderer's entry point (view/02-bindings.md "Commit order").
+// The root's child part is cached per root, so later calls update in place. Synchronous: when
+// it returns, the DOM is committed and every element hook's `client` call has run. The
+// scheduler (view/04-scheduler.md) calls it once per dirty host, inside `renderBatch`, so the
+// list dev check's budget (03) is per flush; a call outside a batch gets a budget of its own.
+// `hydrate(value, root)` (hydrate.ts) makes the same root part from server DOM instead (07).
+import { DEV } from '#view-dev';
+import { ChildPart } from './child-part.js';
+import { resetRowChecks } from './dev-check.js';
+import { dropHooks, hookMark, runHooks } from './hooks.js';
+import { listenFor } from './seen.js';
+const roots = new WeakMap();
+let batching = false;
+/** Runs `fn` (one scheduler flush) with one shared row-check budget for every render in it. */
+export function renderBatch(fn) {
+    if (!DEV) {
+        fn(); // the budget is a development check: production needs no batch state
+        return;
+    }
+    resetRowChecks();
+    const outer = batching;
+    batching = true;
+    try {
+        fn();
+    }
+    finally {
+        batching = outer;
+    }
+}
+/**
+ * Renders `value` into `root`, updating what an earlier call rendered there. `seen` is told
+ * about each template the render instantiates (seen.ts).
+ */
+export function render(value, root, seen) {
+    let part = roots.get(root);
+    if (part === undefined) {
+        part = new ChildPart(root, null, null, 0, false, 0);
+        roots.set(root, part);
+    }
+    const mark = hookMark();
+    if (DEV && !batching)
+        resetRowChecks();
+    const outer = listenFor(seen);
+    try {
+        part.commit(value);
+    }
+    catch (error) {
+        dropHooks(mark);
+        throw error;
+    }
+    finally {
+        listenFor(outer);
+    }
+    runHooks(mark);
+}
+/** Hydration (hydrate.ts): `part`, built over server DOM, is `root`'s part from now on. */
+export function setRootPart(root, part) {
+    roots.set(root, part);
+}
+//# sourceMappingURL=render.js.map

package/dist/view/render/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/view/render/render.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,8FAA8F;AAC9F,uFAAuF;AACvF,8FAA8F;AAC9F,8FAA8F;AAC9F,6FAA6F;AAC7F,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAmB,MAAM,WAAW,CAAC;AAGvD,MAAM,KAAK,GAAG,IAAI,OAAO,EAAmB,CAAC;AAC7C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,EAAE,EAAE,CAAC,CAAC,qEAAqE;QAC3E,OAAO;IACT,CAAC;IACD,cAAc,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,QAAQ,CAAC;IACvB,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,CAAC;QACH,EAAE,EAAE,CAAC;IACP,CAAC;YAAS,CAAC;QACT,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CACpB,KAAiB,EACjB,IAA6C,EAC7C,IAAiB;IAEjB,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACpD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,IAAI,GAAG,IAAI,CAAC,QAAQ;QAAE,cAAc,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,IAAe;IACrD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC","sourcesContent":["// `render(value, root)`: the client renderer's entry point (view/02-bindings.md \"Commit order\").\n// The root's child part is cached per root, so later calls update in place. Synchronous: when\n// it returns, the DOM is committed and every element hook's `client` call has run. The\n// scheduler (view/04-scheduler.md) calls it once per dirty host, inside `renderBatch`, so the\n// list dev check's budget (03) is per flush; a call outside a batch gets a budget of its own.\n// `hydrate(value, root)` (hydrate.ts) makes the same root part from server DOM instead (07).\nimport { DEV } from '#view-dev';\nimport { ChildPart } from './child-part.js';\nimport { resetRowChecks } from './dev-check.js';\nimport { dropHooks, hookMark, runHooks } from './hooks.js';\nimport { listenFor, type SeenMarkup } from './seen.js';\nimport type { ChildValue } from './values.js';\n\nconst roots = new WeakMap<Node, ChildPart>();\nlet batching = false;\n\n/** Runs `fn` (one scheduler flush) with one shared row-check budget for every render in it. */\nexport function renderBatch(fn: () => void): void {\n  if (!DEV) {\n    fn(); // the budget is a development check: production needs no batch state\n    return;\n  }\n  resetRowChecks();\n  const outer = batching;\n  batching = true;\n  try {\n    fn();\n  } finally {\n    batching = outer;\n  }\n}\n\n/**\n * Renders `value` into `root`, updating what an earlier call rendered there. `seen` is told\n * about each template the render instantiates (seen.ts).\n */\nexport function render(\n  value: ChildValue,\n  root: Element | ShadowRoot | DocumentFragment,\n  seen?: SeenMarkup,\n): void {\n  let part = roots.get(root);\n  if (part === undefined) {\n    part = new ChildPart(root, null, null, 0, false, 0);\n    roots.set(root, part);\n  }\n  const mark = hookMark();\n  if (DEV && !batching) resetRowChecks();\n  const outer = listenFor(seen);\n  try {\n    part.commit(value);\n  } catch (error) {\n    dropHooks(mark);\n    throw error;\n  } finally {\n    listenFor(outer);\n  }\n  runHooks(mark);\n}\n\n/** Hydration (hydrate.ts): `part`, built over server DOM, is `root`'s part from now on. */\nexport function setRootPart(root: Node, part: ChildPart): void {\n  roots.set(root, part);\n}\n"]}

package/dist/view/render/reorder.d.ts

@@ -0,0 +1,4 @@
+import type { ChildPart } from './child-part.js';
+import { type List } from './rows.js';
+import type { ListResult } from './values.js';
+export declare function reorder(part: ChildPart, list: List, l: ListResult, rows: ChildPart[], s: number, oe: number, ne: number): void;

package/dist/view/render/reorder.js

@@ -0,0 +1,101 @@
+import { clearList, createRows } from './list.js';
+import { lis, placeRows } from './place.js';
+import { firstFrom, newRow, updateRow } from './rows.js';
+function match(old, keys, s, oe, ne) {
+    const src = new Int32Array(ne - s + 1).fill(-1);
+    const keep = new Uint8Array(ne - s + 1);
+    const m = { src, keep, found: 0 };
+    let os = s;
+    let ns = s;
+    for (; os <= oe && ns <= ne; m.found++) {
+        const head = old[os].key;
+        const tail = old[oe].key;
+        if (keys[ns - s] === head) {
+            keep[ns - s] = 1;
+            src[ns++ - s] = os++;
+        }
+        else if (keys[ne - s] === tail) {
+            keep[ne - s] = 1;
+            src[ne-- - s] = oe--;
+        }
+        else if (keys[ne - s] === head)
+            src[ne-- - s] = os++;
+        else if (keys[ns - s] === tail)
+            src[ns++ - s] = oe--;
+        else
+            break;
+    }
+    if (os > oe || ns > ne)
+        return m;
+    m.keep = undefined;
+    const byKey = new Map();
+    for (let j = os; j <= oe; j++)
+        byKey.set(old[j].key, j);
+    for (let i = ns; i <= ne; i++) {
+        const key = keys[i - s];
+        const j = byKey.get(key);
+        if (j === undefined)
+            continue; // a new key (or, in production, a later duplicate)
+        byKey.delete(key);
+        src[i - s] = j;
+        m.found++;
+    }
+    return m;
+}
+export function reorder(part, list, l, rows, s, oe, ne) {
+    const { items, key } = l;
+    const old = list.rows;
+    const keys = [];
+    for (let i = s; i <= ne; i++)
+        keys.push(key(items[i]));
+    const m = match(old, keys, s, oe, ne);
+    const end = firstFrom(old, oe + 1, part);
+    if (m.found === 0) {
+        // Nothing reused: drop the old rows (all at once when they are the whole list).
+        if (s === 0 && oe === old.length - 1)
+            clearList(part, list);
+        else
+            for (let j = s; j <= oe; j++)
+                old[j].clear();
+        createRows(part, list, l, rows, s, ne, end, keys);
+        return;
+    }
+    const src = m.src;
+    const reused = new Uint8Array(oe - s + 1);
+    let frag = null;
+    let moved = false;
+    let last = -1;
+    for (let i = s; i <= ne; i++) {
+        const j = src[i - s];
+        if (j < 0) {
+            frag ??= document.createDocumentFragment();
+            rows.push(newRow(null, frag, l, items[i], keys[i - s], i));
+            continue;
+        }
+        reused[j - s] = 1;
+        if (j < last)
+            moved = true;
+        else
+            last = j;
+        const row = old[j];
+        updateRow(row, items[i], l);
+        rows.push(row);
+    }
+    for (let j = s; j <= oe; j++)
+        if (reused[j - s] === 0)
+            old[j].clear();
+    if (!moved && frag === null)
+        return;
+    const keep = moved ? (m.keep ?? lis(src)) : undefined;
+    placeRows(part.parent(), rows, s, ne, src, keep, end);
+    if (frag === null)
+        return;
+    for (let i = s; i <= ne; i++) {
+        if (src[i - s] >= 0)
+            continue;
+        const row = rows[i];
+        row.parentNode = null;
+        row.owner = list;
+    }
+}
+//# sourceMappingURL=reorder.js.map

package/dist/view/render/reorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.js","sourceRoot":"","sources":["../../../src/view/render/reorder.ts"],"names":[],"mappings":"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","sourcesContent":["// Reordering the middle of a list (view/03-lists.md \"Reconciliation\", steps 1–3): old rows\n// `s…oe` become new rows `s…ne` once the common prefix and suffix are trimmed. Keys are matched\n// by a two-ended scan first (head and tail, crossed both ways), so swaps, single moves and\n// reversals need no map: the rows matched in place stay and the crossed ones move. When the\n// scan gets stuck, a key map matches the rest and the rows on a longest increasing subsequence\n// of old positions stay. Reused rows re-render in document order before anything moves; gone\n// rows are removed. The benchmark behind this choice is recorded in the spec.\nimport type { ChildPart } from './child-part.js';\nimport { clearList, createRows } from './list.js';\nimport { lis, placeRows } from './place.js';\nimport { firstFrom, newRow, updateRow, type List } from './rows.js';\nimport type { ListResult } from './values.js';\n\n/** The matching: old positions per new row (-1: new), what stays, and how many were found. */\ninterface Match {\n  readonly src: Int32Array;\n  /** Rows to keep in place; undefined: compute from `src` (the key map was needed). */\n  keep: Uint8Array | undefined;\n  found: number;\n}\n\nfunction match(\n  old: readonly ChildPart[],\n  keys: readonly unknown[],\n  s: number,\n  oe: number,\n  ne: number,\n): Match {\n  const src = new Int32Array(ne - s + 1).fill(-1);\n  const keep = new Uint8Array(ne - s + 1);\n  const m: Match = { src, keep, found: 0 };\n  let os = s;\n  let ns = s;\n  for (; os <= oe && ns <= ne; m.found++) {\n    const head = (old[os] as ChildPart).key;\n    const tail = (old[oe] as ChildPart).key;\n    if (keys[ns - s] === head) {\n      keep[ns - s] = 1;\n      src[ns++ - s] = os++;\n    } else if (keys[ne - s] === tail) {\n      keep[ne - s] = 1;\n      src[ne-- - s] = oe--;\n    } else if (keys[ne - s] === head) src[ne-- - s] = os++;\n    else if (keys[ns - s] === tail) src[ns++ - s] = oe--;\n    else break;\n  }\n  if (os > oe || ns > ne) return m;\n  m.keep = undefined;\n  const byKey = new Map<unknown, number>();\n  for (let j = os; j <= oe; j++) byKey.set((old[j] as ChildPart).key, j);\n  for (let i = ns; i <= ne; i++) {\n    const key = keys[i - s];\n    const j = byKey.get(key);\n    if (j === undefined) continue; // a new key (or, in production, a later duplicate)\n    byKey.delete(key);\n    src[i - s] = j;\n    m.found++;\n  }\n  return m;\n}\n\nexport function reorder(\n  part: ChildPart,\n  list: List,\n  l: ListResult,\n  rows: ChildPart[],\n  s: number,\n  oe: number,\n  ne: number,\n): void {\n  const { items, key } = l;\n  const old = list.rows;\n  const keys: unknown[] = [];\n  for (let i = s; i <= ne; i++) keys.push(key(items[i]));\n  const m = match(old, keys, s, oe, ne);\n  const end = firstFrom(old, oe + 1, part);\n  if (m.found === 0) {\n    // Nothing reused: drop the old rows (all at once when they are the whole list).\n    if (s === 0 && oe === old.length - 1) clearList(part, list);\n    else for (let j = s; j <= oe; j++) (old[j] as ChildPart).clear();\n    createRows(part, list, l, rows, s, ne, end, keys);\n    return;\n  }\n  const src = m.src;\n  const reused = new Uint8Array(oe - s + 1);\n  let frag: DocumentFragment | null = null;\n  let moved = false;\n  let last = -1;\n  for (let i = s; i <= ne; i++) {\n    const j = src[i - s] as number;\n    if (j < 0) {\n      frag ??= document.createDocumentFragment();\n      rows.push(newRow(null, frag, l, items[i], keys[i - s], i));\n      continue;\n    }\n    reused[j - s] = 1;\n    if (j < last) moved = true;\n    else last = j;\n    const row = old[j] as ChildPart;\n    updateRow(row, items[i], l);\n    rows.push(row);\n  }\n  for (let j = s; j <= oe; j++) if (reused[j - s] === 0) (old[j] as ChildPart).clear();\n  if (!moved && frag === null) return;\n  const keep = moved ? (m.keep ?? lis(src)) : undefined;\n  placeRows(part.parent(), rows, s, ne, src, keep, end);\n  if (frag === null) return;\n  for (let i = s; i <= ne; i++) {\n    if ((src[i - s] as number) >= 0) continue;\n    const row = rows[i] as ChildPart;\n    row.parentNode = null;\n    row.owner = list;\n  }\n}\n"]}

package/dist/view/render/rows.d.ts

@@ -0,0 +1,23 @@
+import { ChildPart, type Owner } from './child-part.js';
+import type { ListResult } from './values.js';
+/** The rows of a list or the items of an array, owned by one child part. */
+export declare class List implements Owner {
+    readonly part: ChildPart;
+    rows: ChildPart[];
+    /** While rows are created into a fragment: they append to it. */
+    building: DocumentFragment | null;
+    /** Where the development re-evaluation check continues (dev-check.ts). */
+    cursor: number;
+    constructor(part: ChildPart);
+    parentFor(): Node;
+    endFor(index: number): Node | null;
+    first(): Node | null;
+    last(): Node | null;
+}
+/** The first node of `rows[from…]`, or the end of the list's part. */
+export declare function firstFrom(rows: readonly ChildPart[], from: number, part: ChildPart): Node | null;
+/** `Object.is`, or for arrays and plain objects the same entries by `Object.is` (one level). */
+export declare function samePick(a: unknown, b: unknown): boolean;
+export declare function updateRow(row: ChildPart, item: unknown, l: ListResult): void;
+/** A new row: open (positioned by `owner`), or appended to `parent` until placed. */
+export declare function newRow(owner: List | null, parent: Node | null, l: ListResult, item: unknown, key: unknown, index: number): ChildPart;

package/dist/view/render/rows.js

@@ -0,0 +1,95 @@
+// Rows of lists and arrays (view/03-lists.md "Row skipping", "Row boundaries"): the list that
+// owns them (and resolves their positions), row skipping by item identity and a shallow pick
+// comparison, and row creation. Shared by list.ts and the reordering step (reorder.ts).
+import { ChildPart } from './child-part.js';
+/** The rows of a list or the items of an array, owned by one child part. */
+export class List {
+    constructor(part) {
+        this.part = part;
+        this.rows = [];
+        this.building = null;
+        this.cursor = 0;
+    }
+    parentFor() {
+        return this.building ?? this.part.parent();
+    }
+    endFor(index) {
+        return this.building !== null ? null : firstFrom(this.rows, index + 1, this.part);
+    }
+    first() {
+        const rows = this.rows;
+        for (let i = 0; i < rows.length; i++) {
+            const node = rows[i].first();
+            if (node !== null)
+                return node;
+        }
+        return null;
+    }
+    last() {
+        const rows = this.rows;
+        for (let i = rows.length - 1; i >= 0; i--) {
+            const node = rows[i].last();
+            if (node !== null)
+                return node;
+        }
+        return null;
+    }
+}
+/** The first node of `rows[from…]`, or the end of the list's part. */
+export function firstFrom(rows, from, part) {
+    for (let j = from; j < rows.length; j++) {
+        const node = rows[j].first();
+        if (node !== null)
+            return node;
+    }
+    return part.end();
+}
+/** `Object.is`, or for arrays and plain objects the same entries by `Object.is` (one level). */
+export function samePick(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        for (let i = 0; i < a.length; i++)
+            if (!Object.is(a[i], b[i]))
+                return false;
+        return true;
+    }
+    const proto = Object.getPrototypeOf(a);
+    if ((proto !== Object.prototype && proto !== null) || Object.getPrototypeOf(b) !== proto) {
+        return false;
+    }
+    const keys = Object.keys(a);
+    if (keys.length !== Object.keys(b).length)
+        return false;
+    for (const k of keys) {
+        if (!Object.hasOwn(b, k))
+            return false;
+        if (!Object.is(a[k], b[k])) {
+            return false;
+        }
+    }
+    return true;
+}
+export function updateRow(row, item, l) {
+    const picked = l.pick === undefined ? undefined : l.pick(item);
+    if (item === row.item && samePick(picked, row.picked))
+        return;
+    row.item = item;
+    row.picked = picked;
+    row.commit(l.row(item, picked));
+}
+/** A new row: open (positioned by `owner`), or appended to `parent` until placed. */
+export function newRow(owner, parent, l, item, key, index) {
+    const row = new ChildPart(parent, null, owner, index, false, -1);
+    const picked = l.pick === undefined ? undefined : l.pick(item);
+    row.key = key;
+    row.item = item;
+    row.picked = picked;
+    row.commit(l.row(item, picked));
+    return row;
+}
+//# sourceMappingURL=rows.js.map

package/dist/view/render/rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../../src/view/render/rows.ts"],"names":[],"mappings":"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","sourcesContent":["// Rows of lists and arrays (view/03-lists.md \"Row skipping\", \"Row boundaries\"): the list that\n// owns them (and resolves their positions), row skipping by item identity and a shallow pick\n// comparison, and row creation. Shared by list.ts and the reordering step (reorder.ts).\nimport { ChildPart, type Owner } from './child-part.js';\nimport type { ListResult } from './values.js';\n\n/** The rows of a list or the items of an array, owned by one child part. */\nexport class List implements Owner {\n  readonly part: ChildPart;\n  rows: ChildPart[];\n  /** While rows are created into a fragment: they append to it. */\n  building: DocumentFragment | null;\n  /** Where the development re-evaluation check continues (dev-check.ts). */\n  cursor: number;\n\n  constructor(part: ChildPart) {\n    this.part = part;\n    this.rows = [];\n    this.building = null;\n    this.cursor = 0;\n  }\n\n  parentFor(): Node {\n    return this.building ?? this.part.parent();\n  }\n\n  endFor(index: number): Node | null {\n    return this.building !== null ? null : firstFrom(this.rows, index + 1, this.part);\n  }\n\n  first(): Node | null {\n    const rows = this.rows;\n    for (let i = 0; i < rows.length; i++) {\n      const node = (rows[i] as ChildPart).first();\n      if (node !== null) return node;\n    }\n    return null;\n  }\n\n  last(): Node | null {\n    const rows = this.rows;\n    for (let i = rows.length - 1; i >= 0; i--) {\n      const node = (rows[i] as ChildPart).last();\n      if (node !== null) return node;\n    }\n    return null;\n  }\n}\n\n/** The first node of `rows[from…]`, or the end of the list's part. */\nexport function firstFrom(rows: readonly ChildPart[], from: number, part: ChildPart): Node | null {\n  for (let j = from; j < rows.length; j++) {\n    const node = (rows[j] as ChildPart).first();\n    if (node !== null) return node;\n  }\n  return part.end();\n}\n\n/** `Object.is`, or for arrays and plain objects the same entries by `Object.is` (one level). */\nexport function samePick(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null) return false;\n  if (Array.isArray(a) || Array.isArray(b)) {\n    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;\n    for (let i = 0; i < a.length; i++) if (!Object.is(a[i], b[i])) return false;\n    return true;\n  }\n  const proto = Object.getPrototypeOf(a) as unknown;\n  if ((proto !== Object.prototype && proto !== null) || Object.getPrototypeOf(b) !== proto) {\n    return false;\n  }\n  const keys = Object.keys(a);\n  if (keys.length !== Object.keys(b).length) return false;\n  for (const k of keys) {\n    if (!Object.hasOwn(b, k)) return false;\n    if (!Object.is((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k])) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function updateRow(row: ChildPart, item: unknown, l: ListResult): void {\n  const picked = l.pick === undefined ? undefined : l.pick(item);\n  if (item === row.item && samePick(picked, row.picked)) return;\n  row.item = item;\n  row.picked = picked;\n  row.commit(l.row(item, picked));\n}\n\n/** A new row: open (positioned by `owner`), or appended to `parent` until placed. */\nexport function newRow(\n  owner: List | null,\n  parent: Node | null,\n  l: ListResult,\n  item: unknown,\n  key: unknown,\n  index: number,\n): ChildPart {\n  const row = new ChildPart(parent, null, owner, index, false, -1);\n  const picked = l.pick === undefined ? undefined : l.pick(item);\n  row.key = key;\n  row.item = item;\n  row.picked = picked;\n  row.commit(l.row(item, picked));\n  return row;\n}\n"]}

package/dist/view/render/seen.d.ts

@@ -0,0 +1,11 @@
+import type { PartSpec } from '../normalize/types.js';
+/** What is reported: a template object, or `raw()` markup as `{ html }`. */
+export interface Markup {
+    readonly html: string;
+    readonly parts?: readonly PartSpec[];
+}
+export type SeenMarkup = (markup: Markup) => void;
+/** Reports `markup` to the current render's listener, if any. */
+export declare function report(markup: Markup): void;
+/** Sets the listener for one render; returns the previous one, to restore afterwards. */
+export declare function listenFor(fn: SeenMarkup | undefined): SeenMarkup | undefined;

package/dist/view/render/seen.js

@@ -0,0 +1,17 @@
+let seen;
+let last;
+/** Reports `markup` to the current render's listener, if any. */
+export function report(markup) {
+    if (seen !== undefined && markup !== last) {
+        last = markup;
+        seen(markup);
+    }
+}
+/** Sets the listener for one render; returns the previous one, to restore afterwards. */
+export function listenFor(fn) {
+    const outer = seen;
+    seen = fn;
+    last = undefined;
+    return outer;
+}
+//# sourceMappingURL=seen.js.map

package/dist/view/render/seen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seen.js","sourceRoot":"","sources":["../../../src/view/render/seen.ts"],"names":[],"mappings":"AAcA,IAAI,IAA4B,CAAC;AACjC,IAAI,IAAwB,CAAC;AAE7B,iEAAiE;AACjE,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,GAAG,MAAM,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,EAA0B;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC;IACnB,IAAI,GAAG,EAAE,CAAC;IACV,IAAI,GAAG,SAAS,CAAC;IACjB,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["// The templates a render instantiates, reported to the caller of `render`/`hydrate` (view/02\n// \"Commit order\"). Core uses it to listen only for the intent events a component's markup names\n// (view/05-element.md \"Intent events\"). Reporting costs one comparison per instance when no\n// one listens, and one call per run of instances of the same template when someone does.\nimport type { PartSpec } from '../normalize/types.js';\n\n/** What is reported: a template object, or `raw()` markup as `{ html }`. */\nexport interface Markup {\n  readonly html: string;\n  readonly parts?: readonly PartSpec[];\n}\n\nexport type SeenMarkup = (markup: Markup) => void;\n\nlet seen: SeenMarkup | undefined;\nlet last: Markup | undefined;\n\n/** Reports `markup` to the current render's listener, if any. */\nexport function report(markup: Markup): void {\n  if (seen !== undefined && markup !== last) {\n    last = markup;\n    seen(markup);\n  }\n}\n\n/** Sets the listener for one render; returns the previous one, to restore afterwards. */\nexport function listenFor(fn: SeenMarkup | undefined): SeenMarkup | undefined {\n  const outer = seen;\n  seen = fn;\n  last = undefined;\n  return outer;\n}\n"]}

package/dist/view/render/values.d.ts

@@ -0,0 +1,29 @@
+import type { TemplateResult } from '../template.js';
+import type { ChildPart } from './child-part.js';
+/** Renders nothing in a child hole; removes the attribute in an attribute hole. */
+export declare const nothing: unique symbol;
+/** Internal: "never committed", so a part's first commit always writes. */
+export declare const UNSET: unique symbol;
+/** Internal: the key of `raw`'s result; its value is the function that commits the markup. */
+export declare const MARKUP: unique symbol;
+/** Internal: the key of `each`'s result; its value is the function that commits the list. */
+export declare const EACH: unique symbol;
+/** Trusted markup for a child hole: what `raw(html)` returns. */
+export interface RawResult {
+    readonly [MARKUP]: (part: ChildPart, html: string) => void;
+    readonly html: string;
+}
+/** A keyed list for a child hole: what `each(…)` returns. */
+export interface ListResult {
+    readonly [EACH]: (part: ChildPart, list: ListResult) => void;
+    readonly items: readonly unknown[];
+    readonly key: (item: unknown) => unknown;
+    readonly row: (item: unknown, picked: unknown) => unknown;
+    readonly pick: ((item: unknown) => unknown) | undefined;
+}
+/** Everything a child hole accepts (view/02-bindings.md "Child values"). */
+export type ChildValue = string | number | boolean | null | undefined | typeof nothing | TemplateResult | ListResult | RawResult | readonly ChildValue[];
+export declare const isRaw: (value: object) => value is RawResult;
+/** The markup of a `raw()` value, or undefined for anything else. */
+export declare const rawHtml: (value: object) => string | undefined;
+export declare const isList: (value: object) => value is ListResult;

package/dist/view/render/values.js

@@ -0,0 +1,13 @@
+/** Renders nothing in a child hole; removes the attribute in an attribute hole. */
+export const nothing = Symbol('gyral.nothing');
+/** Internal: "never committed", so a part's first commit always writes. */
+export const UNSET = Symbol('gyral.unset');
+/** Internal: the key of `raw`'s result; its value is the function that commits the markup. */
+export const MARKUP = Symbol('gyral.raw');
+/** Internal: the key of `each`'s result; its value is the function that commits the list. */
+export const EACH = Symbol('gyral.each');
+export const isRaw = (value) => MARKUP in value;
+/** The markup of a `raw()` value, or undefined for anything else. */
+export const rawHtml = (value) => isRaw(value) ? value.html : undefined;
+export const isList = (value) => EACH in value;
+//# sourceMappingURL=values.js.map

package/dist/view/render/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/view/render/values.ts"],"names":[],"mappings":"AAQA,mFAAmF;AACnF,MAAM,CAAC,MAAM,OAAO,GAAkB,MAAM,CAAC,eAAe,CAAC,CAAC;AAE9D,2EAA2E;AAC3E,MAAM,CAAC,MAAM,KAAK,GAAkB,MAAM,CAAC,aAAa,CAAC,CAAC;AAE1D,8FAA8F;AAC9F,MAAM,CAAC,MAAM,MAAM,GAAkB,MAAM,CAAC,WAAW,CAAC,CAAC;AACzD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,IAAI,GAAkB,MAAM,CAAC,YAAY,CAAC,CAAC;AA8BxD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAsB,EAAE,CAAC,MAAM,IAAI,KAAK,CAAC;AAE5E,qEAAqE;AACrE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAsB,EAAE,CAC3D,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAExC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAuB,EAAE,CAAC,IAAI,IAAI,KAAK,CAAC","sourcesContent":["// Child values besides text and templates (view/02-bindings.md \"Child values\", \"`raw(html)`\",\n// \"`nothing`\") and the result of `each` (view/03-lists.md \"The API\"). Each is recognised by a\n// symbol, so data parsed from JSON can never pass for one. `each` lives in list.ts and `raw` in\n// raw.ts: their results carry the code that commits them, so an app that never calls one\n// doesn't bundle that code.\nimport type { TemplateResult } from '../template.js';\nimport type { ChildPart } from './child-part.js';\n\n/** Renders nothing in a child hole; removes the attribute in an attribute hole. */\nexport const nothing: unique symbol = Symbol('gyral.nothing');\n\n/** Internal: \"never committed\", so a part's first commit always writes. */\nexport const UNSET: unique symbol = Symbol('gyral.unset');\n\n/** Internal: the key of `raw`'s result; its value is the function that commits the markup. */\nexport const MARKUP: unique symbol = Symbol('gyral.raw');\n/** Internal: the key of `each`'s result; its value is the function that commits the list. */\nexport const EACH: unique symbol = Symbol('gyral.each');\n\n/** Trusted markup for a child hole: what `raw(html)` returns. */\nexport interface RawResult {\n  readonly [MARKUP]: (part: ChildPart, html: string) => void;\n  readonly html: string;\n}\n\n/** A keyed list for a child hole: what `each(…)` returns. */\nexport interface ListResult {\n  readonly [EACH]: (part: ChildPart, list: ListResult) => void;\n  readonly items: readonly unknown[];\n  readonly key: (item: unknown) => unknown;\n  readonly row: (item: unknown, picked: unknown) => unknown;\n  readonly pick: ((item: unknown) => unknown) | undefined;\n}\n\n/** Everything a child hole accepts (view/02-bindings.md \"Child values\"). */\nexport type ChildValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | typeof nothing\n  | TemplateResult\n  | ListResult\n  | RawResult\n  | readonly ChildValue[];\n\nexport const isRaw = (value: object): value is RawResult => MARKUP in value;\n\n/** The markup of a `raw()` value, or undefined for anything else. */\nexport const rawHtml = (value: object): string | undefined =>\n  isRaw(value) ? value.html : undefined;\n\nexport const isList = (value: object): value is ListResult => EACH in value;\n"]}

package/dist/view/render/warn.d.ts

@@ -0,0 +1,14 @@
+/** A child hole got a value it can't render: an error in development. */
+export declare function badChild(value: unknown): never;
+/** `true` in a child hole, once per part: usually a `cond && x` slip. */
+export declare function warnTrue(part: object): void;
+/** An attribute or text-content hole got an object or function, once per part. */
+export declare function warnValue(part: object, value: unknown, where: string): void;
+/** `raw()` parsed in the browser, once per page. */
+export declare function warnRaw(): void;
+/** Keys must be unique strings or numbers: an error in development. */
+export declare function badKey(key: unknown, index: number, duplicate: boolean): never;
+/** A skipped row would render differently: it reads something besides `item` and `pick`. */
+export declare function warnImpureRow(row: (...args: never[]) => unknown): void;
+/** A hook hole got something other than a hook result. */
+export declare function badHook(value: unknown): never;

package/dist/view/render/warn.js

@@ -0,0 +1,69 @@
+// Development-only errors and warnings of the renderer (view/02-bindings.md "Child values",
+// view/03-lists.md "Keys", view/09-template-rules.md "Warnings"). Every call site is guarded by
+// `if (DEV)`, so production bundles drop this module. Messages say what to write instead.
+const SPEC = 'docs/design-docs/view';
+const warned = new WeakSet();
+const describe = (value) => typeof value === 'function'
+    ? 'a function'
+    : Array.isArray(value)
+        ? 'an array'
+        : typeof value === 'object'
+            ? `an object (${Object.prototype.toString.call(value).slice(8, -1)})`
+            : `a ${typeof value}`;
+/** A child hole got a value it can't render: an error in development. */
+export function badChild(value) {
+    throw new TypeError(`gyral: a child hole got ${describe(value)}, which it can't render. Child holes take ` +
+        `text, numbers, html\`…\` results, each(…), arrays, raw(…), or null/undefined/false/` +
+        `nothing for nothing. Format the value as text, or render it with a template ` +
+        `(${SPEC}/02-bindings.md "Child values").`);
+}
+/** `true` in a child hole, once per part: usually a `cond && x` slip. */
+export function warnTrue(part) {
+    if (warned.has(part))
+        return;
+    warned.add(part);
+    console.warn('gyral: `true` in a child hole renders nothing. It is usually a `cond && x` slip where ' +
+        'cond is a boolean and x is missing; write `cond ? x : nothing` ' +
+        `(${SPEC}/02-bindings.md "Child values").`);
+}
+/** An attribute or text-content hole got an object or function, once per part. */
+export function warnValue(part, value, where) {
+    if (warned.has(part))
+        return;
+    warned.add(part);
+    console.warn(`gyral: ${where} got ${describe(value)}; it is written as String(value). Pass a string, ` +
+        `number or boolean, or null/undefined/nothing to leave it out ` +
+        `(${SPEC}/02-bindings.md "Attribute values").`);
+}
+let rawWarned = false;
+/** `raw()` parsed in the browser, once per page. */
+export function warnRaw() {
+    if (rawWarned)
+        return;
+    rawWarned = true;
+    console.warn('gyral: raw() rendered in the browser. It works, but every change re-parses the markup; ' +
+        'prefer templates for content that changes, and keep raw() for server-rendered markup ' +
+        `(${SPEC}/09-template-rules.md "Warnings").`);
+}
+/** Keys must be unique strings or numbers: an error in development. */
+export function badKey(key, index, duplicate) {
+    const problem = duplicate
+        ? `the key ${JSON.stringify(key)} appears twice (again at index ${String(index)})`
+        : `the key at index ${String(index)} is ${describe(key)}`;
+    throw new Error(`gyral: each(): ${problem}. Keys must be unique strings or numbers within a list, such ` +
+        `as a stable id: each(items, (x) => x.id, Row) (${SPEC}/03-lists.md "Keys").`);
+}
+/** A skipped row would render differently: it reads something besides `item` and `pick`. */
+export function warnImpureRow(row) {
+    const name = row.name === '' ? 'a row function' : `the row function ${row.name}`;
+    console.warn(`gyral: each(): ${name} depends on something not passed through \`item\` or \`pick\`, so ` +
+        'skipped rows would show stale content. Return what it reads from `pick` and take it as ' +
+        `the second argument (${SPEC}/03-lists.md "Rows must be pure").`);
+}
+/** A hook hole got something other than a hook result. */
+export function badHook(value) {
+    throw new TypeError(`gyral: an element hook position (\${…} inside a start tag) got ${describe(value)}. Only ` +
+        `hooks made with defineHook() go there, e.g. <input \${invalid(errors)}> ` +
+        `(${SPEC}/02-bindings.md "Element hooks").`);
+}
+//# sourceMappingURL=warn.js.map

package/dist/view/render/warn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn.js","sourceRoot":"","sources":["../../../src/view/render/warn.ts"],"names":[],"mappings":"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","sourcesContent":["// Development-only errors and warnings of the renderer (view/02-bindings.md \"Child values\",\n// view/03-lists.md \"Keys\", view/09-template-rules.md \"Warnings\"). Every call site is guarded by\n// `if (DEV)`, so production bundles drop this module. Messages say what to write instead.\n\nconst SPEC = 'docs/design-docs/view';\nconst warned = new WeakSet<object>();\n\nconst describe = (value: unknown): string =>\n  typeof value === 'function'\n    ? 'a function'\n    : Array.isArray(value)\n      ? 'an array'\n      : typeof value === 'object'\n        ? `an object (${Object.prototype.toString.call(value).slice(8, -1)})`\n        : `a ${typeof value}`;\n\n/** A child hole got a value it can't render: an error in development. */\nexport function badChild(value: unknown): never {\n  throw new TypeError(\n    `gyral: a child hole got ${describe(value)}, which it can't render. Child holes take ` +\n      `text, numbers, html\\`…\\` results, each(…), arrays, raw(…), or null/undefined/false/` +\n      `nothing for nothing. Format the value as text, or render it with a template ` +\n      `(${SPEC}/02-bindings.md \"Child values\").`,\n  );\n}\n\n/** `true` in a child hole, once per part: usually a `cond && x` slip. */\nexport function warnTrue(part: object): void {\n  if (warned.has(part)) return;\n  warned.add(part);\n  console.warn(\n    'gyral: `true` in a child hole renders nothing. It is usually a `cond && x` slip where ' +\n      'cond is a boolean and x is missing; write `cond ? x : nothing` ' +\n      `(${SPEC}/02-bindings.md \"Child values\").`,\n  );\n}\n\n/** An attribute or text-content hole got an object or function, once per part. */\nexport function warnValue(part: object, value: unknown, where: string): void {\n  if (warned.has(part)) return;\n  warned.add(part);\n  console.warn(\n    `gyral: ${where} got ${describe(value)}; it is written as String(value). Pass a string, ` +\n      `number or boolean, or null/undefined/nothing to leave it out ` +\n      `(${SPEC}/02-bindings.md \"Attribute values\").`,\n  );\n}\n\nlet rawWarned = false;\n\n/** `raw()` parsed in the browser, once per page. */\nexport function warnRaw(): void {\n  if (rawWarned) return;\n  rawWarned = true;\n  console.warn(\n    'gyral: raw() rendered in the browser. It works, but every change re-parses the markup; ' +\n      'prefer templates for content that changes, and keep raw() for server-rendered markup ' +\n      `(${SPEC}/09-template-rules.md \"Warnings\").`,\n  );\n}\n\n/** Keys must be unique strings or numbers: an error in development. */\nexport function badKey(key: unknown, index: number, duplicate: boolean): never {\n  const problem = duplicate\n    ? `the key ${JSON.stringify(key)} appears twice (again at index ${String(index)})`\n    : `the key at index ${String(index)} is ${describe(key)}`;\n  throw new Error(\n    `gyral: each(): ${problem}. Keys must be unique strings or numbers within a list, such ` +\n      `as a stable id: each(items, (x) => x.id, Row) (${SPEC}/03-lists.md \"Keys\").`,\n  );\n}\n\n/** A skipped row would render differently: it reads something besides `item` and `pick`. */\nexport function warnImpureRow(row: (...args: never[]) => unknown): void {\n  const name = row.name === '' ? 'a row function' : `the row function ${row.name}`;\n  console.warn(\n    `gyral: each(): ${name} depends on something not passed through \\`item\\` or \\`pick\\`, so ` +\n      'skipped rows would show stale content. Return what it reads from `pick` and take it as ' +\n      `the second argument (${SPEC}/03-lists.md \"Rows must be pure\").`,\n  );\n}\n\n/** A hook hole got something other than a hook result. */\nexport function badHook(value: unknown): never {\n  throw new TypeError(\n    `gyral: an element hook position (\\${…} inside a start tag) got ${describe(value)}. Only ` +\n      `hooks made with defineHook() go there, e.g. <input \\${invalid(errors)}> ` +\n      `(${SPEC}/02-bindings.md \"Element hooks\").`,\n  );\n}\n"]}

package/dist/view/server/component.d.ts

@@ -0,0 +1,9 @@
+import type { ServerComponent } from '../registry.js';
+import { type Deferred, type Item } from './writer.js';
+/**
+ * The text of a shadow component's `<style>` (its CSS texts joined by newlines, `</style`
+ * escaped), exactly as written, so `styleHashes()` hashes what the browser sees. `''`: none.
+ */
+export declare function styleText(component: ServerComponent): string;
+/** Writes a deferred component; nested components are deferred again. */
+export declare function expand({ component, input }: Deferred, dev: boolean): Item[];