sibujs 1.2.0 → 1.4.0

package/dist/patterns.d.cts

@@ -1,4 +1,4 @@
-export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as composable, d as compose, e as createGuard, f as createSlots, g as defineComponent, h as defineSlottedComponent, i as defineStrictComponent, v as validateProps, j as validators, w as withBoundary, k as withDefaults, l as withProps, m as withWrapper } from './contracts-DOrhwbke.cjs';
+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-xo5ckdRP.cjs';
 
 interface MachineConfig<S extends string, E extends string, C extends Record<string, unknown> = Record<string, unknown>> {
     initial: S;
@@ -54,23 +54,33 @@ interface PersistOptions<T = unknown> {
     deserialize?: (raw: string) => unknown;
     /** Optional type guard to validate deserialized data. Falls back to initial on failure. */
     validate?: (value: unknown) => value is T;
+    /**
+     * Sync the signal across browser tabs via the `storage` event.
+     * Only applies when using localStorage (not sessionStorage — session storage
+     * is already isolated per tab). Default: `true` for localStorage.
+     */
+    syncTabs?: boolean;
     /**
      * Encrypt the serialized value before writing to storage.
      * Paired with `decrypt` for reading. Use for sensitive data.
      *
-     * **Security:** Use a real encryption algorithm (e.g. AES-GCM via Web Crypto API).
-     * Do NOT use `btoa()`/`atob()` — Base64 is encoding, not encryption, and provides
-     * zero confidentiality.
+     * **Security requirement:** use an authenticated encryption algorithm
+     * such as AES-GCM via the Web Crypto API. Do NOT:
+     *
+     *  - use `btoa()` / `atob()` — Base64 is encoding, not encryption
+     *  - use XOR with a static key — trivially reversible
+     *  - roll your own cipher — nearly always broken
      *
      * @example
      * ```ts
-     * // Example using a simple XOR cipher for illustration — in production,
-     * // use crypto.subtle.encrypt() with AES-GCM or a proven library.
      * persisted("token", "", {
-     *   encrypt: (v) => myAesGcmEncrypt(v, secretKey),
-     *   decrypt: (v) => myAesGcmDecrypt(v, secretKey),
+     *   encrypt: async (v) => aesGcmEncrypt(v, await getKey()),
+     *   decrypt: async (v) => aesGcmDecrypt(v, await getKey()),
      * });
      * ```
+     *
+     * Note that because localStorage is synchronous, any real AES-GCM
+     * flow needs pre-derived keys and is inherently best-effort.
      */
     encrypt?: (value: string) => string;
     /** Decrypt the stored value before deserialization. Required if `encrypt` is set. */
@@ -141,52 +151,4 @@ declare function globalStore<S extends Record<string, unknown>, A extends Record
     middleware?: Middleware<S>[];
 }): GlobalStore<S, A>;
 
-/**
- * SolidJS-style reactive primitives — standalone APIs that don't require
- * being inside a component. These are thin wrappers around the signal system.
- */
-/**
- * Creates a reactive signal. Equivalent to signal but with SolidJS naming.
- *
- * @param value Initial value
- * @returns Tuple [getter, setter]
- *
- * @example
- * ```ts
- * const [count, setCount] = createSignal(0);
- * console.log(count()); // 0
- * setCount(5);
- * ```
- */
-declare function createSignal<T>(value: T): [() => T, (next: T | ((prev: T) => T)) => void];
-/**
- * Creates a derived/computed reactive value. Equivalent to derived.
- *
- * @param fn Computation function that reads other signals
- * @returns Getter for the computed value
- *
- * @example
- * ```ts
- * const [count] = createSignal(5);
- * const doubled = createMemo(() => count() * 2);
- * console.log(doubled()); // 10
- * ```
- */
-declare function createMemo<T>(fn: () => T): () => T;
-/**
- * Creates a reactive side effect. Equivalent to effect.
- *
- * @param fn Effect function that reads reactive signals
- * @returns Cleanup/teardown function
- *
- * @example
- * ```ts
- * const [count] = createSignal(0);
- * const cleanup = createEffect(() => {
- *   console.log("Count is:", count());
- * });
- * ```
- */
-declare function createEffect(fn: () => void): () => void;
-
-export { type GlobalStore, type MachineConfig, type MachineReturn, type Middleware, type OptimisticAction, type PersistOptions, type Selector, type TimeTravelReturn, createEffect, createMemo, createSignal, globalStore, machine, optimistic, optimisticList, persisted, timeline };
+export { type GlobalStore, type MachineConfig, type MachineReturn, type Middleware, type OptimisticAction, type PersistOptions, type Selector, type TimeTravelReturn, globalStore, machine, optimistic, optimisticList, persisted, timeline };

package/dist/patterns.d.ts

@@ -1,4 +1,4 @@
-export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as composable, d as compose, e as createGuard, f as createSlots, g as defineComponent, h as defineSlottedComponent, i as defineStrictComponent, v as validateProps, j as validators, w as withBoundary, k as withDefaults, l as withProps, m as withWrapper } from './contracts-DOrhwbke.js';
+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-xo5ckdRP.js';
 
 interface MachineConfig<S extends string, E extends string, C extends Record<string, unknown> = Record<string, unknown>> {
     initial: S;
@@ -54,23 +54,33 @@ interface PersistOptions<T = unknown> {
     deserialize?: (raw: string) => unknown;
     /** Optional type guard to validate deserialized data. Falls back to initial on failure. */
     validate?: (value: unknown) => value is T;
+    /**
+     * Sync the signal across browser tabs via the `storage` event.
+     * Only applies when using localStorage (not sessionStorage — session storage
+     * is already isolated per tab). Default: `true` for localStorage.
+     */
+    syncTabs?: boolean;
     /**
      * Encrypt the serialized value before writing to storage.
      * Paired with `decrypt` for reading. Use for sensitive data.
      *
-     * **Security:** Use a real encryption algorithm (e.g. AES-GCM via Web Crypto API).
-     * Do NOT use `btoa()`/`atob()` — Base64 is encoding, not encryption, and provides
-     * zero confidentiality.
+     * **Security requirement:** use an authenticated encryption algorithm
+     * such as AES-GCM via the Web Crypto API. Do NOT:
+     *
+     *  - use `btoa()` / `atob()` — Base64 is encoding, not encryption
+     *  - use XOR with a static key — trivially reversible
+     *  - roll your own cipher — nearly always broken
      *
      * @example
      * ```ts
-     * // Example using a simple XOR cipher for illustration — in production,
-     * // use crypto.subtle.encrypt() with AES-GCM or a proven library.
      * persisted("token", "", {
-     *   encrypt: (v) => myAesGcmEncrypt(v, secretKey),
-     *   decrypt: (v) => myAesGcmDecrypt(v, secretKey),
+     *   encrypt: async (v) => aesGcmEncrypt(v, await getKey()),
+     *   decrypt: async (v) => aesGcmDecrypt(v, await getKey()),
      * });
      * ```
+     *
+     * Note that because localStorage is synchronous, any real AES-GCM
+     * flow needs pre-derived keys and is inherently best-effort.
      */
     encrypt?: (value: string) => string;
     /** Decrypt the stored value before deserialization. Required if `encrypt` is set. */
@@ -141,52 +151,4 @@ declare function globalStore<S extends Record<string, unknown>, A extends Record
     middleware?: Middleware<S>[];
 }): GlobalStore<S, A>;
 
-/**
- * SolidJS-style reactive primitives — standalone APIs that don't require
- * being inside a component. These are thin wrappers around the signal system.
- */
-/**
- * Creates a reactive signal. Equivalent to signal but with SolidJS naming.
- *
- * @param value Initial value
- * @returns Tuple [getter, setter]
- *
- * @example
- * ```ts
- * const [count, setCount] = createSignal(0);
- * console.log(count()); // 0
- * setCount(5);
- * ```
- */
-declare function createSignal<T>(value: T): [() => T, (next: T | ((prev: T) => T)) => void];
-/**
- * Creates a derived/computed reactive value. Equivalent to derived.
- *
- * @param fn Computation function that reads other signals
- * @returns Getter for the computed value
- *
- * @example
- * ```ts
- * const [count] = createSignal(5);
- * const doubled = createMemo(() => count() * 2);
- * console.log(doubled()); // 10
- * ```
- */
-declare function createMemo<T>(fn: () => T): () => T;
-/**
- * Creates a reactive side effect. Equivalent to effect.
- *
- * @param fn Effect function that reads reactive signals
- * @returns Cleanup/teardown function
- *
- * @example
- * ```ts
- * const [count] = createSignal(0);
- * const cleanup = createEffect(() => {
- *   console.log("Count is:", count());
- * });
- * ```
- */
-declare function createEffect(fn: () => void): () => void;
-
-export { type GlobalStore, type MachineConfig, type MachineReturn, type Middleware, type OptimisticAction, type PersistOptions, type Selector, type TimeTravelReturn, createEffect, createMemo, createSignal, globalStore, machine, optimistic, optimisticList, persisted, timeline };
+export { type GlobalStore, type MachineConfig, type MachineReturn, type Middleware, type OptimisticAction, type PersistOptions, type Selector, type TimeTravelReturn, globalStore, machine, optimistic, optimisticList, persisted, timeline };

package/dist/patterns.js

@@ -1,18 +1,14 @@
 import {
-  createEffect,
-  createMemo,
-  createSignal,
   globalStore,
   machine,
   optimistic,
   optimisticList,
   persisted,
   timeline
-} from "./chunk-WILQZRO4.js";
+} from "./chunk-ZWKZCBO6.js";
 import {
   RenderProp,
   assertType,
-  composable,
   compose,
   createGuard,
   createSlots,
@@ -25,22 +21,18 @@ import {
   withDefaults,
   withProps,
   withWrapper
-} from "./chunk-XYU6TZOW.js";
-import "./chunk-L6JRBDNS.js";
-import "./chunk-6SA3QQES.js";
-import "./chunk-CHJ27IGK.js";
-import "./chunk-V2XTI523.js";
-import "./chunk-UNXCEF6S.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-CNZ35WI2.js";
+import "./chunk-NEKUBFPT.js";
+import "./chunk-CHF5OHIA.js";
+import "./chunk-EUZND3CB.js";
+import "./chunk-WZSPOOER.js";
+import "./chunk-ZD6OAMTH.js";
+import "./chunk-5X6PP2UK.js";
 export {
   RenderProp,
   assertType,
-  composable,
   compose,
-  createEffect,
   createGuard,
-  createMemo,
-  createSignal,
   createSlots,
   defineComponent,
   defineSlottedComponent,

package/dist/performance.js

@@ -33,10 +33,10 @@ import {
   transitionState,
   uniqueId,
   yieldToMain
-} from "./chunk-YUTWTI4B.js";
-import "./chunk-V2XTI523.js";
-import "./chunk-UNXCEF6S.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-TSOKIX5Z.js";
+import "./chunk-WZSPOOER.js";
+import "./chunk-ZD6OAMTH.js";
+import "./chunk-5X6PP2UK.js";
 export {
   DOMPool,
   Features,