sibujs 4.3.0 → 4.5.0

package/dist/{contracts-Hg6ITAEF.d.ts → contracts-DBdg9J_a.d.ts}

@@ -182,6 +182,15 @@ declare function withProps<OuterProps extends object, InnerProps extends object>
 /**
  * Runtime prop validation and strict typing contracts for SibuJS.
  * Provides runtime type checking for component props in development mode.
+ *
+ * Both diagnostics here gate on `DEV`, the same foldable flag the rest of the
+ * framework uses, so a `__SIBU_DEV__: false` define removes them and their
+ * message text entirely. They used to test `process.env.NODE_ENV` directly,
+ * which is not a `define` target and does not exist in a browser at all — so
+ * every browser build treated itself as development: `validateProps` ran and
+ * warned, `assertType` threw, and the strings shipped. That went unnoticed
+ * while these functions were reachable only through a bundler; putting
+ * `patterns` on the CDN made them a production artifact.
  */
 /** Validator function: returns true if valid, or an error message string. */
 type Validator<T = unknown> = (value: T, propName: string) => true | string;
@@ -212,9 +221,19 @@ type PropSchema<Props> = {
     [K in keyof Props]: PropDef<Props[K]> | Validator<Props[K]>;
 };
 /**
- * Validate props against a schema. Returns validated props with defaults applied.
- * In production mode (process.env.NODE_ENV === 'production'), validation is skipped
- * and only defaults are applied for performance.
+ * Validate props against a schema, returning the props with defaults applied.
+ *
+ * Defaults are production behaviour; the checking is development-only and is
+ * compiled out of production builds. The two are not interchangeable when the
+ * schema's callbacks touch outside state: a validator that runs in development
+ * and not in production can leave a later property's default factory reading
+ * different state. Keep defaults and validators free of side effects if the
+ * two modes must agree exactly.
+ *
+ * @param props - The props to validate. Not mutated.
+ * @param schema - Per-property definitions, in either the shorthand
+ *   (a bare {@link Validator}) or object form.
+ * @returns A new object: the props, plus any defaults that applied.
  */
 declare function validateProps<Props extends object>(props: Partial<Props>, schema: PropSchema<Props>): Props;
 /**
@@ -228,7 +247,9 @@ declare function defineStrictComponent<Props extends object>(config: {
 }): (props: Partial<Props>) => HTMLElement;
 /**
  * Assert that a value satisfies a contract at runtime.
- * No-op in production builds.
+ *
+ * No-op in production builds — genuinely, now. The previous guard returned early
+ * only when `process` existed, so in a browser it fell through and threw.
  */
 declare function assertType<T>(value: unknown, validator: Validator<T>, label?: string): asserts value is T;
 /**

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 };

package/dist/data.cjs

@@ -295,6 +295,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;
@@ -309,6 +318,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;
@@ -328,11 +342,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;
@@ -503,8 +531,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 {
@@ -604,7 +633,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.3.0" : "dev";
+var _runtimeVersion = true ? "4.5.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -668,10 +697,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;
@@ -694,33 +727,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 {
       retrack2(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) cleanup2(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 (isTrackingSuspended2()) {
-      if (cs._d) validate();
+    if (isTrackingSuspended2() || 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) {
+        recordDependency2(cs);
+        throwPending();
+      }
+    }
     recordDependency2(cs);
     return cs._v;
   }
@@ -729,6 +782,19 @@ function derived(getter, options) {
     cs.__name = debugName;
   }
   computedGetter.__signal = cs;
+  computedGetter.dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    cs._d = pendingError !== void 0;
+    cleanup2(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;
 }
@@ -1402,6 +1468,8 @@ function query(key, fetcher, options = {}) {
     if (disposed) return;
     disposed = true;
     effectCleanup();
+    loading.dispose();
+    isStale.dispose();
     if (intervalTimer) clearInterval(intervalTimer);
     detachFromEntry();
     if (focusHandler && typeof globalThis.removeEventListener === "function") {
@@ -1691,6 +1759,10 @@ function infiniteQuery(key, fetcher, options) {
     disposed = true;
     abortController?.abort();
     effectCleanup();
+    data.dispose();
+    loading.dispose();
+    hasNextPage.dispose();
+    hasPreviousPage.dispose();
   }
   return {
     data,

package/dist/data.js

@@ -20,15 +20,15 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-7BPN4MXR.js";
-import "./chunk-L4B3Y3OM.js";
-import "./chunk-3E5YNK2F.js";
+} from "./chunk-3JZ4L5TJ.js";
+import "./chunk-VUF4ALSW.js";
+import "./chunk-RBTPLM32.js";
 import "./chunk-IXKSNWV5.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-7BJLKDBI.js";
+import "./chunk-RIXRAYIU.js";
 import "./chunk-5DXA2J44.js";
-import "./chunk-MYA5HEK5.js";
-import "./chunk-TSL64O5L.js";
+import "./chunk-XZZOBQAY.js";
+import "./chunk-UGRX3S57.js";
 import "./chunk-2WLZ6757.js";
 export {
   __resetQueryCache,

package/dist/devtools.cjs

@@ -427,6 +427,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;
@@ -441,6 +450,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;
@@ -460,11 +474,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;
@@ -635,8 +663,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 {
@@ -736,7 +765,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.3.0" : "dev";
+var _runtimeVersion = true ? "4.5.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -1102,6 +1131,16 @@ function initDevTools(config) {
     });
     emit();
   });
+  hook.on("computed:destroy", (payload) => {
+    const p = payload;
+    for (const [id, node] of hook.nodes) {
+      if (node.ref === p.signal) {
+        hook.nodes.delete(id);
+        break;
+      }
+    }
+    emit();
+  });
   hook.on("effect:create", (payload) => {
     _dt.nextNodeId++;
     const name = inferName();

package/dist/devtools.js

@@ -35,14 +35,14 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-ZVYNIUOG.js";
+} from "./chunk-FTIR4QW2.js";
 import "./chunk-IXKSNWV5.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-7BJLKDBI.js";
+import "./chunk-RIXRAYIU.js";
 import "./chunk-5DXA2J44.js";
 import "./chunk-QKRPLZ2V.js";
-import "./chunk-MYA5HEK5.js";
-import "./chunk-TSL64O5L.js";
+import "./chunk-XZZOBQAY.js";
+import "./chunk-UGRX3S57.js";
 import {
   isDev
 } from "./chunk-2WLZ6757.js";