sibujs 4.5.0 → 4.6.0

package/dist/{chunk-B3WHI2QA.js → chunk-XRRZKZYX.js}

@@ -1,9 +1,13 @@
 import {
-  registerDisposer
-} from "./chunk-QKRPLZ2V.js";
+  adoptThenable
+} from "./chunk-5HZXGZ6T.js";
 import {
   signal
-} from "./chunk-XZZOBQAY.js";
+} from "./chunk-D33YTSX5.js";
+import {
+  registerDisposer,
+  reportError
+} from "./chunk-NYNYSPK7.js";
 
 // src/ui/transition.ts
 function transition(element, options = {}) {
@@ -32,6 +36,15 @@ function transition(element, options = {}) {
       resolvePrev();
     }
   }
+  function complete(callback, name, resolve) {
+    try {
+      callback?.();
+    } catch (error) {
+      reportError(error, { phase: "async", name, node: element });
+    } finally {
+      resolve();
+    }
+  }
   function enter() {
     return new Promise((resolve) => {
       cancelPending();
@@ -44,8 +57,7 @@ function transition(element, options = {}) {
         activeTimer = null;
         pendingResolve = null;
         if (enterClass) element.classList.remove(enterClass);
-        onEnterDone?.();
-        resolve();
+        complete(onEnterDone, "transition(onEnterDone)", resolve);
       };
       if (duration > 0) {
         pendingResolve = resolve;
@@ -66,8 +78,7 @@ function transition(element, options = {}) {
         activeTimer = null;
         pendingResolve = null;
         if (leaveClass) element.classList.remove(leaveClass);
-        onLeaveDone?.();
-        resolve();
+        complete(onLeaveDone, "transition(onLeaveDone)", resolve);
       };
       if (duration > 0) {
         pendingResolve = resolve;
@@ -274,18 +285,29 @@ async function sequence(steps) {
 function TransitionGroup(options) {
   const [elements, setElements] = signal([]);
   const positions = /* @__PURE__ */ new Map();
+  function runCallback(name, callback, el) {
+    const report = (error) => reportError(error, { phase: "async", name: `TransitionGroup.${name}`, node: el });
+    try {
+      adoptThenable(callback(el))?.then(void 0, report);
+    } catch (error) {
+      report(error);
+    }
+  }
   function add(el) {
     setElements((prev) => [...prev, el]);
-    if (options.enter) {
-      options.enter(el);
-    }
+    if (options.enter) runCallback("enter", options.enter, el);
   }
   async function remove(el) {
-    if (options.leave) {
-      await options.leave(el);
+    try {
+      if (options.leave) {
+        await adoptThenable(options.leave(el));
+      }
+    } catch (error) {
+      reportError(error, { phase: "async", name: "TransitionGroup.leave", node: el });
+    } finally {
+      positions.delete(el);
+      setElements((prev) => prev.filter((e) => e !== el));
     }
-    positions.delete(el);
-    setElements((prev) => prev.filter((e) => e !== el));
   }
   function track(newElements) {
     const oldPositions = /* @__PURE__ */ new Map();
@@ -297,17 +319,13 @@ function TransitionGroup(options) {
     const currentSet = new Set(elements());
     for (const el of newElements) {
       if (!currentSet.has(el)) {
-        if (options.enter) {
-          options.enter(el);
-        }
+        if (options.enter) runCallback("enter", options.enter, el);
       }
     }
     const newSet = new Set(newElements);
     for (const el of elements()) {
       if (!newSet.has(el)) {
-        if (options.leave) {
-          options.leave(el);
-        }
+        if (options.leave) runCallback("leave", options.leave, el);
       }
     }
     setElements(newElements);
@@ -317,7 +335,7 @@ function TransitionGroup(options) {
         if (oldRect && typeof el.getBoundingClientRect === "function") {
           const newRect = el.getBoundingClientRect();
           if (oldRect.left !== newRect.left || oldRect.top !== newRect.top) {
-            options.move(el);
+            runCallback("move", options.move, el);
           }
         }
       }
@@ -368,9 +386,13 @@ function springSignal(initial, options) {
   let target = initial;
   let rafId = null;
   let lastTime = 0;
+  let disposed = false;
+  const canAnimate = () => typeof requestAnimationFrame === "function";
   const REF_DT_MS = 1e3 / 60;
   const MAX_STEP_RATIO = 4;
   function tick(now) {
+    rafId = null;
+    if (disposed) return;
     if (lastTime === 0) lastTime = now;
     const rawDt = now - lastTime;
     lastTime = now;
@@ -383,23 +405,27 @@ function springSignal(initial, options) {
     if (Math.abs(current - target) < precision && Math.abs(velocity) < precision) {
       current = target;
       velocity = 0;
-      rafId = null;
       lastTime = 0;
       setValue(current);
       return;
     }
     setValue(current);
+    if (disposed || rafId !== null) return;
     rafId = requestAnimationFrame(tick);
   }
+  function cancelFrame() {
+    if (rafId !== null) {
+      if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(rafId);
+      rafId = null;
+    }
+  }
   function set(newTarget) {
+    if (disposed) return;
     target = newTarget;
-    if (prefersReducedMotion()) {
+    if (!canAnimate() || prefersReducedMotion()) {
       current = newTarget;
       velocity = 0;
-      if (rafId !== null) {
-        cancelAnimationFrame(rafId);
-        rafId = null;
-      }
+      cancelFrame();
       lastTime = 0;
       setValue(current);
       return;
@@ -410,10 +436,8 @@ function springSignal(initial, options) {
     }
   }
   function dispose() {
-    if (rafId !== null) {
-      cancelAnimationFrame(rafId);
-      rafId = null;
-    }
+    disposed = true;
+    cancelFrame();
     lastTime = 0;
   }
   return [value, set, dispose];

package/dist/{contracts-DBdg9J_a.d.cts → contracts-DRIuclVT.d.cts}

@@ -32,7 +32,15 @@ declare function withWrapper<P>(WrappedComponent: Component<P>, wrapper: (compon
  * Button("Click"); // type="button", disabled=false automatically
  * ```
  */
-declare function withDefaults<P extends object>(component: Component<P>, defaults: Partial<P>): Component<Partial<P>>;
+/**
+ * Props accepted by a {@link withDefaults} component: every key that has a
+ * default becomes optional; every other key keeps its original required or
+ * optional status.
+ */
+type WithDefaultsProps<P, D> = Omit<P, keyof D> & Partial<Pick<P, Extract<keyof P, keyof D>>>;
+declare function withDefaults<P extends object, const D extends Partial<P> = Partial<P>>(component: Component<P>, defaults: D & {
+    [K in Exclude<keyof D, keyof P>]: never;
+}): Component<WithDefaultsProps<P, D>>;
 /**
  * Composes multiple HOC wrappers into a single wrapper.
  * Applied from right to left (like function composition).
@@ -257,4 +265,4 @@ declare function assertType<T>(value: unknown, validator: Validator<T>, label?:
  */
 declare function createGuard<T>(validator: Validator<T>): (value: unknown) => value is T;
 
-export { type ComponentProps as C, type PropDef as P, RenderProp as R, type Validator as V, type PropSchema as a, assertType as b, compose as c, createGuard as d, createSlots as e, defineComponent as f, defineSlottedComponent as g, defineStrictComponent as h, validators as i, withDefaults as j, withProps as k, withWrapper as l, validateProps as v, withBoundary as w };
+export { type ComponentProps as C, type PropDef as P, RenderProp as R, type Validator as V, type WithDefaultsProps as W, type PropSchema as a, assertType as b, compose as c, createGuard as d, createSlots as e, defineComponent as f, defineSlottedComponent as g, defineStrictComponent as h, validators as i, withDefaults as j, withProps as k, withWrapper as l, validateProps as v, withBoundary as w };

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

@@ -32,7 +32,15 @@ declare function withWrapper<P>(WrappedComponent: Component<P>, wrapper: (compon
  * Button("Click"); // type="button", disabled=false automatically
  * ```
  */
-declare function withDefaults<P extends object>(component: Component<P>, defaults: Partial<P>): Component<Partial<P>>;
+/**
+ * Props accepted by a {@link withDefaults} component: every key that has a
+ * default becomes optional; every other key keeps its original required or
+ * optional status.
+ */
+type WithDefaultsProps<P, D> = Omit<P, keyof D> & Partial<Pick<P, Extract<keyof P, keyof D>>>;
+declare function withDefaults<P extends object, const D extends Partial<P> = Partial<P>>(component: Component<P>, defaults: D & {
+    [K in Exclude<keyof D, keyof P>]: never;
+}): Component<WithDefaultsProps<P, D>>;
 /**
  * Composes multiple HOC wrappers into a single wrapper.
  * Applied from right to left (like function composition).
@@ -257,4 +265,4 @@ declare function assertType<T>(value: unknown, validator: Validator<T>, label?:
  */
 declare function createGuard<T>(validator: Validator<T>): (value: unknown) => value is T;
 
-export { type ComponentProps as C, type PropDef as P, RenderProp as R, type Validator as V, type PropSchema as a, assertType as b, compose as c, createGuard as d, createSlots as e, defineComponent as f, defineSlottedComponent as g, defineStrictComponent as h, validators as i, withDefaults as j, withProps as k, withWrapper as l, validateProps as v, withBoundary as w };
+export { type ComponentProps as C, type PropDef as P, RenderProp as R, type Validator as V, type WithDefaultsProps as W, type PropSchema as a, assertType as b, compose as c, createGuard as d, createSlots as e, defineComponent as f, defineSlottedComponent as g, defineStrictComponent as h, validators as i, withDefaults as j, withProps as k, withWrapper as l, validateProps as v, withBoundary as w };

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

@@ -28,6 +28,16 @@ interface FormReturn<T extends object> {
     handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: Event) => void;
     reset: () => void;
     setError: (field: keyof T, message: string) => void;
+    /**
+     * Release the form's derived graph: every field `error` and the `errors`,
+     * `isValid`, `isDirty`, `touched` and `values` aggregates. Call it when the
+     * form's owner goes away, e.g. `onCleanup(f.dispose, formElement)`.
+     *
+     * Afterwards the derived accessors are inert — they return their last
+     * settled values and never recompute — while field `value()`/`set()` keep
+     * working as plain signals. Idempotent.
+     */
+    dispose: () => void;
 }
 /**
  * Require a non-empty value. Rejects `null`, `undefined`, `""` and `[]`.
@@ -239,6 +249,12 @@ declare function FocusTrap(nodes: HTMLElement, options?: {
  * Supports two calling styles:
  * - String combo:   hotkey("ctrl+shift+z", handler)
  * - Explicit flags: hotkey("z", handler, { ctrl: true, shift: true })
+ *
+ * Combo modifiers: `ctrl`/`control`, `shift`, `alt`/`option`,
+ * `meta`/`cmd`/`command`, and `mod` — Cmd on Apple platforms, Ctrl
+ * everywhere else. An unknown modifier throws, because dropping it would
+ * make the shortcut fire on the bare key. The `+` key is written as a
+ * trailing plus: `hotkey("+", h)`, `hotkey("ctrl++", h)`.
  */
 declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, options?: {
     ctrl?: boolean;
@@ -452,6 +468,11 @@ declare function pagination(options: {
 /**
  * eventBus creates a typed publish/subscribe event system.
  * No reactive state needed -- pure event dispatching.
+ *
+ * `emit()` delivers to the handlers registered when it starts. A throwing
+ * handler is reported through the runtime error pipeline and the remaining
+ * handlers still run. Handlers added during delivery receive the next event;
+ * handlers removed (or cleared) during delivery are skipped for the rest of it.
  */
 declare function eventBus<T extends object>(): {
     on: <K extends keyof T>(event: K, handler: (data: T[K]) => void) => () => void;

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

@@ -28,6 +28,16 @@ interface FormReturn<T extends object> {
     handleSubmit: (onSubmit: (values: T) => void | Promise<void>) => (e?: Event) => void;
     reset: () => void;
     setError: (field: keyof T, message: string) => void;
+    /**
+     * Release the form's derived graph: every field `error` and the `errors`,
+     * `isValid`, `isDirty`, `touched` and `values` aggregates. Call it when the
+     * form's owner goes away, e.g. `onCleanup(f.dispose, formElement)`.
+     *
+     * Afterwards the derived accessors are inert — they return their last
+     * settled values and never recompute — while field `value()`/`set()` keep
+     * working as plain signals. Idempotent.
+     */
+    dispose: () => void;
 }
 /**
  * Require a non-empty value. Rejects `null`, `undefined`, `""` and `[]`.
@@ -239,6 +249,12 @@ declare function FocusTrap(nodes: HTMLElement, options?: {
  * Supports two calling styles:
  * - String combo:   hotkey("ctrl+shift+z", handler)
  * - Explicit flags: hotkey("z", handler, { ctrl: true, shift: true })
+ *
+ * Combo modifiers: `ctrl`/`control`, `shift`, `alt`/`option`,
+ * `meta`/`cmd`/`command`, and `mod` — Cmd on Apple platforms, Ctrl
+ * everywhere else. An unknown modifier throws, because dropping it would
+ * make the shortcut fire on the bare key. The `+` key is written as a
+ * trailing plus: `hotkey("+", h)`, `hotkey("ctrl++", h)`.
  */
 declare function hotkey(combo: string, handler: (e: KeyboardEvent) => void, options?: {
     ctrl?: boolean;
@@ -452,6 +468,11 @@ declare function pagination(options: {
 /**
  * eventBus creates a typed publish/subscribe event system.
  * No reactive state needed -- pure event dispatching.
+ *
+ * `emit()` delivers to the handlers registered when it starts. A throwing
+ * handler is reported through the runtime error pipeline and the remaining
+ * handlers still run. Handlers added during delivery receive the next event;
+ * handlers removed (or cleared) during delivery are skipped for the rest of it.
  */
 declare function eventBus<T extends object>(): {
     on: <K extends keyof T>(event: K, handler: (data: T[K]) => void) => () => void;