sibujs 4.0.1 → 4.2.0

package/dist/{chunk-J4WZMCIW.js → chunk-QCFLDD7C.js}

@@ -1,22 +1,22 @@
 import {
   watch
-} from "./chunk-PTLJ7NQX.js";
+} from "./chunk-BMYYZWHX.js";
 import {
   createId
 } from "./chunk-CCSJMTRN.js";
 import {
   derived
-} from "./chunk-AD5YSZAN.js";
+} from "./chunk-2LOYNGBY.js";
 import {
   stripHtml
-} from "./chunk-5INI7D2L.js";
+} from "./chunk-IXKSNWV5.js";
 import {
   effect
-} from "./chunk-XDOMTQHM.js";
+} from "./chunk-7VEC3UD2.js";
 import {
   batch,
   signal
-} from "./chunk-TVURNWDK.js";
+} from "./chunk-HECVW343.js";
 
 // src/widgets/Combobox.ts
 var boundComboboxes = /* @__PURE__ */ new WeakMap();

package/dist/{chunk-DHDZ7IVN.js → chunk-QKRPLZ2V.js}

@@ -1,8 +1,8 @@
 import {
+  DEV,
   devWarn,
-  isDev,
   reportError
-} from "./chunk-VPP2FONR.js";
+} from "./chunk-2WLZ6757.js";
 
 // src/core/rendering/dispose.ts
 var elementDisposers = /* @__PURE__ */ new WeakMap();
@@ -14,7 +14,6 @@ function reportDrainRunaway(label, executed, remaining) {
     { executed, remaining }
   );
 }
-var _isDev = isDev();
 var activeBindingCount = 0;
 function registerDisposer(node, teardown) {
   let disposers = elementDisposers.get(node);
@@ -23,7 +22,7 @@ function registerDisposer(node, teardown) {
     elementDisposers.set(node, disposers);
   }
   disposers.push(teardown);
-  if (_isDev) activeBindingCount++;
+  if (DEV) activeBindingCount++;
 }
 function unregisterDisposer(node, teardown) {
   const disposers = elementDisposers.get(node);
@@ -31,7 +30,7 @@ function unregisterDisposer(node, teardown) {
   const index = disposers.indexOf(teardown);
   if (index === -1) return;
   disposers.splice(index, 1);
-  if (_isDev) activeBindingCount--;
+  if (DEV) activeBindingCount--;
   if (disposers.length === 0) elementDisposers.delete(node);
 }
 function dispose(node) {
@@ -55,13 +54,13 @@ function dispose(node) {
         if (!pending || pending.length === 0) break;
         const snapshot = pending.slice();
         elementDisposers.delete(current);
-        if (_isDev) activeBindingCount -= snapshot.length;
+        if (DEV) activeBindingCount -= snapshot.length;
         for (let i2 = 0; i2 < snapshot.length; i2++) {
           if (executed >= MAX_DRAIN_TEARDOWNS) {
             const rest = snapshot.slice(i2);
             const added = elementDisposers.get(current);
             elementDisposers.set(current, added ? rest.concat(added) : rest);
-            if (_isDev) activeBindingCount += rest.length;
+            if (DEV) activeBindingCount += rest.length;
             reportDrainRunaway("dispose", executed, rest.length + (added?.length ?? 0));
             runaway = true;
             break;
@@ -89,7 +88,7 @@ function replaceChildrenSafely(parent, ...next) {
   parent.replaceChildren(...next);
 }
 function checkLeaks(warnThreshold = 0) {
-  if (!_isDev) return 0;
+  if (!DEV) return 0;
   if (warnThreshold > 0 && activeBindingCount > warnThreshold) {
     devWarn(
       `checkLeaks: ${activeBindingCount} active DOM bindings detected. Expected \u2264${warnThreshold}. This may indicate a component was removed from the DOM without calling dispose().`

package/dist/{chunk-52ERIVFD.js → chunk-QL4UREZO.js}

@@ -1,26 +1,26 @@
 import {
   stripHtml
-} from "./chunk-5INI7D2L.js";
+} from "./chunk-IXKSNWV5.js";
 import {
   globalSingleton
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-XDOMTQHM.js";
+} from "./chunk-7VEC3UD2.js";
 import {
   dispose
-} from "./chunk-DHDZ7IVN.js";
+} from "./chunk-QKRPLZ2V.js";
 import {
   signal
-} from "./chunk-TVURNWDK.js";
+} from "./chunk-HECVW343.js";
 import {
   forEachSubscriber,
   getSubscriberCount,
   getSubscriberDeps
-} from "./chunk-JYXQCELN.js";
+} from "./chunk-7ALC7KGE.js";
 import {
   isDev
-} from "./chunk-VPP2FONR.js";
+} from "./chunk-2WLZ6757.js";
 
 // src/devtools/debug.ts
 var debugEnabled = false;

package/dist/{chunk-TNEHT3NG.js → chunk-SF3TB4K6.js}

@@ -1,33 +1,33 @@
 import {
   bindAttribute,
   setSafeAttribute
-} from "./chunk-PHRH66Y7.js";
+} from "./chunk-HJEPKZ2O.js";
 import {
   derived
-} from "./chunk-AD5YSZAN.js";
+} from "./chunk-2LOYNGBY.js";
 import {
   isEventHandlerAttr
-} from "./chunk-5INI7D2L.js";
+} from "./chunk-IXKSNWV5.js";
 import {
   globalSingleton
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-XDOMTQHM.js";
+} from "./chunk-7VEC3UD2.js";
 import {
   dispose,
   registerDisposer,
   replaceChildrenSafely
-} from "./chunk-DHDZ7IVN.js";
+} from "./chunk-QKRPLZ2V.js";
 import {
   signal
-} from "./chunk-TVURNWDK.js";
+} from "./chunk-HECVW343.js";
 import {
   track
-} from "./chunk-JYXQCELN.js";
+} from "./chunk-7ALC7KGE.js";
 import {
   reportError
-} from "./chunk-VPP2FONR.js";
+} from "./chunk-2WLZ6757.js";
 
 // src/ui/form.ts
 function required(message = "This field is required") {

package/dist/{chunk-HPXTUPJD.js → chunk-XZ2N525U.js}

@@ -1,25 +1,25 @@
 import {
   context
-} from "./chunk-XET2RUJF.js";
+} from "./chunk-FOWBJZDL.js";
 import {
   derived
-} from "./chunk-AD5YSZAN.js";
+} from "./chunk-2LOYNGBY.js";
 import {
   sanitizeUrl
-} from "./chunk-5INI7D2L.js";
+} from "./chunk-IXKSNWV5.js";
 import {
   globalSingleton
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-XDOMTQHM.js";
+} from "./chunk-7VEC3UD2.js";
 import {
   getRequestScopedCache
-} from "./chunk-TIRZCERI.js";
+} from "./chunk-5DXA2J44.js";
 import {
   batch,
   signal
-} from "./chunk-TVURNWDK.js";
+} from "./chunk-HECVW343.js";
 
 // src/data/abort.ts
 function isAbortError(error) {

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

@@ -29,13 +29,69 @@ interface FormReturn<T extends object> {
     reset: () => void;
     setError: (field: keyof T, message: string) => void;
 }
+/**
+ * Require a non-empty value. Rejects `null`, `undefined`, `""` and `[]`.
+ *
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function required(message?: string): ValidatorFn<unknown>;
+/**
+ * Require a minimum string length. An empty value passes — pair with
+ * {@link required} when the field is mandatory.
+ *
+ * @param min Minimum number of characters.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function minLength(min: number, message?: string): ValidatorFn<string>;
+/**
+ * Require a maximum string length. An empty value passes.
+ *
+ * @param max Maximum number of characters.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function maxLength(max: number, message?: string): ValidatorFn<string>;
+/**
+ * Require the value to match a regular expression. An empty value passes.
+ *
+ * @param regex Pattern the value must satisfy.
+ * @param message Message used on failure.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function matchesPattern(regex: RegExp, message?: string): ValidatorFn<string>;
+/**
+ * Require a syntactically plausible email address. Deliberately permissive —
+ * the only authoritative check is sending mail to it. An empty value passes.
+ *
+ * @param message Message used on failure.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function email(message?: string): ValidatorFn<string>;
+/**
+ * Require a numeric value to be at least `minVal`. `null`/`undefined` passes.
+ *
+ * @param minVal Inclusive lower bound.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function min(minVal: number, message?: string): ValidatorFn<number>;
+/**
+ * Require a numeric value to be at most `maxVal`. `null`/`undefined` passes.
+ *
+ * @param maxVal Inclusive upper bound.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function max(maxVal: number, message?: string): ValidatorFn<number>;
+/**
+ * Build a validator from an arbitrary predicate.
+ *
+ * @param fn Returns `true` when the value is acceptable.
+ * @param message Message used when `fn` returns `false`.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function custom<T>(fn: (value: T) => boolean, message: string): ValidatorFn<T>;
 /**
  * Props returned by bindField, ready to spread into an input tag factory.
@@ -180,6 +236,13 @@ declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, opti
     meta?: boolean;
     preventDefault?: boolean;
 }): () => void;
+/**
+ * Announce a message to screen readers through a shared live region.
+ *
+ * @param message Text to announce.
+ * @param priority `"polite"` waits for a pause; `"assertive"` interrupts.
+ * @returns Nothing. A no-op without a DOM, so it is safe under SSR.
+ */
 declare function announce(message: string, priority?: "polite" | "assertive"): void;
 
 /**
@@ -266,6 +329,12 @@ declare function bindData(el: HTMLElement, key: string, getter: AttributeValue |
  * @internal
  */
 declare function __resetDialogStack(): void;
+/**
+ * Dialog open/close state with focus trapping and scroll locking wired in.
+ *
+ * @returns A handle exposing `open`, `close`, `toggle` and the reactive
+ * `isOpen` accessor.
+ */
 declare function dialog(): {
     open: () => void;
     close: () => void;
@@ -296,6 +365,14 @@ interface ToastInstance {
     dismiss: (id: string) => void;
     dismissAll: () => void;
 }
+/**
+ * Create a toast queue.
+ *
+ * @param options `duration` in ms before auto-dismiss; `maxToasts` caps how
+ * many are shown at once.
+ * @returns A {@link ToastInstance} with `info`, `success`, `warning`, `error`,
+ * plus the reactive list to render.
+ */
 declare function toast(options?: {
     duration?: number;
     maxToasts?: number;

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

@@ -29,13 +29,69 @@ interface FormReturn<T extends object> {
     reset: () => void;
     setError: (field: keyof T, message: string) => void;
 }
+/**
+ * Require a non-empty value. Rejects `null`, `undefined`, `""` and `[]`.
+ *
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function required(message?: string): ValidatorFn<unknown>;
+/**
+ * Require a minimum string length. An empty value passes — pair with
+ * {@link required} when the field is mandatory.
+ *
+ * @param min Minimum number of characters.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function minLength(min: number, message?: string): ValidatorFn<string>;
+/**
+ * Require a maximum string length. An empty value passes.
+ *
+ * @param max Maximum number of characters.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function maxLength(max: number, message?: string): ValidatorFn<string>;
+/**
+ * Require the value to match a regular expression. An empty value passes.
+ *
+ * @param regex Pattern the value must satisfy.
+ * @param message Message used on failure.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function matchesPattern(regex: RegExp, message?: string): ValidatorFn<string>;
+/**
+ * Require a syntactically plausible email address. Deliberately permissive —
+ * the only authoritative check is sending mail to it. An empty value passes.
+ *
+ * @param message Message used on failure.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function email(message?: string): ValidatorFn<string>;
+/**
+ * Require a numeric value to be at least `minVal`. `null`/`undefined` passes.
+ *
+ * @param minVal Inclusive lower bound.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function min(minVal: number, message?: string): ValidatorFn<number>;
+/**
+ * Require a numeric value to be at most `maxVal`. `null`/`undefined` passes.
+ *
+ * @param maxVal Inclusive upper bound.
+ * @param message Overrides the default message.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function max(maxVal: number, message?: string): ValidatorFn<number>;
+/**
+ * Build a validator from an arbitrary predicate.
+ *
+ * @param fn Returns `true` when the value is acceptable.
+ * @param message Message used when `fn` returns `false`.
+ * @returns A validator returning the message on failure, `null` on success.
+ */
 declare function custom<T>(fn: (value: T) => boolean, message: string): ValidatorFn<T>;
 /**
  * Props returned by bindField, ready to spread into an input tag factory.
@@ -180,6 +236,13 @@ declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, opti
     meta?: boolean;
     preventDefault?: boolean;
 }): () => void;
+/**
+ * Announce a message to screen readers through a shared live region.
+ *
+ * @param message Text to announce.
+ * @param priority `"polite"` waits for a pause; `"assertive"` interrupts.
+ * @returns Nothing. A no-op without a DOM, so it is safe under SSR.
+ */
 declare function announce(message: string, priority?: "polite" | "assertive"): void;
 
 /**
@@ -266,6 +329,12 @@ declare function bindData(el: HTMLElement, key: string, getter: AttributeValue |
  * @internal
  */
 declare function __resetDialogStack(): void;
+/**
+ * Dialog open/close state with focus trapping and scroll locking wired in.
+ *
+ * @returns A handle exposing `open`, `close`, `toggle` and the reactive
+ * `isOpen` accessor.
+ */
 declare function dialog(): {
     open: () => void;
     close: () => void;
@@ -296,6 +365,14 @@ interface ToastInstance {
     dismiss: (id: string) => void;
     dismissAll: () => void;
 }
+/**
+ * Create a toast queue.
+ *
+ * @param options `duration` in ms before auto-dismiss; `maxToasts` caps how
+ * many are shown at once.
+ * @returns A {@link ToastInstance} with `info`, `success`, `warning`, `error`,
+ * plus the reactive list to render.
+ */
 declare function toast(options?: {
     duration?: number;
     maxToasts?: number;

package/dist/data.cjs

@@ -45,23 +45,17 @@ __export(data_exports, {
 module.exports = __toCommonJS(data_exports);
 
 // src/core/dev.ts
-function isDev() {
-  return typeof globalThis.__SIBU_DEV__ !== "undefined" ? !!globalThis.__SIBU_DEV__ : (
-    // The bare `__SIBU_DEV__` is a bundler define that only exists in
-    // production builds; under the test runner it is always undefined, so
-    // this branch is unreachable here.
-    /* v8 ignore next 2 */
-    typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
-  );
-}
-var _isDev = isDev();
+var DEV = typeof __SIBU_DEV__ !== "undefined" ? !!__SIBU_DEV__ : typeof globalThis.__SIBU_DEV__ !== "undefined" ? !!globalThis.__SIBU_DEV__ : (
+  // safe default: off in browser, on in test/dev Node
+  typeof process !== "undefined" && process.env?.NODE_ENV !== "production"
+);
 function devAssert(condition, message) {
-  if (_isDev && !condition) {
+  if ((typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) && !condition) {
     throw new Error(`[SibuJS] ${message}`);
   }
 }
 function devWarn(message) {
-  if (_isDev) {
+  if (typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) {
     console.warn(`[SibuJS] ${message}`);
   }
 }
@@ -372,7 +366,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;
@@ -603,17 +604,16 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _isDev2 = isDev();
-var _runtimeVersion = true ? "4.0.1" : "dev";
+var _runtimeVersion = true ? "4.2.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
   const existing = g[REGISTRY_KEY];
   if (existing) {
-    if (_isDev2 && !existing.__dupWarned) {
+    if (DEV && !existing.__dupWarned) {
       existing.__dupWarned = true;
       devWarn(
-        `Multiple instances of the reactive runtime detected on this page (active: ${existing.version}, duplicate: ${_runtimeVersion}). Reactivity still works \u2014 all copies share the first one \u2014 but de-duplicate sibujs in your bundler (e.g. Vite optimizeDeps.exclude: ['sibujs'] or resolve.dedupe: ['sibujs']).`
+        `Multiple instances of the reactive runtime detected on this page (active: ${existing.version}, duplicate: ${_runtimeVersion}). Reactivity is NOT broken and no bundler configuration is required: every copy routes through the first one via a global registry, so signal writes still reach subscribers registered by any copy. This is only a SIZE issue \u2014 the duplicate copy's bytes are downloaded and parsed for nothing. If you want them back, de-duplicate sibujs in your bundler (Vite: resolve.dedupe: ['sibujs']). Mismatched VERSIONS above are worth fixing regardless, since only the first one loaded is used.`
       );
     }
     return existing;
@@ -959,7 +959,6 @@ var isBatching = API2.isBatching;
 
 // src/core/signals/signal.ts
 var _g2 = globalThis;
-var _isDev3 = isDev();
 function signal(initial, options) {
   const state2 = {
     value: initial,
@@ -972,7 +971,7 @@ function signal(initial, options) {
     _d: false,
     _validate: void 0
   };
-  const debugName = _isDev3 ? options?.name : void 0;
+  const debugName = DEV ? options?.name : void 0;
   const equalsFn = options?.equals;
   if (debugName) state2.__name = debugName;
   function get() {
@@ -989,7 +988,7 @@ function signal(initial, options) {
       if (equalsFn(prev, newValue)) return;
       state2.value = newValue;
       state2.__v++;
-      if (_isDev3) {
+      if (DEV) {
         const hook = _g2.__SIBU_DEVTOOLS_GLOBAL_HOOK__;
         if (hook) hook.emit("signal:update", { signal: state2, name: debugName, oldValue: prev, newValue });
       }
@@ -997,7 +996,7 @@ function signal(initial, options) {
         notifySubscribers2(state2);
       }
     };
-  } else if (_isDev3) {
+  } else if (DEV) {
     set = (next) => {
       const prev = state2.value;
       const newValue = typeof next === "function" ? next(prev) : next;
@@ -1022,7 +1021,7 @@ function signal(initial, options) {
       }
     };
   }
-  if (_isDev3) {
+  if (DEV) {
     const hook = _g2.__SIBU_DEVTOOLS_GLOBAL_HOOK__;
     if (hook) hook.emit("signal:create", { signal: state2, name: debugName, getter: get, initial });
   }
@@ -2159,11 +2158,10 @@ function syncAdapter(config) {
 }
 
 // src/core/rendering/context.ts
-var _isDev4 = isDev();
 function context(defaultValue) {
   const [getValue, setValue] = signal(defaultValue);
   const warnIfSSR = (method) => {
-    if (!_isDev4 || !isSSR()) return;
+    if (!DEV || !isSSR()) return;
     devWarn(
       `context.${method}() called during SSR. SibuJS context() is application-global \u2014 it is NOT isolated per request, so a concurrent request can observe this value. Do not use context() for request-specific SSR data; pass it explicitly or use request-scoped storage instead.`
     );
@@ -2191,7 +2189,7 @@ function context(defaultValue) {
       setValue(value);
       try {
         const result = fn();
-        if (_isDev4 && result !== null && typeof result?.then === "function") {
+        if (DEV && result !== null && typeof result?.then === "function") {
           devWarn(
             "context.withContext() received an async callback. Scoping is synchronous only \u2014 the previous value is restored as soon as the callback returns its promise, so anything after an `await` runs outside the scope."
           );

package/dist/data.js

@@ -20,16 +20,16 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-HPXTUPJD.js";
-import "./chunk-XET2RUJF.js";
-import "./chunk-AD5YSZAN.js";
-import "./chunk-5INI7D2L.js";
+} from "./chunk-XZ2N525U.js";
+import "./chunk-FOWBJZDL.js";
+import "./chunk-2LOYNGBY.js";
+import "./chunk-IXKSNWV5.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-XDOMTQHM.js";
-import "./chunk-TIRZCERI.js";
-import "./chunk-TVURNWDK.js";
-import "./chunk-JYXQCELN.js";
-import "./chunk-VPP2FONR.js";
+import "./chunk-7VEC3UD2.js";
+import "./chunk-5DXA2J44.js";
+import "./chunk-HECVW343.js";
+import "./chunk-7ALC7KGE.js";
+import "./chunk-2WLZ6757.js";
 export {
   __resetQueryCache,
   calculateDelay,