sibujs 4.0.0 → 4.1.0

package/dist/ecosystem.cjs

@@ -359,7 +359,14 @@ function reactiveBinding(commit, ownerNode) {
   subscriber._disposed = false;
   subscriber._errorPhase = "binding";
   subscriber._errorNode = ownerNode;
-  run();
+  try {
+    run();
+  } catch (err) {
+    subscriber._disposed = true;
+    subscriber._errorNode = void 0;
+    cleanup(subscriber);
+    throw err;
+  }
   return subscriber._dispose ?? (subscriber._dispose = () => {
     subscriber._disposed = true;
     subscriber._errorNode = void 0;
@@ -591,7 +598,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev2 = isDev();
-var _runtimeVersion = true ? "4.0.0" : "dev";
+var _runtimeVersion = true ? "4.1.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -1623,9 +1630,9 @@ function toKebab(prop) {
 }
 function applyStyle(el, style) {
   if (typeof style === "function") {
-    const teardown = track2(() => {
+    const teardown = reactiveBinding2(() => {
       el.setAttribute("style", sanitizeStyleAttribute(String(style())));
-    });
+    }, el);
     registerDisposer(el, teardown);
     return;
   }
@@ -1639,9 +1646,9 @@ function applyStyle(el, style) {
     const name = toKebab(prop);
     if (typeof val === "function") {
       const getter = val;
-      const teardown = track2(() => {
+      const teardown = reactiveBinding2(() => {
         htmlEl.style.setProperty(name, sanitizeCSSValue(String(getter())));
-      });
+      }, el);
       registerDisposer(el, teardown);
     } else {
       htmlEl.style.setProperty(name, sanitizeCSSValue(String(val)));
@@ -1654,9 +1661,9 @@ function applyClass(el, cls) {
     return;
   }
   if (typeof cls === "function") {
-    const teardown = track2(() => {
+    const teardown = reactiveBinding2(() => {
       el.setAttribute("class", cls());
-    });
+    }, el);
     registerDisposer(el, teardown);
     return;
   }
@@ -1681,7 +1688,7 @@ function applyClass(el, cls) {
       }
       el.setAttribute("class", r);
     };
-    const teardown = track2(update);
+    const teardown = reactiveBinding2(update, el);
     registerDisposer(el, teardown);
   } else {
     el.setAttribute("class", result);

package/dist/ecosystem.js

@@ -7,18 +7,18 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-WN6WDFCB.js";
+} from "./chunk-FB7KQXZI.js";
 import "./chunk-WWV3SJ3L.js";
-import "./chunk-DQVUBVNX.js";
-import "./chunk-4MFZMLUU.js";
-import "./chunk-Z2CE42DB.js";
+import "./chunk-I3VI34DP.js";
+import "./chunk-SHDVWATN.js";
+import "./chunk-DCDS2PQ6.js";
 import "./chunk-5INI7D2L.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-PBQEW5VW.js";
+import "./chunk-PFTDGEPZ.js";
 import "./chunk-TIRZCERI.js";
 import "./chunk-DHDZ7IVN.js";
-import "./chunk-W55YHPEP.js";
-import "./chunk-ACBT6UZS.js";
+import "./chunk-UFSQEO7P.js";
+import "./chunk-D3SZ4LVS.js";
 import "./chunk-VPP2FONR.js";
 export {
   antdAdapter,

package/dist/extras.cjs

@@ -645,7 +645,14 @@ function reactiveBinding(commit, ownerNode) {
   subscriber._disposed = false;
   subscriber._errorPhase = "binding";
   subscriber._errorNode = ownerNode;
-  run();
+  try {
+    run();
+  } catch (err) {
+    subscriber._disposed = true;
+    subscriber._errorNode = void 0;
+    cleanup(subscriber);
+    throw err;
+  }
   return subscriber._dispose ?? (subscriber._dispose = () => {
     subscriber._disposed = true;
     subscriber._errorNode = void 0;
@@ -877,7 +884,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev2 = isDev();
-var _runtimeVersion = true ? "4.0.0" : "dev";
+var _runtimeVersion = true ? "4.1.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -9021,9 +9028,9 @@ function toKebab(prop) {
 }
 function applyStyle(el, style2) {
   if (typeof style2 === "function") {
-    const teardown = track2(() => {
+    const teardown = reactiveBinding2(() => {
       el.setAttribute("style", sanitizeStyleAttribute(String(style2())));
-    });
+    }, el);
     registerDisposer(el, teardown);
     return;
   }
@@ -9037,9 +9044,9 @@ function applyStyle(el, style2) {
     const name = toKebab(prop);
     if (typeof val === "function") {
       const getter = val;
-      const teardown = track2(() => {
+      const teardown = reactiveBinding2(() => {
         htmlEl.style.setProperty(name, sanitizeCSSValue(String(getter())));
-      });
+      }, el);
       registerDisposer(el, teardown);
     } else {
       htmlEl.style.setProperty(name, sanitizeCSSValue(String(val)));
@@ -9052,9 +9059,9 @@ function applyClass(el, cls) {
     return;
   }
   if (typeof cls === "function") {
-    const teardown = track2(() => {
+    const teardown = reactiveBinding2(() => {
       el.setAttribute("class", cls());
-    });
+    }, el);
     registerDisposer(el, teardown);
     return;
   }
@@ -9079,7 +9086,7 @@ function applyClass(el, cls) {
       }
       el.setAttribute("class", r);
     };
-    const teardown = track2(update);
+    const teardown = reactiveBinding2(update, el);
     registerDisposer(el, teardown);
   } else {
     el.setAttribute("class", result);

package/dist/extras.js

@@ -5,7 +5,7 @@ import {
   optimisticList,
   persisted,
   timeline
-} from "./chunk-WOOMUJFT.js";
+} from "./chunk-4U7KD3RY.js";
 import {
   DOMPool,
   Features,
@@ -41,7 +41,7 @@ import {
   transitionState,
   uniqueId,
   yieldToMain
-} from "./chunk-3EKJK5FZ.js";
+} from "./chunk-LOFZHP6V.js";
 import {
   VERSION,
   bundlerMetadata,
@@ -88,7 +88,7 @@ import {
   wasm,
   worker,
   workerFn
-} from "./chunk-VFHIVEPF.js";
+} from "./chunk-BMSN6NWQ.js";
 import {
   FocusTrap,
   VirtualList,
@@ -129,7 +129,7 @@ import {
   toast,
   withScopedStyle,
   zipMask
-} from "./chunk-DR7H6UGM.js";
+} from "./chunk-XIHMS2Y6.js";
 import {
   RenderProp,
   assertType,
@@ -156,7 +156,7 @@ import {
   select,
   tabs,
   tooltip
-} from "./chunk-6LG2T7LO.js";
+} from "./chunk-FMHIQNMP.js";
 import {
   animationFrame,
   battery,
@@ -194,7 +194,7 @@ import {
   visibility,
   wakeLock,
   windowSize
-} from "./chunk-EWEE7NBF.js";
+} from "./chunk-DAKLOMKS.js";
 import "./chunk-H3SRKIYX.js";
 import "./chunk-52XFPGSN.js";
 import {
@@ -219,7 +219,7 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-NF3LYCQH.js";
+} from "./chunk-XSZRJW76.js";
 import {
   SibuError,
   checkLeaks,
@@ -257,7 +257,7 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-F64ZPCFE.js";
+} from "./chunk-4RH6D7GR.js";
 import {
   antdAdapter,
   chakraAdapter,
@@ -267,7 +267,7 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-WN6WDFCB.js";
+} from "./chunk-FB7KQXZI.js";
 import {
   createPlugin,
   createPluginRegistry,
@@ -279,7 +279,7 @@ import {
   triggerPluginMount,
   triggerPluginUnmount
 } from "./chunk-WWV3SJ3L.js";
-import "./chunk-ES2GERY2.js";
+import "./chunk-MRAMKDHQ.js";
 import {
   collectStream,
   deserializeState,
@@ -300,15 +300,15 @@ import {
   suspenseSwapScript,
   trustHTML
 } from "./chunk-HYCCIYNS.js";
-import "./chunk-RRIDJQ5C.js";
+import "./chunk-KSOEJGFO.js";
 import "./chunk-CCSJMTRN.js";
-import "./chunk-O3QQ3XOL.js";
-import "./chunk-DQVUBVNX.js";
-import "./chunk-4MFZMLUU.js";
-import "./chunk-Z2CE42DB.js";
+import "./chunk-5GJ5RTHA.js";
+import "./chunk-I3VI34DP.js";
+import "./chunk-SHDVWATN.js";
+import "./chunk-DCDS2PQ6.js";
 import "./chunk-5INI7D2L.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-PBQEW5VW.js";
+import "./chunk-PFTDGEPZ.js";
 import "./chunk-TIRZCERI.js";
 import {
   TransitionGroup,
@@ -332,10 +332,10 @@ import {
   stagger,
   transition,
   viewTransition
-} from "./chunk-E62UADKL.js";
+} from "./chunk-IM7N5WR4.js";
 import "./chunk-DHDZ7IVN.js";
-import "./chunk-W55YHPEP.js";
-import "./chunk-ACBT6UZS.js";
+import "./chunk-UFSQEO7P.js";
+import "./chunk-D3SZ4LVS.js";
 import "./chunk-VPP2FONR.js";
 export {
   DOMPool,

package/dist/index.cjs

@@ -95,6 +95,7 @@ __export(index_exports, {
   enhance: () => enhance,
   enhanceAll: () => enhanceAll,
   enqueueBatchedSignal: () => enqueueBatchedSignal,
+  external: () => external,
   fieldset: () => fieldset,
   figcaption: () => figcaption,
   figure: () => figure,
@@ -909,7 +910,14 @@ function reactiveBinding(commit, ownerNode) {
   subscriber._disposed = false;
   subscriber._errorPhase = "binding";
   subscriber._errorNode = ownerNode;
-  run();
+  try {
+    run();
+  } catch (err) {
+    subscriber._disposed = true;
+    subscriber._errorNode = void 0;
+    cleanup(subscriber);
+    throw err;
+  }
   return subscriber._dispose ?? (subscriber._dispose = () => {
     subscriber._disposed = true;
     subscriber._errorNode = void 0;
@@ -1141,7 +1149,7 @@ function forEachSubscriber(signal2, visit) {
 
 // src/reactivity/track.ts
 var _isDev4 = isDev();
-var _runtimeVersion = true ? "4.0.0" : "dev";
+var _runtimeVersion = true ? "4.1.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -1364,9 +1372,9 @@ function toKebab(prop) {
 }
 function applyStyle(el, style2) {
   if (typeof style2 === "function") {
-    const teardown = track2(() => {
+    const teardown = reactiveBinding2(() => {
       el.setAttribute("style", sanitizeStyleAttribute(String(style2())));
-    });
+    }, el);
     registerDisposer(el, teardown);
     return;
   }
@@ -1380,9 +1388,9 @@ function applyStyle(el, style2) {
     const name = toKebab(prop);
     if (typeof val === "function") {
       const getter = val;
-      const teardown = track2(() => {
+      const teardown = reactiveBinding2(() => {
         htmlEl.style.setProperty(name, sanitizeCSSValue(String(getter())));
-      });
+      }, el);
       registerDisposer(el, teardown);
     } else {
       htmlEl.style.setProperty(name, sanitizeCSSValue(String(val)));
@@ -1395,9 +1403,9 @@ function applyClass(el, cls) {
     return;
   }
   if (typeof cls === "function") {
-    const teardown = track2(() => {
+    const teardown = reactiveBinding2(() => {
       el.setAttribute("class", cls());
-    });
+    }, el);
     registerDisposer(el, teardown);
     return;
   }
@@ -1422,7 +1430,7 @@ function applyClass(el, cls) {
       }
       el.setAttribute("class", r);
     };
-    const teardown = track2(update);
+    const teardown = reactiveBinding2(update, el);
     registerDisposer(el, teardown);
   } else {
     el.setAttribute("class", result);
@@ -2396,6 +2404,17 @@ function signal(initial, options) {
   }
   return [get, set];
 }
+function external(options) {
+  const [version, bump] = signal(0, options?.name ? { name: options.name } : void 0);
+  return {
+    track() {
+      version();
+    },
+    invalidate() {
+      bump((n) => n + 1);
+    }
+  };
+}
 
 // src/components/ErrorDisplay.ts
 var STYLES = `
@@ -4960,6 +4979,7 @@ function drainTeardowns(teardowns, label2) {
     }
   }
 }
+var EACH_KEYS = ["text", "attr", "class", "show", "on", "cleanup"];
 function resolveTarget(root, target) {
   if (target == null) return root;
   if (typeof target !== "string") return target;
@@ -4970,6 +4990,11 @@ function resolveTarget(root, target) {
     return null;
   }
 }
+function bindNode(el, commit) {
+  if (isSSR()) return () => {
+  };
+  return reactiveBinding2(commit, el);
+}
 function readControlValue(el) {
   if (el instanceof HTMLInputElement) {
     if (el.type === "checkbox") return el.checked;
@@ -4993,6 +5018,50 @@ function writeControlValue(el, value) {
   const next = value == null ? "" : String(value);
   if (el.value !== next) el.value = next;
 }
+function applyEachBindings(ctx, el, spec, index) {
+  const where = `ctx.each[${index}]`;
+  if (isDev()) {
+    for (const key of Object.keys(spec)) {
+      devAssert(
+        EACH_KEYS.includes(key),
+        `${where}: unknown binding "${key}". Expected one of: ${EACH_KEYS.join(", ")}.`
+      );
+    }
+  }
+  if (spec.text !== void 0) {
+    devAssert(typeof spec.text === "function", `${where}: "text" must be a function returning the value.`);
+    ctx.text(el, spec.text);
+  }
+  if (spec.attr !== void 0) {
+    for (const name of Object.keys(spec.attr)) {
+      const value = spec.attr[name];
+      devAssert(typeof value === "function", `${where}: attr["${name}"] must be a function returning the value.`);
+      ctx.attr(el, name, value);
+    }
+  }
+  if (spec.class !== void 0) {
+    for (const name of Object.keys(spec.class)) {
+      const on2 = spec.class[name];
+      devAssert(typeof on2 === "function", `${where}: class["${name}"] must be a function returning a boolean.`);
+      ctx.classed(el, name, on2);
+    }
+  }
+  if (spec.show !== void 0) {
+    devAssert(typeof spec.show === "function", `${where}: "show" must be a function returning a boolean.`);
+    ctx.show(el, spec.show);
+  }
+  if (spec.on !== void 0) {
+    for (const event of Object.keys(spec.on)) {
+      const handler = spec.on[event];
+      devAssert(typeof handler === "function", `${where}: on["${String(event)}"] must be a function.`);
+      ctx.on(el, event, handler);
+    }
+  }
+  if (spec.cleanup !== void 0) {
+    devAssert(typeof spec.cleanup === "function", `${where}: "cleanup" must be a function.`);
+    ctx.cleanup(spec.cleanup);
+  }
+}
 function enhance(target, setup) {
   const root = typeof target === "string" ? typeof document !== "undefined" ? document.querySelector(target) : null : target;
   if (!root) {
@@ -5043,7 +5112,7 @@ function enhance(target, setup) {
     text: (t, value) => {
       bind(t, (el) => {
         teardowns.push(
-          effect(() => {
+          bindNode(el, () => {
             const v = value();
             const next = v == null ? "" : String(v);
             if (el.textContent !== next) el.textContent = next;
@@ -5054,7 +5123,7 @@ function enhance(target, setup) {
     attr: (t, name, value) => {
       bind(t, (el) => {
         teardowns.push(
-          effect(() => {
+          bindNode(el, () => {
             const v = value();
             const next = v == null ? null : String(v);
             setSafeAttribute(el, name, next, { syncValueProperty: false, label: "enhance attr()" });
@@ -5065,7 +5134,7 @@ function enhance(target, setup) {
     classed: (t, name, on2) => {
       bind(t, (el) => {
         teardowns.push(
-          effect(() => {
+          bindNode(el, () => {
             el.classList.toggle(name, Boolean(on2()));
           })
         );
@@ -5075,7 +5144,7 @@ function enhance(target, setup) {
       bind(t, (el) => {
         const prevHidden = el.hidden;
         teardowns.push(
-          effect(() => {
+          bindNode(el, () => {
             el.hidden = !when2();
           })
         );
@@ -5090,7 +5159,7 @@ function enhance(target, setup) {
         const [get, set] = state2;
         const evt = options?.event ?? (control instanceof HTMLSelectElement || control instanceof HTMLInputElement && (control.type === "checkbox" || control.type === "radio") ? "change" : "input");
         teardowns.push(
-          effect(() => {
+          bindNode(el, () => {
             writeControlValue(control, get());
           })
         );
@@ -5099,6 +5168,16 @@ function enhance(target, setup) {
         teardowns.push(() => control.removeEventListener(evt, onInput));
       });
     },
+    each: (target_, describe2) => {
+      devAssert(typeof describe2 === "function", "ctx.each: second argument must be a function.");
+      const elements = typeof target_ === "string" ? ctx.refs(target_) : Array.from(target_);
+      for (let i2 = 0; i2 < elements.length; i2++) {
+        const el = elements[i2];
+        const spec = describe2(el, i2);
+        if (spec == null) continue;
+        applyEachBindings(ctx, el, spec, i2);
+      }
+    },
     cleanup: (fn) => {
       teardowns.push(fn);
     }
@@ -5474,6 +5553,7 @@ function nextTick() {
   enhance,
   enhanceAll,
   enqueueBatchedSignal,
+  external,
   fieldset,
   figcaption,
   figure,

package/dist/index.d.cts

@@ -1186,6 +1186,70 @@ interface SignalOptions<T = unknown> {
  * @param options Optional config: `{ name: "count" }` for devtools labeling
  */
 declare function signal<T>(initial: T, options?: SignalOptions<T>): StateTuple<T>;
+/**
+ * A valueless reactive token standing in for state SibuJS does not own.
+ *
+ * See {@link external}.
+ */
+interface ExternalSource {
+    /**
+     * Declare, from inside a reactive computation, that it reads the external
+     * state this source represents. Call it in the same places you would read a
+     * signal — the top of a binding getter, a `derived()` body, an `effect()`.
+     *
+     * Outside a tracking context it is a no-op, exactly like reading a signal.
+     */
+    track(): void;
+    /**
+     * Declare that the external state changed. Every consumer that called
+     * {@link ExternalSource.track} is invalidated.
+     *
+     * Participates in `batch()` like any signal write: inside a batch, consumers
+     * are notified once when the outermost batch flushes.
+     */
+    invalidate(): void;
+}
+/**
+ * Create a reactive source for state that lives outside SibuJS — a domain
+ * engine, a media element, a canvas scene, an editor document, a cache a
+ * socket writes into.
+ *
+ * The pattern is two lines: `track()` where you read, `invalidate()` after you
+ * mutate.
+ *
+ * ```ts
+ * import { Chess } from "chess.js";
+ * import { external } from "sibujs";
+ *
+ * const game = new Chess();      // owns the rules and the mutable state
+ * const moved = external();      // owns "something changed"
+ *
+ * ctx.text("@status", () => {
+ *   moved.track();               // this binding reads the engine
+ *   return game.isCheckmate() ? "Checkmate" : `${game.turn()} to move`;
+ * });
+ *
+ * game.move({ from: "e2", to: "e4" });
+ * moved.invalidate();            // every consumer above re-reads
+ * ```
+ *
+ * **One source is one invalidation domain.** Every consumer of a source
+ * re-runs on every `invalidate()`, so the granularity of your updates is
+ * exactly the granularity of your sources: one for a whole engine is the
+ * cheapest to write, several (`board`, `clock`, `history`) let an update touch
+ * only what it affects. See `docs/architecture/external-state.md` for the
+ * trade-offs and when subdividing is worth it.
+ *
+ * Ownership, disposal and error routing are the consumer's, not the source's:
+ * a disposed binding or effect is never invalidated, and a consumer that
+ * throws is reported through the normal runtime error pipeline with its own
+ * phase and node.
+ *
+ * @param options `name` labels the source in devtools (development only).
+ */
+declare function external(options?: {
+    name?: string;
+}): ExternalSource;
 
 /**
  * Reactive array hook. Provides common array operations that
@@ -1683,6 +1747,37 @@ declare function strict<T>(fn: () => T): T;
  */
 declare function strictEffect(fn: () => void): () => void;
 
+/** Event handlers for {@link EachBindings}, typed per event name. */
+type EachEventBindings = {
+    [K in keyof HTMLElementEventMap]?: (event: HTMLElementEventMap[K], el: HTMLElement) => void;
+};
+/**
+ * What {@link EnhanceContext.each} attaches to one element.
+ *
+ * Every field maps one-to-one onto an existing `ctx.*` helper and is committed
+ * through it — this is a shorthand for calls you could write by hand, not a
+ * template language and not a second binding engine. There is no expression
+ * parsing, no string interpolation and no `eval`: every value is a plain
+ * function you wrote, so it stays CSP-safe and fully type-checked.
+ *
+ * Anything not covered here (two-way `model()`, listener options, a nested
+ * `enhance`) is written imperatively in the same callback — it receives the
+ * element, so `ctx.model(el, …)` beside a returned descriptor is normal.
+ */
+interface EachBindings {
+    /** Reactive `textContent` — same as `ctx.text(el, value)`. */
+    text?: () => unknown;
+    /** Reactive attributes by name — same as `ctx.attr(el, name, value)`. */
+    attr?: Record<string, () => unknown>;
+    /** Reactive class toggles by class name — same as `ctx.classed(el, name, on)`. */
+    class?: Record<string, () => boolean>;
+    /** Reactive visibility — same as `ctx.show(el, when)`. */
+    show?: () => boolean;
+    /** Event listeners by event name — same as `ctx.on(el, event, handler)`. */
+    on?: EachEventBindings;
+    /** Per-element teardown, run with the rest of the enhancement's cleanups. */
+    cleanup?: () => void;
+}
 /**
  * Helpers handed to an `enhance` setup. Every binding is fine-grained (its own
  * effect) and auto-disposed when the root element (or the returned dispose) is
@@ -1715,6 +1810,43 @@ interface EnhanceContext {
     model<T>(target: string | Element, state: readonly [() => T, (value: T) => void], options?: {
         event?: string;
     }): void;
+    /**
+     * Bind a set of elements the server already rendered — a board, a table, a
+     * keyboard, a timeline, a legend — one descriptor at a time.
+     *
+     * The callback receives each element and its index and returns what to
+     * attach; every field is committed through the matching `ctx.*` helper, so
+     * ownership, disposal, write elision, attribute sanitization and error
+     * routing are byte-for-byte the same as writing the calls out by hand. No
+     * element is created, replaced, moved or re-parented — node identity is
+     * preserved, which is the entire point of enhancing existing markup.
+     *
+     * ```ts
+     * ctx.each<HTMLButtonElement>("@square", (el) => {
+     *   const square = el.dataset.square as Square;
+     *   return {
+     *     text: () => pieceAt(square),
+     *     class: { selected: () => selected() === square },
+     *     attr: { "aria-label": () => describe(square) },
+     *     on: { click: () => choose(square) },
+     *   };
+     * });
+     * ```
+     *
+     * The callback may also return nothing and wire the element imperatively —
+     * `ctx.model(el, …)`, `ctx.on(el, "click", h, { passive: true })` — for the
+     * cases the descriptor deliberately does not cover.
+     *
+     * Zero matches is a silent no-op. Calling `each` twice over the same
+     * elements creates two independent sets of bindings, exactly as calling
+     * `ctx.text()` twice on one node does; the helper is sugar over those calls
+     * and does not track what a previous call attached.
+     *
+     * @param target A `@ref`/CSS selector resolved with {@link EnhanceContext.refs},
+     *   or any iterable of elements (an array, a `NodeList`, an `HTMLCollection`).
+     * @param describe Called once per element, in document order.
+     */
+    each<T extends Element = HTMLElement>(target: string | Iterable<Element>, describe: (element: T, index: number) => EachBindings | void): void;
     /** Register arbitrary teardown to run on disposal. */
     cleanup(fn: () => void): void;
 }
@@ -2021,4 +2153,4 @@ declare const untracked: ReactiveApi["untracked"];
 declare const retrack: ReactiveApi["retrack"];
 declare const setMaxDrainIterations: ReactiveApi["setMaxDrainIterations"];
 
-export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedContext, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EffectBody, type EffectOptions, type EnhanceContext, type EnhanceSetup, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, type IslandLoader, type IslandRegistration, type IslandStrategy, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, MAX_DRAIN_TEARDOWNS, type MediaProps, type MountIslandsOptions, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type RuntimeErrorContext, type RuntimeErrorHandler, type RuntimeErrorPhase, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enhance, enhanceAll, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getRuntimeErrorHandler, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, lazyIsland, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, mountIslands, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, registerIsland, replaceChildrenSafely, reportDrainRunaway, reportError, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, setRuntimeErrorHandler, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, unregisterDisposer, unregisterIsland, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedContext, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EachBindings, type EachEventBindings, type EffectBody, type EffectOptions, type EnhanceContext, type EnhanceSetup, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type ExternalSource, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, type IslandLoader, type IslandRegistration, type IslandStrategy, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, MAX_DRAIN_TEARDOWNS, type MediaProps, type MountIslandsOptions, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type RuntimeErrorContext, type RuntimeErrorHandler, type RuntimeErrorPhase, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enhance, enhanceAll, enqueueBatchedSignal, external, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getRuntimeErrorHandler, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, lazyIsland, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, mountIslands, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, registerIsland, replaceChildrenSafely, reportDrainRunaway, reportError, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, setRuntimeErrorHandler, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, unregisterDisposer, unregisterIsland, untracked, use, var_, video, watch, when, withSSR, writable };