@kdeveloper/kvark 0.6.9 → 0.8.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/@kdeveloper/kvark.svg)](https://www.npmjs.com/package/@kdeveloper/kvark)
 
-Atomic state management for **React** and **Vue 3** with **explicit dependency graphs**, stale-while-revalidate, and first-class external invalidation.
+Atomic state management for **React**, **Preact**, and **Vue 3** with **explicit dependency graphs**, stale-while-revalidate, and first-class external invalidation.
 
 Inspired by Jotai, but built around a key difference: dependencies are declared upfront rather than inferred at runtime. This makes the data graph statically analysable, enables parallel loading, and allows invalidation from anywhere — WebSocket handlers, SSE streams, timers, Service Workers — without framework hooks.
 
@@ -23,7 +23,7 @@ Inspired by Jotai, but built around a key difference: dependencies are declared
 
 ```bash
 pnpm add @kdeveloper/kvark
-# optional peers: react >=18 and/or vue >=3.4
+# optional peers: react >=18, preact >=10, and/or vue >=3.4
 ```
 
 ## Quick Start
@@ -70,6 +70,16 @@ function UserCard() {
 }
 ```
 
+### Preact
+
+The same atoms and store work with `@kdeveloper/kvark/preact` — the API is identical to the React integration. Replace the React import with the Preact one:
+
+```tsx
+import { Provider, useAtomValue, useSetAtom } from "@kdeveloper/kvark/preact";
+```
+
+Hooks use only `preact` and `preact/hooks` internally — no `preact/compat` aliases required.
+
 ### Vue 3
 
 The same atoms and store work with `@kdeveloper/kvark/vue`. Composables mirror the React hooks; `useAtomValue` returns an **awaitable** [`shallowRef`](https://vuejs.org/api/reactivity-advanced.html#shallowref) — use `.value` in `<script setup>` (templates unwrap refs automatically). Until the first `get` resolves, that ref’s value is `undefined`; TypeScript types it as `V | undefined` (`ThenableShallowRef<V>`). After `await useAtomValue(atom)` you get `Readonly<ShallowRef<V>>` with a defined `.value`. The ref also implements `PromiseLike`, so awaiting it in an async `setup` suspends until the first `get` resolves — see [Suspense (Vue 3)](#suspense-vue-3).
@@ -192,6 +202,8 @@ The `ctx` passed to `set` provides:
 - **`ctx.get(key)`** — read any declared dependency (same as in `get`).
 - **`ctx.signal`** — an `AbortSignal` tied to the atom's lifecycle, useful for cancelling in-flight requests.
 - **`ctx.setOptimisticValue(value)`** — synchronously update the atom's cached value before the async work completes (see below). Also accepts a mutator `(prev) => next`.
+- **`ctx.writeOptimistic(atom, value)`** — synchronously write into another atom's cache with automatic rollback on error (see [Dependent mutations](#dependent-mutations)). Also accepts a mutator.
+- **`ctx.invalidate(atom)`** / **`ctx.invalidateMany(atoms)`** — mark unrelated atoms as stale so they refetch (see [Dependent mutations](#dependent-mutations)).
 
 #### Optimistic updates
 
@@ -226,6 +238,112 @@ set: async (ctx) => {
 
 If the `PUT` fails, the atom reverts to whatever value `get` had loaded before the optimistic update — no manual rollback needed.
 
+#### Dependent mutations
+
+The `ctx` inside `set` also provides methods for cross-atom side-effects:
+
+- **`ctx.invalidate(atom)`** — mark another atom as `stale` and schedule a refetch. Does **not** participate in rollback; best called after the async work succeeds.
+- **`ctx.invalidateMany(atoms)`** — same as `invalidate`, but for multiple atoms at once.
+- **`ctx.writeOptimistic(atom, value | mutator)`** — synchronously write a value into another atom's cache (same semantics as `store.write`). If the mutation throws, the store rolls back **all** atoms touched by `writeOptimistic` together with the primary atom's `setOptimisticValue`.
+
+A common pattern is a list atom alongside per-item atoms managed by `atomFamily`. Mutating an item should optimistically patch the list and then invalidate it after the request succeeds:
+
+```ts
+const todosListAtom = atom({
+  debugLabel: "todosList",
+  get: async () => {
+    const res = await fetch("/api/todos");
+    return res.json() as Promise<Todo[]>;
+  },
+});
+
+const todoAtom = atomFamily({
+  debugLabel: "todo",
+  get: (id: number) => async () => {
+    const res = await fetch(`/api/todos/${id}`);
+    return res.json() as Promise<Todo>;
+  },
+  set: (id: number) => async (ctx, patch: Partial<Todo>) => {
+    ctx.setOptimisticValue((prev) => ({ ...prev!, ...patch }));
+    ctx.writeOptimistic(todosListAtom, (list) =>
+      list?.map((t) => (t.id === id ? { ...t, ...patch } : t)),
+    );
+    await fetch(`/api/todos/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(patch),
+      signal: ctx.signal,
+    });
+    ctx.invalidate(todosListAtom);
+  },
+});
+```
+
+If the `PATCH` fails, both the item and the list revert to their pre-optimistic state. After success, `invalidate(todosListAtom)` triggers a background refetch to reconcile with the server.
+
+#### Standalone mutations (`mutation`)
+
+Sometimes a server action updates **several** atoms at once, and there is no single writable atom that should own the mutation. Use **`mutation(fn)`** to define that work once, then run it with **`store.mutate(m, ...args)`** or **`useMutation(m)`** in components.
+
+The callback receives a **`MutationContext`** (the same optimistic and invalidation helpers as in `set`, but **without** `setOptimisticValue`, `ctx.get`, or `ctx.signal` — pass server inputs as mutation arguments, and use `store.get` / `client.get` beforehand if you need current values):
+
+- **`ctx.writeOptimistic(atom, value | mutator)`** — same semantics as inside `set`. On throw, every atom touched by `writeOptimistic` rolls back to its state before the first optimistic write in this run.
+- **`ctx.invalidate` / `ctx.invalidateMany`** — mark atoms stale (not rolled back on error).
+
+Unlike **`set`**, a successful **`mutate` does not invalidate any atom automatically**. Call `ctx.invalidate` / `ctx.invalidateMany` when you want stale-while-revalidate after the request completes.
+
+```ts
+import { atom, mutation, createStore } from "@kdeveloper/kvark";
+
+const listAtom = atom({
+  debugLabel: "list",
+  get: async () => {
+    const res = await fetch("/api/items");
+    return res.json() as Promise<string[]>;
+  },
+});
+
+const countAtom = atom({
+  debugLabel: "count",
+  get: async () => {
+    const res = await fetch("/api/count");
+    return (await res.json()) as { n: number };
+  },
+});
+
+const addItem = mutation(async (ctx, label: string) => {
+  ctx.writeOptimistic(listAtom, (prev) => [...(prev ?? []), label]);
+  ctx.writeOptimistic(countAtom, (prev) => ({ n: (prev?.n ?? 0) + 1 }));
+  await fetch("/api/items", {
+    method: "POST",
+    body: JSON.stringify({ label }),
+  });
+  ctx.invalidateMany([listAtom, countAtom]);
+});
+
+const store = createStore();
+await store.mutate(addItem, "new row");
+```
+
+**React / Preact / Vue**
+
+```tsx
+import { useMutation } from "@kdeveloper/kvark/react"; // or "@kdeveloper/kvark/preact"
+
+const runAddItem = useMutation(addItem);
+
+await runAddItem("new row");
+```
+
+```vue
+<script setup lang="ts">
+import { useMutation } from "@kdeveloper/kvark/vue";
+
+const runAddItem = useMutation(addItem);
+</script>
+```
+
+`useMutation` returns a stable function (React/Preact: `useCallback` over `store.mutate`) with the same argument tuple as your mutation.
+
 #### Writable atoms vs `onMount`
 
 Both can update an atom's cached value, but they serve different purposes:
@@ -393,6 +511,15 @@ const setCount = useSetAtom(countAtom);
 await setCount(42);
 ```
 
+### `useMutation`
+
+Returns a function that runs a **`mutation(...)`** descriptor against the store, with the same `...args` as the mutation callback (after `ctx`). Does not subscribe to any atom.
+
+```tsx
+const runReorder = useMutation(reorderMutation);
+await runReorder(itemId, newIndex);
+```
+
 ### `useAtom`
 
 Combines `useAtomValue` and `useSetAtom` into a `[value, setter]` tuple.
@@ -414,9 +541,15 @@ const readBalance = useAtomContext(async (client) => {
 const balance = await readBalance();
 ```
 
+## Preact (`@kdeveloper/kvark/preact`)
+
+Same hook names, signatures, and behaviour as the React integration: `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useMutation`, `useAtom`, `useAtomContext`. All hooks must be used inside a `<Provider>`.
+
+Internally the entry imports only from `preact` and `preact/hooks` — there is **no dependency on `preact/compat`**, so your app does not need any React compatibility aliases.
+
 ## Vue 3 (`@kdeveloper/kvark/vue`)
 
-Same composable names and behaviour as React: `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useAtom`, `useAtomContext`. Wrap your app (or subtree) with `Provider` and pass `:store="store"`.
+Same composable names and behaviour as React: `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useMutation`, `useAtom`, `useAtomContext`. Wrap your app (or subtree) with `Provider` and pass `:store="store"`.
 
 Exported types: **`ThenableShallowRef<V>`** (default `useAtomValue`), **`ThenableObservedShallowRef<V>`** and **`ObservedValue<V>`** (with `{ observe: true }`). They encode pending vs resolved ref shapes for TypeScript.
 
@@ -546,10 +679,15 @@ client.write(counterAtom, (prev) => (prev ?? 0) + 1);
 
 ### `StoreClient` interface
 
+The concrete `Store` class exposes the same surface as `getClient()` — e.g. `store.mutate(m, ...args)` and `client.mutate(m, ...args)`.
+
 ```ts
+import type { Atom, WritableAtom, AtomState, Mutation } from "@kdeveloper/kvark";
+
 interface StoreClient {
   get<V>(atom: Atom<V>): Promise<V>;
   set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void>;
+  mutate<Args extends readonly unknown[]>(mutation: Mutation<Args>, ...args: Args): Promise<void>;
   write<V>(atom: Atom<V>, value: V): void;
   write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;
   invalidate(atom: Atom<unknown>): void;
@@ -560,7 +698,7 @@ interface StoreClient {
 
 ## Provider and Store Setup
 
-**React**
+**React / Preact**
 
 ```tsx
 // store.ts
@@ -568,7 +706,7 @@ import { createStore } from "@kdeveloper/kvark";
 export const store = createStore();
 
 // App.tsx
-import { Provider } from "@kdeveloper/kvark/react";
+import { Provider } from "@kdeveloper/kvark/react"; // or "@kdeveloper/kvark/preact"
 import { store } from "./store";
 
 export function App() {
@@ -607,16 +745,19 @@ type PostArgs = AtomArgs<typeof postAtom>; // → [postId: number]
 type Writable = IsWritable<typeof countAtom>; // → true | false
 ```
 
+`WritableAtomContext` extends `MutationContext` — the same `writeOptimistic` / `invalidate` / `invalidateMany` helpers appear on both standalone mutations and writable `set` callbacks.
+
 ## Package Structure
 
-| Import                     | Contents                                                                                                                                                     |
-| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `@kdeveloper/kvark`        | `atom`, `createStore`, all types                                                                                                                             |
-| `@kdeveloper/kvark/react`  | `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useAtom`, `useAtomContext`                                                                            |
-| `@kdeveloper/kvark/vue`    | `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useAtom`, `useAtomContext`; types `ThenableShallowRef`, `ThenableObservedShallowRef`, `ObservedValue` |
-| `@kdeveloper/kvark/family` | `atomFamily`, `stableFamilyKey`, re-exports `atom` / `createStore` and core types                                                                            |
+| Import                     | Contents                                                                                                                                                                    |
+| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@kdeveloper/kvark`        | `atom`, `mutation`, `createStore`, all types (including `Mutation`, `MutationContext`)                                                                                      |
+| `@kdeveloper/kvark/react`   | `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useMutation`, `useAtom`, `useAtomContext`                                                                            |
+| `@kdeveloper/kvark/preact`  | `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useMutation`, `useAtom`, `useAtomContext`                                                                            |
+| `@kdeveloper/kvark/vue`     | `Provider`, `useStore`, `useAtomValue`, `useSetAtom`, `useMutation`, `useAtom`, `useAtomContext`; types `ThenableShallowRef`, `ThenableObservedShallowRef`, `ObservedValue` |
+| `@kdeveloper/kvark/family` | `atomFamily`, `stableFamilyKey`, re-exports `atom`, `mutation`, `createStore`; types include `AtomFamily`, `Mutation`, `MutationContext`, and core atom types               |
 
-The core (`@kdeveloper/kvark`) has **zero runtime dependencies**. **React** and **Vue** are optional peer dependencies — install the framework you use and import from `/react` or `/vue`.
+The core (`@kdeveloper/kvark`) has **zero runtime dependencies**. **React**, **Preact**, and **Vue** are optional peer dependencies — install the framework you use and import from `/react`, `/preact`, or `/vue`.
 
 The published package is **ESM-only** (`import`); there is no CommonJS `require` entry.
 
@@ -639,6 +780,7 @@ Useful variants: `pnpm test:watch`, `pnpm lint:fix`, `pnpm fmt:check`, `pnpm lin
 - **Node.js** ≥ 20
 - **TypeScript** ≥ 6 (strict mode recommended)
 - **React** ≥ 18 (optional peer, for `@kdeveloper/kvark/react`)
+- **Preact** ≥ 10 (optional peer, for `@kdeveloper/kvark/preact`)
 - **Vue** ≥ 3.4 (optional peer, for `@kdeveloper/kvark/vue`)
 
 ## License

package/dist/{atom-BC8W-H22.d.ts → atom-DfZiw6GT.d.ts}

@@ -1,4 +1,4 @@
-import { f as WritableAtom, i as Atom, o as AtomConfig, p as WritableAtomContext } from "./store-Cng0OzIQ.js";
+import { c as AtomConfig, g as WritableAtomContext, h as WritableAtom, o as Atom } from "./store-DLoedZQo.js";
 
 //#region src/internal/atom.d.ts
 type WritableConfig<Value, Deps extends Record<string, Atom<unknown>>, Args extends readonly unknown[]> = AtomConfig<Value, Deps, Args> & {
@@ -9,4 +9,4 @@ declare function atom<Value, Deps extends Record<string, Atom<unknown>> = Record
 declare function atom<Value, Deps extends Record<string, Atom<unknown>> = Record<never, never>>(config: ReadonlyConfig<Value, Deps>): Atom<Value>;
 //#endregion
 export { atom as t };
-//# sourceMappingURL=atom-BC8W-H22.d.ts.map
+//# sourceMappingURL=atom-DfZiw6GT.d.ts.map

package/dist/{atom-BC8W-H22.d.ts.map → atom-DfZiw6GT.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"atom-BC8W-H22.d.ts","names":[],"sources":["../src/internal/atom.ts"],"mappings":";;;KASK,cAAA,qBAEU,MAAA,SAAe,IAAA,+CAE1B,UAAA,CAAW,KAAA,EAAO,IAAA,EAAM,IAAA;EAC1B,GAAA,GAAM,GAAA,EAAK,mBAAA,CAAoB,IAAA,EAAM,KAAA,MAAW,IAAA,EAAM,IAAA,KAAS,OAAA;AAAA;AAAA,KAG5D,cAAA,qBAAmC,MAAA,SAAe,IAAA,cAAkB,IAAA,CACvE,UAAA,CAAW,KAAA,EAAO,IAAA;AAAA,iBAIJ,IAAA,qBAED,MAAA,SAAe,IAAA,aAAiB,MAAA,8DAAA,CAE7C,MAAA,EAAQ,cAAA,CAAe,KAAA,EAAO,IAAA,EAAM,IAAA,IAAQ,YAAA,CAAa,KAAA,EAAO,IAAA;AAAA,iBAElD,IAAA,qBAAyB,MAAA,SAAe,IAAA,aAAiB,MAAA,eAAA,CACvE,MAAA,EAAQ,cAAA,CAAe,KAAA,EAAO,IAAA,IAC7B,IAAA,CAAK,KAAA"}
+{"version":3,"file":"atom-DfZiw6GT.d.ts","names":[],"sources":["../src/internal/atom.ts"],"mappings":";;;KASK,cAAA,qBAEU,MAAA,SAAe,IAAA,+CAE1B,UAAA,CAAW,KAAA,EAAO,IAAA,EAAM,IAAA;EAC1B,GAAA,GAAM,GAAA,EAAK,mBAAA,CAAoB,IAAA,EAAM,KAAA,MAAW,IAAA,EAAM,IAAA,KAAS,OAAA;AAAA;AAAA,KAG5D,cAAA,qBAAmC,MAAA,SAAe,IAAA,cAAkB,IAAA,CACvE,UAAA,CAAW,KAAA,EAAO,IAAA;AAAA,iBAIJ,IAAA,qBAED,MAAA,SAAe,IAAA,aAAiB,MAAA,8DAAA,CAE7C,MAAA,EAAQ,cAAA,CAAe,KAAA,EAAO,IAAA,EAAM,IAAA,IAAQ,YAAA,CAAa,KAAA,EAAO,IAAA;AAAA,iBAElD,IAAA,qBAAyB,MAAA,SAAe,IAAA,aAAiB,MAAA,eAAA,CACvE,MAAA,EAAQ,cAAA,CAAe,KAAA,EAAO,IAAA,IAC7B,IAAA,CAAK,KAAA"}

package/dist/family.d.ts

@@ -1,5 +1,5 @@
-import { c as AtomState, d as StalePolicy, f as WritableAtom, i as Atom, l as AtomValue, o as AtomConfig, r as createStore, s as AtomContext } from "./store-Cng0OzIQ.js";
-import { t as atom } from "./atom-BC8W-H22.js";
+import { a as mutation, c as AtomConfig, d as AtomValue, g as WritableAtomContext, h as WritableAtom, i as Mutation, l as AtomContext, m as StalePolicy, o as Atom, p as MutationContext, r as createStore, u as AtomState } from "./store-DLoedZQo.js";
+import { t as atom } from "./atom-DfZiw6GT.js";
 
 //#region src/internal/family.d.ts
 type AtomFamilyOptions<Param, Value, Deps extends Record<string, Atom<unknown>>, Args extends readonly unknown[], Key = Param> = {
@@ -20,7 +20,7 @@ type AtomFamilyOptions<Param, Value, Deps extends Record<string, Atom<unknown>>,
    */
   paramKey?: (param: Param) => Key;
   get: (param: Param) => (ctx: AtomContext<Deps>) => Promise<Value>;
-  set?: (param: Param) => (ctx: AtomContext<Deps>, ...args: Args) => Promise<void>;
+  set?: (param: Param) => (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;
 };
 interface AtomFamily<Param, Value, Key = Param> {
   (param: Param): Atom<Value>;
@@ -45,5 +45,5 @@ declare function atomFamily<Param, Value, Deps extends Record<string, Atom<unkno
  */
 declare function stableFamilyKey(value: unknown): string;
 //#endregion
-export { type Atom, type AtomConfig, type AtomContext, type AtomFamily, type AtomFamilyOptions, type AtomState, type AtomValue, type StalePolicy, type WritableAtom, atom, atomFamily, createStore, stableFamilyKey };
+export { type Atom, type AtomConfig, type AtomContext, type AtomFamily, type AtomFamilyOptions, type AtomState, type AtomValue, type Mutation, type MutationContext, type StalePolicy, type WritableAtom, atom, atomFamily, createStore, mutation, stableFamilyKey };
 //# sourceMappingURL=family.d.ts.map

package/dist/family.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"family.d.ts","names":[],"sources":["../src/internal/family.ts","../src/internal/stable-family-key.ts"],"mappings":";;;;KAKY,iBAAA,4BAGG,MAAA,SAAe,IAAA,mDAEtB,KAAA;EAEN,YAAA,IAAgB,KAAA,EAAO,KAAA,KAAU,IAAA;EACjC,WAAA,GAAc,WAAA;EACd,WAAA;EACA,OAAA;EACA,UAAA;EAR4B;;;;;;;;;;EAmB5B,QAAA,IAAY,KAAA,EAAO,KAAA,KAAU,GAAA;EAC7B,GAAA,GAAM,KAAA,EAAO,KAAA,MAAW,GAAA,EAAK,WAAA,CAAY,IAAA,MAAU,OAAA,CAAQ,KAAA;EAC3D,GAAA,IAAO,KAAA,EAAO,KAAA,MAAW,GAAA,EAAK,WAAA,CAAY,IAAA,MAAU,IAAA,EAAM,IAAA,KAAS,OAAA;AAAA;AAAA,UAGpD,UAAA,qBAA+B,KAAA;EAAA,CAC7C,KAAA,EAAO,KAAA,GAAQ,IAAA,CAAK,KAAA;EACrB,UAAA,CAAW,KAAA,EAAO,KAAA;EAClB,aAAA;EACA,MAAA,CAAO,KAAA,EAAO,KAAA;EACd,QAAA,IAAY,WAAA,CAAY,GAAA,EAAK,IAAA,CAAK,KAAA;AAAA;AAAA,iBAYpB,UAAA,4BAGD,MAAA,SAAe,IAAA,aAAiB,MAAA,qEAEvC,KAAA,CAAA,CACN,OAAA,EAAS,iBAAA,CAAkB,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,IAAA,EAAM,GAAA,IAAO,UAAA,CAAW,KAAA,EAAO,KAAA,EAAO,GAAA;;;;;;;AAlDvF;;;;;;;iBC0BgB,eAAA,CAAgB,KAAA"}
+{"version":3,"file":"family.d.ts","names":[],"sources":["../src/internal/family.ts","../src/internal/stable-family-key.ts"],"mappings":";;;;KAKY,iBAAA,4BAGG,MAAA,SAAe,IAAA,mDAEtB,KAAA;EAEN,YAAA,IAAgB,KAAA,EAAO,KAAA,KAAU,IAAA;EACjC,WAAA,GAAc,WAAA;EACd,WAAA;EACA,OAAA;EACA,UAAA;EAR4B;;;;;;;;;;EAmB5B,QAAA,IAAY,KAAA,EAAO,KAAA,KAAU,GAAA;EAC7B,GAAA,GAAM,KAAA,EAAO,KAAA,MAAW,GAAA,EAAK,WAAA,CAAY,IAAA,MAAU,OAAA,CAAQ,KAAA;EAC3D,GAAA,IAAO,KAAA,EAAO,KAAA,MAAW,GAAA,EAAK,mBAAA,CAAoB,IAAA,EAAM,KAAA,MAAW,IAAA,EAAM,IAAA,KAAS,OAAA;AAAA;AAAA,UAGnE,UAAA,qBAA+B,KAAA;EAAA,CAC7C,KAAA,EAAO,KAAA,GAAQ,IAAA,CAAK,KAAA;EACrB,UAAA,CAAW,KAAA,EAAO,KAAA;EAClB,aAAA;EACA,MAAA,CAAO,KAAA,EAAO,KAAA;EACd,QAAA,IAAY,WAAA,CAAY,GAAA,EAAK,IAAA,CAAK,KAAA;AAAA;AAAA,iBAYpB,UAAA,4BAGD,MAAA,SAAe,IAAA,aAAiB,MAAA,qEAEvC,KAAA,CAAA,CACN,OAAA,EAAS,iBAAA,CAAkB,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,IAAA,EAAM,GAAA,IAAO,UAAA,CAAW,KAAA,EAAO,KAAA,EAAO,GAAA;;;;;;;AAlDvF;;;;;;;iBC0BgB,eAAA,CAAgB,KAAA"}

package/dist/family.js

@@ -1,4 +1,4 @@
-import { n as atomFamily, r as atom, t as createStore } from "./store-DuKg4_ng.js";
+import { i as atom, n as mutation, r as atomFamily, t as createStore } from "./store-DvSUP7R9.js";
 //#region src/internal/stable-family-key.ts
 /**
 * Produces a deterministic string key for plain-object/array/primitive values.
@@ -54,6 +54,6 @@ function serializeValue(value) {
 	}).join(",")}}`;
 }
 //#endregion
-export { atom, atomFamily, createStore, stableFamilyKey };
+export { atom, atomFamily, createStore, mutation, stableFamilyKey };
 
 //# sourceMappingURL=family.js.map

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-import { a as AtomArgs, c as AtomState, d as StalePolicy, f as WritableAtom, i as Atom, l as AtomValue, n as StoreClient, o as AtomConfig, p as WritableAtomContext, r as createStore, s as AtomContext, u as IsWritable } from "./store-Cng0OzIQ.js";
-import { t as atom } from "./atom-BC8W-H22.js";
-export { type Atom, type AtomArgs, type AtomConfig, type AtomContext, type AtomState, type AtomValue, type IsWritable, type StalePolicy, type StoreClient, type WritableAtom, type WritableAtomContext, atom, createStore };
+import { a as mutation, c as AtomConfig, d as AtomValue, f as IsWritable, g as WritableAtomContext, h as WritableAtom, i as Mutation, l as AtomContext, m as StalePolicy, n as StoreClient, o as Atom, p as MutationContext, r as createStore, s as AtomArgs, u as AtomState } from "./store-DLoedZQo.js";
+import { t as atom } from "./atom-DfZiw6GT.js";
+export { type Atom, type AtomArgs, type AtomConfig, type AtomContext, type AtomState, type AtomValue, type IsWritable, type Mutation, type MutationContext, type StalePolicy, type StoreClient, type WritableAtom, type WritableAtomContext, atom, createStore, mutation };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { r as atom, t as createStore } from "./store-DuKg4_ng.js";
-export { atom, createStore };
+import { i as atom, n as mutation, t as createStore } from "./store-DvSUP7R9.js";
+export { atom, createStore, mutation };

package/dist/preact/index.d.ts

@@ -0,0 +1,42 @@
+import { h as WritableAtom, i as Mutation, n as StoreClient, o as Atom, t as Store } from "../store-DLoedZQo.js";
+import { ComponentChildren, VNode } from "preact";
+
+//#region src/preact/provider.d.ts
+type ProviderProps = {
+  store: Store;
+  children: ComponentChildren;
+};
+declare function Provider({
+  store,
+  children
+}: ProviderProps): VNode;
+declare function useStore(): Store;
+//#endregion
+//#region src/preact/use-atom-value.d.ts
+type ObservedValue<V> = {
+  value: V;
+  isStale: boolean;
+  error: unknown;
+};
+declare function useAtomValue<V>(atom: Atom<V>): V;
+declare function useAtomValue<V>(atom: Atom<V>, opts: {
+  observe: true;
+}): ObservedValue<V>;
+//#endregion
+//#region src/preact/use-set-atom.d.ts
+declare function useSetAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): (...args: A) => Promise<void>;
+//#endregion
+//#region src/preact/use-mutation.d.ts
+declare function useMutation<Args extends readonly unknown[]>(mutation: Mutation<Args>): (...args: Args) => Promise<void>;
+//#endregion
+//#region src/preact/use-atom.d.ts
+declare function useAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): readonly [V, (...args: A) => Promise<void>];
+//#endregion
+//#region src/preact/use-atom-context.d.ts
+declare function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R>;
+//#endregion
+//#region src/preact/use-stable-fn.d.ts
+declare function useStableFn<Args extends unknown[], R>(fn: (...args: Args) => R): (...args: Args) => R;
+//#endregion
+export { Provider, useAtom, useAtomContext, useAtomValue, useMutation, useSetAtom, useStableFn, useStore };
+//# sourceMappingURL=index.d.ts.map

package/dist/preact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/preact/provider.tsx","../../src/preact/use-atom-value.ts","../../src/preact/use-set-atom.ts","../../src/preact/use-mutation.ts","../../src/preact/use-atom.ts","../../src/preact/use-atom-context.ts","../../src/preact/use-stable-fn.ts"],"mappings":";;;;KAOY,aAAA;EACV,KAAA,EAAO,KAAA;EACP,QAAA,EAAU,iBAAA;AAAA;AAAA,iBAGI,QAAA,CAAA;EAAW,KAAA;EAAO;AAAA,GAAY,aAAA,GAAgB,KAAA;AAAA,iBAI9C,QAAA,CAAA,GAAY,KAAA;;;KCVvB,aAAA;EACH,KAAA,EAAO,CAAA;EACP,OAAA;EACA,KAAA;AAAA;AAAA,iBAGc,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,CAAA;AAAA,iBAChC,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,IAAA;EAAQ,OAAA;AAAA,IAAkB,aAAA,CAAc,CAAA;;;iBCTvE,UAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,QACjB,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFH,WAAA,iCAAA,CACd,QAAA,EAAU,QAAA,CAAS,IAAA,QACd,IAAA,EAAM,IAAA,KAAS,OAAA;;;iBCFN,OAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,cACX,CAAA,MAAO,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFhB,cAAA,GAAA,CAAkB,QAAA,GAAW,GAAA,EAAK,WAAA,KAAgB,OAAA,CAAQ,CAAA,UAAW,OAAA,CAAQ,CAAA;;;iBCF7E,WAAA,2BAAA,CACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,CAAA,OAClB,IAAA,EAAM,IAAA,KAAS,CAAA"}

package/dist/preact/index.js

@@ -0,0 +1,116 @@
+import { t as CONFIG } from "../types-B2mzc3A5.js";
+import { createContext } from "preact";
+import { useCallback, useContext, useEffect, useLayoutEffect, useRef, useState } from "preact/hooks";
+import { jsx } from "preact/jsx-runtime";
+//#region src/preact/provider.tsx
+/** @jsxImportSource preact */
+const StoreContext = createContext(null);
+function Provider({ store, children }) {
+	return /* @__PURE__ */ jsx(StoreContext.Provider, {
+		value: store,
+		children
+	});
+}
+function useStore() {
+	const store = useContext(StoreContext);
+	if (store == null) throw new Error("useStore must be used within a <Provider>");
+	return store;
+}
+//#endregion
+//#region src/preact/use-sync-external-store.ts
+function didSnapshotChange(inst) {
+	try {
+		return !Object.is(inst._value, inst._getSnapshot());
+	} catch {
+		return true;
+	}
+}
+function useSyncExternalStore(subscribe, getSnapshot) {
+	const value = getSnapshot();
+	const [{ _instance }, forceUpdate] = useState(() => ({ _instance: {
+		_value: value,
+		_getSnapshot: getSnapshot
+	} }));
+	useLayoutEffect(() => {
+		_instance._value = value;
+		_instance._getSnapshot = getSnapshot;
+		if (didSnapshotChange(_instance)) forceUpdate({ _instance });
+	}, [
+		subscribe,
+		value,
+		getSnapshot
+	]);
+	useEffect(() => {
+		if (didSnapshotChange(_instance)) forceUpdate({ _instance });
+		return subscribe(() => {
+			if (didSnapshotChange(_instance)) forceUpdate({ _instance });
+		});
+	}, [subscribe]);
+	return value;
+}
+//#endregion
+//#region src/preact/use-stable-fn.ts
+function useStableFn(fn) {
+	const ref = useRef(fn);
+	ref.current = fn;
+	return useCallback((...args) => ref.current(...args), []);
+}
+//#endregion
+//#region src/preact/use-atom-value.ts
+function useAtomValue(atom, opts) {
+	const store = useStore();
+	const snapshot = useSyncExternalStore(useStableFn((notify) => store.subscribe(atom, notify)), useStableFn(() => store.getSnapshot(atom)));
+	const stalePolicy = atom[CONFIG].stalePolicy ?? "keep";
+	if (snapshot.status === "pending") throw store.resolve(atom);
+	if (snapshot.status === "stale") {
+		if (stalePolicy === "suspend") throw store.resolve(atom);
+		store.resolve(atom);
+		if (opts?.observe === true) return {
+			value: snapshot.value,
+			isStale: true,
+			error: void 0
+		};
+		return snapshot.value;
+	}
+	if (snapshot.status === "error") {
+		if (opts?.observe === true && snapshot.value !== void 0) return {
+			value: snapshot.value,
+			isStale: false,
+			error: snapshot.error
+		};
+		throw snapshot.error;
+	}
+	if (opts?.observe === true) return {
+		value: snapshot.value,
+		isStale: false,
+		error: void 0
+	};
+	return snapshot.value;
+}
+//#endregion
+//#region src/preact/use-set-atom.ts
+function useSetAtom(atom) {
+	const store = useStore();
+	return useCallback((...args) => store.set(atom, ...args), [store, atom]);
+}
+//#endregion
+//#region src/preact/use-mutation.ts
+function useMutation(mutation) {
+	const store = useStore();
+	return useCallback((...args) => store.mutate(mutation, ...args), [store, mutation]);
+}
+//#endregion
+//#region src/preact/use-atom.ts
+function useAtom(atom) {
+	return [useAtomValue(atom), useSetAtom(atom)];
+}
+//#endregion
+//#region src/preact/use-atom-context.ts
+function useAtomContext(callback) {
+	const store = useStore();
+	return useCallback(() => callback(store.getClient()), [store, callback]);
+}
+//#endregion
+export { Provider, useAtom, useAtomContext, useAtomValue, useMutation, useSetAtom, useStableFn, useStore };
+
+//# sourceMappingURL=index.js.map

package/dist/preact/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/preact/provider.tsx","../../src/preact/use-sync-external-store.ts","../../src/preact/use-stable-fn.ts","../../src/preact/use-atom-value.ts","../../src/preact/use-set-atom.ts","../../src/preact/use-mutation.ts","../../src/preact/use-atom.ts","../../src/preact/use-atom-context.ts"],"sourcesContent":["/** @jsxImportSource preact */\nimport { createContext, type ComponentChildren, type VNode } from \"preact\";\nimport { useContext } from \"preact/hooks\";\nimport type { Store } from \"@/internal/store.js\";\n\nconst StoreContext = createContext<Store | null>(null);\n\nexport type ProviderProps = {\n  store: Store;\n  children: ComponentChildren;\n};\n\nexport function Provider({ store, children }: ProviderProps): VNode {\n  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>;\n}\n\nexport function useStore(): Store {\n  const store = useContext(StoreContext);\n  if (store == null) {\n    throw new Error(\"useStore must be used within a <Provider>\");\n  }\n  return store;\n}\n","import { useState, useLayoutEffect, useEffect } from \"preact/hooks\";\n\n// Typed shim for useSyncExternalStore using only preact/hooks,\n// based on React's client shim that Preact ships in preact/compat.\n\ntype StoreInstance<T> = { _value: T; _getSnapshot: () => T };\n\nfunction didSnapshotChange<T>(inst: StoreInstance<T>): boolean {\n  try {\n    return !Object.is(inst._value, inst._getSnapshot());\n  } catch {\n    return true;\n  }\n}\n\nexport function useSyncExternalStore<T>(\n  subscribe: (onStoreChange: () => void) => () => void,\n  getSnapshot: () => T,\n): T {\n  const value = getSnapshot();\n\n  const [{ _instance }, forceUpdate] = useState(() => ({\n    _instance: { _value: value, _getSnapshot: getSnapshot } as StoreInstance<T>,\n  }));\n\n  useLayoutEffect(() => {\n    _instance._value = value;\n    _instance._getSnapshot = getSnapshot;\n\n    if (didSnapshotChange(_instance)) {\n      forceUpdate({ _instance });\n    }\n  }, [subscribe, value, getSnapshot]);\n\n  useEffect(() => {\n    if (didSnapshotChange(_instance)) {\n      forceUpdate({ _instance });\n    }\n\n    return subscribe(() => {\n      if (didSnapshotChange(_instance)) {\n        forceUpdate({ _instance });\n      }\n    });\n  }, [subscribe]);\n\n  return value;\n}\n","import { useCallback, useRef } from \"preact/hooks\";\n\nexport function useStableFn<Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n): (...args: Args) => R {\n  const ref = useRef(fn);\n  ref.current = fn;\n\n  return useCallback((...args: Args) => ref.current(...args), []);\n}\n","import { useSyncExternalStore } from \"@/preact/use-sync-external-store.js\";\nimport type { Atom, AtomState, StalePolicy } from \"@/internal/types.js\";\nimport { CONFIG } from \"@/internal/types.js\";\nimport { useStore } from \"@/preact/provider.js\";\nimport { useStableFn } from \"@/preact/use-stable-fn.js\";\n\ntype ObservedValue<V> = {\n  value: V;\n  isStale: boolean;\n  error: unknown;\n};\n\nexport function useAtomValue<V>(atom: Atom<V>): V;\nexport function useAtomValue<V>(atom: Atom<V>, opts: { observe: true }): ObservedValue<V>;\nexport function useAtomValue<V>(atom: Atom<V>, opts?: { observe: true }): V | ObservedValue<V> {\n  const store = useStore();\n\n  const subscribe = useStableFn((notify: () => void) => store.subscribe(atom, notify));\n  const getSnapshot = useStableFn(() => store.getSnapshot(atom));\n\n  const snapshot: AtomState<V> = useSyncExternalStore(subscribe, getSnapshot);\n\n  const stalePolicy: StalePolicy = atom[CONFIG].stalePolicy ?? \"keep\";\n\n  if (snapshot.status === \"pending\") {\n    throw store.resolve(atom);\n  }\n\n  if (snapshot.status === \"stale\") {\n    if (stalePolicy === \"suspend\") {\n      throw store.resolve(atom);\n    }\n    // \"keep\" or \"reset\" while stale: trigger background revalidation\n    void store.resolve(atom);\n\n    if (opts?.observe === true) {\n      return { value: snapshot.value, isStale: true, error: undefined };\n    }\n    return snapshot.value;\n  }\n\n  if (snapshot.status === \"error\") {\n    if (opts?.observe === true && snapshot.value !== undefined) {\n      return {\n        value: snapshot.value as V,\n        isStale: false,\n        error: snapshot.error,\n      };\n    }\n    throw snapshot.error;\n  }\n\n  // status === \"fresh\"\n  if (opts?.observe === true) {\n    return { value: snapshot.value, isStale: false, error: undefined };\n  }\n  return snapshot.value;\n}\n","import { useCallback } from \"preact/hooks\";\nimport type { WritableAtom } from \"@/internal/types.js\";\nimport { useStore } from \"@/preact/provider.js\";\n\nexport function useSetAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): (...args: A) => Promise<void> {\n  const store = useStore();\n  return useCallback((...args: A): Promise<void> => store.set(atom, ...args), [store, atom]);\n}\n","import { useCallback } from \"preact/hooks\";\nimport type { Mutation } from \"@/internal/mutation.js\";\nimport { useStore } from \"@/preact/provider.js\";\n\nexport function useMutation<Args extends readonly unknown[]>(\n  mutation: Mutation<Args>,\n): (...args: Args) => Promise<void> {\n  const store = useStore();\n  return useCallback(\n    (...args: Args): Promise<void> => store.mutate(mutation, ...args),\n    [store, mutation],\n  );\n}\n","import type { WritableAtom } from \"@/internal/types.js\";\nimport { useAtomValue } from \"@/preact/use-atom-value.js\";\nimport { useSetAtom } from \"@/preact/use-set-atom.js\";\n\nexport function useAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): readonly [V, (...args: A) => Promise<void>] {\n  const value = useAtomValue(atom);\n  const setter = useSetAtom(atom);\n  return [value, setter] as const;\n}\n","import { useCallback } from \"preact/hooks\";\nimport type { StoreClient } from \"@/internal/store.js\";\nimport { useStore } from \"@/preact/provider.js\";\n\nexport function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R> {\n  const store = useStore();\n  return useCallback((): Promise<R> => callback(store.getClient()), [store, callback]);\n}\n"],"mappings":";;;;;;AAKA,MAAM,eAAe,cAA4B,KAAK;AAOtD,SAAgB,SAAS,EAAE,OAAO,YAAkC;AAClE,QAAO,oBAAC,aAAa,UAAd;EAAuB,OAAO;EAAQ;EAAiC,CAAA;;AAGhF,SAAgB,WAAkB;CAChC,MAAM,QAAQ,WAAW,aAAa;AACtC,KAAI,SAAS,KACX,OAAM,IAAI,MAAM,4CAA4C;AAE9D,QAAO;;;;ACdT,SAAS,kBAAqB,MAAiC;AAC7D,KAAI;AACF,SAAO,CAAC,OAAO,GAAG,KAAK,QAAQ,KAAK,cAAc,CAAC;SAC7C;AACN,SAAO;;;AAIX,SAAgB,qBACd,WACA,aACG;CACH,MAAM,QAAQ,aAAa;CAE3B,MAAM,CAAC,EAAE,aAAa,eAAe,gBAAgB,EACnD,WAAW;EAAE,QAAQ;EAAO,cAAc;EAAa,EACxD,EAAE;AAEH,uBAAsB;AACpB,YAAU,SAAS;AACnB,YAAU,eAAe;AAEzB,MAAI,kBAAkB,UAAU,CAC9B,aAAY,EAAE,WAAW,CAAC;IAE3B;EAAC;EAAW;EAAO;EAAY,CAAC;AAEnC,iBAAgB;AACd,MAAI,kBAAkB,UAAU,CAC9B,aAAY,EAAE,WAAW,CAAC;AAG5B,SAAO,gBAAgB;AACrB,OAAI,kBAAkB,UAAU,CAC9B,aAAY,EAAE,WAAW,CAAC;IAE5B;IACD,CAAC,UAAU,CAAC;AAEf,QAAO;;;;AC5CT,SAAgB,YACd,IACsB;CACtB,MAAM,MAAM,OAAO,GAAG;AACtB,KAAI,UAAU;AAEd,QAAO,aAAa,GAAG,SAAe,IAAI,QAAQ,GAAG,KAAK,EAAE,EAAE,CAAC;;;;ACMjE,SAAgB,aAAgB,MAAe,MAAgD;CAC7F,MAAM,QAAQ,UAAU;CAKxB,MAAM,WAAyB,qBAHb,aAAa,WAAuB,MAAM,UAAU,MAAM,OAAO,CAAC,EAChE,kBAAkB,MAAM,YAAY,KAAK,CAAC,CAEa;CAE3E,MAAM,cAA2B,KAAK,QAAQ,eAAe;AAE7D,KAAI,SAAS,WAAW,UACtB,OAAM,MAAM,QAAQ,KAAK;AAG3B,KAAI,SAAS,WAAW,SAAS;AAC/B,MAAI,gBAAgB,UAClB,OAAM,MAAM,QAAQ,KAAK;AAGtB,QAAM,QAAQ,KAAK;AAExB,MAAI,MAAM,YAAY,KACpB,QAAO;GAAE,OAAO,SAAS;GAAO,SAAS;GAAM,OAAO,KAAA;GAAW;AAEnE,SAAO,SAAS;;AAGlB,KAAI,SAAS,WAAW,SAAS;AAC/B,MAAI,MAAM,YAAY,QAAQ,SAAS,UAAU,KAAA,EAC/C,QAAO;GACL,OAAO,SAAS;GAChB,SAAS;GACT,OAAO,SAAS;GACjB;AAEH,QAAM,SAAS;;AAIjB,KAAI,MAAM,YAAY,KACpB,QAAO;EAAE,OAAO,SAAS;EAAO,SAAS;EAAO,OAAO,KAAA;EAAW;AAEpE,QAAO,SAAS;;;;ACpDlB,SAAgB,WACd,MAC+B;CAC/B,MAAM,QAAQ,UAAU;AACxB,QAAO,aAAa,GAAG,SAA2B,MAAM,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC,OAAO,KAAK,CAAC;;;;ACJ5F,SAAgB,YACd,UACkC;CAClC,MAAM,QAAQ,UAAU;AACxB,QAAO,aACJ,GAAG,SAA8B,MAAM,OAAO,UAAU,GAAG,KAAK,EACjE,CAAC,OAAO,SAAS,CAClB;;;;ACPH,SAAgB,QACd,MAC6C;AAG7C,QAAO,CAFO,aAAa,KAAK,EACjB,WAAW,KAAK,CACT;;;;ACLxB,SAAgB,eAAkB,UAA8D;CAC9F,MAAM,QAAQ,UAAU;AACxB,QAAO,kBAA8B,SAAS,MAAM,WAAW,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC"}

package/dist/react/index.d.ts

@@ -1,4 +1,4 @@
-import { f as WritableAtom, i as Atom, n as StoreClient, t as Store } from "../store-Cng0OzIQ.js";
+import { h as WritableAtom, i as Mutation, n as StoreClient, o as Atom, t as Store } from "../store-DLoedZQo.js";
 import { ReactNode } from "react";
 
 //#region src/react/provider.d.ts
@@ -26,6 +26,9 @@ declare function useAtomValue<V>(atom: Atom<V>, opts: {
 //#region src/react/use-set-atom.d.ts
 declare function useSetAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): (...args: A) => Promise<void>;
 //#endregion
+//#region src/react/use-mutation.d.ts
+declare function useMutation<Args extends readonly unknown[]>(mutation: Mutation<Args>): (...args: Args) => Promise<void>;
+//#endregion
 //#region src/react/use-atom.d.ts
 declare function useAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): readonly [V, (...args: A) => Promise<void>];
 //#endregion
@@ -35,5 +38,5 @@ declare function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>):
 //#region src/react/use-stable-fn.d.ts
 declare function useStableFn<Args extends unknown[], R>(fn: (...args: Args) => R): (...args: Args) => R;
 //#endregion
-export { Provider, useAtom, useAtomContext, useAtomValue, useSetAtom, useStableFn, useStore };
+export { Provider, useAtom, useAtomContext, useAtomValue, useMutation, useSetAtom, useStableFn, useStore };
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/react/provider.tsx","../../src/react/use-atom-value.ts","../../src/react/use-set-atom.ts","../../src/react/use-atom.ts","../../src/react/use-atom-context.ts","../../src/react/use-stable-fn.ts"],"mappings":";;;;KAKY,aAAA;EACV,KAAA,EAAO,KAAA;EACP,QAAA,EAAU,SAAA;AAAA;AAAA,iBAGI,QAAA,CAAA;EAAW,KAAA;EAAO;AAAA,GAAY,aAAA,GAAgB,SAAA;AAAA,iBAI9C,QAAA,CAAA,GAAY,KAAA;;;KCRvB,aAAA;EACH,KAAA,EAAO,CAAA;EACP,OAAA;EACA,KAAA;AAAA;AAAA,iBAGc,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,CAAA;AAAA,iBAChC,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,IAAA;EAAQ,OAAA;AAAA,IAAkB,aAAA,CAAc,CAAA;;;iBCTvE,UAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,QACjB,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFH,OAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,cACX,CAAA,MAAO,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFhB,cAAA,GAAA,CAAkB,QAAA,GAAW,GAAA,EAAK,WAAA,KAAgB,OAAA,CAAQ,CAAA,UAAW,OAAA,CAAQ,CAAA;;;iBCF7E,WAAA,2BAAA,CACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,CAAA,OAClB,IAAA,EAAM,IAAA,KAAS,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/react/provider.tsx","../../src/react/use-atom-value.ts","../../src/react/use-set-atom.ts","../../src/react/use-mutation.ts","../../src/react/use-atom.ts","../../src/react/use-atom-context.ts","../../src/react/use-stable-fn.ts"],"mappings":";;;;KAKY,aAAA;EACV,KAAA,EAAO,KAAA;EACP,QAAA,EAAU,SAAA;AAAA;AAAA,iBAGI,QAAA,CAAA;EAAW,KAAA;EAAO;AAAA,GAAY,aAAA,GAAgB,SAAA;AAAA,iBAI9C,QAAA,CAAA,GAAY,KAAA;;;KCRvB,aAAA;EACH,KAAA,EAAO,CAAA;EACP,OAAA;EACA,KAAA;AAAA;AAAA,iBAGc,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,CAAA;AAAA,iBAChC,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,IAAA;EAAQ,OAAA;AAAA,IAAkB,aAAA,CAAc,CAAA;;;iBCTvE,UAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,QACjB,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFH,WAAA,iCAAA,CACd,QAAA,EAAU,QAAA,CAAS,IAAA,QACd,IAAA,EAAM,IAAA,KAAS,OAAA;;;iBCFN,OAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,cACX,CAAA,MAAO,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFhB,cAAA,GAAA,CAAkB,QAAA,GAAW,GAAA,EAAK,WAAA,KAAgB,OAAA,CAAQ,CAAA,UAAW,OAAA,CAAQ,CAAA;;;iBCF7E,WAAA,2BAAA,CACd,EAAA,MAAQ,IAAA,EAAM,IAAA,KAAS,CAAA,OAClB,IAAA,EAAM,IAAA,KAAS,CAAA"}

package/dist/react/index.js

@@ -60,6 +60,12 @@ function useSetAtom(atom) {
 	return useCallback((...args) => store.set(atom, ...args), [store, atom]);
 }
 //#endregion
+//#region src/react/use-mutation.ts
+function useMutation(mutation) {
+	const store = useStore();
+	return useCallback((...args) => store.mutate(mutation, ...args), [store, mutation]);
+}
+//#endregion
 //#region src/react/use-atom.ts
 function useAtom(atom) {
 	return [useAtomValue(atom), useSetAtom(atom)];
@@ -71,6 +77,6 @@ function useAtomContext(callback) {
 	return useCallback(() => callback(store.getClient()), [store, callback]);
 }
 //#endregion
-export { Provider, useAtom, useAtomContext, useAtomValue, useSetAtom, useStableFn, useStore };
+export { Provider, useAtom, useAtomContext, useAtomValue, useMutation, useSetAtom, useStableFn, useStore };
 
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/react/provider.tsx","../../src/react/use-stable-fn.ts","../../src/react/use-atom-value.ts","../../src/react/use-set-atom.ts","../../src/react/use-atom.ts","../../src/react/use-atom-context.ts"],"sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport type { Store } from \"@/internal/store.js\";\n\nconst StoreContext = createContext<Store | null>(null);\n\nexport type ProviderProps = {\n  store: Store;\n  children: ReactNode;\n};\n\nexport function Provider({ store, children }: ProviderProps): ReactNode {\n  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>;\n}\n\nexport function useStore(): Store {\n  const store = useContext(StoreContext);\n  if (store == null) {\n    throw new Error(\"useStore must be used within a <Provider>\");\n  }\n  return store;\n}\n","import { useCallback, useRef } from \"react\";\n\nexport function useStableFn<Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n): (...args: Args) => R {\n  const ref = useRef(fn);\n  ref.current = fn;\n\n  return useCallback((...args: Args) => ref.current(...args), []);\n}\n","import { useSyncExternalStore } from \"react\";\nimport type { Atom, AtomState, StalePolicy } from \"@/internal/types.js\";\nimport { CONFIG } from \"@/internal/types.js\";\nimport { useStore } from \"@/react/provider.js\";\nimport { useStableFn } from \"@/react/use-stable-fn.js\";\n\ntype ObservedValue<V> = {\n  value: V;\n  isStale: boolean;\n  error: unknown;\n};\n\nexport function useAtomValue<V>(atom: Atom<V>): V;\nexport function useAtomValue<V>(atom: Atom<V>, opts: { observe: true }): ObservedValue<V>;\nexport function useAtomValue<V>(atom: Atom<V>, opts?: { observe: true }): V | ObservedValue<V> {\n  const store = useStore();\n\n  const subscribe = useStableFn((notify: () => void) => store.subscribe(atom, notify));\n  const getSnapshot = useStableFn(() => store.getSnapshot(atom));\n  const getServerSnapshot = useStableFn(() => store.getServerSnapshot(atom));\n\n  const snapshot: AtomState<V> = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n\n  const stalePolicy: StalePolicy = atom[CONFIG].stalePolicy ?? \"keep\";\n\n  if (snapshot.status === \"pending\") {\n    throw store.resolve(atom);\n  }\n\n  if (snapshot.status === \"stale\") {\n    if (stalePolicy === \"suspend\") {\n      throw store.resolve(atom);\n    }\n    // \"keep\" or \"reset\" while stale: trigger background revalidation\n    void store.resolve(atom);\n\n    if (opts?.observe === true) {\n      return { value: snapshot.value, isStale: true, error: undefined };\n    }\n    return snapshot.value;\n  }\n\n  if (snapshot.status === \"error\") {\n    if (opts?.observe === true && snapshot.value !== undefined) {\n      return {\n        value: snapshot.value as V,\n        isStale: false,\n        error: snapshot.error,\n      };\n    }\n    throw snapshot.error;\n  }\n\n  // status === \"fresh\"\n  if (opts?.observe === true) {\n    return { value: snapshot.value, isStale: false, error: undefined };\n  }\n  return snapshot.value;\n}\n","import { useCallback } from \"react\";\nimport type { WritableAtom } from \"@/internal/types.js\";\nimport { useStore } from \"@/react/provider.js\";\n\nexport function useSetAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): (...args: A) => Promise<void> {\n  const store = useStore();\n  return useCallback((...args: A): Promise<void> => store.set(atom, ...args), [store, atom]);\n}\n","import type { WritableAtom } from \"@/internal/types.js\";\nimport { useAtomValue } from \"@/react/use-atom-value.js\";\nimport { useSetAtom } from \"@/react/use-set-atom.js\";\n\nexport function useAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): readonly [V, (...args: A) => Promise<void>] {\n  const value = useAtomValue(atom);\n  const setter = useSetAtom(atom);\n  return [value, setter] as const;\n}\n","import { useCallback } from \"react\";\nimport type { StoreClient } from \"@/internal/store.js\";\nimport { useStore } from \"@/react/provider.js\";\n\nexport function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R> {\n  const store = useStore();\n  return useCallback((): Promise<R> => callback(store.getClient()), [store, callback]);\n}\n"],"mappings":";;;;AAGA,MAAM,eAAe,cAA4B,KAAK;AAOtD,SAAgB,SAAS,EAAE,OAAO,YAAsC;AACtE,QAAO,oBAAC,aAAa,UAAd;EAAuB,OAAO;EAAQ;EAAiC,CAAA;;AAGhF,SAAgB,WAAkB;CAChC,MAAM,QAAQ,WAAW,aAAa;AACtC,KAAI,SAAS,KACX,OAAM,IAAI,MAAM,4CAA4C;AAE9D,QAAO;;;;ACjBT,SAAgB,YACd,IACsB;CACtB,MAAM,MAAM,OAAO,GAAG;AACtB,KAAI,UAAU;AAEd,QAAO,aAAa,GAAG,SAAe,IAAI,QAAQ,GAAG,KAAK,EAAE,EAAE,CAAC;;;;ACMjE,SAAgB,aAAgB,MAAe,MAAgD;CAC7F,MAAM,QAAQ,UAAU;CAMxB,MAAM,WAAyB,qBAJb,aAAa,WAAuB,MAAM,UAAU,MAAM,OAAO,CAAC,EAChE,kBAAkB,MAAM,YAAY,KAAK,CAAC,EACpC,kBAAkB,MAAM,kBAAkB,KAAK,CAAC,CAEoB;CAE9F,MAAM,cAA2B,KAAK,QAAQ,eAAe;AAE7D,KAAI,SAAS,WAAW,UACtB,OAAM,MAAM,QAAQ,KAAK;AAG3B,KAAI,SAAS,WAAW,SAAS;AAC/B,MAAI,gBAAgB,UAClB,OAAM,MAAM,QAAQ,KAAK;AAGtB,QAAM,QAAQ,KAAK;AAExB,MAAI,MAAM,YAAY,KACpB,QAAO;GAAE,OAAO,SAAS;GAAO,SAAS;GAAM,OAAO,KAAA;GAAW;AAEnE,SAAO,SAAS;;AAGlB,KAAI,SAAS,WAAW,SAAS;AAC/B,MAAI,MAAM,YAAY,QAAQ,SAAS,UAAU,KAAA,EAC/C,QAAO;GACL,OAAO,SAAS;GAChB,SAAS;GACT,OAAO,SAAS;GACjB;AAEH,QAAM,SAAS;;AAIjB,KAAI,MAAM,YAAY,KACpB,QAAO;EAAE,OAAO,SAAS;EAAO,SAAS;EAAO,OAAO,KAAA;EAAW;AAEpE,QAAO,SAAS;;;;ACrDlB,SAAgB,WACd,MAC+B;CAC/B,MAAM,QAAQ,UAAU;AACxB,QAAO,aAAa,GAAG,SAA2B,MAAM,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC,OAAO,KAAK,CAAC;;;;ACJ5F,SAAgB,QACd,MAC6C;AAG7C,QAAO,CAFO,aAAa,KAAK,EACjB,WAAW,KAAK,CACT;;;;ACLxB,SAAgB,eAAkB,UAA8D;CAC9F,MAAM,QAAQ,UAAU;AACxB,QAAO,kBAA8B,SAAS,MAAM,WAAW,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/react/provider.tsx","../../src/react/use-stable-fn.ts","../../src/react/use-atom-value.ts","../../src/react/use-set-atom.ts","../../src/react/use-mutation.ts","../../src/react/use-atom.ts","../../src/react/use-atom-context.ts"],"sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport type { Store } from \"@/internal/store.js\";\n\nconst StoreContext = createContext<Store | null>(null);\n\nexport type ProviderProps = {\n  store: Store;\n  children: ReactNode;\n};\n\nexport function Provider({ store, children }: ProviderProps): ReactNode {\n  return <StoreContext.Provider value={store}>{children}</StoreContext.Provider>;\n}\n\nexport function useStore(): Store {\n  const store = useContext(StoreContext);\n  if (store == null) {\n    throw new Error(\"useStore must be used within a <Provider>\");\n  }\n  return store;\n}\n","import { useCallback, useRef } from \"react\";\n\nexport function useStableFn<Args extends unknown[], R>(\n  fn: (...args: Args) => R,\n): (...args: Args) => R {\n  const ref = useRef(fn);\n  ref.current = fn;\n\n  return useCallback((...args: Args) => ref.current(...args), []);\n}\n","import { useSyncExternalStore } from \"react\";\nimport type { Atom, AtomState, StalePolicy } from \"@/internal/types.js\";\nimport { CONFIG } from \"@/internal/types.js\";\nimport { useStore } from \"@/react/provider.js\";\nimport { useStableFn } from \"@/react/use-stable-fn.js\";\n\ntype ObservedValue<V> = {\n  value: V;\n  isStale: boolean;\n  error: unknown;\n};\n\nexport function useAtomValue<V>(atom: Atom<V>): V;\nexport function useAtomValue<V>(atom: Atom<V>, opts: { observe: true }): ObservedValue<V>;\nexport function useAtomValue<V>(atom: Atom<V>, opts?: { observe: true }): V | ObservedValue<V> {\n  const store = useStore();\n\n  const subscribe = useStableFn((notify: () => void) => store.subscribe(atom, notify));\n  const getSnapshot = useStableFn(() => store.getSnapshot(atom));\n  const getServerSnapshot = useStableFn(() => store.getServerSnapshot(atom));\n\n  const snapshot: AtomState<V> = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n\n  const stalePolicy: StalePolicy = atom[CONFIG].stalePolicy ?? \"keep\";\n\n  if (snapshot.status === \"pending\") {\n    throw store.resolve(atom);\n  }\n\n  if (snapshot.status === \"stale\") {\n    if (stalePolicy === \"suspend\") {\n      throw store.resolve(atom);\n    }\n    // \"keep\" or \"reset\" while stale: trigger background revalidation\n    void store.resolve(atom);\n\n    if (opts?.observe === true) {\n      return { value: snapshot.value, isStale: true, error: undefined };\n    }\n    return snapshot.value;\n  }\n\n  if (snapshot.status === \"error\") {\n    if (opts?.observe === true && snapshot.value !== undefined) {\n      return {\n        value: snapshot.value as V,\n        isStale: false,\n        error: snapshot.error,\n      };\n    }\n    throw snapshot.error;\n  }\n\n  // status === \"fresh\"\n  if (opts?.observe === true) {\n    return { value: snapshot.value, isStale: false, error: undefined };\n  }\n  return snapshot.value;\n}\n","import { useCallback } from \"react\";\nimport type { WritableAtom } from \"@/internal/types.js\";\nimport { useStore } from \"@/react/provider.js\";\n\nexport function useSetAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): (...args: A) => Promise<void> {\n  const store = useStore();\n  return useCallback((...args: A): Promise<void> => store.set(atom, ...args), [store, atom]);\n}\n","import { useCallback } from \"react\";\nimport type { Mutation } from \"@/internal/mutation.js\";\nimport { useStore } from \"@/react/provider.js\";\n\nexport function useMutation<Args extends readonly unknown[]>(\n  mutation: Mutation<Args>,\n): (...args: Args) => Promise<void> {\n  const store = useStore();\n  return useCallback(\n    (...args: Args): Promise<void> => store.mutate(mutation, ...args),\n    [store, mutation],\n  );\n}\n","import type { WritableAtom } from \"@/internal/types.js\";\nimport { useAtomValue } from \"@/react/use-atom-value.js\";\nimport { useSetAtom } from \"@/react/use-set-atom.js\";\n\nexport function useAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): readonly [V, (...args: A) => Promise<void>] {\n  const value = useAtomValue(atom);\n  const setter = useSetAtom(atom);\n  return [value, setter] as const;\n}\n","import { useCallback } from \"react\";\nimport type { StoreClient } from \"@/internal/store.js\";\nimport { useStore } from \"@/react/provider.js\";\n\nexport function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R> {\n  const store = useStore();\n  return useCallback((): Promise<R> => callback(store.getClient()), [store, callback]);\n}\n"],"mappings":";;;;AAGA,MAAM,eAAe,cAA4B,KAAK;AAOtD,SAAgB,SAAS,EAAE,OAAO,YAAsC;AACtE,QAAO,oBAAC,aAAa,UAAd;EAAuB,OAAO;EAAQ;EAAiC,CAAA;;AAGhF,SAAgB,WAAkB;CAChC,MAAM,QAAQ,WAAW,aAAa;AACtC,KAAI,SAAS,KACX,OAAM,IAAI,MAAM,4CAA4C;AAE9D,QAAO;;;;ACjBT,SAAgB,YACd,IACsB;CACtB,MAAM,MAAM,OAAO,GAAG;AACtB,KAAI,UAAU;AAEd,QAAO,aAAa,GAAG,SAAe,IAAI,QAAQ,GAAG,KAAK,EAAE,EAAE,CAAC;;;;ACMjE,SAAgB,aAAgB,MAAe,MAAgD;CAC7F,MAAM,QAAQ,UAAU;CAMxB,MAAM,WAAyB,qBAJb,aAAa,WAAuB,MAAM,UAAU,MAAM,OAAO,CAAC,EAChE,kBAAkB,MAAM,YAAY,KAAK,CAAC,EACpC,kBAAkB,MAAM,kBAAkB,KAAK,CAAC,CAEoB;CAE9F,MAAM,cAA2B,KAAK,QAAQ,eAAe;AAE7D,KAAI,SAAS,WAAW,UACtB,OAAM,MAAM,QAAQ,KAAK;AAG3B,KAAI,SAAS,WAAW,SAAS;AAC/B,MAAI,gBAAgB,UAClB,OAAM,MAAM,QAAQ,KAAK;AAGtB,QAAM,QAAQ,KAAK;AAExB,MAAI,MAAM,YAAY,KACpB,QAAO;GAAE,OAAO,SAAS;GAAO,SAAS;GAAM,OAAO,KAAA;GAAW;AAEnE,SAAO,SAAS;;AAGlB,KAAI,SAAS,WAAW,SAAS;AAC/B,MAAI,MAAM,YAAY,QAAQ,SAAS,UAAU,KAAA,EAC/C,QAAO;GACL,OAAO,SAAS;GAChB,SAAS;GACT,OAAO,SAAS;GACjB;AAEH,QAAM,SAAS;;AAIjB,KAAI,MAAM,YAAY,KACpB,QAAO;EAAE,OAAO,SAAS;EAAO,SAAS;EAAO,OAAO,KAAA;EAAW;AAEpE,QAAO,SAAS;;;;ACrDlB,SAAgB,WACd,MAC+B;CAC/B,MAAM,QAAQ,UAAU;AACxB,QAAO,aAAa,GAAG,SAA2B,MAAM,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC,OAAO,KAAK,CAAC;;;;ACJ5F,SAAgB,YACd,UACkC;CAClC,MAAM,QAAQ,UAAU;AACxB,QAAO,aACJ,GAAG,SAA8B,MAAM,OAAO,UAAU,GAAG,KAAK,EACjE,CAAC,OAAO,SAAS,CAClB;;;;ACPH,SAAgB,QACd,MAC6C;AAG7C,QAAO,CAFO,aAAa,KAAK,EACjB,WAAW,KAAK,CACT;;;;ACLxB,SAAgB,eAAkB,UAA8D;CAC9F,MAAM,QAAQ,UAAU;AACxB,QAAO,kBAA8B,SAAS,MAAM,WAAW,CAAC,EAAE,CAAC,OAAO,SAAS,CAAC"}

package/dist/{store-Cng0OzIQ.d.ts → store-DLoedZQo.d.ts}

@@ -23,7 +23,14 @@ type AtomContext<Deps extends Record<string, Atom<unknown>>> = {
   get: <K extends keyof Deps>(key: K) => Promise<AtomValue<Deps[K]>>;
   signal: AbortSignal;
 };
-interface WritableAtomContext<Deps extends Record<string, Atom<unknown>>, Value> extends AtomContext<Deps> {
+/** Context for standalone mutations: optimistic writes and invalidation (no primary atom). */
+type MutationContext = {
+  writeOptimistic<U>(atom: Atom<U>, value: U): void;
+  writeOptimistic<U>(atom: Atom<U>, mutate: (prev: U | undefined) => U): void;
+  invalidate(atom: Atom<unknown>): void;
+  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;
+};
+interface WritableAtomContext<Deps extends Record<string, Atom<unknown>>, Value> extends AtomContext<Deps>, MutationContext {
   setOptimisticValue(value: Value): void;
   setOptimisticValue(mutate: (prev: Value | undefined) => Value): void;
 }
@@ -54,10 +61,18 @@ type AtomValue<A> = A extends Atom<infer V> ? V : never;
 type IsWritable<A> = A extends WritableAtom<unknown, readonly unknown[]> ? true : false;
 type AtomArgs<A> = A extends WritableAtom<unknown, infer Args> ? Args : never;
 //#endregion
+//#region src/internal/mutation.d.ts
+declare const MUTATION_RUN: unique symbol;
+type Mutation<in out Args extends readonly unknown[]> = {
+  readonly [MUTATION_RUN]: (ctx: MutationContext, ...args: Args) => Promise<void>;
+};
+declare function mutation<const Args extends readonly unknown[]>(fn: (ctx: MutationContext, ...args: Args) => Promise<void>): Mutation<Args>;
+//#endregion
 //#region src/internal/store.d.ts
 interface StoreClient {
   get<V>(atom: Atom<V>): Promise<V>;
   set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void>;
+  mutate<Args extends readonly unknown[]>(mutation: Mutation<Args>, ...args: Args): Promise<void>;
   write<V>(atom: Atom<V>, value: V): void;
   write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;
   invalidate(atom: Atom<unknown>): void;
@@ -73,11 +88,12 @@ declare class Store {
   getSnapshot<V>(atom: Atom<V>): AtomState<V>;
   getServerSnapshot<V>(atom: Atom<V>): AtomState<V>;
   set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void>;
+  mutate<Args extends readonly unknown[]>(mutation: Mutation<Args>, ...args: Args): Promise<void>;
   write<V>(atom: Atom<V>, value: V): void;
   write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;
   getClient(): StoreClient;
 }
 declare function createStore(): Store;
 //#endregion
-export { AtomArgs as a, AtomState as c, StalePolicy as d, WritableAtom as f, Atom as i, AtomValue as l, StoreClient as n, AtomConfig as o, WritableAtomContext as p, createStore as r, AtomContext as s, Store as t, IsWritable as u };
-//# sourceMappingURL=store-Cng0OzIQ.d.ts.map
+export { mutation as a, AtomConfig as c, AtomValue as d, IsWritable as f, WritableAtomContext as g, WritableAtom as h, Mutation as i, AtomContext as l, StalePolicy as m, StoreClient as n, Atom as o, MutationContext as p, createStore as r, AtomArgs as s, Store as t, AtomState as u };
+//# sourceMappingURL=store-DLoedZQo.d.ts.map

package/dist/store-DLoedZQo.d.ts.map

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

package/dist/{store-DuKg4_ng.js → store-DvSUP7R9.js}

@@ -183,6 +183,12 @@ function atomFamily(options) {
 	return family;
 }
 //#endregion
+//#region src/internal/mutation.ts
+const MUTATION_RUN = Symbol("kvark.mutationRun");
+function mutation(fn) {
+	return { [MUTATION_RUN]: fn };
+}
+//#endregion
 //#region src/internal/store.ts
 const PENDING_STATE = {
 	status: "pending",
@@ -319,6 +325,33 @@ var Store = class {
 		this.#pending.add(atom);
 		this.#schedulePendingFlush();
 	}
+	#relatedOptimisticWrite(target, valueOrMutate, relatedSnapshots) {
+		const targetEntry = this.#getOrCreate(target);
+		if (!relatedSnapshots.has(target)) relatedSnapshots.set(target, {
+			state: targetEntry.state,
+			version: targetEntry.version
+		});
+		this.#controllers.get(target)?.abort();
+		targetEntry.promise = null;
+		targetEntry.state = {
+			status: "fresh",
+			value: typeof valueOrMutate === "function" ? valueOrMutate(extractPreviousValue(targetEntry.state)) : valueOrMutate,
+			error: void 0
+		};
+		targetEntry.version++;
+		this.#scheduleNotify(target);
+		this.#markReverseDependentsStale(target);
+	}
+	#rollbackRelatedSnapshots(relatedSnapshots) {
+		for (const [target, targetSnap] of relatedSnapshots) {
+			const targetEntry = this.#atoms.get(target);
+			if (targetEntry != null) {
+				targetEntry.state = targetSnap.state;
+				targetEntry.version = targetSnap.version;
+				this.#scheduleNotify(target);
+			}
+		}
+	}
 	#registerRdeps(atom, deps) {
 		for (const dep of Object.values(deps)) {
 			let set = this.#rdeps.get(dep);
@@ -398,6 +431,7 @@ var Store = class {
 		const baseCtx = this.#makeCtx(atom, deps);
 		const entry = this.#getOrCreate(atom);
 		const optimisticSnapshot = { current: null };
+		const relatedSnapshots = /* @__PURE__ */ new Map();
 		const ctx = {
 			...baseCtx,
 			setOptimisticValue: (valueOrMutate) => {
@@ -413,7 +447,12 @@ var Store = class {
 				entry.version++;
 				this.#scheduleNotify(atom);
 				this.#markReverseDependentsStale(atom);
-			}
+			},
+			writeOptimistic: (target, valueOrMutate) => {
+				this.#relatedOptimisticWrite(target, valueOrMutate, relatedSnapshots);
+			},
+			invalidate: (target) => this.invalidate(target),
+			invalidateMany: (targets) => this.invalidateMany(targets)
 		};
 		try {
 			await config.set(ctx, ...args);
@@ -424,10 +463,27 @@ var Store = class {
 				entry.version = snap.version;
 				this.#scheduleNotify(atom);
 			}
+			this.#rollbackRelatedSnapshots(relatedSnapshots);
 			throw e;
 		}
 		this.invalidate(atom);
 	}
+	async mutate(mutation, ...args) {
+		const relatedSnapshots = /* @__PURE__ */ new Map();
+		const ctx = {
+			writeOptimistic: (target, valueOrMutate) => {
+				this.#relatedOptimisticWrite(target, valueOrMutate, relatedSnapshots);
+			},
+			invalidate: (target) => this.invalidate(target),
+			invalidateMany: (targets) => this.invalidateMany(targets)
+		};
+		try {
+			await mutation[MUTATION_RUN](ctx, ...args);
+		} catch (e) {
+			this.#rollbackRelatedSnapshots(relatedSnapshots);
+			throw e;
+		}
+	}
 	write(atom, valueOrMutate) {
 		const entry = this.#getOrCreate(atom);
 		this.#controllers.get(atom)?.abort();
@@ -446,6 +502,7 @@ var Store = class {
 		this.#client = {
 			get: (atom) => this.resolve(atom),
 			set: (atom, ...args) => this.set(atom, ...args),
+			mutate: (m, ...args) => this.mutate(m, ...args),
 			write: (atom, valueOrMutate) => this.write(atom, valueOrMutate),
 			invalidate: (atom) => this.invalidate(atom),
 			invalidateMany: (atoms) => this.invalidateMany(atoms),
@@ -467,6 +524,6 @@ function extractPreviousValue(state) {
 	if (state.status === "error") return state.value;
 }
 //#endregion
-export { atomFamily as n, atom as r, createStore as t };
+export { atom as i, mutation as n, atomFamily as r, createStore as t };
 
-//# sourceMappingURL=store-DuKg4_ng.js.map
+//# sourceMappingURL=store-DvSUP7R9.js.map

package/dist/store-DvSUP7R9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-DvSUP7R9.js","names":["#maxSize","#nodeMap","#valueMap","#head","#tail","#moveToMru","#insertBeforeTail","#evict","#detach","#atoms","#rdeps","#pending","#controllers","#familyUnsubs","#registeredFamilies","#getOrCreate","#runGet","#registerRdeps","#makeCtx","#scheduleNotify","#markStale","#schedulePendingFlush","#flushScheduled","#flushPending","#markReverseDependentsStale","#autoRegisterFamily","#relatedOptimisticWrite","#rollbackRelatedSnapshots","#client"],"sources":["../src/internal/atom.ts","../src/internal/lru-cache.ts","../src/internal/family.ts","../src/internal/mutation.ts","../src/internal/store.ts"],"sourcesContent":["import type {\n  Atom,\n  AtomConfig,\n  InternalAtomConfig,\n  WritableAtom,\n  WritableAtomContext,\n} from \"@/internal/types.js\";\nimport { CONFIG, WRITABLE } from \"@/internal/types.js\";\n\ntype WritableConfig<\n  Value,\n  Deps extends Record<string, Atom<unknown>>,\n  Args extends readonly unknown[],\n> = AtomConfig<Value, Deps, Args> & {\n  set: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n};\n\ntype ReadonlyConfig<Value, Deps extends Record<string, Atom<unknown>>> = Omit<\n  AtomConfig<Value, Deps, readonly []>,\n  \"set\"\n>;\n\nexport function atom<\n  Value,\n  Deps extends Record<string, Atom<unknown>> = Record<never, never>,\n  Args extends readonly unknown[] = readonly [],\n>(config: WritableConfig<Value, Deps, Args>): WritableAtom<Value, Args>;\n\nexport function atom<Value, Deps extends Record<string, Atom<unknown>> = Record<never, never>>(\n  config: ReadonlyConfig<Value, Deps>,\n): Atom<Value>;\n\nexport function atom<\n  Value,\n  Deps extends Record<string, Atom<unknown>> = Record<never, never>,\n  Args extends readonly unknown[] = readonly [],\n>(config: AtomConfig<Value, Deps, Args>): Atom<Value> {\n  const internal: InternalAtomConfig<Value> = Object.create(null) as InternalAtomConfig<Value>;\n  internal.get = config.get as InternalAtomConfig<Value>[\"get\"];\n\n  if (config.debugLabel != null) {\n    internal.debugLabel = config.debugLabel;\n  }\n  if (config.dependencies != null) {\n    internal.dependencies = config.dependencies as Record<string, Atom<unknown>>;\n  }\n  if (config.stalePolicy != null) {\n    internal.stalePolicy = config.stalePolicy;\n  }\n  if (config.set != null) {\n    internal.set = config.set as NonNullable<InternalAtomConfig<Value>[\"set\"]>;\n  }\n  if (config.onMount != null) {\n    internal.onMount = config.onMount as NonNullable<InternalAtomConfig<Value>[\"onMount\"]>;\n  }\n\n  if (config.set != null) {\n    return {\n      [CONFIG]: internal,\n      [WRITABLE]: [] as unknown as Args,\n      debugLabel: config.debugLabel,\n    } as unknown as Atom<Value>;\n  }\n\n  return {\n    [CONFIG]: internal,\n    debugLabel: config.debugLabel,\n  } as Atom<Value>;\n}\n","type LruNode<K> = {\n  key: K;\n  prev: LruNode<K> | null;\n  next: LruNode<K> | null;\n};\n\n/**\n * Fixed-capacity cache with O(1) get, set, delete and LRU eviction.\n *\n * Pass `maxSize: Infinity` to disable eviction (keep-all semantics).\n *\n * LRU end (oldest): head.next — MRU end (newest): tail.prev.\n */\nexport class LruCache<K, V> {\n  readonly #maxSize: number;\n  readonly #nodeMap = new Map<K, LruNode<K>>();\n  readonly #valueMap = new Map<K, V>();\n  readonly #head: LruNode<K>;\n  readonly #tail: LruNode<K>;\n\n  constructor(maxSize: number) {\n    this.#maxSize = maxSize;\n    this.#head = { key: undefined as unknown as K, prev: null, next: null };\n    this.#tail = { key: undefined as unknown as K, prev: this.#head, next: null };\n    this.#head.next = this.#tail;\n  }\n\n  /** Returns the value and marks the entry as most-recently used. */\n  get(key: K): V | undefined {\n    const node = this.#nodeMap.get(key);\n    if (node == null) {\n      return undefined;\n    }\n    this.#moveToMru(node);\n    return this.#valueMap.get(key);\n  }\n\n  /** Returns the value without affecting LRU order. */\n  peek(key: K): V | undefined {\n    return this.#valueMap.get(key);\n  }\n\n  /** Inserts or updates a value and evicts the LRU entry if over capacity. */\n  set(key: K, value: V): void {\n    const existing = this.#nodeMap.get(key);\n    if (existing != null) {\n      this.#valueMap.set(key, value);\n      this.#moveToMru(existing);\n      return;\n    }\n\n    const node: LruNode<K> = { key, prev: null, next: null };\n    this.#nodeMap.set(key, node);\n    this.#valueMap.set(key, value);\n    this.#insertBeforeTail(node);\n    this.#evict();\n  }\n\n  delete(key: K): void {\n    const node = this.#nodeMap.get(key);\n    if (node == null) {\n      return;\n    }\n    this.#detach(node);\n    this.#nodeMap.delete(key);\n    this.#valueMap.delete(key);\n  }\n\n  values(): IterableIterator<V> {\n    return this.#valueMap.values();\n  }\n\n  /** Returns a live read-only view of the underlying map. */\n  asReadonlyMap(): ReadonlyMap<K, V> {\n    return this.#valueMap;\n  }\n\n  #moveToMru(node: LruNode<K>): void {\n    this.#detach(node);\n    this.#insertBeforeTail(node);\n  }\n\n  #detach(node: LruNode<K>): void {\n    const { prev, next } = node;\n    if (prev == null || next == null) {\n      return;\n    }\n    prev.next = next;\n    next.prev = prev;\n  }\n\n  #insertBeforeTail(node: LruNode<K>): void {\n    const before = this.#tail.prev;\n    if (before == null) {\n      return;\n    }\n    before.next = node;\n    node.prev = before;\n    node.next = this.#tail;\n    this.#tail.prev = node;\n  }\n\n  #evict(): void {\n    if (!Number.isFinite(this.#maxSize)) {\n      return;\n    }\n    while (this.#nodeMap.size > this.#maxSize) {\n      const oldest = this.#head.next;\n      if (oldest == null) {\n        break;\n      }\n      this.#detach(oldest);\n      this.#nodeMap.delete(oldest.key);\n      this.#valueMap.delete(oldest.key);\n    }\n  }\n}\n","import type { Atom, AtomContext, StalePolicy, WritableAtomContext } from \"@/internal/types.js\";\nimport { FAMILY_LINK } from \"@/internal/types.js\";\nimport { atom } from \"@/internal/atom.js\";\nimport { LruCache } from \"@/internal/lru-cache.js\";\n\nexport type AtomFamilyOptions<\n  Param,\n  Value,\n  Deps extends Record<string, Atom<unknown>>,\n  Args extends readonly unknown[],\n  Key = Param,\n> = {\n  dependencies?: (param: Param) => Deps;\n  stalePolicy?: StalePolicy;\n  cachePolicy?: \"keep-all\" | \"lru\";\n  lruSize?: number;\n  debugLabel?: string;\n  /**\n   * Optional function to derive a stable cache key from `param`.\n   * Use when `Param` is an object and you want equality-by-value semantics.\n   * The returned key is used for all cache operations (get, set, LRU, invalidate, remove).\n   * The original `param` is still passed to `get`, `set`, and `dependencies`.\n   *\n   * For plain objects/arrays you can use `stableFamilyKey` from `@kdeveloper/kvark/family`.\n   * Treat the param object as immutable after the first call — `stableFamilyKey` memoises\n   * by object reference via a WeakMap.\n   */\n  paramKey?: (param: Param) => Key;\n  get: (param: Param) => (ctx: AtomContext<Deps>) => Promise<Value>;\n  set?: (param: Param) => (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n};\n\nexport interface AtomFamily<Param, Value, Key = Param> {\n  (param: Param): Atom<Value>;\n  invalidate(param: Param): void;\n  invalidateAll(): void;\n  remove(param: Param): void;\n  getCache(): ReadonlyMap<Key, Atom<Value>>;\n}\n\nexport interface FamilyLink {\n  invalidateAtom: (atom: Atom<unknown>) => void;\n  registerStore: (cb: (atom: Atom<unknown>) => void) => () => void;\n}\n\nexport function getFamilyLink(target: Atom<unknown>): FamilyLink | undefined {\n  return (target as unknown as Record<symbol, FamilyLink | undefined>)[FAMILY_LINK];\n}\n\nexport function atomFamily<\n  Param,\n  Value,\n  Deps extends Record<string, Atom<unknown>> = Record<never, never>,\n  Args extends readonly unknown[] = readonly [],\n  Key = Param,\n>(options: AtomFamilyOptions<Param, Value, Deps, Args, Key>): AtomFamily<Param, Value, Key> {\n  const maxSize = options.cachePolicy === \"lru\" ? (options.lruSize ?? 100) : Infinity;\n  const cache = new LruCache<Key, Atom<Value>>(maxSize);\n  const storeCallbacks = new Set<(atom: Atom<unknown>) => void>();\n\n  function keyOf(param: Param): Key {\n    return options.paramKey != null ? options.paramKey(param) : (param as unknown as Key);\n  }\n\n  const link: FamilyLink = {\n    invalidateAtom(target: Atom<unknown>): void {\n      for (const cb of storeCallbacks) {\n        cb(target);\n      }\n    },\n    registerStore(cb: (atom: Atom<unknown>) => void): () => void {\n      storeCallbacks.add(cb);\n      return () => {\n        storeCallbacks.delete(cb);\n      };\n    },\n  };\n\n  function attachLink(target: Atom<Value>): void {\n    (target as unknown as Record<symbol, FamilyLink>)[FAMILY_LINK] = link;\n  }\n\n  function getOrCreate(param: Param): Atom<Value> {\n    const key = keyOf(param);\n    const cached = cache.get(key);\n    if (cached != null) {\n      return cached;\n    }\n\n    const deps = options.dependencies?.(param);\n    const getFn = options.get(param);\n    const setFn = options.set?.(param);\n\n    const labelSuffix = options.paramKey != null ? String(key) : String(param);\n    const label = options.debugLabel != null ? `${options.debugLabel}(${labelSuffix})` : undefined;\n\n    const created = createAtom(label, deps, getFn, setFn);\n    attachLink(created);\n    cache.set(key, created);\n\n    return created;\n  }\n\n  function createAtom(\n    label: string | undefined,\n    deps: Deps | undefined,\n    getFn: (ctx: AtomContext<Deps>) => Promise<Value>,\n    setFn: ((ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>) | undefined,\n  ): Atom<Value> {\n    const base = {\n      get: getFn as (ctx: AtomContext<Deps>) => Promise<Value>,\n    } as {\n      debugLabel?: string;\n      dependencies?: Deps;\n      stalePolicy?: StalePolicy;\n      get: (ctx: AtomContext<Deps>) => Promise<Value>;\n      set?: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n    };\n\n    if (label != null) {\n      base.debugLabel = label;\n    }\n    if (deps != null) {\n      base.dependencies = deps;\n    }\n    if (options.stalePolicy != null) {\n      base.stalePolicy = options.stalePolicy;\n    }\n\n    if (setFn != null) {\n      base.set = setFn;\n      return atom(\n        base as typeof base & {\n          set: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n        },\n      ) as Atom<Value>;\n    }\n\n    return atom(base as Omit<typeof base, \"set\">);\n  }\n\n  const family = getOrCreate as AtomFamily<Param, Value, Key>;\n\n  family.invalidate = (param: Param): void => {\n    const cached = cache.peek(keyOf(param));\n    if (cached != null) {\n      link.invalidateAtom(cached);\n    }\n  };\n\n  family.invalidateAll = (): void => {\n    for (const cached of cache.values()) {\n      link.invalidateAtom(cached);\n    }\n  };\n\n  family.remove = (param: Param): void => {\n    cache.delete(keyOf(param));\n  };\n\n  family.getCache = (): ReadonlyMap<Key, Atom<Value>> => cache.asReadonlyMap();\n\n  return family;\n}\n","import type { MutationContext } from \"@/internal/types.js\";\n\nexport const MUTATION_RUN = Symbol(\"kvark.mutationRun\");\n\nexport type Mutation<in out Args extends readonly unknown[]> = {\n  readonly [MUTATION_RUN]: (ctx: MutationContext, ...args: Args) => Promise<void>;\n};\n\nexport function mutation<const Args extends readonly unknown[]>(\n  fn: (ctx: MutationContext, ...args: Args) => Promise<void>,\n): Mutation<Args> {\n  return { [MUTATION_RUN]: fn } as Mutation<Args>;\n}\n","import type {\n  Atom,\n  AtomContext,\n  AtomState,\n  InternalAtomConfig,\n  MutationContext,\n  StalePolicy,\n  WritableAtom,\n  WritableAtomContext,\n} from \"@/internal/types.js\";\nimport { CONFIG } from \"@/internal/types.js\";\nimport { getFamilyLink } from \"@/internal/family.js\";\nimport { MUTATION_RUN, type Mutation } from \"@/internal/mutation.js\";\n\ntype AtomEntry<V> = {\n  state: AtomState<V>;\n  version: number;\n  promise: Promise<V> | null;\n  listeners: Set<() => void>;\n  mountCount: number;\n  unmount: (() => void) | null;\n};\n\nexport interface StoreClient {\n  get<V>(atom: Atom<V>): Promise<V>;\n  set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void>;\n  mutate<Args extends readonly unknown[]>(mutation: Mutation<Args>, ...args: Args): Promise<void>;\n  write<V>(atom: Atom<V>, value: V): void;\n  write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;\n  invalidate(atom: Atom<unknown>): void;\n  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;\n  subscribe<V>(atom: Atom<V>, listener: (state: AtomState<V>) => void): () => void;\n}\n\nconst PENDING_STATE: AtomState<never> = {\n  status: \"pending\",\n  value: undefined,\n  error: undefined,\n} as AtomState<never>;\n\nexport class Store {\n  readonly #atoms = new WeakMap<Atom<unknown>, AtomEntry<unknown>>();\n  readonly #rdeps = new Map<Atom<unknown>, Set<Atom<unknown>>>();\n  readonly #pending = new Set<Atom<unknown>>();\n  readonly #controllers = new WeakMap<Atom<unknown>, AbortController>();\n  readonly #familyUnsubs = new Set<() => void>();\n  readonly #registeredFamilies = new WeakSet<object>();\n  #client: StoreClient | null = null;\n  #flushScheduled = false;\n\n  #getOrCreate<V>(atom: Atom<V>): AtomEntry<V> {\n    let entry = this.#atoms.get(atom) as AtomEntry<V> | undefined;\n    if (entry == null) {\n      entry = {\n        state: PENDING_STATE as AtomState<V>,\n        version: 0,\n        promise: null,\n        listeners: new Set(),\n        mountCount: 0,\n        unmount: null,\n      };\n      this.#atoms.set(atom, entry as AtomEntry<unknown>);\n    }\n    return entry;\n  }\n\n  resolve<V>(atom: Atom<V>): Promise<V> {\n    const entry = this.#getOrCreate(atom);\n    if (entry.promise != null) {\n      return entry.promise;\n    }\n\n    const promise = this.#runGet(atom).finally(() => {\n      const e = this.#atoms.get(atom) as AtomEntry<V> | undefined;\n      if (e != null) {\n        e.promise = null;\n      }\n    });\n    entry.promise = promise;\n    return promise;\n  }\n\n  async #runGet<V>(atom: Atom<V>): Promise<V> {\n    const config: InternalAtomConfig<V> = atom[CONFIG];\n    const dependencies = config.dependencies;\n    const stalePolicy: StalePolicy = config.stalePolicy ?? \"keep\";\n    const entry = this.#getOrCreate(atom);\n\n    if (dependencies != null) {\n      await Promise.all(Object.values(dependencies).map((dep) => this.resolve(dep)));\n      this.#registerRdeps(atom, dependencies);\n    }\n\n    const ctx = this.#makeCtx(atom, dependencies ?? {});\n\n    try {\n      const value = await config.get(ctx);\n      if (ctx.signal.aborted) {\n        throw new DOMException(\"The operation was aborted\", \"AbortError\");\n      }\n      entry.state = { status: \"fresh\", value, error: undefined };\n      entry.version++;\n      this.#scheduleNotify(atom);\n      return value;\n    } catch (e: unknown) {\n      if (isAbortError(e)) {\n        throw e;\n      }\n      const prevValue = extractPreviousValue<V>(entry.state);\n      entry.state = {\n        status: \"error\",\n        value: stalePolicy === \"keep\" ? prevValue : undefined,\n        error: e,\n      } as AtomState<V>;\n      entry.version++;\n      this.#scheduleNotify(atom);\n      throw e;\n    }\n  }\n\n  invalidate(atom: Atom<unknown>): void {\n    this.#markStale(atom);\n    this.#pending.add(atom);\n    this.#schedulePendingFlush();\n  }\n\n  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void {\n    for (const a of atoms) {\n      this.#markStale(a);\n      this.#pending.add(a);\n    }\n    if (this.#pending.size > 0) {\n      this.#schedulePendingFlush();\n    }\n  }\n\n  #markStale(atom: Atom<unknown>, visited = new Set<Atom<unknown>>()): void {\n    if (visited.has(atom)) {\n      return;\n    }\n    visited.add(atom);\n\n    const entry = this.#atoms.get(atom);\n    if (entry != null) {\n      const stalePolicy: StalePolicy = atom[CONFIG].stalePolicy ?? \"keep\";\n\n      if (entry.state.status === \"fresh\") {\n        if (stalePolicy === \"reset\") {\n          entry.state = PENDING_STATE;\n        } else {\n          entry.state = { ...entry.state, status: \"stale\" };\n        }\n      }\n\n      entry.promise = null;\n      this.#controllers.get(atom)?.abort();\n    }\n\n    const rdeps = this.#rdeps.get(atom);\n    if (rdeps != null) {\n      for (const dep of rdeps) {\n        this.#markStale(dep, visited);\n      }\n    }\n  }\n\n  #markReverseDependentsStale(atom: Atom<unknown>): void {\n    const rdeps = this.#rdeps.get(atom);\n    if (rdeps != null) {\n      const visited = new Set<Atom<unknown>>([atom]);\n      for (const dep of rdeps) {\n        this.#markStale(dep, visited);\n        this.#pending.add(dep);\n      }\n    }\n  }\n\n  #flushPending(): void {\n    const batch = [...this.#pending];\n    this.#pending.clear();\n    const toNotify = new Set<() => void>();\n    for (const a of batch) {\n      const entry = this.#atoms.get(a);\n      if (entry != null) {\n        for (const l of entry.listeners) {\n          toNotify.add(l);\n        }\n      }\n    }\n    for (const l of toNotify) {\n      l();\n    }\n  }\n\n  #schedulePendingFlush(): void {\n    if (!this.#flushScheduled) {\n      this.#flushScheduled = true;\n      queueMicrotask(() => {\n        this.#flushScheduled = false;\n        this.#flushPending();\n      });\n    }\n  }\n\n  #scheduleNotify(atom: Atom<unknown>): void {\n    this.#pending.add(atom);\n    this.#schedulePendingFlush();\n  }\n\n  #relatedOptimisticWrite<U>(\n    target: Atom<U>,\n    valueOrMutate: U | ((prev: U | undefined) => U),\n    relatedSnapshots: Map<Atom<unknown>, { state: AtomState<unknown>; version: number }>,\n  ): void {\n    const targetEntry = this.#getOrCreate(target);\n    if (!relatedSnapshots.has(target)) {\n      relatedSnapshots.set(target, { state: targetEntry.state, version: targetEntry.version });\n    }\n    this.#controllers.get(target)?.abort();\n    targetEntry.promise = null;\n    const next =\n      typeof valueOrMutate === \"function\"\n        ? (valueOrMutate as (prev: U | undefined) => U)(extractPreviousValue(targetEntry.state))\n        : valueOrMutate;\n    targetEntry.state = { status: \"fresh\", value: next, error: undefined };\n    targetEntry.version++;\n    this.#scheduleNotify(target);\n    this.#markReverseDependentsStale(target);\n  }\n\n  #rollbackRelatedSnapshots(\n    relatedSnapshots: Map<Atom<unknown>, { state: AtomState<unknown>; version: number }>,\n  ): void {\n    for (const [target, targetSnap] of relatedSnapshots) {\n      const targetEntry = this.#atoms.get(target) as AtomEntry<unknown> | undefined;\n      if (targetEntry != null) {\n        targetEntry.state = targetSnap.state;\n        targetEntry.version = targetSnap.version;\n        this.#scheduleNotify(target);\n      }\n    }\n  }\n\n  #registerRdeps(atom: Atom<unknown>, deps: Record<string, Atom<unknown>>): void {\n    for (const dep of Object.values(deps)) {\n      let set = this.#rdeps.get(dep);\n      if (set == null) {\n        set = new Set();\n        this.#rdeps.set(dep, set);\n      }\n      set.add(atom);\n    }\n  }\n\n  #makeCtx(\n    atom: Atom<unknown>,\n    deps: Record<string, Atom<unknown>>,\n  ): AtomContext<Record<string, Atom<unknown>>> {\n    this.#controllers.get(atom)?.abort();\n    const controller = new AbortController();\n    this.#controllers.set(atom, controller);\n\n    return {\n      signal: controller.signal,\n      get: async (key: string) => {\n        const dep = deps[key];\n        if (dep == null) {\n          throw new Error(`Unknown dependency key: \"${String(key)}\"`);\n        }\n        return this.resolve(dep);\n      },\n    };\n  }\n\n  subscribe<V>(atom: Atom<V>, listener: () => void): () => void {\n    const entry = this.#getOrCreate(atom);\n    entry.listeners.add(listener);\n\n    this.#autoRegisterFamily(atom);\n\n    if (entry.state.status === \"pending\" && entry.promise == null) {\n      void this.resolve(atom);\n    }\n\n    entry.mountCount++;\n    if (entry.mountCount === 1) {\n      const config: InternalAtomConfig<V> = atom[CONFIG];\n      if (config.onMount != null) {\n        const setValue = (value: V): void => {\n          entry.state = { status: \"fresh\", value, error: undefined };\n          entry.version++;\n          this.#scheduleNotify(atom);\n        };\n        const cleanup = config.onMount(setValue as (value: unknown) => void);\n        if (typeof cleanup === \"function\") {\n          entry.unmount = cleanup;\n        }\n      }\n    }\n\n    return () => {\n      entry.listeners.delete(listener);\n      entry.mountCount--;\n      if (entry.mountCount === 0 && entry.unmount != null) {\n        entry.unmount();\n        entry.unmount = null;\n      }\n    };\n  }\n\n  #autoRegisterFamily(atom: Atom<unknown>): void {\n    const link = getFamilyLink(atom);\n    if (link == null) {\n      return;\n    }\n    if (this.#registeredFamilies.has(link)) {\n      return;\n    }\n    this.#registeredFamilies.add(link);\n    const unsub = link.registerStore((target: Atom<unknown>) => {\n      this.invalidate(target);\n    });\n    this.#familyUnsubs.add(unsub);\n  }\n\n  getSnapshot<V>(atom: Atom<V>): AtomState<V> {\n    return this.#getOrCreate(atom).state;\n  }\n\n  getServerSnapshot<V>(atom: Atom<V>): AtomState<V> {\n    const entry = this.#atoms.get(atom) as AtomEntry<V> | undefined;\n    if (entry != null) {\n      return entry.state;\n    }\n    return PENDING_STATE as AtomState<V>;\n  }\n\n  async set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void> {\n    const config: InternalAtomConfig<V> = atom[CONFIG];\n    if (config.set == null) {\n      throw new Error(\n        `Atom${atom.debugLabel != null ? ` \"${atom.debugLabel}\"` : \"\"} is not writable`,\n      );\n    }\n\n    const deps = config.dependencies ?? {};\n    const baseCtx = this.#makeCtx(atom, deps);\n    const entry = this.#getOrCreate(atom);\n\n    const optimisticSnapshot: {\n      current: { state: AtomState<V>; version: number } | null;\n    } = { current: null };\n    const relatedSnapshots = new Map<\n      Atom<unknown>,\n      { state: AtomState<unknown>; version: number }\n    >();\n\n    const ctx: WritableAtomContext<Record<string, Atom<unknown>>, V> = {\n      ...baseCtx,\n      setOptimisticValue: (valueOrMutate: V | ((prev: V | undefined) => V)): void => {\n        if (optimisticSnapshot.current == null) {\n          optimisticSnapshot.current = { state: entry.state, version: entry.version };\n        }\n        const next =\n          typeof valueOrMutate === \"function\"\n            ? (valueOrMutate as (prev: V | undefined) => V)(extractPreviousValue(entry.state))\n            : valueOrMutate;\n        entry.state = { status: \"fresh\", value: next, error: undefined };\n        entry.version++;\n        this.#scheduleNotify(atom);\n        this.#markReverseDependentsStale(atom);\n      },\n      writeOptimistic: <U>(\n        target: Atom<U>,\n        valueOrMutate: U | ((prev: U | undefined) => U),\n      ): void => {\n        this.#relatedOptimisticWrite(target, valueOrMutate, relatedSnapshots);\n      },\n      invalidate: (target: Atom<unknown>): void => this.invalidate(target),\n      invalidateMany: (targets: ReadonlyArray<Atom<unknown>>): void => this.invalidateMany(targets),\n    };\n\n    try {\n      await config.set(ctx, ...args);\n    } catch (e: unknown) {\n      const snap = optimisticSnapshot.current;\n      if (snap != null) {\n        entry.state = snap.state;\n        entry.version = snap.version;\n        this.#scheduleNotify(atom);\n      }\n      this.#rollbackRelatedSnapshots(relatedSnapshots);\n      throw e;\n    }\n\n    this.invalidate(atom);\n  }\n\n  async mutate<Args extends readonly unknown[]>(\n    mutation: Mutation<Args>,\n    ...args: Args\n  ): Promise<void> {\n    const relatedSnapshots = new Map<\n      Atom<unknown>,\n      { state: AtomState<unknown>; version: number }\n    >();\n\n    const ctx: MutationContext = {\n      writeOptimistic: <U>(\n        target: Atom<U>,\n        valueOrMutate: U | ((prev: U | undefined) => U),\n      ): void => {\n        this.#relatedOptimisticWrite(target, valueOrMutate, relatedSnapshots);\n      },\n      invalidate: (target: Atom<unknown>): void => this.invalidate(target),\n      invalidateMany: (targets: ReadonlyArray<Atom<unknown>>): void => this.invalidateMany(targets),\n    };\n\n    try {\n      await mutation[MUTATION_RUN](ctx, ...args);\n    } catch (e: unknown) {\n      this.#rollbackRelatedSnapshots(relatedSnapshots);\n      throw e;\n    }\n  }\n\n  write<V>(atom: Atom<V>, value: V): void;\n  write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;\n  write<V>(atom: Atom<V>, valueOrMutate: V | ((prev: V | undefined) => V)): void {\n    const entry = this.#getOrCreate(atom);\n    this.#controllers.get(atom)?.abort();\n    entry.promise = null;\n    const next =\n      typeof valueOrMutate === \"function\"\n        ? (valueOrMutate as (prev: V | undefined) => V)(extractPreviousValue(entry.state))\n        : valueOrMutate;\n    entry.state = { status: \"fresh\", value: next, error: undefined };\n    entry.version++;\n    this.#scheduleNotify(atom);\n    this.#markReverseDependentsStale(atom);\n  }\n\n  getClient(): StoreClient {\n    if (this.#client != null) {\n      return this.#client;\n    }\n\n    this.#client = {\n      get: <V>(atom: Atom<V>): Promise<V> => this.resolve(atom),\n      set: <V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void> =>\n        this.set(atom, ...args),\n      mutate: <Args extends readonly unknown[]>(m: Mutation<Args>, ...args: Args): Promise<void> =>\n        this.mutate(m, ...args),\n      write: <V>(atom: Atom<V>, valueOrMutate: V | ((prev: V | undefined) => V)): void =>\n        this.write(atom, valueOrMutate as V),\n      invalidate: (atom: Atom<unknown>): void => this.invalidate(atom),\n      invalidateMany: (atoms: ReadonlyArray<Atom<unknown>>): void => this.invalidateMany(atoms),\n      subscribe: <V>(atom: Atom<V>, listener: (state: AtomState<V>) => void): (() => void) =>\n        this.subscribe(atom, () => {\n          listener(this.getSnapshot(atom));\n        }),\n    };\n    return this.#client;\n  }\n}\n\nexport function createStore(): Store {\n  return new Store();\n}\n\nfunction isAbortError(e: unknown): boolean {\n  return e instanceof DOMException && e.name === \"AbortError\";\n}\n\nfunction extractPreviousValue<V>(state: AtomState<V>): V | undefined {\n  if (state.status === \"stale\" || state.status === \"fresh\") {\n    return state.value;\n  }\n  if (state.status === \"error\") {\n    return state.value;\n  }\n  return undefined;\n}\n"],"mappings":";;AAgCA,SAAgB,KAId,QAAoD;CACpD,MAAM,WAAsC,OAAO,OAAO,KAAK;AAC/D,UAAS,MAAM,OAAO;AAEtB,KAAI,OAAO,cAAc,KACvB,UAAS,aAAa,OAAO;AAE/B,KAAI,OAAO,gBAAgB,KACzB,UAAS,eAAe,OAAO;AAEjC,KAAI,OAAO,eAAe,KACxB,UAAS,cAAc,OAAO;AAEhC,KAAI,OAAO,OAAO,KAChB,UAAS,MAAM,OAAO;AAExB,KAAI,OAAO,WAAW,KACpB,UAAS,UAAU,OAAO;AAG5B,KAAI,OAAO,OAAO,KAChB,QAAO;GACJ,SAAS;GACT,WAAW,EAAE;EACd,YAAY,OAAO;EACpB;AAGH,QAAO;GACJ,SAAS;EACV,YAAY,OAAO;EACpB;;;;;;;;;;;ACtDH,IAAa,WAAb,MAA4B;CAC1B;CACA,2BAAoB,IAAI,KAAoB;CAC5C,4BAAqB,IAAI,KAAW;CACpC;CACA;CAEA,YAAY,SAAiB;AAC3B,QAAA,UAAgB;AAChB,QAAA,OAAa;GAAE,KAAK,KAAA;GAA2B,MAAM;GAAM,MAAM;GAAM;AACvE,QAAA,OAAa;GAAE,KAAK,KAAA;GAA2B,MAAM,MAAA;GAAY,MAAM;GAAM;AAC7E,QAAA,KAAW,OAAO,MAAA;;;CAIpB,IAAI,KAAuB;EACzB,MAAM,OAAO,MAAA,QAAc,IAAI,IAAI;AACnC,MAAI,QAAQ,KACV;AAEF,QAAA,UAAgB,KAAK;AACrB,SAAO,MAAA,SAAe,IAAI,IAAI;;;CAIhC,KAAK,KAAuB;AAC1B,SAAO,MAAA,SAAe,IAAI,IAAI;;;CAIhC,IAAI,KAAQ,OAAgB;EAC1B,MAAM,WAAW,MAAA,QAAc,IAAI,IAAI;AACvC,MAAI,YAAY,MAAM;AACpB,SAAA,SAAe,IAAI,KAAK,MAAM;AAC9B,SAAA,UAAgB,SAAS;AACzB;;EAGF,MAAM,OAAmB;GAAE;GAAK,MAAM;GAAM,MAAM;GAAM;AACxD,QAAA,QAAc,IAAI,KAAK,KAAK;AAC5B,QAAA,SAAe,IAAI,KAAK,MAAM;AAC9B,QAAA,iBAAuB,KAAK;AAC5B,QAAA,OAAa;;CAGf,OAAO,KAAc;EACnB,MAAM,OAAO,MAAA,QAAc,IAAI,IAAI;AACnC,MAAI,QAAQ,KACV;AAEF,QAAA,OAAa,KAAK;AAClB,QAAA,QAAc,OAAO,IAAI;AACzB,QAAA,SAAe,OAAO,IAAI;;CAG5B,SAA8B;AAC5B,SAAO,MAAA,SAAe,QAAQ;;;CAIhC,gBAAmC;AACjC,SAAO,MAAA;;CAGT,WAAW,MAAwB;AACjC,QAAA,OAAa,KAAK;AAClB,QAAA,iBAAuB,KAAK;;CAG9B,QAAQ,MAAwB;EAC9B,MAAM,EAAE,MAAM,SAAS;AACvB,MAAI,QAAQ,QAAQ,QAAQ,KAC1B;AAEF,OAAK,OAAO;AACZ,OAAK,OAAO;;CAGd,kBAAkB,MAAwB;EACxC,MAAM,SAAS,MAAA,KAAW;AAC1B,MAAI,UAAU,KACZ;AAEF,SAAO,OAAO;AACd,OAAK,OAAO;AACZ,OAAK,OAAO,MAAA;AACZ,QAAA,KAAW,OAAO;;CAGpB,SAAe;AACb,MAAI,CAAC,OAAO,SAAS,MAAA,QAAc,CACjC;AAEF,SAAO,MAAA,QAAc,OAAO,MAAA,SAAe;GACzC,MAAM,SAAS,MAAA,KAAW;AAC1B,OAAI,UAAU,KACZ;AAEF,SAAA,OAAa,OAAO;AACpB,SAAA,QAAc,OAAO,OAAO,IAAI;AAChC,SAAA,SAAe,OAAO,OAAO,IAAI;;;;;;ACpEvC,SAAgB,cAAc,QAA+C;AAC3E,QAAQ,OAA6D;;AAGvE,SAAgB,WAMd,SAA0F;CAE1F,MAAM,QAAQ,IAAI,SADF,QAAQ,gBAAgB,QAAS,QAAQ,WAAW,MAAO,SACtB;CACrD,MAAM,iCAAiB,IAAI,KAAoC;CAE/D,SAAS,MAAM,OAAmB;AAChC,SAAO,QAAQ,YAAY,OAAO,QAAQ,SAAS,MAAM,GAAI;;CAG/D,MAAM,OAAmB;EACvB,eAAe,QAA6B;AAC1C,QAAK,MAAM,MAAM,eACf,IAAG,OAAO;;EAGd,cAAc,IAA+C;AAC3D,kBAAe,IAAI,GAAG;AACtB,gBAAa;AACX,mBAAe,OAAO,GAAG;;;EAG9B;CAED,SAAS,WAAW,QAA2B;AAC5C,SAAiD,eAAe;;CAGnE,SAAS,YAAY,OAA2B;EAC9C,MAAM,MAAM,MAAM,MAAM;EACxB,MAAM,SAAS,MAAM,IAAI,IAAI;AAC7B,MAAI,UAAU,KACZ,QAAO;EAGT,MAAM,OAAO,QAAQ,eAAe,MAAM;EAC1C,MAAM,QAAQ,QAAQ,IAAI,MAAM;EAChC,MAAM,QAAQ,QAAQ,MAAM,MAAM;EAElC,MAAM,cAAc,QAAQ,YAAY,OAAO,OAAO,IAAI,GAAG,OAAO,MAAM;EAG1E,MAAM,UAAU,WAFF,QAAQ,cAAc,OAAO,GAAG,QAAQ,WAAW,GAAG,YAAY,KAAK,KAAA,GAEnD,MAAM,OAAO,MAAM;AACrD,aAAW,QAAQ;AACnB,QAAM,IAAI,KAAK,QAAQ;AAEvB,SAAO;;CAGT,SAAS,WACP,OACA,MACA,OACA,OACa;EACb,MAAM,OAAO,EACX,KAAK,OACN;AAQD,MAAI,SAAS,KACX,MAAK,aAAa;AAEpB,MAAI,QAAQ,KACV,MAAK,eAAe;AAEtB,MAAI,QAAQ,eAAe,KACzB,MAAK,cAAc,QAAQ;AAG7B,MAAI,SAAS,MAAM;AACjB,QAAK,MAAM;AACX,UAAO,KACL,KAGD;;AAGH,SAAO,KAAK,KAAiC;;CAG/C,MAAM,SAAS;AAEf,QAAO,cAAc,UAAuB;EAC1C,MAAM,SAAS,MAAM,KAAK,MAAM,MAAM,CAAC;AACvC,MAAI,UAAU,KACZ,MAAK,eAAe,OAAO;;AAI/B,QAAO,sBAA4B;AACjC,OAAK,MAAM,UAAU,MAAM,QAAQ,CACjC,MAAK,eAAe,OAAO;;AAI/B,QAAO,UAAU,UAAuB;AACtC,QAAM,OAAO,MAAM,MAAM,CAAC;;AAG5B,QAAO,iBAAgD,MAAM,eAAe;AAE5E,QAAO;;;;AChKT,MAAa,eAAe,OAAO,oBAAoB;AAMvD,SAAgB,SACd,IACgB;AAChB,QAAO,GAAG,eAAe,IAAI;;;;ACuB/B,MAAM,gBAAkC;CACtC,QAAQ;CACR,OAAO,KAAA;CACP,OAAO,KAAA;CACR;AAED,IAAa,QAAb,MAAmB;CACjB,yBAAkB,IAAI,SAA4C;CAClE,yBAAkB,IAAI,KAAwC;CAC9D,2BAAoB,IAAI,KAAoB;CAC5C,+BAAwB,IAAI,SAAyC;CACrE,gCAAyB,IAAI,KAAiB;CAC9C,sCAA+B,IAAI,SAAiB;CACpD,UAA8B;CAC9B,kBAAkB;CAElB,aAAgB,MAA6B;EAC3C,IAAI,QAAQ,MAAA,MAAY,IAAI,KAAK;AACjC,MAAI,SAAS,MAAM;AACjB,WAAQ;IACN,OAAO;IACP,SAAS;IACT,SAAS;IACT,2BAAW,IAAI,KAAK;IACpB,YAAY;IACZ,SAAS;IACV;AACD,SAAA,MAAY,IAAI,MAAM,MAA4B;;AAEpD,SAAO;;CAGT,QAAW,MAA2B;EACpC,MAAM,QAAQ,MAAA,YAAkB,KAAK;AACrC,MAAI,MAAM,WAAW,KACnB,QAAO,MAAM;EAGf,MAAM,UAAU,MAAA,OAAa,KAAK,CAAC,cAAc;GAC/C,MAAM,IAAI,MAAA,MAAY,IAAI,KAAK;AAC/B,OAAI,KAAK,KACP,GAAE,UAAU;IAEd;AACF,QAAM,UAAU;AAChB,SAAO;;CAGT,OAAA,OAAiB,MAA2B;EAC1C,MAAM,SAAgC,KAAK;EAC3C,MAAM,eAAe,OAAO;EAC5B,MAAM,cAA2B,OAAO,eAAe;EACvD,MAAM,QAAQ,MAAA,YAAkB,KAAK;AAErC,MAAI,gBAAgB,MAAM;AACxB,SAAM,QAAQ,IAAI,OAAO,OAAO,aAAa,CAAC,KAAK,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC;AAC9E,SAAA,cAAoB,MAAM,aAAa;;EAGzC,MAAM,MAAM,MAAA,QAAc,MAAM,gBAAgB,EAAE,CAAC;AAEnD,MAAI;GACF,MAAM,QAAQ,MAAM,OAAO,IAAI,IAAI;AACnC,OAAI,IAAI,OAAO,QACb,OAAM,IAAI,aAAa,6BAA6B,aAAa;AAEnE,SAAM,QAAQ;IAAE,QAAQ;IAAS;IAAO,OAAO,KAAA;IAAW;AAC1D,SAAM;AACN,SAAA,eAAqB,KAAK;AAC1B,UAAO;WACA,GAAY;AACnB,OAAI,aAAa,EAAE,CACjB,OAAM;GAER,MAAM,YAAY,qBAAwB,MAAM,MAAM;AACtD,SAAM,QAAQ;IACZ,QAAQ;IACR,OAAO,gBAAgB,SAAS,YAAY,KAAA;IAC5C,OAAO;IACR;AACD,SAAM;AACN,SAAA,eAAqB,KAAK;AAC1B,SAAM;;;CAIV,WAAW,MAA2B;AACpC,QAAA,UAAgB,KAAK;AACrB,QAAA,QAAc,IAAI,KAAK;AACvB,QAAA,sBAA4B;;CAG9B,eAAe,OAA2C;AACxD,OAAK,MAAM,KAAK,OAAO;AACrB,SAAA,UAAgB,EAAE;AAClB,SAAA,QAAc,IAAI,EAAE;;AAEtB,MAAI,MAAA,QAAc,OAAO,EACvB,OAAA,sBAA4B;;CAIhC,WAAW,MAAqB,0BAAU,IAAI,KAAoB,EAAQ;AACxE,MAAI,QAAQ,IAAI,KAAK,CACnB;AAEF,UAAQ,IAAI,KAAK;EAEjB,MAAM,QAAQ,MAAA,MAAY,IAAI,KAAK;AACnC,MAAI,SAAS,MAAM;GACjB,MAAM,cAA2B,KAAK,QAAQ,eAAe;AAE7D,OAAI,MAAM,MAAM,WAAW,QACzB,KAAI,gBAAgB,QAClB,OAAM,QAAQ;OAEd,OAAM,QAAQ;IAAE,GAAG,MAAM;IAAO,QAAQ;IAAS;AAIrD,SAAM,UAAU;AAChB,SAAA,YAAkB,IAAI,KAAK,EAAE,OAAO;;EAGtC,MAAM,QAAQ,MAAA,MAAY,IAAI,KAAK;AACnC,MAAI,SAAS,KACX,MAAK,MAAM,OAAO,MAChB,OAAA,UAAgB,KAAK,QAAQ;;CAKnC,4BAA4B,MAA2B;EACrD,MAAM,QAAQ,MAAA,MAAY,IAAI,KAAK;AACnC,MAAI,SAAS,MAAM;GACjB,MAAM,UAAU,IAAI,IAAmB,CAAC,KAAK,CAAC;AAC9C,QAAK,MAAM,OAAO,OAAO;AACvB,UAAA,UAAgB,KAAK,QAAQ;AAC7B,UAAA,QAAc,IAAI,IAAI;;;;CAK5B,gBAAsB;EACpB,MAAM,QAAQ,CAAC,GAAG,MAAA,QAAc;AAChC,QAAA,QAAc,OAAO;EACrB,MAAM,2BAAW,IAAI,KAAiB;AACtC,OAAK,MAAM,KAAK,OAAO;GACrB,MAAM,QAAQ,MAAA,MAAY,IAAI,EAAE;AAChC,OAAI,SAAS,KACX,MAAK,MAAM,KAAK,MAAM,UACpB,UAAS,IAAI,EAAE;;AAIrB,OAAK,MAAM,KAAK,SACd,IAAG;;CAIP,wBAA8B;AAC5B,MAAI,CAAC,MAAA,gBAAsB;AACzB,SAAA,iBAAuB;AACvB,wBAAqB;AACnB,UAAA,iBAAuB;AACvB,UAAA,cAAoB;KACpB;;;CAIN,gBAAgB,MAA2B;AACzC,QAAA,QAAc,IAAI,KAAK;AACvB,QAAA,sBAA4B;;CAG9B,wBACE,QACA,eACA,kBACM;EACN,MAAM,cAAc,MAAA,YAAkB,OAAO;AAC7C,MAAI,CAAC,iBAAiB,IAAI,OAAO,CAC/B,kBAAiB,IAAI,QAAQ;GAAE,OAAO,YAAY;GAAO,SAAS,YAAY;GAAS,CAAC;AAE1F,QAAA,YAAkB,IAAI,OAAO,EAAE,OAAO;AACtC,cAAY,UAAU;AAKtB,cAAY,QAAQ;GAAE,QAAQ;GAAS,OAHrC,OAAO,kBAAkB,aACpB,cAA6C,qBAAqB,YAAY,MAAM,CAAC,GACtF;GAC8C,OAAO,KAAA;GAAW;AACtE,cAAY;AACZ,QAAA,eAAqB,OAAO;AAC5B,QAAA,2BAAiC,OAAO;;CAG1C,0BACE,kBACM;AACN,OAAK,MAAM,CAAC,QAAQ,eAAe,kBAAkB;GACnD,MAAM,cAAc,MAAA,MAAY,IAAI,OAAO;AAC3C,OAAI,eAAe,MAAM;AACvB,gBAAY,QAAQ,WAAW;AAC/B,gBAAY,UAAU,WAAW;AACjC,UAAA,eAAqB,OAAO;;;;CAKlC,eAAe,MAAqB,MAA2C;AAC7E,OAAK,MAAM,OAAO,OAAO,OAAO,KAAK,EAAE;GACrC,IAAI,MAAM,MAAA,MAAY,IAAI,IAAI;AAC9B,OAAI,OAAO,MAAM;AACf,0BAAM,IAAI,KAAK;AACf,UAAA,MAAY,IAAI,KAAK,IAAI;;AAE3B,OAAI,IAAI,KAAK;;;CAIjB,SACE,MACA,MAC4C;AAC5C,QAAA,YAAkB,IAAI,KAAK,EAAE,OAAO;EACpC,MAAM,aAAa,IAAI,iBAAiB;AACxC,QAAA,YAAkB,IAAI,MAAM,WAAW;AAEvC,SAAO;GACL,QAAQ,WAAW;GACnB,KAAK,OAAO,QAAgB;IAC1B,MAAM,MAAM,KAAK;AACjB,QAAI,OAAO,KACT,OAAM,IAAI,MAAM,4BAA4B,OAAO,IAAI,CAAC,GAAG;AAE7D,WAAO,KAAK,QAAQ,IAAI;;GAE3B;;CAGH,UAAa,MAAe,UAAkC;EAC5D,MAAM,QAAQ,MAAA,YAAkB,KAAK;AACrC,QAAM,UAAU,IAAI,SAAS;AAE7B,QAAA,mBAAyB,KAAK;AAE9B,MAAI,MAAM,MAAM,WAAW,aAAa,MAAM,WAAW,KAClD,MAAK,QAAQ,KAAK;AAGzB,QAAM;AACN,MAAI,MAAM,eAAe,GAAG;GAC1B,MAAM,SAAgC,KAAK;AAC3C,OAAI,OAAO,WAAW,MAAM;IAC1B,MAAM,YAAY,UAAmB;AACnC,WAAM,QAAQ;MAAE,QAAQ;MAAS;MAAO,OAAO,KAAA;MAAW;AAC1D,WAAM;AACN,WAAA,eAAqB,KAAK;;IAE5B,MAAM,UAAU,OAAO,QAAQ,SAAqC;AACpE,QAAI,OAAO,YAAY,WACrB,OAAM,UAAU;;;AAKtB,eAAa;AACX,SAAM,UAAU,OAAO,SAAS;AAChC,SAAM;AACN,OAAI,MAAM,eAAe,KAAK,MAAM,WAAW,MAAM;AACnD,UAAM,SAAS;AACf,UAAM,UAAU;;;;CAKtB,oBAAoB,MAA2B;EAC7C,MAAM,OAAO,cAAc,KAAK;AAChC,MAAI,QAAQ,KACV;AAEF,MAAI,MAAA,mBAAyB,IAAI,KAAK,CACpC;AAEF,QAAA,mBAAyB,IAAI,KAAK;EAClC,MAAM,QAAQ,KAAK,eAAe,WAA0B;AAC1D,QAAK,WAAW,OAAO;IACvB;AACF,QAAA,aAAmB,IAAI,MAAM;;CAG/B,YAAe,MAA6B;AAC1C,SAAO,MAAA,YAAkB,KAAK,CAAC;;CAGjC,kBAAqB,MAA6B;EAChD,MAAM,QAAQ,MAAA,MAAY,IAAI,KAAK;AACnC,MAAI,SAAS,KACX,QAAO,MAAM;AAEf,SAAO;;CAGT,MAAM,IAAqC,MAA0B,GAAG,MAAwB;EAC9F,MAAM,SAAgC,KAAK;AAC3C,MAAI,OAAO,OAAO,KAChB,OAAM,IAAI,MACR,OAAO,KAAK,cAAc,OAAO,KAAK,KAAK,WAAW,KAAK,GAAG,kBAC/D;EAGH,MAAM,OAAO,OAAO,gBAAgB,EAAE;EACtC,MAAM,UAAU,MAAA,QAAc,MAAM,KAAK;EACzC,MAAM,QAAQ,MAAA,YAAkB,KAAK;EAErC,MAAM,qBAEF,EAAE,SAAS,MAAM;EACrB,MAAM,mCAAmB,IAAI,KAG1B;EAEH,MAAM,MAA6D;GACjE,GAAG;GACH,qBAAqB,kBAA0D;AAC7E,QAAI,mBAAmB,WAAW,KAChC,oBAAmB,UAAU;KAAE,OAAO,MAAM;KAAO,SAAS,MAAM;KAAS;AAM7E,UAAM,QAAQ;KAAE,QAAQ;KAAS,OAH/B,OAAO,kBAAkB,aACpB,cAA6C,qBAAqB,MAAM,MAAM,CAAC,GAChF;KACwC,OAAO,KAAA;KAAW;AAChE,UAAM;AACN,UAAA,eAAqB,KAAK;AAC1B,UAAA,2BAAiC,KAAK;;GAExC,kBACE,QACA,kBACS;AACT,UAAA,uBAA6B,QAAQ,eAAe,iBAAiB;;GAEvE,aAAa,WAAgC,KAAK,WAAW,OAAO;GACpE,iBAAiB,YAAgD,KAAK,eAAe,QAAQ;GAC9F;AAED,MAAI;AACF,SAAM,OAAO,IAAI,KAAK,GAAG,KAAK;WACvB,GAAY;GACnB,MAAM,OAAO,mBAAmB;AAChC,OAAI,QAAQ,MAAM;AAChB,UAAM,QAAQ,KAAK;AACnB,UAAM,UAAU,KAAK;AACrB,UAAA,eAAqB,KAAK;;AAE5B,SAAA,yBAA+B,iBAAiB;AAChD,SAAM;;AAGR,OAAK,WAAW,KAAK;;CAGvB,MAAM,OACJ,UACA,GAAG,MACY;EACf,MAAM,mCAAmB,IAAI,KAG1B;EAEH,MAAM,MAAuB;GAC3B,kBACE,QACA,kBACS;AACT,UAAA,uBAA6B,QAAQ,eAAe,iBAAiB;;GAEvE,aAAa,WAAgC,KAAK,WAAW,OAAO;GACpE,iBAAiB,YAAgD,KAAK,eAAe,QAAQ;GAC9F;AAED,MAAI;AACF,SAAM,SAAS,cAAc,KAAK,GAAG,KAAK;WACnC,GAAY;AACnB,SAAA,yBAA+B,iBAAiB;AAChD,SAAM;;;CAMV,MAAS,MAAe,eAAuD;EAC7E,MAAM,QAAQ,MAAA,YAAkB,KAAK;AACrC,QAAA,YAAkB,IAAI,KAAK,EAAE,OAAO;AACpC,QAAM,UAAU;AAKhB,QAAM,QAAQ;GAAE,QAAQ;GAAS,OAH/B,OAAO,kBAAkB,aACpB,cAA6C,qBAAqB,MAAM,MAAM,CAAC,GAChF;GACwC,OAAO,KAAA;GAAW;AAChE,QAAM;AACN,QAAA,eAAqB,KAAK;AAC1B,QAAA,2BAAiC,KAAK;;CAGxC,YAAyB;AACvB,MAAI,MAAA,UAAgB,KAClB,QAAO,MAAA;AAGT,QAAA,SAAe;GACb,MAAS,SAA8B,KAAK,QAAQ,KAAK;GACzD,MAAuC,MAA0B,GAAG,SAClE,KAAK,IAAI,MAAM,GAAG,KAAK;GACzB,SAA0C,GAAmB,GAAG,SAC9D,KAAK,OAAO,GAAG,GAAG,KAAK;GACzB,QAAW,MAAe,kBACxB,KAAK,MAAM,MAAM,cAAmB;GACtC,aAAa,SAA8B,KAAK,WAAW,KAAK;GAChE,iBAAiB,UAA8C,KAAK,eAAe,MAAM;GACzF,YAAe,MAAe,aAC5B,KAAK,UAAU,YAAY;AACzB,aAAS,KAAK,YAAY,KAAK,CAAC;KAChC;GACL;AACD,SAAO,MAAA;;;AAIX,SAAgB,cAAqB;AACnC,QAAO,IAAI,OAAO;;AAGpB,SAAS,aAAa,GAAqB;AACzC,QAAO,aAAa,gBAAgB,EAAE,SAAS;;AAGjD,SAAS,qBAAwB,OAAoC;AACnE,KAAI,MAAM,WAAW,WAAW,MAAM,WAAW,QAC/C,QAAO,MAAM;AAEf,KAAI,MAAM,WAAW,QACnB,QAAO,MAAM"}

package/dist/types-B2mzc3A5.js.map

@@ -1 +1 @@
-{"version":3,"file":"types-B2mzc3A5.js","names":[],"sources":["../src/internal/types.ts"],"sourcesContent":["export const CONFIG = Symbol(\"kvark.config\");\nexport const WRITABLE = Symbol(\"kvark.writable\");\nexport const FAMILY_LINK = Symbol(\"kvark.familyLink\");\n\nexport type AtomState<Value> =\n  | { status: \"pending\"; value: undefined; error: undefined }\n  | { status: \"stale\"; value: Value; error: undefined }\n  | { status: \"fresh\"; value: Value; error: undefined }\n  | { status: \"error\"; value: Value | undefined; error: unknown };\n\nexport type StalePolicy = \"keep\" | \"suspend\" | \"reset\";\n\nexport type AtomContext<Deps extends Record<string, Atom<unknown>>> = {\n  get: <K extends keyof Deps>(key: K) => Promise<AtomValue<Deps[K]>>;\n  signal: AbortSignal;\n};\n\nexport interface WritableAtomContext<\n  Deps extends Record<string, Atom<unknown>>,\n  Value,\n> extends AtomContext<Deps> {\n  setOptimisticValue(value: Value): void;\n  setOptimisticValue(mutate: (prev: Value | undefined) => Value): void;\n}\n\nexport type AtomConfig<\n  Value,\n  Deps extends Record<string, Atom<unknown>>,\n  Args extends readonly unknown[],\n> = {\n  dependencies?: Deps;\n  stalePolicy?: StalePolicy;\n  debugLabel?: string;\n  get: (ctx: AtomContext<Deps>) => Promise<Value>;\n  set?: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n  onMount?: (set: (value: Value) => void) => (() => void) | void;\n};\n\nexport interface InternalAtomConfig<Value> {\n  dependencies?: Record<string, Atom<unknown>>;\n  stalePolicy?: StalePolicy;\n  debugLabel?: string;\n  get: (ctx: AtomContext<Record<string, Atom<unknown>>>) => Promise<Value>;\n  // Internal erased config: `Value` in WritableAtomContext is invariant; `any` matches all atom instantiations.\n  set?: (\n    // oxlint-disable-next-line typescript/no-explicit-any\n    ctx: WritableAtomContext<Record<string, Atom<unknown>>, any>,\n    ...args: readonly unknown[]\n  ) => Promise<void>;\n  onMount?: (set: (value: unknown) => void) => (() => void) | void;\n}\n\nexport interface Atom<out Value> {\n  readonly [CONFIG]: InternalAtomConfig<Value>;\n  readonly debugLabel: string | undefined;\n}\n\nexport interface WritableAtom<\n  out Value,\n  in out Args extends readonly unknown[],\n> extends Atom<Value> {\n  readonly [WRITABLE]: Args;\n}\n\nexport type AtomValue<A> = A extends Atom<infer V> ? V : never;\nexport type IsWritable<A> = A extends WritableAtom<unknown, readonly unknown[]> ? true : false;\nexport type AtomArgs<A> = A extends WritableAtom<unknown, infer Args> ? Args : never;\n"],"mappings":";AAAA,MAAa,SAAS,OAAO,eAAe;AAC5C,MAAa,WAAW,OAAO,iBAAiB;AAChD,MAAa,cAAc,OAAO,mBAAmB"}
+{"version":3,"file":"types-B2mzc3A5.js","names":[],"sources":["../src/internal/types.ts"],"sourcesContent":["export const CONFIG = Symbol(\"kvark.config\");\nexport const WRITABLE = Symbol(\"kvark.writable\");\nexport const FAMILY_LINK = Symbol(\"kvark.familyLink\");\n\nexport type AtomState<Value> =\n  | { status: \"pending\"; value: undefined; error: undefined }\n  | { status: \"stale\"; value: Value; error: undefined }\n  | { status: \"fresh\"; value: Value; error: undefined }\n  | { status: \"error\"; value: Value | undefined; error: unknown };\n\nexport type StalePolicy = \"keep\" | \"suspend\" | \"reset\";\n\nexport type AtomContext<Deps extends Record<string, Atom<unknown>>> = {\n  get: <K extends keyof Deps>(key: K) => Promise<AtomValue<Deps[K]>>;\n  signal: AbortSignal;\n};\n\n/** Context for standalone mutations: optimistic writes and invalidation (no primary atom). */\nexport type MutationContext = {\n  writeOptimistic<U>(atom: Atom<U>, value: U): void;\n  writeOptimistic<U>(atom: Atom<U>, mutate: (prev: U | undefined) => U): void;\n  invalidate(atom: Atom<unknown>): void;\n  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;\n};\n\nexport interface WritableAtomContext<Deps extends Record<string, Atom<unknown>>, Value>\n  extends AtomContext<Deps>, MutationContext {\n  setOptimisticValue(value: Value): void;\n  setOptimisticValue(mutate: (prev: Value | undefined) => Value): void;\n}\n\nexport type AtomConfig<\n  Value,\n  Deps extends Record<string, Atom<unknown>>,\n  Args extends readonly unknown[],\n> = {\n  dependencies?: Deps;\n  stalePolicy?: StalePolicy;\n  debugLabel?: string;\n  get: (ctx: AtomContext<Deps>) => Promise<Value>;\n  set?: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n  onMount?: (set: (value: Value) => void) => (() => void) | void;\n};\n\nexport interface InternalAtomConfig<Value> {\n  dependencies?: Record<string, Atom<unknown>>;\n  stalePolicy?: StalePolicy;\n  debugLabel?: string;\n  get: (ctx: AtomContext<Record<string, Atom<unknown>>>) => Promise<Value>;\n  // Internal erased config: `Value` in WritableAtomContext is invariant; `any` matches all atom instantiations.\n  set?: (\n    // oxlint-disable-next-line typescript/no-explicit-any\n    ctx: WritableAtomContext<Record<string, Atom<unknown>>, any>,\n    ...args: readonly unknown[]\n  ) => Promise<void>;\n  onMount?: (set: (value: unknown) => void) => (() => void) | void;\n}\n\nexport interface Atom<out Value> {\n  readonly [CONFIG]: InternalAtomConfig<Value>;\n  readonly debugLabel: string | undefined;\n}\n\nexport interface WritableAtom<\n  out Value,\n  in out Args extends readonly unknown[],\n> extends Atom<Value> {\n  readonly [WRITABLE]: Args;\n}\n\nexport type AtomValue<A> = A extends Atom<infer V> ? V : never;\nexport type IsWritable<A> = A extends WritableAtom<unknown, readonly unknown[]> ? true : false;\nexport type AtomArgs<A> = A extends WritableAtom<unknown, infer Args> ? Args : never;\n"],"mappings":";AAAA,MAAa,SAAS,OAAO,eAAe;AAC5C,MAAa,WAAW,OAAO,iBAAiB;AAChD,MAAa,cAAc,OAAO,mBAAmB"}

package/dist/vue/index.d.ts

@@ -1,4 +1,4 @@
-import { f as WritableAtom, i as Atom, n as StoreClient, t as Store } from "../store-Cng0OzIQ.js";
+import { h as WritableAtom, i as Mutation, n as StoreClient, o as Atom, t as Store } from "../store-DLoedZQo.js";
 import * as _$vue from "vue";
 import { PropType, ShallowRef } from "vue";
 
@@ -34,6 +34,9 @@ declare function useAtomValue<V>(atom: Atom<V>, opts: {
 //#region src/vue/use-set-atom.d.ts
 declare function useSetAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): (...args: A) => Promise<void>;
 //#endregion
+//#region src/vue/use-mutation.d.ts
+declare function useMutation<Args extends readonly unknown[]>(mutation: Mutation<Args>): (...args: Args) => Promise<void>;
+//#endregion
 //#region src/vue/use-atom.d.ts
 type ThenableAtomTuple<V, A extends readonly unknown[]> = readonly [ThenableShallowRef<V>, (...args: A) => Promise<void>] & PromiseLike<readonly [Readonly<ShallowRef<V>>, (...args: A) => Promise<void>]>;
 declare function useAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): ThenableAtomTuple<V, A>;
@@ -41,5 +44,5 @@ declare function useAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V,
 //#region src/vue/use-atom-context.d.ts
 declare function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R>;
 //#endregion
-export { type ObservedValue, Provider, type ThenableObservedShallowRef, type ThenableShallowRef, useAtom, useAtomContext, useAtomValue, useSetAtom, useStore };
+export { type ObservedValue, Provider, type ThenableObservedShallowRef, type ThenableShallowRef, useAtom, useAtomContext, useAtomValue, useMutation, useSetAtom, useStore };
 //# sourceMappingURL=index.d.ts.map

package/dist/vue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/vue/provider.ts","../../src/vue/use-atom-value.ts","../../src/vue/use-set-atom.ts","../../src/vue/use-atom.ts","../../src/vue/use-atom-context.ts"],"mappings":";;;;;cAKa,QAAA,QAAQ,eAAA,CAGgB,KAAA,CAHhB,gBAAA;;UAGQ,QAAA,CAAS,KAAA;;;sBAHjB,KAAA,CAAA,YAAA;;gIAGgB,KAAA,CAAA,gBAAA;;UAAR,QAAA,CAAS,KAAA;;;;iBAQtB,QAAA,CAAA,GAAY,KAAA;;;KCZhB,aAAA;EACV,KAAA,EAAO,CAAA;EACP,OAAA;EACA,KAAA;AAAA;AAAA,KAGU,kBAAA,MAAwB,QAAA,CAAS,UAAA,CAAW,CAAA,iBACtD,WAAA,CAAY,QAAA,CAAS,UAAA,CAAW,CAAA;AAAA,KAEtB,0BAAA,MAAgC,QAAA,CAAS,UAAA,CAAW,aAAA,CAAc,CAAA,MAC5E,WAAA,CAAY,QAAA,CAAS,UAAA,CAAW,aAAA,CAAc,CAAA;AAAA,iBAEhC,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,kBAAA,CAAmB,CAAA;AAAA,iBACnD,YAAA,GAAA,CACd,IAAA,EAAM,IAAA,CAAK,CAAA,GACX,IAAA;EAAQ,OAAA;AAAA,IACP,0BAAA,CAA2B,CAAA;;;iBCjBd,UAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,QACjB,IAAA,EAAM,CAAA,KAAM,OAAA;;;KCAd,iBAAA,8CACH,kBAAA,CAAmB,CAAA,OACf,IAAA,EAAM,CAAA,KAAM,OAAA,UAEhB,WAAA,WAAsB,QAAA,CAAS,UAAA,CAAW,CAAA,QAAS,IAAA,EAAM,CAAA,KAAM,OAAA;AAAA,iBAEjD,OAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,IACrB,iBAAA,CAAkB,CAAA,EAAG,CAAA;;;iBCVR,cAAA,GAAA,CAAkB,QAAA,GAAW,GAAA,EAAK,WAAA,KAAgB,OAAA,CAAQ,CAAA,UAAW,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/vue/provider.ts","../../src/vue/use-atom-value.ts","../../src/vue/use-set-atom.ts","../../src/vue/use-mutation.ts","../../src/vue/use-atom.ts","../../src/vue/use-atom-context.ts"],"mappings":";;;;;cAKa,QAAA,QAAQ,eAAA,CAGgB,KAAA,CAHhB,gBAAA;;UAGQ,QAAA,CAAS,KAAA;;;sBAHjB,KAAA,CAAA,YAAA;;gIAGgB,KAAA,CAAA,gBAAA;;UAAR,QAAA,CAAS,KAAA;;;;iBAQtB,QAAA,CAAA,GAAY,KAAA;;;KCZhB,aAAA;EACV,KAAA,EAAO,CAAA;EACP,OAAA;EACA,KAAA;AAAA;AAAA,KAGU,kBAAA,MAAwB,QAAA,CAAS,UAAA,CAAW,CAAA,iBACtD,WAAA,CAAY,QAAA,CAAS,UAAA,CAAW,CAAA;AAAA,KAEtB,0BAAA,MAAgC,QAAA,CAAS,UAAA,CAAW,aAAA,CAAc,CAAA,MAC5E,WAAA,CAAY,QAAA,CAAS,UAAA,CAAW,aAAA,CAAc,CAAA;AAAA,iBAEhC,YAAA,GAAA,CAAgB,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,kBAAA,CAAmB,CAAA;AAAA,iBACnD,YAAA,GAAA,CACd,IAAA,EAAM,IAAA,CAAK,CAAA,GACX,IAAA;EAAQ,OAAA;AAAA,IACP,0BAAA,CAA2B,CAAA;;;iBCjBd,UAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,QACjB,IAAA,EAAM,CAAA,KAAM,OAAA;;;iBCFH,WAAA,iCAAA,CACd,QAAA,EAAU,QAAA,CAAS,IAAA,QACd,IAAA,EAAM,IAAA,KAAS,OAAA;;;KCAjB,iBAAA,8CACH,kBAAA,CAAmB,CAAA,OACf,IAAA,EAAM,CAAA,KAAM,OAAA,UAEhB,WAAA,WAAsB,QAAA,CAAS,UAAA,CAAW,CAAA,QAAS,IAAA,EAAM,CAAA,KAAM,OAAA;AAAA,iBAEjD,OAAA,iCAAA,CACd,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,IACrB,iBAAA,CAAkB,CAAA,EAAG,CAAA;;;iBCVR,cAAA,GAAA,CAAkB,QAAA,GAAW,GAAA,EAAK,WAAA,KAAgB,OAAA,CAAQ,CAAA,UAAW,OAAA,CAAQ,CAAA"}

package/dist/vue/index.js

@@ -74,6 +74,12 @@ function useSetAtom(atom) {
 	return (...args) => store.set(atom, ...args);
 }
 //#endregion
+//#region src/vue/use-mutation.ts
+function useMutation(mutation) {
+	const store = useStore();
+	return (...args) => store.mutate(mutation, ...args);
+}
+//#endregion
 //#region src/vue/use-atom.ts
 function useAtom(atom) {
 	const value = useAtomValue(atom);
@@ -89,6 +95,6 @@ function useAtomContext(callback) {
 	return () => callback(store.getClient());
 }
 //#endregion
-export { Provider, useAtom, useAtomContext, useAtomValue, useSetAtom, useStore };
+export { Provider, useAtom, useAtomContext, useAtomValue, useMutation, useSetAtom, useStore };
 
 //# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/vue/provider.ts","../../src/vue/use-atom-value.ts","../../src/vue/use-set-atom.ts","../../src/vue/use-atom.ts","../../src/vue/use-atom-context.ts"],"sourcesContent":["import { type InjectionKey, type PropType, defineComponent, inject, provide } from \"vue\";\nimport type { Store } from \"@/internal/store.js\";\n\nconst StoreKey: InjectionKey<Store> = Symbol(\"kvark-store\");\n\nexport const Provider = defineComponent({\n  name: \"KvarkProvider\",\n  props: {\n    store: { type: Object as PropType<Store>, required: true },\n  },\n  setup(props, { slots }) {\n    provide(StoreKey, props.store);\n    return () => slots[\"default\"]?.();\n  },\n});\n\nexport function useStore(): Store {\n  const store = inject(StoreKey);\n  if (store == null) {\n    throw new Error(\"useStore must be used within a <Provider>\");\n  }\n  return store;\n}\n","import { type ShallowRef, readonly, shallowRef, watchEffect } from \"vue\";\nimport type { Atom, AtomState } from \"@/internal/types.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport type ObservedValue<V> = {\n  value: V | undefined;\n  isStale: boolean;\n  error: unknown;\n};\n\nexport type ThenableShallowRef<V> = Readonly<ShallowRef<V | undefined>> &\n  PromiseLike<Readonly<ShallowRef<V>>>;\n\nexport type ThenableObservedShallowRef<V> = Readonly<ShallowRef<ObservedValue<V>>> &\n  PromiseLike<Readonly<ShallowRef<ObservedValue<V>>>>;\n\nexport function useAtomValue<V>(atom: Atom<V>): ThenableShallowRef<V>;\nexport function useAtomValue<V>(\n  atom: Atom<V>,\n  opts: { observe: true },\n): ThenableObservedShallowRef<V>;\nexport function useAtomValue<V>(\n  atom: Atom<V>,\n  opts?: { observe: true },\n): ThenableShallowRef<V> | ThenableObservedShallowRef<V> {\n  const store = useStore();\n\n  function derive(snapshot: AtomState<V>): V | ObservedValue<V> {\n    if (snapshot.status === \"pending\") {\n      void store.resolve(atom);\n      if (opts?.observe === true) {\n        return { value: undefined as V, isStale: false, error: undefined };\n      }\n      return undefined as V;\n    }\n\n    if (snapshot.status === \"stale\") {\n      void store.resolve(atom);\n      if (opts?.observe === true) {\n        return { value: snapshot.value, isStale: true, error: undefined };\n      }\n      return snapshot.value;\n    }\n\n    if (snapshot.status === \"error\") {\n      if (opts?.observe === true && snapshot.value !== undefined) {\n        return { value: snapshot.value as V, isStale: false, error: snapshot.error };\n      }\n      throw snapshot.error;\n    }\n\n    // status === \"fresh\"\n    if (opts?.observe === true) {\n      return { value: snapshot.value, isStale: false, error: undefined };\n    }\n    return snapshot.value;\n  }\n\n  const result = shallowRef(derive(store.getSnapshot(atom)));\n\n  watchEffect((onCleanup) => {\n    const unsub = store.subscribe(atom, () => {\n      result.value = derive(store.getSnapshot(atom));\n    });\n    onCleanup(unsub);\n  });\n\n  const ref = readonly(result);\n\n  return new Proxy(ref, {\n    get(target, prop, receiver) {\n      if (prop === \"then\") {\n        return (onFulfilled?: (v: unknown) => unknown, onRejected?: (e: unknown) => unknown) =>\n          store\n            .resolve(atom)\n            .then(() => ref, onRejected)\n            .then(onFulfilled as never);\n      }\n      return Reflect.get(target, prop, receiver);\n    },\n  }) as ThenableShallowRef<V> | ThenableObservedShallowRef<V>;\n}\n","import type { WritableAtom } from \"@/internal/types.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport function useSetAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): (...args: A) => Promise<void> {\n  const store = useStore();\n  return (...args: A): Promise<void> => store.set(atom, ...args);\n}\n","import type { ShallowRef } from \"vue\";\nimport type { WritableAtom } from \"@/internal/types.js\";\nimport { type ThenableShallowRef, useAtomValue } from \"@/vue/use-atom-value.js\";\nimport { useSetAtom } from \"@/vue/use-set-atom.js\";\n\ntype ThenableAtomTuple<V, A extends readonly unknown[]> = readonly [\n  ThenableShallowRef<V>,\n  (...args: A) => Promise<void>,\n] &\n  PromiseLike<readonly [Readonly<ShallowRef<V>>, (...args: A) => Promise<void>]>;\n\nexport function useAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): ThenableAtomTuple<V, A> {\n  const value = useAtomValue(atom);\n  const setter = useSetAtom(atom);\n  const tuple = [value, setter] as const;\n\n  return Object.assign(tuple, {\n    // oxlint-disable-next-line unicorn/no-thenable -- PromiseLike for await useAtom()\n    then(onFulfilled?: (v: typeof tuple) => unknown, onRejected?: (e: unknown) => unknown) {\n      return Promise.resolve(value)\n        .then(() => [value, setter] as const, onRejected)\n        .then(onFulfilled as never);\n    },\n  }) as ThenableAtomTuple<V, A>;\n}\n","import type { StoreClient } from \"@/internal/store.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R> {\n  const store = useStore();\n  return (): Promise<R> => callback(store.getClient());\n}\n"],"mappings":";;AAGA,MAAM,WAAgC,OAAO,cAAc;AAE3D,MAAa,WAAW,gBAAgB;CACtC,MAAM;CACN,OAAO,EACL,OAAO;EAAE,MAAM;EAA2B,UAAU;EAAM,EAC3D;CACD,MAAM,OAAO,EAAE,SAAS;AACtB,UAAQ,UAAU,MAAM,MAAM;AAC9B,eAAa,MAAM,cAAc;;CAEpC,CAAC;AAEF,SAAgB,WAAkB;CAChC,MAAM,QAAQ,OAAO,SAAS;AAC9B,KAAI,SAAS,KACX,OAAM,IAAI,MAAM,4CAA4C;AAE9D,QAAO;;;;ACAT,SAAgB,aACd,MACA,MACuD;CACvD,MAAM,QAAQ,UAAU;CAExB,SAAS,OAAO,UAA8C;AAC5D,MAAI,SAAS,WAAW,WAAW;AAC5B,SAAM,QAAQ,KAAK;AACxB,OAAI,MAAM,YAAY,KACpB,QAAO;IAAE,OAAO,KAAA;IAAgB,SAAS;IAAO,OAAO,KAAA;IAAW;AAEpE;;AAGF,MAAI,SAAS,WAAW,SAAS;AAC1B,SAAM,QAAQ,KAAK;AACxB,OAAI,MAAM,YAAY,KACpB,QAAO;IAAE,OAAO,SAAS;IAAO,SAAS;IAAM,OAAO,KAAA;IAAW;AAEnE,UAAO,SAAS;;AAGlB,MAAI,SAAS,WAAW,SAAS;AAC/B,OAAI,MAAM,YAAY,QAAQ,SAAS,UAAU,KAAA,EAC/C,QAAO;IAAE,OAAO,SAAS;IAAY,SAAS;IAAO,OAAO,SAAS;IAAO;AAE9E,SAAM,SAAS;;AAIjB,MAAI,MAAM,YAAY,KACpB,QAAO;GAAE,OAAO,SAAS;GAAO,SAAS;GAAO,OAAO,KAAA;GAAW;AAEpE,SAAO,SAAS;;CAGlB,MAAM,SAAS,WAAW,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC;AAE1D,cAAa,cAAc;AAIzB,YAHc,MAAM,UAAU,YAAY;AACxC,UAAO,QAAQ,OAAO,MAAM,YAAY,KAAK,CAAC;IAC9C,CACc;GAChB;CAEF,MAAM,MAAM,SAAS,OAAO;AAE5B,QAAO,IAAI,MAAM,KAAK,EACpB,IAAI,QAAQ,MAAM,UAAU;AAC1B,MAAI,SAAS,OACX,SAAQ,aAAuC,eAC7C,MACG,QAAQ,KAAK,CACb,WAAW,KAAK,WAAW,CAC3B,KAAK,YAAqB;AAEjC,SAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;IAE7C,CAAC;;;;AC7EJ,SAAgB,WACd,MAC+B;CAC/B,MAAM,QAAQ,UAAU;AACxB,SAAQ,GAAG,SAA2B,MAAM,IAAI,MAAM,GAAG,KAAK;;;;ACIhE,SAAgB,QACd,MACyB;CACzB,MAAM,QAAQ,aAAa,KAAK;CAChC,MAAM,SAAS,WAAW,KAAK;AAG/B,QAAO,OAAO,OAFA,CAAC,OAAO,OAAO,EAED,EAE1B,KAAK,aAA4C,YAAsC;AACrF,SAAO,QAAQ,QAAQ,MAAM,CAC1B,WAAW,CAAC,OAAO,OAAO,EAAW,WAAW,CAChD,KAAK,YAAqB;IAEhC,CAAC;;;;ACtBJ,SAAgB,eAAkB,UAA8D;CAC9F,MAAM,QAAQ,UAAU;AACxB,cAAyB,SAAS,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/vue/provider.ts","../../src/vue/use-atom-value.ts","../../src/vue/use-set-atom.ts","../../src/vue/use-mutation.ts","../../src/vue/use-atom.ts","../../src/vue/use-atom-context.ts"],"sourcesContent":["import { type InjectionKey, type PropType, defineComponent, inject, provide } from \"vue\";\nimport type { Store } from \"@/internal/store.js\";\n\nconst StoreKey: InjectionKey<Store> = Symbol(\"kvark-store\");\n\nexport const Provider = defineComponent({\n  name: \"KvarkProvider\",\n  props: {\n    store: { type: Object as PropType<Store>, required: true },\n  },\n  setup(props, { slots }) {\n    provide(StoreKey, props.store);\n    return () => slots[\"default\"]?.();\n  },\n});\n\nexport function useStore(): Store {\n  const store = inject(StoreKey);\n  if (store == null) {\n    throw new Error(\"useStore must be used within a <Provider>\");\n  }\n  return store;\n}\n","import { type ShallowRef, readonly, shallowRef, watchEffect } from \"vue\";\nimport type { Atom, AtomState } from \"@/internal/types.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport type ObservedValue<V> = {\n  value: V | undefined;\n  isStale: boolean;\n  error: unknown;\n};\n\nexport type ThenableShallowRef<V> = Readonly<ShallowRef<V | undefined>> &\n  PromiseLike<Readonly<ShallowRef<V>>>;\n\nexport type ThenableObservedShallowRef<V> = Readonly<ShallowRef<ObservedValue<V>>> &\n  PromiseLike<Readonly<ShallowRef<ObservedValue<V>>>>;\n\nexport function useAtomValue<V>(atom: Atom<V>): ThenableShallowRef<V>;\nexport function useAtomValue<V>(\n  atom: Atom<V>,\n  opts: { observe: true },\n): ThenableObservedShallowRef<V>;\nexport function useAtomValue<V>(\n  atom: Atom<V>,\n  opts?: { observe: true },\n): ThenableShallowRef<V> | ThenableObservedShallowRef<V> {\n  const store = useStore();\n\n  function derive(snapshot: AtomState<V>): V | ObservedValue<V> {\n    if (snapshot.status === \"pending\") {\n      void store.resolve(atom);\n      if (opts?.observe === true) {\n        return { value: undefined as V, isStale: false, error: undefined };\n      }\n      return undefined as V;\n    }\n\n    if (snapshot.status === \"stale\") {\n      void store.resolve(atom);\n      if (opts?.observe === true) {\n        return { value: snapshot.value, isStale: true, error: undefined };\n      }\n      return snapshot.value;\n    }\n\n    if (snapshot.status === \"error\") {\n      if (opts?.observe === true && snapshot.value !== undefined) {\n        return { value: snapshot.value as V, isStale: false, error: snapshot.error };\n      }\n      throw snapshot.error;\n    }\n\n    // status === \"fresh\"\n    if (opts?.observe === true) {\n      return { value: snapshot.value, isStale: false, error: undefined };\n    }\n    return snapshot.value;\n  }\n\n  const result = shallowRef(derive(store.getSnapshot(atom)));\n\n  watchEffect((onCleanup) => {\n    const unsub = store.subscribe(atom, () => {\n      result.value = derive(store.getSnapshot(atom));\n    });\n    onCleanup(unsub);\n  });\n\n  const ref = readonly(result);\n\n  return new Proxy(ref, {\n    get(target, prop, receiver) {\n      if (prop === \"then\") {\n        return (onFulfilled?: (v: unknown) => unknown, onRejected?: (e: unknown) => unknown) =>\n          store\n            .resolve(atom)\n            .then(() => ref, onRejected)\n            .then(onFulfilled as never);\n      }\n      return Reflect.get(target, prop, receiver);\n    },\n  }) as ThenableShallowRef<V> | ThenableObservedShallowRef<V>;\n}\n","import type { WritableAtom } from \"@/internal/types.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport function useSetAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): (...args: A) => Promise<void> {\n  const store = useStore();\n  return (...args: A): Promise<void> => store.set(atom, ...args);\n}\n","import type { Mutation } from \"@/internal/mutation.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport function useMutation<Args extends readonly unknown[]>(\n  mutation: Mutation<Args>,\n): (...args: Args) => Promise<void> {\n  const store = useStore();\n  return (...args: Args): Promise<void> => store.mutate(mutation, ...args);\n}\n","import type { ShallowRef } from \"vue\";\nimport type { WritableAtom } from \"@/internal/types.js\";\nimport { type ThenableShallowRef, useAtomValue } from \"@/vue/use-atom-value.js\";\nimport { useSetAtom } from \"@/vue/use-set-atom.js\";\n\ntype ThenableAtomTuple<V, A extends readonly unknown[]> = readonly [\n  ThenableShallowRef<V>,\n  (...args: A) => Promise<void>,\n] &\n  PromiseLike<readonly [Readonly<ShallowRef<V>>, (...args: A) => Promise<void>]>;\n\nexport function useAtom<V, A extends readonly unknown[]>(\n  atom: WritableAtom<V, A>,\n): ThenableAtomTuple<V, A> {\n  const value = useAtomValue(atom);\n  const setter = useSetAtom(atom);\n  const tuple = [value, setter] as const;\n\n  return Object.assign(tuple, {\n    // oxlint-disable-next-line unicorn/no-thenable -- PromiseLike for await useAtom()\n    then(onFulfilled?: (v: typeof tuple) => unknown, onRejected?: (e: unknown) => unknown) {\n      return Promise.resolve(value)\n        .then(() => [value, setter] as const, onRejected)\n        .then(onFulfilled as never);\n    },\n  }) as ThenableAtomTuple<V, A>;\n}\n","import type { StoreClient } from \"@/internal/store.js\";\nimport { useStore } from \"@/vue/provider.js\";\n\nexport function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R> {\n  const store = useStore();\n  return (): Promise<R> => callback(store.getClient());\n}\n"],"mappings":";;AAGA,MAAM,WAAgC,OAAO,cAAc;AAE3D,MAAa,WAAW,gBAAgB;CACtC,MAAM;CACN,OAAO,EACL,OAAO;EAAE,MAAM;EAA2B,UAAU;EAAM,EAC3D;CACD,MAAM,OAAO,EAAE,SAAS;AACtB,UAAQ,UAAU,MAAM,MAAM;AAC9B,eAAa,MAAM,cAAc;;CAEpC,CAAC;AAEF,SAAgB,WAAkB;CAChC,MAAM,QAAQ,OAAO,SAAS;AAC9B,KAAI,SAAS,KACX,OAAM,IAAI,MAAM,4CAA4C;AAE9D,QAAO;;;;ACAT,SAAgB,aACd,MACA,MACuD;CACvD,MAAM,QAAQ,UAAU;CAExB,SAAS,OAAO,UAA8C;AAC5D,MAAI,SAAS,WAAW,WAAW;AAC5B,SAAM,QAAQ,KAAK;AACxB,OAAI,MAAM,YAAY,KACpB,QAAO;IAAE,OAAO,KAAA;IAAgB,SAAS;IAAO,OAAO,KAAA;IAAW;AAEpE;;AAGF,MAAI,SAAS,WAAW,SAAS;AAC1B,SAAM,QAAQ,KAAK;AACxB,OAAI,MAAM,YAAY,KACpB,QAAO;IAAE,OAAO,SAAS;IAAO,SAAS;IAAM,OAAO,KAAA;IAAW;AAEnE,UAAO,SAAS;;AAGlB,MAAI,SAAS,WAAW,SAAS;AAC/B,OAAI,MAAM,YAAY,QAAQ,SAAS,UAAU,KAAA,EAC/C,QAAO;IAAE,OAAO,SAAS;IAAY,SAAS;IAAO,OAAO,SAAS;IAAO;AAE9E,SAAM,SAAS;;AAIjB,MAAI,MAAM,YAAY,KACpB,QAAO;GAAE,OAAO,SAAS;GAAO,SAAS;GAAO,OAAO,KAAA;GAAW;AAEpE,SAAO,SAAS;;CAGlB,MAAM,SAAS,WAAW,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC;AAE1D,cAAa,cAAc;AAIzB,YAHc,MAAM,UAAU,YAAY;AACxC,UAAO,QAAQ,OAAO,MAAM,YAAY,KAAK,CAAC;IAC9C,CACc;GAChB;CAEF,MAAM,MAAM,SAAS,OAAO;AAE5B,QAAO,IAAI,MAAM,KAAK,EACpB,IAAI,QAAQ,MAAM,UAAU;AAC1B,MAAI,SAAS,OACX,SAAQ,aAAuC,eAC7C,MACG,QAAQ,KAAK,CACb,WAAW,KAAK,WAAW,CAC3B,KAAK,YAAqB;AAEjC,SAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;IAE7C,CAAC;;;;AC7EJ,SAAgB,WACd,MAC+B;CAC/B,MAAM,QAAQ,UAAU;AACxB,SAAQ,GAAG,SAA2B,MAAM,IAAI,MAAM,GAAG,KAAK;;;;ACJhE,SAAgB,YACd,UACkC;CAClC,MAAM,QAAQ,UAAU;AACxB,SAAQ,GAAG,SAA8B,MAAM,OAAO,UAAU,GAAG,KAAK;;;;ACI1E,SAAgB,QACd,MACyB;CACzB,MAAM,QAAQ,aAAa,KAAK;CAChC,MAAM,SAAS,WAAW,KAAK;AAG/B,QAAO,OAAO,OAFA,CAAC,OAAO,OAAO,EAED,EAE1B,KAAK,aAA4C,YAAsC;AACrF,SAAO,QAAQ,QAAQ,MAAM,CAC1B,WAAW,CAAC,OAAO,OAAO,EAAW,WAAW,CAChD,KAAK,YAAqB;IAEhC,CAAC;;;;ACtBJ,SAAgB,eAAkB,UAA8D;CAC9F,MAAM,QAAQ,UAAU;AACxB,cAAyB,SAAS,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kdeveloper/kvark",
-  "version": "0.6.9",
+  "version": "0.8.0",
   "description": "Atomic state management with explicit dependency graphs",
   "license": "MIT",
   "files": [
@@ -19,6 +19,10 @@
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
     },
+    "./preact": {
+      "types": "./dist/preact/index.d.ts",
+      "import": "./dist/preact/index.js"
+    },
     "./vue": {
       "types": "./dist/vue/index.d.ts",
       "import": "./dist/vue/index.js"
@@ -30,6 +34,7 @@
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
+    "@testing-library/preact": "^3.2.4",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
@@ -39,6 +44,7 @@
     "oxfmt": "^0.42.0",
     "oxlint": "^1.57.0",
     "oxlint-tsgolint": "^0.18.1",
+    "preact": "^10.29.0",
     "react": ">=18",
     "react-dom": "^19.2.4",
     "tsdown": "^0.21.7",
@@ -47,6 +53,7 @@
     "vue": "^3.5.31"
   },
   "peerDependencies": {
+    "preact": ">=10",
     "react": ">=18",
     "vue": ">=3.4"
   },
@@ -54,6 +61,9 @@
     "react": {
       "optional": true
     },
+    "preact": {
+      "optional": true
+    },
     "vue": {
       "optional": true
     }

package/dist/store-Cng0OzIQ.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store-Cng0OzIQ.d.ts","names":[],"sources":["../src/internal/types.ts","../src/internal/store.ts"],"mappings":";cAAa,MAAA;AAAA,cACA,QAAA;AAAA,KAGD,SAAA;EACN,MAAA;EAAmB,KAAA;EAAkB,KAAA;AAAA;EACrC,MAAA;EAAiB,KAAA,EAAO,KAAA;EAAO,KAAA;AAAA;EAC/B,MAAA;EAAiB,KAAA,EAAO,KAAA;EAAO,KAAA;AAAA;EAC/B,MAAA;EAAiB,KAAA,EAAO,KAAA;EAAmB,KAAA;AAAA;AAAA,KAErC,WAAA;AAAA,KAEA,WAAA,cAAyB,MAAA,SAAe,IAAA;EAClD,GAAA,mBAAsB,IAAA,EAAM,GAAA,EAAK,CAAA,KAAM,OAAA,CAAQ,SAAA,CAAU,IAAA,CAAK,CAAA;EAC9D,MAAA,EAAQ,WAAA;AAAA;AAAA,UAGO,mBAAA,cACF,MAAA,SAAe,IAAA,2BAEpB,WAAA,CAAY,IAAA;EACpB,kBAAA,CAAmB,KAAA,EAAO,KAAA;EAC1B,kBAAA,CAAmB,MAAA,GAAS,IAAA,EAAM,KAAA,iBAAsB,KAAA;AAAA;AAAA,KAG9C,UAAA,qBAEG,MAAA,SAAe,IAAA;EAG5B,YAAA,GAAe,IAAA;EACf,WAAA,GAAc,WAAA;EACd,UAAA;EACA,GAAA,GAAM,GAAA,EAAK,WAAA,CAAY,IAAA,MAAU,OAAA,CAAQ,KAAA;EACzC,GAAA,IAAO,GAAA,EAAK,mBAAA,CAAoB,IAAA,EAAM,KAAA,MAAW,IAAA,EAAM,IAAA,KAAS,OAAA;EAChE,OAAA,IAAW,GAAA,GAAM,KAAA,EAAO,KAAA;AAAA;AAAA,UAGT,kBAAA;EACf,YAAA,GAAe,MAAA,SAAe,IAAA;EAC9B,WAAA,GAAc,WAAA;EACd,UAAA;EACA,GAAA,GAAM,GAAA,EAAK,WAAA,CAAY,MAAA,SAAe,IAAA,gBAAoB,OAAA,CAAQ,KAAA;EAElE,GAAA,IAEE,GAAA,EAAK,mBAAA,CAAoB,MAAA,SAAe,IAAA,qBACrC,IAAA,yBACA,OAAA;EACL,OAAA,IAAW,GAAA,GAAM,KAAA;AAAA;AAAA,UAGF,IAAA;EAAA,UACL,MAAA,GAAS,kBAAA,CAAmB,KAAA;EAAA,SAC7B,UAAA;AAAA;AAAA,UAGM,YAAA,4DAGP,IAAA,CAAK,KAAA;EAAA,UACH,QAAA,GAAW,IAAA;AAAA;AAAA,KAGX,SAAA,MAAe,CAAA,SAAU,IAAA,YAAgB,CAAA;AAAA,KACzC,UAAA,MAAgB,CAAA,SAAU,YAAA;AAAA,KAC1B,QAAA,MAAc,CAAA,SAAU,YAAA,wBAAoC,IAAA;;;UC7CvD,WAAA;EACf,GAAA,IAAO,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,OAAA,CAAQ,CAAA;EAC/B,GAAA,kCAAqC,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,MAAO,IAAA,EAAM,CAAA,GAAI,OAAA;EAC5E,KAAA,IAAS,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,KAAA,EAAO,CAAA;EAC/B,KAAA,IAAS,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,MAAA,GAAS,IAAA,EAAM,CAAA,iBAAkB,CAAA;EACzD,UAAA,CAAW,IAAA,EAAM,IAAA;EACjB,cAAA,CAAe,KAAA,EAAO,aAAA,CAAc,IAAA;EACpC,SAAA,IAAa,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,QAAA,GAAW,KAAA,EAAO,SAAA,CAAU,CAAA;AAAA;AAAA,cAS7C,KAAA;EAAA;EA0BX,OAAA,GAAA,CAAW,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,OAAA,CAAQ,CAAA;EAsDnC,UAAA,CAAW,IAAA,EAAM,IAAA;EAMjB,cAAA,CAAe,KAAA,EAAO,aAAA,CAAc,IAAA;EAkHpC,SAAA,GAAA,CAAa,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,QAAA;EAmD5B,WAAA,GAAA,CAAe,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,SAAA,CAAU,CAAA;EAIzC,iBAAA,GAAA,CAAqB,IAAA,EAAM,IAAA,CAAK,CAAA,IAAK,SAAA,CAAU,CAAA;EAQzC,GAAA,iCAAA,CAAqC,IAAA,EAAM,YAAA,CAAa,CAAA,EAAG,CAAA,MAAO,IAAA,EAAM,CAAA,GAAI,OAAA;EAiDlF,KAAA,GAAA,CAAS,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,KAAA,EAAO,CAAA;EAC/B,KAAA,GAAA,CAAS,IAAA,EAAM,IAAA,CAAK,CAAA,GAAI,MAAA,GAAS,IAAA,EAAM,CAAA,iBAAkB,CAAA;EAezD,SAAA,CAAA,GAAa,WAAA;AAAA;AAAA,iBAsBC,WAAA,CAAA,GAAe,KAAA"}

package/dist/store-DuKg4_ng.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"store-DuKg4_ng.js","names":["#maxSize","#nodeMap","#valueMap","#head","#tail","#moveToMru","#insertBeforeTail","#evict","#detach","#atoms","#rdeps","#pending","#controllers","#familyUnsubs","#registeredFamilies","#getOrCreate","#runGet","#registerRdeps","#makeCtx","#scheduleNotify","#markStale","#schedulePendingFlush","#flushScheduled","#flushPending","#autoRegisterFamily","#markReverseDependentsStale","#client"],"sources":["../src/internal/atom.ts","../src/internal/lru-cache.ts","../src/internal/family.ts","../src/internal/store.ts"],"sourcesContent":["import type {\n  Atom,\n  AtomConfig,\n  InternalAtomConfig,\n  WritableAtom,\n  WritableAtomContext,\n} from \"@/internal/types.js\";\nimport { CONFIG, WRITABLE } from \"@/internal/types.js\";\n\ntype WritableConfig<\n  Value,\n  Deps extends Record<string, Atom<unknown>>,\n  Args extends readonly unknown[],\n> = AtomConfig<Value, Deps, Args> & {\n  set: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;\n};\n\ntype ReadonlyConfig<Value, Deps extends Record<string, Atom<unknown>>> = Omit<\n  AtomConfig<Value, Deps, readonly []>,\n  \"set\"\n>;\n\nexport function atom<\n  Value,\n  Deps extends Record<string, Atom<unknown>> = Record<never, never>,\n  Args extends readonly unknown[] = readonly [],\n>(config: WritableConfig<Value, Deps, Args>): WritableAtom<Value, Args>;\n\nexport function atom<Value, Deps extends Record<string, Atom<unknown>> = Record<never, never>>(\n  config: ReadonlyConfig<Value, Deps>,\n): Atom<Value>;\n\nexport function atom<\n  Value,\n  Deps extends Record<string, Atom<unknown>> = Record<never, never>,\n  Args extends readonly unknown[] = readonly [],\n>(config: AtomConfig<Value, Deps, Args>): Atom<Value> {\n  const internal: InternalAtomConfig<Value> = Object.create(null) as InternalAtomConfig<Value>;\n  internal.get = config.get as InternalAtomConfig<Value>[\"get\"];\n\n  if (config.debugLabel != null) {\n    internal.debugLabel = config.debugLabel;\n  }\n  if (config.dependencies != null) {\n    internal.dependencies = config.dependencies as Record<string, Atom<unknown>>;\n  }\n  if (config.stalePolicy != null) {\n    internal.stalePolicy = config.stalePolicy;\n  }\n  if (config.set != null) {\n    internal.set = config.set as NonNullable<InternalAtomConfig<Value>[\"set\"]>;\n  }\n  if (config.onMount != null) {\n    internal.onMount = config.onMount as NonNullable<InternalAtomConfig<Value>[\"onMount\"]>;\n  }\n\n  if (config.set != null) {\n    return {\n      [CONFIG]: internal,\n      [WRITABLE]: [] as unknown as Args,\n      debugLabel: config.debugLabel,\n    } as unknown as Atom<Value>;\n  }\n\n  return {\n    [CONFIG]: internal,\n    debugLabel: config.debugLabel,\n  } as Atom<Value>;\n}\n","type LruNode<K> = {\n  key: K;\n  prev: LruNode<K> | null;\n  next: LruNode<K> | null;\n};\n\n/**\n * Fixed-capacity cache with O(1) get, set, delete and LRU eviction.\n *\n * Pass `maxSize: Infinity` to disable eviction (keep-all semantics).\n *\n * LRU end (oldest): head.next — MRU end (newest): tail.prev.\n */\nexport class LruCache<K, V> {\n  readonly #maxSize: number;\n  readonly #nodeMap = new Map<K, LruNode<K>>();\n  readonly #valueMap = new Map<K, V>();\n  readonly #head: LruNode<K>;\n  readonly #tail: LruNode<K>;\n\n  constructor(maxSize: number) {\n    this.#maxSize = maxSize;\n    this.#head = { key: undefined as unknown as K, prev: null, next: null };\n    this.#tail = { key: undefined as unknown as K, prev: this.#head, next: null };\n    this.#head.next = this.#tail;\n  }\n\n  /** Returns the value and marks the entry as most-recently used. */\n  get(key: K): V | undefined {\n    const node = this.#nodeMap.get(key);\n    if (node == null) {\n      return undefined;\n    }\n    this.#moveToMru(node);\n    return this.#valueMap.get(key);\n  }\n\n  /** Returns the value without affecting LRU order. */\n  peek(key: K): V | undefined {\n    return this.#valueMap.get(key);\n  }\n\n  /** Inserts or updates a value and evicts the LRU entry if over capacity. */\n  set(key: K, value: V): void {\n    const existing = this.#nodeMap.get(key);\n    if (existing != null) {\n      this.#valueMap.set(key, value);\n      this.#moveToMru(existing);\n      return;\n    }\n\n    const node: LruNode<K> = { key, prev: null, next: null };\n    this.#nodeMap.set(key, node);\n    this.#valueMap.set(key, value);\n    this.#insertBeforeTail(node);\n    this.#evict();\n  }\n\n  delete(key: K): void {\n    const node = this.#nodeMap.get(key);\n    if (node == null) {\n      return;\n    }\n    this.#detach(node);\n    this.#nodeMap.delete(key);\n    this.#valueMap.delete(key);\n  }\n\n  values(): IterableIterator<V> {\n    return this.#valueMap.values();\n  }\n\n  /** Returns a live read-only view of the underlying map. */\n  asReadonlyMap(): ReadonlyMap<K, V> {\n    return this.#valueMap;\n  }\n\n  #moveToMru(node: LruNode<K>): void {\n    this.#detach(node);\n    this.#insertBeforeTail(node);\n  }\n\n  #detach(node: LruNode<K>): void {\n    const { prev, next } = node;\n    if (prev == null || next == null) {\n      return;\n    }\n    prev.next = next;\n    next.prev = prev;\n  }\n\n  #insertBeforeTail(node: LruNode<K>): void {\n    const before = this.#tail.prev;\n    if (before == null) {\n      return;\n    }\n    before.next = node;\n    node.prev = before;\n    node.next = this.#tail;\n    this.#tail.prev = node;\n  }\n\n  #evict(): void {\n    if (!Number.isFinite(this.#maxSize)) {\n      return;\n    }\n    while (this.#nodeMap.size > this.#maxSize) {\n      const oldest = this.#head.next;\n      if (oldest == null) {\n        break;\n      }\n      this.#detach(oldest);\n      this.#nodeMap.delete(oldest.key);\n      this.#valueMap.delete(oldest.key);\n    }\n  }\n}\n","import type { Atom, AtomContext, StalePolicy } from \"@/internal/types.js\";\nimport { FAMILY_LINK } from \"@/internal/types.js\";\nimport { atom } from \"@/internal/atom.js\";\nimport { LruCache } from \"@/internal/lru-cache.js\";\n\nexport type AtomFamilyOptions<\n  Param,\n  Value,\n  Deps extends Record<string, Atom<unknown>>,\n  Args extends readonly unknown[],\n  Key = Param,\n> = {\n  dependencies?: (param: Param) => Deps;\n  stalePolicy?: StalePolicy;\n  cachePolicy?: \"keep-all\" | \"lru\";\n  lruSize?: number;\n  debugLabel?: string;\n  /**\n   * Optional function to derive a stable cache key from `param`.\n   * Use when `Param` is an object and you want equality-by-value semantics.\n   * The returned key is used for all cache operations (get, set, LRU, invalidate, remove).\n   * The original `param` is still passed to `get`, `set`, and `dependencies`.\n   *\n   * For plain objects/arrays you can use `stableFamilyKey` from `@kdeveloper/kvark/family`.\n   * Treat the param object as immutable after the first call — `stableFamilyKey` memoises\n   * by object reference via a WeakMap.\n   */\n  paramKey?: (param: Param) => Key;\n  get: (param: Param) => (ctx: AtomContext<Deps>) => Promise<Value>;\n  set?: (param: Param) => (ctx: AtomContext<Deps>, ...args: Args) => Promise<void>;\n};\n\nexport interface AtomFamily<Param, Value, Key = Param> {\n  (param: Param): Atom<Value>;\n  invalidate(param: Param): void;\n  invalidateAll(): void;\n  remove(param: Param): void;\n  getCache(): ReadonlyMap<Key, Atom<Value>>;\n}\n\nexport interface FamilyLink {\n  invalidateAtom: (atom: Atom<unknown>) => void;\n  registerStore: (cb: (atom: Atom<unknown>) => void) => () => void;\n}\n\nexport function getFamilyLink(target: Atom<unknown>): FamilyLink | undefined {\n  return (target as unknown as Record<symbol, FamilyLink | undefined>)[FAMILY_LINK];\n}\n\nexport function atomFamily<\n  Param,\n  Value,\n  Deps extends Record<string, Atom<unknown>> = Record<never, never>,\n  Args extends readonly unknown[] = readonly [],\n  Key = Param,\n>(options: AtomFamilyOptions<Param, Value, Deps, Args, Key>): AtomFamily<Param, Value, Key> {\n  const maxSize = options.cachePolicy === \"lru\" ? (options.lruSize ?? 100) : Infinity;\n  const cache = new LruCache<Key, Atom<Value>>(maxSize);\n  const storeCallbacks = new Set<(atom: Atom<unknown>) => void>();\n\n  function keyOf(param: Param): Key {\n    return options.paramKey != null ? options.paramKey(param) : (param as unknown as Key);\n  }\n\n  const link: FamilyLink = {\n    invalidateAtom(target: Atom<unknown>): void {\n      for (const cb of storeCallbacks) {\n        cb(target);\n      }\n    },\n    registerStore(cb: (atom: Atom<unknown>) => void): () => void {\n      storeCallbacks.add(cb);\n      return () => {\n        storeCallbacks.delete(cb);\n      };\n    },\n  };\n\n  function attachLink(target: Atom<Value>): void {\n    (target as unknown as Record<symbol, FamilyLink>)[FAMILY_LINK] = link;\n  }\n\n  function getOrCreate(param: Param): Atom<Value> {\n    const key = keyOf(param);\n    const cached = cache.get(key);\n    if (cached != null) {\n      return cached;\n    }\n\n    const deps = options.dependencies?.(param);\n    const getFn = options.get(param);\n    const setFn = options.set?.(param);\n\n    const labelSuffix = options.paramKey != null ? String(key) : String(param);\n    const label = options.debugLabel != null ? `${options.debugLabel}(${labelSuffix})` : undefined;\n\n    const created = createAtom(label, deps, getFn, setFn);\n    attachLink(created);\n    cache.set(key, created);\n\n    return created;\n  }\n\n  function createAtom(\n    label: string | undefined,\n    deps: Deps | undefined,\n    getFn: (ctx: AtomContext<Deps>) => Promise<Value>,\n    setFn: ((ctx: AtomContext<Deps>, ...args: Args) => Promise<void>) | undefined,\n  ): Atom<Value> {\n    const base = {\n      get: getFn as (ctx: AtomContext<Deps>) => Promise<Value>,\n    } as {\n      debugLabel?: string;\n      dependencies?: Deps;\n      stalePolicy?: StalePolicy;\n      get: (ctx: AtomContext<Deps>) => Promise<Value>;\n      set?: (ctx: AtomContext<Deps>, ...args: Args) => Promise<void>;\n    };\n\n    if (label != null) {\n      base.debugLabel = label;\n    }\n    if (deps != null) {\n      base.dependencies = deps;\n    }\n    if (options.stalePolicy != null) {\n      base.stalePolicy = options.stalePolicy;\n    }\n\n    if (setFn != null) {\n      base.set = setFn;\n      return atom(\n        base as typeof base & {\n          set: (ctx: AtomContext<Deps>, ...args: Args) => Promise<void>;\n        },\n      ) as Atom<Value>;\n    }\n\n    return atom(base as Omit<typeof base, \"set\">);\n  }\n\n  const family = getOrCreate as AtomFamily<Param, Value, Key>;\n\n  family.invalidate = (param: Param): void => {\n    const cached = cache.peek(keyOf(param));\n    if (cached != null) {\n      link.invalidateAtom(cached);\n    }\n  };\n\n  family.invalidateAll = (): void => {\n    for (const cached of cache.values()) {\n      link.invalidateAtom(cached);\n    }\n  };\n\n  family.remove = (param: Param): void => {\n    cache.delete(keyOf(param));\n  };\n\n  family.getCache = (): ReadonlyMap<Key, Atom<Value>> => cache.asReadonlyMap();\n\n  return family;\n}\n","import type {\n  Atom,\n  AtomContext,\n  AtomState,\n  InternalAtomConfig,\n  StalePolicy,\n  WritableAtom,\n  WritableAtomContext,\n} from \"@/internal/types.js\";\nimport { CONFIG } from \"@/internal/types.js\";\nimport { getFamilyLink } from \"@/internal/family.js\";\n\ntype AtomEntry<V> = {\n  state: AtomState<V>;\n  version: number;\n  promise: Promise<V> | null;\n  listeners: Set<() => void>;\n  mountCount: number;\n  unmount: (() => void) | null;\n};\n\nexport interface StoreClient {\n  get<V>(atom: Atom<V>): Promise<V>;\n  set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void>;\n  write<V>(atom: Atom<V>, value: V): void;\n  write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;\n  invalidate(atom: Atom<unknown>): void;\n  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;\n  subscribe<V>(atom: Atom<V>, listener: (state: AtomState<V>) => void): () => void;\n}\n\nconst PENDING_STATE: AtomState<never> = {\n  status: \"pending\",\n  value: undefined,\n  error: undefined,\n} as AtomState<never>;\n\nexport class Store {\n  readonly #atoms = new WeakMap<Atom<unknown>, AtomEntry<unknown>>();\n  readonly #rdeps = new Map<Atom<unknown>, Set<Atom<unknown>>>();\n  readonly #pending = new Set<Atom<unknown>>();\n  readonly #controllers = new WeakMap<Atom<unknown>, AbortController>();\n  readonly #familyUnsubs = new Set<() => void>();\n  readonly #registeredFamilies = new WeakSet<object>();\n  #client: StoreClient | null = null;\n  #flushScheduled = false;\n\n  #getOrCreate<V>(atom: Atom<V>): AtomEntry<V> {\n    let entry = this.#atoms.get(atom) as AtomEntry<V> | undefined;\n    if (entry == null) {\n      entry = {\n        state: PENDING_STATE as AtomState<V>,\n        version: 0,\n        promise: null,\n        listeners: new Set(),\n        mountCount: 0,\n        unmount: null,\n      };\n      this.#atoms.set(atom, entry as AtomEntry<unknown>);\n    }\n    return entry;\n  }\n\n  resolve<V>(atom: Atom<V>): Promise<V> {\n    const entry = this.#getOrCreate(atom);\n    if (entry.promise != null) {\n      return entry.promise;\n    }\n\n    const promise = this.#runGet(atom).finally(() => {\n      const e = this.#atoms.get(atom) as AtomEntry<V> | undefined;\n      if (e != null) {\n        e.promise = null;\n      }\n    });\n    entry.promise = promise;\n    return promise;\n  }\n\n  async #runGet<V>(atom: Atom<V>): Promise<V> {\n    const config: InternalAtomConfig<V> = atom[CONFIG];\n    const dependencies = config.dependencies;\n    const stalePolicy: StalePolicy = config.stalePolicy ?? \"keep\";\n    const entry = this.#getOrCreate(atom);\n\n    if (dependencies != null) {\n      await Promise.all(Object.values(dependencies).map((dep) => this.resolve(dep)));\n      this.#registerRdeps(atom, dependencies);\n    }\n\n    const ctx = this.#makeCtx(atom, dependencies ?? {});\n\n    try {\n      const value = await config.get(ctx);\n      if (ctx.signal.aborted) {\n        throw new DOMException(\"The operation was aborted\", \"AbortError\");\n      }\n      entry.state = { status: \"fresh\", value, error: undefined };\n      entry.version++;\n      this.#scheduleNotify(atom);\n      return value;\n    } catch (e: unknown) {\n      if (isAbortError(e)) {\n        throw e;\n      }\n      const prevValue = extractPreviousValue<V>(entry.state);\n      entry.state = {\n        status: \"error\",\n        value: stalePolicy === \"keep\" ? prevValue : undefined,\n        error: e,\n      } as AtomState<V>;\n      entry.version++;\n      this.#scheduleNotify(atom);\n      throw e;\n    }\n  }\n\n  invalidate(atom: Atom<unknown>): void {\n    this.#markStale(atom);\n    this.#pending.add(atom);\n    this.#schedulePendingFlush();\n  }\n\n  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void {\n    for (const a of atoms) {\n      this.#markStale(a);\n      this.#pending.add(a);\n    }\n    if (this.#pending.size > 0) {\n      this.#schedulePendingFlush();\n    }\n  }\n\n  #markStale(atom: Atom<unknown>, visited = new Set<Atom<unknown>>()): void {\n    if (visited.has(atom)) {\n      return;\n    }\n    visited.add(atom);\n\n    const entry = this.#atoms.get(atom);\n    if (entry != null) {\n      const stalePolicy: StalePolicy = atom[CONFIG].stalePolicy ?? \"keep\";\n\n      if (entry.state.status === \"fresh\") {\n        if (stalePolicy === \"reset\") {\n          entry.state = PENDING_STATE;\n        } else {\n          entry.state = { ...entry.state, status: \"stale\" };\n        }\n      }\n\n      entry.promise = null;\n      this.#controllers.get(atom)?.abort();\n    }\n\n    const rdeps = this.#rdeps.get(atom);\n    if (rdeps != null) {\n      for (const dep of rdeps) {\n        this.#markStale(dep, visited);\n      }\n    }\n  }\n\n  #markReverseDependentsStale(atom: Atom<unknown>): void {\n    const rdeps = this.#rdeps.get(atom);\n    if (rdeps != null) {\n      const visited = new Set<Atom<unknown>>([atom]);\n      for (const dep of rdeps) {\n        this.#markStale(dep, visited);\n        this.#pending.add(dep);\n      }\n    }\n  }\n\n  #flushPending(): void {\n    const batch = [...this.#pending];\n    this.#pending.clear();\n    const toNotify = new Set<() => void>();\n    for (const a of batch) {\n      const entry = this.#atoms.get(a);\n      if (entry != null) {\n        for (const l of entry.listeners) {\n          toNotify.add(l);\n        }\n      }\n    }\n    for (const l of toNotify) {\n      l();\n    }\n  }\n\n  #schedulePendingFlush(): void {\n    if (!this.#flushScheduled) {\n      this.#flushScheduled = true;\n      queueMicrotask(() => {\n        this.#flushScheduled = false;\n        this.#flushPending();\n      });\n    }\n  }\n\n  #scheduleNotify(atom: Atom<unknown>): void {\n    this.#pending.add(atom);\n    this.#schedulePendingFlush();\n  }\n\n  #registerRdeps(atom: Atom<unknown>, deps: Record<string, Atom<unknown>>): void {\n    for (const dep of Object.values(deps)) {\n      let set = this.#rdeps.get(dep);\n      if (set == null) {\n        set = new Set();\n        this.#rdeps.set(dep, set);\n      }\n      set.add(atom);\n    }\n  }\n\n  #makeCtx(\n    atom: Atom<unknown>,\n    deps: Record<string, Atom<unknown>>,\n  ): AtomContext<Record<string, Atom<unknown>>> {\n    this.#controllers.get(atom)?.abort();\n    const controller = new AbortController();\n    this.#controllers.set(atom, controller);\n\n    return {\n      signal: controller.signal,\n      get: async (key: string) => {\n        const dep = deps[key];\n        if (dep == null) {\n          throw new Error(`Unknown dependency key: \"${String(key)}\"`);\n        }\n        return this.resolve(dep);\n      },\n    };\n  }\n\n  subscribe<V>(atom: Atom<V>, listener: () => void): () => void {\n    const entry = this.#getOrCreate(atom);\n    entry.listeners.add(listener);\n\n    this.#autoRegisterFamily(atom);\n\n    if (entry.state.status === \"pending\" && entry.promise == null) {\n      void this.resolve(atom);\n    }\n\n    entry.mountCount++;\n    if (entry.mountCount === 1) {\n      const config: InternalAtomConfig<V> = atom[CONFIG];\n      if (config.onMount != null) {\n        const setValue = (value: V): void => {\n          entry.state = { status: \"fresh\", value, error: undefined };\n          entry.version++;\n          this.#scheduleNotify(atom);\n        };\n        const cleanup = config.onMount(setValue as (value: unknown) => void);\n        if (typeof cleanup === \"function\") {\n          entry.unmount = cleanup;\n        }\n      }\n    }\n\n    return () => {\n      entry.listeners.delete(listener);\n      entry.mountCount--;\n      if (entry.mountCount === 0 && entry.unmount != null) {\n        entry.unmount();\n        entry.unmount = null;\n      }\n    };\n  }\n\n  #autoRegisterFamily(atom: Atom<unknown>): void {\n    const link = getFamilyLink(atom);\n    if (link == null) {\n      return;\n    }\n    if (this.#registeredFamilies.has(link)) {\n      return;\n    }\n    this.#registeredFamilies.add(link);\n    const unsub = link.registerStore((target: Atom<unknown>) => {\n      this.invalidate(target);\n    });\n    this.#familyUnsubs.add(unsub);\n  }\n\n  getSnapshot<V>(atom: Atom<V>): AtomState<V> {\n    return this.#getOrCreate(atom).state;\n  }\n\n  getServerSnapshot<V>(atom: Atom<V>): AtomState<V> {\n    const entry = this.#atoms.get(atom) as AtomEntry<V> | undefined;\n    if (entry != null) {\n      return entry.state;\n    }\n    return PENDING_STATE as AtomState<V>;\n  }\n\n  async set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void> {\n    const config: InternalAtomConfig<V> = atom[CONFIG];\n    if (config.set == null) {\n      throw new Error(\n        `Atom${atom.debugLabel != null ? ` \"${atom.debugLabel}\"` : \"\"} is not writable`,\n      );\n    }\n\n    const deps = config.dependencies ?? {};\n    const baseCtx = this.#makeCtx(atom, deps);\n    const entry = this.#getOrCreate(atom);\n\n    // Ref: assignments inside setOptimisticValue are not tracked on a plain `let` for catch narrowing.\n    const optimisticSnapshot: {\n      current: { state: AtomState<V>; version: number } | null;\n    } = { current: null };\n\n    const ctx: WritableAtomContext<Record<string, Atom<unknown>>, V> = {\n      ...baseCtx,\n      setOptimisticValue: (valueOrMutate: V | ((prev: V | undefined) => V)): void => {\n        if (optimisticSnapshot.current == null) {\n          optimisticSnapshot.current = { state: entry.state, version: entry.version };\n        }\n        const next =\n          typeof valueOrMutate === \"function\"\n            ? (valueOrMutate as (prev: V | undefined) => V)(extractPreviousValue(entry.state))\n            : valueOrMutate;\n        entry.state = { status: \"fresh\", value: next, error: undefined };\n        entry.version++;\n        this.#scheduleNotify(atom);\n        this.#markReverseDependentsStale(atom);\n      },\n    };\n\n    try {\n      await config.set(ctx, ...args);\n    } catch (e: unknown) {\n      const snap = optimisticSnapshot.current;\n      if (snap != null) {\n        entry.state = snap.state;\n        entry.version = snap.version;\n        this.#scheduleNotify(atom);\n      }\n      throw e;\n    }\n\n    this.invalidate(atom);\n  }\n\n  write<V>(atom: Atom<V>, value: V): void;\n  write<V>(atom: Atom<V>, mutate: (prev: V | undefined) => V): void;\n  write<V>(atom: Atom<V>, valueOrMutate: V | ((prev: V | undefined) => V)): void {\n    const entry = this.#getOrCreate(atom);\n    this.#controllers.get(atom)?.abort();\n    entry.promise = null;\n    const next =\n      typeof valueOrMutate === \"function\"\n        ? (valueOrMutate as (prev: V | undefined) => V)(extractPreviousValue(entry.state))\n        : valueOrMutate;\n    entry.state = { status: \"fresh\", value: next, error: undefined };\n    entry.version++;\n    this.#scheduleNotify(atom);\n    this.#markReverseDependentsStale(atom);\n  }\n\n  getClient(): StoreClient {\n    if (this.#client != null) {\n      return this.#client;\n    }\n\n    this.#client = {\n      get: <V>(atom: Atom<V>): Promise<V> => this.resolve(atom),\n      set: <V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void> =>\n        this.set(atom, ...args),\n      write: <V>(atom: Atom<V>, valueOrMutate: V | ((prev: V | undefined) => V)): void =>\n        this.write(atom, valueOrMutate as V),\n      invalidate: (atom: Atom<unknown>): void => this.invalidate(atom),\n      invalidateMany: (atoms: ReadonlyArray<Atom<unknown>>): void => this.invalidateMany(atoms),\n      subscribe: <V>(atom: Atom<V>, listener: (state: AtomState<V>) => void): (() => void) =>\n        this.subscribe(atom, () => {\n          listener(this.getSnapshot(atom));\n        }),\n    };\n    return this.#client;\n  }\n}\n\nexport function createStore(): Store {\n  return new Store();\n}\n\nfunction isAbortError(e: unknown): boolean {\n  return e instanceof DOMException && e.name === \"AbortError\";\n}\n\nfunction extractPreviousValue<V>(state: AtomState<V>): V | undefined {\n  if (state.status === \"stale\" || state.status === \"fresh\") {\n    return state.value;\n  }\n  if (state.status === \"error\") {\n    return state.value;\n  }\n  return undefined;\n}\n"],"mappings":"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"}