sibujs 1.4.0 → 2.0.0

package/dist/{chunk-ZD6OAMTH.js → chunk-VLPPXTYG.js}

@@ -1,7 +1,7 @@
 import {
   devWarn,
   isDev
-} from "./chunk-5X6PP2UK.js";
+} from "./chunk-LMLD24FC.js";
 
 // src/reactivity/track.ts
 var _isDev = isDev();
@@ -9,11 +9,11 @@ var subscriberStack = new Array(32);
 var stackCapacity = 32;
 var stackTop = -1;
 var currentSubscriber = null;
-var signalSubscribers = /* @__PURE__ */ new WeakMap();
 var SUBS = "__s";
 var notifyDepth = 0;
 var pendingQueue = [];
 var pendingSet = /* @__PURE__ */ new Set();
+var propagateStack = [];
 function safeInvoke(sub) {
   try {
     sub();
@@ -23,6 +23,15 @@ function safeInvoke(sub) {
 }
 var suspendDepth = 0;
 var trackingSuspended = false;
+function retrack(effectFn, subscriber) {
+  const prev = currentSubscriber;
+  currentSubscriber = subscriber;
+  try {
+    effectFn();
+  } finally {
+    currentSubscriber = prev;
+  }
+}
 function track(effectFn, subscriber) {
   if (!subscriber) subscriber = effectFn;
   cleanup(subscriber);
@@ -90,7 +99,6 @@ function recordDependency(signal) {
   let subs = signal[SUBS];
   if (!subs) {
     subs = /* @__PURE__ */ new Set();
-    signalSubscribers.set(signal, subs);
     signal[SUBS] = subs;
   }
   subs.add(currentSubscriber);
@@ -112,57 +120,71 @@ function queueSignalNotification(signal) {
     }
   }
 }
+var maxDrainIterations = 1e5;
 function drainNotificationQueue() {
   if (notifyDepth > 0) return;
   notifyDepth++;
   try {
     let i = 0;
     while (i < pendingQueue.length) {
+      if (i >= maxDrainIterations) {
+        if (typeof console !== "undefined") {
+          console.error(
+            `[SibuJS] Notification queue exceeded ${maxDrainIterations} iterations \u2014 likely an effect that writes to a signal it reads. Breaking to prevent infinite loop.`
+          );
+        }
+        break;
+      }
       safeInvoke(pendingQueue[i]);
       i++;
     }
   } finally {
-    pendingQueue.length = 0;
-    pendingSet.clear();
     notifyDepth--;
+    if (notifyDepth === 0) {
+      pendingQueue.length = 0;
+      pendingSet.clear();
+    }
   }
 }
 function propagateDirty(sub) {
   sub();
-  let sig = sub._sig;
-  while (sig) {
+  const rootSig = sub._sig;
+  if (!rootSig) return;
+  const stack = propagateStack;
+  const baseLen = stack.length;
+  stack.push(rootSig);
+  while (stack.length > baseLen) {
+    const sig = stack.pop();
     const first = sig.__f;
     if (first) {
       if (first._c) {
         const nSig = first._sig;
-        nSig._d = true;
-        sig = nSig;
-        continue;
-      }
-      if (!pendingSet.has(first)) {
+        if (!nSig._d) {
+          nSig._d = true;
+          stack.push(nSig);
+        }
+      } else if (!pendingSet.has(first)) {
         pendingSet.add(first);
         pendingQueue.push(first);
       }
-      break;
+      continue;
     }
     const subs = sig[SUBS];
-    if (!subs) break;
-    let nextSig;
+    if (!subs) continue;
     for (const s of subs) {
       if (s._c) {
-        s();
         const nSig = s._sig;
-        if (nSig && !nextSig) {
-          nextSig = nSig;
-        } else if (nSig) {
-          propagateDirty(s);
+        if (nSig && !nSig._d) {
+          nSig._d = true;
+          stack.push(nSig);
+        } else if (!nSig) {
+          s();
         }
       } else if (!pendingSet.has(s)) {
         pendingSet.add(s);
         pendingQueue.push(s);
       }
     }
-    sig = nextSig;
   }
 }
 function notifySubscribers(signal) {
@@ -186,13 +208,23 @@ function notifySubscribers(signal) {
       }
       let i = 0;
       while (i < pendingQueue.length) {
+        if (i >= maxDrainIterations) {
+          if (typeof console !== "undefined") {
+            console.error(
+              `[SibuJS] Notification queue exceeded ${maxDrainIterations} iterations \u2014 likely an effect that writes to a signal it reads. Breaking to prevent infinite loop.`
+            );
+          }
+          break;
+        }
         safeInvoke(pendingQueue[i]);
         i++;
       }
     } finally {
-      pendingQueue.length = 0;
-      pendingSet.clear();
       notifyDepth--;
+      if (notifyDepth === 0) {
+        pendingQueue.length = 0;
+        pendingSet.clear();
+      }
     }
     return;
   }
@@ -212,30 +244,48 @@ function notifySubscribers(signal) {
   notifyDepth++;
   try {
     let directCount = 0;
+    let hasComputedSub = false;
     for (const sub of subs) {
+      if (sub._c) hasComputedSub = true;
       pendingQueue[directCount++] = sub;
     }
-    for (let i2 = 0; i2 < directCount; i2++) {
-      if (pendingQueue[i2]._c) {
-        propagateDirty(pendingQueue[i2]);
+    if (!hasComputedSub) {
+      for (let i2 = 0; i2 < directCount; i2++) {
+        safeInvoke(pendingQueue[i2]);
       }
-    }
-    for (let i2 = 0; i2 < directCount; i2++) {
-      if (!pendingQueue[i2]._c) {
-        if (!pendingSet.has(pendingQueue[i2])) {
-          safeInvoke(pendingQueue[i2]);
+    } else {
+      for (let i2 = 0; i2 < directCount; i2++) {
+        if (pendingQueue[i2]._c) {
+          propagateDirty(pendingQueue[i2]);
+        }
+      }
+      for (let i2 = 0; i2 < directCount; i2++) {
+        const sub = pendingQueue[i2];
+        if (!sub._c && !pendingSet.has(sub)) {
+          pendingSet.add(sub);
+          safeInvoke(sub);
         }
       }
     }
     let i = directCount;
     while (i < pendingQueue.length) {
+      if (i - directCount >= maxDrainIterations) {
+        if (typeof console !== "undefined") {
+          console.error(
+            `[SibuJS] Notification queue exceeded ${maxDrainIterations} iterations \u2014 likely an effect that writes to a signal it reads. Breaking to prevent infinite loop.`
+          );
+        }
+        break;
+      }
       safeInvoke(pendingQueue[i]);
       i++;
     }
   } finally {
-    pendingQueue.length = 0;
-    pendingSet.clear();
     notifyDepth--;
+    if (notifyDepth === 0) {
+      pendingQueue.length = 0;
+      pendingSet.clear();
+    }
   }
 }
 function cleanup(subscriber) {
@@ -246,7 +296,9 @@ function cleanup(subscriber) {
     if (subs) {
       subs.delete(subscriber);
       if (singleDep.__f === subscriber) {
-        singleDep.__f = void 0;
+        singleDep.__f = subs.size === 1 ? subs.values().next().value : void 0;
+      } else if (subs.size === 1 && singleDep.__f === void 0) {
+        singleDep.__f = subs.values().next().value;
       }
     }
     sub._dep = void 0;
@@ -259,7 +311,9 @@ function cleanup(subscriber) {
     if (subs) {
       subs.delete(subscriber);
       if (signal.__f === subscriber) {
-        signal.__f = void 0;
+        signal.__f = subs.size === 1 ? subs.values().next().value : void 0;
+      } else if (subs.size === 1 && signal.__f === void 0) {
+        signal.__f = subs.values().next().value;
       }
     }
   }
@@ -268,6 +322,7 @@ function cleanup(subscriber) {
 
 export {
   trackingSuspended,
+  retrack,
   track,
   untracked,
   recordDependency,

package/dist/{chunk-OUZZEE4S.js → chunk-WOMYAHHI.js}

@@ -1,19 +1,19 @@
 import {
   createPlugin
-} from "./chunk-K5ZUMYVS.js";
+} from "./chunk-3JHCYHWN.js";
 import {
   tagFactory
-} from "./chunk-B7SWRFUT.js";
+} from "./chunk-KLRMB5ZS.js";
 import {
   derived
-} from "./chunk-L6JRBDNS.js";
+} from "./chunk-54EDRCEF.js";
 import {
   effect
-} from "./chunk-6SA3QQES.js";
+} from "./chunk-HB24TBAF.js";
 import {
   batch,
   signal
-} from "./chunk-V2XTI523.js";
+} from "./chunk-CC65Y57T.js";
 
 // src/ecosystem/adapters/mobx.ts
 function mobXAdapter(options) {
@@ -21,7 +21,7 @@ function mobXAdapter(options) {
     const { autorun } = options;
     const disposers = [];
     function fromMobX(expression) {
-      const [getValue, setValue] = signal(expression());
+      const [getValue, setValue] = signal(void 0);
       const disposer = autorun(() => {
         const newValue = expression();
         batch(() => {
@@ -29,7 +29,13 @@ function mobXAdapter(options) {
         });
       });
       disposers.push(disposer);
-      return getValue;
+      const getter = (() => getValue());
+      getter.dispose = () => {
+        const i = disposers.indexOf(disposer);
+        if (i >= 0) disposers.splice(i, 1);
+        disposer();
+      };
+      return getter;
     }
     function toMobX(sibuGetter, callback) {
       return effect(() => {
@@ -57,12 +63,12 @@ function reduxAdapter(options) {
         setState(store.getState());
       });
     });
-    function useSelector(selector) {
+    function select(selector) {
       return derived(() => selector(getState()));
     }
     const api = {
       getState,
-      useSelector,
+      select,
       dispatch: store.dispatch.bind(store),
       destroy: unsubscribe
     };
@@ -80,12 +86,12 @@ function zustandAdapter(options) {
         setSibuState(state);
       });
     });
-    function useSelector(selector) {
+    function select(selector) {
       return derived(() => selector(getState()));
     }
     const api = {
       getState,
-      useSelector,
+      select,
       setState: store.setState.bind(store),
       destroy() {
         unsubscribe();

package/dist/{contracts-xo5ckdRP.d.cts → contracts-ey_Qh8ef.d.cts}

@@ -29,7 +29,7 @@ declare function withWrapper<P>(WrappedComponent: Component<P>, wrapper: (compon
  * @example
  * ```ts
  * const Button = withDefaults(RawButton, { type: "button", disabled: false });
- * Button({ nodes: "Click" }); // type="button", disabled=false automatically
+ * Button("Click"); // type="button", disabled=false automatically
  * ```
  */
 declare function withDefaults<P extends Record<string, unknown>>(component: Component<P>, defaults: Partial<P>): Component<Partial<P>>;
@@ -107,11 +107,10 @@ type WithNodes<Props> = Props & {
  * const Button = defineComponent<{ label: string; variant?: 'primary' | 'secondary'; disabled?: boolean }>({
  *   defaults: { variant: 'primary', disabled: false },
  *   setup(props) {
- *     return button({
- *       class: `btn btn-${props.variant}`,
- *       disabled: props.disabled,
- *       nodes: props.label
- *     });
+ *     return button(
+ *       { class: `btn btn-${props.variant}`, disabled: props.disabled },
+ *       props.label,
+ *     );
  *   }
  * });
  *
@@ -137,7 +136,7 @@ declare function defineComponent<Props extends Record<string, unknown>>(config:
  * const Card = defineSlottedComponent<{ title: string }>({
  *   setup(props) {
  *     const el = div({ class: 'card' });
- *     el.appendChild(h2({ nodes: props.title }));
+ *     el.appendChild(h2(props.title));
  *     if (props.nodes) {
  *       const nodes = Array.isArray(props.nodes) ? props.nodes : [props.nodes];
  *       nodes.forEach(child => el.appendChild(child));
@@ -146,7 +145,7 @@ declare function defineComponent<Props extends Record<string, unknown>>(config:
  *   }
  * });
  *
- * // Usage: Card({ title: 'Hello', nodes: p({ nodes: 'World' }) })
+ * // Usage: Card({ title: 'Hello', nodes: p('World') })
  * ```
  */
 declare function defineSlottedComponent<Props extends Record<string, unknown>>(config: {

package/dist/{contracts-xo5ckdRP.d.ts → contracts-ey_Qh8ef.d.ts}

@@ -29,7 +29,7 @@ declare function withWrapper<P>(WrappedComponent: Component<P>, wrapper: (compon
  * @example
  * ```ts
  * const Button = withDefaults(RawButton, { type: "button", disabled: false });
- * Button({ nodes: "Click" }); // type="button", disabled=false automatically
+ * Button("Click"); // type="button", disabled=false automatically
  * ```
  */
 declare function withDefaults<P extends Record<string, unknown>>(component: Component<P>, defaults: Partial<P>): Component<Partial<P>>;
@@ -107,11 +107,10 @@ type WithNodes<Props> = Props & {
  * const Button = defineComponent<{ label: string; variant?: 'primary' | 'secondary'; disabled?: boolean }>({
  *   defaults: { variant: 'primary', disabled: false },
  *   setup(props) {
- *     return button({
- *       class: `btn btn-${props.variant}`,
- *       disabled: props.disabled,
- *       nodes: props.label
- *     });
+ *     return button(
+ *       { class: `btn btn-${props.variant}`, disabled: props.disabled },
+ *       props.label,
+ *     );
  *   }
  * });
  *
@@ -137,7 +136,7 @@ declare function defineComponent<Props extends Record<string, unknown>>(config:
  * const Card = defineSlottedComponent<{ title: string }>({
  *   setup(props) {
  *     const el = div({ class: 'card' });
- *     el.appendChild(h2({ nodes: props.title }));
+ *     el.appendChild(h2(props.title));
  *     if (props.nodes) {
  *       const nodes = Array.isArray(props.nodes) ? props.nodes : [props.nodes];
  *       nodes.forEach(child => el.appendChild(child));
@@ -146,7 +145,7 @@ declare function defineComponent<Props extends Record<string, unknown>>(config:
  *   }
  * });
  *
- * // Usage: Card({ title: 'Hello', nodes: p({ nodes: 'World' }) })
+ * // Usage: Card({ title: 'Hello', nodes: p('World') })
  * ```
  */
 declare function defineSlottedComponent<Props extends Record<string, unknown>>(config: {

package/dist/{customElement-D2DJp_xn.d.cts → customElement-CPfIrbvg.d.cts}

@@ -21,6 +21,8 @@ interface FormReturn<T extends Record<string, unknown>> {
     errors: () => Partial<Record<keyof T, string | null>>;
     isValid: () => boolean;
     isDirty: () => boolean;
+    /** True while an async handleSubmit callback is in flight. Prevents double-submit. */
+    submitting: () => boolean;
     touched: () => Partial<Record<keyof T, boolean>>;
     values: () => T;
     handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: Event) => void;
@@ -112,7 +114,7 @@ interface MaskOptions {
 declare function inputMask(options: MaskOptions): {
     value: () => string;
     rawValue: () => string;
-    bind: (input: HTMLInputElement) => void;
+    bind: (input: HTMLInputElement) => () => void;
 };
 /** Phone number mask: (999) 999-9999 */
 declare function phoneMask(): MaskOptions;
@@ -138,7 +140,7 @@ declare function focus(): {
     isFocused: () => boolean;
     focus: () => void;
     blur: () => void;
-    bind: (element: HTMLElement) => void;
+    bind: (element: HTMLElement) => () => void;
 };
 /**
  * FocusTrap traps focus within a container element.
@@ -150,7 +152,12 @@ declare function FocusTrap(nodes: HTMLElement, options?: {
 }): HTMLElement;
 /**
  * hotkey registers a keyboard shortcut handler.
- * Returns a cleanup function.
+ *
+ * Returns a `dispose()` cleanup function — call it from the owning
+ * component's unmount path to remove the `keydown` listener from
+ * `document`. The returned function is idempotent only via the
+ * browser's default `removeEventListener` semantics, so callers
+ * should invoke it exactly once.
  *
  * Supports two calling styles:
  * - String combo:   hotkey("ctrl+shift+z", handler)
@@ -161,12 +168,8 @@ declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, opti
     shift?: boolean;
     alt?: boolean;
     meta?: boolean;
-    global?: boolean;
     preventDefault?: boolean;
 }): () => void;
-/**
- * announce creates a screen reader announcement using ARIA live regions.
- */
 declare function announce(message: string, priority?: "polite" | "assertive"): void;
 
 /**
@@ -213,13 +216,19 @@ declare function bindBoolAttr(el: HTMLElement, attr: string, getter: boolean | (
 declare function bindData(el: HTMLElement, key: string, getter: string | (() => string)): () => void;
 
 /**
- * dialog provides reactive dialog state management with escape-to-close support.
+ * Test-only helper to reset the module-level stack between specs. Client-only:
+ * in SSR dialog() is never meaningfully invoked. In production the stack is
+ * bounded by open dialog count and cleaned via removeFromStack/dispose.
+ *
+ * @internal
  */
+declare function __resetDialogStack(): void;
 declare function dialog(): {
     open: () => void;
     close: () => void;
     isOpen: () => boolean;
     toggle: () => void;
+    dispose: () => void;
 };
 
 /**
@@ -310,4 +319,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 { lazyLoad as A, type BoundFieldProps as B, type CustomElementOptions as C, matchesPattern as D, max as E, type FieldConfig as F, maxLength as G, min as H, type IntersectionResult as I, minLength as J, pagination as K, phoneMask as L, type MaskOptions as M, removeScopedStyle as N, required as O, scopedStyle as P, ssnMask as Q, svgElement as R, timeMask as S, type Toast as T, toast as U, type ValidatorFn as V, withScopedStyle as W, zipMask as X, FocusTrap as a, type FormConfig as b, type FormField as c, type FormReturn as d, type ToastInstance as e, VirtualList as f, type VirtualListProps as g, announce as h, aria as i, bindAttrs as j, bindBoolAttr as k, bindData as l, bindField as m, creditCardMask as n, custom as o, dateMask as p, defineElement as q, dialog as r, email as s, eventBus as t, focus as u, form as v, hotkey as w, infiniteScroll as x, inputMask as y, intersection as z };
+export { lazyLoad as A, type BoundFieldProps as B, type CustomElementOptions as C, matchesPattern as D, max as E, type FieldConfig as F, maxLength as G, min as H, type IntersectionResult as I, minLength as J, pagination as K, phoneMask as L, type MaskOptions as M, removeScopedStyle as N, required as O, scopedStyle as P, ssnMask as Q, svgElement as R, timeMask as S, type Toast as T, toast as U, type ValidatorFn as V, withScopedStyle as W, zipMask as X, __resetDialogStack as _, FocusTrap as a, type FormConfig as b, type FormField as c, type FormReturn as d, type ToastInstance as e, VirtualList as f, type VirtualListProps as g, announce as h, aria as i, bindAttrs as j, bindBoolAttr as k, bindData as l, bindField as m, creditCardMask as n, custom as o, dateMask as p, defineElement as q, dialog as r, email as s, eventBus as t, focus as u, form as v, hotkey as w, infiniteScroll as x, inputMask as y, intersection as z };

package/dist/{customElement-D2DJp_xn.d.ts → customElement-CPfIrbvg.d.ts}

@@ -21,6 +21,8 @@ interface FormReturn<T extends Record<string, unknown>> {
     errors: () => Partial<Record<keyof T, string | null>>;
     isValid: () => boolean;
     isDirty: () => boolean;
+    /** True while an async handleSubmit callback is in flight. Prevents double-submit. */
+    submitting: () => boolean;
     touched: () => Partial<Record<keyof T, boolean>>;
     values: () => T;
     handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: Event) => void;
@@ -112,7 +114,7 @@ interface MaskOptions {
 declare function inputMask(options: MaskOptions): {
     value: () => string;
     rawValue: () => string;
-    bind: (input: HTMLInputElement) => void;
+    bind: (input: HTMLInputElement) => () => void;
 };
 /** Phone number mask: (999) 999-9999 */
 declare function phoneMask(): MaskOptions;
@@ -138,7 +140,7 @@ declare function focus(): {
     isFocused: () => boolean;
     focus: () => void;
     blur: () => void;
-    bind: (element: HTMLElement) => void;
+    bind: (element: HTMLElement) => () => void;
 };
 /**
  * FocusTrap traps focus within a container element.
@@ -150,7 +152,12 @@ declare function FocusTrap(nodes: HTMLElement, options?: {
 }): HTMLElement;
 /**
  * hotkey registers a keyboard shortcut handler.
- * Returns a cleanup function.
+ *
+ * Returns a `dispose()` cleanup function — call it from the owning
+ * component's unmount path to remove the `keydown` listener from
+ * `document`. The returned function is idempotent only via the
+ * browser's default `removeEventListener` semantics, so callers
+ * should invoke it exactly once.
  *
  * Supports two calling styles:
  * - String combo:   hotkey("ctrl+shift+z", handler)
@@ -161,12 +168,8 @@ declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, opti
     shift?: boolean;
     alt?: boolean;
     meta?: boolean;
-    global?: boolean;
     preventDefault?: boolean;
 }): () => void;
-/**
- * announce creates a screen reader announcement using ARIA live regions.
- */
 declare function announce(message: string, priority?: "polite" | "assertive"): void;
 
 /**
@@ -213,13 +216,19 @@ declare function bindBoolAttr(el: HTMLElement, attr: string, getter: boolean | (
 declare function bindData(el: HTMLElement, key: string, getter: string | (() => string)): () => void;
 
 /**
- * dialog provides reactive dialog state management with escape-to-close support.
+ * Test-only helper to reset the module-level stack between specs. Client-only:
+ * in SSR dialog() is never meaningfully invoked. In production the stack is
+ * bounded by open dialog count and cleaned via removeFromStack/dispose.
+ *
+ * @internal
  */
+declare function __resetDialogStack(): void;
 declare function dialog(): {
     open: () => void;
     close: () => void;
     isOpen: () => boolean;
     toggle: () => void;
+    dispose: () => void;
 };
 
 /**
@@ -310,4 +319,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 { lazyLoad as A, type BoundFieldProps as B, type CustomElementOptions as C, matchesPattern as D, max as E, type FieldConfig as F, maxLength as G, min as H, type IntersectionResult as I, minLength as J, pagination as K, phoneMask as L, type MaskOptions as M, removeScopedStyle as N, required as O, scopedStyle as P, ssnMask as Q, svgElement as R, timeMask as S, type Toast as T, toast as U, type ValidatorFn as V, withScopedStyle as W, zipMask as X, FocusTrap as a, type FormConfig as b, type FormField as c, type FormReturn as d, type ToastInstance as e, VirtualList as f, type VirtualListProps as g, announce as h, aria as i, bindAttrs as j, bindBoolAttr as k, bindData as l, bindField as m, creditCardMask as n, custom as o, dateMask as p, defineElement as q, dialog as r, email as s, eventBus as t, focus as u, form as v, hotkey as w, infiniteScroll as x, inputMask as y, intersection as z };
+export { lazyLoad as A, type BoundFieldProps as B, type CustomElementOptions as C, matchesPattern as D, max as E, type FieldConfig as F, maxLength as G, min as H, type IntersectionResult as I, minLength as J, pagination as K, phoneMask as L, type MaskOptions as M, removeScopedStyle as N, required as O, scopedStyle as P, ssnMask as Q, svgElement as R, timeMask as S, type Toast as T, toast as U, type ValidatorFn as V, withScopedStyle as W, zipMask as X, __resetDialogStack as _, FocusTrap as a, type FormConfig as b, type FormField as c, type FormReturn as d, type ToastInstance as e, VirtualList as f, type VirtualListProps as g, announce as h, aria as i, bindAttrs as j, bindBoolAttr as k, bindData as l, bindField as m, creditCardMask as n, custom as o, dateMask as p, defineElement as q, dialog as r, email as s, eventBus as t, focus as u, form as v, hotkey as w, infiniteScroll as x, inputMask as y, intersection as z };