@gyral/core 0.2.0 → 0.3.1

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.\n// `style` is written through the CSSOM, never `setAttribute`, so a strict CSP allows it.\nimport { DEV } from '#view-dev';\nimport type { PartSpec } from '../normalize/types.js';\nimport { COMMIT_HOOK, isHook, type HookResult, type HookSpec } from './hooks.js';\nimport { toggle } from './toggles.js';\nimport { nothing, UNSET } from './values.js';\nimport { badHook, warnFunctionProp, warnToggle, 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/** `?modal` on `<dialog>`, `?popover-open` on `[popover]`: opened and closed (toggles.ts). */\nexport const TOGGLE = 11;\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  if (name === 'modal' || name === 'popover-open') return TOGGLE;\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          this.write(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        if (DEV && typeof v === 'function') warnFunctionProp(this, el, this.name);\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 TOGGLE: {\n        const on = truthy(v);\n        if (on === this.value) return;\n        this.value = on;\n        if (toggle !== undefined) toggle(this, this.name, on);\n        else if (DEV) warnToggle(el, this.name);\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  /**\n   * Writes the attribute; `style` through the CSSOM (`.style.cssText`), which a strict CSP\n   * (`style-src` without `'unsafe-inline'`) allows where `setAttribute('style', …)` is blocked.\n   * HTML, SVG and MathML elements all have `.style`.\n   */\n  write(s: string): void {\n    if (this.name === 'style') (this.el as Element & ElementCSSInlineStyle).style.cssText = s;\n    else this.el.setAttribute(this.name, s);\n  }\n\n  /**\n   * MULTI: pieces joined with the static strings; `nothing` in any piece removes. With no\n   * pieces it is a static `style` attribute (01 \"Normalization\"): written once, at creation.\n   */\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 && this.value !== UNSET) 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.write(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,173 @@
+// 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, checkSvgParent, 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 template = templateOf(result);
+        if (DEV && template.svg)
+            checkSvgParent(this.parent());
+        const instance = new Instance(template, 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, checkSvgParent, 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 template = templateOf(result);\n    if (DEV && template.svg) checkSvgParent(this.parent());\n    const instance = new Instance(template, 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/dispose.d.ts

@@ -0,0 +1,3 @@
+import { type HookPart, type HookResult } from './hooks.js';
+/** Commits a disposable hook, then tracks it for removal and disconnects. */
+export declare function commitTracked(part: HookPart, result: HookResult): void;

package/dist/view/render/dispose.js

@@ -0,0 +1,76 @@
+// Disposable hooks (view/02-bindings.md "Widgets with a lifecycle"): hooks whose spec has
+// `dispose`, and the tracking behind it. A disposable hook is tracked per render root from its commit
+// (`track`), with the spec and arguments to dispose (`kept`, `keptArgs`). After each render of
+// a root commits, before its client calls, `run` disposes every tracked hook whose element left
+// the root (Gyral removed it: a cleared part, a replaced instance, a removed row; moves keep it
+// inside) or whose position no longer holds it (`nothing`, another hook); a disposable hook
+// replacing one disposes the old one in `track`. When the host disconnects, `run(root, true)`
+// disposes the root's hooks and marks them `off`: the render on reconnect re-commits them from
+// scratch (`prev` undefined) or, for skipped rows, `run` queues their `client` again. Nothing
+// here is bundled unless it is registered (`#spec-features`, or use-disposal.ts when a module
+// names `dispose`: gyral-c5d.2, gyral-1zd.24), and nothing runs until such a hook commits.
+import { commitHook } from './hook-part.js';
+import { committing, queueHook, useDisposal, } from './hooks.js';
+/** Parts committed since their root's hooks last ran, with that root. */
+let fresh = [];
+const live = new WeakMap();
+const dispose = (p) => {
+    p.kept.dispose?.(p.el, p.keptArgs);
+};
+function run(root, disconnect) {
+    let tracked = live.get(root);
+    if (disconnect !== true) {
+        // Inside a flush several roots commit before their hooks run: keep the others' parts.
+        const rest = [];
+        for (const entry of fresh) {
+            const [p, owner] = entry;
+            if (owner !== root) {
+                if (p.el.isConnected)
+                    rest.push(entry);
+                continue;
+            }
+            if (!root.contains(p.el))
+                continue; // left over from a render that threw
+            if (tracked === undefined)
+                live.set(root, (tracked = new Set()));
+            tracked.add(p);
+        }
+        fresh = rest;
+    }
+    if (tracked === undefined)
+        return false;
+    for (const p of tracked) {
+        const off = p.off;
+        p.off = disconnect;
+        if (disconnect === true || !root.contains(p.el) || p.spec !== p.kept) {
+            if (disconnect !== true)
+                tracked.delete(p);
+            if (off !== true)
+                dispose(p);
+        }
+        else if (off === true) {
+            p.prev = undefined; // a skipped row's hook: client again, from scratch
+            queueHook(p);
+        }
+    }
+    return tracked.size > 0;
+}
+/** A disposable hook committed at `part`: tracks it, and turns disposal on. */
+function track(part) {
+    useDisposal(run);
+    // Replaced by this one, unless a disconnect disposed it already.
+    if (part.off !== true && part.kept !== undefined && part.kept !== part.spec)
+        dispose(part);
+    part.off = false;
+    part.kept = part.spec ?? undefined;
+    part.keptArgs = part.args;
+    fresh.push([part, committing()]);
+}
+/** Commits a disposable hook, then tracks it for removal and disconnects. */
+export function commitTracked(part, result) {
+    if (part.off === true)
+        part.spec = null; // disposed by a disconnect: start over, always queued
+    commitHook(part, result);
+    track(part);
+}
+//# sourceMappingURL=dispose.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispose.js","sourceRoot":"","sources":["../../../src/view/render/dispose.ts"],"names":[],"mappings":"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","sourcesContent":["// Disposable hooks (view/02-bindings.md \"Widgets with a lifecycle\"): hooks whose spec has\n// `dispose`, and the tracking behind it. A disposable hook is tracked per render root from its commit\n// (`track`), with the spec and arguments to dispose (`kept`, `keptArgs`). After each render of\n// a root commits, before its client calls, `run` disposes every tracked hook whose element left\n// the root (Gyral removed it: a cleared part, a replaced instance, a removed row; moves keep it\n// inside) or whose position no longer holds it (`nothing`, another hook); a disposable hook\n// replacing one disposes the old one in `track`. When the host disconnects, `run(root, true)`\n// disposes the root's hooks and marks them `off`: the render on reconnect re-commits them from\n// scratch (`prev` undefined) or, for skipped rows, `run` queues their `client` again. Nothing\n// here is bundled unless it is registered (`#spec-features`, or use-disposal.ts when a module\n// names `dispose`: gyral-c5d.2, gyral-1zd.24), and nothing runs until such a hook commits.\nimport { commitHook } from './hook-part.js';\nimport {\n  committing,\n  queueHook,\n  useDisposal,\n  type HookPart,\n  type HookResult,\n  type HookSpec,\n} from './hooks.js';\n\n/** Parts committed since their root's hooks last ran, with that root. */\nlet fresh: [HookPart, Node | undefined][] = [];\nconst live = new WeakMap<Node, Set<HookPart>>();\n\nconst dispose = (p: HookPart): void => {\n  (p.kept as HookSpec<readonly unknown[]>).dispose?.(p.el, p.keptArgs as readonly unknown[]);\n};\n\nfunction run(root: Node, disconnect?: boolean): boolean {\n  let tracked = live.get(root);\n  if (disconnect !== true) {\n    // Inside a flush several roots commit before their hooks run: keep the others' parts.\n    const rest: [HookPart, Node | undefined][] = [];\n    for (const entry of fresh) {\n      const [p, owner] = entry;\n      if (owner !== root) {\n        if (p.el.isConnected) rest.push(entry);\n        continue;\n      }\n      if (!root.contains(p.el)) continue; // left over from a render that threw\n      if (tracked === undefined) live.set(root, (tracked = new Set()));\n      tracked.add(p);\n    }\n    fresh = rest;\n  }\n  if (tracked === undefined) return false;\n  for (const p of tracked) {\n    const off = p.off;\n    p.off = disconnect;\n    if (disconnect === true || !root.contains(p.el) || p.spec !== p.kept) {\n      if (disconnect !== true) tracked.delete(p);\n      if (off !== true) dispose(p);\n    } else if (off === true) {\n      p.prev = undefined; // a skipped row's hook: client again, from scratch\n      queueHook(p);\n    }\n  }\n  return tracked.size > 0;\n}\n\n/** A disposable hook committed at `part`: tracks it, and turns disposal on. */\nfunction track(part: HookPart): void {\n  useDisposal(run);\n  // Replaced by this one, unless a disconnect disposed it already.\n  if (part.off !== true && part.kept !== undefined && part.kept !== part.spec) dispose(part);\n  part.off = false;\n  part.kept = part.spec ?? undefined;\n  part.keptArgs = part.args;\n  fresh.push([part, committing()]);\n}\n\n/** Commits a disposable hook, then tracks it for removal and disconnects. */\nexport function commitTracked(part: HookPart, result: HookResult): void {\n  if (part.off === true) part.spec = null; // disposed by a disconnect: start over, always queued\n  commitHook(part, result);\n  track(part);\n}\n"]}

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

@@ -0,0 +1,5 @@
+import { type HookPart, type HookResult, type HookSpec } from './hooks.js';
+/** Queues the client call when the hook or its arguments changed, or always (`update`). */
+export declare function commitHook(part: HookPart, result: HookResult): void;
+/** 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,36 @@
+// `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.
+// A spec with `dispose` commits through dispose.ts's tracking, registered separately (hooks.ts
+// `disposableCommit`) so apps whose hooks have no teardown don't bundle it (gyral-c5d.2).
+import { DEV } from '#view-dev';
+import { runner } from './hook-run.js';
+import { disposableCommit, hookResult, hookSpec, queueHook, sameArgs, useHookRunner, } from './hooks.js';
+/** Queues the client call when the hook or its arguments changed, or always (`update`). */
+export function commitHook(part, result) {
+    const spec = hookSpec(result);
+    const args = result.args;
+    const same = spec === part.spec;
+    if (same && spec.update !== 'always' && 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) {
+    useHookRunner(runner);
+    return (...args) => hookResult(spec, args, spec.dispose === undefined ? commitHook : commitDisposable);
+}
+let warned = false;
+/** A hook with `dispose`: tracked when disposal is registered, else committed plainly. */
+function commitDisposable(part, result) {
+    if (DEV && disposableCommit === undefined && !warned) {
+        warned = true;
+        console.warn('gyral: a hook declares dispose, but the build found no module naming it, so hook ' +
+            'disposal was left out and dispose never runs. Write the dispose key in your source ' +
+            '(view/05-element.md "Features register themselves").');
+    }
+    (disposableCommit ?? commitHook)(part, result);
+}
+//# 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,+FAA+F;AAC/F,0FAA0F;AAC1F,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,GAId,MAAM,YAAY,CAAC;AAEpB,2FAA2F;AAC3F,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,MAAkB;IAC3D,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,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IAC1E,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,aAAa,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,CACjB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;AACvF,CAAC;AAED,IAAI,MAAM,GAAG,KAAK,CAAC;AAEnB,0FAA0F;AAC1F,SAAS,gBAAgB,CAAC,IAAc,EAAE,MAAkB;IAC1D,IAAI,GAAG,IAAI,gBAAgB,KAAK,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;QACrD,MAAM,GAAG,IAAI,CAAC;QACd,OAAO,CAAC,IAAI,CACV,mFAAmF;YACjF,qFAAqF;YACrF,sDAAsD,CACzD,CAAC;IACJ,CAAC;IACD,CAAC,gBAAgB,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjD,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.\n// A spec with `dispose` commits through dispose.ts's tracking, registered separately (hooks.ts\n// `disposableCommit`) so apps whose hooks have no teardown don't bundle it (gyral-c5d.2).\nimport { DEV } from '#view-dev';\nimport { runner } from './hook-run.js';\nimport {\n  disposableCommit,\n  hookResult,\n  hookSpec,\n  queueHook,\n  sameArgs,\n  useHookRunner,\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, or always (`update`). */\nexport function 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 && spec.update !== 'always' && 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  useHookRunner(runner);\n  return (...args) =>\n    hookResult(spec, args, spec.dispose === undefined ? commitHook : commitDisposable);\n}\n\nlet warned = false;\n\n/** A hook with `dispose`: tracked when disposal is registered, else committed plainly. */\nfunction commitDisposable(part: HookPart, result: HookResult): void {\n  if (DEV && disposableCommit === undefined && !warned) {\n    warned = true;\n    console.warn(\n      'gyral: a hook declares dispose, but the build found no module naming it, so hook ' +\n        'disposal was left out and dispose never runs. Write the dispose key in your source ' +\n        '(view/05-element.md \"Features register themselves\").',\n    );\n  }\n  (disposableCommit ?? commitHook)(part, result);\n}\n"]}

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

@@ -0,0 +1,2 @@
+import { type HookRunner } from './hooks.js';
+export declare const runner: HookRunner;