@gyral/core 0.2.0 → 0.3.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/view/render/plan.ts"],"names":[],"mappings":"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","sourcesContent":["// Instantiation plans (view/01-templates.md \"Instantiation\"): computed once per template object,\n// they say how to reach every part's nodes in a clone by child-index paths, following\n// firstChild/nextSibling and sharing prefixes (no TreeWalker, no marker search), and what each\n// part is. Part kinds that depend on the element (live form state) are decided here, from the\n// template's own parsed content, so creating an instance only walks and allocates.\nimport {\n  ATTR_PART,\n  BOOL_PART,\n  CHILD_BEFORE,\n  CHILD_SOLE,\n  MULTI_PART,\n  PROP_PART,\n  HOOK_PART,\n  TEXT_PART,\n  type PartSpec,\n  type TemplateObject,\n} from '../normalize/types.js';\nimport { templateElement } from '../template-element.js';\nimport { attrKind, HOOK, MULTI, PROP, TEXTAREA, TITLE } from './attr-parts.js';\n\n/** Plan kinds of child parts (element parts use their attr-parts.ts kind, ≥ 0). */\nexport const CHILD = -1;\nexport const SOLE = -2;\nexport const ROOT = -3;\n\nexport interface Plan {\n  readonly content: DocumentFragment;\n  /** One root node and no root-level holes: clone that node instead of the fragment. */\n  readonly single: boolean;\n  /** Per target node, in document order: keep depth, sibling skip (-1: none), n, n indexes. */\n  readonly ops: readonly number[];\n  readonly targets: number;\n  /** Per part: its element's (or child part's parent's) target, its reference node's target. */\n  readonly a: readonly number[];\n  readonly b: readonly number[];\n  /** Per part: the index of its (first) value, and its kind. */\n  readonly at: readonly number[];\n  readonly kinds: readonly number[];\n}\n\n/** Scratch space for walks (never re-entrant: nested instances are created after the walk). */\nexport const stack: Node[] = [];\nexport const nodes: Node[] = [];\n\n/** Fills `nodes` with each target of `plan`, walking from `stack[0]` (or `stack[1]`). */\nexport function walk(plan: Plan): void {\n  const ops = plan.ops;\n  let k = 0;\n  for (let t = 0; t < plan.targets; t++) {\n    const keep = ops[k] as number;\n    const skip = ops[k + 1] as number;\n    const n = ops[k + 2] as number;\n    k += 3;\n    let depth = keep;\n    let node = stack[keep] as Node;\n    if (skip >= 0) {\n      node = stack[++depth] as Node;\n      for (let s = 0; s < skip; s++) node = node.nextSibling as Node;\n      stack[depth] = node;\n    }\n    for (let j = 0; j < n; j++) {\n      node = node.firstChild as Node;\n      for (let s = ops[k++] as number; s > 0; s--) node = node.nextSibling as Node;\n      stack[++depth] = node;\n    }\n    nodes[t] = node;\n  }\n}\n\nfunction build(template: TemplateObject): Plan {\n  const content = templateElement(template).content;\n  const single = content.childNodes.length === 1 && template.parts.every((p) => p[1].length > 0);\n  const ids = new Map<string, number>();\n  const ops: number[] = [];\n  let cursor: readonly number[] = single ? [0] : [];\n  const target = (path: readonly number[]): number => {\n    const id = path.join();\n    const known = ids.get(id);\n    if (known !== undefined) return known;\n    let keep = 0;\n    while (keep < path.length && path[keep] === cursor[keep]) keep++;\n    if (keep === path.length) {\n      ops.push(keep, -1, 0); // an ancestor of the cursor (or the cursor itself)\n    } else {\n      const from = (cursor[keep] ?? Infinity) < (path[keep] as number) ? keep + 1 : keep;\n      const skip = from > keep ? (path[keep] as number) - (cursor[keep] as number) : -1;\n      ops.push(keep, skip, path.length - from, ...path.slice(from));\n      cursor = path;\n    }\n    ids.set(id, ids.size);\n    return ids.size - 1;\n  };\n  const a: number[] = [];\n  const b: number[] = [];\n  const at: number[] = [];\n  let value = 0;\n  for (const spec of template.parts) {\n    a.push(target(spec[1]));\n    b.push(spec[0] === CHILD_BEFORE ? target([...spec[1], spec[2]]) : -1);\n    at.push(value);\n    value += spec[0] === MULTI_PART ? spec[3].length - 1 : 1;\n  }\n  const kinds: number[] = [];\n  const plan: Plan = { content, single, ops, targets: ids.size, a, b, at, kinds };\n  // Walk the template's own content once to decide the element-dependent kinds.\n  stack[0] = content;\n  if (single) stack[1] = content.firstChild as Node;\n  walk(plan);\n  template.parts.forEach((spec, i) => {\n    kinds.push(kindOf(spec, nodes[a[i] as number] as Element));\n  });\n  return plan;\n}\n\nfunction kindOf(spec: PartSpec, el: Element): number {\n  switch (spec[0]) {\n    case ATTR_PART:\n      return attrKind(el, spec[2], false);\n    case MULTI_PART:\n      return MULTI;\n    case BOOL_PART:\n      return attrKind(el, spec[2], true);\n    case PROP_PART:\n      return PROP;\n    case HOOK_PART:\n      return HOOK;\n    case TEXT_PART:\n      return el.localName === 'textarea' ? TEXTAREA : TITLE;\n    default:\n      return spec[1].length === 0 ? ROOT : spec[0] === CHILD_SOLE ? SOLE : CHILD;\n  }\n}\n\nconst plans = new WeakMap<TemplateObject, Plan>();\nlet lastTemplate: TemplateObject | undefined;\nlet lastPlan: Plan | undefined;\n\n/** The plan of `template` (one-entry cache in front of the WeakMap: rows repeat a template). */\nexport function planOf(template: TemplateObject): Plan {\n  if (template === lastTemplate) return lastPlan as Plan;\n  let plan = plans.get(template);\n  if (plan === undefined) {\n    plan = build(template);\n    plans.set(template, plan);\n  }\n  lastTemplate = template;\n  lastPlan = plan;\n  return plan;\n}\n"]}

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

@@ -0,0 +1,21 @@
+import { type RawResult } from './values.js';
+/** Parsed `raw()` markup: the start anchor, the last node, and the string. */
+export declare class RawRange {
+    readonly start: Comment;
+    end: Node;
+    html: string;
+    constructor(start: Comment, end: Node, html: string);
+    first(): Node;
+    last(): Node;
+    remove(): void;
+}
+/**
+ * `html` parsed by a <template> through the `gyral` Trusted Types policy (its content is reused:
+ * read it before the next call).
+ */
+export declare function parse(html: string): DocumentFragment;
+/**
+ * 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 declare function raw(html: string): RawResult;

package/dist/view/render/raw.js

@@ -0,0 +1,72 @@
+// `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 { trustedHTML } from '../trusted-html.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> through the `gyral` Trusted Types policy (its content is reused:
+ * read it before the next call).
+ */
+export function parse(html) {
+    parser ??= document.createElement('template');
+    parser.innerHTML = trustedHTML(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 { trustedHTML } from '../trusted-html.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/**\n * `html` parsed by a <template> through the `gyral` Trusted Types policy (its content is reused:\n * read it before the next call).\n */\nexport function parse(html: string): DocumentFragment {\n  parser ??= document.createElement('template');\n  parser.innerHTML = trustedHTML(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,15 @@
+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, and
+ * element hooks deferred to `flushHooks` (after each pass) and the end of the flush.
+ */
+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,65 @@
+// `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 outside a flush 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 and hooks run once every host has rendered,
+// children first (hooks.ts); a call outside a batch gets a budget and a hook run 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, endHooks, hookMark, runHooks, startHooks } 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, and
+ * element hooks deferred to `flushHooks` (after each pass) and the end of the flush.
+ */
+export function renderBatch(fn) {
+    if (DEV)
+        resetRowChecks(); // the budget is a development check
+    const outer = batching;
+    startHooks(); // element hooks wait for the flush (hook-run.ts)
+    let ok = false;
+    batching = true;
+    try {
+        fn();
+        ok = true;
+    }
+    finally {
+        batching = outer;
+        endHooks(ok);
+    }
+}
+/**
+ * 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(root);
+    if (DEV && !batching)
+        resetRowChecks();
+    const outer = listenFor(seen);
+    try {
+        part.commit(value);
+    }
+    catch (error) {
+        dropHooks(mark);
+        throw error;
+    }
+    finally {
+        listenFor(outer);
+    }
+    runHooks(mark, root);
+}
+/** 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,+FAA+F;AAC/F,gGAAgG;AAChG,+FAA+F;AAC/F,6FAA6F;AAC7F,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,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,SAAS,EAAmB,MAAM,WAAW,CAAC;AAGvD,MAAM,KAAK,GAAG,IAAI,OAAO,EAAmB,CAAC;AAC7C,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAc;IACxC,IAAI,GAAG;QAAE,cAAc,EAAE,CAAC,CAAC,oCAAoC;IAC/D,MAAM,KAAK,GAAG,QAAQ,CAAC;IACvB,UAAU,EAAE,CAAC,CAAC,iDAAiD;IAC/D,IAAI,EAAE,GAAG,KAAK,CAAC;IACf,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,CAAC;QACH,EAAE,EAAE,CAAC;QACL,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,QAAQ,GAAG,KAAK,CAAC;QACjB,QAAQ,CAAC,EAAE,CAAC,CAAC;IACf,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,CAAC,IAAI,CAAC,CAAC;IAC5B,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,EAAE,IAAI,CAAC,CAAC;AACvB,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 outside a flush every element hook's `client` call has\n// run. The scheduler (view/04-scheduler.md) calls it once per dirty host, inside `renderBatch`,\n// so the list dev check's budget (03) is per flush and hooks run once every host has rendered,\n// children first (hooks.ts); a call outside a batch gets a budget and a hook run 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, endHooks, hookMark, runHooks, startHooks } 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/**\n * Runs `fn` (one scheduler flush) with one shared row-check budget for every render in it, and\n * element hooks deferred to `flushHooks` (after each pass) and the end of the flush.\n */\nexport function renderBatch(fn: () => void): void {\n  if (DEV) resetRowChecks(); // the budget is a development check\n  const outer = batching;\n  startHooks(); // element hooks wait for the flush (hook-run.ts)\n  let ok = false;\n  batching = true;\n  try {\n    fn();\n    ok = true;\n  } finally {\n    batching = outer;\n    endHooks(ok);\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(root);\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, root);\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":"AAQA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAa,MAAM,WAAW,CAAC;AAWpE,SAAS,KAAK,CACZ,GAAyB,EACzB,IAAwB,EACxB,CAAS,EACT,EAAU,EACV,EAAU;IAEV,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,MAAM,CAAC,GAAU,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACzC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAI,GAAG,CAAC,EAAE,CAAe,CAAC,GAAG,CAAC;QACxC,MAAM,IAAI,GAAI,GAAG,CAAC,EAAE,CAAe,CAAC,GAAG,CAAC;QACxC,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACjB,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACjB,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;QACvB,CAAC;aAAM,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;aAClD,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;;YAChD,MAAM;IACb,CAAC;IACD,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;QAAE,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC;IACnB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,GAAG,CAAE,GAAG,CAAC,CAAC,CAAe,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACvE,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS,CAAC,mDAAmD;QAClF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACf,CAAC,CAAC,KAAK,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,IAAe,EACf,IAAU,EACV,CAAa,EACb,IAAiB,EACjB,CAAS,EACT,EAAU,EACV,EAAU;IAEV,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;IACtB,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAClB,gFAAgF;QAChF,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;YACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;gBAAG,GAAG,CAAC,CAAC,CAAe,CAAC,KAAK,EAAE,CAAC;QACjE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,IAAI,IAAI,GAA4B,IAAI,CAAC;IACzC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAW,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,IAAI,KAAK,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3D,SAAS;QACX,CAAC;QACD,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,GAAG,IAAI;YAAE,KAAK,GAAG,IAAI,CAAC;;YACtB,IAAI,GAAG,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAc,CAAC;QAChC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;QAAE,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAAG,GAAG,CAAC,CAAC,CAAe,CAAC,KAAK,EAAE,CAAC;IACrF,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAY,IAAI,CAAC;YAAE,SAAS;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAc,CAAC;QACjC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;QACtB,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;AACH,CAAC","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/toggles.d.ts

@@ -0,0 +1,6 @@
+import type { HookPart } from './hooks.js';
+/** Queues a native action after this part's DOM is committed and inserted. */
+export type Toggle = (part: HookPart, name: string, on: boolean) => void;
+export declare let toggle: Toggle | undefined;
+/** Internal: turns the bindings on (modal.ts's `applyToggle`). */
+export declare function useToggles(run: Toggle): void;

package/dist/view/render/toggles.js

@@ -0,0 +1,6 @@
+export let toggle;
+/** Internal: turns the bindings on (modal.ts's `applyToggle`). */
+export function useToggles(run) {
+    toggle = run;
+}
+//# sourceMappingURL=toggles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toggles.js","sourceRoot":"","sources":["../../../src/view/render/toggles.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,IAAI,MAA0B,CAAC;AAEtC,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,GAAG,GAAG,CAAC;AACf,CAAC","sourcesContent":["// Dialogs and popovers from state (view/02-bindings.md \"Dialogs and popovers\", gyral-1zd.27):\n// `?modal=${open}` on a `<dialog>` and `?popover-open=${open}` on a `[popover]` element open and\n// close them with the platform's methods. The code that does it (modal.ts) registers here, so\n// only builds that use the bindings bundle it: core's `#spec-features` registers it at load\n// without a build step, and compiled builds register it when a module writes either binding.\nimport type { HookPart } from './hooks.js';\n\n/** Queues a native action after this part's DOM is committed and inserted. */\nexport type Toggle = (part: HookPart, name: string, on: boolean) => void;\n\nexport let toggle: Toggle | undefined;\n\n/** Internal: turns the bindings on (modal.ts's `applyToggle`). */\nexport function useToggles(run: Toggle): void {\n  toggle = run;\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,28 @@
+/** 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;
+/**
+ * A property binding got a function, once per part (02 "Properties"): views attach no
+ * closures. Built-in elements and Gyral components warn; other custom elements may take a
+ * callback (a third-party widget's API), so they don't.
+ */
+export declare function warnFunctionProp(part: object, el: Element, name: 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. */
+/** `?modal`/`?popover-open` with the bindings' code left out of the build (toggles.ts). */
+export declare function warnToggle(el: Element, name: string): void;
+export declare function badHook(value: unknown): never;
+/**
+ * An svg template renders only in SVG content: an SVG element other than <foreignObject>,
+ * <desc> or <title>, whose content is HTML (01 "svg templates"). A detached fragment (an
+ * instance being built) isn't checked: its place is known only when it is inserted.
+ */
+export declare function checkSvgParent(parent: Node): void;