sibujs 4.4.0 → 4.5.0

package/dist/{chunk-HFCOH2GN.js → chunk-GW3SCCZG.js}

@@ -1,22 +1,22 @@
 import {
   watch
-} from "./chunk-RR7M3FHM.js";
+} from "./chunk-7LN645I6.js";
 import {
   createId
 } from "./chunk-CCSJMTRN.js";
 import {
   derived
-} from "./chunk-W2EQ7X2L.js";
+} from "./chunk-RBTPLM32.js";
 import {
   stripHtml
 } from "./chunk-IXKSNWV5.js";
 import {
   effect
-} from "./chunk-7GIHSAWB.js";
+} from "./chunk-RIXRAYIU.js";
 import {
   batch,
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 
 // src/widgets/Combobox.ts
 var boundComboboxes = /* @__PURE__ */ new WeakMap();

package/dist/{chunk-PNIRUQ4C.js → chunk-KEISJXBU.js}

@@ -1,7 +1,7 @@
 import {
   bindAttribute,
   setSafeAttribute
-} from "./chunk-VCTAEPSB.js";
+} from "./chunk-ONOHFDLG.js";
 import {
   isEventHandlerAttr,
   sanitizeCSSValue,
@@ -13,7 +13,7 @@ import {
 } from "./chunk-QKRPLZ2V.js";
 import {
   reactiveBinding
-} from "./chunk-3BTTCZ5J.js";
+} from "./chunk-UGRX3S57.js";
 import {
   DEV,
   devWarn,

package/dist/{chunk-LYVUX7NT.js → chunk-OMJJM3KM.js}

@@ -6,11 +6,11 @@ import {
 } from "./chunk-52XFPGSN.js";
 import {
   effect
-} from "./chunk-7GIHSAWB.js";
+} from "./chunk-RIXRAYIU.js";
 import {
   batch,
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 import {
   reportError
 } from "./chunk-2WLZ6757.js";

package/dist/{chunk-VCTAEPSB.js → chunk-ONOHFDLG.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-IXKSNWV5.js";
 import {
   reactiveBinding
-} from "./chunk-3BTTCZ5J.js";
+} from "./chunk-UGRX3S57.js";
 import {
   DEV,
   devWarn,
@@ -62,6 +62,14 @@ function setSafeAttribute(el, name, value, options = {}) {
   const html = isHtmlElement(el);
   const idlName = html ? name.toLowerCase() : name;
   if (typeof value === "boolean") {
+    if (name.length > 5 && name.slice(0, 5).toLowerCase() === "aria-") {
+      const token = value ? "true" : "false";
+      if ((ns ? el.getAttributeNS(ns, localName) : el.getAttribute(name)) !== token) {
+        if (ns) el.setAttributeNS(ns, name, token);
+        else el.setAttribute(name, token);
+      }
+      return true;
+    }
     if (html && BOOLEAN_IDL_ATTRS.has(idlName) && idlName in el) {
       setProp(el, idlName, value);
     } else if (value) {

package/dist/{chunk-36S2YPP4.js → chunk-PCT43HW3.js}

@@ -1,7 +1,7 @@
 import {
   SVG_NS,
   tagFactory
-} from "./chunk-PNIRUQ4C.js";
+} from "./chunk-KEISJXBU.js";
 
 // src/core/rendering/html.ts
 var html = tagFactory("html");

package/dist/{chunk-W2EQ7X2L.js → chunk-RBTPLM32.js}

@@ -1,9 +1,10 @@
 import {
+  cleanup,
   isTrackingSuspended,
   recordDependency,
   retrack,
   track
-} from "./chunk-3BTTCZ5J.js";
+} from "./chunk-UGRX3S57.js";
 import {
   devAssert
 } from "./chunk-2WLZ6757.js";
@@ -16,10 +17,14 @@ function derived(getter, options) {
   const cs = {};
   cs._d = false;
   cs._init = false;
+  cs._f = false;
   cs._g = getter;
   cs.__v = 0;
+  let evaluating = false;
+  let disposed = false;
+  let pendingError;
   const markDirty = () => {
-    if (cs._d) return;
+    if (cs._d || disposed) return;
     cs._d = true;
   };
   markDirty._c = 1;
@@ -42,33 +47,53 @@ function derived(getter, options) {
     }
   }, markDirty);
   const hook = globalThis.__SIBU_DEVTOOLS_GLOBAL_HOOK__;
-  let evaluating = false;
   const validate = () => {
-    if (!cs._d) return;
+    if (!cs._d || disposed || pendingError !== void 0) return;
     const oldValue = cs._v;
     evaluating = true;
     try {
       retrack(recompute, markDirty);
       if (!Object.is(oldValue, cs._v)) cs.__v++;
+    } catch (err) {
+      pendingError = { error: err };
+      cs.__v++;
+      if (disposed) cs._d = true;
+      else cs._f = true;
     } finally {
       evaluating = false;
+      if (disposed) cleanup(markDirty);
     }
-    if (hook && !Object.is(oldValue, cs._v)) {
+    if (hook && !disposed && !Object.is(oldValue, cs._v)) {
       hook.emit("computed:update", { signal: cs, oldValue, newValue: cs._v });
     }
   };
   cs._validate = validate;
+  const throwPending = () => {
+    const { error } = pendingError;
+    pendingError = void 0;
+    if (disposed) cs._d = false;
+    throw error;
+  };
   function computedGetter() {
     if (evaluating) {
       throw new Error(
         `[SibuJS] Circular dependency detected in derived${debugName ? ` "${debugName}"` : ""}. A derived signal cannot read itself (directly or through a chain).`
       );
     }
-    if (isTrackingSuspended()) {
-      if (cs._d) validate();
+    if (isTrackingSuspended() || disposed) {
+      if (cs._d) {
+        validate();
+        if (pendingError !== void 0) throwPending();
+      }
       return cs._v;
     }
-    if (cs._d) validate();
+    if (cs._d) {
+      validate();
+      if (pendingError !== void 0) {
+        recordDependency(cs);
+        throwPending();
+      }
+    }
     recordDependency(cs);
     return cs._v;
   }
@@ -77,6 +102,19 @@ function derived(getter, options) {
     cs.__name = debugName;
   }
   computedGetter.__signal = cs;
+  computedGetter.dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    cs._d = pendingError !== void 0;
+    cleanup(markDirty);
+    const h = globalThis.__SIBU_DEVTOOLS_GLOBAL_HOOK__;
+    if (h) {
+      try {
+        h.emit("computed:destroy", { signal: cs, getter: computedGetter });
+      } catch {
+      }
+    }
+  };
   if (hook) hook.emit("computed:create", { signal: cs, name: debugName, getter: computedGetter });
   return computedGetter;
 }

package/dist/{chunk-7GIHSAWB.js → chunk-RIXRAYIU.js}

@@ -5,7 +5,7 @@ import {
   cleanup,
   retrack,
   untracked
-} from "./chunk-3BTTCZ5J.js";
+} from "./chunk-UGRX3S57.js";
 import {
   devAssert,
   reportError

package/dist/{chunk-HQSEH5F6.js → chunk-RJE2BNI4.js}

@@ -6,7 +6,7 @@ import {
 import {
   div,
   span
-} from "./chunk-36S2YPP4.js";
+} from "./chunk-PCT43HW3.js";
 import {
   STATIC_VALUE_RESOLVER,
   planHeadElementEntry,
@@ -20,7 +20,7 @@ import {
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-7GIHSAWB.js";
+} from "./chunk-RIXRAYIU.js";
 import {
   registerDisposer,
   replaceChildrenSafely
@@ -28,7 +28,7 @@ import {
 import {
   batch,
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 
 // src/platform/head.ts
 function escapeScriptJsonLocal(json) {

package/dist/{chunk-ADM46X22.js → chunk-S373NSMK.js}

@@ -135,42 +135,42 @@ import {
   use,
   var_,
   video
-} from "./chunk-36S2YPP4.js";
+} from "./chunk-PCT43HW3.js";
 import {
   trustHTML
 } from "./chunk-NIOYEGBQ.js";
 import {
   watch
-} from "./chunk-RR7M3FHM.js";
+} from "./chunk-7LN645I6.js";
 import {
   __resetIdCounter,
   createId
 } from "./chunk-CCSJMTRN.js";
 import {
   context
-} from "./chunk-7NBDXVHS.js";
+} from "./chunk-VUF4ALSW.js";
 import {
   SVG_NS,
   bindChildNode,
   captureFocusWithin,
   restoreFocusWithin,
   tagFactory
-} from "./chunk-PNIRUQ4C.js";
+} from "./chunk-KEISJXBU.js";
 import {
   bindAttribute,
   bindDynamic,
   setSafeAttribute
-} from "./chunk-VCTAEPSB.js";
+} from "./chunk-ONOHFDLG.js";
 import {
   derived
-} from "./chunk-W2EQ7X2L.js";
+} from "./chunk-RBTPLM32.js";
 import {
   globalSingleton
 } from "./chunk-7ZHH77QA.js";
 import {
   effect,
   on
-} from "./chunk-7GIHSAWB.js";
+} from "./chunk-RIXRAYIU.js";
 import {
   disableSSR,
   enableSSR,
@@ -195,7 +195,7 @@ import {
   external,
   isBatching,
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 import {
   notifySubscribers,
   reactiveBinding,
@@ -206,7 +206,7 @@ import {
   suspendTracking,
   track,
   untracked
-} from "./chunk-3BTTCZ5J.js";
+} from "./chunk-UGRX3S57.js";
 import {
   DEV,
   __export,
@@ -1757,7 +1757,7 @@ function show(condition, element) {
   const update = () => {
     resolved.style.display = condition() ? "" : "none";
   };
-  registerDisposer(resolved, track(update));
+  registerDisposer(resolved, reactiveBinding(update, resolved));
   return resolved;
 }
 function attachBranch(parent, anchor, branch, attachedOnce, where) {
@@ -1802,7 +1802,7 @@ function when(condition, thenBranch, elseBranch) {
     restoreFocusWithin(focused, currentNode ? [currentNode] : [], "when");
     initialized = true;
   };
-  registerDisposer(anchor, track(update));
+  registerDisposer(anchor, reactiveBinding(update, anchor));
   if (!initialized) {
     queueMicrotask(() => {
       if (!initialized && anchor.parentNode) update();
@@ -1836,7 +1836,7 @@ function match(value, cases, fallback) {
     restoreFocusWithin(focused, currentNode ? [currentNode] : [], "match");
     initialized = true;
   };
-  registerDisposer(anchor, track(update));
+  registerDisposer(anchor, reactiveBinding(update, anchor));
   if (!initialized) {
     queueMicrotask(() => {
       if (!initialized && anchor.parentNode) update();
@@ -1991,7 +1991,12 @@ function each(getArray, render, options) {
         const [indexGetter, setIndex] = signal(i2);
         let node;
         try {
-          node = resolveNodeChild(render(itemGetter, indexGetter));
+          suspendTracking();
+          try {
+            node = resolveNodeChild(render(itemGetter, indexGetter));
+          } finally {
+            resumeTracking();
+          }
         } catch (err) {
           const key2 = newKeys[i2];
           node = document.createComment(`each:error:${i2}`);

package/dist/{chunk-M2F7TZHH.js → chunk-TBYTO6BS.js}

@@ -6,14 +6,14 @@ import {
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-7GIHSAWB.js";
+} from "./chunk-RIXRAYIU.js";
 import {
   dispose,
   replaceChildrenSafely
 } from "./chunk-QKRPLZ2V.js";
 import {
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 import {
   DEV,
   devWarn,

package/dist/{chunk-3BTTCZ5J.js → chunk-UGRX3S57.js}

@@ -151,6 +151,15 @@ function untracked(fn) {
 var subscriberEpochCounter = 0;
 function retrack(effectFn, subscriber) {
   const prev = currentSubscriber;
+  let savedDepth = 0;
+  let savedSuspendSub = null;
+  if (trackingSuspended) {
+    savedDepth = suspendDepth;
+    savedSuspendSub = suspendSavedSub;
+    suspendDepth = 0;
+    suspendSavedSub = null;
+    trackingSuspended = false;
+  }
   currentSubscriber = subscriber;
   const sub = subscriber;
   const epoch = ++subscriberEpochCounter;
@@ -165,6 +174,11 @@ function retrack(effectFn, subscriber) {
     effectFn();
   } finally {
     currentSubscriber = prev;
+    if (savedDepth !== 0) {
+      suspendDepth = savedDepth;
+      suspendSavedSub = savedSuspendSub;
+      trackingSuspended = true;
+    }
     let node = sub.depsHead ?? null;
     while (node !== null) {
       const next = node.subNext;
@@ -184,11 +198,25 @@ function track(effectFn, subscriber) {
   if (!subscriber) return reactiveBinding(effectFn);
   cleanup(subscriber);
   const prev = currentSubscriber;
+  let savedDepth = 0;
+  let savedSuspendSub = null;
+  if (trackingSuspended) {
+    savedDepth = suspendDepth;
+    savedSuspendSub = suspendSavedSub;
+    suspendDepth = 0;
+    suspendSavedSub = null;
+    trackingSuspended = false;
+  }
   currentSubscriber = subscriber;
   try {
     effectFn();
   } finally {
     currentSubscriber = prev;
+    if (savedDepth !== 0) {
+      suspendDepth = savedDepth;
+      suspendSavedSub = savedSuspendSub;
+      trackingSuspended = true;
+    }
     const sub2 = subscriber;
     for (let n = sub2.depsHead ?? null; n !== null; n = n.subNext) {
       const sig = n.sig;
@@ -359,8 +387,9 @@ function propagateDirty(sub) {
         if (s._c) {
           const nSig = s._sig;
           if (nSig) {
-            if (!nSig._d) {
+            if (!nSig._d || nSig._f === true) {
               nSig._d = true;
+              nSig._f = false;
               stack.push(nSig);
             }
           } else {
@@ -460,7 +489,7 @@ function forEachSubscriber(signal, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.4.0" : "dev";
+var _runtimeVersion = true ? "4.5.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;

package/dist/{chunk-7NBDXVHS.js → chunk-VUF4ALSW.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-5DXA2J44.js";
 import {
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 import {
   DEV,
   devWarn

package/dist/{chunk-LQFGQNMV.js → chunk-VZKNK2V7.js}

@@ -4,14 +4,14 @@ import {
 } from "./chunk-H3SRKIYX.js";
 import {
   derived
-} from "./chunk-W2EQ7X2L.js";
+} from "./chunk-RBTPLM32.js";
 import {
   effect
-} from "./chunk-7GIHSAWB.js";
+} from "./chunk-RIXRAYIU.js";
 import {
   batch,
   signal
-} from "./chunk-NVNJH22U.js";
+} from "./chunk-XZZOBQAY.js";
 
 // src/patterns/machine.ts
 function machine(config) {
@@ -487,7 +487,12 @@ function timeline(initial, maxHistory = 100) {
       setIndex(targetIndex);
     }
   }
-  return { value, set, undo, redo, canUndo, canRedo, history, index, reset, jumpTo };
+  function dispose() {
+    value.dispose();
+    canUndo.dispose();
+    canRedo.dispose();
+  }
+  return { value, set, undo, redo, canUndo, canRedo, history, index, reset, jumpTo, dispose };
 }
 
 // src/patterns/globalStore.ts

package/dist/{chunk-NVNJH22U.js → chunk-XZZOBQAY.js}

@@ -3,7 +3,7 @@ import {
   notifySubscribers,
   queueSignalNotification,
   recordDependency
-} from "./chunk-3BTTCZ5J.js";
+} from "./chunk-UGRX3S57.js";
 import {
   DEV
 } from "./chunk-2WLZ6757.js";

package/dist/{customElement-CNZxEB9G.d.ts → customElement-OB9CIsc5.d.cts}

@@ -148,6 +148,17 @@ interface VirtualListProps<T> {
 }
 /**
  * VirtualList renders only visible items for efficient large-list rendering.
+ *
+ * Scope — it virtualizes ONE axis:
+ *   - vertical only, inside a container of fixed `containerHeight`;
+ *   - every item has the same fixed `itemHeight`;
+ *   - on each scroll or `items()` change the visible window is disposed and
+ *     re-rendered through `renderItem` (no keyed reuse of item nodes);
+ *   - no horizontal virtualization, frozen rows/columns or sticky headers.
+ *
+ * Two-axis content (spreadsheets, large grids with frozen headers) needs its
+ * own windowing, typically a keyed `each()` over the visible row indices with a
+ * nested keyed `each()` over the visible column indices.
  */
 declare function VirtualList<T>(props: VirtualListProps<T>): HTMLElement;
 
@@ -302,6 +313,12 @@ declare function bindAttrs(el: HTMLElement, attrs: Record<string, AttributeSourc
  * Reactively toggle a boolean attribute (like disabled, readonly, hidden).
  * When the value is truthy the attribute is present (set to ""),
  * when falsy the attribute is removed entirely.
+ *
+ * `aria-*` names are the exception, as in every attribute writer: ARIA states
+ * are "true"/"false" tokens, and a missing state means "not applicable" rather
+ * than `false`, so `bindBoolAttr(el, "aria-busy", false)` writes
+ * `aria-busy="false"`. This helper cannot remove an ARIA attribute; use
+ * `bindAttribute(el, "aria-busy", () => (busy() ? true : null))` for that.
  * Returns a teardown function to stop reactive tracking.
  *
  * The attribute NAME is policed too: `bindBoolAttr(el, "onclick", true)` would
@@ -403,14 +420,7 @@ declare function infiniteScroll(options: {
     dispose: () => void;
 };
 
-/**
- * pagination provides reactive pagination state and controls.
- */
-declare function pagination(options: {
-    totalItems: () => number;
-    pageSize?: number;
-    initialPage?: number;
-}): {
+interface PaginationResult {
     page: () => number;
     pageSize: () => number;
     totalPages: () => number;
@@ -419,7 +429,25 @@ declare function pagination(options: {
     goTo: (page: number) => void;
     startIndex: () => number;
     endIndex: () => number;
-};
+    /**
+     * Release the subscriptions to `totalItems`. Call it when the pagination is
+     * discarded before the state it reads. Afterwards the accessors return their
+     * last values and the controls no longer move the page. Idempotent.
+     */
+    dispose: () => void;
+}
+/**
+ * pagination provides reactive pagination state and controls.
+ *
+ * It subscribes to the caller's `totalItems` getter, which usually lives longer
+ * than the pagination itself (a store, a query result). Call `dispose()` when
+ * the pagination is no longer used, e.g. `onUnmount(pager.dispose, el)`.
+ */
+declare function pagination(options: {
+    totalItems: () => number;
+    pageSize?: number;
+    initialPage?: number;
+}): PaginationResult;
 
 /**
  * eventBus creates a typed publish/subscribe event system.
@@ -458,4 +486,4 @@ declare function defineElement(name: string, component: (props: Record<string, u
  */
 declare function svgElement(tag: string, props?: Record<string, unknown>, ...nodes: (SVGElement | string)[]): SVGElement;
 
-export { type AttributeSource as A, type BoundFieldProps as B, type CustomElementOptions as C, intersection as D, lazyLoad as E, type FieldConfig as F, matchesPattern as G, max as H, type IntersectionResult as I, maxLength as J, min as K, minLength as L, type MaskOptions as M, pagination as N, phoneMask as O, removeScopedStyle as P, required as Q, scopedStyle as R, ssnMask as S, type Toast as T, svgElement as U, type ValidatorFn as V, timeMask as W, toast as X, withScopedStyle as Y, zipMask as Z, __resetDialogStack as _, type AttributeValue as a, FocusTrap as b, type FormConfig as c, type FormField as d, type FormReturn as e, type ToastInstance as f, VirtualList as g, type VirtualListProps as h, announce as i, aria as j, bindAttrs as k, bindBoolAttr as l, bindData as m, bindField as n, creditCardMask as o, custom as p, dateMask as q, defineElement as r, dialog as s, email as t, eventBus as u, focus as v, form as w, hotkey as x, infiniteScroll as y, inputMask as z };
+export { zipMask as $, type AttributeSource as A, type BoundFieldProps as B, type CustomElementOptions as C, intersection as D, lazyLoad as E, type FieldConfig as F, matchesPattern as G, max as H, type IntersectionResult as I, maxLength as J, min as K, minLength as L, type MaskOptions as M, pagination as N, phoneMask as O, type PaginationResult as P, removeScopedStyle as Q, required as R, scopedStyle as S, type Toast as T, ssnMask as U, type ValidatorFn as V, svgElement as W, timeMask as X, toast as Y, withScopedStyle as Z, __resetDialogStack as _, type AttributeValue as a, FocusTrap as b, type FormConfig as c, type FormField as d, type FormReturn as e, type ToastInstance as f, VirtualList as g, type VirtualListProps as h, announce as i, aria as j, bindAttrs as k, bindBoolAttr as l, bindData as m, bindField as n, creditCardMask as o, custom as p, dateMask as q, defineElement as r, dialog as s, email as t, eventBus as u, focus as v, form as w, hotkey as x, infiniteScroll as y, inputMask as z };

package/dist/{customElement-CNZxEB9G.d.cts → customElement-OB9CIsc5.d.ts}

@@ -148,6 +148,17 @@ interface VirtualListProps<T> {
 }
 /**
  * VirtualList renders only visible items for efficient large-list rendering.
+ *
+ * Scope — it virtualizes ONE axis:
+ *   - vertical only, inside a container of fixed `containerHeight`;
+ *   - every item has the same fixed `itemHeight`;
+ *   - on each scroll or `items()` change the visible window is disposed and
+ *     re-rendered through `renderItem` (no keyed reuse of item nodes);
+ *   - no horizontal virtualization, frozen rows/columns or sticky headers.
+ *
+ * Two-axis content (spreadsheets, large grids with frozen headers) needs its
+ * own windowing, typically a keyed `each()` over the visible row indices with a
+ * nested keyed `each()` over the visible column indices.
  */
 declare function VirtualList<T>(props: VirtualListProps<T>): HTMLElement;
 
@@ -302,6 +313,12 @@ declare function bindAttrs(el: HTMLElement, attrs: Record<string, AttributeSourc
  * Reactively toggle a boolean attribute (like disabled, readonly, hidden).
  * When the value is truthy the attribute is present (set to ""),
  * when falsy the attribute is removed entirely.
+ *
+ * `aria-*` names are the exception, as in every attribute writer: ARIA states
+ * are "true"/"false" tokens, and a missing state means "not applicable" rather
+ * than `false`, so `bindBoolAttr(el, "aria-busy", false)` writes
+ * `aria-busy="false"`. This helper cannot remove an ARIA attribute; use
+ * `bindAttribute(el, "aria-busy", () => (busy() ? true : null))` for that.
  * Returns a teardown function to stop reactive tracking.
  *
  * The attribute NAME is policed too: `bindBoolAttr(el, "onclick", true)` would
@@ -403,14 +420,7 @@ declare function infiniteScroll(options: {
     dispose: () => void;
 };
 
-/**
- * pagination provides reactive pagination state and controls.
- */
-declare function pagination(options: {
-    totalItems: () => number;
-    pageSize?: number;
-    initialPage?: number;
-}): {
+interface PaginationResult {
     page: () => number;
     pageSize: () => number;
     totalPages: () => number;
@@ -419,7 +429,25 @@ declare function pagination(options: {
     goTo: (page: number) => void;
     startIndex: () => number;
     endIndex: () => number;
-};
+    /**
+     * Release the subscriptions to `totalItems`. Call it when the pagination is
+     * discarded before the state it reads. Afterwards the accessors return their
+     * last values and the controls no longer move the page. Idempotent.
+     */
+    dispose: () => void;
+}
+/**
+ * pagination provides reactive pagination state and controls.
+ *
+ * It subscribes to the caller's `totalItems` getter, which usually lives longer
+ * than the pagination itself (a store, a query result). Call `dispose()` when
+ * the pagination is no longer used, e.g. `onUnmount(pager.dispose, el)`.
+ */
+declare function pagination(options: {
+    totalItems: () => number;
+    pageSize?: number;
+    initialPage?: number;
+}): PaginationResult;
 
 /**
  * eventBus creates a typed publish/subscribe event system.
@@ -458,4 +486,4 @@ declare function defineElement(name: string, component: (props: Record<string, u
  */
 declare function svgElement(tag: string, props?: Record<string, unknown>, ...nodes: (SVGElement | string)[]): SVGElement;
 
-export { type AttributeSource as A, type BoundFieldProps as B, type CustomElementOptions as C, intersection as D, lazyLoad as E, type FieldConfig as F, matchesPattern as G, max as H, type IntersectionResult as I, maxLength as J, min as K, minLength as L, type MaskOptions as M, pagination as N, phoneMask as O, removeScopedStyle as P, required as Q, scopedStyle as R, ssnMask as S, type Toast as T, svgElement as U, type ValidatorFn as V, timeMask as W, toast as X, withScopedStyle as Y, zipMask as Z, __resetDialogStack as _, type AttributeValue as a, FocusTrap as b, type FormConfig as c, type FormField as d, type FormReturn as e, type ToastInstance as f, VirtualList as g, type VirtualListProps as h, announce as i, aria as j, bindAttrs as k, bindBoolAttr as l, bindData as m, bindField as n, creditCardMask as o, custom as p, dateMask as q, defineElement as r, dialog as s, email as t, eventBus as u, focus as v, form as w, hotkey as x, infiniteScroll as y, inputMask as z };
+export { zipMask as $, type AttributeSource as A, type BoundFieldProps as B, type CustomElementOptions as C, intersection as D, lazyLoad as E, type FieldConfig as F, matchesPattern as G, max as H, type IntersectionResult as I, maxLength as J, min as K, minLength as L, type MaskOptions as M, pagination as N, phoneMask as O, type PaginationResult as P, removeScopedStyle as Q, required as R, scopedStyle as S, type Toast as T, ssnMask as U, type ValidatorFn as V, svgElement as W, timeMask as X, toast as Y, withScopedStyle as Z, __resetDialogStack as _, type AttributeValue as a, FocusTrap as b, type FormConfig as c, type FormField as d, type FormReturn as e, type ToastInstance as f, VirtualList as g, type VirtualListProps as h, announce as i, aria as j, bindAttrs as k, bindBoolAttr as l, bindData as m, bindField as n, creditCardMask as o, custom as p, dateMask as q, defineElement as r, dialog as s, email as t, eventBus as u, focus as v, form as w, hotkey as x, infiniteScroll as y, inputMask as z };