sibujs 4.5.0 → 4.7.0

package/dist/patterns.d.ts

@@ -1,4 +1,5 @@
-export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as compose, d as createGuard, e as createSlots, f as defineComponent, g as defineSlottedComponent, h as defineStrictComponent, v as validateProps, i as validators, w as withBoundary, j as withDefaults, k as withProps, l as withWrapper } from './contracts-DBdg9J_a.js';
+export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, W as WithDefaultsProps, b as assertType, c as compose, d as createGuard, e as createSlots, f as defineComponent, g as defineSlottedComponent, h as defineStrictComponent, v as validateProps, i as validators, w as withBoundary, j as withDefaults, k as withProps, l as withWrapper } from './contracts-CLqzJnOV.js';
+import './types-CJFViL6Q.js';
 
 interface MachineConfig<S extends string, E extends string, C extends object = Record<string, unknown>> {
     initial: S;
@@ -36,10 +37,10 @@ declare function machine<S extends string, E extends string, C extends object =
  * @param key Storage key
  * @param initial Default value when no persisted value exists
  * @param options Storage options
- * @returns The same `[getter, setter]` tuple as `signal()`. For localStorage
- *   (cross-tab sync on), the setter additionally carries a non-enumerable
- *   `dispose()` method — call `setter.dispose()` on unmount to remove the
- *   `storage` event listener; otherwise it lives for the page's lifetime.
+ * @returns The same `[getter, setter]` tuple as `signal()`. The setter also
+ *   carries a non-enumerable `dispose()` method — call `setter.dispose()` on
+ *   unmount to stop persisting and remove the cross-tab `storage` listener;
+ *   otherwise both live for the page's lifetime.
  *
  * @example
  * ```ts
@@ -94,15 +95,21 @@ interface PersistOptions<T = unknown> {
      *  Must be synchronous — see `encrypt` docs. */
     decrypt?: (value: string) => string;
 }
+/** Setter returned by {@link persisted}: writes like a `signal()` setter, released with `dispose()`. */
+type PersistedSetter<T> = ((next: T | ((prev: T) => T)) => void) & {
+    /** Stop persisting changes and remove the cross-tab `storage` listener. */
+    dispose(): void;
+};
 /**
  * A signal mirrored into persistent storage, rehydrated on creation.
  *
  * @param key Storage key.
  * @param initial Value used when storage holds nothing (or holds junk).
  * @param options Storage backend, serializer and version/migration settings.
- * @returns A `[accessor, setter]` pair with the same shape as `signal`.
+ * @returns A `[accessor, setter]` pair with the same shape as `signal`; the
+ *   setter carries `dispose()`.
  */
-declare function persisted<T>(key: string, initial: T, options?: PersistOptions<T>): [() => T, (next: T | ((prev: T) => T)) => void];
+declare function persisted<T>(key: string, initial: T, options?: PersistOptions<T>): [() => T, PersistedSetter<T>];
 
 /**
  * optimistic provides optimistic UI updates that can be reverted on failure.
@@ -210,10 +217,22 @@ interface TimeTravelReturn<T> {
 }
 /**
  * timeline wraps a state value with undo/redo history.
+ *
+ * @param maxHistory How many entries (including the current one) to keep. Must
+ *   be a positive safe integer — `0`, negative, fractional, `NaN` or infinite
+ *   capacities throw a `RangeError`, since they would evict the current value
+ *   and break the index invariant.
  */
 declare function timeline<T>(initial: T, maxHistory?: number): TimeTravelReturn<T>;
 
-type Middleware<S> = (state: S, action: string, payload: unknown, next: () => void) => void;
+/**
+ * Store middleware. Call `next()` once to continue the chain — synchronously or
+ * later (after an `await`, from a timer). A middleware may be `async`: a
+ * rejection is reported through the runtime error handler, and a middleware
+ * that fails (throws, or rejects) before calling `next()` never continues —
+ * a later `next()` from it is ignored.
+ */
+type Middleware<S> = (state: S, action: string, payload: unknown, next: () => void) => void | PromiseLike<void>;
 type Selector<S, R> = (state: S) => R;
 /**
  * Action-map constraint.
@@ -247,4 +266,4 @@ declare function globalStore<S extends object, A extends StoreActionMap<S>>(conf
     middleware?: Middleware<S>[];
 }): GlobalStore<S, A>;
 
-export { type GlobalStore, type MachineConfig, type MachineReturn, type Middleware, type PersistOptions, type Selector, type StoreActionMap, type TimeTravelReturn, globalStore, machine, optimistic, optimisticList, persisted, timeline };
+export { type GlobalStore, type MachineConfig, type MachineReturn, type Middleware, type PersistOptions, type PersistedSetter, type Selector, type StoreActionMap, type TimeTravelReturn, globalStore, machine, optimistic, optimisticList, persisted, timeline };

package/dist/patterns.js

@@ -5,7 +5,7 @@ import {
   optimisticList,
   persisted,
   timeline
-} from "./chunk-VZKNK2V7.js";
+} from "./chunk-XZR4PXRE.js";
 import {
   RenderProp,
   assertType,
@@ -21,14 +21,14 @@ import {
   withDefaults,
   withProps,
   withWrapper
-} from "./chunk-R25EFXXC.js";
+} from "./chunk-TUCPL2HB.js";
 import "./chunk-H3SRKIYX.js";
-import "./chunk-RBTPLM32.js";
-import "./chunk-RIXRAYIU.js";
-import "./chunk-5DXA2J44.js";
-import "./chunk-XZZOBQAY.js";
-import "./chunk-UGRX3S57.js";
-import "./chunk-2WLZ6757.js";
+import "./chunk-RUSSKG6G.js";
+import "./chunk-WEQ3DMVL.js";
+import "./chunk-7XHATCIH.js";
+import "./chunk-FQRUXCEE.js";
+import "./chunk-JWKYU5GV.js";
+import "./chunk-NYNYSPK7.js";
 export {
   RenderProp,
   assertType,