storion 0.17.0 → 0.18.0

package/CHANGELOG.md

@@ -7,8 +7,114 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Updated React peer dependency requirement from `^18.0.0 || ^19.0.0` and development dependencies to React 19. The library now fully supports React 19's improved Suspense behavior and concurrent rendering.
+
+- Fixed `isNetworkError()` to correctly detect `DOMException` errors in environments where `DOMException` doesn't extend `Error` (e.g., jsdom).
+
+- **BREAKING**: Store `meta` property now accepts either a single `MetaEntry` or `meta.of(...)` for multiple entries (instead of raw arrays).
+  ```ts
+  // Single meta - no change needed
+  meta: persist(),
+
+  // Multiple metas - use meta.of() instead of array
+  meta: meta.of(persist(), notPersisted.for("password")),
+  ```
+
 ### Added
 
+- Custom `StrictMode` component and `useStrictMode()` hook for detecting React StrictMode. Use `StrictMode` from `storion/react` instead of React's built-in one to enable proper handling of double rendering and effect calling:
+  ```tsx
+  import { StoreProvider, StrictMode } from "storion/react";
+  
+  // Use Storion's StrictMode for optimal strict mode handling
+  createRoot(document.getElementById("root")!).render(
+    <StrictMode>
+      <StoreProvider container={app}>
+        <App />
+      </StoreProvider>
+    </StrictMode>
+  );
+  
+  // Detect strict mode in components
+  import { useStrictMode } from "storion/react";
+  
+  function MyComponent() {
+    const isStrictMode = useStrictMode();
+    // ...
+  }
+  ```
+
+- `async.state()` now accepts a function overload for capturing synchronous execution results and Suspense patterns:
+  ```ts
+  // With function - captures execution result
+  const pws = async.state(() => getValue());
+  console.log(pws.state.status); // "fulfilled" if returned, "rejected" if threw Error
+  
+  // Suspense pattern - captures thrown promises
+  const pws = async.state(() => {
+    const cache = getFromCache(key);
+    if (!cache) throw fetchAndCache(key); // throws promise for Suspense
+    return cache;
+  });
+  console.log(pws.state.status); // "pending" if promise thrown, "fulfilled" if cached
+  ```
+
+- `meta.of()` helper for type-safe arrays of metadata entries. Returns `{ metas: [...] }` for proper typing.
+  ```ts
+  import { meta } from "storion";
+
+  const userStore = store({
+    state: { name: "", password: "" },
+    meta: meta.of(
+      persist(),
+      notPersisted.for("password"),
+    ),
+  });
+  ```
+
+- `async.action()` now returns a `success(data)` method for directly setting state without executing the handler. Useful for optimistic updates, websocket/push data, SSR hydration, or testing. Respects `autoCancel` option: with `autoCancel: true` (default), cancels any in-flight request; with `autoCancel: false`, lets in-flight requests complete but prevents them from overwriting the manually set state.
+  ```ts
+  const userQuery = async.action(focus('user'), fetchUser);
+  
+  // Optimistic update
+  userQuery.success(optimisticData);
+  
+  // Websocket push
+  websocket.on('user_updated', (data) => userQuery.success(data));
+  
+  // SSR hydration
+  userQuery.success(window.__DATA__.user);
+  ```
+
+- `observe()` wrapper for abortable functions to observe lifecycle events. The `onStart` callback can return an object with lifecycle callbacks: `onAbort`, `onSuccess`, `onError`, `onDone`.
+  ```ts
+  import { abortable, observe } from "storion/async";
+  
+  // Simple logging
+  const fetchUser = abortable(async (ctx, id: string) => { ... })
+    .use(observe((ctx, id) => {
+      console.log(`Fetching user ${id}`);
+    }));
+  
+  // Full lifecycle
+  const fetchData = abortable(async () => { ... })
+    .use(observe(() => ({
+      onAbort: () => console.log('Aborted'),
+      onSuccess: (data) => console.log('Success:', data),
+      onError: (err) => console.error('Error:', err),
+      onDone: () => console.log('Done'),
+    })));
+  
+  // Loading indicator pattern
+  const fetchData = abortable(async () => { ... })
+    .use(observe(() => {
+      showLoading();
+      return { onDone: hideLoading };
+    }));
+  ```
+
 - `effect()` now automatically catches thrown promises (Suspense-like behavior). When `async.wait()` throws a promise inside an effect, the effect will automatically re-run when the promise resolves. Uses `ctx.nth` to detect staleness - if dependencies change before the promise resolves, the refresh is skipped. On promise rejection, the error is handled via `options.onError` (supports `keepAlive`, `failFast`, retry config, or custom handler).
   ```ts
   effect(() => {
@@ -20,6 +126,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   });
   ```
 
+- `mixins()` helper function for composing multiple mixins into a single selector. Supports array syntax for merging and object syntax for key mapping. Keys ending with "Mixin" suffix are automatically stripped.
+  ```ts
+  import { useStore, mixins } from "storion/react";
+
+  // Object syntax - keys mapped to results, "Mixin" suffix stripped
+  const { t, language } = useStore(mixins({ tMixin, languageMixin }));
+
+  // Array syntax - merge multiple mixins
+  const data = useStore(mixins([userMixin, { count: countMixin }]));
+  ```
+
+### Changed
+
+- **BREAKING**: Removed `useStore(MergeMixin)` and `useStore(MixinMap)` overloads. Use `useStore(mixins(...))` instead:
+  ```ts
+  // Before
+  useStore({ tMixin, countMixin })
+  useStore([userMixin, { count: countMixin }])
+
+  // After
+  useStore(mixins({ tMixin, countMixin }))
+  useStore(mixins([userMixin, { count: countMixin }]))
+  ```
+
 ### Fixed
 
 - Store property subscriptions now correctly re-render when a property changes while its emitter temporarily has **0 listeners** (e.g. around render/commit timing windows), by buffering the last change and replaying it on the next subscription.

package/dist/async/action.d.ts

@@ -0,0 +1,32 @@
+import { Focus } from '../types';
+import { AsyncState, AsyncMode, AsyncHandler, AsyncOptions, AsyncActions } from './types';
+import { Abortable } from './abortable';
+
+/**
+ * Internal implementation for focus-based async.
+ * @internal
+ */
+export declare function asyncWithFocus<T, M extends AsyncMode, TArgs extends any[]>(focus: Focus<AsyncState<T, M>>, handler: AsyncHandler<T, TArgs>, options?: AsyncOptions): AsyncActions<T, M, TArgs>;
+/**
+ * Create async actions bound to a focus (lens) for async state management.
+ * Use *Query naming for read operations, *Mutation for write operations.
+ *
+ * @example
+ * const userStore = store({
+ *   name: 'user',
+ *   state: { user: async.fresh<User>() },
+ *   setup({ focus }) {
+ *     const userQuery = async.action(focus('user'), async (ctx, id: string) => {
+ *       const res = await fetch(`/api/users/${id}`, { signal: ctx.signal });
+ *       return res.json();
+ *     });
+ *     return { fetchUser: userQuery.dispatch };
+ *   },
+ * });
+ */
+export declare function action<T, M extends AsyncMode, TArgs extends any[]>(focus: Focus<AsyncState<T, M>>, handler: AsyncHandler<T, TArgs>, options?: AsyncOptions): AsyncActions<T, M, TArgs>;
+/**
+ * Create async actions with an Abortable (signal auto-injected).
+ */
+export declare function action<T, M extends AsyncMode, TArgs extends any[]>(focus: Focus<AsyncState<T, M>>, abortableFn: Abortable<TArgs, T>, options?: AsyncOptions): AsyncActions<T, M, TArgs>;
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/async/action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EAET,YAAY,EACZ,YAAY,EACZ,YAAY,EAKb,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AA8B1D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAAE,KAAK,SAAS,GAAG,EAAE,EACxE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,EAC/B,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CA+T3B;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAAE,KAAK,SAAS,GAAG,EAAE,EAChE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,EAC/B,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAE7B;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,SAAS,EAAE,KAAK,SAAS,GAAG,EAAE,EAChE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAC9B,WAAW,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/dist/async/async.d.ts

@@ -1,345 +1,75 @@
-import { Focus, MetaEntry, SelectorMixin } from '../types';
-import { AsyncState, AsyncMode, AsyncHandler, AsyncOptions, AsyncActions, CancellablePromise, AsyncKey, AsyncRequestId, PromiseWithState, AsyncOrPromise, InferData, MapData, MapRecordData, CombinedSettledResult, MapCombinedSettledResult, CombinedRaceResult } from './types';
-import { Abortable } from './abortable';
-
+import { fresh, stale } from './state';
+import { action } from './action';
+import { mixin } from './mixin';
+import { wait, hasData, isLoading, isError } from './wait';
+import { all, any, race, settled } from './combine';
+import { derive } from './derive';
+import { chain } from './then';
+import { delay, state } from './utils';
 /**
- * Get the pending promise for an async state (for Suspense).
- * Returns undefined if no pending promise.
- */
-export declare function getPendingPromise<T>(state: AsyncState<T, any>): Promise<T> | undefined;
-/**
- * Convert a value or parameterless function to a Promise.
- * Handles: PromiseLike, sync values, functions returning either.
+ * Async module - reactive async state management.
  *
- * @example
- * toPromise(42)                    // Promise.resolve(42)
- * toPromise(Promise.resolve(42))   // Promise.resolve(42)
- * toPromise(() => 42)              // Promise.resolve(42)
- * toPromise(() => fetchData())     // fetchData() promise
- * toPromise(thenable)              // Promise wrapping thenable
- */
-export declare function toPromise<T>(value: T | (() => T)): Promise<Awaited<T>>;
-/**
- * Wraps a synchronous or async function to always return a Promise.
- * Ensures async execution even for synchronous functions.
- */
-declare function promiseTry<T>(fn: () => T | PromiseLike<T>): Promise<Awaited<T>>;
-/**
- * Options for creating an async selector mixin.
+ * This module provides:
+ * - State creators: `async.fresh()`, `async.stale()`
+ * - Store-bound actions: `async.action()`
+ * - Component-local mixins: `async.mixin()`
+ * - Data extraction: `async.wait()`, `async.hasData()`, `async.isLoading()`, `async.isError()`
+ * - Combinators: `async.all()`, `async.any()`, `async.race()`, `async.settled()`
+ * - Derivation: `async.derive()`
+ * - Promise-like chaining: `async.chain()`
+ * - Utilities: `async.delay()`, `async.invoke()`, `async.state()`
  */
-export interface AsyncMixinOptions<T, M extends AsyncMode = "fresh"> extends AsyncOptions {
-    /**
-     * Initial async state. Defaults to `async.fresh<T>()`.
-     */
-    initial?: AsyncState<T, M>;
-    /**
-     * Name of store for the async state. Defaults to `async:${handler.name || "anonymous"}`.
-     */
-    name?: string;
-    /**
-     * Metadata for the async state. Defaults to empty array.
-     */
-    meta?: MetaEntry<"result"> | MetaEntry<"result">[];
-}
+export type { AsyncMixinOptions, AsyncMixinResult } from './mixin';
+export type { AsyncStateExtra } from './state';
+export { asyncState, asyncStateFrom } from './state';
+export { getPendingPromise } from './helpers';
+export { toPromise } from './utils';
 /**
- * Result tuple from async selector mixin: [state, actions]
- */
-export type AsyncMixinResult<T, M extends AsyncMode, TArgs extends any[]> = [
-    AsyncState<T, M>,
-    AsyncActions<T, M, TArgs>
-];
-/**
- * Extra properties that can be added to async state.
- * @internal
- */
-interface AsyncStateExtra<T> {
-    __key?: AsyncKey<T>;
-    __requestId?: AsyncRequestId;
-}
-/**
- * Create a frozen AsyncState with the specified status.
- * Users cannot modify properties directly - must use async actions.
- *
- * Overloads:
- * - asyncState("fresh", "idle") - Fresh idle state
- * - asyncState("fresh", "pending", extra?) - Fresh pending state
- * - asyncState("fresh", "success", data) - Fresh success state
- * - asyncState("fresh", "error", error, extra?) - Fresh error state
- * - asyncState("stale", "idle", data) - Stale idle state
- * - asyncState("stale", "pending", data, extra?) - Stale pending state
- * - asyncState("stale", "success", data) - Stale success state
- * - asyncState("stale", "error", data, error, extra?) - Stale error state
- */
-export declare function asyncState<T = unknown>(mode: "fresh", status: "idle"): AsyncState<T, "fresh">;
-export declare function asyncState<T = unknown>(mode: "fresh", status: "pending", extra?: AsyncStateExtra<T>): AsyncState<T, "fresh">;
-export declare function asyncState<T>(mode: "fresh", status: "success", data: T): AsyncState<T, "fresh">;
-export declare function asyncState<T = unknown>(mode: "fresh", status: "error", error: Error, extra?: AsyncStateExtra<T>): AsyncState<T, "fresh">;
-export declare function asyncState<T>(mode: "stale", status: "idle", data: T): AsyncState<T, "stale">;
-export declare function asyncState<T>(mode: "stale", status: "pending", data: T, extra?: AsyncStateExtra<T>): AsyncState<T, "stale">;
-export declare function asyncState<T>(mode: "stale", status: "success", data: T): AsyncState<T, "stale">;
-export declare function asyncState<T>(mode: "stale", status: "error", data: T, error: Error, extra?: AsyncStateExtra<T>): AsyncState<T, "stale">;
-export declare namespace asyncState {
-    var from: typeof asyncStateFrom;
-}
-/**
- * Create a new AsyncState based on a previous state, preserving mode and stale data.
- * Useful for deriving new states while maintaining the mode semantics.
+ * Async namespace providing reactive async state management.
  *
  * @example
- * // From success to pending (preserves mode and stale data)
- * const next = asyncState.from(prev, "pending");
+ * // Create async state in store
+ * const userStore = store({
+ *   name: 'user',
+ *   state: { user: async.fresh<User>() },
+ *   setup({ focus }) {
+ *     const userQuery = async.action(focus('user'), async (ctx, id: string) => {
+ *       const res = await fetch(`/api/users/${id}`, { signal: ctx.signal });
+ *       return res.json();
+ *     });
+ *     return { fetchUser: userQuery.dispatch };
+ *   },
+ * });
  *
- * // From pending to success
- * const next = asyncState.from(prev, "success", newData);
+ * @example
+ * // Use async mixin in component
+ * const submitMutation = async.mixin(async (ctx, data: FormData) => {
+ *   const res = await fetch('/api/submit', { method: 'POST', body: data });
+ *   return res.json();
+ * });
  *
- * // From any to error
- * const next = asyncState.from(prev, "error", new Error("failed"));
+ * function Form() {
+ *   const [state, { dispatch }] = useStore(({ mixin }) => mixin(submitMutation));
+ *   return <button onClick={() => dispatch(formData)}>Submit</button>;
+ * }
  */
-export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "idle"): AsyncState<T, M>;
-export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "pending"): AsyncState<T, M>;
-export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "success", data: T): AsyncState<T, M>;
-export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "error", error: Error): AsyncState<T, M>;
-export declare namespace async {
-    /**
-     * Create a fresh mode async state (data undefined during loading/error).
-     */
-    function fresh<T = unknown>(): AsyncState<T, "fresh">;
-    /**
-     * Create a stale mode async state with initial data.
-     * Data is preserved during loading and error states.
-     */
-    function stale<T>(): AsyncState<T | undefined, "stale">;
-    function stale<T>(initialData: T | undefined | null): AsyncState<T, "stale">;
-    /**
-     * Create async actions bound to a focus (lens) for async state management.
-     * Use *Query naming for read operations, *Mutation for write operations.
-     *
-     * @example
-     * const userStore = store({
-     *   name: 'user',
-     *   state: { user: async.fresh<User>() },
-     *   setup({ focus }) {
-     *     const userQuery = async.action(focus('user'), async (ctx, id: string) => {
-     *       const res = await fetch(`/api/users/${id}`, { signal: ctx.signal });
-     *       return res.json();
-     *     });
-     *     return { fetchUser: userQuery.dispatch };
-     *   },
-     * });
-     */
-    function action<T, M extends AsyncMode, TArgs extends any[]>(focus: Focus<AsyncState<T, M>>, handler: AsyncHandler<T, TArgs>, options?: AsyncOptions): AsyncActions<T, M, TArgs>;
-    /**
-     * Create async actions with an Abortable (signal auto-injected).
-     */
-    function action<T, M extends AsyncMode, TArgs extends any[]>(focus: Focus<AsyncState<T, M>>, abortableFn: Abortable<TArgs, T>, options?: AsyncOptions): AsyncActions<T, M, TArgs>;
-    /**
-     * Create an async selector mixin for component-local async state.
-     * Uses `scoped()` internally, so state is isolated per component and auto-disposed.
-     *
-     * @example
-     * const submitMutation = async.mixin(async (ctx, data: FormData) => {
-     *   const res = await fetch('/api/submit', {
-     *     method: 'POST',
-     *     body: JSON.stringify(data),
-     *     signal: ctx.signal,
-     *   });
-     *   return res.json();
-     * });
-     *
-     * function ContactForm() {
-     *   const [state, { dispatch }] = useStore(({ mixin }) => mixin(submitMutation));
-     *   return <button onClick={() => dispatch(formData)}>Submit</button>;
-     * }
-     */
-    function mixin<T, TArgs extends any[]>(handler: AsyncHandler<T, TArgs>, options?: AsyncMixinOptions<T, "fresh">): SelectorMixin<AsyncMixinResult<T, "fresh", TArgs>>;
-    /**
-     * Create an async selector mixin with stale mode.
-     */
-    function mixin<T, TArgs extends any[]>(handler: AsyncHandler<T, TArgs>, options: AsyncMixinOptions<T, "stale"> & {
-        initial: AsyncState<T, "stale">;
-    }): SelectorMixin<AsyncMixinResult<T, "stale", TArgs>>;
-    /**
-     * Create an async selector mixin with an Abortable (signal auto-injected).
-     */
-    function mixin<T, TArgs extends any[]>(abortableFn: Abortable<TArgs, T>, options?: AsyncMixinOptions<T, "fresh">): SelectorMixin<AsyncMixinResult<T, "fresh", TArgs>>;
-    /**
-     * Create an async selector mixin with an Abortable and stale mode.
-     */
-    function mixin<T, TArgs extends any[]>(abortableFn: Abortable<TArgs, T>, options: AsyncMixinOptions<T, "stale"> & {
-        initial: AsyncState<T, "stale">;
-    }): SelectorMixin<AsyncMixinResult<T, "stale", TArgs>>;
-    function delay<T = void>(ms: number, resolved?: T): CancellablePromise<T>;
-    /**
-     * Wraps a synchronous or async function to always return a Promise.
-     * Ensures async execution even for synchronous functions.
-     *
-     * This is the same utility used internally for dispatching handlers.
-     *
-     * @example
-     * const promise = async.invoke(() => {
-     *   // Sync or async code
-     *   return someValue;
-     * });
-     */
-    const invoke: typeof promiseTry;
-    /**
-     * Extract data from AsyncState, throws if not ready.
-     * - Success: returns data
-     * - Stale mode (idle/pending/error with data): returns stale data
-     * - Pending with promise: throws promise (for Suspense)
-     * - Otherwise: throws error or AsyncNotReadyError
-     */
-    function wait<T, M extends AsyncMode>(state: AsyncState<T, M>): M extends "stale" ? T : T;
-    /**
-     * Returns the first successful result from an array or record of async states.
-     * Supports both AsyncState and PromiseWithState.
-     *
-     * @example
-     * ```ts
-     * // Array form
-     * const [key, data] = async.race([state1, state2]);
-     *
-     * // Map form
-     * const [key, data] = async.race({ user: userState, posts: postsState });
-     * ```
-     */
-    function race<const T extends readonly AsyncOrPromise[]>(states: T): [number, InferData<T[number]>];
-    function race<T extends Record<string, AsyncOrPromise>>(states: T): CombinedRaceResult<T>;
-    /**
-     * Get the state of a promise.
-     * @param promise - The promise to get the state of.
-     * @returns The state of the promise.
-     */
-    function state<T>(promise: PromiseLike<T>): PromiseWithState<T>;
-    /**
-     * Returns all data if all states are ready.
-     * Supports both AsyncState and PromiseWithState, as array, record, or rest params.
-     *
-     * @example
-     * ```ts
-     * // Rest params (backward compatible)
-     * const [a, b, c] = async.all(state1, state2, state3);
-     *
-     * // Array form - returns tuple of data
-     * const [userData, postsData] = async.all([userState, postsState]);
-     *
-     * // Map form - returns record of data
-     * const { user, posts } = async.all({ user: userState, posts: postsState });
-     * ```
-     */
-    function all<const T extends readonly AsyncOrPromise[]>(states: T): MapData<T>;
-    function all<T extends Record<string, AsyncOrPromise>>(states: T): MapRecordData<T>;
-    function all<const T extends readonly AsyncOrPromise[]>(...states: T): MapData<T>;
-    /**
-     * Returns the first ready data from multiple states.
-     * Supports both AsyncState and PromiseWithState, as array, record, or rest params.
-     *
-     * @example
-     * ```ts
-     * // Rest params (backward compatible)
-     * const data = async.any(state1, state2, state3);
-     *
-     * // Array form
-     * const data = async.any([state1, state2, state3]);
-     *
-     * // Map form
-     * const data = async.any({ primary: primaryState, fallback: fallbackState });
-     * ```
-     */
-    function any<const T extends readonly AsyncOrPromise[]>(states: T): InferData<T[number]>;
-    function any<T extends Record<string, AsyncOrPromise>>(states: T): InferData<T[keyof T]>;
-    function any<const T extends readonly AsyncOrPromise[]>(...states: T): InferData<T[number]>;
-    /**
-     * Returns settled results for all states (never throws).
-     * Supports both AsyncState and PromiseWithState, as array, record, or rest params.
-     *
-     * @example
-     * ```ts
-     * // Rest params (backward compatible)
-     * const results = async.settled(state1, state2);
-     *
-     * // Array form
-     * const results = async.settled([state1, state2]);
-     * // [{ status: "fulfilled", value: data1 }, { status: "rejected", reason: error }]
-     *
-     * // Map form
-     * const results = async.settled({ user: userState, posts: postsState });
-     * // { user: { status: "fulfilled", value: userData }, posts: { status: "pending" } }
-     * ```
-     */
-    function settled<const T extends readonly AsyncOrPromise[]>(states: T): MapCombinedSettledResult<T>;
-    function settled<T extends Record<string, AsyncOrPromise>>(states: T): {
-        [K in keyof T]: CombinedSettledResult<InferData<T[K]>>;
-    };
-    function settled<const T extends readonly AsyncOrPromise[]>(...states: T): MapCombinedSettledResult<T>;
-    /**
-     * Check if state has data available (success or stale).
-     */
-    function hasData<T, M extends AsyncMode>(state: AsyncState<T, M>): state is AsyncState<T, M> & {
-        data: T;
-    };
-    /**
-     * Check if state is loading (pending status).
-     */
-    function isLoading<T, M extends AsyncMode>(state: AsyncState<T, M>): state is AsyncState<T, M> & {
-        status: "pending";
-    };
-    /**
-     * Check if state has an error.
-     */
-    function isError<T, M extends AsyncMode>(state: AsyncState<T, M>): state is AsyncState<T, M> & {
-        status: "error";
-        error: Error;
-    };
-    /**
-     * Derive an async state from other async states using a synchronous computation.
-     * The computation function uses `async.wait()` to extract data from async states,
-     * which throws promises when states are pending.
-     *
-     * Key behaviors:
-     * - If `computeFn` throws a promise (via `async.wait`), sets focus to pending and re-runs after promise settles
-     * - If `computeFn` throws an error, sets focus to error state
-     * - If `computeFn` returns a value, sets focus to success state
-     * - If `computeFn` returns a promise (not throws), throws an error - must be synchronous
-     * - Uses a single wrapper promise to avoid cascading re-renders
-     *
-     * @param focus - Focus to update with derived async state
-     * @param computeFn - Synchronous computation function that uses `async.wait()` to read async states
-     * @returns Dispose function to stop the derivation
-     *
-     * @example
-     * // Basic usage - derive from multiple async states
-     * async.derive(focus('c'), () => {
-     *   const a = async.wait(state.a);
-     *   const b = async.wait(state.b);
-     *   return a + b;
-     * });
-     *
-     * @example
-     * // Conditional dependencies
-     * async.derive(focus('result'), () => {
-     *   const type = async.wait(state.type);
-     *   if (type === 'user') {
-     *     return async.wait(state.userData);
-     *   } else {
-     *     return async.wait(state.guestData);
-     *   }
-     * });
-     *
-     * @example
-     * // For parallel waiting, use async.all
-     * async.derive(focus('combined'), () => {
-     *   const [a, b, c] = async.all([state.a, state.b, state.c]);
-     *   return { a, b, c };
-     * });
-     *
-     * @example
-     * // With stale mode - preserves data during loading/error
-     * async.derive(focus('result'), () => {
-     *   return async.wait(state.userData);
-     * });
-     */
-    function derive<T, M extends AsyncMode = "fresh">(focus: Focus<AsyncState<T, M>>, computeFn: () => T): VoidFunction;
-}
-export {};
+export declare const async: {
+    fresh: typeof fresh;
+    stale: typeof stale;
+    action: typeof action;
+    mixin: typeof mixin;
+    wait: typeof wait;
+    hasData: typeof hasData;
+    isLoading: typeof isLoading;
+    isError: typeof isError;
+    all: typeof all;
+    any: typeof any;
+    race: typeof race;
+    settled: typeof settled;
+    derive: typeof derive;
+    chain: typeof chain;
+    delay: typeof delay;
+    invoke: typeof import('./helpers').promiseTry;
+    state: typeof state;
+};
 //# sourceMappingURL=async.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/async/async.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../src/async/async.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAU,KAAK,EAAE,MAAM,SAAS,CAAC;AAM/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;CAqCjB,CAAC"}