@llui/dom 0.0.20 → 0.0.22

package/dist/primitives/child.js

@@ -1,5 +1,5 @@
 import { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js';
-import { createScope, disposeScope, addDisposer } from '../scope.js';
+import { createLifetime, disposeLifetime, addDisposer } from '../lifetime.js';
 import { createComponentInstance, flushInstance } from '../update-loop.js';
 import { createBinding, setFlatBindings } from '../binding.js';
 import { registerChild, unregisterChild } from '../addressed.js';
@@ -13,15 +13,15 @@ export function child(opts) {
             `and never update.`);
     }
     const parentCtx = getRenderContext('child');
-    const parentScope = parentCtx.rootScope;
-    const childScope = createScope(parentScope);
-    childScope._kind = 'child';
-    // Tag eagerly: childScope lives as long as the child component is mounted,
+    const parentLifetime = parentCtx.rootLifetime;
+    const childLifetime = createLifetime(parentLifetime);
+    childLifetime._kind = 'child';
+    // Tag eagerly: childLifetime lives as long as the child component is mounted,
     // so disposing it IS the child-unmount event. Setting the cause up front
     // (instead of inside the disposer closure below) ensures the parent's
-    // _disposerLog sees it when `disposeScope` walks up the parent chain —
-    // `childInst.rootScope` is an orphan (parent = null) and cannot emit.
-    childScope.disposalCause = 'child-unmount';
+    // _disposerLog sees it when `disposeLifetime` walks up the parent chain —
+    // `childInst.rootLifetime` is an orphan (parent = null) and cannot emit.
+    childLifetime.disposalCause = 'child-unmount';
     const parentSend = parentCtx.send;
     const childDef = opts.def;
     const initialProps = opts.props(parentCtx.state);
@@ -47,7 +47,7 @@ export function child(opts) {
     // accessor purely to fire the diff + propsMsg dispatch below. There is no
     // DOM output — the comment node is a detached anchor kept only so the
     // Binding shape stays uniform with other kinds.
-    createBinding(childScope, {
+    createBinding(childLifetime, {
         mask: FULL_MASK,
         accessor: ((parentState) => {
             const newProps = opts.props(parentState);
@@ -88,10 +88,10 @@ export function child(opts) {
     // Register in component registry for addressed effects
     registerChild(opts.key, { send: childInst.send });
     // Cleanup: dispose child instance when parent scope disposes
-    addDisposer(childScope, () => {
+    addDisposer(childLifetime, () => {
         unregisterChild(opts.key);
-        childInst.rootScope.disposalCause = 'child-unmount';
-        disposeScope(childInst.rootScope);
+        childInst.rootLifetime.disposalCause = 'child-unmount';
+        disposeLifetime(childInst.rootLifetime);
     });
     return nodes;
 }

package/dist/primitives/child.js.map

@@ -1 +1 @@
-{"version":3,"file":"child.js","sourceRoot":"","sources":["../../src/primitives/child.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChildOptions, ComponentDef } from '../types.js'\nimport { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js'\nimport { createScope, disposeScope, addDisposer } from '../scope.js'\nimport { createComponentInstance, flushInstance, type ComponentInstance } from '../update-loop.js'\nimport { createBinding, setFlatBindings } from '../binding.js'\nimport { registerChild, unregisterChild } from '../addressed.js'\nimport { createView } from '../view-helpers.js'\n\nconst FULL_MASK = 0xffffffff\n\nexport function child<S, ChildM>(opts: ChildOptions<S, ChildM>): Node[] {\n  // Dev-mode guard: props must be a function, not a static object\n  if (typeof opts.props !== 'function') {\n    throw new Error(\n      `child(\"${String(opts.key)}\"): props must be a reactive accessor function ` +\n        `(s => ({ ... })), not a static object. Static props are captured once at mount ` +\n        `and never update.`,\n    )\n  }\n\n  const parentCtx = getRenderContext('child')\n  const parentScope = parentCtx.rootScope\n  const childScope = createScope(parentScope)\n  childScope._kind = 'child'\n  // Tag eagerly: childScope lives as long as the child component is mounted,\n  // so disposing it IS the child-unmount event. Setting the cause up front\n  // (instead of inside the disposer closure below) ensures the parent's\n  // _disposerLog sees it when `disposeScope` walks up the parent chain —\n  // `childInst.rootScope` is an orphan (parent = null) and cannot emit.\n  childScope.disposalCause = 'child-unmount'\n  const parentSend = parentCtx.send\n\n  const childDef = opts.def as ComponentDef<unknown, ChildM, unknown>\n  const initialProps = opts.props(parentCtx.state as S)\n  const childInst = createComponentInstance(childDef, initialProps)\n\n  // Wrap child's send to intercept messages for onMsg → parent\n  const originalSend = childInst.send\n  childInst.send = (msg: ChildM) => {\n    originalSend(msg)\n    if (opts.onMsg && parentSend) {\n      // Defer to after the child processes — use microtask\n      queueMicrotask(() => {\n        const parentMsg = opts.onMsg!(msg)\n        if (parentMsg != null) {\n          parentSend(parentMsg)\n        }\n      })\n    }\n  }\n\n  // Track props for shallow-diff\n  let prevProps: Record<string, unknown> = { ...initialProps }\n\n  // Register a binding on the child scope that watches parent props changes.\n  // This is a side-effect-only (`kind: 'effect'`) binding: Phase 2 runs the\n  // accessor purely to fire the diff + propsMsg dispatch below. There is no\n  // DOM output — the comment node is a detached anchor kept only so the\n  // Binding shape stays uniform with other kinds.\n  createBinding(childScope, {\n    mask: FULL_MASK,\n    accessor: ((parentState: S) => {\n      const newProps = opts.props(parentState)\n\n      let changed = false\n      for (const key of Object.keys(newProps)) {\n        if (!Object.is(newProps[key], prevProps[key])) {\n          changed = true\n          break\n        }\n      }\n\n      if (changed && childDef.propsMsg) {\n        const msg = childDef.propsMsg(newProps)\n        // Dispatch via `originalSend` so framework-synthesized propsMsg\n        // traffic bypasses the `onMsg` wrapper below. Otherwise a naive\n        // `onMsg: m => forward(m)` echoes props/set back to the parent,\n        // which mutates parent state, re-fires this accessor, and loops\n        // forever.\n        originalSend(msg)\n        flushInstance(childInst)\n      }\n      prevProps = { ...newProps }\n    }) as (state: never) => unknown,\n    kind: 'effect',\n    node: document.createComment('child:' + opts.key),\n    perItem: false,\n  })\n\n  // Run the child's view within the child's render context\n  setFlatBindings(childInst.allBindings)\n  setRenderContext({\n    ...childInst,\n    send: childInst.send as (msg: unknown) => void,\n    instance: childInst as ComponentInstance,\n  })\n  const nodes = childDef.view(createView(childInst.send))\n  clearRenderContext()\n  setFlatBindings(parentCtx.allBindings)\n  setRenderContext(parentCtx)\n\n  // Register in component registry for addressed effects\n  registerChild(opts.key, { send: childInst.send as (msg: unknown) => void })\n\n  // Cleanup: dispose child instance when parent scope disposes\n  addDisposer(childScope, () => {\n    unregisterChild(opts.key)\n    childInst.rootScope.disposalCause = 'child-unmount'\n    disposeScope(childInst.rootScope)\n  })\n\n  return nodes\n}\n"]}
+{"version":3,"file":"child.js","sourceRoot":"","sources":["../../src/primitives/child.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ChildOptions, ComponentDef } from '../types.js'\nimport { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js'\nimport { createLifetime, disposeLifetime, addDisposer } from '../lifetime.js'\nimport { createComponentInstance, flushInstance, type ComponentInstance } from '../update-loop.js'\nimport { createBinding, setFlatBindings } from '../binding.js'\nimport { registerChild, unregisterChild } from '../addressed.js'\nimport { createView } from '../view-helpers.js'\n\nconst FULL_MASK = 0xffffffff\n\nexport function child<S, ChildM>(opts: ChildOptions<S, ChildM>): Node[] {\n  // Dev-mode guard: props must be a function, not a static object\n  if (typeof opts.props !== 'function') {\n    throw new Error(\n      `child(\"${String(opts.key)}\"): props must be a reactive accessor function ` +\n        `(s => ({ ... })), not a static object. Static props are captured once at mount ` +\n        `and never update.`,\n    )\n  }\n\n  const parentCtx = getRenderContext('child')\n  const parentLifetime = parentCtx.rootLifetime\n  const childLifetime = createLifetime(parentLifetime)\n  childLifetime._kind = 'child'\n  // Tag eagerly: childLifetime lives as long as the child component is mounted,\n  // so disposing it IS the child-unmount event. Setting the cause up front\n  // (instead of inside the disposer closure below) ensures the parent's\n  // _disposerLog sees it when `disposeLifetime` walks up the parent chain —\n  // `childInst.rootLifetime` is an orphan (parent = null) and cannot emit.\n  childLifetime.disposalCause = 'child-unmount'\n  const parentSend = parentCtx.send\n\n  const childDef = opts.def as ComponentDef<unknown, ChildM, unknown, Record<string, unknown>>\n  const initialProps = opts.props(parentCtx.state as S)\n  const childInst = createComponentInstance(childDef, initialProps)\n\n  // Wrap child's send to intercept messages for onMsg → parent\n  const originalSend = childInst.send\n  childInst.send = (msg: ChildM) => {\n    originalSend(msg)\n    if (opts.onMsg && parentSend) {\n      // Defer to after the child processes — use microtask\n      queueMicrotask(() => {\n        const parentMsg = opts.onMsg!(msg)\n        if (parentMsg != null) {\n          parentSend(parentMsg)\n        }\n      })\n    }\n  }\n\n  // Track props for shallow-diff\n  let prevProps: Record<string, unknown> = { ...initialProps }\n\n  // Register a binding on the child scope that watches parent props changes.\n  // This is a side-effect-only (`kind: 'effect'`) binding: Phase 2 runs the\n  // accessor purely to fire the diff + propsMsg dispatch below. There is no\n  // DOM output — the comment node is a detached anchor kept only so the\n  // Binding shape stays uniform with other kinds.\n  createBinding(childLifetime, {\n    mask: FULL_MASK,\n    accessor: ((parentState: S) => {\n      const newProps = opts.props(parentState)\n\n      let changed = false\n      for (const key of Object.keys(newProps)) {\n        if (!Object.is(newProps[key], prevProps[key])) {\n          changed = true\n          break\n        }\n      }\n\n      if (changed && childDef.propsMsg) {\n        const msg = childDef.propsMsg(newProps)\n        // Dispatch via `originalSend` so framework-synthesized propsMsg\n        // traffic bypasses the `onMsg` wrapper below. Otherwise a naive\n        // `onMsg: m => forward(m)` echoes props/set back to the parent,\n        // which mutates parent state, re-fires this accessor, and loops\n        // forever.\n        originalSend(msg)\n        flushInstance(childInst)\n      }\n      prevProps = { ...newProps }\n    }) as (state: never) => unknown,\n    kind: 'effect',\n    node: document.createComment('child:' + opts.key),\n    perItem: false,\n  })\n\n  // Run the child's view within the child's render context\n  setFlatBindings(childInst.allBindings)\n  setRenderContext({\n    ...childInst,\n    send: childInst.send as (msg: unknown) => void,\n    instance: childInst as ComponentInstance,\n  })\n  const nodes = childDef.view(createView(childInst.send))\n  clearRenderContext()\n  setFlatBindings(parentCtx.allBindings)\n  setRenderContext(parentCtx)\n\n  // Register in component registry for addressed effects\n  registerChild(opts.key, { send: childInst.send as (msg: unknown) => void })\n\n  // Cleanup: dispose child instance when parent scope disposes\n  addDisposer(childLifetime, () => {\n    unregisterChild(opts.key)\n    childInst.rootLifetime.disposalCause = 'child-unmount'\n    disposeLifetime(childInst.rootLifetime)\n  })\n\n  return nodes\n}\n"]}

package/dist/primitives/context.js

@@ -1,5 +1,5 @@
 import { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js';
-import { createScope } from '../scope.js';
+import { createLifetime } from '../lifetime.js';
 /**
  * Per-scope storage: scope → (context-id → accessor).
  * WeakMap so disposed scopes are GC'd.
@@ -35,18 +35,18 @@ export function createContext(defaultValue, name) {
  */
 export function provide(ctx, accessor, children) {
     const renderCtx = getRenderContext('provide');
-    const parentScope = renderCtx.rootScope;
+    const parentLifetime = renderCtx.rootLifetime;
     // Create a sub-scope so the context is attached to THIS provider alone.
     // Descendants (including those mounted later via show/branch/each) walk
     // up to this scope via their own parent chain and find the accessor.
     // Nested providers create their own sub-scope, shadowing outer values.
-    const providerScope = createScope(parentScope);
+    const providerScope = createLifetime(parentLifetime);
     const map = new Map();
     map.set(ctx._id, accessor);
     contextMap.set(providerScope, map);
-    // Render children with the provider scope as the new rootScope so any
+    // Render children with the provider scope as the new rootLifetime so any
     // primitives (bindings, structural blocks, nested providers) attach here.
-    setRenderContext({ ...renderCtx, rootScope: providerScope });
+    setRenderContext({ ...renderCtx, rootLifetime: providerScope });
     try {
         return children();
     }
@@ -70,7 +70,7 @@ export function provide(ctx, accessor, children) {
 export function useContext(ctx) {
     let scope = null;
     try {
-        scope = getRenderContext('useContext').rootScope;
+        scope = getRenderContext('useContext').rootLifetime;
     }
     catch {
         // No render context (e.g. called from connect() in a unit test).

package/dist/primitives/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/primitives/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Scope } from '../types.js'\nimport { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js'\nimport { createScope } from '../scope.js'\n\n/**\n * Per-scope storage: scope → (context-id → accessor).\n * WeakMap so disposed scopes are GC'd.\n */\nconst contextMap = new WeakMap<Scope, Map<symbol, (s: unknown) => unknown>>()\n\nexport interface Context<T> {\n  readonly _id: symbol\n  readonly _default: T | undefined\n  readonly _name: string | undefined\n}\n\n/**\n * Create a typed context key. Pass a default value to make consumers without a\n * provider resolve to it; omit to make unprovided consumption throw.\n *\n * ```ts\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n * ```\n */\nexport function createContext<T>(defaultValue?: T, name?: string): Context<T> {\n  return { _id: Symbol(name ?? 'llui-ctx'), _default: defaultValue, _name: name }\n}\n\n/**\n * Provide a reactive value for `ctx` to every descendant rendered inside `children`.\n * The accessor `(s: S) => T` is evaluated lazily at binding read time, so providers\n * can thread state slices down without prop drilling.\n *\n * ```ts\n * view: ({ send }) => [\n *   provide(ThemeContext, (s: State) => s.theme, () => [\n *     header(send),\n *     main(send),\n *   ]),\n * ]\n * ```\n *\n * Nested providers shadow outer ones within their subtree. The outer value is\n * restored after `children()` returns, so sibling subtrees aren't affected.\n */\nexport function provide<S, T>(\n  ctx: Context<T>,\n  accessor: (s: S) => T,\n  children: () => Node[],\n): Node[] {\n  const renderCtx = getRenderContext('provide')\n  const parentScope = renderCtx.rootScope\n  // Create a sub-scope so the context is attached to THIS provider alone.\n  // Descendants (including those mounted later via show/branch/each) walk\n  // up to this scope via their own parent chain and find the accessor.\n  // Nested providers create their own sub-scope, shadowing outer values.\n  const providerScope = createScope(parentScope)\n  const map = new Map<symbol, (s: unknown) => unknown>()\n  map.set(ctx._id, accessor as (s: unknown) => unknown)\n  contextMap.set(providerScope, map)\n  // Render children with the provider scope as the new rootScope so any\n  // primitives (bindings, structural blocks, nested providers) attach here.\n  setRenderContext({ ...renderCtx, rootScope: providerScope })\n  try {\n    return children()\n  } finally {\n    clearRenderContext()\n    setRenderContext(renderCtx)\n  }\n}\n\n/**\n * Read a context accessor within a view or view-function. Walks the scope chain\n * from the current render point to find the nearest provider. Returns an\n * `(s: S) => T` accessor that can be passed to bindings (text/class/etc.).\n *\n * ```ts\n * export function themedCard(): Node[] {\n *   const theme = useContext(ThemeContext)\n *   return div({ class: (s) => `card theme-${theme(s)}` }, [...])\n * }\n * ```\n */\nexport function useContext<S, T>(ctx: Context<T>): (s: S) => T {\n  let scope: Scope | null = null\n  try {\n    scope = getRenderContext('useContext').rootScope\n  } catch {\n    // No render context (e.g. called from connect() in a unit test).\n    // Fall through to default resolution below.\n  }\n  while (scope) {\n    const map = contextMap.get(scope)\n    if (map?.has(ctx._id)) {\n      const accessor = map.get(ctx._id)!\n      return accessor as (s: S) => T\n    }\n    scope = scope.parent\n  }\n  if (ctx._default !== undefined) {\n    const d = ctx._default\n    return () => d\n  }\n  const label = ctx._name ?? ctx._id.description ?? 'unknown'\n  throw new Error(\n    `[LLui] useContext(${label}): no provider found and no default value. ` +\n      `Wrap a parent element with provide(${label}, accessor, () => [...]) ` +\n      `or pass a default to createContext().`,\n  )\n}\n\n/**\n * Provide a state-independent value to every descendant. Companion to\n * `provide()` for the common case of publishing a stable dispatcher\n * bag, callback record, or DI container — anything that doesn't depend\n * on the parent's state.\n *\n * ```ts\n * provideValue(ToastContext, { show: (m) => send({ type: 'toast', m }) }, () => [\n *   main([pageSlot()]),\n * ])\n * ```\n *\n * Equivalent to `provide(ctx, () => value, children)`, but exists so\n * the call site reads as \"provide this value\" rather than \"provide an\n * accessor that ignores its state argument and returns a value.\" Pair\n * with `useContextValue` for symmetric ergonomics on the consumer side.\n *\n * Internally still uses the accessor mechanism: the value is wrapped\n * in a constant lambda. Consumers that read via the reactive\n * `useContext` form will get an `(s) => T` whose accessor ignores `s`.\n */\nexport function provideValue<T>(ctx: Context<T>, value: T, children: () => Node[]): Node[] {\n  return provide(ctx, () => value, children)\n}\n\n/**\n * Read a state-independent value from the nearest provider. Companion\n * to `useContext()` for the common case of consuming a stable\n * dispatcher bag, callback record, or DI container.\n *\n * ```ts\n * const toast = useContextValue(ToastContext)\n * button({ onClick: () => toast.show('Saved') }, [text('Save')])\n * ```\n *\n * Equivalent to calling the accessor returned by `useContext` with\n * `undefined`, but reads as a single function call instead of a\n * three-step \"look up the accessor, ignore the state arg, get the\n * value\" dance.\n *\n * ## Value capture contract\n *\n * **The returned value is captured once, at view-construction time.**\n * Any reference you store from `useContextValue(ctx)` into a closure\n * — for example, by assigning it to a local `const` inside `view(...)`\n * and reading it from an event handler — sees the value as it was\n * when the view ran. The closure does NOT re-read the context on each\n * event dispatch.\n *\n * That's fine, and usually what you want, for stable dispatcher bags:\n * the bag's methods close over the layout's `send`, and `send` itself\n * is stable across the layout's lifetime, so the methods work\n * correctly regardless of when the handler fires. Pages can stash\n * `const toast = useContextValue(ToastContext)` at the top of their\n * `view()` and call `toast.show(...)` from any event handler below.\n *\n * **Do NOT use `useContextValue` when the consumer needs to see\n * updates to the context value.** If a parent re-`provideValue`s the\n * context with a different object later, existing consumers already\n * holding the captured value will still see the old one. For\n * reactive consumption, use `useContext(ctx)` — that returns an\n * accessor that re-reads the provider on each binding evaluation, so\n * reactive bindings (`class`, `text`, etc.) pick up updates\n * automatically.\n *\n * **Do NOT use `useContextValue` against a provider whose accessor\n * reads from state.** The accessor is invoked with `undefined` here,\n * so any `(s) => s.something` provider will throw or return garbage.\n * Match `provideValue` on the producer side with `useContextValue` on\n * the consumer side, and `provide` with `useContext`.\n */\nexport function useContextValue<T>(ctx: Context<T>): T {\n  const accessor = useContext<unknown, T>(ctx)\n  // The contract above: the producer side promised this accessor\n  // doesn't read its state arg. Pass undefined.\n  return accessor(undefined)\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/primitives/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Lifetime } from '../types.js'\nimport { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js'\nimport { createLifetime } from '../lifetime.js'\n\n/**\n * Per-scope storage: scope → (context-id → accessor).\n * WeakMap so disposed scopes are GC'd.\n */\nconst contextMap = new WeakMap<Lifetime, Map<symbol, (s: unknown) => unknown>>()\n\nexport interface Context<T> {\n  readonly _id: symbol\n  readonly _default: T | undefined\n  readonly _name: string | undefined\n}\n\n/**\n * Create a typed context key. Pass a default value to make consumers without a\n * provider resolve to it; omit to make unprovided consumption throw.\n *\n * ```ts\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n * ```\n */\nexport function createContext<T>(defaultValue?: T, name?: string): Context<T> {\n  return { _id: Symbol(name ?? 'llui-ctx'), _default: defaultValue, _name: name }\n}\n\n/**\n * Provide a reactive value for `ctx` to every descendant rendered inside `children`.\n * The accessor `(s: S) => T` is evaluated lazily at binding read time, so providers\n * can thread state slices down without prop drilling.\n *\n * ```ts\n * view: ({ send }) => [\n *   provide(ThemeContext, (s: State) => s.theme, () => [\n *     header(send),\n *     main(send),\n *   ]),\n * ]\n * ```\n *\n * Nested providers shadow outer ones within their subtree. The outer value is\n * restored after `children()` returns, so sibling subtrees aren't affected.\n */\nexport function provide<S, T>(\n  ctx: Context<T>,\n  accessor: (s: S) => T,\n  children: () => Node[],\n): Node[] {\n  const renderCtx = getRenderContext('provide')\n  const parentLifetime = renderCtx.rootLifetime\n  // Create a sub-scope so the context is attached to THIS provider alone.\n  // Descendants (including those mounted later via show/branch/each) walk\n  // up to this scope via their own parent chain and find the accessor.\n  // Nested providers create their own sub-scope, shadowing outer values.\n  const providerScope = createLifetime(parentLifetime)\n  const map = new Map<symbol, (s: unknown) => unknown>()\n  map.set(ctx._id, accessor as (s: unknown) => unknown)\n  contextMap.set(providerScope, map)\n  // Render children with the provider scope as the new rootLifetime so any\n  // primitives (bindings, structural blocks, nested providers) attach here.\n  setRenderContext({ ...renderCtx, rootLifetime: providerScope })\n  try {\n    return children()\n  } finally {\n    clearRenderContext()\n    setRenderContext(renderCtx)\n  }\n}\n\n/**\n * Read a context accessor within a view or view-function. Walks the scope chain\n * from the current render point to find the nearest provider. Returns an\n * `(s: S) => T` accessor that can be passed to bindings (text/class/etc.).\n *\n * ```ts\n * export function themedCard(): Node[] {\n *   const theme = useContext(ThemeContext)\n *   return div({ class: (s) => `card theme-${theme(s)}` }, [...])\n * }\n * ```\n */\nexport function useContext<S, T>(ctx: Context<T>): (s: S) => T {\n  let scope: Lifetime | null = null\n  try {\n    scope = getRenderContext('useContext').rootLifetime\n  } catch {\n    // No render context (e.g. called from connect() in a unit test).\n    // Fall through to default resolution below.\n  }\n  while (scope) {\n    const map = contextMap.get(scope)\n    if (map?.has(ctx._id)) {\n      const accessor = map.get(ctx._id)!\n      return accessor as (s: S) => T\n    }\n    scope = scope.parent\n  }\n  if (ctx._default !== undefined) {\n    const d = ctx._default\n    return () => d\n  }\n  const label = ctx._name ?? ctx._id.description ?? 'unknown'\n  throw new Error(\n    `[LLui] useContext(${label}): no provider found and no default value. ` +\n      `Wrap a parent element with provide(${label}, accessor, () => [...]) ` +\n      `or pass a default to createContext().`,\n  )\n}\n\n/**\n * Provide a state-independent value to every descendant. Companion to\n * `provide()` for the common case of publishing a stable dispatcher\n * bag, callback record, or DI container — anything that doesn't depend\n * on the parent's state.\n *\n * ```ts\n * provideValue(ToastContext, { show: (m) => send({ type: 'toast', m }) }, () => [\n *   main([pageSlot()]),\n * ])\n * ```\n *\n * Equivalent to `provide(ctx, () => value, children)`, but exists so\n * the call site reads as \"provide this value\" rather than \"provide an\n * accessor that ignores its state argument and returns a value.\" Pair\n * with `useContextValue` for symmetric ergonomics on the consumer side.\n *\n * Internally still uses the accessor mechanism: the value is wrapped\n * in a constant lambda. Consumers that read via the reactive\n * `useContext` form will get an `(s) => T` whose accessor ignores `s`.\n */\nexport function provideValue<T>(ctx: Context<T>, value: T, children: () => Node[]): Node[] {\n  return provide(ctx, () => value, children)\n}\n\n/**\n * Read a state-independent value from the nearest provider. Companion\n * to `useContext()` for the common case of consuming a stable\n * dispatcher bag, callback record, or DI container.\n *\n * ```ts\n * const toast = useContextValue(ToastContext)\n * button({ onClick: () => toast.show('Saved') }, [text('Save')])\n * ```\n *\n * Equivalent to calling the accessor returned by `useContext` with\n * `undefined`, but reads as a single function call instead of a\n * three-step \"look up the accessor, ignore the state arg, get the\n * value\" dance.\n *\n * ## Value capture contract\n *\n * **The returned value is captured once, at view-construction time.**\n * Any reference you store from `useContextValue(ctx)` into a closure\n * — for example, by assigning it to a local `const` inside `view(...)`\n * and reading it from an event handler — sees the value as it was\n * when the view ran. The closure does NOT re-read the context on each\n * event dispatch.\n *\n * That's fine, and usually what you want, for stable dispatcher bags:\n * the bag's methods close over the layout's `send`, and `send` itself\n * is stable across the layout's lifetime, so the methods work\n * correctly regardless of when the handler fires. Pages can stash\n * `const toast = useContextValue(ToastContext)` at the top of their\n * `view()` and call `toast.show(...)` from any event handler below.\n *\n * **Do NOT use `useContextValue` when the consumer needs to see\n * updates to the context value.** If a parent re-`provideValue`s the\n * context with a different object later, existing consumers already\n * holding the captured value will still see the old one. For\n * reactive consumption, use `useContext(ctx)` — that returns an\n * accessor that re-reads the provider on each binding evaluation, so\n * reactive bindings (`class`, `text`, etc.) pick up updates\n * automatically.\n *\n * **Do NOT use `useContextValue` against a provider whose accessor\n * reads from state.** The accessor is invoked with `undefined` here,\n * so any `(s) => s.something` provider will throw or return garbage.\n * Match `provideValue` on the producer side with `useContextValue` on\n * the consumer side, and `provide` with `useContext`.\n */\nexport function useContextValue<T>(ctx: Context<T>): T {\n  const accessor = useContext<unknown, T>(ctx)\n  // The contract above: the producer side promised this accessor\n  // doesn't read its state arg. Pass undefined.\n  return accessor(undefined)\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"each.d.ts","sourceRoot":"","sources":["../../src/primitives/each.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,aAAa,CAAA;AAuBnE,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAEpD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAAG,IAAI,CAEzE;AAgCD,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAmR1E"}
+{"version":3,"file":"each.d.ts","sourceRoot":"","sources":["../../src/primitives/each.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA0B,MAAM,aAAa,CAAA;AAuBtE,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAEpD;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,GAAG,IAAI,CAEzE;AAgCD,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAmR1E"}

package/dist/primitives/each.js

@@ -1,5 +1,5 @@
 import { getRenderContext, setRenderContext, clearRenderContext, } from '../render-context.js';
-import { createScope, disposeScope, disposeScopesBulk, addDisposer, removeOrphanedChildren, } from '../scope.js';
+import { createLifetime, disposeLifetime, disposeLifetimesBulk, addDisposer, removeOrphanedChildren, } from '../lifetime.js';
 import { getFlatBindings, setFlatBindings } from '../binding.js';
 import { FULL_MASK } from '../update-loop.js';
 // Clear callbacks — registered by selector.bind() during render, called by reconcileClear().
@@ -18,7 +18,7 @@ export function registerOnRemove(cb) {
 }
 // Reusable render context for buildEntry — avoids object allocation per entry
 const buildCtx = {
-    rootScope: null,
+    rootLifetime: null,
     state: null,
     allBindings: [],
     structuralBlocks: [],
@@ -35,7 +35,7 @@ const buildBag = {
 };
 export function each(opts) {
     const ctx = getRenderContext('each');
-    const parentScope = ctx.rootScope;
+    const parentLifetime = ctx.rootLifetime;
     const blocks = ctx.structuralBlocks;
     const anchor = document.createComment('each');
     const entries = [];
@@ -111,7 +111,7 @@ export function each(opts) {
             lastItemsRef = newItems;
             const oldKeys = snapshotKeys();
             const report = opts.onTransition ? { entering: [], leaving: [] } : null;
-            reconcileEntries(entries, newItems, opts, parentScope, parent, anchor, ctx, state, leaving, report);
+            reconcileEntries(entries, newItems, opts, parentLifetime, parent, anchor, ctx, state, leaving, report);
             if (opts.onTransition && report) {
                 opts.onTransition({ entering: report.entering, leaving: report.leaving, parent });
             }
@@ -159,8 +159,8 @@ export function each(opts) {
                 s.disposalCause = 'each-remove';
                 scopes.push(s);
             }
-            disposeScopesBulk(scopes);
-            removeOrphanedChildren(parentScope);
+            disposeLifetimesBulk(scopes);
+            removeOrphanedChildren(parentLifetime);
             entries.length = 0;
             emitDiff(oldKeys);
         },
@@ -178,7 +178,7 @@ export function each(opts) {
             const newLen = newItems.length;
             if (newLen >= oldLen) {
                 // Not a removal — fallback (shouldn't happen if compiler detected correctly)
-                reconcileEntries(entries, newItems, opts, parentScope, parent, anchor, ctx, state, leaving, null);
+                reconcileEntries(entries, newItems, opts, parentLifetime, parent, anchor, ctx, state, leaving, null);
                 emitDiff(oldKeys);
                 return;
             }
@@ -201,7 +201,7 @@ export function each(opts) {
                     for (const node of entry.nodes)
                         parent.removeChild(node);
                     entry.scope.disposalCause = 'each-remove';
-                    disposeScope(entry.scope, true);
+                    disposeLifetime(entry.scope, true);
                     entries[oi] = null;
                     didRemove = true;
                 }
@@ -214,7 +214,7 @@ export function each(opts) {
                         entries[w++] = entries[r];
                 }
                 entries.length = w;
-                removeOrphanedChildren(parentScope);
+                removeOrphanedChildren(parentLifetime);
             }
             // Update indices for remaining entries
             for (let i = 0; i < entries.length; i++) {
@@ -245,7 +245,7 @@ export function each(opts) {
     activeRemoveCallbacks = removeCallbacks;
     for (let i = 0; i < initialItems.length; i++) {
         const item = initialItems[i];
-        const entry = buildEntry(item, i, opts, parentScope, ctx);
+        const entry = buildEntry(item, i, opts, parentLifetime, ctx);
         entries.push(entry);
     }
     activeClearCallbacks = null;
@@ -257,15 +257,15 @@ export function each(opts) {
                 opts.enter(entry.nodes);
         }
     }
-    addDisposer(parentScope, () => {
+    addDisposer(parentLifetime, () => {
         const idx = blocks.indexOf(block);
         if (idx !== -1)
             blocks.splice(idx, 1);
-        // parentScope is being disposed — its children array is about to be
+        // parentLifetime is being disposed — its children array is about to be
         // cleared by the recursive dispose pass, so skip per-entry parent
         // removal (avoids O(N²) indexOf+splice).
         for (const entry of entries) {
-            disposeScope(entry.scope, true);
+            disposeLifetime(entry.scope, true);
         }
         entries.length = 0;
         // Force-remove any mid-leave entries immediately
@@ -274,7 +274,7 @@ export function each(opts) {
                 if (node.parentNode)
                     node.parentNode.removeChild(node);
             }
-            disposeScope(entry.scope, true);
+            disposeLifetime(entry.scope, true);
         }
         leaving.length = 0;
     });
@@ -298,7 +298,7 @@ function removeEntry(entry, opts, leaving) {
                 node.parentNode.removeChild(node);
         }
         entry.scope.disposalCause = 'each-remove';
-        disposeScope(entry.scope);
+        disposeLifetime(entry.scope);
         const idx = leaving.indexOf(entry);
         if (idx !== -1)
             leaving.splice(idx, 1);
@@ -318,12 +318,12 @@ function fireEnter(entry, opts) {
         void opts.enter(entry.nodes);
     }
 }
-function buildEntry(item, index, opts, parentScope, ctx, state) {
+function buildEntry(item, index, opts, parentLifetime, ctx, state) {
     const key = opts.key(item);
     // Use a lightweight scope — just needs itemUpdaters for per-item bindings.
     // Full scope features (disposers, bindings, children) are only needed when
     // the render callback uses structural primitives or selector.bind().
-    const scope = createScope(parentScope);
+    const scope = createLifetime(parentLifetime);
     scope._kind = 'each';
     const currentState = (state ?? ctx.state);
     const send = ctx.send;
@@ -358,7 +358,12 @@ function buildEntry(item, index, opts, parentScope, ctx, state) {
                 else {
                     fieldCache = new Map();
                 }
-                const accessor = () => entry.current[key];
+                // `current` returns the whole item — essential for primitive T
+                // (where the field map is useless) and for whole-record sampling.
+                // Caller must call it like a method: `item.current()`.
+                const accessor = key === 'current'
+                    ? () => entry.current
+                    : () => entry.current[key];
                 accessor.__perItem = true;
                 fieldCache.set(key, accessor);
                 return accessor;
@@ -368,7 +373,7 @@ function buildEntry(item, index, opts, parentScope, ctx, state) {
     };
     const indexAccessor = () => entry.index;
     // Reuse a single context object to avoid allocation per entry
-    buildCtx.rootScope = scope;
+    buildCtx.rootLifetime = scope;
     buildCtx.state = currentState;
     buildCtx.allBindings = ctx.allBindings;
     buildCtx.structuralBlocks = ctx.structuralBlocks;
@@ -405,7 +410,7 @@ function collectNodes(target, nodes) {
     for (const n of nodes)
         target.push(n);
 }
-function reconcileEntries(entries, newItems, opts, parentScope, parent, anchor, ctx, state, leaving, report) {
+function reconcileEntries(entries, newItems, opts, parentLifetime, parent, anchor, ctx, state, leaving, report) {
     const oldLen = entries.length;
     const newLen = newItems.length;
     const hasLeave = !!opts.leave;
@@ -440,8 +445,8 @@ function reconcileEntries(entries, newItems, opts, parentScope, parent, anchor,
             s.disposalCause = 'each-remove';
             scopes.push(s);
         }
-        disposeScopesBulk(scopes);
-        removeOrphanedChildren(parentScope);
+        disposeLifetimesBulk(scopes);
+        removeOrphanedChildren(parentLifetime);
         entries.length = 0;
         return;
     }
@@ -458,7 +463,7 @@ function reconcileEntries(entries, newItems, opts, parentScope, parent, anchor,
         const frag = document.createDocumentFragment();
         const newlyAdded = [];
         for (let i = oldLen; i < newLen; i++) {
-            const entry = buildEntry(newItems[i], i, opts, parentScope, ctx, state);
+            const entry = buildEntry(newItems[i], i, opts, parentLifetime, ctx, state);
             entries.push(entry);
             newlyAdded.push(entry);
             for (const node of entry.nodes)
@@ -547,20 +552,20 @@ function reconcileEntries(entries, newItems, opts, parentScope, parent, anchor,
             range.setEndAfter(lastEntry.nodes[lastEntry.nodes.length - 1]);
             range.deleteContents();
             // Bulk dispose all old scopes
-            const oldScopes = [];
+            const oldLifetimes = [];
             for (let i = 0; i < entries.length; i++) {
                 const s = entries[i].scope;
                 s.disposalCause = 'each-remove';
-                oldScopes.push(s);
+                oldLifetimes.push(s);
             }
-            disposeScopesBulk(oldScopes);
-            removeOrphanedChildren(parentScope);
+            disposeLifetimesBulk(oldLifetimes);
+            removeOrphanedChildren(parentLifetime);
             entries.length = 0;
             // Build all new entries into a fragment
             const frag = document.createDocumentFragment();
             const newlyAdded = [];
             for (let i = 0; i < newLen; i++) {
-                const entry = buildEntry(newItems[i], i, opts, parentScope, ctx, state);
+                const entry = buildEntry(newItems[i], i, opts, parentLifetime, ctx, state);
                 entries.push(entry);
                 newlyAdded.push(entry);
                 for (const node of entry.nodes)
@@ -594,14 +599,14 @@ function reconcileEntries(entries, newItems, opts, parentScope, parent, anchor,
             newEntries.push(existing);
         }
         else {
-            const entry = buildEntry(item, i, opts, parentScope, ctx, state);
+            const entry = buildEntry(item, i, opts, parentLifetime, ctx, state);
             newEntries.push(entry);
             newlyAdded.push(entry);
         }
     }
     // Remove entries not in the new list. Use bulk-detach pattern so
     // disposing K removals costs O(K+P) rather than O(K*P) where P is
-    // parentScope.children.length (avoids K * indexOf+splice).
+    // parentLifetime.children.length (avoids K * indexOf+splice).
     let didBulkDetach = false;
     for (const entry of entries) {
         if (!usedKeys.has(entry.key)) {
@@ -614,13 +619,13 @@ function reconcileEntries(entries, newItems, opts, parentScope, parent, anchor,
                 for (const node of entry.nodes)
                     parent.removeChild(node);
                 entry.scope.disposalCause = 'each-remove';
-                disposeScope(entry.scope, true);
+                disposeLifetime(entry.scope, true);
                 didBulkDetach = true;
             }
         }
     }
     if (didBulkDetach)
-        removeOrphanedChildren(parentScope);
+        removeOrphanedChildren(parentLifetime);
     // Reorder DOM
     const hasSurvivors = newEntries.some((e) => oldByKey.has(e.key));
     if (!hasSurvivors || !survivorsInOrder(entries, newEntries, usedKeys)) {