@llui/dom 0.0.20 → 0.0.21

package/dist/view-helpers.d.ts

@@ -1,4 +1,4 @@
-import type { Send, ShowOptions, BranchOptions, EachOptions } from './types.js';
+import type { Send, ShowOptions, BranchOptions, EachOptions, ScopeOptions } from './types.js';
 import { type SelectorInstance } from './primitives/selector.js';
 import { type Context } from './primitives/context.js';
 /**
@@ -30,6 +30,7 @@ export interface View<S, M> {
     send: Send<M>;
     show(opts: ShowOptions<S, M>): Node[];
     branch(opts: BranchOptions<S, M>): Node[];
+    scope(opts: ScopeOptions<S, M>): Node[];
     each<T>(opts: EachOptions<S, T, M>): Node[];
     text(accessor: ((s: S) => string) | string, mask?: number): Text;
     /**
@@ -41,6 +42,13 @@ export interface View<S, M> {
     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;
+    /**
+     * Imperative one-shot read of current state inside the render context.
+     * Returns `selector(state)` at call time — no binding is created, no
+     * mask is assigned. Use when a builder needs the current state
+     * snapshot and a reactive binding would be wrong semantically.
+     */
+    sample<R>(selector: (s: S) => R): R;
 }
 /**
  * Create a `View<S, M>` bundle for a component's `view` callback.

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,MAAM,YAAY,CAAA;AAO/E,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AACvF,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,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACzC,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;CACnC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAc1D"}
+{"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,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,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAA;IACzC,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;CACpC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAgB1D"}

package/dist/view-helpers.js

@@ -1,10 +1,12 @@
 import { show as _show } from './primitives/show.js';
 import { branch as _branch } from './primitives/branch.js';
+import { scope as _scope } from './primitives/scope.js';
 import { each as _each } from './primitives/each.js';
 import { text as _text } from './primitives/text.js';
 import { unsafeHtml as _unsafeHtml } from './primitives/unsafe-html.js';
 import { memo as _memo } from './primitives/memo.js';
 import { selector as _selector } from './primitives/selector.js';
+import { sample as _sample } from './primitives/sample.js';
 import { useContext } from './primitives/context.js';
 /**
  * Create a `View<S, M>` bundle for a component's `view` callback.
@@ -15,12 +17,14 @@ export function createView(send) {
         send,
         show: (opts) => _show(opts),
         branch: (opts) => _branch(opts),
+        scope: (opts) => _scope(opts),
         each: (opts) => _each(opts),
         text: (accessor, mask) => typeof accessor === 'string' ? _text(accessor) : _text(accessor, mask),
         unsafeHtml: (accessor, mask) => typeof accessor === 'string' ? _unsafeHtml(accessor) : _unsafeHtml(accessor, mask),
         memo: (accessor) => _memo(accessor),
         selector: (field) => _selector(field),
         ctx: (c) => useContext(c),
+        sample: (selector) => _sample(selector),
     };
 }
 //# sourceMappingURL=view-helpers.js.map

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,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,UAAU,EAAgB,MAAM,yBAAyB,CAAA;AA4ClE;;;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,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAO,IAAI,CAAC;QACrC,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;KAC/C,CAAA;AACH,CAAC","sourcesContent":["import type { Send, ShowOptions, BranchOptions, EachOptions } from './types.js'\nimport { show as _show } from './primitives/show.js'\nimport { branch as _branch } from './primitives/branch.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 { 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(opts: BranchOptions<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\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: (opts) => _branch<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  }\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,EAAgB,MAAM,yBAAyB,CAAA;AAoDlE;;;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,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAO,IAAI,CAAC;QACrC,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;KAC9D,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 { 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(opts: BranchOptions<S, M>): 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\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: (opts) => _branch<S, M>(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  }\n}\n"]}

package/package.json

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