@kdeveloper/kvark 0.3.1 → 0.5.0

package/README.md

@@ -296,12 +296,12 @@ Combines `useAtomValue` and `useSetAtom` into a `[value, setter]` tuple.
 const [count, setCount] = useAtom(countAtom);
 ```
 
-### `useAtomCallback`
+### `useAtomContext`
 
 Imperative access to the `StoreClient` inside a callback. Does not subscribe.
 
 ```tsx
-const readBalance = useAtomCallback(async (client) => {
+const readBalance = useAtomContext(async (client) => {
   return client.get(balanceAtom);
 });
 
@@ -348,12 +348,28 @@ const unsub = client.subscribe(userAtom, (state) => {
 });
 ```
 
+### Direct Write
+
+When the server pushes a complete, authoritative value (e.g. via WebSocket or SSE), use `client.write` to store it directly — no refetch through `get` is triggered. Any in-flight `get` for the atom is aborted, and derived atoms that depend on it are marked `stale` so they re-compute.
+
+```ts
+ws.addEventListener("message", (event) => {
+  const msg = JSON.parse(event.data);
+  if (msg.type === "post.updated") {
+    client.write(postFamily(msg.postId), msg.post);
+  }
+});
+```
+
+`write` works on any `Atom<V>` — the atom does not need a `set` config. This makes it the right tool when you already have the final value and want to skip a redundant network round-trip.
+
 ### `StoreClient` interface
 
 ```ts
 interface StoreClient {
   get<V>(atom: Atom<V>): Promise<V>;
   set<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>, ...args: A): Promise<void>;
+  write<V>(atom: Atom<V>, value: V): void;
   invalidate(atom: Atom<unknown>): void;
   invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;
   subscribe<V>(atom: Atom<V>, listener: (state: AtomState<V>) => void): () => void;
@@ -395,7 +411,7 @@ type Writable = IsWritable<typeof countAtom>; // → true | false
 | Import                     | Contents                                                               |
 | -------------------------- | ---------------------------------------------------------------------- |
 | `@kdeveloper/kvark`        | `atom`, `createStore`, all types                                       |
-| `@kdeveloper/kvark/react`  | `Provider`, `useAtomValue`, `useSetAtom`, `useAtom`, `useAtomCallback` |
+| `@kdeveloper/kvark/react`  | `Provider`, `useAtomValue`, `useSetAtom`, `useAtom`, `useAtomContext` |
 | `@kdeveloper/kvark/family` | `atomFamily`                                                           |
 
 The core (`@kdeveloper/kvark`) has **zero runtime dependencies**. React is a peer dependency only needed when using the `/react` subpath.

package/dist/{index.d.ts → atom-CtZVA4ka.d.mts}

@@ -1,11 +1,12 @@
-import { A as Atom, b as AtomConfig, h as WritableAtomContext, W as WritableAtom } from './store-CAz6uZcN.js';
-export { i as AtomArgs, a as AtomContext, c as AtomState, d as AtomValue, I as IsWritable, S as StalePolicy, g as StoreClient, e as createStore } from './store-CAz6uZcN.js';
+import { f as WritableAtom, i as Atom, o as AtomConfig, p as WritableAtomContext } from "./store-BbmNU3xn.mjs";
 
+//#region src/internal/atom.d.ts
 type WritableConfig<Value, Deps extends Record<string, Atom<unknown>>, Args extends readonly unknown[]> = AtomConfig<Value, Deps, Args> & {
-    set: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;
+  set: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;
 };
 type ReadonlyConfig<Value, Deps extends Record<string, Atom<unknown>>> = Omit<AtomConfig<Value, Deps, readonly []>, "set">;
 declare function atom<Value, Deps extends Record<string, Atom<unknown>> = Record<never, never>, Args extends readonly unknown[] = readonly []>(config: WritableConfig<Value, Deps, Args>): WritableAtom<Value, Args>;
 declare function atom<Value, Deps extends Record<string, Atom<unknown>> = Record<never, never>>(config: ReadonlyConfig<Value, Deps>): Atom<Value>;
-
-export { Atom, AtomConfig, WritableAtom, WritableAtomContext, atom };
+//#endregion
+export { atom as t };
+//# sourceMappingURL=atom-CtZVA4ka.d.mts.map

package/dist/atom-CtZVA4ka.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom-CtZVA4ka.d.mts","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.mts

@@ -0,0 +1,24 @@
+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-BbmNU3xn.mjs";
+import { t as atom } from "./atom-CtZVA4ka.mjs";
+
+//#region src/internal/family.d.ts
+type AtomFamilyOptions<Param, Value, Deps extends Record<string, Atom<unknown>>, Args extends readonly unknown[]> = {
+  dependencies?: (param: Param) => Deps;
+  stalePolicy?: StalePolicy;
+  cachePolicy?: "keep-all" | "lru";
+  lruSize?: number;
+  debugLabel?: string;
+  get: (param: Param) => (ctx: AtomContext<Deps>) => Promise<Value>;
+  set?: (param: Param) => (ctx: AtomContext<Deps>, ...args: Args) => Promise<void>;
+};
+interface AtomFamily<Param, Value> {
+  (param: Param): Atom<Value>;
+  invalidate(param: Param): void;
+  invalidateAll(): void;
+  remove(param: Param): void;
+  getCache(): ReadonlyMap<Param, Atom<Value>>;
+}
+declare function atomFamily<Param, Value, Deps extends Record<string, Atom<unknown>> = Record<never, never>, Args extends readonly unknown[] = readonly []>(options: AtomFamilyOptions<Param, Value, Deps, Args>): AtomFamily<Param, Value>;
+//#endregion
+export { type Atom, type AtomConfig, type AtomContext, type AtomFamily, type AtomFamilyOptions, type AtomState, type AtomValue, type StalePolicy, type WritableAtom, atom, atomFamily, createStore };
+//# sourceMappingURL=family.d.mts.map

package/dist/family.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family.d.mts","names":[],"sources":["../src/internal/family.ts"],"mappings":";;;;KAIY,iBAAA,4BAGG,MAAA,SAAe,IAAA;EAG5B,YAAA,IAAgB,KAAA,EAAO,KAAA,KAAU,IAAA;EACjC,WAAA,GAAc,WAAA;EACd,WAAA;EACA,OAAA;EACA,UAAA;EACA,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;EAAA,CACd,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,KAAA,EAAO,IAAA,CAAK,KAAA;AAAA;AAAA,iBAYtB,UAAA,4BAGD,MAAA,SAAe,IAAA,aAAiB,MAAA,8DAAA,CAE7C,OAAA,EAAS,iBAAA,CAAkB,KAAA,EAAO,KAAA,EAAO,IAAA,EAAM,IAAA,IAAQ,UAAA,CAAW,KAAA,EAAO,KAAA"}

package/dist/family.mjs

@@ -0,0 +1,2 @@
+import { n as atomFamily, r as atom, t as createStore } from "./store-CmRXgcwh.mjs";
+export { atom, atomFamily, createStore };

package/dist/index.d.mts

@@ -0,0 +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-BbmNU3xn.mjs";
+import { t as atom } from "./atom-CtZVA4ka.mjs";
+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 };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { r as atom, t as createStore } from "./store-CmRXgcwh.mjs";
+export { atom, createStore };

package/dist/react/index.d.mts

@@ -0,0 +1,36 @@
+import { f as WritableAtom, i as Atom, n as StoreClient, t as Store } from "../store-BbmNU3xn.mjs";
+import { ReactNode } from "react";
+
+//#region src/react/provider.d.ts
+type ProviderProps = {
+  store: Store;
+  children: ReactNode;
+};
+declare function Provider({
+  store,
+  children
+}: ProviderProps): ReactNode;
+declare function useStore(): Store;
+//#endregion
+//#region src/react/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/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-atom.d.ts
+declare function useAtom<V, A extends readonly unknown[]>(atom: WritableAtom<V, A>): readonly [V, (...args: A) => Promise<void>];
+//#endregion
+//#region src/react/use-atom-context.d.ts
+declare function useAtomContext<R>(callback: (ctx: StoreClient) => Promise<R>): () => Promise<R>;
+//#endregion
+export { Provider, useAtom, useAtomContext, useAtomValue, useSetAtom, useStore };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","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"],"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;;;KCTvB,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;;;iBCRvE,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"}

package/dist/react/index.mjs

@@ -0,0 +1,69 @@
+import { i as CONFIG } from "../store-CmRXgcwh.mjs";
+import { createContext, useCallback, useContext, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/provider.tsx
+const StoreContext = createContext(null);
+function Provider({ store, children }) {
+	return /* @__PURE__ */ jsx(StoreContext, {
+		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/react/use-atom-value.ts
+function useAtomValue(atom, opts) {
+	const store = useStore();
+	const snapshot = useSyncExternalStore((notify) => store.subscribe(atom, notify), () => store.getSnapshot(atom), () => store.getServerSnapshot(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/react/use-set-atom.ts
+function useSetAtom(atom) {
+	const store = useStore();
+	return useCallback((...args) => store.set(atom, ...args), [store, atom]);
+}
+//#endregion
+//#region src/react/use-atom.ts
+function useAtom(atom) {
+	return [useAtomValue(atom), useSetAtom(atom)];
+}
+//#endregion
+//#region src/react/use-atom-context.ts
+function useAtomContext(callback) {
+	const store = useStore();
+	return useCallback(() => callback(store.getClient()), [store, callback]);
+}
+//#endregion
+export { Provider, useAtom, useAtomContext, useAtomValue, useSetAtom, useStore };
+
+//# sourceMappingURL=index.mjs.map

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","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"],"sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport { 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 value={store}>{children}</StoreContext>;\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 { useSyncExternalStore } from \"react\";\nimport type { Atom, AtomState, StalePolicy } from \"../internal/types.js\";\nimport { CONFIG } from \"../internal/types.js\";\nimport { useStore } from \"./provider.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 snapshot: AtomState<V> = useSyncExternalStore(\n    (notify) => store.subscribe(atom, notify),\n    () => store.getSnapshot(atom),\n    () => store.getServerSnapshot(atom),\n  );\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 \"./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 \"./use-atom-value.js\";\nimport { useSetAtom } from \"./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 \"./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,cAAD;EAAc,OAAO;EAAQ;EAAwB,CAAA;;AAG9D,SAAgB,WAAkB;CAChC,MAAM,QAAQ,WAAW,aAAa;AACtC,KAAI,SAAS,KACX,OAAM,IAAI,MAAM,4CAA4C;AAE9D,QAAO;;;;ACNT,SAAgB,aAAgB,MAAe,MAAgD;CAC7F,MAAM,QAAQ,UAAU;CAExB,MAAM,WAAyB,sBAC5B,WAAW,MAAM,UAAU,MAAM,OAAO,QACnC,MAAM,YAAY,KAAK,QACvB,MAAM,kBAAkB,KAAK,CACpC;CAED,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,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-BbmNU3xn.d.mts

@@ -0,0 +1,80 @@
+//#region src/internal/types.d.ts
+declare const CONFIG: unique symbol;
+declare const WRITABLE: unique symbol;
+type AtomState<Value> = {
+  status: "pending";
+  value: undefined;
+  error: undefined;
+} | {
+  status: "stale";
+  value: Value;
+  error: undefined;
+} | {
+  status: "fresh";
+  value: Value;
+  error: undefined;
+} | {
+  status: "error";
+  value: Value | undefined;
+  error: unknown;
+};
+type StalePolicy = "keep" | "suspend" | "reset";
+type AtomContext<Deps extends Record<string, Atom<unknown>>> = {
+  get: <K extends keyof Deps>(key: K) => Promise<AtomValue<Deps[K]>>;
+  signal: AbortSignal;
+};
+type WritableAtomContext<Deps extends Record<string, Atom<unknown>>, Value> = AtomContext<Deps> & {
+  setOptimisticValue: (value: Value) => void;
+};
+type AtomConfig<Value, Deps extends Record<string, Atom<unknown>>, Args extends readonly unknown[]> = {
+  dependencies?: Deps;
+  stalePolicy?: StalePolicy;
+  debugLabel?: string;
+  get: (ctx: AtomContext<Deps>) => Promise<Value>;
+  set?: (ctx: WritableAtomContext<Deps, Value>, ...args: Args) => Promise<void>;
+  onMount?: (set: (value: Value) => void) => (() => void) | void;
+};
+interface InternalAtomConfig<Value> {
+  dependencies?: Record<string, Atom<unknown>>;
+  stalePolicy?: StalePolicy;
+  debugLabel?: string;
+  get: (ctx: AtomContext<Record<string, Atom<unknown>>>) => Promise<Value>;
+  set?: (ctx: WritableAtomContext<Record<string, Atom<unknown>>, Value>, ...args: readonly unknown[]) => Promise<void>;
+  onMount?: (set: (value: unknown) => void) => (() => void) | void;
+}
+interface Atom<out Value> {
+  readonly [CONFIG]: InternalAtomConfig<Value>;
+  readonly debugLabel: string | undefined;
+}
+interface WritableAtom<out Value, in out Args extends readonly unknown[]> extends Atom<Value> {
+  readonly [WRITABLE]: Args;
+}
+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/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>;
+  write<V>(atom: Atom<V>, value: V): void;
+  invalidate(atom: Atom<unknown>): void;
+  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;
+  subscribe<V>(atom: Atom<V>, listener: (state: AtomState<V>) => void): () => void;
+}
+declare class Store {
+  #private;
+  resolve<V>(atom: Atom<V>): Promise<V>;
+  invalidate(atom: Atom<unknown>): void;
+  invalidateMany(atoms: ReadonlyArray<Atom<unknown>>): void;
+  subscribe<V>(atom: Atom<V>, listener: () => void): () => void;
+  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>;
+  write<V>(atom: Atom<V>, value: 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-BbmNU3xn.d.mts.map

package/dist/store-BbmNU3xn.d.mts.map

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