storion 0.2.3 → 0.4.0

package/dist/async/types.d.ts

@@ -0,0 +1,275 @@
+/**
+ * Async data mode:
+ * - "fresh": data is undefined during loading/error (only show fresh data)
+ * - "stale": data is preserved during loading/error (stale-while-revalidate)
+ */
+export type AsyncMode = "fresh" | "stale";
+export type AsyncStatus = "idle" | "pending" | "success" | "error";
+/**
+ * Serialized async state for persistence/hydration.
+ * Only success states are persisted.
+ */
+export type SerializedAsyncState<T = unknown> = {
+    status: "success";
+    mode: AsyncMode;
+    data: T;
+} | null;
+/**
+ * Async state with mode support.
+ * - Fresh mode: data is undefined during idle/pending/error
+ * - Stale mode: data is preserved (T) during pending/error after first load
+ */
+export type AsyncState<T = unknown, M extends AsyncMode = AsyncMode> = AsyncIdleState<T, M> | AsyncPendingState<T, M> | AsyncSuccessState<T> | AsyncErrorState<T, M>;
+export interface AsyncIdleStateFresh {
+    status: "idle";
+    mode: "fresh";
+    data: undefined;
+    error: undefined;
+    timestamp: undefined;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<undefined>;
+}
+export interface AsyncPendingStateFresh<T = unknown> {
+    status: "pending";
+    mode: "fresh";
+    data: undefined;
+    error: undefined;
+    timestamp: undefined;
+    /** @internal Key for Suspense promise tracking */
+    __key?: AsyncKey<T>;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<T>;
+}
+export interface AsyncErrorStateFresh {
+    status: "error";
+    mode: "fresh";
+    data: undefined;
+    error: Error;
+    timestamp: undefined;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<undefined>;
+}
+export interface AsyncIdleStateStale<T = unknown> {
+    status: "idle";
+    mode: "stale";
+    data: T;
+    error: undefined;
+    timestamp: undefined;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<T>;
+}
+export interface AsyncPendingStateStale<T = unknown> {
+    status: "pending";
+    mode: "stale";
+    data: T;
+    error: undefined;
+    timestamp: undefined;
+    /** @internal Key for Suspense promise tracking */
+    __key?: AsyncKey<T>;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<T>;
+}
+export interface AsyncErrorStateStale<T = unknown> {
+    status: "error";
+    mode: "stale";
+    data: T;
+    error: Error;
+    timestamp: undefined;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<T>;
+}
+export type AsyncIdleState<T = unknown, M extends AsyncMode = AsyncMode> = M extends "fresh" ? AsyncIdleStateFresh : M extends "stale" ? AsyncIdleStateStale<T> : AsyncIdleStateFresh | AsyncIdleStateStale<T>;
+export type AsyncPendingState<T = unknown, M extends AsyncMode = AsyncMode> = M extends "fresh" ? AsyncPendingStateFresh<T> : M extends "stale" ? AsyncPendingStateStale<T> : AsyncPendingStateFresh<T> | AsyncPendingStateStale<T>;
+export interface AsyncSuccessState<T = unknown> {
+    status: "success";
+    mode: "fresh" | "stale";
+    data: T;
+    error: undefined;
+    timestamp: number;
+    /** @internal Request ID for concurrency control */
+    __requestId?: AsyncRequestId;
+    toJSON?(): SerializedAsyncState<T>;
+}
+export type AsyncErrorState<T = unknown, M extends AsyncMode = AsyncMode> = M extends "fresh" ? AsyncErrorStateFresh : M extends "stale" ? AsyncErrorStateStale<T> : AsyncErrorStateFresh | AsyncErrorStateStale<T>;
+/**
+ * Opaque key type for linking state to pending promise.
+ * Used internally for React Suspense support.
+ */
+export type AsyncKey<T = unknown> = object & {
+    __brand?: T;
+};
+/**
+ * Request ID for detecting external state modifications.
+ * Used to prevent stale async updates from overwriting rolled-back state.
+ */
+export type AsyncRequestId = object;
+/**
+ * Context passed to async handlers.
+ */
+export interface AsyncContext {
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+    /**
+     * Wrap a promise to never resolve if the async operation is cancelled.
+     * Useful for nested async operations that should be cancelled together.
+     *
+     * @example
+     * async(focus, async (ctx) => {
+     *   const data1 = await ctx.safe(fetch('/api/1'));
+     *   const data2 = await ctx.safe(fetch('/api/2'));
+     *   return { data1, data2 };
+     * });
+     */
+    safe<T>(promise: Promise<T>): Promise<T>;
+    /**
+     * Wrap a callback to not run if the async operation is cancelled.
+     * Useful for event handlers and timeouts.
+     *
+     * @example
+     * async(focus, async (ctx) => {
+     *   setTimeout(ctx.safe(() => {
+     *     // Only runs if not cancelled
+     *     doSomething();
+     *   }), 1000);
+     * });
+     */
+    safe<TArgs extends unknown[], TReturn>(callback: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn | undefined;
+    /**
+     * Cancel the current async operation.
+     * Useful for implementing timeouts.
+     *
+     * @example
+     * async(focus, async (ctx) => {
+     *   // Timeout after 5 seconds
+     *   setTimeout(ctx.cancel, 5000);
+     *
+     *   const data = await ctx.safe(fetch('/api/slow'));
+     *   return data;
+     * });
+     */
+    cancel(): void;
+}
+/**
+ * Async handler function signature.
+ * Receives AsyncContext as first arg, then user-defined args.
+ */
+export type AsyncHandler<T, TArgs extends any[]> = (context: AsyncContext, ...args: TArgs) => T | PromiseLike<T>;
+export interface AsyncRetryOptions {
+    /** Number of retry attempts */
+    count: number;
+    /** Delay between retries (ms) or function returning delay */
+    delay?: number | ((attempt: number, error: Error) => number);
+}
+/**
+ * Options for async mixin setup.
+ */
+export interface AsyncOptions {
+    /** Error callback */
+    onError?: (error: Error) => void;
+    /** Retry configuration */
+    retry?: number | AsyncRetryOptions;
+    /** Auto-cancel previous request on new dispatch (default: true) */
+    autoCancel?: boolean;
+}
+export type CancellablePromise<T> = Promise<T> & {
+    cancel(): void;
+};
+/**
+ * Last invocation info for async action (for typing asyncAction.last())
+ */
+export interface AsyncLastInvocation<T, M extends AsyncMode, TArgs extends any[]> {
+    /** Arguments passed to the last dispatch */
+    readonly args: TArgs;
+    /** Invocation count (1-indexed) */
+    readonly nth: number;
+    /** Current async state (reactive) */
+    readonly state: AsyncState<T, M>;
+}
+/**
+ * API returned from async() mixin.
+ */
+export interface AsyncActions<T, M extends AsyncMode, TArgs extends any[]> {
+    /** Dispatch the async operation */
+    dispatch(...args: TArgs): CancellablePromise<T>;
+    /** Re-dispatch with last args. Returns undefined if no previous dispatch. */
+    refresh(): CancellablePromise<T> | undefined;
+    /** Cancel ongoing operation */
+    cancel(): void;
+    /** Reset to idle state */
+    reset(): void;
+    /**
+     * Get the last invocation info including current async state.
+     * Reactive - reads from the async state, triggers re-render when state changes.
+     *
+     * @returns Last invocation info with state, or undefined if never dispatched
+     */
+    last(): AsyncLastInvocation<T, M, TArgs> | undefined;
+}
+/**
+ * Infer the data type from an AsyncState
+ */
+export type InferAsyncData<T> = T extends AsyncState<infer D, any> ? D : never;
+/**
+ * Infer the mode from an AsyncState
+ */
+export type InferAsyncMode<T> = T extends AsyncState<any, infer M> ? M : never;
+/**
+ * Settled result for a single async state
+ */
+export type SettledResult<T, M extends AsyncMode = AsyncMode> = {
+    status: "success";
+    data: T;
+} | (M extends "stale" ? {
+    status: "error";
+    error: Error;
+    data: T;
+} : {
+    status: "error";
+    error: Error;
+    data: undefined;
+}) | (M extends "stale" ? {
+    status: "pending";
+    data: T;
+} : {
+    status: "pending";
+    data: undefined;
+}) | (M extends "stale" ? {
+    status: "idle";
+    data: T;
+} : {
+    status: "idle";
+    data: undefined;
+});
+/**
+ * Map a tuple of AsyncState to their data types
+ */
+export type MapAsyncData<T extends readonly AsyncState<any, any>[]> = {
+    -readonly [K in keyof T]: InferAsyncData<T[K]>;
+};
+/**
+ * Map a tuple of AsyncState to SettledResult
+ */
+export type MapSettledResult<T extends readonly AsyncState<any, any>[]> = {
+    -readonly [K in keyof T]: SettledResult<InferAsyncData<T[K]>, InferAsyncMode<T[K]>>;
+};
+/**
+ * Race result type - tuple of [key, value]
+ */
+export type RaceResult<T extends Record<string, AsyncState<any, any>>> = {
+    [K in keyof T]: [K, InferAsyncData<T[K]>];
+}[keyof T];
+export declare class AsyncNotReadyError extends Error {
+    readonly status: AsyncStatus;
+    constructor(message: string, status: AsyncStatus);
+}
+export declare class AsyncAggregateError extends Error {
+    readonly errors: Error[];
+    constructor(message: string, errors: Error[]);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/async/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/async/types.ts"],"names":[],"mappings":"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"}

package/dist/collection.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Lazy-instantiation Map wrapper.
+ *
+ * Creates items on first access via `get()`. Useful for managing
+ * collections where items should be created on-demand.
+ *
+ * @example
+ * ```ts
+ * // Create a collection of emitters, one per property key
+ * const emitters = collection((key: string) => emitter<void>());
+ *
+ * // First access creates the emitter
+ * const countEmitter = emitters.get("count"); // creates new emitter
+ * const countEmitter2 = emitters.get("count"); // returns same emitter
+ * ```
+ *
+ * @param createItem - Factory function to create new items
+ * @param initialItems - Optional initial entries
+ * @returns A Map-like object with lazy instantiation on `get()`
+ */
+export declare function collection<TKey, TValue>(createItem: (key: TKey) => TValue, initialItems?: readonly [TKey, TValue][]): {
+    with(key: TKey, callback: (item: TValue) => void): /*elided*/ any;
+    /** Check if key exists (does NOT create item) */
+    has(key: TKey): boolean;
+    /** Get item by key, creating it if it doesn't exist */
+    get(key: TKey): NonNullable<TValue>;
+    /** Explicitly set an item */
+    set(key: TKey, value: TValue): /*elided*/ any;
+    /** Number of items in the collection */
+    readonly size: number;
+    /** Remove all items */
+    clear(): /*elided*/ any;
+    /** Remove a specific item */
+    delete(key: TKey): /*elided*/ any;
+    /** Iterate over keys */
+    keys(): MapIterator<TKey>;
+    /** Iterate over values */
+    values(): MapIterator<TValue>;
+    /** Iterate over [key, value] pairs */
+    entries(): MapIterator<[TKey, TValue]>;
+};
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EACrC,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,EACjC,YAAY,CAAC,EAAE,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;cAK5B,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;IAOhD,iDAAiD;aACxC,IAAI;IAIb,uDAAuD;aAC9C,IAAI;IAOb,6BAA6B;aACpB,IAAI,SAAS,MAAM;IAK5B,wCAAwC;;IAKxC,uBAAuB;;IAMvB,6BAA6B;gBACjB,IAAI;IAKhB,wBAAwB;;IAKxB,0BAA0B;;IAK1B,sCAAsC;;EAKzC"}

package/dist/core/container.d.ts

@@ -1,7 +1,38 @@
-import { StoreContainer, ContainerOptions } from '../types';
+import { StoreContainer, ContainerOptions, StoreMiddleware } from '../types';
 
+interface DefaultMiddlewareConfig {
+    /** Middleware to run before container's middleware */
+    pre?: StoreMiddleware[];
+    /** Middleware to run after container's middleware */
+    post?: StoreMiddleware[];
+}
+/**
+ * Container function with static defaults method.
+ */
+interface ContainerFn {
+    (options?: ContainerOptions): StoreContainer;
+    /**
+     * Add default middleware that will be applied to all new containers.
+     */
+    defaults: {
+        (config?: DefaultMiddlewareConfig): void;
+        clear(): void;
+    };
+}
 /**
  * Create a store container.
+ *
+ * Container provides resolver methods plus store-specific lifecycle:
+ * - get(spec): cached instance
+ * - create(spec): fresh instance
+ * - set(spec, override): override for DI/testing
+ * - has(spec): check cache
+ * - tryGet(spec): get if cached
+ * - delete(spec): remove from cache
+ * - clear(): dispose all
+ * - scope(): child container
+ * - onCreate/onDispose: lifecycle events
  */
-export declare function container(options?: ContainerOptions): StoreContainer;
+export declare const container: ContainerFn;
+export {};
 //# sourceMappingURL=container.d.ts.map

package/dist/core/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/core/container.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAKV,cAAc,EAEd,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAMlB;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,cAAc,CA6NxE"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/core/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAIrB,MAAM,UAAU,CAAC;AAUlB,UAAU,uBAAuB;IAC/B,sDAAsD;IACtD,GAAG,CAAC,EAAE,eAAe,EAAE,CAAC;IACxB,qDAAqD;IACrD,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;CAC1B;AAYD;;GAEG;AACH,UAAU,WAAW;IACnB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAAC;IAC7C;;OAEG;IACH,QAAQ,EAAE;QACR,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;QACzC,KAAK,IAAI,IAAI,CAAC;KACf,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAE,WA4TvB,CAAC"}

package/dist/core/createResolver.d.ts

@@ -0,0 +1,47 @@
+import { Factory, Middleware, Resolver, ResolverOptions } from '../types';
+
+export type { Factory, Middleware, MiddlewareContext, Resolver, ResolverOptions, } from '../types';
+/**
+ * Create a new resolver with optional middleware and parent.
+ */
+export declare function createResolver(options?: ResolverOptions): Resolver;
+/**
+ * Create a middleware that only applies to factories matching a predicate.
+ *
+ * @example
+ * ```ts
+ * const storeOnlyMiddleware = when(
+ *   (factory) => is(factory, "store.spec"),
+ *   (ctx) => {
+ *     console.log("Creating store:", ctx.factory.name);
+ *     return ctx.next();
+ *   }
+ * );
+ * ```
+ */
+export declare function when(predicate: (factory: Factory) => boolean, middleware: Middleware): Middleware;
+/**
+ * Create a logging middleware for debugging.
+ *
+ * @example
+ * ```ts
+ * const app = createResolver({
+ *   middleware: [createLoggingMiddleware("App")],
+ * });
+ * ```
+ */
+export declare function createLoggingMiddleware(prefix?: string): Middleware;
+/**
+ * Create a middleware that validates factory results.
+ *
+ * @example
+ * ```ts
+ * const validateMiddleware = createValidationMiddleware((result) => {
+ *   if (result === null || result === undefined) {
+ *     throw new Error("Factory returned null/undefined");
+ *   }
+ * });
+ * ```
+ */
+export declare function createValidationMiddleware(validate: (result: unknown, factory: Factory) => void): Middleware;
+//# sourceMappingURL=createResolver.d.ts.map

package/dist/core/createResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createResolver.d.ts","sourceRoot":"","sources":["../../src/core/createResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,QAAQ,EACR,eAAe,EAEhB,MAAM,UAAU,CAAC;AAIlB,YAAY,EACV,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAmClB;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAoItE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAClB,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,EACxC,UAAU,EAAE,UAAU,GACrB,UAAU,CAOZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAa,GAAG,UAAU,CAUvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GACpD,UAAU,CAMZ"}

package/dist/core/effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../src/core/effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,CAAC,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;IAEhD;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACnC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GACpC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,SAAS,CAAC;CAC5C;AAmFD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;AAsBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CA6R1E"}
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../src/core/effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,CAAC,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,mBAAmB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAAC;IAEhD;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEzC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACnC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GACpC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAAG,SAAS,CAAC;CAC5C;AAqGD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;AAsBpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CA4R1E"}

package/dist/core/equality.d.ts

@@ -1,4 +1,4 @@
-import { Equality } from '../types';
+import { Equality, EqualityShorthand } from '../types';
 
 /**
  * Strict equality (Object.is).
@@ -6,8 +6,27 @@ import { Equality } from '../types';
 export declare function strictEqual<T>(a: T, b: T): boolean;
 /**
  * Shallow equality for objects/arrays.
+ * Compares by reference for each top-level key/index.
+ *
+ * @param itemEqual - Optional comparator for each item/value (defaults to Object.is)
  */
-export declare function shallowEqual<T>(a: T, b: T): boolean;
+export declare function shallowEqual<T>(a: T, b: T, itemEqual?: (a: unknown, b: unknown) => boolean): boolean;
+/**
+ * 2-level shallow equality.
+ * Compares keys/length, then shallow compares each item/value.
+ *
+ * @example
+ * [{ id: 1, data: obj }] vs [{ id: 1, data: obj }] // true (same obj ref)
+ */
+export declare function shallow2Equal<T>(a: T, b: T): boolean;
+/**
+ * 3-level shallow equality.
+ * Compares keys/length, then shallow2 compares each item/value.
+ *
+ * @example
+ * [{ id: 1, nested: { data: obj } }] vs [{ id: 1, nested: { data: obj } }] // true
+ */
+export declare function shallow3Equal<T>(a: T, b: T): boolean;
 /**
  * Deep equality.
  */
@@ -15,5 +34,6 @@ export declare const deepEqual: (value: any, other: any) => boolean;
 /**
  * Resolve equality strategy to a function.
  */
-export declare function resolveEquality<T>(equality: Equality<T> | undefined): (a: T, b: T) => boolean;
+export declare function resolveEquality<T>(e: Equality<T> | undefined): (a: T, b: T) => boolean;
+export declare function equality(shorthand: EqualityShorthand): (a: unknown, b: unknown) => boolean;
 //# sourceMappingURL=equality.d.ts.map

package/dist/core/equality.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"equality.d.ts","sourceRoot":"","sources":["../../src/core/equality.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAgBnD;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,qCAAU,CAAC;AAEjC;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,GAChC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAKzB"}
+{"version":3,"file":"equality.d.ts","sourceRoot":"","sources":["../../src/core/equality.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG5D;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,CAAC,EAAE,CAAC,EACJ,CAAC,EAAE,CAAC,EACJ,SAAS,GAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,OAAmB,GACzD,OAAO,CAgBT;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,qCAAU,CAAC;AAEjC;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,GACzB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAOzB;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,+BATlC,OAAO,CAWzB"}

package/dist/core/fnWrapper.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Utility for wrapping functions while preserving original references.
+ *
+ * This allows wrapped and original functions to be treated as the same
+ * for deduplication purposes (e.g., in trigger()).
+ */
+/** Symbol to mark the original function on wrapped functions */
+export declare const ORIGINAL_FN: unique symbol;
+/**
+ * Wrap a function while marking the original for later retrieval.
+ *
+ * @param originalFn - The original function to wrap
+ * @param createWrapper - Factory function that receives the original and returns the wrapper
+ * @returns The wrapper function with the original marked
+ *
+ * @example
+ * ```ts
+ * const original = (x: number) => x * 2;
+ * const wrapped = wrapFn(original, (fn) => {
+ *   return (x: number) => {
+ *     console.log('calling...');
+ *     return fn(x);
+ *   };
+ * });
+ *
+ * unwrapFn(wrapped) === original; // true
+ * ```
+ */
+export declare function wrapFn<T extends Function>(originalFn: T, createWrapper: (original: T) => T): T;
+/**
+ * Unwrap a function to get its original reference.
+ * If the function is not wrapped, returns the function itself.
+ *
+ * @param fn - The function to unwrap
+ * @returns The original function or the function itself if not wrapped
+ *
+ * @example
+ * ```ts
+ * const original = (x: number) => x * 2;
+ * const wrapped = wrapFn(original, (...args) => original(...args));
+ *
+ * unwrapFn(wrapped) === original; // true
+ * unwrapFn(original) === original; // true
+ * ```
+ */
+export declare function unwrapFn<T extends Function>(fn: T): T;
+/**
+ * Check if a function is wrapped.
+ *
+ * @param fn - The function to check
+ * @returns true if the function has an original reference marked
+ */
+export declare function isWrappedFn(fn: Function): boolean;
+//# sourceMappingURL=fnWrapper.d.ts.map

package/dist/core/fnWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fnWrapper.d.ts","sourceRoot":"","sources":["../../src/core/fnWrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gEAAgE;AAChE,eAAO,MAAM,WAAW,eAAmC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,QAAQ,EACvC,UAAU,EAAE,CAAC,EACb,aAAa,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAChC,CAAC,CAIH;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAEjD"}

package/dist/core/middleware.d.ts

@@ -1,9 +1,9 @@
-import { StoreSpec, StoreMiddleware } from '../types';
+import { StoreMiddleware, StoreMiddlewareContext } from '../types';
 
-/** Pattern type for matching spec names */
+/** Pattern type for matching displayName */
 export type SpecPattern = string | RegExp;
 /**
- * Compose multiple middleware into one.
+ * Compose multiple store middleware into one.
  * Middleware are applied in order (first middleware wraps the chain).
  */
 export declare function compose(...middlewares: StoreMiddleware[]): StoreMiddleware;
@@ -11,11 +11,11 @@ export declare function compose(...middlewares: StoreMiddleware[]): StoreMiddlew
  * Conditionally apply middleware based on a predicate or pattern(s).
  *
  * @overload Apply middleware when predicate returns true
- * @param predicate - Function that receives spec and returns whether to apply middleware
+ * @param predicate - Function that receives context and returns whether to apply middleware
  * @param middleware - Middleware or array of middleware to apply
  *
  * @overload Apply middleware for matching pattern(s)
- * @param patterns - Pattern or array of patterns to match spec names
+ * @param patterns - Pattern or array of patterns to match displayName
  * @param middleware - Middleware or array of middleware to apply
  *
  * Pattern types:
@@ -43,7 +43,7 @@ export declare function compose(...middlewares: StoreMiddleware[]): StoreMiddlew
  *
  * // Predicate function
  * applyFor(
- *   (spec) => spec.options.meta?.persist === true,
+ *   (ctx) => ctx.spec.options.meta?.persist === true,
  *   persistMiddleware
  * );
  *
@@ -51,13 +51,13 @@ export declare function compose(...middlewares: StoreMiddleware[]): StoreMiddlew
  * applyFor("counterStore", [loggingMiddleware, devtoolsMiddleware]);
  * ```
  */
-export declare function applyFor(predicate: (spec: StoreSpec<any, any>) => boolean, middleware: StoreMiddleware | StoreMiddleware[]): StoreMiddleware;
+export declare function applyFor(predicate: (ctx: StoreMiddlewareContext) => boolean, middleware: StoreMiddleware | StoreMiddleware[]): StoreMiddleware;
 export declare function applyFor(patterns: SpecPattern | SpecPattern[], middleware: StoreMiddleware | StoreMiddleware[]): StoreMiddleware;
 /**
  * Apply middleware to all stores except those matching predicate or pattern(s).
  *
  * @overload Exclude stores matching predicate
- * @param predicate - Function that receives spec and returns whether to exclude
+ * @param predicate - Function that receives context and returns whether to exclude
  * @param middleware - Middleware or array of middleware to apply
  *
  * @overload Exclude stores matching pattern(s)
@@ -68,7 +68,7 @@ export declare function applyFor(patterns: SpecPattern | SpecPattern[], middlewa
  * ```ts
  * // Exclude by predicate
  * applyExcept(
- *   (spec) => spec.name.startsWith("_"),
+ *   (ctx) => ctx.displayName.startsWith("_"),
  *   loggingMiddleware
  * );
  *
@@ -83,6 +83,6 @@ export declare function applyFor(patterns: SpecPattern | SpecPattern[], middlewa
  * applyExcept(/^(temp|cache)/, persistMiddleware);
  * ```
  */
-export declare function applyExcept(predicate: (spec: StoreSpec<any, any>) => boolean, middleware: StoreMiddleware | StoreMiddleware[]): StoreMiddleware;
+export declare function applyExcept(predicate: (ctx: StoreMiddlewareContext) => boolean, middleware: StoreMiddleware | StoreMiddleware[]): StoreMiddleware;
 export declare function applyExcept(patterns: SpecPattern | SpecPattern[], middleware: StoreMiddleware | StoreMiddleware[]): StoreMiddleware;
 //# sourceMappingURL=middleware.d.ts.map

package/dist/core/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAGV,SAAS,EACT,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAwD1C;;;GAGG;AACH,wBAAgB,OAAO,CACrB,GAAG,WAAW,EAAE,eAAe,EAAE,GAChC,eAAe,CAqBjB;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,EACjD,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC;AACnB,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,EACrC,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC;AA+BnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,EACjD,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC;AACnB,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,EACrC,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/core/middleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EAIvB,MAAM,UAAU,CAAC;AAElB,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAwD1C;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,WAAW,EAAE,eAAe,EAAE,GAAG,eAAe,CA+B1E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,QAAQ,CACtB,SAAS,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,EACnD,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC;AACnB,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,EACrC,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC;AA0CnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,EACnD,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC;AACnB,wBAAgB,WAAW,CACzB,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,EACrC,UAAU,EAAE,eAAe,GAAG,eAAe,EAAE,GAC9C,eAAe,CAAC"}

package/dist/core/pick.d.ts

@@ -10,20 +10,20 @@ import { PickEquality } from '../types';
  * @example
  * ```ts
  * // Without pick: re-renders when ANY profile property changes
- * useStore(({ resolve }) => {
- *   const [state] = resolve(userStore);
+ * useStore(({ get }) => {
+ *   const [state] = get(userStore);
  *   return { name: state.profile.name }; // tracks "profile"
  * });
  *
  * // With pick: re-renders only when profile.name changes
- * useStore(({ resolve }) => {
- *   const [state] = resolve(userStore);
+ * useStore(({ get }) => {
+ *   const [state] = get(userStore);
  *   return { name: pick(() => state.profile.name) };
  * });
  *
  * // With custom equality
- * useStore(({ resolve }) => {
- *   const [state] = resolve(userStore);
+ * useStore(({ get }) => {
+ *   const [state] = get(userStore);
  *   return {
  *     profile: pick(
  *       () => ({ name: state.profile.name, age: state.profile.age }),

package/dist/core/pick.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../src/core/pick.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAO7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAwGxE"}
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../src/core/pick.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAO7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAyGxE"}