storion 0.10.1 → 0.11.0

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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"}

package/dist/core/map.d.ts

@@ -0,0 +1,153 @@
+import { Focus, PickEquality } from '../types';
+import { FocusAutoDispose } from './disposalGroup';
+
+/**
+ * Options for the map helper.
+ */
+export interface MapOptions<T> {
+    /**
+     * Auto-dispose values 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
+     * map({ autoDispose: true })
+     *
+     * // With 100ms grace period
+     * map({ autoDispose: 100 })
+     *
+     * // Named group - values moving between maps with same group name won't be disposed
+     * map({ autoDispose: "cache" })
+     *
+     * // Named group with grace period
+     * map({ autoDispose: { group: "cache", gracePeriodMs: 100 } })
+     *
+     * // Direct group instance
+     * const group = disposalGroup();
+     * map({ autoDispose: group })
+     * ```
+     */
+    autoDispose?: FocusAutoDispose;
+    /**
+     * Called when value is added to the map.
+     */
+    onAdded?: (value: T, key: string) => void;
+    /**
+     * Called when value is removed from the map.
+     */
+    onRemoved?: (value: T, key: string) => void;
+}
+/**
+ * Map API returned by the map() helper.
+ */
+export interface FocusMap<T> {
+    /** Get the current record (returns empty object 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;
+    /**
+     * Get value at key, or create it if it doesn't exist.
+     *
+     * @example
+     * const user = users.tryGet('user-123', () => ({ id: 'user-123', name: 'New' }));
+     */
+    tryGet(key: string, create: () => T): T;
+    /**
+     * Swap values at two keys.
+     *
+     * @example
+     * cache.swap('a', 'b'); // Swap values at keys 'a' and 'b'
+     */
+    swap(keyA: string, keyB: string): 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(),
+ *     };
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With named disposal group for cross-collection moves
+ * const cacheStore = store({
+ *   name: 'cache',
+ *   state: {
+ *     active: {} as Record<string, Session>,
+ *     archived: {} as Record<string, Session>,
+ *   },
+ *   setup({ focus }) {
+ *     // Same group name = values moving between won't be disposed
+ *     const active = focus('active').as(map({ autoDispose: "sessions" }));
+ *     const archived = focus('archived').as(map({ autoDispose: "sessions" }));
+ *
+ *     return {
+ *       archiveSession: (id: string) => {
+ *         const session = active.at(id);
+ *         if (session) {
+ *           active.delete(id);         // Schedules disposal
+ *           archived.set(id, session); // Cancels disposal - same group!
+ *         }
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+export declare function map<T>(options?: MapOptions<T>): (focus: Focus<Record<string, T> | undefined | null> | Focus<Record<string, T> | undefined> | Focus<Record<string, T> | null> | Focus<Record<string, T>>) => FocusMap<T>;
+export { disposalGroup, getNamedGroup, type DisposalGroup, type FocusAutoDispose, type FocusAutoDisposeOptions, } from './disposalGroup';
+//# sourceMappingURL=map.d.ts.map

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

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

package/dist/dev.d.ts

@@ -1,47 +1,52 @@
 /**
  * Development-only utilities.
  *
- * These use the __DEV__ flag which should be defined by the consuming application's bundler.
+ * Uses `process.env.NODE_ENV` which bundlers (Vite, Webpack, Rollup) replace at build time.
+ * In production builds, all code inside `if (process.env.NODE_ENV !== 'production')` blocks
+ * is completely removed via dead code elimination.
+ *
+ * **How it works:**
+ * 1. Bundler replaces `process.env.NODE_ENV` with `"production"` or `"development"`
+ * 2. Condition becomes `if ("production" !== 'production')` → `if (false)`
+ * 3. Minifier removes the entire dead code block
  *
- * **For consuming applications:**
- * Add this to your Vite config:
+ * @example
  * ```ts
- * export default defineConfig({
- *   define: {
- *     __DEV__: JSON.stringify(process.env.NODE_ENV !== 'production'),
- *   },
- * });
+ * // Development build (after bundling):
+ * if ("development" !== 'production') {
+ *   console.warn('Warning'); // ✅ Included
+ * }
+ *
+ * // Production build (after bundling + minification):
+ * // The entire block is removed - zero runtime cost
  * ```
+ */
+/**
+ * Check if running in development mode.
  *
- * In production builds with __DEV__ = false, all code inside `if (__DEV__)` blocks
- * is completely removed via dead code elimination.
+ * **Note:** For tree-shaking to work, use the inline pattern directly:
+ * ```ts
+ * if (process.env.NODE_ENV !== 'production') {
+ *   // dev-only code
+ * }
+ * ```
  *
- * If __DEV__ is not defined, these utilities fall back to checking process.env.NODE_ENV.
+ * @returns `true` if in development mode, `false` in production
  */
+export declare function isDev(): boolean;
 /**
  * Development utilities namespace.
  *
- * **Usage:**
+ * **Important:** For optimal tree-shaking, prefer using inline checks:
  * ```ts
- * // Check if in dev mode
- * if (dev()) {
- *   // dev code
+ * if (process.env.NODE_ENV !== 'production') {
+ *   console.warn('[storion] Warning message');
  * }
- *
- * // Run function only in dev
- * dev(() => {
- *   validateSignalGraph();
- * });
- *
- * // Logging
- * dev.log("Signal created:", signal);
- * dev.warn("Deprecated API used");
- * dev.error("Invalid config:", config);
- *
- * // Assertions
- * dev.assert(value !== undefined, "Value cannot be undefined");
  * ```
  *
+ * The `dev.*` utilities are convenient but require the bundler to inline
+ * the `process.env.NODE_ENV` check within the function body.
+ *
  * @example
  * ```ts
  * // Check dev mode
@@ -68,7 +73,6 @@ export declare function dev(fn?: () => void): boolean;
 export declare namespace dev {
     /**
      * Log a message only in development.
-     * If __DEV__ is defined and is false, this is removed via dead code elimination.
      *
      * @param message - Message to log
      * @param args - Additional arguments
@@ -76,14 +80,13 @@ export declare namespace dev {
      * @example
      * ```ts
      * dev.log("Signal created:", signal);
-     * // Production (with __DEV__ defined): removed entirely
-     * // Development: console.log("[rextive] Signal created:", signal)
+     * // Production: removed entirely
+     * // Development: console.log("[storion] Signal created:", signal)
      * ```
      */
     function log(message: string, ...args: any[]): void;
     /**
      * Log a warning only in development.
-     * If __DEV__ is defined and is false, this is removed via dead code elimination.
      *
      * @param message - Warning message
      * @param args - Additional arguments
@@ -91,14 +94,13 @@ export declare namespace dev {
      * @example
      * ```ts
      * dev.warn("Deprecated API used");
-     * // Production (with __DEV__ defined): removed entirely
-     * // Development: console.warn("[rextive] Deprecated API used")
+     * // Production: removed entirely
+     * // Development: console.warn("[storion] Deprecated API used")
      * ```
      */
     function warn(message: string, ...args: any[]): void;
     /**
      * Log an error only in development.
-     * If __DEV__ is defined and is false, this is removed via dead code elimination.
      *
      * @param message - Error message
      * @param args - Additional arguments
@@ -106,14 +108,13 @@ export declare namespace dev {
      * @example
      * ```ts
      * dev.error("Invalid configuration:", config);
-     * // Production (with __DEV__ defined): removed entirely
-     * // Development: console.error("[rextive] Invalid configuration:", config)
+     * // Production: removed entirely
+     * // Development: console.error("[storion] Invalid configuration:", config)
      * ```
      */
     function error(message: string, ...args: any[]): void;
     /**
      * Assert a condition only in development.
-     * If __DEV__ is defined and is false, this is removed via dead code elimination.
      *
      * @param condition - Condition to assert
      * @param message - Error message if assertion fails
@@ -121,7 +122,7 @@ export declare namespace dev {
      * @example
      * ```ts
      * dev.assert(signal !== undefined, "Signal cannot be undefined");
-     * // Production (with __DEV__ defined): removed entirely
+     * // Production: removed entirely
      * // Development: throws if condition is false
      * ```
      */

package/dist/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmCH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAW5C;AAED;;GAEG;AACH,yBAAiB,GAAG,CAAC;IACnB;;;;;;;;;;;;;OAaG;IACH,SAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAIzD;IAED;;;;;;;;;;;;;OAaG;IACH,SAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAI1D;IAED;;;;;;;;;;;;;OAaG;IACH,SAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAI3D;IAED;;;;;;;;;;;;;OAaG;IACH,SAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMhE;CACF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAU5C;AAED;;GAEG;AACH,yBAAiB,GAAG,CAAC;IACnB;;;;;;;;;;;;OAYG;IACH,SAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAIzD;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAI1D;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAI3D;IAED;;;;;;;;;;;;OAYG;IACH,SAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAMhE;CACF"}

package/dist/{effect-BDQU8Voz.js → effect-1beiYe_c.js}

@@ -1985,53 +1985,38 @@ function pick(selector, equality2) {
   });
   return currentValue;
 }
-function checkIsDev() {
-  var _a;
-  if (typeof __DEV__ !== "undefined") {
-    return __DEV__;
-  }
-  try {
-    const p = globalThis.process;
-    if ((_a = p == null ? void 0 : p.env) == null ? void 0 : _a.NODE_ENV) {
-      return p.env.NODE_ENV !== "production";
-    }
-  } catch {
-  }
-  return false;
-}
 function dev(fn) {
-  const isDev = checkIsDev();
+  if (process.env.NODE_ENV === "production") {
+    return false;
+  }
   if (fn) {
-    if (isDev) {
-      fn();
-    }
-    return isDev;
+    fn();
   }
-  return isDev;
+  return true;
 }
 ((dev2) => {
   function log(message, ...args) {
-    if (checkIsDev()) {
-      console.log(`[rextive] ${message}`, ...args);
+    if (process.env.NODE_ENV !== "production") {
+      console.log(`[storion] ${message}`, ...args);
     }
   }
   dev2.log = log;
   function warn(message, ...args) {
-    if (checkIsDev()) {
-      console.warn(`[rextive] ${message}`, ...args);
+    if (process.env.NODE_ENV !== "production") {
+      console.warn(`[storion] ${message}`, ...args);
     }
   }
   dev2.warn = warn;
   function error(message, ...args) {
-    if (checkIsDev()) {
-      console.error(`[rextive] ${message}`, ...args);
+    if (process.env.NODE_ENV !== "production") {
+      console.error(`[storion] ${message}`, ...args);
     }
   }
   dev2.error = error;
   function assert(condition, message) {
-    if (checkIsDev()) {
+    if (process.env.NODE_ENV !== "production") {
       if (!condition) {
-        throw new Error(`[rextive] Assertion failed: ${message}`);
+        throw new Error(`[storion] Assertion failed: ${message}`);
       }
     }
   }
@@ -2962,7 +2947,8 @@ function createAbortableContext(controller, pauseState, takeState, setStatus) {
     race: baseSafe.race,
     settled: baseSafe.settled,
     any: baseSafe.any,
-    callback: baseSafe.callback
+    callback: baseSafe.callback,
+    delay: baseSafe.delay
   });
   const take = (key) => {
     const takeKey = String(key ?? "__checkpoint__");
@@ -3311,12 +3297,24 @@ function createSafe(getSignal, isCancelled) {
       cb(...args);
     };
   };
+  const delay = (ms, resolved) => {
+    if (isCancelled()) {
+      return new Promise(() => {
+      });
+    }
+    return wrapPromise(
+      new Promise((resolve) => {
+        setTimeout(() => resolve(resolved), ms);
+      })
+    );
+  };
   return Object.assign(safe, {
     all,
     race,
     settled,
     any,
-    callback
+    callback,
+    delay
   });
 }
 const retryStrategy = {
@@ -3615,10 +3613,11 @@ function effect(fn, options) {
 }
 export {
   AsyncNotReadyError as A,
-  pool as B,
-  tryDispose as C,
-  unwrapFn as D,
+  LocalStoreDependencyError as B,
+  pool as C,
+  tryDispose as D,
   EffectRefreshError as E,
+  unwrapFn as F,
   HooksContextError as H,
   InvalidActionError as I,
   LifetimeMismatchError as L,
@@ -3635,19 +3634,19 @@ export {
   isSpec as i,
   ScopedOutsideSelectorError as j,
   STORION_TYPE as k,
-  resolveEquality as l,
-  is$1 as m,
-  batch as n,
-  equality as o,
+  dev as l,
+  resolveEquality as m,
+  is$1 as n,
+  batch as o,
   pick as p,
-  shallowEqual as q,
+  equality as q,
   retryStrategy as r,
   storeTuple as s,
   tryStabilize as t,
   untrack as u,
-  deepEqual as v,
+  shallowEqual as v,
   withHooks as w,
-  StorionError as x,
-  StoreDisposedError as y,
-  LocalStoreDependencyError as z
+  deepEqual as x,
+  StorionError as y,
+  StoreDisposedError as z
 };

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { container } from './core/container';
 export { batch, untrack } from './core/tracking';
 export { createResolver as resolver } from './core/createResolver';
 export { pick } from './core/pick';
-export { list, map, toggle, increment, decrement, multiply, divide, clamp, append, prepend, merge, reset, type ListOptions, type MapOptions, type FocusList, type FocusMap, } from './core/focusHelpers';
+export { list, map, disposalGroup, getNamedGroup, toggle, increment, decrement, multiply, divide, clamp, append, prepend, merge, reset, type ListOptions, type MapOptions, type FocusList, type FocusMap, type DisposalGroup, type FocusAutoDispose, type FocusAutoDisposeOptions, } from './core/focusHelpers';
 export { effect, type EffectFn, type EffectContext, type EffectOptions, type EffectErrorStrategy, type EffectErrorContext, type EffectRetryConfig, } from './core/effect';
 export { applyFor, applyExcept, forStores, type SpecPattern, type MiddlewareMap, } from './core/middleware';
 export { equality, shallowEqual, deepEqual, strictEqual, } from './core/equality';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnC,OAAO,EACL,IAAI,EACJ,GAAG,EAEH,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,EACL,KAAK,EAEL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,MAAM,EACN,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAG1B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,cAAc,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGnE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnC,OAAO,EACL,IAAI,EACJ,GAAG,EACH,aAAa,EACb,aAAa,EAEb,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,MAAM,EACN,KAAK,EACL,MAAM,EACN,OAAO,EACP,KAAK,EACL,KAAK,EAEL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,MAAM,EACN,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAGzD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}