storion 0.10.2 → 0.11.0

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

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

package/dist/async/index.js

@@ -1,5 +1,5 @@
-import { c as createSafe, i as isSpec, s as storeTuple, a as store, A as AsyncNotReadyError, b as AsyncAggregateError, e as effect, u as untrack, d as AsyncFunctionError, S as SetupPhaseError, f as isAbortable, r as retryStrategy } from "../effect-BDQU8Voz.js";
-import { g } from "../effect-BDQU8Voz.js";
+import { c as createSafe, i as isSpec, s as storeTuple, a as store, A as AsyncNotReadyError, b as AsyncAggregateError, e as effect, u as untrack, d as AsyncFunctionError, S as SetupPhaseError, f as isAbortable, r as retryStrategy } from "../effect-1beiYe_c.js";
+import { g } from "../effect-1beiYe_c.js";
 function createAsyncContext(abortController, isCancelledOrAborted, cancel, resolver) {
   const safe = createSafe(
     () => abortController.signal,

package/dist/async/safe.d.ts

@@ -141,6 +141,20 @@ export interface SafeCallback {
      */
     <TArgs extends any[]>(callback: (...args: TArgs) => void): (...args: TArgs) => void;
 }
+export interface SafeDelay {
+    /**
+     * Delay execution for specified milliseconds.
+     * Never resolves if cancelled.
+     *
+     * @example
+     * // Wait 1 second
+     * await safe.delay(1000);
+     *
+     * // Wait and return a value
+     * const result = await safe.delay(500, "done");
+     */
+    <T = void>(ms: number, resolved?: T): Promise<T>;
+}
 /**
  * Safe function type returned by createSafe.
  *
@@ -190,6 +204,8 @@ export interface SafeFnWithUtils extends SafeFn {
     any: SafeAny;
     /** Wrap callback to only execute if not cancelled */
     callback: SafeCallback;
+    /** Delay execution, never resolves if cancelled */
+    delay: SafeDelay;
 }
 /**
  * Create a safe function for a given context.

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

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

package/dist/core/disposalGroup.d.ts

@@ -0,0 +1,95 @@
+import { AutoDisposeOptions } from '../types';
+
+/**
+ * Check if value is an object (can have dispose method).
+ * Primitives (string, number, boolean, etc.) are skipped for disposal tracking.
+ */
+export declare function isObject(value: unknown): value is object;
+/**
+ * Get or create a disposal group by name.
+ * Named groups are shared across all collections using the same name.
+ */
+export declare function getNamedGroup(name: string): DisposalGroup;
+/**
+ * Full options for auto-dispose with group and grace period.
+ */
+export interface FocusAutoDisposeOptions {
+    /** Disposal group - either a DisposalGroup instance or a named group string */
+    group?: DisposalGroup | string;
+    /** Grace period in ms before disposing (default: 0) */
+    gracePeriodMs?: number;
+}
+/**
+ * Unified auto-dispose option type.
+ * - `false` / `undefined`: No auto-disposal
+ * - `true`: Dispose immediately via microtask
+ * - `number`: Grace period in ms (e.g., `100` = 100ms delay)
+ * - `string`: Named group (shared across collections using same name)
+ * - `DisposalGroup`: Direct group instance
+ * - `{ group, gracePeriodMs }`: Full options object
+ */
+export type FocusAutoDispose = boolean | number | string | DisposalGroup | FocusAutoDisposeOptions;
+/**
+ * Normalized result of parsing autoDispose option.
+ */
+export interface NormalizedAutoDispose {
+    enabled: true;
+    gracePeriodMs: number;
+    group: DisposalGroup | null;
+}
+/**
+ * Normalize autoDispose option to a standard format.
+ */
+export declare function normalizeAutoDispose(autoDispose: FocusAutoDispose | undefined): NormalizedAutoDispose | false;
+/**
+ * @deprecated Use normalizeAutoDispose instead
+ */
+export declare function normalizeAutoDisposeOptions(autoDispose: boolean | AutoDisposeOptions | undefined): AutoDisposeOptions | false;
+/**
+ * Disposal group for coordinating disposal across multiple collections.
+ *
+ * @example
+ * ```ts
+ * const group = disposalGroup();
+ *
+ * const listA = focus('listA').as(list({ group }));
+ * const listB = focus('listB').as(list({ group }));
+ *
+ * // Moving item from A to B won't dispose it
+ * const item = listA.pop();  // schedules disposal in group
+ * listB.push(item);          // cancels disposal because item is still in group
+ * ```
+ */
+export interface DisposalGroup {
+    /**
+     * Schedule items for disposal.
+     * Items will be disposed after the grace period unless cancelled.
+     */
+    scheduleDisposal(items: unknown[], gracePeriodMs: number): void;
+    /**
+     * Cancel disposal for items that are being re-added.
+     */
+    cancelDisposal(items: unknown[]): void;
+    /**
+     * Check if an item is pending disposal.
+     */
+    isPending(item: unknown): boolean;
+    /**
+     * Force immediate disposal of all pending items.
+     */
+    flush(): void;
+}
+/**
+ * Create a disposal group for coordinating disposal across collections.
+ */
+export declare function disposalGroup(): DisposalGroup;
+/**
+ * Create a local disposal tracker for a single collection.
+ * Uses microtask scheduling with cancellation support.
+ */
+export declare function createLocalDisposalTracker(gracePeriodMs: number): {
+    scheduleDisposal(items: unknown[]): void;
+    cancelDisposal(items: unknown[]): void;
+    isPending(item: unknown): boolean;
+};
+//# sourceMappingURL=disposalGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disposalGroup.d.ts","sourceRoot":"","sources":["../../src/core/disposalGroup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAOnD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAOzD;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IAC/B,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,MAAM,GACN,MAAM,GACN,aAAa,GACb,uBAAuB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;CAC7B;AAgBD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,gBAAgB,GAAG,SAAS,GACxC,qBAAqB,GAAG,KAAK,CAuC/B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,GACpD,kBAAkB,GAAG,KAAK,CAI5B;AAMD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhE;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAElC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,CA2D7C;AAMD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM;4BAOpC,OAAO,EAAE,GAAG,IAAI;0BAuBlB,OAAO,EAAE,GAAG,IAAI;oBAatB,OAAO,GAAG,OAAO;EAIpC"}

package/dist/core/focusHelpers.d.ts

@@ -1,5 +1,12 @@
-import { Focus, PickEquality } from '../types';
-
+/**
+ * Focus Helpers - Convenient APIs for common state mutations.
+ *
+ * This module provides:
+ * - Reducer helpers (toggle, increment, etc.) for use with list.set() and map.set()
+ * - Re-exports list() and map() from their dedicated modules
+ */
+export { list, disposalGroup, getNamedGroup, type ListOptions, type FocusList, type DisposalGroup, type FocusAutoDispose, type FocusAutoDisposeOptions, } from './list';
+export { map, type MapOptions, type FocusMap } from './map';
 /**
  * Toggle a boolean value. Works with undefined (treats as false).
  *
@@ -96,163 +103,4 @@ export declare function merge<T extends object>(partial: Partial<T>): (prev: T |
  * ```
  */
 export declare function reset<T>(defaultValue: T): (prev: T | undefined) => T;
-/**
- * Options for the list helper.
- */
-export interface ListOptions {
-    /** Auto-dispose items when removed. Defaults to false */
-    autoDispose?: boolean;
-}
-/**
- * List API returned by the list() helper.
- */
-export interface FocusList<T> {
-    /** Get the current array (returns empty array if undefined/null) */
-    get(): T[];
-    /** Get item at index */
-    at(index: number): T | undefined;
-    /** Get the length of the array */
-    length(): number;
-    /** Check if array is empty */
-    isEmpty(): boolean;
-    /** Get the first item */
-    first(): T | undefined;
-    /** Get the last item */
-    last(): T | undefined;
-    /** Push item(s) to the end */
-    push(...items: T[]): void;
-    /** Add item(s) to the beginning */
-    unshift(...items: T[]): void;
-    /** Remove and return the last item (auto-disposes if enabled) */
-    pop(): T | undefined;
-    /** Remove and return the first item (auto-disposes if enabled) */
-    shift(): T | undefined;
-    /** Remove item(s) by reference (auto-disposes if enabled) */
-    remove(...items: T[]): number;
-    /** Remove item at index (auto-disposes if enabled) */
-    removeAt(index: number): T | undefined;
-    /** Remove items matching predicate (auto-disposes if enabled) */
-    removeWhere(predicate: (item: T, index: number) => boolean): number;
-    /** Insert item at index */
-    insert(index: number, ...items: T[]): void;
-    /**
-     * Set item at index (auto-disposes old item if enabled).
-     * Accepts direct value, reducer, or immer-style updater.
-     *
-     * @example
-     * items.set(0, newItem);                     // Direct value
-     * items.set(0, prev => ({ ...prev, done: true })); // Reducer
-     * items.set(0, draft => { draft.done = true }); // Updater (mutates draft)
-     */
-    set(index: number, itemOrReducerOrUpdater: T | ((prev: T) => T | void)): void;
-    /** Clear all items (auto-disposes all if enabled) */
-    clear(): void;
-    /** Replace entire array (auto-disposes old items if enabled) */
-    replace(items: T[]): void;
-    /** Find item matching predicate */
-    find(predicate: (item: T, index: number) => boolean): T | undefined;
-    /** Find index of item matching predicate */
-    findIndex(predicate: (item: T, index: number) => boolean): number;
-    /** Check if item exists */
-    includes(item: T): boolean;
-    /** Map items (read-only, doesn't mutate) */
-    map<U>(fn: (item: T, index: number) => U): U[];
-    /** Filter items (read-only, doesn't mutate) */
-    filter(predicate: (item: T, index: number) => boolean): T[];
-    /** Create a pick selector for fine-grained reactivity */
-    pick(equality?: PickEquality<T[] | undefined | null>): T[];
-}
-/**
- * Create a list helper for array focus.
- * Handles undefined/null arrays gracefully.
- *
- * @example
- * ```ts
- * const todoStore = store({
- *   name: 'todos',
- *   state: { items: [] as TodoItem[] },
- *   setup({ focus }) {
- *     const items = focus('items').as(list());
- *     return {
- *       addTodo: (text: string) => items.push({ id: Date.now(), text, done: false }),
- *       removeTodo: (todo: TodoItem) => items.remove(todo),
- *       clearDone: () => items.removeWhere(item => item.done),
- *       clearAll: () => items.clear(),
- *     };
- *   },
- * });
- * ```
- */
-export declare function list<T>(options?: ListOptions): (focus: Focus<T[] | undefined | null> | Focus<T[] | undefined> | Focus<T[] | null> | Focus<T[]>) => FocusList<T>;
-/**
- * Options for the map helper.
- */
-export interface MapOptions {
-    /** Auto-dispose values when removed. Defaults to false */
-    autoDispose?: boolean;
-}
-/**
- * Map API returned by the map() helper.
- */
-export interface FocusMap<T> {
-    /** Get the current record (returns defaultValue if undefined/null) */
-    get(): Record<string, T>;
-    /** Get value by key */
-    at(key: string): T | undefined;
-    /** Get number of entries */
-    size(): number;
-    /** Check if record is empty */
-    isEmpty(): boolean;
-    /** Check if key exists */
-    has(key: string): boolean;
-    /**
-     * Set value at key (auto-disposes old value if enabled).
-     * Accepts direct value, reducer, or immer-style updater.
-     *
-     * @example
-     * cache.set('count', 10);                    // Direct value
-     * cache.set('count', prev => prev + 1);      // Reducer (returns new value)
-     * cache.set('user', draft => { draft.age++ }); // Updater (mutates draft)
-     */
-    set(key: string, valueOrReducerOrUpdater: T | ((prev: T) => T | void)): void;
-    /** Delete key(s) (auto-disposes values if enabled) */
-    delete(...keys: string[]): number;
-    /** Delete keys matching predicate (auto-disposes values if enabled) */
-    deleteWhere(predicate: (value: T, key: string) => boolean): number;
-    /** Clear all entries (auto-disposes all values if enabled) */
-    clear(): void;
-    /** Replace entire record (auto-disposes old values if enabled) */
-    replace(record: Record<string, T>): void;
-    /** Get all keys */
-    keys(): string[];
-    /** Get all values */
-    values(): T[];
-    /** Get all entries */
-    entries(): [string, T][];
-    /** Create a pick selector for fine-grained reactivity */
-    pick(equality?: PickEquality<Record<string, T> | undefined | null>): Record<string, T>;
-}
-/**
- * Create a map helper for object/record focus.
- * Handles undefined/null records gracefully.
- *
- * @example
- * ```ts
- * const cacheStore = store({
- *   name: 'cache',
- *   state: { users: {} as Record<string, User> },
- *   setup({ focus }) {
- *     const users = focus('users').as(map());
- *     return {
- *       setUser: (id: string, user: User) => users.set(id, user),
- *       getUser: (id: string) => users.at(id),
- *       removeUser: (id: string) => users.delete(id),
- *       hasUser: (id: string) => users.has(id),
- *       clearUsers: () => users.clear(),
- *     };
- *   },
- * });
- * ```
- */
-export declare function map<T>(options?: MapOptions): (focus: Focus<Record<string, T> | undefined | null> | Focus<Record<string, T> | undefined> | Focus<Record<string, T> | null> | Focus<Record<string, T>>) => FocusMap<T>;
 //# sourceMappingURL=focusHelpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"focusHelpers.d.ts","sourceRoot":"","sources":["../../src/core/focusHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA2GpD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,KAAK,OAAO,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,MAAM,GAAE,MAAU,GACjB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,MAAM,GAAE,MAAU,GACjB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAEtC;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAE5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAEpE;AAMD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,oEAAoE;IACpE,GAAG,IAAI,CAAC,EAAE,CAAC;IACX,wBAAwB;IACxB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACjC,kCAAkC;IAClC,MAAM,IAAI,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,IAAI,OAAO,CAAC;IACnB,yBAAyB;IACzB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvB,wBAAwB;IACxB,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC;IACtB,8BAA8B;IAC9B,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAC7B,iEAAiE;IACjE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACrB,kEAAkE;IAClE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACvB,6DAA6D;IAC7D,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACvC,iEAAiE;IACjE,WAAW,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;IACpE,2BAA2B;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAC3C;;;;;;;;OAQG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9E,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAC;IACd,gEAAgE;IAChE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC;IACpE,4CAA4C;IAC5C,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;IAClE,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IAC/C,+CAA+C;IAC/C,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,CAAC,EAAE,CAAC;IAC5D,yDAAyD;IACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,WAAW,GACpB,CACD,KAAK,EACD,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,GAC7B,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,GACtB,KAAK,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GACjB,KAAK,CAAC,CAAC,EAAE,CAAC,KACX,SAAS,CAAC,CAAC,CAAC,CAqQhB;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,sEAAsE;IACtE,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzB,uBAAuB;IACvB,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/B,4BAA4B;IAC5B,IAAI,IAAI,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,IAAI,OAAO,CAAC;IACnB,0BAA0B;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7E,sDAAsD;IACtD,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAClC,uEAAuE;IACvE,WAAW,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,CAAC;IACnE,8DAA8D;IAC9D,KAAK,IAAI,IAAI,CAAC;IACd,kEAAkE;IAClE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACzC,mBAAmB;IACnB,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,qBAAqB;IACrB,MAAM,IAAI,CAAC,EAAE,CAAC;IACd,sBAAsB;IACtB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;IACzB,yDAAyD;IACzD,IAAI,CACF,QAAQ,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GAC5D,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,GAAG,CAAC,CAAC,EACnB,OAAO,CAAC,EAAE,UAAU,GACnB,CACD,KAAK,EACD,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,GAC3C,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,GACpC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAC/B,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KACzB,QAAQ,CAAC,CAAC,CAAC,CAsKf"}
+{"version":3,"file":"focusHelpers.d.ts","sourceRoot":"","sources":["../../src/core/focusHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EACL,IAAI,EACJ,aAAa,EACb,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAM5D;;;;;;;;GAQG;AACH,wBAAgB,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,KAAK,OAAO,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,MAAM,GAAE,MAAU,GACjB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,MAAM,GAAE,MAAU,GACjB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAEtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAEtC;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAE5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAEpE"}

package/dist/core/list.d.ts

@@ -0,0 +1,167 @@
+import { Focus, PickEquality } from '../types';
+import { FocusAutoDispose } from './disposalGroup';
+
+/**
+ * Options for the list helper.
+ */
+export interface ListOptions<T> {
+    /**
+     * Auto-dispose items when removed.
+     *
+     * - `false` / `undefined`: No auto-disposal (default)
+     * - `true`: Dispose immediately via microtask
+     * - `number`: Grace period in ms (e.g., `100` = 100ms delay)
+     * - `string`: Named disposal group (shared across collections)
+     * - `DisposalGroup`: Direct group instance
+     * - `{ group, gracePeriodMs }`: Full options
+     *
+     * @example
+     * ```ts
+     * // Simple auto-dispose
+     * list({ autoDispose: true })
+     *
+     * // With 100ms grace period
+     * list({ autoDispose: 100 })
+     *
+     * // Named group - items moving between lists with same group name won't be disposed
+     * list({ autoDispose: "todos" })
+     *
+     * // Named group with grace period
+     * list({ autoDispose: { group: "todos", gracePeriodMs: 100 } })
+     *
+     * // Direct group instance
+     * const group = disposalGroup();
+     * list({ autoDispose: group })
+     * ```
+     */
+    autoDispose?: FocusAutoDispose;
+    /**
+     * Called when item(s) are added to the list.
+     */
+    onAdded?: (item: T, index: number) => void;
+    /**
+     * Called when item(s) are removed from the list.
+     */
+    onRemoved?: (item: T, index: number) => void;
+}
+/**
+ * List API returned by the list() helper.
+ */
+export interface FocusList<T> {
+    /** Get the current array (returns empty array if undefined/null) */
+    get(): T[];
+    /** Get item at index */
+    at(index: number): T | undefined;
+    /** Get the length of the array */
+    length(): number;
+    /** Check if array is empty */
+    isEmpty(): boolean;
+    /** Get the first item */
+    first(): T | undefined;
+    /** Get the last item */
+    last(): T | undefined;
+    /** Push item(s) to the end */
+    push(...items: T[]): void;
+    /** Add item(s) to the beginning */
+    unshift(...items: T[]): void;
+    /** Remove and return the last item (auto-disposes if enabled) */
+    pop(): T | undefined;
+    /** Remove and return the first item (auto-disposes if enabled) */
+    shift(): T | undefined;
+    /** Remove item(s) by reference (auto-disposes if enabled) */
+    remove(...items: T[]): number;
+    /** Remove item at index (auto-disposes if enabled) */
+    removeAt(index: number): T | undefined;
+    /** Remove items matching predicate (auto-disposes if enabled) */
+    removeWhere(predicate: (item: T, index: number) => boolean): number;
+    /** Insert item at index */
+    insert(index: number, ...items: T[]): void;
+    /**
+     * Set item at index (auto-disposes old item if enabled).
+     * Accepts direct value, reducer, or immer-style updater.
+     *
+     * @example
+     * items.set(0, newItem);                     // Direct value
+     * items.set(0, prev => ({ ...prev, done: true })); // Reducer
+     * items.set(0, draft => { draft.done = true }); // Updater (mutates draft)
+     */
+    set(index: number, itemOrReducerOrUpdater: T | ((prev: T) => T | void)): void;
+    /**
+     * Get item at index, or create it if it doesn't exist.
+     *
+     * @example
+     * const item = items.tryGet(5, () => ({ id: 5, name: 'New' }));
+     */
+    tryGet(index: number, create: () => T): T;
+    /**
+     * Swap items at two indices.
+     *
+     * @example
+     * items.swap(0, 2); // Swap first and third items
+     */
+    swap(indexA: number, indexB: number): void;
+    /** Clear all items (auto-disposes all if enabled) */
+    clear(): void;
+    /** Replace entire array (auto-disposes old items if enabled) */
+    replace(items: T[]): void;
+    /** Find item matching predicate */
+    find(predicate: (item: T, index: number) => boolean): T | undefined;
+    /** Find index of item matching predicate */
+    findIndex(predicate: (item: T, index: number) => boolean): number;
+    /** Check if item exists */
+    includes(item: T): boolean;
+    /** Map items (read-only, doesn't mutate) */
+    map<U>(fn: (item: T, index: number) => U): U[];
+    /** Filter items (read-only, doesn't mutate) */
+    filter(predicate: (item: T, index: number) => boolean): T[];
+    /** Create a pick selector for fine-grained reactivity */
+    pick(equality?: PickEquality<T[] | undefined | null>): T[];
+}
+/**
+ * Create a list helper for array focus.
+ * Handles undefined/null arrays gracefully.
+ *
+ * @example
+ * ```ts
+ * const todoStore = store({
+ *   name: 'todos',
+ *   state: { items: [] as TodoItem[] },
+ *   setup({ focus }) {
+ *     const items = focus('items').as(list());
+ *     return {
+ *       addTodo: (text: string) => items.push({ id: Date.now(), text, done: false }),
+ *       removeTodo: (todo: TodoItem) => items.remove(todo),
+ *       clearDone: () => items.removeWhere(item => item.done),
+ *       clearAll: () => items.clear(),
+ *     };
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With named disposal group for cross-collection moves
+ * const todoStore = store({
+ *   name: 'todos',
+ *   state: {
+ *     active: [] as TodoItem[],
+ *     completed: [] as TodoItem[],
+ *   },
+ *   setup({ focus }) {
+ *     // Same group name = items moving between won't be disposed
+ *     const active = focus('active').as(list({ autoDispose: "todos" }));
+ *     const completed = focus('completed').as(list({ autoDispose: "todos" }));
+ *
+ *     return {
+ *       complete: (todo: TodoItem) => {
+ *         active.remove(todo);      // Schedules disposal
+ *         completed.push(todo);     // Cancels disposal - same group!
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare function list<T>(options?: ListOptions<T>): (focus: Focus<T[] | undefined | null> | Focus<T[] | undefined> | Focus<T[] | null> | Focus<T[]>) => FocusList<T>;
+export { disposalGroup, getNamedGroup, type DisposalGroup, type FocusAutoDispose, type FocusAutoDisposeOptions, } from './disposalGroup';
+//# sourceMappingURL=list.d.ts.map

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

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