@gyral/core 0.2.0 → 0.3.0

package/dist/view/render/attr-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attr-parts.js","sourceRoot":"","sources":["../../../src/view/render/attr-parts.ts"],"names":[],"mappings":"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","sourcesContent":["// Element parts (view/02-bindings.md \"Attribute values\", \"Boolean attributes\", \"Properties\",\n// \"Live form state\", \"Element hooks\"): every hole on or inside one element that isn't a child\n// hole, as one class with a kind, so an instance's update loop sees only two part shapes.\n// Every part compares with its committed value and writes only on change. Live form state\n// sets the attribute too on first creation (the default, so `form.reset()` returns to the\n// model's first value); when the model's value changes it compares with the element's live\n// state and writes only on a difference, so the change lands even over a user's edit, and an\n// unchanged model never touches the control. Constructors only record nodes; hydration\n// (view/07-hydration.md) builds the same parts over server DOM and adopts this render's values\n// as committed (adopt-attr.ts), so edits made before scripts ran stay by the same rule.\nimport { DEV } from '#view-dev';\nimport type { PartSpec } from '../normalize/types.js';\nimport { COMMIT_HOOK, isHook, type HookResult, type HookSpec } from './hooks.js';\nimport { nothing, UNSET } from './values.js';\nimport { badHook, warnTrue, warnValue } from './warn.js';\n\n/** What every part of an instance implements: commit its value(s) from this render's values. */\nexport interface Part {\n  set(values: readonly unknown[]): void;\n}\n\n/** `name=${v}`; `value=${v}` on a non-text input becomes this after its first commit. */\nexport const ATTR = 0;\n/** `name=\"a ${x} b\"`. */\nexport const MULTI = 1;\n/** `?name=${v}`. */\nexport const BOOL = 2;\n/** `.name=${v}`. */\nexport const PROP = 3;\n/** `value=${v}` on `<input>`: live `.value`. */\nexport const VALUE = 4;\n/** `?checked` on `<input>`, `?selected` on `<option>`: attribute first, then the live property. */\nexport const CHECKED = 5;\n/** `?indeterminate` on `<input>`: the property only. */\nexport const STATE = 6;\n/** `?open` on `<details>`/`<dialog>`: the attribute, compared with its live presence. */\nexport const OPEN = 7;\n/** `<title>${v}</title>`: text content. */\nexport const TITLE = 8;\n/** `<textarea>${v}</textarea>`: text content first, then the live `.value`. */\nexport const TEXTAREA = 9;\n/** `${hook(…)}` in a start tag. */\nexport const HOOK = 10;\n\n/** Input types whose `value` is a submitted value, not state the user edits. */\nexport const PLAIN = /^(checkbox|radio|hidden|button|submit|reset|image|file)$/;\n\n/** `String(v)`: numbers and booleans as text (objects warn in development first). */\nconst text = String as (value: unknown) => string;\n\nexport const absent = (v: unknown): boolean => v === null || v === undefined || v === nothing;\nexport const truthy = (v: unknown): boolean => v !== nothing && !!v;\n\nconst isObject = (v: unknown): boolean =>\n  (typeof v === 'object' && v !== null) || typeof v === 'function';\n\n/** The text of a `<textarea>`/`<title>` value: child-hole rules, as one string. */\nexport function textOf(part: object, v: unknown): string {\n  if (typeof v === 'string') return v;\n  if (typeof v === 'number') return String(v);\n  if (DEV) {\n    if (v === true) warnTrue(part);\n    else if (isObject(v)) warnValue(part, v, 'the text content');\n  }\n  return absent(v) || typeof v === 'boolean' ? '' : text(v);\n}\n\n/** The kind of a bound attribute (`?name` when `bool`) on `el`. */\nexport function attrKind(el: Element, name: string, bool: boolean): number {\n  const tag = el.localName;\n  if (!bool) return name === 'value' && tag === 'input' ? VALUE : ATTR;\n  if (tag === 'input')\n    return name === 'checked' ? CHECKED : name === 'indeterminate' ? STATE : BOOL;\n  if (tag === 'option' && name === 'selected') return CHECKED;\n  return name === 'open' && (tag === 'details' || tag === 'dialog') ? OPEN : BOOL;\n}\n\n/** The element part for part table entry `spec`: `[kind, path, name?, strings?]` (01). */\nexport function attrPart(el: Element, kind: number, spec: PartSpec, at: number): AttrPart {\n  const s = spec as readonly [number, unknown, string?, (readonly string[])?];\n  return new AttrPart(el, kind, s[2] ?? '', at, s[3]);\n}\n\nexport class AttrPart implements Part {\n  readonly el: Element;\n  kind: number;\n  readonly name: string;\n  readonly at: number;\n  /** The committed value: raw (ATTR, PROP, VALUE), boolean, string (MULTI, text), or UNSET. */\n  value: unknown;\n  /** MULTI: the static strings and the committed pieces. */\n  readonly strings: readonly string[] | undefined;\n  readonly pieces: unknown[] | undefined;\n  /** HOOK: the hook, its committed arguments and the ones before. */\n  spec: HookSpec<readonly unknown[]> | null;\n  args: readonly unknown[] | undefined;\n  prev: readonly unknown[] | undefined;\n\n  constructor(el: Element, kind: number, name: string, at: number, strings?: readonly string[]) {\n    this.el = el;\n    this.kind = kind;\n    this.name = name;\n    this.at = at;\n    this.value = UNSET;\n    this.strings = strings;\n    this.pieces =\n      strings === undefined ? undefined : new Array<unknown>(strings.length - 1).fill(UNSET);\n    this.spec = null;\n    this.args = undefined;\n    this.prev = undefined;\n  }\n\n  set(values: readonly unknown[]): void {\n    const v = values[this.at];\n    const el = this.el;\n    const live = el as unknown as Record<string, unknown>;\n    switch (this.kind) {\n      case ATTR:\n        if (v === this.value) return;\n        this.value = v;\n        if (absent(v)) el.removeAttribute(this.name);\n        else {\n          if (DEV && isObject(v)) warnValue(this, v, `the attribute ${this.name}`);\n          el.setAttribute(this.name, typeof v === 'string' ? v : text(v));\n        }\n        return;\n      case MULTI:\n        this.multi(values);\n        return;\n      case BOOL: {\n        const on = truthy(v);\n        if (on === this.value) return;\n        this.value = on;\n        el.toggleAttribute(this.name, on);\n        return;\n      }\n      case PROP:\n        if (Object.is(v, this.value)) return;\n        this.value = v;\n        live[this.name] = v;\n        return;\n      case VALUE: {\n        if (v === this.value) return;\n        const s = absent(v) ? '' : text(v);\n        if (this.value === UNSET) {\n          // First creation: the attribute (the default), then the live value.\n          if (absent(v)) el.removeAttribute('value');\n          else el.setAttribute('value', s);\n          if (PLAIN.test((el as HTMLInputElement).type)) this.kind = ATTR;\n        }\n        this.value = v;\n        if (this.kind === VALUE && live.value !== s) live.value = s;\n        return;\n      }\n      case CHECKED:\n      case STATE: {\n        const on = truthy(v);\n        if (on === this.value) return;\n        if (this.kind === CHECKED && this.value === UNSET) el.toggleAttribute(this.name, on);\n        this.value = on;\n        if (live[this.name] !== on) live[this.name] = on;\n        return;\n      }\n      case OPEN: {\n        const on = truthy(v);\n        if (on === this.value) return;\n        this.value = on;\n        if (el.hasAttribute('open') !== on) el.toggleAttribute('open', on);\n        return;\n      }\n      case TITLE:\n      case TEXTAREA: {\n        const s = textOf(this, v);\n        if (s === this.value) return;\n        if (this.kind === TEXTAREA && this.value !== UNSET) {\n          if (live.value !== s) live.value = s;\n        } else el.textContent = s;\n        this.value = s;\n        return;\n      }\n      default:\n        this.hook(v);\n    }\n  }\n\n  /** MULTI: pieces joined with the static strings; `nothing` in any piece removes. */\n  private multi(values: readonly unknown[]): void {\n    const pieces = this.pieces as unknown[];\n    let changed = false;\n    for (let i = 0; i < pieces.length; i++) {\n      const v = values[this.at + i];\n      if (v !== pieces[i]) {\n        pieces[i] = v;\n        changed = true;\n      }\n    }\n    if (!changed) return;\n    const joined = this.join(pieces);\n    if (joined === this.value) return;\n    this.value = joined;\n    if (joined === null) this.el.removeAttribute(this.name);\n    else this.el.setAttribute(this.name, joined);\n  }\n\n  /** The joined value of `pieces`, or null when one is `nothing`. */\n  join(pieces: readonly unknown[]): string | null {\n    const strings = this.strings as readonly string[];\n    let joined = strings[0] as string;\n    for (let i = 0; i < pieces.length; i++) {\n      const v = pieces[i];\n      if (v === nothing) return null;\n      if (DEV && isObject(v)) warnValue(this, v, `the attribute ${this.name}`);\n      joined += (v === null || v === undefined ? '' : text(v)) + (strings[i + 1] as string);\n    }\n    return joined;\n  }\n\n  /** HOOK: the result commits itself (hook-part.ts); an absent value forgets the hook. */\n  hook(v: unknown): void {\n    if (absent(v)) {\n      this.spec = null;\n      this.args = undefined;\n      return;\n    }\n    const commit = isHook(v) ? v[COMMIT_HOOK] : undefined;\n    if (commit !== undefined) commit(this, v as HookResult);\n    else if (DEV) badHook(v);\n  }\n}\n"]}

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

@@ -0,0 +1,51 @@
+import { Instance } from './instance.js';
+import { type List } from './list.js';
+import type { RawRange } from './raw.js';
+/** What a child part holds. */
+export declare const EMPTY = 0;
+export declare const TEXT = 1;
+export declare const INSTANCE = 2;
+export declare const ITEMS = 3;
+export declare const LIST = 4;
+export declare const RAW = 5;
+/** Resolves the position of the parts it owns (root-level open parts, rows, items). */
+export interface Owner {
+    parentFor(index: number): Node;
+    endFor(index: number): Node | null;
+}
+export declare class ChildPart {
+    /** The parent element, when fixed (holes inside an element, the render root). */
+    parentNode: Node | null;
+    /** The static reference node; null: the end of `parentNode`. Unused when `owner` is set. */
+    ref: Node | null;
+    /** Set for open parts: their position comes from the owner. */
+    owner: Owner | null;
+    /** Position among the owner's rows or items. */
+    index: number;
+    /** Index of the value in the instance's values. */
+    readonly at: number;
+    /** The part is its parent element's only content (lists clear with replaceChildren). */
+    readonly sole: boolean;
+    kind: number;
+    /** Committed text value (TEXT). */
+    value: unknown;
+    content: Text | Instance | List | RawRange | null;
+    /** Rows of `each` (view/03-lists.md): key, item and pick result last rendered. */
+    key: unknown;
+    item: unknown;
+    picked: unknown;
+    constructor(parentNode: Node | null, ref: Node | null, owner: Owner | null, index: number, sole: boolean, at: number);
+    set(values: readonly unknown[]): void;
+    /** The node new content goes into. */
+    parent(): Node;
+    /** The node after this part's content (null: the end of the parent). */
+    end(): Node | null;
+    first(): Node | null;
+    last(): Node | null;
+    commit(value: unknown): void;
+    private text;
+    private template;
+    private create;
+    /** Removes the content; the part becomes empty. */
+    clear(): void;
+}

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

@@ -0,0 +1,170 @@
+// The child part (view/02-bindings.md "Child values", "The anchor rule"): one class for every
+// child hole, list row, array item and render root, so its call sites stay monomorphic. It
+// inserts before its reference node: a static node of the template (`ref`), the end of its
+// parent element (`ref` null), or, for root-level holes, rows and items, wherever its owner
+// says (the instance's or list's position, resolved only when something is inserted).
+import { DEV } from '#view-dev';
+import { isTemplateResult, sourceOf, templateOf } from '../template.js';
+import { Instance } from './instance.js';
+import { clearList, commitItems } from './list.js';
+import { EACH, isList, isRaw, MARKUP, nothing } from './values.js';
+import { badChild, warnTrue } from './warn.js';
+/** What a child part holds. */
+export const EMPTY = 0;
+export const TEXT = 1;
+export const INSTANCE = 2;
+export const ITEMS = 3;
+export const LIST = 4;
+export const RAW = 5;
+export class ChildPart {
+    constructor(parentNode, ref, owner, index, sole, at) {
+        this.parentNode = parentNode;
+        this.ref = ref;
+        this.owner = owner;
+        this.index = index;
+        this.at = at;
+        this.sole = sole;
+        this.kind = EMPTY;
+        this.value = undefined;
+        this.content = null;
+        this.key = undefined;
+        this.item = undefined;
+        this.picked = undefined;
+    }
+    set(values) {
+        this.commit(values[this.at]);
+    }
+    /** The node new content goes into. */
+    parent() {
+        if (this.parentNode !== null)
+            return this.parentNode;
+        if (this.owner !== null)
+            return this.owner.parentFor(this.index);
+        return this.ref.parentNode;
+    }
+    /** The node after this part's content (null: the end of the parent). */
+    end() {
+        return this.owner === null ? this.ref : this.owner.endFor(this.index);
+    }
+    first() {
+        const content = this.content;
+        return this.kind === TEXT ? content : content && content.first();
+    }
+    last() {
+        const content = this.content;
+        return this.kind === TEXT ? content : content && content.last();
+    }
+    commit(value) {
+        switch (typeof value) {
+            case 'string':
+            case 'number':
+                this.text(value);
+                return;
+            case 'object':
+                if (value === null)
+                    break;
+                if (isTemplateResult(value)) {
+                    this.template(value);
+                    return;
+                }
+                if (isList(value)) {
+                    value[EACH](this, value);
+                    return;
+                }
+                if (Array.isArray(value)) {
+                    commitItems(this, value);
+                    return;
+                }
+                if (isRaw(value)) {
+                    value[MARKUP](this, value.html);
+                    return;
+                }
+                if (DEV)
+                    badChild(value);
+                break;
+            case 'boolean':
+                if (DEV && value)
+                    warnTrue(this);
+                break;
+            case 'undefined':
+                break;
+            default:
+                if (DEV && value !== nothing)
+                    badChild(value);
+        }
+        if (this.kind !== EMPTY)
+            this.clear();
+    }
+    text(value) {
+        if (this.kind === TEXT) {
+            if (value !== this.value) {
+                this.value = value;
+                this.content.data = typeof value === 'string' ? value : String(value);
+            }
+            return;
+        }
+        if (this.kind !== EMPTY)
+            this.clear();
+        const data = typeof value === 'string' ? value : String(value);
+        const parent = this.parentNode;
+        let node;
+        if (this.sole && parent !== null && data !== '') {
+            // The parent's only content: one DOM call creates and inserts the Text node.
+            parent.textContent = data;
+            node = parent.firstChild;
+        }
+        else {
+            node = document.createTextNode(data);
+            this.parent().insertBefore(node, this.end());
+        }
+        this.kind = TEXT;
+        this.content = node;
+        this.value = value;
+    }
+    template(result) {
+        const source = sourceOf(result);
+        if (this.kind === INSTANCE) {
+            const instance = this.content;
+            if (instance.source === source) {
+                instance.update(result.values);
+                return;
+            }
+            // Another source with the same id (a second call site, a module reloaded in development)
+            // is the same template. Production client objects have no id: each is its own template,
+            // so a different object replaces the instance (01 "Template ids").
+            const template = templateOf(result);
+            if (template.id !== undefined && template.id === instance.template.id) {
+                instance.source = source;
+                instance.update(result.values);
+                return;
+            }
+            this.clear();
+            this.create(result, source);
+            return;
+        }
+        if (this.kind !== EMPTY)
+            this.clear();
+        this.create(result, source);
+    }
+    create(result, source) {
+        const instance = new Instance(templateOf(result), source, this);
+        instance.update(result.values);
+        instance.insert(this.parent(), this.end());
+        this.kind = INSTANCE;
+        this.content = instance;
+    }
+    /** Removes the content; the part becomes empty. */
+    clear() {
+        const content = this.content;
+        if (this.kind === TEXT)
+            content.remove();
+        else if (this.kind === ITEMS || this.kind === LIST)
+            clearList(this, content);
+        else if (content !== null)
+            content.remove();
+        this.kind = EMPTY;
+        this.content = null;
+        this.value = undefined;
+    }
+}
+//# sourceMappingURL=child-part.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"child-part.js","sourceRoot":"","sources":["../../../src/view/render/child-part.ts"],"names":[],"mappings":"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","sourcesContent":["// The child part (view/02-bindings.md \"Child values\", \"The anchor rule\"): one class for every\n// child hole, list row, array item and render root, so its call sites stay monomorphic. It\n// inserts before its reference node: a static node of the template (`ref`), the end of its\n// parent element (`ref` null), or, for root-level holes, rows and items, wherever its owner\n// says (the instance's or list's position, resolved only when something is inserted).\nimport { DEV } from '#view-dev';\nimport { isTemplateResult, sourceOf, templateOf, type TemplateResult } from '../template.js';\nimport { Instance } from './instance.js';\nimport { clearList, commitItems, type List } from './list.js';\nimport { EACH, isList, isRaw, MARKUP, nothing } from './values.js';\nimport type { RawRange } from './raw.js';\nimport { badChild, warnTrue } from './warn.js';\n\n/** What a child part holds. */\nexport const EMPTY = 0;\nexport const TEXT = 1;\nexport const INSTANCE = 2;\nexport const ITEMS = 3;\nexport const LIST = 4;\nexport const RAW = 5;\n\n/** Resolves the position of the parts it owns (root-level open parts, rows, items). */\nexport interface Owner {\n  parentFor(index: number): Node;\n  endFor(index: number): Node | null;\n}\n\n/** What a child part's content can be, besides text. */\ntype Span = Instance | List | RawRange;\n\nexport class ChildPart {\n  /** The parent element, when fixed (holes inside an element, the render root). */\n  parentNode: Node | null;\n  /** The static reference node; null: the end of `parentNode`. Unused when `owner` is set. */\n  ref: Node | null;\n  /** Set for open parts: their position comes from the owner. */\n  owner: Owner | null;\n  /** Position among the owner's rows or items. */\n  index: number;\n  /** Index of the value in the instance's values. */\n  readonly at: number;\n  /** The part is its parent element's only content (lists clear with replaceChildren). */\n  readonly sole: boolean;\n  kind: number;\n  /** Committed text value (TEXT). */\n  value: unknown;\n  content: Text | Instance | List | RawRange | null;\n  /** Rows of `each` (view/03-lists.md): key, item and pick result last rendered. */\n  key: unknown;\n  item: unknown;\n  picked: unknown;\n\n  constructor(\n    parentNode: Node | null,\n    ref: Node | null,\n    owner: Owner | null,\n    index: number,\n    sole: boolean,\n    at: number,\n  ) {\n    this.parentNode = parentNode;\n    this.ref = ref;\n    this.owner = owner;\n    this.index = index;\n    this.at = at;\n    this.sole = sole;\n    this.kind = EMPTY;\n    this.value = undefined;\n    this.content = null;\n    this.key = undefined;\n    this.item = undefined;\n    this.picked = undefined;\n  }\n\n  set(values: readonly unknown[]): void {\n    this.commit(values[this.at]);\n  }\n\n  /** The node new content goes into. */\n  parent(): Node {\n    if (this.parentNode !== null) return this.parentNode;\n    if (this.owner !== null) return this.owner.parentFor(this.index);\n    return (this.ref as Node).parentNode as Node;\n  }\n\n  /** The node after this part's content (null: the end of the parent). */\n  end(): Node | null {\n    return this.owner === null ? this.ref : this.owner.endFor(this.index);\n  }\n\n  first(): Node | null {\n    const content = this.content;\n    return this.kind === TEXT ? (content as Text) : content && (content as Span).first();\n  }\n\n  last(): Node | null {\n    const content = this.content;\n    return this.kind === TEXT ? (content as Text) : content && (content as Span).last();\n  }\n\n  commit(value: unknown): void {\n    switch (typeof value) {\n      case 'string':\n      case 'number':\n        this.text(value);\n        return;\n      case 'object':\n        if (value === null) break;\n        if (isTemplateResult(value)) {\n          this.template(value);\n          return;\n        }\n        if (isList(value)) {\n          value[EACH](this, value);\n          return;\n        }\n        if (Array.isArray(value)) {\n          commitItems(this, value);\n          return;\n        }\n        if (isRaw(value)) {\n          value[MARKUP](this, value.html);\n          return;\n        }\n        if (DEV) badChild(value);\n        break;\n      case 'boolean':\n        if (DEV && value) warnTrue(this);\n        break;\n      case 'undefined':\n        break;\n      default:\n        if (DEV && value !== nothing) badChild(value);\n    }\n    if (this.kind !== EMPTY) this.clear();\n  }\n\n  private text(value: string | number): void {\n    if (this.kind === TEXT) {\n      if (value !== this.value) {\n        this.value = value;\n        (this.content as Text).data = typeof value === 'string' ? value : String(value);\n      }\n      return;\n    }\n    if (this.kind !== EMPTY) this.clear();\n    const data = typeof value === 'string' ? value : String(value);\n    const parent = this.parentNode;\n    let node: Text;\n    if (this.sole && parent !== null && data !== '') {\n      // The parent's only content: one DOM call creates and inserts the Text node.\n      parent.textContent = data;\n      node = parent.firstChild as Text;\n    } else {\n      node = document.createTextNode(data);\n      this.parent().insertBefore(node, this.end());\n    }\n    this.kind = TEXT;\n    this.content = node;\n    this.value = value;\n  }\n\n  private template(result: TemplateResult): void {\n    const source = sourceOf(result);\n    if (this.kind === INSTANCE) {\n      const instance = this.content as Instance;\n      if (instance.source === source) {\n        instance.update(result.values);\n        return;\n      }\n      // Another source with the same id (a second call site, a module reloaded in development)\n      // is the same template. Production client objects have no id: each is its own template,\n      // so a different object replaces the instance (01 \"Template ids\").\n      const template = templateOf(result);\n      if (template.id !== undefined && template.id === instance.template.id) {\n        instance.source = source;\n        instance.update(result.values);\n        return;\n      }\n      this.clear();\n      this.create(result, source);\n      return;\n    }\n    if (this.kind !== EMPTY) this.clear();\n    this.create(result, source);\n  }\n\n  private create(result: TemplateResult, source: unknown): void {\n    const instance = new Instance(templateOf(result), source, this);\n    instance.update(result.values);\n    instance.insert(this.parent(), this.end());\n    this.kind = INSTANCE;\n    this.content = instance;\n  }\n\n  /** Removes the content; the part becomes empty. */\n  clear(): void {\n    const content = this.content;\n    if (this.kind === TEXT) (content as Text).remove();\n    else if (this.kind === ITEMS || this.kind === LIST) clearList(this, content as List);\n    else if (content !== null) (content as Instance | RawRange).remove();\n    this.kind = EMPTY;\n    this.content = null;\n    this.value = undefined;\n  }\n}\n"]}

package/dist/view/render/dev-check.d.ts

@@ -0,0 +1,12 @@
+import { ChildPart } from './child-part.js';
+import { type List } from './rows.js';
+import { type ListResult } from './values.js';
+/** Rows re-evaluated per flush (render.ts `renderBatch`), or per render call outside one. */
+export declare const ROW_CHECKS = 200;
+/** Called at the start of each flush, or of a `render` call outside one. */
+export declare function resetRowChecks(): void;
+/** Keys are unique strings or numbers. Guarded here too: the lazy hydration chunk calls it. */
+export declare function checkKeys(items: readonly unknown[], key: (item: unknown) => unknown): void;
+export declare function recheckRows(list: List, l: ListResult): void;
+/** Whether rendering `value` into `part` would change nothing. */
+export declare function sameChild(part: ChildPart, value: unknown): boolean;

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"]}