@gyral/core 0.1.0 → 0.3.0

package/dist/view/render/dev-check.js

@@ -0,0 +1,122 @@
+// Development checks for lists (view/03-lists.md "Keys", "Rows must be pure"). Keys must be
+// unique strings or numbers. Skipped rows are re-evaluated and compared with what is committed
+// (template, by id or identity, and values, recursively); a difference warns once per row
+// function. At most 200 rows are checked per flush (per render call outside one), rotating
+// through each list. Only reached under `if (DEV)`.
+import { DEV } from '#view-dev';
+import { isTemplateResult, templateOf } from '../template.js';
+import { BOOL, CHECKED, HOOK, MULTI, OPEN, STATE, TEXTAREA, textOf, TITLE, truthy, } from './attr-parts.js';
+import { ChildPart, EMPTY, INSTANCE, ITEMS, LIST, RAW, TEXT } from './child-part.js';
+import { hookSpec, sameArgs } from './hooks.js';
+import { samePick } from './rows.js';
+import { isList, rawHtml } from './values.js';
+import { badKey, warnImpureRow } from './warn.js';
+/** Rows re-evaluated per flush (render.ts `renderBatch`), or per render call outside one. */
+export const ROW_CHECKS = 200;
+let budget = ROW_CHECKS;
+const warned = new WeakSet();
+/** Called at the start of each flush, or of a `render` call outside one. */
+export function resetRowChecks() {
+    budget = ROW_CHECKS;
+}
+/** Keys are unique strings or numbers. Guarded here too: the lazy hydration chunk calls it. */
+export function checkKeys(items, key) {
+    if (!DEV)
+        return;
+    const seen = new Set();
+    for (let i = 0; i < items.length; i++) {
+        const k = key(items[i]);
+        if (typeof k !== 'string' && typeof k !== 'number')
+            badKey(k, i, false);
+        if (seen.has(k))
+            badKey(k, i, true);
+        seen.add(k);
+    }
+}
+export function recheckRows(list, l) {
+    const rows = list.rows;
+    const n = rows.length;
+    if (n === 0 || budget <= 0 || warned.has(l.row))
+        return;
+    const count = Math.min(budget, n);
+    budget -= count;
+    let at = list.cursor % n;
+    for (let k = 0; k < count; k++) {
+        const row = rows[at];
+        if (!sameChild(row, l.row(row.item, row.picked))) {
+            warned.add(l.row);
+            warnImpureRow(l.row);
+            break;
+        }
+        at = (at + 1) % n;
+    }
+    list.cursor = at;
+}
+/** Whether rendering `value` into `part` would change nothing. */
+export function sameChild(part, value) {
+    if (typeof value === 'string' || typeof value === 'number') {
+        return part.kind === TEXT && Object.is(part.value, value);
+    }
+    if (typeof value === 'object' && value !== null) {
+        if (isTemplateResult(value)) {
+            if (part.kind !== INSTANCE)
+                return false;
+            const committed = part.content;
+            const template = templateOf(value);
+            return ((committed.template === template ||
+                (template.id !== undefined && template.id === committed.template.id)) &&
+                committed.parts.every((p) => samePart(p, value.values)));
+        }
+        if (isList(value))
+            return part.kind === LIST && sameList(part.content, value);
+        if (Array.isArray(value)) {
+            if (part.kind !== ITEMS)
+                return false;
+            const rows = part.content.rows;
+            return rows.length === value.length && rows.every((r, i) => sameChild(r, value[i]));
+        }
+        const html = rawHtml(value);
+        if (html !== undefined)
+            return part.kind === RAW && part.content.html === html;
+    }
+    return part.kind === EMPTY;
+}
+function samePart(p, values) {
+    if (p instanceof ChildPart)
+        return sameChild(p, values[p.at]);
+    const part = p;
+    const v = values[part.at];
+    switch (part.kind) {
+        case MULTI:
+            return (part.pieces ?? []).every((piece, i) => Object.is(piece, values[part.at + i]));
+        case BOOL:
+        case CHECKED:
+        case STATE:
+        case OPEN:
+            return part.value === truthy(v);
+        case TITLE:
+        case TEXTAREA:
+            return part.value === textOf(part, v);
+        case HOOK: {
+            const spec = hookSpec(v);
+            if (spec === undefined)
+                return part.spec === null;
+            return spec === part.spec && sameArgs(v.args, part.args);
+        }
+        default:
+            // ATTR, PROP and VALUE keep the raw committed value.
+            return Object.is(part.value, v);
+    }
+}
+function sameList(list, l) {
+    const rows = list.rows;
+    if (rows.length !== l.items.length)
+        return false;
+    return rows.every((row, i) => {
+        const item = l.items[i];
+        return (row.item === item &&
+            Object.is(row.key, l.key(item)) &&
+            samePick(row.picked, l.pick === undefined ? undefined : l.pick(item)));
+    });
+}
+//# sourceMappingURL=dev-check.js.map

package/dist/view/render/dev-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-check.js","sourceRoot":"","sources":["../../../src/view/render/dev-check.ts"],"names":[],"mappings":"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","sourcesContent":["// Development checks for lists (view/03-lists.md \"Keys\", \"Rows must be pure\"). Keys must be\n// unique strings or numbers. Skipped rows are re-evaluated and compared with what is committed\n// (template, by id or identity, and values, recursively); a difference warns once per row\n// function. At most 200 rows are checked per flush (per render call outside one), rotating\n// through each list. Only reached under `if (DEV)`.\nimport { DEV } from '#view-dev';\nimport { isTemplateResult, templateOf } from '../template.js';\nimport {\n  BOOL,\n  CHECKED,\n  HOOK,\n  MULTI,\n  OPEN,\n  STATE,\n  TEXTAREA,\n  textOf,\n  TITLE,\n  truthy,\n  type AttrPart,\n  type Part,\n} from './attr-parts.js';\nimport { ChildPart, EMPTY, INSTANCE, ITEMS, LIST, RAW, TEXT } from './child-part.js';\nimport type { RawRange } from './raw.js';\nimport { hookSpec, sameArgs, type HookResult } from './hooks.js';\nimport type { Instance } from './instance.js';\nimport { samePick, type List } from './rows.js';\nimport { isList, rawHtml, type ListResult } from './values.js';\nimport { badKey, warnImpureRow } from './warn.js';\n\n/** Rows re-evaluated per flush (render.ts `renderBatch`), or per render call outside one. */\nexport const ROW_CHECKS = 200;\nlet budget = ROW_CHECKS;\nconst warned = new WeakSet<object>();\n\n/** Called at the start of each flush, or of a `render` call outside one. */\nexport function resetRowChecks(): void {\n  budget = ROW_CHECKS;\n}\n\n/** Keys are unique strings or numbers. Guarded here too: the lazy hydration chunk calls it. */\nexport function checkKeys(items: readonly unknown[], key: (item: unknown) => unknown): void {\n  if (!DEV) return;\n  const seen = new Set<unknown>();\n  for (let i = 0; i < items.length; i++) {\n    const k = key(items[i]);\n    if (typeof k !== 'string' && typeof k !== 'number') badKey(k, i, false);\n    if (seen.has(k)) badKey(k, i, true);\n    seen.add(k);\n  }\n}\n\nexport function recheckRows(list: List, l: ListResult): void {\n  const rows = list.rows;\n  const n = rows.length;\n  if (n === 0 || budget <= 0 || warned.has(l.row)) return;\n  const count = Math.min(budget, n);\n  budget -= count;\n  let at = list.cursor % n;\n  for (let k = 0; k < count; k++) {\n    const row = rows[at] as ChildPart;\n    if (!sameChild(row, l.row(row.item, row.picked))) {\n      warned.add(l.row);\n      warnImpureRow(l.row);\n      break;\n    }\n    at = (at + 1) % n;\n  }\n  list.cursor = at;\n}\n\n/** Whether rendering `value` into `part` would change nothing. */\nexport function sameChild(part: ChildPart, value: unknown): boolean {\n  if (typeof value === 'string' || typeof value === 'number') {\n    return part.kind === TEXT && Object.is(part.value, value);\n  }\n  if (typeof value === 'object' && value !== null) {\n    if (isTemplateResult(value)) {\n      if (part.kind !== INSTANCE) return false;\n      const committed = part.content as Instance;\n      const template = templateOf(value);\n      return (\n        (committed.template === template ||\n          (template.id !== undefined && template.id === committed.template.id)) &&\n        committed.parts.every((p) => samePart(p, value.values))\n      );\n    }\n    if (isList(value)) return part.kind === LIST && sameList(part.content as List, value);\n    if (Array.isArray(value)) {\n      if (part.kind !== ITEMS) return false;\n      const rows = (part.content as List).rows;\n      return rows.length === value.length && rows.every((r, i) => sameChild(r, value[i]));\n    }\n    const html = rawHtml(value);\n    if (html !== undefined) return part.kind === RAW && (part.content as RawRange).html === html;\n  }\n  return part.kind === EMPTY;\n}\n\nfunction samePart(p: Part, values: readonly unknown[]): boolean {\n  if (p instanceof ChildPart) return sameChild(p, values[p.at]);\n  const part = p as AttrPart;\n  const v = values[part.at];\n  switch (part.kind) {\n    case MULTI:\n      return (part.pieces ?? []).every((piece, i) => Object.is(piece, values[part.at + i]));\n    case BOOL:\n    case CHECKED:\n    case STATE:\n    case OPEN:\n      return part.value === truthy(v);\n    case TITLE:\n    case TEXTAREA:\n      return part.value === textOf(part, v);\n    case HOOK: {\n      const spec = hookSpec(v);\n      if (spec === undefined) return part.spec === null;\n      return spec === part.spec && sameArgs((v as HookResult).args, part.args);\n    }\n    default:\n      // ATTR, PROP and VALUE keep the raw committed value.\n      return Object.is(part.value, v);\n  }\n}\n\nfunction sameList(list: List, l: ListResult): boolean {\n  const rows = list.rows;\n  if (rows.length !== l.items.length) return false;\n  return rows.every((row, i) => {\n    const item = l.items[i];\n    return (\n      row.item === item &&\n      Object.is(row.key, l.key(item)) &&\n      samePick(row.picked, l.pick === undefined ? undefined : l.pick(item))\n    );\n  });\n}\n"]}

package/dist/view/render/hook-part.d.ts

@@ -0,0 +1,3 @@
+import { type HookResult, type HookSpec } from './hooks.js';
+/** Defines an element hook: a small behaviour attached to the element it sits on. */
+export declare function defineHook<A extends readonly unknown[]>(spec: HookSpec<A>): (...args: A) => HookResult<A>;

package/dist/view/render/hook-part.js

@@ -0,0 +1,20 @@
+// `defineHook` (view/02-bindings.md "Element hooks"): its results carry `commitHook`, so the
+// code that compares arguments and queues client calls is bundled only by apps with hooks.
+import { hookResult, hookSpec, queueHook, sameArgs, } from './hooks.js';
+/** Queues the client call when the hook or its arguments changed. */
+function commitHook(part, result) {
+    const spec = hookSpec(result);
+    const args = result.args;
+    const same = spec === part.spec;
+    if (same && sameArgs(args, part.args))
+        return;
+    part.prev = same ? part.args : undefined;
+    part.spec = spec;
+    part.args = args;
+    queueHook(part);
+}
+/** Defines an element hook: a small behaviour attached to the element it sits on. */
+export function defineHook(spec) {
+    return (...args) => hookResult(spec, args, commitHook);
+}
+//# sourceMappingURL=hook-part.js.map

package/dist/view/render/hook-part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-part.js","sourceRoot":"","sources":["../../../src/view/render/hook-part.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,2FAA2F;AAC3F,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,GAIT,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,SAAS,UAAU,CAAC,IAAc,EAAE,MAAkB;IACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAiC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC;IAChC,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACjB,SAAS,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,UAAU,CACxB,IAAiB;IAEjB,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC","sourcesContent":["// `defineHook` (view/02-bindings.md \"Element hooks\"): its results carry `commitHook`, so the\n// code that compares arguments and queues client calls is bundled only by apps with hooks.\nimport {\n  hookResult,\n  hookSpec,\n  queueHook,\n  sameArgs,\n  type HookPart,\n  type HookResult,\n  type HookSpec,\n} from './hooks.js';\n\n/** Queues the client call when the hook or its arguments changed. */\nfunction commitHook(part: HookPart, result: HookResult): void {\n  const spec = hookSpec(result) as HookSpec<readonly unknown[]>;\n  const args = result.args;\n  const same = spec === part.spec;\n  if (same && sameArgs(args, part.args)) return;\n  part.prev = same ? part.args : undefined;\n  part.spec = spec;\n  part.args = args;\n  queueHook(part);\n}\n\n/** Defines an element hook: a small behaviour attached to the element it sits on. */\nexport function defineHook<A extends readonly unknown[]>(\n  spec: HookSpec<A>,\n): (...args: A) => HookResult<A> {\n  return (...args) => hookResult(spec, args, commitHook);\n}\n"]}

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

@@ -0,0 +1,40 @@
+declare const HOOK: unique symbol;
+/** Internal: a hook result's commit function (hook-part.ts), so apps without hooks skip it. */
+export declare const COMMIT_HOOK: unique symbol;
+/** Attributes a hook's server half adds to the start tag (`true`: present, no value). */
+export type HookAttributes = Readonly<Record<string, string | true>>;
+export interface HookSpec<A extends readonly unknown[]> {
+    /** Attributes for the server-rendered start tag (view/06-server.md). */
+    server?(args: A): HookAttributes;
+    /** Runs after the commit when `args` changed; `prev` is undefined the first time. */
+    client(el: Element, args: A, prev: A | undefined): void;
+}
+/** What a hook returns in a template: `<input ${invalid(errors)}>`. */
+export interface HookResult<A extends readonly unknown[] = readonly unknown[]> {
+    readonly [HOOK]: HookSpec<A>;
+    readonly [COMMIT_HOOK]: (part: HookPart, result: HookResult) => void;
+    readonly args: A;
+}
+/** A hook position as committing sees it (an element part of kind HOOK). */
+export interface HookPart {
+    readonly el: Element;
+    spec: HookSpec<readonly unknown[]> | null;
+    args: readonly unknown[] | undefined;
+    prev: readonly unknown[] | undefined;
+}
+export declare const isHook: (value: unknown) => value is HookResult;
+/** The spec of a hook result, or undefined for anything else. */
+export declare const hookSpec: (value: unknown) => HookSpec<readonly unknown[]> | undefined;
+/** Internal (hook-part.ts): a hook result. */
+export declare const hookResult: <A extends readonly unknown[]>(spec: HookSpec<A>, args: A, commit: HookResult[typeof COMMIT_HOOK]) => HookResult<A>;
+/** Shallow comparison of two argument lists, `Object.is` per argument. */
+export declare function sameArgs(a: readonly unknown[], b: readonly unknown[] | undefined): boolean;
+/** Queues `part`'s client call for the end of the render (document order). */
+export declare function queueHook(part: HookPart): void;
+/** The queue position before a render, for `runHooks`/`dropHooks`. */
+export declare const hookMark: () => number;
+/** Runs the `client` calls queued since `mark`, in document order. */
+export declare function runHooks(mark: number): void;
+/** Forgets the calls queued since `mark` (the render threw). */
+export declare function dropHooks(mark: number): void;
+export {};

package/dist/view/render/hooks.js

@@ -0,0 +1,46 @@
+// Element hooks (view/02-bindings.md "Element hooks", "Commit order"): their types and the
+// queue of client calls. A hook position (attr-parts.ts, kind HOOK) queues itself when its
+// arguments change (shallow `Object.is` per argument, hook-part.ts, which also holds
+// `defineHook`); `render` runs the queued `client` calls after the commit, in document order.
+// There is no cleanup: listeners a hook adds to its element are collected with it.
+const HOOK = Symbol('gyral.hook');
+/** Internal: a hook result's commit function (hook-part.ts), so apps without hooks skip it. */
+export const COMMIT_HOOK = Symbol('gyral.hook.commit');
+export const isHook = (value) => typeof value === 'object' && value !== null && HOOK in value;
+/** The spec of a hook result, or undefined for anything else. */
+export const hookSpec = (value) => isHook(value) ? value[HOOK] : undefined;
+/** Internal (hook-part.ts): a hook result. */
+export const hookResult = (spec, args, commit) => ({ [HOOK]: spec, [COMMIT_HOOK]: commit, args });
+/** Shallow comparison of two argument lists, `Object.is` per argument. */
+export function sameArgs(a, b) {
+    if (b === undefined || 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 queue = [];
+/** Queues `part`'s client call for the end of the render (document order). */
+export function queueHook(part) {
+    queue.push(part);
+}
+/** The queue position before a render, for `runHooks`/`dropHooks`. */
+export const hookMark = () => queue.length;
+/** Runs the `client` calls queued since `mark`, in document order. */
+export function runHooks(mark) {
+    try {
+        for (let i = mark; i < queue.length; i++) {
+            const part = queue[i];
+            part.spec.client(part.el, part.args, part.prev);
+        }
+    }
+    finally {
+        queue.length = mark;
+    }
+}
+/** Forgets the calls queued since `mark` (the render threw). */
+export function dropHooks(mark) {
+    queue.length = mark;
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/view/render/hooks.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,2FAA2F;AAC3F,qFAAqF;AACrF,8FAA8F;AAC9F,mFAAmF;AAEnF,MAAM,IAAI,GAAkB,MAAM,CAAC,YAAY,CAAC,CAAC;AACjD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,WAAW,GAAkB,MAAM,CAAC,mBAAmB,CAAC,CAAC;AA2BtE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAuB,EAAE,CAC5D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC;AAE/D,iEAAiE;AACjE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAA4C,EAAE,CACnF,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAE1C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAAiB,EACjB,IAAO,EACP,MAAsC,EACvB,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,CAAqB,EAAE,CAAiC;IAC/E,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,KAAK,GAAe,EAAE,CAAC;AAE7B,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;AAEnD,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAa,CAAC;YACjC,IAAI,CAAC,IAAqC,CAAC,MAAM,CAChD,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,IAA0B,EAC/B,IAAI,CAAC,IAAI,CACV,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;AACtB,CAAC","sourcesContent":["// Element hooks (view/02-bindings.md \"Element hooks\", \"Commit order\"): their types and the\n// queue of client calls. A hook position (attr-parts.ts, kind HOOK) queues itself when its\n// arguments change (shallow `Object.is` per argument, hook-part.ts, which also holds\n// `defineHook`); `render` runs the queued `client` calls after the commit, in document order.\n// There is no cleanup: listeners a hook adds to its element are collected with it.\n\nconst HOOK: unique symbol = Symbol('gyral.hook');\n/** Internal: a hook result's commit function (hook-part.ts), so apps without hooks skip it. */\nexport const COMMIT_HOOK: unique symbol = Symbol('gyral.hook.commit');\n\n/** Attributes a hook's server half adds to the start tag (`true`: present, no value). */\nexport type HookAttributes = Readonly<Record<string, string | true>>;\n\nexport interface HookSpec<A extends readonly unknown[]> {\n  /** Attributes for the server-rendered start tag (view/06-server.md). */\n  server?(args: A): HookAttributes;\n  /** Runs after the commit when `args` changed; `prev` is undefined the first time. */\n  client(el: Element, args: A, prev: A | undefined): void;\n}\n\n/** What a hook returns in a template: `<input ${invalid(errors)}>`. */\nexport interface HookResult<A extends readonly unknown[] = readonly unknown[]> {\n  readonly [HOOK]: HookSpec<A>;\n  readonly [COMMIT_HOOK]: (part: HookPart, result: HookResult) => void;\n  readonly args: A;\n}\n\n/** A hook position as committing sees it (an element part of kind HOOK). */\nexport interface HookPart {\n  readonly el: Element;\n  spec: HookSpec<readonly unknown[]> | null;\n  args: readonly unknown[] | undefined;\n  prev: readonly unknown[] | undefined;\n}\n\nexport const isHook = (value: unknown): value is HookResult =>\n  typeof value === 'object' && value !== null && HOOK in value;\n\n/** The spec of a hook result, or undefined for anything else. */\nexport const hookSpec = (value: unknown): HookSpec<readonly unknown[]> | undefined =>\n  isHook(value) ? value[HOOK] : undefined;\n\n/** Internal (hook-part.ts): a hook result. */\nexport const hookResult = <A extends readonly unknown[]>(\n  spec: HookSpec<A>,\n  args: A,\n  commit: HookResult[typeof COMMIT_HOOK],\n): HookResult<A> => ({ [HOOK]: spec, [COMMIT_HOOK]: commit, args });\n\n/** Shallow comparison of two argument lists, `Object.is` per argument. */\nexport function sameArgs(a: readonly unknown[], b: readonly unknown[] | undefined): boolean {\n  if (b === undefined || 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\nconst queue: HookPart[] = [];\n\n/** Queues `part`'s client call for the end of the render (document order). */\nexport function queueHook(part: HookPart): void {\n  queue.push(part);\n}\n\n/** The queue position before a render, for `runHooks`/`dropHooks`. */\nexport const hookMark = (): number => queue.length;\n\n/** Runs the `client` calls queued since `mark`, in document order. */\nexport function runHooks(mark: number): void {\n  try {\n    for (let i = mark; i < queue.length; i++) {\n      const part = queue[i] as HookPart;\n      (part.spec as HookSpec<readonly unknown[]>).client(\n        part.el,\n        part.args as readonly unknown[],\n        part.prev,\n      );\n    }\n  } finally {\n    queue.length = mark;\n  }\n}\n\n/** Forgets the calls queued since `mark` (the render threw). */\nexport function dropHooks(mark: number): void {\n  queue.length = mark;\n}\n"]}

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

@@ -0,0 +1,10 @@
+import { type SeenMarkup } from './seen.js';
+import type { ChildValue } from './values.js';
+/**
+ * Hydrates the server-rendered DOM in `root` with `value`, the first client render
+ * (view/07-hydration.md): builds the parts over the existing nodes, runs element hooks' client
+ * halves once, and leaves later `render` calls to update in place. Throws `HydrationMismatch`
+ * when the DOM doesn't match; `host` names the component in its message; `seen` is as for
+ * `render`.
+ */
+export declare function hydrate(value: ChildValue, root: Element | ShadowRoot, host?: string, seen?: SeenMarkup): void;

package/dist/view/render/hydrate.js

@@ -0,0 +1,33 @@
+// `hydrate(value, root)` (view/07-hydration.md): the first client render of server-rendered DOM.
+// Kept apart from render.ts so the walk (adopt.ts) is bundled only where hydration is used: core
+// loads it lazily, with the first server-rendered host (07 "Loading").
+import { adopt } from './adopt.js';
+import { ChildPart } from './child-part.js';
+import { dropHooks, hookMark, runHooks } from './hooks.js';
+import { setRootPart } from './render.js';
+import { listenFor } from './seen.js';
+/**
+ * Hydrates the server-rendered DOM in `root` with `value`, the first client render
+ * (view/07-hydration.md): builds the parts over the existing nodes, runs element hooks' client
+ * halves once, and leaves later `render` calls to update in place. Throws `HydrationMismatch`
+ * when the DOM doesn't match; `host` names the component in its message; `seen` is as for
+ * `render`.
+ */
+export function hydrate(value, root, host = 'the root', seen) {
+    const part = new ChildPart(root, null, null, 0, false, 0);
+    const mark = hookMark();
+    const outer = listenFor(seen);
+    try {
+        adopt(part, value, root, host);
+    }
+    catch (error) {
+        dropHooks(mark);
+        throw error;
+    }
+    finally {
+        listenFor(outer);
+    }
+    setRootPart(root, part);
+    runHooks(mark);
+}
+//# sourceMappingURL=hydrate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydrate.js","sourceRoot":"","sources":["../../../src/view/render/hydrate.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,iGAAiG;AACjG,uEAAuE;AACvE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAmB,MAAM,WAAW,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,KAAiB,EACjB,IAA0B,EAC1B,IAAI,GAAG,UAAU,EACjB,IAAiB;IAEjB,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,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,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC","sourcesContent":["// `hydrate(value, root)` (view/07-hydration.md): the first client render of server-rendered DOM.\n// Kept apart from render.ts so the walk (adopt.ts) is bundled only where hydration is used: core\n// loads it lazily, with the first server-rendered host (07 \"Loading\").\nimport { adopt } from './adopt.js';\nimport { ChildPart } from './child-part.js';\nimport { dropHooks, hookMark, runHooks } from './hooks.js';\nimport { setRootPart } from './render.js';\nimport { listenFor, type SeenMarkup } from './seen.js';\nimport type { ChildValue } from './values.js';\n\n/**\n * Hydrates the server-rendered DOM in `root` with `value`, the first client render\n * (view/07-hydration.md): builds the parts over the existing nodes, runs element hooks' client\n * halves once, and leaves later `render` calls to update in place. Throws `HydrationMismatch`\n * when the DOM doesn't match; `host` names the component in its message; `seen` is as for\n * `render`.\n */\nexport function hydrate(\n  value: ChildValue,\n  root: Element | ShadowRoot,\n  host = 'the root',\n  seen?: SeenMarkup,\n): void {\n  const part = new ChildPart(root, null, null, 0, false, 0);\n  const mark = hookMark();\n  const outer = listenFor(seen);\n  try {\n    adopt(part, value, root, host);\n  } catch (error) {\n    dropHooks(mark);\n    throw error;\n  } finally {\n    listenFor(outer);\n  }\n  setRootPart(root, part);\n  runHooks(mark);\n}\n"]}

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

@@ -0,0 +1,33 @@
+import type { TemplateObject } from '../normalize/types.js';
+import { type Part } from './attr-parts.js';
+import { ChildPart, type Owner } from './child-part.js';
+/** The DOM cloned from one template, plus its parts. */
+export declare class Instance implements Owner {
+    readonly template: TemplateObject;
+    /** The result source last rendered (strings array or compiled object), for a fast compare. */
+    source: unknown;
+    /** The child part whose content this instance is. */
+    readonly holder: ChildPart;
+    readonly parts: Part[];
+    /** First and last static root nodes; null when the template is a single hole. */
+    start: Node | null;
+    end: Node | null;
+    /** Root-level child parts before the first / after the last static root node. */
+    head: ChildPart | null;
+    tail: ChildPart | null;
+    /** The clone, until it is inserted. */
+    frag: DocumentFragment | null;
+    /** `adopt`: hydration (adopt.ts) fills the parts and root nodes from server DOM instead. */
+    constructor(template: TemplateObject, source: unknown, holder: ChildPart, adopt?: boolean);
+    private build;
+    /** Commits this render's values, part by part in document order. */
+    update(values: readonly unknown[]): void;
+    /** Inserts the (committed) clone; afterwards root-level parts resolve through the holder. */
+    insert(parent: Node, before: Node | null): void;
+    first(): Node | null;
+    last(): Node | null;
+    remove(): void;
+    /** Owner of root-level open parts: the clone while building, then the holder's parent. */
+    parentFor(): Node;
+    endFor(): Node | null;
+}

package/dist/view/render/instance.js

@@ -0,0 +1,107 @@
+import { attrPart } from './attr-parts.js';
+import { ChildPart } from './child-part.js';
+import { removeRange } from './nodes.js';
+import { report } from './seen.js';
+import { CHILD, nodes, planOf, ROOT, stack, walk } from './plan.js';
+/** The DOM cloned from one template, plus its parts. */
+export class Instance {
+    /** `adopt`: hydration (adopt.ts) fills the parts and root nodes from server DOM instead. */
+    constructor(template, source, holder, adopt) {
+        this.template = template;
+        this.source = source;
+        this.holder = holder;
+        this.parts = [];
+        this.head = null;
+        this.tail = null;
+        this.frag = this.start = this.end = null;
+        report(template);
+        if (adopt === true)
+            return;
+        const plan = planOf(template);
+        if (plan.single) {
+            const root = document.importNode(plan.content.firstChild, true);
+            stack[1] = root;
+            this.start = this.end = root;
+        }
+        else {
+            const frag = document.importNode(plan.content, true);
+            stack[0] = frag;
+            this.frag = frag;
+            this.start = frag.firstChild;
+            this.end = frag.lastChild;
+        }
+        walk(plan);
+        this.build(plan);
+    }
+    build(plan) {
+        const { a, b, at, kinds } = plan;
+        const specs = this.template.parts;
+        for (let i = 0; i < kinds.length; i++) {
+            const kind = kinds[i];
+            const node = nodes[a[i]];
+            if (kind >= 0) {
+                this.parts.push(attrPart(node, kind, specs[i], at[i]));
+                continue;
+            }
+            const r = b[i];
+            const ref = r >= 0 ? nodes[r] : null;
+            if (kind !== ROOT) {
+                this.parts.push(new ChildPart(node, ref, null, 0, kind !== CHILD, at[i]));
+                continue;
+            }
+            const part = new ChildPart(null, ref, ref === null ? this : null, 0, false, at[i]);
+            if (ref === null)
+                this.tail = part;
+            else if (ref === this.start)
+                this.head = part;
+            this.parts.push(part);
+        }
+    }
+    /** Commits this render's values, part by part in document order. */
+    update(values) {
+        const parts = this.parts;
+        for (let i = 0; i < parts.length; i++)
+            parts[i].set(values);
+    }
+    /** Inserts the (committed) clone; afterwards root-level parts resolve through the holder. */
+    insert(parent, before) {
+        parent.insertBefore(this.frag ?? this.start, before);
+        this.frag = null;
+    }
+    first() {
+        const head = this.head !== null ? this.head.first() : null;
+        if (head !== null)
+            return head;
+        if (this.start !== null)
+            return this.start;
+        return this.tail !== null ? this.tail.first() : null;
+    }
+    last() {
+        const tail = this.tail !== null ? this.tail.last() : null;
+        if (tail !== null)
+            return tail;
+        if (this.end !== null)
+            return this.end;
+        return this.head !== null ? this.head.last() : null;
+    }
+    remove() {
+        const first = this.first();
+        if (first === null)
+            return;
+        const last = this.last();
+        if (first === last)
+            first.remove();
+        else
+            removeRange(first, last);
+    }
+    /** Owner of root-level open parts: the clone while building, then the holder's parent. */
+    parentFor() {
+        if (this.frag !== null)
+            return this.frag;
+        return this.start !== null ? this.start.parentNode : this.holder.parent();
+    }
+    endFor() {
+        return this.frag !== null ? null : this.holder.end();
+    }
+}
+//# sourceMappingURL=instance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../../../src/view/render/instance.ts"],"names":[],"mappings":"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","sourcesContent":["// Template instances (view/01-templates.md \"Instantiation\", view/02-bindings.md \"Commit order\").\n// An instance is cloned with `document.importNode` (nested custom elements upgrade at once),\n// every part's nodes are resolved from the clone first by child-index paths (firstChild/\n// nextSibling, sharing prefixes; no TreeWalker, no marker search), then the values commit while\n// the clone is still detached, and only then is it inserted, so child components connect with\n// their props set. A template with one root node and no root-level holes clones just that node.\n// How to reach the nodes, and what each part is, comes from the template's plan (plan.ts).\n// Hydration (adopt.ts) creates instances with `adopt` set and fills them from server DOM.\nimport type { PartSpec, TemplateObject } from '../normalize/types.js';\nimport { attrPart, type Part } from './attr-parts.js';\nimport { ChildPart, type Owner } from './child-part.js';\nimport { removeRange } from './nodes.js';\nimport { report } from './seen.js';\nimport { CHILD, nodes, planOf, ROOT, stack, walk, type Plan } from './plan.js';\n\n/** The DOM cloned from one template, plus its parts. */\nexport class Instance implements Owner {\n  readonly template: TemplateObject;\n  /** The result source last rendered (strings array or compiled object), for a fast compare. */\n  source: unknown;\n  /** The child part whose content this instance is. */\n  readonly holder: ChildPart;\n  readonly parts: Part[];\n  /** First and last static root nodes; null when the template is a single hole. */\n  start: Node | null;\n  end: Node | null;\n  /** Root-level child parts before the first / after the last static root node. */\n  head: ChildPart | null;\n  tail: ChildPart | null;\n  /** The clone, until it is inserted. */\n  frag: DocumentFragment | null;\n\n  /** `adopt`: hydration (adopt.ts) fills the parts and root nodes from server DOM instead. */\n  constructor(template: TemplateObject, source: unknown, holder: ChildPart, adopt?: boolean) {\n    this.template = template;\n    this.source = source;\n    this.holder = holder;\n    this.parts = [];\n    this.head = null;\n    this.tail = null;\n    this.frag = this.start = this.end = null;\n    report(template);\n    if (adopt === true) return;\n    const plan = planOf(template);\n    if (plan.single) {\n      const root = document.importNode(plan.content.firstChild as Node, true);\n      stack[1] = root;\n      this.start = this.end = root;\n    } else {\n      const frag = document.importNode(plan.content, true);\n      stack[0] = frag;\n      this.frag = frag;\n      this.start = frag.firstChild;\n      this.end = frag.lastChild;\n    }\n    walk(plan);\n    this.build(plan);\n  }\n\n  private build(plan: Plan): void {\n    const { a, b, at, kinds } = plan;\n    const specs = this.template.parts;\n    for (let i = 0; i < kinds.length; i++) {\n      const kind = kinds[i] as number;\n      const node = nodes[a[i] as number] as Element;\n      if (kind >= 0) {\n        this.parts.push(attrPart(node, kind, specs[i] as PartSpec, at[i] as number));\n        continue;\n      }\n      const r = b[i] as number;\n      const ref = r >= 0 ? (nodes[r] as Node) : null;\n      if (kind !== ROOT) {\n        this.parts.push(new ChildPart(node, ref, null, 0, kind !== CHILD, at[i] as number));\n        continue;\n      }\n      const part = new ChildPart(null, ref, ref === null ? this : null, 0, false, at[i] as number);\n      if (ref === null) this.tail = part;\n      else if (ref === this.start) this.head = part;\n      this.parts.push(part);\n    }\n  }\n\n  /** Commits this render's values, part by part in document order. */\n  update(values: readonly unknown[]): void {\n    const parts = this.parts;\n    for (let i = 0; i < parts.length; i++) (parts[i] as Part).set(values);\n  }\n\n  /** Inserts the (committed) clone; afterwards root-level parts resolve through the holder. */\n  insert(parent: Node, before: Node | null): void {\n    parent.insertBefore(this.frag ?? (this.start as Node), before);\n    this.frag = null;\n  }\n\n  first(): Node | null {\n    const head = this.head !== null ? this.head.first() : null;\n    if (head !== null) return head;\n    if (this.start !== null) return this.start;\n    return this.tail !== null ? this.tail.first() : null;\n  }\n\n  last(): Node | null {\n    const tail = this.tail !== null ? this.tail.last() : null;\n    if (tail !== null) return tail;\n    if (this.end !== null) return this.end;\n    return this.head !== null ? this.head.last() : null;\n  }\n\n  remove(): void {\n    const first = this.first();\n    if (first === null) return;\n    const last = this.last() as Node;\n    if (first === last) (first as ChildNode).remove();\n    else removeRange(first, last);\n  }\n\n  /** Owner of root-level open parts: the clone while building, then the holder's parent. */\n  parentFor(): Node {\n    if (this.frag !== null) return this.frag;\n    return this.start !== null ? (this.start.parentNode as Node) : this.holder.parent();\n  }\n\n  endFor(): Node | null {\n    return this.frag !== null ? null : this.holder.end();\n  }\n}\n"]}

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

@@ -0,0 +1,20 @@
+import { ChildPart } from './child-part.js';
+import { List } from './rows.js';
+import { type ChildValue, type ListResult } from './values.js';
+export { List } from './rows.js';
+/** Removes every row; the list's part keeps its (now empty) list. */
+export declare function clearList(part: ChildPart, list: List): void;
+/**
+ * Creates rows for `l.items[from…to]` (keys from `keys[i - from]` when given) into one
+ * fragment, pushes them onto `rows` and inserts the fragment before `end`.
+ */
+export declare function createRows(part: ChildPart, list: List, l: ListResult, rows: ChildPart[], from: number, to: number, end: Node | null, keys?: readonly unknown[]): void;
+/**
+ * A keyed list (view/03-lists.md). `key` must give each item a unique string or number; `row`
+ * must depend only on its arguments: a row re-renders only when its item object or its `pick`
+ * result changes.
+ */
+export declare function each<T>(items: readonly T[], key: (item: T) => string | number, row: (item: T) => ChildValue): ListResult;
+export declare function each<T, P>(items: readonly T[], key: (item: T) => string | number, row: (item: T, picked: P) => ChildValue, pick: (item: T) => P): ListResult;
+/** A positional array: items reused by index (view/02-bindings.md "Child values"). */
+export declare function commitItems(part: ChildPart, values: readonly unknown[]): void;