@llui/dom 0.0.32 → 0.0.33

package/dist/primitives/sample.d.ts

@@ -1,11 +1,23 @@
 /**
  * Read current state inside a render context and return the result of
  * `selector(state)`. No binding is created, no mask is assigned — this
- * is a one-shot imperative read.
+ * is a one-shot imperative read at view-construction time.
  *
- * Use when a builder needs the current state snapshot (e.g. to pass
- * an object to an imperative renderer), and a reactive binding would
- * be wrong semantically.
+ * **Don't use for variable-length lists.** Wrapping a list-render in
+ * `sample` looks idiomatic but silently breaks reactivity: the
+ * `.map(...)` runs once at construction, captures the row objects in
+ * closure, and never re-runs when state updates in place. The cells
+ * inside the captured rows show stale data; only a full structural
+ * rebuild (e.g. a parent `branch` swapping arms) will refresh them.
+ * Use `each` + `ItemAccessor` instead — see the "List of editable
+ * rows" recipe in the cookbook.
+ *
+ * **Use for** passing a state snapshot to an imperative renderer
+ * (foreign libraries, third-party canvas/svg builders), reading a
+ * value to compute a static piece of structure that doesn't need to
+ * react, or any case where a reactive binding would be semantically
+ * wrong (e.g. capturing a value at *this exact moment* for a
+ * one-shot side effect).
  *
  * Also exposed as `h.sample` on the View bag for destructure-from-`h`
  * ergonomics. The top-level import form works everywhere a render

package/dist/primitives/sample.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/primitives/sample.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAGrD"}
+{"version":3,"file":"sample.d.ts","sourceRoot":"","sources":["../../src/primitives/sample.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAGrD"}

package/dist/primitives/sample.js

@@ -2,11 +2,23 @@ import { getRenderContext } from '../render-context.js';
 /**
  * Read current state inside a render context and return the result of
  * `selector(state)`. No binding is created, no mask is assigned — this
- * is a one-shot imperative read.
+ * is a one-shot imperative read at view-construction time.
  *
- * Use when a builder needs the current state snapshot (e.g. to pass
- * an object to an imperative renderer), and a reactive binding would
- * be wrong semantically.
+ * **Don't use for variable-length lists.** Wrapping a list-render in
+ * `sample` looks idiomatic but silently breaks reactivity: the
+ * `.map(...)` runs once at construction, captures the row objects in
+ * closure, and never re-runs when state updates in place. The cells
+ * inside the captured rows show stale data; only a full structural
+ * rebuild (e.g. a parent `branch` swapping arms) will refresh them.
+ * Use `each` + `ItemAccessor` instead — see the "List of editable
+ * rows" recipe in the cookbook.
+ *
+ * **Use for** passing a state snapshot to an imperative renderer
+ * (foreign libraries, third-party canvas/svg builders), reading a
+ * value to compute a static piece of structure that doesn't need to
+ * react, or any case where a reactive binding would be semantically
+ * wrong (e.g. capturing a value at *this exact moment* for a
+ * one-shot side effect).
  *
  * Also exposed as `h.sample` on the View bag for destructure-from-`h`
  * ergonomics. The top-level import form works everywhere a render

package/dist/primitives/sample.js.map

@@ -1 +1 @@
-{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../src/primitives/sample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,MAAM,CAAO,QAAqB;IAChD,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAU,CAAC,CAAA;AACjC,CAAC","sourcesContent":["import { getRenderContext } from '../render-context.js'\n\n/**\n * Read current state inside a render context and return the result of\n * `selector(state)`. No binding is created, no mask is assigned — this\n * is a one-shot imperative read.\n *\n * Use when a builder needs the current state snapshot (e.g. to pass\n * an object to an imperative renderer), and a reactive binding would\n * be wrong semantically.\n *\n * Also exposed as `h.sample` on the View bag for destructure-from-`h`\n * ergonomics. The top-level import form works everywhere a render\n * context is live — including `each.render`, whose bag intentionally\n * does not carry View methods.\n *\n * Throws if called outside a render context.\n */\nexport function sample<S, R>(selector: (s: S) => R): R {\n  const ctx = getRenderContext('sample')\n  return selector(ctx.state as S)\n}\n"]}
+{"version":3,"file":"sample.js","sourceRoot":"","sources":["../../src/primitives/sample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,MAAM,CAAO,QAAqB;IAChD,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,KAAU,CAAC,CAAA;AACjC,CAAC","sourcesContent":["import { getRenderContext } from '../render-context.js'\n\n/**\n * Read current state inside a render context and return the result of\n * `selector(state)`. No binding is created, no mask is assigned — this\n * is a one-shot imperative read at view-construction time.\n *\n * **Don't use for variable-length lists.** Wrapping a list-render in\n * `sample` looks idiomatic but silently breaks reactivity: the\n * `.map(...)` runs once at construction, captures the row objects in\n * closure, and never re-runs when state updates in place. The cells\n * inside the captured rows show stale data; only a full structural\n * rebuild (e.g. a parent `branch` swapping arms) will refresh them.\n * Use `each` + `ItemAccessor` instead — see the \"List of editable\n * rows\" recipe in the cookbook.\n *\n * **Use for** passing a state snapshot to an imperative renderer\n * (foreign libraries, third-party canvas/svg builders), reading a\n * value to compute a static piece of structure that doesn't need to\n * react, or any case where a reactive binding would be semantically\n * wrong (e.g. capturing a value at *this exact moment* for a\n * one-shot side effect).\n *\n * Also exposed as `h.sample` on the View bag for destructure-from-`h`\n * ergonomics. The top-level import form works everywhere a render\n * context is live — including `each.render`, whose bag intentionally\n * does not carry View methods.\n *\n * Throws if called outside a render context.\n */\nexport function sample<S, R>(selector: (s: S) => R): R {\n  const ctx = getRenderContext('sample')\n  return selector(ctx.state as S)\n}\n"]}

package/dist/primitives/unsafe-html.d.ts

@@ -24,5 +24,5 @@
  * reads. Phase 2 / Phase 1 skip the reconcile when no interesting bit
  * is set. Defaults to FULL_MASK for hand-written components.
  */
-export declare function unsafeHtml<S>(accessor: ((s: S) => string) | string, mask?: number): Node[];
+export declare function unsafeHtml<S>(accessor: ((s: S) => string) | (() => string) | string, mask?: number): Node[];
 //# sourceMappingURL=unsafe-html.d.ts.map

package/dist/primitives/unsafe-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unsafe-html.d.ts","sourceRoot":"","sources":["../../src/primitives/unsafe-html.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CA8C1F"}
+{"version":3,"file":"unsafe-html.d.ts","sourceRoot":"","sources":["../../src/primitives/unsafe-html.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,EACtD,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,EAAE,CA8CR"}

package/dist/primitives/unsafe-html.js.map

@@ -1 +1 @@
-{"version":3,"file":"unsafe-html.js","sourceRoot":"","sources":["../../src/primitives/unsafe-html.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CAAI,QAAqC,EAAE,IAAa;IAChF,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAA;IAC1C,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAA;IACnC,MAAM,SAAS,GAAG,IAAI,IAAI,SAAS,CAAA;IAEnC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IAClD,IAAI,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAU,CAAC,CAAA;IAC1C,IAAI,YAAY,GAAW,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAE7D,MAAM,KAAK,GAAoB;QAC7B,IAAI,EAAE,SAAS;QACf,SAAS,CAAC,KAAc;YACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAU,CAAC,CAAA;YACpC,8DAA8D;YAC9D,gEAAgE;YAChE,sDAAsD;YACtD,IAAI,OAAO,KAAK,WAAW;gBAAE,OAAM;YAEnC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAA;YAChC,IAAI,CAAC,MAAM;gBAAE,OAAM;YAEnB,MAAM,QAAQ,GAAG,YAAY,CAAA;YAC7B,YAAY,GAAG,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC7C,WAAW,GAAG,OAAO,CAAA;YAErB,gEAAgE;YAChE,kEAAkE;YAClE,4DAA4D;YAC5D,kEAAkE;YAClE,qCAAqC;YACrC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAA;YAC9B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YAChC,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,IAAI,CAAC,UAAU;oBAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YACxD,CAAC;QACH,CAAC;KACF,CAAA;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAElB,OAAO,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAiD,EAAE,IAAY;IACvF,oEAAoE;IACpE,oEAAoE;IACpE,iEAAiE;IACjE,sEAAsE;IACtE,0DAA0D;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAA;AAC/D,CAAC","sourcesContent":["import type { StructuralBlock } from '../structural.js'\nimport { getRenderContext } from '../render-context.js'\nimport { FULL_MASK } from '../update-loop.js'\n\n/**\n * Insert raw HTML into the DOM tree.\n *\n * **Security.** The caller is responsible for sanitizing `html`. Never\n * interpolate unsanitized user input — this is the XSS escape hatch and\n * the name carries the warning deliberately.\n *\n * **Opaque to the framework.** The parsed subtree is treated as a black\n * box by LLui — no bindings, events, `each`, `show`, or `child` inside\n * it will be discovered or driven by the framework. Use element helpers\n * for anything that needs to react to state or dispatch messages.\n *\n * **Static form.** `unsafeHtml('<b>hi</b>')` parses once at view time\n * and returns the parsed nodes. Zero reactive overhead.\n *\n * **Reactive form.** `unsafeHtml((s) => s.markdownHtml)` registers a\n * structural block that re-parses when the returned string differs\n * (strict `===`) from the previous value. Unchanged strings short-\n * circuit — existing DOM identity (focus, selection, listeners\n * attached outside LLui) is preserved.\n *\n * **Mask hint.** The second parameter mirrors `text()`: the compiler\n * passes a precise mask derived from which state fields the accessor\n * reads. Phase 2 / Phase 1 skip the reconcile when no interesting bit\n * is set. Defaults to FULL_MASK for hand-written components.\n */\nexport function unsafeHtml<S>(accessor: ((s: S) => string) | string, mask?: number): Node[] {\n  const ctx = getRenderContext('unsafeHtml')\n  if (typeof accessor === 'string') {\n    return parseHtmlToNodes(ctx, accessor)\n  }\n\n  const blocks = ctx.structuralBlocks\n  const blockMask = mask ?? FULL_MASK\n\n  const anchor = ctx.dom.createComment('unsafeHtml')\n  let currentHtml = accessor(ctx.state as S)\n  let currentNodes: Node[] = parseHtmlToNodes(ctx, currentHtml)\n\n  const block: StructuralBlock = {\n    mask: blockMask,\n    reconcile(state: unknown) {\n      const newHtml = accessor(state as S)\n      // Identity short-circuit — don't rebuild the subtree when the\n      // author handed us the same string. Preserves focus, selection,\n      // and any listeners outside LLui's view of the world.\n      if (newHtml === currentHtml) return\n\n      const parent = anchor.parentNode\n      if (!parent) return\n\n      const oldNodes = currentNodes\n      currentNodes = parseHtmlToNodes(ctx, newHtml)\n      currentHtml = newHtml\n\n      // The anchor sits immediately before the current node range, so\n      // `anchor.nextSibling` is the first old node (or whatever follows\n      // when the old list is empty). Insert new nodes there, then\n      // remove the old ones — matches `branch()`'s enter/leave order so\n      // transitions can inspect both sets.\n      const ref = anchor.nextSibling\n      for (const node of currentNodes) {\n        parent.insertBefore(node, ref)\n      }\n      for (const node of oldNodes) {\n        if (node.parentNode) node.parentNode.removeChild(node)\n      }\n    },\n  }\n  blocks.push(block)\n\n  return [anchor, ...currentNodes]\n}\n\nfunction parseHtmlToNodes(ctx: import('../render-context.js').RenderContext, html: string): Node[] {\n  // Delegates to the env — jsdom/linkedom adapters may implement this\n  // via DOMParser instead of the browser `<template>` trick, but both\n  // return an inert DocumentFragment that doesn't execute scripts.\n  // Snapshot — moving nodes to a parent drains fragment.childNodes, but\n  // callers hold this array and we iterate it on reconcile.\n  return Array.from(ctx.dom.parseHtmlFragment(html).childNodes)\n}\n"]}
+{"version":3,"file":"unsafe-html.js","sourceRoot":"","sources":["../../src/primitives/unsafe-html.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CACxB,QAAsD,EACtD,IAAa;IAEb,MAAM,GAAG,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAA;IAC1C,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAA;IACnC,MAAM,SAAS,GAAG,IAAI,IAAI,SAAS,CAAA;IAEnC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IAClD,IAAI,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAU,CAAC,CAAA;IAC1C,IAAI,YAAY,GAAW,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IAE7D,MAAM,KAAK,GAAoB;QAC7B,IAAI,EAAE,SAAS;QACf,SAAS,CAAC,KAAc;YACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAU,CAAC,CAAA;YACpC,8DAA8D;YAC9D,gEAAgE;YAChE,sDAAsD;YACtD,IAAI,OAAO,KAAK,WAAW;gBAAE,OAAM;YAEnC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAA;YAChC,IAAI,CAAC,MAAM;gBAAE,OAAM;YAEnB,MAAM,QAAQ,GAAG,YAAY,CAAA;YAC7B,YAAY,GAAG,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC7C,WAAW,GAAG,OAAO,CAAA;YAErB,gEAAgE;YAChE,kEAAkE;YAClE,4DAA4D;YAC5D,kEAAkE;YAClE,qCAAqC;YACrC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAA;YAC9B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YAChC,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,IAAI,CAAC,UAAU;oBAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YACxD,CAAC;QACH,CAAC;KACF,CAAA;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAElB,OAAO,CAAC,MAAM,EAAE,GAAG,YAAY,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAiD,EAAE,IAAY;IACvF,oEAAoE;IACpE,oEAAoE;IACpE,iEAAiE;IACjE,sEAAsE;IACtE,0DAA0D;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAA;AAC/D,CAAC","sourcesContent":["import type { StructuralBlock } from '../structural.js'\nimport { getRenderContext } from '../render-context.js'\nimport { FULL_MASK } from '../update-loop.js'\n\n/**\n * Insert raw HTML into the DOM tree.\n *\n * **Security.** The caller is responsible for sanitizing `html`. Never\n * interpolate unsanitized user input — this is the XSS escape hatch and\n * the name carries the warning deliberately.\n *\n * **Opaque to the framework.** The parsed subtree is treated as a black\n * box by LLui — no bindings, events, `each`, `show`, or `child` inside\n * it will be discovered or driven by the framework. Use element helpers\n * for anything that needs to react to state or dispatch messages.\n *\n * **Static form.** `unsafeHtml('<b>hi</b>')` parses once at view time\n * and returns the parsed nodes. Zero reactive overhead.\n *\n * **Reactive form.** `unsafeHtml((s) => s.markdownHtml)` registers a\n * structural block that re-parses when the returned string differs\n * (strict `===`) from the previous value. Unchanged strings short-\n * circuit — existing DOM identity (focus, selection, listeners\n * attached outside LLui) is preserved.\n *\n * **Mask hint.** The second parameter mirrors `text()`: the compiler\n * passes a precise mask derived from which state fields the accessor\n * reads. Phase 2 / Phase 1 skip the reconcile when no interesting bit\n * is set. Defaults to FULL_MASK for hand-written components.\n */\nexport function unsafeHtml<S>(\n  accessor: ((s: S) => string) | (() => string) | string,\n  mask?: number,\n): Node[] {\n  const ctx = getRenderContext('unsafeHtml')\n  if (typeof accessor === 'string') {\n    return parseHtmlToNodes(ctx, accessor)\n  }\n\n  const blocks = ctx.structuralBlocks\n  const blockMask = mask ?? FULL_MASK\n\n  const anchor = ctx.dom.createComment('unsafeHtml')\n  let currentHtml = accessor(ctx.state as S)\n  let currentNodes: Node[] = parseHtmlToNodes(ctx, currentHtml)\n\n  const block: StructuralBlock = {\n    mask: blockMask,\n    reconcile(state: unknown) {\n      const newHtml = accessor(state as S)\n      // Identity short-circuit — don't rebuild the subtree when the\n      // author handed us the same string. Preserves focus, selection,\n      // and any listeners outside LLui's view of the world.\n      if (newHtml === currentHtml) return\n\n      const parent = anchor.parentNode\n      if (!parent) return\n\n      const oldNodes = currentNodes\n      currentNodes = parseHtmlToNodes(ctx, newHtml)\n      currentHtml = newHtml\n\n      // The anchor sits immediately before the current node range, so\n      // `anchor.nextSibling` is the first old node (or whatever follows\n      // when the old list is empty). Insert new nodes there, then\n      // remove the old ones — matches `branch()`'s enter/leave order so\n      // transitions can inspect both sets.\n      const ref = anchor.nextSibling\n      for (const node of currentNodes) {\n        parent.insertBefore(node, ref)\n      }\n      for (const node of oldNodes) {\n        if (node.parentNode) node.parentNode.removeChild(node)\n      }\n    },\n  }\n  blocks.push(block)\n\n  return [anchor, ...currentNodes]\n}\n\nfunction parseHtmlToNodes(ctx: import('../render-context.js').RenderContext, html: string): Node[] {\n  // Delegates to the env — jsdom/linkedom adapters may implement this\n  // via DOMParser instead of the browser `<template>` trick, but both\n  // return an inert DocumentFragment that doesn't execute scripts.\n  // Snapshot — moving nodes to a parent drains fragment.childNodes, but\n  // callers hold this array and we iterate it on reconcile.\n  return Array.from(ctx.dom.parseHtmlFragment(html).childNodes)\n}\n"]}

package/dist/types.d.ts

@@ -288,11 +288,19 @@ export interface TransitionOptions {
 }
 interface BranchOptionsBase extends TransitionOptions {
 }
+/**
+ * Discriminant accessor — reads a string-keyed value either from the
+ * current state (`(s) => …`) or from a closed-over item accessor /
+ * memo (`() => item.kind()`). Both forms re-evaluate on every commit.
+ * The zero-arg form is the canonical shape for branching on per-row
+ * fields inside an `each.render` callback.
+ */
+type Discriminant<S, K extends string> = ((s: S) => K) | (() => K);
 /**
  * All cases covered by `cases` — no default allowed (would be dead code).
  */
 type BranchOptionsExhaustive<S, M, K extends string> = BranchOptionsBase & {
-    on: (s: S) => K;
+    on: Discriminant<S, K>;
     cases: {
         [P in K]: (h: View<S, M>) => Node[];
     };
@@ -302,7 +310,7 @@ type BranchOptionsExhaustive<S, M, K extends string> = BranchOptionsBase & {
  * `cases` may cover some but not all keys; `default` handles the rest.
  */
 type BranchOptionsNonExhaustive<S, M, K extends string> = BranchOptionsBase & {
-    on: (s: S) => K;
+    on: Discriminant<S, K>;
     cases?: {
         [P in K]?: (h: View<S, M>) => Node[];
     };
@@ -316,7 +324,7 @@ type BranchOptionsNonExhaustive<S, M, K extends string> = BranchOptionsBase & {
  * `on`'s return type to a literal union.
  */
 type BranchOptionsWide<S, M> = BranchOptionsBase & {
-    on: (s: S) => string;
+    on: Discriminant<S, string>;
     cases?: Record<string, (h: View<S, M>) => Node[]>;
     default?: (h: View<S, M>) => Node[];
 };
@@ -336,7 +344,15 @@ type BranchOptionsWide<S, M> = BranchOptionsBase & {
  */
 export type BranchOptions<S, M = unknown, K extends string = string> = string extends K ? BranchOptionsWide<S, M> : BranchOptionsExhaustive<S, M, K> | BranchOptionsNonExhaustive<S, M, K>;
 export interface ShowOptions<S, M = unknown> extends TransitionOptions {
-    when: (s: S) => boolean;
+    /**
+     * Predicate evaluated on every commit. `(s) => …` reads from
+     * component state; `() => …` (zero-arg) reads from a closed-over
+     * source — typically `item.field()` inside an `each.render`
+     * callback. Both forms are reactive: the predicate runs against
+     * each new state and the rendered subtree mounts/unmounts on the
+     * boolean transition.
+     */
+    when: ((s: S) => boolean) | (() => boolean);
     render: (h: View<S, M>) => Node[];
     fallback?: (h: View<S, M>) => Node[];
 }
@@ -350,7 +366,13 @@ export interface ShowOptions<S, M = unknown> extends TransitionOptions {
  * one-shot current-state read.
  */
 export interface ScopeOptions<S, M = unknown> extends TransitionOptions {
-    on: (s: S) => string;
+    /**
+     * Key accessor evaluated on every commit. `(s) => …` reads from
+     * component state; `() => …` (zero-arg) reads from a closed-over
+     * source. The render callback rebuilds whenever the returned key
+     * changes — fresh lifetime, fresh bindings.
+     */
+    on: ((s: S) => string) | (() => string);
     render: (h: View<S, M>) => Node[];
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE","sourcesContent":["// ── Component Definition ──────────────────────────────────────────\n\nimport type { View } from './view-helpers.js'\nimport type { StructuralBlock } from './structural.js'\nimport type { ComponentInstance } from './update-loop.js'\nimport type { DisposerEvent } from './tracking/disposer-log.js'\n\nexport interface ComponentDef<S, M, E = never, D = void> {\n  name: string\n  init: (data: D) => [S, E[]]\n  update: (state: S, msg: M) => [S, E[]]\n  view: (h: View<S, M>) => Node[]\n  onEffect?: (ctx: { effect: E; send: Send<M>; signal: AbortSignal }) => void\n\n  // Level 2 composition\n  propsMsg?: (props: Record<string, unknown>) => M\n  receives?: Record<string, (params: unknown) => M>\n\n  /** @internal Compiler-injected */\n  __dirty?: (oldState: S, newState: S) => number | [number, number]\n  /** @internal Compiler-injected */\n  __renderToString?: (state: S) => string\n  /** @internal Compiler-injected */\n  __msgSchema?: object\n  /** @internal Compiler-injected; keyed by Msg discriminant → annotations. See agent spec §5.1. */\n  __msgAnnotations?: Record<\n    string,\n    {\n      intent: string | null\n      alwaysAffordable: boolean\n      requiresConfirm: boolean\n      humanOnly: boolean\n    }\n  >\n  /** @internal Compiler-emitted; one entry per send() call site in view(). See agent spec §5.2. */\n  __bindingDescriptors?: Array<{ variant: string }>\n  /** @internal Compiler-injected; 32-char hex SHA-256 of schemas + annotations. See agent spec §12.3. */\n  __schemaHash?: string\n  /** @internal Compiler-injected — maps top-level state field → dirty-mask bit(s) */\n  __maskLegend?: Record<string, number>\n  /** @internal Compiler-injected — source-file location of the component() call */\n  __componentMeta?: { file: string; line: number }\n  /** @internal Compiler-injected — shape of the State type (for introspection) */\n  __stateSchema?: object\n  /** @internal Compiler-injected — Effect union schema (for introspection) */\n  __effectSchema?: object\n  /** @internal Compiler-injected — replaces generic Phase 1 + Phase 2 loop */\n  __update?: (\n    state: S,\n    dirty: number,\n    bindings: Binding[],\n    blocks: StructuralBlock[],\n    bindingsBeforePhase1: number,\n  ) => void\n  /** @internal Compiler-injected — per-message-type specialized handlers.\n   *  Bypass the entire processMessages pipeline for single-message updates. */\n  __handlers?: Record<string, (inst: object, msg: unknown) => [S, E[]]>\n}\n\nexport type Send<M> = (msg: M) => void\n\n/**\n * Type-erased component definition for use at module boundaries where\n * the consumer's `S`, `M`, `E` are internal and invisible to the caller.\n *\n * Why this exists: `ComponentDef<S, M, E, D>` uses property syntax for\n * its callable fields (`init: (data: D) => ...`), and TypeScript\n * checks property syntax with strict (contravariant) variance. That's\n * the right call for user-facing type safety when authoring a\n * component (a narrower `Msg` type can't accidentally satisfy the\n * `update`'s param), but it means `ComponentDef<MyState, MyMsg, MyEffect, MyData>`\n * is NOT structurally assignable to `ComponentDef<unknown, unknown, unknown, unknown>`\n * — the `init: (data: MyData) => ...` field is contravariant in `MyData`,\n * so widening to `unknown` is rejected.\n *\n * `AnyComponentDef` (and `LazyDef<D>` below) declare the same fields\n * using **method syntax** (`init(data: D): ...`), which TypeScript\n * checks bivariantly. Concrete `ComponentDef<S, M, E, D>` assigns into\n * these structurally without any `widenDef` helper at the callsite.\n *\n * Used by every API that accepts an opaque component definition at a\n * module boundary:\n *\n * - `child({ def })`\n * - `lazy({ loader })` — returns `LazyDef<D>` so the loader's `D` survives\n * - `createOnRenderClient({ Layout })` (from `@llui/vike`)\n * - `createOnRenderHtml({ Layout })` (from `@llui/vike`)\n *\n * The `D` parameter is `unknown` here — `child()` doesn't pass init\n * data through, and `Layout` callers pass route-supplied data whose\n * shape is unknown at the type-erased boundary. Use `LazyDef<D>` when\n * you need to preserve the init data shape (the lazy loader case).\n */\nexport interface AnyComponentDef {\n  name: string\n  init(data: unknown): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __msgAnnotations?: unknown\n  __bindingDescriptors?: unknown\n  __schemaHash?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Type-erased component definition for use at module boundaries where the\n * loaded component's S, M, E are internal and invisible to the caller.\n * Only `D` (init data) survives because the caller provides it.\n *\n * `ComponentDef<S, M, E, D>` is structurally assignable to `LazyDef<D>`\n * for any S, M, E — `view: (h: unknown) => Node[]` accepts any View via\n * contravariance, and all other fields widen to `unknown` return types.\n *\n * Used by `lazy()` as the loader's return type. Use `AnyComponentDef`\n * (above) when D is also opaque — most other adapter-layer APIs.\n */\nexport interface LazyDef<D = void> {\n  name: string\n  // Method syntax — TypeScript checks methods bivariantly, so\n  // ComponentDef<S, M, E, D>'s concrete (state: S, msg: M) => ...\n  // assigns here even though S/M ≠ unknown. Property syntax would\n  // be contravariant and reject the assignment.\n  init(data: D): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __msgAnnotations?: unknown\n  __bindingDescriptors?: unknown\n  __schemaHash?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Maps a value shape to a reactive-props shape: every field becomes an accessor\n * `(s: S) => V`. Use for Level-1 view function signatures.\n *\n * ```ts\n * type ToolbarData = { tools: Tool[]; theme: 'light' | 'dark' }\n *\n * export function toolbar<S>(props: Props<ToolbarData, S>, send: Send<Msg>) {\n *   return [div({ class: props.theme }, [each({ items: props.tools, ... })])]\n * }\n *\n * // Caller — TypeScript enforces per-field accessors; passing a raw value errors:\n * toolbar({ tools: (s: State) => s.tools, theme: (s) => s.theme }, send)\n * ```\n */\nexport type Props<T, S> = {\n  [K in keyof T]: (s: S) => T[K]\n}\n\n// ── App Handle ────────────────────────────────────────────────────\n\nexport interface AppHandle {\n  dispose(): void\n  flush(): void\n  /**\n   * Dispatch a message into the mounted instance from outside its\n   * normal view-bound `send` channel. Useful for adapter layers that\n   * need to push updates into a long-lived instance — e.g.\n   * `@llui/vike`'s persistent-layout chain pushes layout-data updates\n   * into surviving layer instances on client navigation when their\n   * `propsMsg` translates the new data into a state-update message.\n   *\n   * Messages are queued through the same path as `view`-side `send`\n   * calls — they batch into the next microtask and process via the\n   * normal update loop. Calling `send` after `dispose` is a no-op.\n   */\n  send(msg: unknown): void\n  /**\n   * Read the current state snapshot. Safe to call from anywhere —\n   * event handlers, async callbacks, adapter `send` wrappers, or any\n   * imperative context where the render context is not live.\n   *\n   * Unlike `sample()` (a view primitive that requires an active\n   * render context and throws outside of `view()`), `getState` is\n   * the sanctioned escape hatch for \"I need to know the current\n   * state to decide what to dispatch.\" Typical shape:\n   *\n   * ```ts\n   * const handle = mountApp(root, MyApp)\n   * container.addEventListener('drop', () => {\n   *   const { mode } = handle.getState() as AppState\n   *   if (mode === 'drag') handle.send({ type: 'commit' })\n   * })\n   * ```\n   *\n   * Throws after `dispose()` — stale reads are silent bugs; a thrown\n   * error pinpoints the callsite that forgot to detach.\n   *\n   * The return type is `unknown` because `AppHandle` is state-type\n   * erased at this boundary; cast to your app's state type at the\n   * call site.\n   */\n  getState(): unknown\n  /**\n   * Register a listener called synchronously after every update cycle\n   * completes. The listener receives the new state. Returns an\n   * unsubscribe function. Safe after dispose (no-op; returns a no-op\n   * unsubscribe). See agent spec §10.5 (state-update frames).\n   */\n  subscribe(listener: (state: unknown) => void): () => void\n  /**\n   * Snapshot the Msg variants currently dispatchable from rendered UI.\n   * Each entry corresponds to one or more event-handler bindings the\n   * compiler tagged with literal `send({type: '<variant>'})` calls;\n   * the registry tracks live mounts via lifetime refcounts so the\n   * snapshot reflects what the user can click *right now*, not the\n   * static catalogue of every variant the app could ever accept.\n   *\n   * Used by `@llui/agent` to populate `list_actions`. Apps that don't\n   * use the LLui compiler tagger pass (or whose views contain no\n   * literal sends) get an empty array — agents fall back to the Msg\n   * schema for affordance discovery.\n   */\n  getBindingDescriptors(): Array<{ variant: string }>\n  /**\n   * Hot-swap the component's `update` function (and optionally\n   * `onEffect`) without rebuilding the DOM. Pending messages are\n   * drained against the OLD `update` first so a half-applied\n   * transition can't leave the state ill-formed; subsequent\n   * dispatches go through the new function.\n   *\n   * This is the lightweight HMR escape hatch for cases where the\n   * full `replaceComponent` flow (in `@llui/dom/hmr`) is overkill —\n   * pure `update.ts` edits don't change the view, so disposing the\n   * root lifetime and re-running the view just to install a new\n   * function is wasteful and loses focus / scroll / transient DOM\n   * state. Wire it via `import.meta.hot`:\n   *\n   * ```ts\n   * // main.ts\n   * const handle = mountApp(root, App)\n   * if (import.meta.hot) {\n   *   import.meta.hot.accept('./app/update', (mod) => {\n   *     if (mod) handle.swapUpdate(mod.update)\n   *   })\n   * }\n   * ```\n   *\n   * Caveats:\n   *   - Doesn't compensate for State shape changes — if the new\n   *     `update` reads a field the old state doesn't have, you'll\n   *     see runtime errors. Hard-reload after structural state\n   *     changes.\n   *   - Doesn't swap `view` or compiler-emitted `__update`/`__dirty`\n   *     — for those, prefer the auto-injected component-level HMR\n   *     accept callback (which routes through `replaceComponent`).\n   */\n  swapUpdate(\n    newUpdate: (state: unknown, msg: unknown) => [unknown, unknown[]],\n    newOnEffect?: unknown,\n  ): void\n  /**\n   * Run the reducer in isolation against the current state. Returns\n   * `[newState, effects]` — the reducer's literal output without any\n   * commit, flush, or effect-handler invocation. Used by the agent's\n   * `would_dispatch` tool to predict what a candidate dispatch would\n   * do before committing to it.\n   *\n   * Pure-reducer assumption: TEA mandates `update` be pure. LLui's\n   * runtime treats it that way too (no speculative re-runs for any\n   * other reason). Apps whose reducers branch on `Date.now()` or\n   * read `localStorage` will see prediction drift from real dispatch\n   * by exactly that amount of impurity — surface as documented at\n   * the agent's call site, not silently corrected here.\n   *\n   * **No effects fire.** Effect descriptors are returned for the\n   * agent to inspect; `onEffect` is not called. This is the entire\n   * point of the API.\n   */\n  runReducer(msg: unknown): { state: unknown; effects: unknown[] } | null\n}\n\n// ── Lifetime ─────────────────────────────────────────────────────────\n\nexport interface Lifetime {\n  id: number\n  parent: Lifetime | null\n  children: Lifetime[]\n  disposers: Array<() => void>\n  bindings: Binding[]\n  /** Per-item updaters — called directly by each() when item changes, bypassing Phase 2 */\n  itemUpdaters: Array<() => void>\n  /**\n   * @internal dev-only back-reference to the owning ComponentInstance.\n   * Populated on the root scope by `installDevTools` so `disposeLifetime`\n   * can walk up the scope chain and emit DisposerEvents into the\n   * instance's `_disposerLog`. Undefined in production.\n   */\n  instance?: ComponentInstance\n  /**\n   * @internal dev-only cause hint. Structural primitives (branch, each,\n   * child, mountApp teardown) set this field immediately before calling\n   * `disposeLifetime`; the dispose path reads it once to stamp the emitted\n   * DisposerEvent. Left undefined, `disposeLifetime` falls back to\n   * `'component-unmount'`. Undefined in production.\n   */\n  disposalCause?: DisposerEvent['cause']\n  /** @internal dev-only — populated by structural primitives for scope-tree classification */\n  _kind?: 'root' | 'show' | 'each' | 'branch' | 'scope' | 'child' | 'portal' | 'foreign'\n}\n\nexport interface LifetimeNode {\n  scopeId: string\n  kind: 'root' | 'show' | 'each' | 'branch' | 'scope' | 'child' | 'portal' | 'foreign'\n  active: boolean\n  children: LifetimeNode[]\n}\n\n// ── Binding ───────────────────────────────────────────────────────\n\n/**\n * Binding output kinds.\n *\n * `'text' | 'prop' | 'attr' | 'class' | 'style'` write their accessor's\n * return value to the DOM. `'effect'` is a side-effect-only watcher:\n * the accessor is invoked every Phase 2 tick its mask is hit, but its\n * return value is discarded and `applyBinding` is a no-op. Used by\n * `child()` to fire the prop-diff/propsMsg cascade on parent updates\n * without the cost of stringifying the returned props bag onto a\n * detached anchor node every render.\n */\nexport type BindingKind = 'text' | 'prop' | 'attr' | 'class' | 'style' | 'effect'\n\nexport interface Binding {\n  mask: number\n  accessor: (state: unknown) => unknown\n  lastValue: unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  ownerLifetime: Lifetime\n  perItem: boolean\n  dead: boolean\n}\n\n// ── Structural Primitives ─────────────────────────────────────────\n\nexport interface TransitionOptions {\n  enter?: (nodes: Node[]) => void | Promise<void>\n  leave?: (nodes: Node[]) => void | Promise<void>\n  onTransition?: (ctx: { entering: Node[]; leaving: Node[]; parent: Node }) => void | Promise<void>\n}\n\ninterface BranchOptionsBase extends TransitionOptions {\n  /**\n   * @internal Set by `show()` / `scope()` sugar when delegating to\n   * `branch()`, so the dev-only disposer log can report `'show-hide'` /\n   * `'scope-rebuild'` instead of the default `'branch-swap'` for the\n   * leaving arm. User code should not set this directly.\n   */\n  __disposalCause?: DisposerEvent['cause']\n  /** @internal Compiler-injected mask of paths read by `on`. */\n  __mask?: number\n}\n\n/**\n * All cases covered by `cases` — no default allowed (would be dead code).\n */\ntype BranchOptionsExhaustive<S, M, K extends string> = BranchOptionsBase & {\n  on: (s: S) => K\n  cases: { [P in K]: (h: View<S, M>) => Node[] }\n  default?: never\n}\n\n/**\n * `cases` may cover some but not all keys; `default` handles the rest.\n */\ntype BranchOptionsNonExhaustive<S, M, K extends string> = BranchOptionsBase & {\n  on: (s: S) => K\n  cases?: { [P in K]?: (h: View<S, M>) => Node[] }\n  default: (h: View<S, M>) => Node[]\n}\n\n/**\n * `on` returns a wide `string` — exhaustiveness cannot be verified at\n * compile time (the key domain is infinite). Lenient: `default` is\n * optional so existing call sites that predate exhaustiveness typing\n * continue to compile. Authors who want the gate opt in by narrowing\n * `on`'s return type to a literal union.\n */\ntype BranchOptionsWide<S, M> = BranchOptionsBase & {\n  on: (s: S) => string\n  cases?: Record<string, (h: View<S, M>) => Node[]>\n  default?: (h: View<S, M>) => Node[]\n}\n\n/**\n * Options for `branch()`.\n *\n * When `on` returns a literal string union (e.g. `'idle' | 'loading'\n * | 'done'`), TypeScript enforces exhaustiveness: either every union\n * member has a case (and `default` is disallowed as unreachable), or\n * `default` is required to cover the remainder. When `on` returns a\n * wide `string`, `default` stays optional — exhaustiveness isn't\n * meaningful for an unbounded domain.\n *\n * `cases` is optional when `default` is present; `branch({ on, default })`\n * is the canonical dynamic-rebuild shape — `scope()` sugar wraps\n * exactly this form.\n */\nexport type BranchOptions<S, M = unknown, K extends string = string> = string extends K\n  ? BranchOptionsWide<S, M>\n  : BranchOptionsExhaustive<S, M, K> | BranchOptionsNonExhaustive<S, M, K>\n\nexport interface ShowOptions<S, M = unknown> extends TransitionOptions {\n  when: (s: S) => boolean\n  render: (h: View<S, M>) => Node[]\n  fallback?: (h: View<S, M>) => Node[]\n}\n\n/**\n * Options for `scope()` — rebuilds a subtree when `on(state)` changes.\n *\n * Sugar over `branch({ on, cases: {}, default: render, __disposalCause: 'scope-rebuild' })`.\n * Use when the key is dynamic (e.g. an epoch counter bumped from the\n * outside) and you want a fresh arm — fresh lifetime, fresh bindings —\n * each time it changes. Combine with `sample()` inside `render` for a\n * one-shot current-state read.\n */\nexport interface ScopeOptions<S, M = unknown> extends TransitionOptions {\n  on: (s: S) => string\n  render: (h: View<S, M>) => Node[]\n  /** @internal Compiler-injected mask of paths read by `on`. */\n  __mask?: number\n}\n\n/**\n * Options for `each()`. The inherited `enter` / `leave` callbacks fire **per item**:\n * `enter(nodes)` runs after an item's DOM is inserted (including initial mount);\n * `leave(nodes)` runs before an item's DOM is removed and may return a Promise\n * to hold the DOM until the animation resolves. Setting `leave` disables the\n * bulk-clear / full-replace fast paths.\n */\n/**\n * Per-item accessor. Two access forms:\n * - `item.field` — shorthand, returns accessor for `item.current[field]`\n * - `item(t => t.expr)` — computed expressions\n *\n * In both cases the returned value is a `() => V` accessor.\n * Invoke it (`item.field()`) to read the current value imperatively.\n */\nexport type ItemAccessor<T> = {\n  <R>(selector: (t: T) => R): () => R\n} & {\n  [K in keyof T]-?: () => T[K]\n} & {\n  /**\n   * Read the whole current item. Needed when T is a primitive (where the\n   * field-map branch collapses to method names like `toString`) or when\n   * you want to sample the entire record rather than a single field.\n   *\n   * Shadows any literal `current` field on T — if T has such a field,\n   * use `item(r => r.current)` to disambiguate.\n   */\n  current(): T\n}\n\nexport interface EachOptions<S, T, M = unknown> extends TransitionOptions {\n  items: (s: S) => T[]\n  key: (item: T) => string | number\n  render: (opts: {\n    send: Send<M>\n    item: ItemAccessor<T>\n    /**\n     * Plain (non-Proxy) accessor factory. Compiler-output path; avoid in user code\n     * (use `item.field` / `item(fn)` — more ergonomic and bypasses Proxy when compiled).\n     */\n    acc: <R>(selector: (t: T) => R) => () => R\n    index: () => number\n    /**\n     * The component's View bag (`h.text`, `h.show`, `h.branch`,\n     * `h.scope`, `h.sample`, …). Each-render callers used to reach\n     * for the top-level imports; the bag form is symmetric with how\n     * `branch.cases[k]`, `show.render`, and `scope.render` receive it.\n     * Both still work — destructure whichever is more convenient.\n     */\n    h: View<S, M>\n    /** @internal Compiler-injected — entry reference for row factory */\n    entry?: Record<string, unknown>\n  }) => Node[]\n}\n\nexport interface PortalOptions {\n  target: HTMLElement | string\n  render: () => Node[]\n}\n\nexport interface ForeignOptions<S, M, T extends Record<string, unknown>, Instance> {\n  /**\n   * Construct the imperative instance. Can be async — return a\n   * `Promise<Instance>` to defer construction until e.g. a dynamic\n   * `import()` resolves. While the promise is pending:\n   *\n   *   - The container element is in the DOM immediately (so layout\n   *     doesn't shift when the instance arrives).\n   *   - `sync` is NOT called. State changes are tracked by the\n   *     primitive and the latest props are applied as the initial\n   *     sync right after the promise resolves.\n   *   - If the owning scope disposes before the promise resolves,\n   *     `destroy(instance)` runs on resolution — no matter how long\n   *     the promise takes.\n   */\n  mount: (ctx: { container: HTMLElement; send: Send<M> }) => Instance | Promise<Instance>\n  props: (s: S) => T\n  sync:\n    | ((ctx: { instance: Instance; props: T; prev: T | undefined }) => void)\n    | {\n        [K in keyof T]?: (ctx: { instance: Instance; value: T[K]; prev: T[K] | undefined }) => void\n      }\n  destroy: (instance: Instance) => void\n  container?: { tag?: string; attrs?: Record<string, string> }\n}\n\nexport interface ChildOptions<S, ChildM> {\n  // Type-erased via AnyComponentDef so callers can pass any concrete\n  // ComponentDef<S, M, E, D> without a widening helper. The runtime\n  // narrows the message shape via the user-supplied `onMsg` callback,\n  // which keeps `ChildM` typed at this boundary even though the def\n  // itself is opaque.\n  def: AnyComponentDef\n  key: string | number\n  props: (s: S) => Record<string, unknown>\n  onMsg?: (msg: ChildM) => unknown | null\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE","sourcesContent":["// ── Component Definition ──────────────────────────────────────────\n\nimport type { View } from './view-helpers.js'\nimport type { StructuralBlock } from './structural.js'\nimport type { ComponentInstance } from './update-loop.js'\nimport type { DisposerEvent } from './tracking/disposer-log.js'\n\nexport interface ComponentDef<S, M, E = never, D = void> {\n  name: string\n  init: (data: D) => [S, E[]]\n  update: (state: S, msg: M) => [S, E[]]\n  view: (h: View<S, M>) => Node[]\n  onEffect?: (ctx: { effect: E; send: Send<M>; signal: AbortSignal }) => void\n\n  // Level 2 composition\n  propsMsg?: (props: Record<string, unknown>) => M\n  receives?: Record<string, (params: unknown) => M>\n\n  /** @internal Compiler-injected */\n  __dirty?: (oldState: S, newState: S) => number | [number, number]\n  /** @internal Compiler-injected */\n  __renderToString?: (state: S) => string\n  /** @internal Compiler-injected */\n  __msgSchema?: object\n  /** @internal Compiler-injected; keyed by Msg discriminant → annotations. See agent spec §5.1. */\n  __msgAnnotations?: Record<\n    string,\n    {\n      intent: string | null\n      alwaysAffordable: boolean\n      requiresConfirm: boolean\n      humanOnly: boolean\n    }\n  >\n  /** @internal Compiler-emitted; one entry per send() call site in view(). See agent spec §5.2. */\n  __bindingDescriptors?: Array<{ variant: string }>\n  /** @internal Compiler-injected; 32-char hex SHA-256 of schemas + annotations. See agent spec §12.3. */\n  __schemaHash?: string\n  /** @internal Compiler-injected — maps top-level state field → dirty-mask bit(s) */\n  __maskLegend?: Record<string, number>\n  /** @internal Compiler-injected — source-file location of the component() call */\n  __componentMeta?: { file: string; line: number }\n  /** @internal Compiler-injected — shape of the State type (for introspection) */\n  __stateSchema?: object\n  /** @internal Compiler-injected — Effect union schema (for introspection) */\n  __effectSchema?: object\n  /** @internal Compiler-injected — replaces generic Phase 1 + Phase 2 loop */\n  __update?: (\n    state: S,\n    dirty: number,\n    bindings: Binding[],\n    blocks: StructuralBlock[],\n    bindingsBeforePhase1: number,\n  ) => void\n  /** @internal Compiler-injected — per-message-type specialized handlers.\n   *  Bypass the entire processMessages pipeline for single-message updates. */\n  __handlers?: Record<string, (inst: object, msg: unknown) => [S, E[]]>\n}\n\nexport type Send<M> = (msg: M) => void\n\n/**\n * Type-erased component definition for use at module boundaries where\n * the consumer's `S`, `M`, `E` are internal and invisible to the caller.\n *\n * Why this exists: `ComponentDef<S, M, E, D>` uses property syntax for\n * its callable fields (`init: (data: D) => ...`), and TypeScript\n * checks property syntax with strict (contravariant) variance. That's\n * the right call for user-facing type safety when authoring a\n * component (a narrower `Msg` type can't accidentally satisfy the\n * `update`'s param), but it means `ComponentDef<MyState, MyMsg, MyEffect, MyData>`\n * is NOT structurally assignable to `ComponentDef<unknown, unknown, unknown, unknown>`\n * — the `init: (data: MyData) => ...` field is contravariant in `MyData`,\n * so widening to `unknown` is rejected.\n *\n * `AnyComponentDef` (and `LazyDef<D>` below) declare the same fields\n * using **method syntax** (`init(data: D): ...`), which TypeScript\n * checks bivariantly. Concrete `ComponentDef<S, M, E, D>` assigns into\n * these structurally without any `widenDef` helper at the callsite.\n *\n * Used by every API that accepts an opaque component definition at a\n * module boundary:\n *\n * - `child({ def })`\n * - `lazy({ loader })` — returns `LazyDef<D>` so the loader's `D` survives\n * - `createOnRenderClient({ Layout })` (from `@llui/vike`)\n * - `createOnRenderHtml({ Layout })` (from `@llui/vike`)\n *\n * The `D` parameter is `unknown` here — `child()` doesn't pass init\n * data through, and `Layout` callers pass route-supplied data whose\n * shape is unknown at the type-erased boundary. Use `LazyDef<D>` when\n * you need to preserve the init data shape (the lazy loader case).\n */\nexport interface AnyComponentDef {\n  name: string\n  init(data: unknown): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __msgAnnotations?: unknown\n  __bindingDescriptors?: unknown\n  __schemaHash?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Type-erased component definition for use at module boundaries where the\n * loaded component's S, M, E are internal and invisible to the caller.\n * Only `D` (init data) survives because the caller provides it.\n *\n * `ComponentDef<S, M, E, D>` is structurally assignable to `LazyDef<D>`\n * for any S, M, E — `view: (h: unknown) => Node[]` accepts any View via\n * contravariance, and all other fields widen to `unknown` return types.\n *\n * Used by `lazy()` as the loader's return type. Use `AnyComponentDef`\n * (above) when D is also opaque — most other adapter-layer APIs.\n */\nexport interface LazyDef<D = void> {\n  name: string\n  // Method syntax — TypeScript checks methods bivariantly, so\n  // ComponentDef<S, M, E, D>'s concrete (state: S, msg: M) => ...\n  // assigns here even though S/M ≠ unknown. Property syntax would\n  // be contravariant and reject the assignment.\n  init(data: D): [unknown, unknown[]]\n  update(state: unknown, msg: unknown): [unknown, unknown[]]\n  view(h: unknown): Node[]\n  onEffect?: unknown\n  propsMsg?: unknown\n  receives?: unknown\n  __dirty?: unknown\n  __renderToString?: unknown\n  __msgSchema?: unknown\n  __msgAnnotations?: unknown\n  __bindingDescriptors?: unknown\n  __schemaHash?: unknown\n  __maskLegend?: unknown\n  __componentMeta?: unknown\n  __stateSchema?: unknown\n  __effectSchema?: unknown\n  __update?: unknown\n  __handlers?: unknown\n}\n\n/**\n * Maps a value shape to a reactive-props shape: every field becomes an accessor\n * `(s: S) => V`. Use for Level-1 view function signatures.\n *\n * ```ts\n * type ToolbarData = { tools: Tool[]; theme: 'light' | 'dark' }\n *\n * export function toolbar<S>(props: Props<ToolbarData, S>, send: Send<Msg>) {\n *   return [div({ class: props.theme }, [each({ items: props.tools, ... })])]\n * }\n *\n * // Caller — TypeScript enforces per-field accessors; passing a raw value errors:\n * toolbar({ tools: (s: State) => s.tools, theme: (s) => s.theme }, send)\n * ```\n */\nexport type Props<T, S> = {\n  [K in keyof T]: (s: S) => T[K]\n}\n\n// ── App Handle ────────────────────────────────────────────────────\n\nexport interface AppHandle {\n  dispose(): void\n  flush(): void\n  /**\n   * Dispatch a message into the mounted instance from outside its\n   * normal view-bound `send` channel. Useful for adapter layers that\n   * need to push updates into a long-lived instance — e.g.\n   * `@llui/vike`'s persistent-layout chain pushes layout-data updates\n   * into surviving layer instances on client navigation when their\n   * `propsMsg` translates the new data into a state-update message.\n   *\n   * Messages are queued through the same path as `view`-side `send`\n   * calls — they batch into the next microtask and process via the\n   * normal update loop. Calling `send` after `dispose` is a no-op.\n   */\n  send(msg: unknown): void\n  /**\n   * Read the current state snapshot. Safe to call from anywhere —\n   * event handlers, async callbacks, adapter `send` wrappers, or any\n   * imperative context where the render context is not live.\n   *\n   * Unlike `sample()` (a view primitive that requires an active\n   * render context and throws outside of `view()`), `getState` is\n   * the sanctioned escape hatch for \"I need to know the current\n   * state to decide what to dispatch.\" Typical shape:\n   *\n   * ```ts\n   * const handle = mountApp(root, MyApp)\n   * container.addEventListener('drop', () => {\n   *   const { mode } = handle.getState() as AppState\n   *   if (mode === 'drag') handle.send({ type: 'commit' })\n   * })\n   * ```\n   *\n   * Throws after `dispose()` — stale reads are silent bugs; a thrown\n   * error pinpoints the callsite that forgot to detach.\n   *\n   * The return type is `unknown` because `AppHandle` is state-type\n   * erased at this boundary; cast to your app's state type at the\n   * call site.\n   */\n  getState(): unknown\n  /**\n   * Register a listener called synchronously after every update cycle\n   * completes. The listener receives the new state. Returns an\n   * unsubscribe function. Safe after dispose (no-op; returns a no-op\n   * unsubscribe). See agent spec §10.5 (state-update frames).\n   */\n  subscribe(listener: (state: unknown) => void): () => void\n  /**\n   * Snapshot the Msg variants currently dispatchable from rendered UI.\n   * Each entry corresponds to one or more event-handler bindings the\n   * compiler tagged with literal `send({type: '<variant>'})` calls;\n   * the registry tracks live mounts via lifetime refcounts so the\n   * snapshot reflects what the user can click *right now*, not the\n   * static catalogue of every variant the app could ever accept.\n   *\n   * Used by `@llui/agent` to populate `list_actions`. Apps that don't\n   * use the LLui compiler tagger pass (or whose views contain no\n   * literal sends) get an empty array — agents fall back to the Msg\n   * schema for affordance discovery.\n   */\n  getBindingDescriptors(): Array<{ variant: string }>\n  /**\n   * Hot-swap the component's `update` function (and optionally\n   * `onEffect`) without rebuilding the DOM. Pending messages are\n   * drained against the OLD `update` first so a half-applied\n   * transition can't leave the state ill-formed; subsequent\n   * dispatches go through the new function.\n   *\n   * This is the lightweight HMR escape hatch for cases where the\n   * full `replaceComponent` flow (in `@llui/dom/hmr`) is overkill —\n   * pure `update.ts` edits don't change the view, so disposing the\n   * root lifetime and re-running the view just to install a new\n   * function is wasteful and loses focus / scroll / transient DOM\n   * state. Wire it via `import.meta.hot`:\n   *\n   * ```ts\n   * // main.ts\n   * const handle = mountApp(root, App)\n   * if (import.meta.hot) {\n   *   import.meta.hot.accept('./app/update', (mod) => {\n   *     if (mod) handle.swapUpdate(mod.update)\n   *   })\n   * }\n   * ```\n   *\n   * Caveats:\n   *   - Doesn't compensate for State shape changes — if the new\n   *     `update` reads a field the old state doesn't have, you'll\n   *     see runtime errors. Hard-reload after structural state\n   *     changes.\n   *   - Doesn't swap `view` or compiler-emitted `__update`/`__dirty`\n   *     — for those, prefer the auto-injected component-level HMR\n   *     accept callback (which routes through `replaceComponent`).\n   */\n  swapUpdate(\n    newUpdate: (state: unknown, msg: unknown) => [unknown, unknown[]],\n    newOnEffect?: unknown,\n  ): void\n  /**\n   * Run the reducer in isolation against the current state. Returns\n   * `[newState, effects]` — the reducer's literal output without any\n   * commit, flush, or effect-handler invocation. Used by the agent's\n   * `would_dispatch` tool to predict what a candidate dispatch would\n   * do before committing to it.\n   *\n   * Pure-reducer assumption: TEA mandates `update` be pure. LLui's\n   * runtime treats it that way too (no speculative re-runs for any\n   * other reason). Apps whose reducers branch on `Date.now()` or\n   * read `localStorage` will see prediction drift from real dispatch\n   * by exactly that amount of impurity — surface as documented at\n   * the agent's call site, not silently corrected here.\n   *\n   * **No effects fire.** Effect descriptors are returned for the\n   * agent to inspect; `onEffect` is not called. This is the entire\n   * point of the API.\n   */\n  runReducer(msg: unknown): { state: unknown; effects: unknown[] } | null\n}\n\n// ── Lifetime ─────────────────────────────────────────────────────────\n\nexport interface Lifetime {\n  id: number\n  parent: Lifetime | null\n  children: Lifetime[]\n  disposers: Array<() => void>\n  bindings: Binding[]\n  /** Per-item updaters — called directly by each() when item changes, bypassing Phase 2 */\n  itemUpdaters: Array<() => void>\n  /**\n   * @internal dev-only back-reference to the owning ComponentInstance.\n   * Populated on the root scope by `installDevTools` so `disposeLifetime`\n   * can walk up the scope chain and emit DisposerEvents into the\n   * instance's `_disposerLog`. Undefined in production.\n   */\n  instance?: ComponentInstance\n  /**\n   * @internal dev-only cause hint. Structural primitives (branch, each,\n   * child, mountApp teardown) set this field immediately before calling\n   * `disposeLifetime`; the dispose path reads it once to stamp the emitted\n   * DisposerEvent. Left undefined, `disposeLifetime` falls back to\n   * `'component-unmount'`. Undefined in production.\n   */\n  disposalCause?: DisposerEvent['cause']\n  /** @internal dev-only — populated by structural primitives for scope-tree classification */\n  _kind?: 'root' | 'show' | 'each' | 'branch' | 'scope' | 'child' | 'portal' | 'foreign'\n}\n\nexport interface LifetimeNode {\n  scopeId: string\n  kind: 'root' | 'show' | 'each' | 'branch' | 'scope' | 'child' | 'portal' | 'foreign'\n  active: boolean\n  children: LifetimeNode[]\n}\n\n// ── Binding ───────────────────────────────────────────────────────\n\n/**\n * Binding output kinds.\n *\n * `'text' | 'prop' | 'attr' | 'class' | 'style'` write their accessor's\n * return value to the DOM. `'effect'` is a side-effect-only watcher:\n * the accessor is invoked every Phase 2 tick its mask is hit, but its\n * return value is discarded and `applyBinding` is a no-op. Used by\n * `child()` to fire the prop-diff/propsMsg cascade on parent updates\n * without the cost of stringifying the returned props bag onto a\n * detached anchor node every render.\n */\nexport type BindingKind = 'text' | 'prop' | 'attr' | 'class' | 'style' | 'effect'\n\nexport interface Binding {\n  mask: number\n  accessor: (state: unknown) => unknown\n  lastValue: unknown\n  kind: BindingKind\n  node: Node\n  key?: string\n  ownerLifetime: Lifetime\n  perItem: boolean\n  dead: boolean\n}\n\n// ── Structural Primitives ─────────────────────────────────────────\n\nexport interface TransitionOptions {\n  enter?: (nodes: Node[]) => void | Promise<void>\n  leave?: (nodes: Node[]) => void | Promise<void>\n  onTransition?: (ctx: { entering: Node[]; leaving: Node[]; parent: Node }) => void | Promise<void>\n}\n\ninterface BranchOptionsBase extends TransitionOptions {\n  /**\n   * @internal Set by `show()` / `scope()` sugar when delegating to\n   * `branch()`, so the dev-only disposer log can report `'show-hide'` /\n   * `'scope-rebuild'` instead of the default `'branch-swap'` for the\n   * leaving arm. User code should not set this directly.\n   */\n  __disposalCause?: DisposerEvent['cause']\n  /** @internal Compiler-injected mask of paths read by `on`. */\n  __mask?: number\n}\n\n/**\n * Discriminant accessor — reads a string-keyed value either from the\n * current state (`(s) => …`) or from a closed-over item accessor /\n * memo (`() => item.kind()`). Both forms re-evaluate on every commit.\n * The zero-arg form is the canonical shape for branching on per-row\n * fields inside an `each.render` callback.\n */\ntype Discriminant<S, K extends string> = ((s: S) => K) | (() => K)\n\n/**\n * All cases covered by `cases` — no default allowed (would be dead code).\n */\ntype BranchOptionsExhaustive<S, M, K extends string> = BranchOptionsBase & {\n  on: Discriminant<S, K>\n  cases: { [P in K]: (h: View<S, M>) => Node[] }\n  default?: never\n}\n\n/**\n * `cases` may cover some but not all keys; `default` handles the rest.\n */\ntype BranchOptionsNonExhaustive<S, M, K extends string> = BranchOptionsBase & {\n  on: Discriminant<S, K>\n  cases?: { [P in K]?: (h: View<S, M>) => Node[] }\n  default: (h: View<S, M>) => Node[]\n}\n\n/**\n * `on` returns a wide `string` — exhaustiveness cannot be verified at\n * compile time (the key domain is infinite). Lenient: `default` is\n * optional so existing call sites that predate exhaustiveness typing\n * continue to compile. Authors who want the gate opt in by narrowing\n * `on`'s return type to a literal union.\n */\ntype BranchOptionsWide<S, M> = BranchOptionsBase & {\n  on: Discriminant<S, string>\n  cases?: Record<string, (h: View<S, M>) => Node[]>\n  default?: (h: View<S, M>) => Node[]\n}\n\n/**\n * Options for `branch()`.\n *\n * When `on` returns a literal string union (e.g. `'idle' | 'loading'\n * | 'done'`), TypeScript enforces exhaustiveness: either every union\n * member has a case (and `default` is disallowed as unreachable), or\n * `default` is required to cover the remainder. When `on` returns a\n * wide `string`, `default` stays optional — exhaustiveness isn't\n * meaningful for an unbounded domain.\n *\n * `cases` is optional when `default` is present; `branch({ on, default })`\n * is the canonical dynamic-rebuild shape — `scope()` sugar wraps\n * exactly this form.\n */\nexport type BranchOptions<S, M = unknown, K extends string = string> = string extends K\n  ? BranchOptionsWide<S, M>\n  : BranchOptionsExhaustive<S, M, K> | BranchOptionsNonExhaustive<S, M, K>\n\nexport interface ShowOptions<S, M = unknown> extends TransitionOptions {\n  /**\n   * Predicate evaluated on every commit. `(s) => …` reads from\n   * component state; `() => …` (zero-arg) reads from a closed-over\n   * source — typically `item.field()` inside an `each.render`\n   * callback. Both forms are reactive: the predicate runs against\n   * each new state and the rendered subtree mounts/unmounts on the\n   * boolean transition.\n   */\n  when: ((s: S) => boolean) | (() => boolean)\n  render: (h: View<S, M>) => Node[]\n  fallback?: (h: View<S, M>) => Node[]\n}\n\n/**\n * Options for `scope()` — rebuilds a subtree when `on(state)` changes.\n *\n * Sugar over `branch({ on, cases: {}, default: render, __disposalCause: 'scope-rebuild' })`.\n * Use when the key is dynamic (e.g. an epoch counter bumped from the\n * outside) and you want a fresh arm — fresh lifetime, fresh bindings —\n * each time it changes. Combine with `sample()` inside `render` for a\n * one-shot current-state read.\n */\nexport interface ScopeOptions<S, M = unknown> extends TransitionOptions {\n  /**\n   * Key accessor evaluated on every commit. `(s) => …` reads from\n   * component state; `() => …` (zero-arg) reads from a closed-over\n   * source. The render callback rebuilds whenever the returned key\n   * changes — fresh lifetime, fresh bindings.\n   */\n  on: ((s: S) => string) | (() => string)\n  render: (h: View<S, M>) => Node[]\n  /** @internal Compiler-injected mask of paths read by `on`. */\n  __mask?: number\n}\n\n/**\n * Options for `each()`. The inherited `enter` / `leave` callbacks fire **per item**:\n * `enter(nodes)` runs after an item's DOM is inserted (including initial mount);\n * `leave(nodes)` runs before an item's DOM is removed and may return a Promise\n * to hold the DOM until the animation resolves. Setting `leave` disables the\n * bulk-clear / full-replace fast paths.\n */\n/**\n * Per-item accessor. Two access forms:\n * - `item.field` — shorthand, returns accessor for `item.current[field]`\n * - `item(t => t.expr)` — computed expressions\n *\n * In both cases the returned value is a `() => V` accessor.\n * Invoke it (`item.field()`) to read the current value imperatively.\n */\nexport type ItemAccessor<T> = {\n  <R>(selector: (t: T) => R): () => R\n} & {\n  [K in keyof T]-?: () => T[K]\n} & {\n  /**\n   * Read the whole current item. Needed when T is a primitive (where the\n   * field-map branch collapses to method names like `toString`) or when\n   * you want to sample the entire record rather than a single field.\n   *\n   * Shadows any literal `current` field on T — if T has such a field,\n   * use `item(r => r.current)` to disambiguate.\n   */\n  current(): T\n}\n\nexport interface EachOptions<S, T, M = unknown> extends TransitionOptions {\n  items: (s: S) => T[]\n  key: (item: T) => string | number\n  render: (opts: {\n    send: Send<M>\n    item: ItemAccessor<T>\n    /**\n     * Plain (non-Proxy) accessor factory. Compiler-output path; avoid in user code\n     * (use `item.field` / `item(fn)` — more ergonomic and bypasses Proxy when compiled).\n     */\n    acc: <R>(selector: (t: T) => R) => () => R\n    index: () => number\n    /**\n     * The component's View bag (`h.text`, `h.show`, `h.branch`,\n     * `h.scope`, `h.sample`, …). Each-render callers used to reach\n     * for the top-level imports; the bag form is symmetric with how\n     * `branch.cases[k]`, `show.render`, and `scope.render` receive it.\n     * Both still work — destructure whichever is more convenient.\n     */\n    h: View<S, M>\n    /** @internal Compiler-injected — entry reference for row factory */\n    entry?: Record<string, unknown>\n  }) => Node[]\n}\n\nexport interface PortalOptions {\n  target: HTMLElement | string\n  render: () => Node[]\n}\n\nexport interface ForeignOptions<S, M, T extends Record<string, unknown>, Instance> {\n  /**\n   * Construct the imperative instance. Can be async — return a\n   * `Promise<Instance>` to defer construction until e.g. a dynamic\n   * `import()` resolves. While the promise is pending:\n   *\n   *   - The container element is in the DOM immediately (so layout\n   *     doesn't shift when the instance arrives).\n   *   - `sync` is NOT called. State changes are tracked by the\n   *     primitive and the latest props are applied as the initial\n   *     sync right after the promise resolves.\n   *   - If the owning scope disposes before the promise resolves,\n   *     `destroy(instance)` runs on resolution — no matter how long\n   *     the promise takes.\n   */\n  mount: (ctx: { container: HTMLElement; send: Send<M> }) => Instance | Promise<Instance>\n  props: (s: S) => T\n  sync:\n    | ((ctx: { instance: Instance; props: T; prev: T | undefined }) => void)\n    | {\n        [K in keyof T]?: (ctx: { instance: Instance; value: T[K]; prev: T[K] | undefined }) => void\n      }\n  destroy: (instance: Instance) => void\n  container?: { tag?: string; attrs?: Record<string, string> }\n}\n\nexport interface ChildOptions<S, ChildM> {\n  // Type-erased via AnyComponentDef so callers can pass any concrete\n  // ComponentDef<S, M, E, D> without a widening helper. The runtime\n  // narrows the message shape via the user-supplied `onMsg` callback,\n  // which keeps `ChildM` typed at this boundary even though the def\n  // itself is opaque.\n  def: AnyComponentDef\n  key: string | number\n  props: (s: S) => Record<string, unknown>\n  onMsg?: (msg: ChildM) => unknown | null\n}\n"]}

package/dist/view-helpers.d.ts

@@ -33,13 +33,29 @@ export interface View<S, M> {
     branch<K extends string = string>(opts: BranchOptions<S, M, K>): Node[];
     scope(opts: ScopeOptions<S, M>): Node[];
     each<T>(opts: EachOptions<S, T, M>): Node[];
-    text(accessor: ((s: S) => string) | string, mask?: number): Text;
+    /**
+     * Reactive text node. Three accepted forms, all reactive at the
+     * binding layer:
+     *   - **Static**  — `text('hello')` for a fixed string.
+     *   - **State accessor** — `text((s) => s.title)` reads from the
+     *     component's state on every commit.
+     *   - **Item accessor (zero-arg)** — `text(item.title)` inside an
+     *     `each.render` callback reads the current item's value. The
+     *     runtime detects the zero-arg form and registers it as a
+     *     per-item updater — same reactivity, no full state-mask scan.
+     *
+     * Eager invocation (`text(item.title())`) is **static** — it reads
+     * once at view-construction and the resulting Text node never
+     * updates. The `agent-no-eager-item-accessor` lint rule flags this.
+     */
+    text(accessor: ((s: S) => string) | (() => string) | string, mask?: number): Text;
     /**
      * Insert raw HTML into the tree. Caller is responsible for sanitizing.
      * The parsed subtree is opaque to LLui — no nested bindings, events,
-     * or primitives inside it will be tracked. See `unsafeHtml` for details.
+     * or primitives inside it will be tracked. Same accessor forms as
+     * `text` — state-keyed, item-keyed (zero-arg), or static string.
      */
-    unsafeHtml(accessor: ((s: S) => string) | string, mask?: number): Node[];
+    unsafeHtml(accessor: ((s: S) => string) | (() => string) | string, mask?: number): Node[];
     memo<T>(accessor: (s: S) => T): (s: S) => T;
     selector<V>(field: (s: S) => V): SelectorInstance<V>;
     ctx<T>(c: Context<T>): (s: S) => T;

package/dist/view-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-helpers.d.ts","sourceRoot":"","sources":["../src/view-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAQ7F,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEvF,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,EAAE,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACb,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACrC,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACvE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACvC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChE;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAA;IACxE,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IAC3C,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACpD,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IAClC;;;;;OAKG;IACH,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;CAClD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAiB1D"}
+{"version":3,"file":"view-helpers.d.ts","sourceRoot":"","sources":["../src/view-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAQ7F,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAEvF,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,EAAE,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IACb,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACrC,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACvE,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACvC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IAC3C;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjF;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAAA;IACzF,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IAC3C,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAA;IACpD,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IAClC;;;;;OAKG;IACH,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;CAClD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAiB1D"}

package/dist/view-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"view-helpers.js","sourceRoot":"","sources":["../src/view-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAyB,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,UAAU,IAAI,WAAW,EAA0B,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAgB,MAAM,yBAAyB,CAAA;AA0DlE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAO,IAAa;IAC5C,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAO,IAAI,CAAC;QACjC,MAAM,EAAE,CAAmB,IAA4B,EAAE,EAAE,CAAC,OAAO,CAAU,IAAI,CAAC;QAClF,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAO,IAAI,CAAC;QACnC,IAAI,EAAE,CAAI,IAA0B,EAAE,EAAE,CAAC,KAAK,CAAU,IAAI,CAAC;QAC7D,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CACvB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAI,QAAQ,EAAE,IAAI,CAAC;QAC3E,UAAU,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAC7B,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAI,QAAQ,EAAE,IAAI,CAAC;QACvF,IAAI,EAAE,CAAI,QAAqB,EAAE,EAAE,CAAC,KAAK,CAAO,QAAQ,CAAC;QACzD,QAAQ,EAAE,CAAI,KAAkB,EAAE,EAAE,CAAC,SAAS,CAAO,KAAK,CAAC;QAC3D,GAAG,EAAE,CAAI,CAAa,EAAE,EAAE,CAAC,UAAU,CAAO,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAI,QAAqB,EAAE,EAAE,CAAC,OAAO,CAAO,QAAQ,CAAC;QAC7D,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAO,IAAI,CAAC;KAC9C,CAAA;AACH,CAAC","sourcesContent":["import type { Send, ShowOptions, BranchOptions, EachOptions, ScopeOptions } from './types.js'\nimport { show as _show } from './primitives/show.js'\nimport { branch as _branch } from './primitives/branch.js'\nimport { scope as _scope } from './primitives/scope.js'\nimport { each as _each } from './primitives/each.js'\nimport { text as _text } from './primitives/text.js'\nimport { unsafeHtml as _unsafeHtml } from './primitives/unsafe-html.js'\nimport { memo as _memo } from './primitives/memo.js'\nimport { selector as _selector, type SelectorInstance } from './primitives/selector.js'\nimport { sample as _sample } from './primitives/sample.js'\nimport { clientOnly as _clientOnly, type ClientOnlyOptions } from './primitives/client-only.js'\nimport { useContext, type Context } from './primitives/context.js'\n\n/**\n * Typed view helpers bound to a component's `State` / `Msg`. The sole\n * argument to `view`, so every state-bound primitive infers `State` from\n * the component definition — no per-call `show<State>(...)` annotation.\n *\n * ```ts\n * view: ({ send, show, text }) => [\n *   ...show({ when: s => s.count > 0, render: () => [...] }),\n *   text(s => String(s.count)),\n * ]\n * ```\n *\n * Tip: to view-function over a sub-slice of parent state, import `slice`\n * as a standalone helper:\n *\n * ```ts\n * import { slice } from '@llui/dom'\n * const form = slice(h, s => s.form)   // returns View<FormState, Msg>\n * ```\n *\n * The Vite plugin's mask-injection pass recognizes all three call forms\n * equivalently: `h.text(...)` (member expression), `text(...)` (destructured\n * alias), and `text(...)` (bare import from `@llui/dom`). No per-binding\n * gating is lost when calling through `h`.\n */\nexport interface View<S, M> {\n  send: Send<M>\n  show(opts: ShowOptions<S, M>): Node[]\n  branch<K extends string = string>(opts: BranchOptions<S, M, K>): Node[]\n  scope(opts: ScopeOptions<S, M>): Node[]\n  each<T>(opts: EachOptions<S, T, M>): Node[]\n  text(accessor: ((s: S) => string) | string, mask?: number): Text\n  /**\n   * Insert raw HTML into the tree. Caller is responsible for sanitizing.\n   * The parsed subtree is opaque to LLui — no nested bindings, events,\n   * or primitives inside it will be tracked. See `unsafeHtml` for details.\n   */\n  unsafeHtml(accessor: ((s: S) => string) | string, mask?: number): Node[]\n  memo<T>(accessor: (s: S) => T): (s: S) => T\n  selector<V>(field: (s: S) => V): SelectorInstance<V>\n  ctx<T>(c: Context<T>): (s: S) => T\n  /**\n   * Imperative one-shot read of current state inside the render context.\n   * Returns `selector(state)` at call time — no binding is created, no\n   * mask is assigned. Use when a builder needs the current state\n   * snapshot and a reactive binding would be wrong semantically.\n   */\n  sample<R>(selector: (s: S) => R): R\n  /**\n   * Mark a subtree as browser-only. SSR emits an anchor-bracketed\n   * placeholder (with optional fallback); the `render` callback only\n   * runs on client mount / hydrate. See the `clientOnly` export.\n   */\n  clientOnly(opts: ClientOnlyOptions<S, M>): Node[]\n}\n\n/**\n * Create a `View<S, M>` bundle for a component's `view` callback.\n * Delegates straight to the underlying primitives — zero per-call overhead.\n */\nexport function createView<S, M>(send: Send<M>): View<S, M> {\n  return {\n    send,\n    show: (opts) => _show<S, M>(opts),\n    branch: <K extends string>(opts: BranchOptions<S, M, K>) => _branch<S, M, K>(opts),\n    scope: (opts) => _scope<S, M>(opts),\n    each: <T>(opts: EachOptions<S, T, M>) => _each<S, T, M>(opts),\n    text: (accessor, mask) =>\n      typeof accessor === 'string' ? _text(accessor) : _text<S>(accessor, mask),\n    unsafeHtml: (accessor, mask) =>\n      typeof accessor === 'string' ? _unsafeHtml(accessor) : _unsafeHtml<S>(accessor, mask),\n    memo: <T>(accessor: (s: S) => T) => _memo<S, T>(accessor),\n    selector: <V>(field: (s: S) => V) => _selector<S, V>(field),\n    ctx: <T>(c: Context<T>) => useContext<S, T>(c),\n    sample: <R>(selector: (s: S) => R) => _sample<S, R>(selector),\n    clientOnly: (opts) => _clientOnly<S, M>(opts),\n  }\n}\n"]}
+{"version":3,"file":"view-helpers.js","sourceRoot":"","sources":["../src/view-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAyB,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,UAAU,IAAI,WAAW,EAA0B,MAAM,6BAA6B,CAAA;AAC/F,OAAO,EAAE,UAAU,EAAgB,MAAM,yBAAyB,CAAA;AA0ElE;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAO,IAAa;IAC5C,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAO,IAAI,CAAC;QACjC,MAAM,EAAE,CAAmB,IAA4B,EAAE,EAAE,CAAC,OAAO,CAAU,IAAI,CAAC;QAClF,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAO,IAAI,CAAC;QACnC,IAAI,EAAE,CAAI,IAA0B,EAAE,EAAE,CAAC,KAAK,CAAU,IAAI,CAAC;QAC7D,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CACvB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAI,QAAQ,EAAE,IAAI,CAAC;QAC3E,UAAU,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAC7B,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAI,QAAQ,EAAE,IAAI,CAAC;QACvF,IAAI,EAAE,CAAI,QAAqB,EAAE,EAAE,CAAC,KAAK,CAAO,QAAQ,CAAC;QACzD,QAAQ,EAAE,CAAI,KAAkB,EAAE,EAAE,CAAC,SAAS,CAAO,KAAK,CAAC;QAC3D,GAAG,EAAE,CAAI,CAAa,EAAE,EAAE,CAAC,UAAU,CAAO,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAI,QAAqB,EAAE,EAAE,CAAC,OAAO,CAAO,QAAQ,CAAC;QAC7D,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAO,IAAI,CAAC;KAC9C,CAAA;AACH,CAAC","sourcesContent":["import type { Send, ShowOptions, BranchOptions, EachOptions, ScopeOptions } from './types.js'\nimport { show as _show } from './primitives/show.js'\nimport { branch as _branch } from './primitives/branch.js'\nimport { scope as _scope } from './primitives/scope.js'\nimport { each as _each } from './primitives/each.js'\nimport { text as _text } from './primitives/text.js'\nimport { unsafeHtml as _unsafeHtml } from './primitives/unsafe-html.js'\nimport { memo as _memo } from './primitives/memo.js'\nimport { selector as _selector, type SelectorInstance } from './primitives/selector.js'\nimport { sample as _sample } from './primitives/sample.js'\nimport { clientOnly as _clientOnly, type ClientOnlyOptions } from './primitives/client-only.js'\nimport { useContext, type Context } from './primitives/context.js'\n\n/**\n * Typed view helpers bound to a component's `State` / `Msg`. The sole\n * argument to `view`, so every state-bound primitive infers `State` from\n * the component definition — no per-call `show<State>(...)` annotation.\n *\n * ```ts\n * view: ({ send, show, text }) => [\n *   ...show({ when: s => s.count > 0, render: () => [...] }),\n *   text(s => String(s.count)),\n * ]\n * ```\n *\n * Tip: to view-function over a sub-slice of parent state, import `slice`\n * as a standalone helper:\n *\n * ```ts\n * import { slice } from '@llui/dom'\n * const form = slice(h, s => s.form)   // returns View<FormState, Msg>\n * ```\n *\n * The Vite plugin's mask-injection pass recognizes all three call forms\n * equivalently: `h.text(...)` (member expression), `text(...)` (destructured\n * alias), and `text(...)` (bare import from `@llui/dom`). No per-binding\n * gating is lost when calling through `h`.\n */\nexport interface View<S, M> {\n  send: Send<M>\n  show(opts: ShowOptions<S, M>): Node[]\n  branch<K extends string = string>(opts: BranchOptions<S, M, K>): Node[]\n  scope(opts: ScopeOptions<S, M>): Node[]\n  each<T>(opts: EachOptions<S, T, M>): Node[]\n  /**\n   * Reactive text node. Three accepted forms, all reactive at the\n   * binding layer:\n   *   - **Static**  — `text('hello')` for a fixed string.\n   *   - **State accessor** — `text((s) => s.title)` reads from the\n   *     component's state on every commit.\n   *   - **Item accessor (zero-arg)** — `text(item.title)` inside an\n   *     `each.render` callback reads the current item's value. The\n   *     runtime detects the zero-arg form and registers it as a\n   *     per-item updater — same reactivity, no full state-mask scan.\n   *\n   * Eager invocation (`text(item.title())`) is **static** — it reads\n   * once at view-construction and the resulting Text node never\n   * updates. The `agent-no-eager-item-accessor` lint rule flags this.\n   */\n  text(accessor: ((s: S) => string) | (() => string) | string, mask?: number): Text\n  /**\n   * Insert raw HTML into the tree. Caller is responsible for sanitizing.\n   * The parsed subtree is opaque to LLui — no nested bindings, events,\n   * or primitives inside it will be tracked. Same accessor forms as\n   * `text` — state-keyed, item-keyed (zero-arg), or static string.\n   */\n  unsafeHtml(accessor: ((s: S) => string) | (() => string) | string, mask?: number): Node[]\n  memo<T>(accessor: (s: S) => T): (s: S) => T\n  selector<V>(field: (s: S) => V): SelectorInstance<V>\n  ctx<T>(c: Context<T>): (s: S) => T\n  /**\n   * Imperative one-shot read of current state inside the render context.\n   * Returns `selector(state)` at call time — no binding is created, no\n   * mask is assigned. Use when a builder needs the current state\n   * snapshot and a reactive binding would be wrong semantically.\n   */\n  sample<R>(selector: (s: S) => R): R\n  /**\n   * Mark a subtree as browser-only. SSR emits an anchor-bracketed\n   * placeholder (with optional fallback); the `render` callback only\n   * runs on client mount / hydrate. See the `clientOnly` export.\n   */\n  clientOnly(opts: ClientOnlyOptions<S, M>): Node[]\n}\n\n/**\n * Create a `View<S, M>` bundle for a component's `view` callback.\n * Delegates straight to the underlying primitives — zero per-call overhead.\n */\nexport function createView<S, M>(send: Send<M>): View<S, M> {\n  return {\n    send,\n    show: (opts) => _show<S, M>(opts),\n    branch: <K extends string>(opts: BranchOptions<S, M, K>) => _branch<S, M, K>(opts),\n    scope: (opts) => _scope<S, M>(opts),\n    each: <T>(opts: EachOptions<S, T, M>) => _each<S, T, M>(opts),\n    text: (accessor, mask) =>\n      typeof accessor === 'string' ? _text(accessor) : _text<S>(accessor, mask),\n    unsafeHtml: (accessor, mask) =>\n      typeof accessor === 'string' ? _unsafeHtml(accessor) : _unsafeHtml<S>(accessor, mask),\n    memo: <T>(accessor: (s: S) => T) => _memo<S, T>(accessor),\n    selector: <V>(field: (s: S) => V) => _selector<S, V>(field),\n    ctx: <T>(c: Context<T>) => useContext<S, T>(c),\n    sample: <R>(selector: (s: S) => R) => _sample<S, R>(selector),\n    clientOnly: (opts) => _clientOnly<S, M>(opts),\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/dom",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "type": "module",
   "sideEffects": false,
   "exports": {