@shiftbloom-studio/symphony-state 0.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) YEAR YOUR_NAME
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,198 @@
+# Symphony State
+
+[![npm](https://img.shields.io/npm/v/@shiftbloom-studio/symphony-state)](https://www.npmjs.com/package/@shiftbloom-studio/symphony-state)
+[![CI](https://img.shields.io/github/actions/workflow/status/shiftbloom-studio/symphony-state/ci.yml)](https://github.com/shiftbloom-studio/symphony-state/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@shiftbloom-studio/symphony-state)](LICENSE)
+
+**Orchestrate multiple state sources without a monolithic global store.**
+
+Symphony State coordinates local state, React Context, external stores (Zustand/Redux), server state libraries (TanStack Query/SWR), URL params, and browser persistence without taking ownership of those sources. It focuses on deterministic, dependency-driven propagation and atomic transactions so you can keep cross-domain state consistent.
+
+## Why Symphony State?
+
+- **Mixed sources drift**: local state, URL params, and external stores can diverge.
+- **Update storms**: independent updates trigger multiple re-renders.
+- **Cross-domain dependencies**: cart state depends on auth/pricing, etc.
+
+Symphony State provides an orchestration layer that schedules updates in a single wave and keeps dependencies consistent.
+
+## Installation
+
+```bash
+npm install @shiftbloom-studio/symphony-state
+```
+
+## Quickstart (AtomAdapter)
+
+```tsx
+import {
+  createConductor,
+  defineSection,
+  createAtomAdapter
+} from "@shiftbloom-studio/symphony-state";
+import { SymphonyProvider, useSection } from "@shiftbloom-studio/symphony-state/react";
+
+const auth = defineSection({
+  key: "auth",
+  source: createAtomAdapter({ userId: null as string | null })
+});
+
+const conductor = createConductor({ sections: [auth] });
+
+function AuthPanel() {
+  const authSection = useSection<{ userId: string | null }>("auth");
+  return (
+    <button onClick={() => authSection.set({ userId: "42" })}>
+      {authSection.value.userId ?? "Login"}
+    </button>
+  );
+}
+
+export function App() {
+  return (
+    <SymphonyProvider conductor={conductor}>
+      <AuthPanel />
+    </SymphonyProvider>
+  );
+}
+```
+
+## Quickstart (Zustand + Redux adapters)
+
+```ts
+import { createZustandAdapter } from "@shiftbloom-studio/symphony-state/adapters/zustand";
+import { createReduxAdapter } from "@shiftbloom-studio/symphony-state/adapters/redux";
+
+const zustandSection = defineSection({
+  key: "filters",
+  source: createZustandAdapter(zustandStore)
+});
+
+const reduxSection = defineSection({
+  key: "cart",
+  source: createReduxAdapter(reduxStore, {
+    select: (state) => state.cart,
+    update: (next) => ({ type: "cart/replace", payload: next }),
+    patch: (partial) => ({ type: "cart/patch", payload: partial })
+  })
+});
+```
+
+## Transactions
+
+```ts
+conductor.transaction(() => {
+  conductor.getSection("auth").set({ userId: "42" });
+  conductor.getSection("cart").patch({ ownerId: "42" });
+}, "login");
+```
+
+All section updates are staged, resolved in dependency order, committed atomically, and only then are subscribers notified.
+
+## Derived sections
+
+```ts
+import { defineDerivedSection } from "@shiftbloom-studio/symphony-state";
+
+const pricing = defineDerivedSection({
+  key: "pricing",
+  inputs: ["cart", "auth"],
+  compute: (cart, auth) => ({
+    total: cart.items.length * (auth.isPremium ? 0.8 : 1)
+  })
+});
+```
+
+Derived sections are read-only and recompute only when their inputs change.
+
+## Next.js patterns
+
+### App Router
+
+```tsx
+// app/layout.tsx
+"use client";
+import { SymphonyProvider } from "@shiftbloom-studio/symphony-state/react";
+import { conductor } from "./symphony";
+
+export default function RootLayout({ children }) {
+  return <SymphonyProvider conductor={conductor}>{children}</SymphonyProvider>;
+}
+```
+
+### Pages Router
+
+```tsx
+// pages/_app.tsx
+import { SymphonyProvider } from "@shiftbloom-studio/symphony-state/react";
+import { conductor } from "../symphony";
+
+export default function App({ Component, pageProps }) {
+  return (
+    <SymphonyProvider conductor={conductor}>
+      <Component {...pageProps} />
+    </SymphonyProvider>
+  );
+}
+```
+
+### Hydration helper
+
+```tsx
+import { SymphonyScript } from "@shiftbloom-studio/symphony-state/react";
+
+<SymphonyScript state={{ auth: { userId: "42" } }} />;
+```
+
+## Persistence
+
+```ts
+import { createStorageSink } from "@shiftbloom-studio/symphony-state";
+
+const auth = defineSection({
+  key: "auth",
+  source: createAtomAdapter({ userId: null }),
+  persist: createStorageSink({
+    key: "symphony-auth",
+    throttleMs: 200
+  })
+});
+```
+
+## DevTools (optional)
+
+```tsx
+import { SymphonyDevTools } from "@shiftbloom-studio/symphony-state/devtools";
+
+<SymphonyDevTools maxTransactions={10} />;
+```
+
+DevTools are dev-only, tree-shakeable, and unstyled apart from minimal CSS variables.
+
+## API Reference
+
+| API                                 | Description                                    |
+| ----------------------------------- | ---------------------------------------------- |
+| `createConductor(config)`           | Create a conductor instance.                   |
+| `defineSection(def)`                | Define a section backed by a source adapter.   |
+| `defineDerivedSection(def)`         | Define a derived, read-only section.           |
+| `createAtomAdapter(initial)`        | Built-in minimal store.                        |
+| `createExternalStoreAdapter(store)` | Wrap an external get/set/subscribe store.      |
+| `createUrlParamsAdapter(options)`   | Sync with URL search params.                   |
+| `createStorageSink(options)`        | Persist section values to storage.             |
+| `SymphonyProvider`                  | React context provider.                        |
+| `useSection(key)`                   | React hook for section read/write.             |
+| `useSelector(key, selector)`        | Selector hook with equality.                   |
+| `createSymphony(config)`            | Typed helper that wires a conductor and hooks. |
+| `SymphonyDevTools`                  | Optional devtools panel.                       |
+
+## Design principles
+
+- **Orchestration, not ownership**: Symphony State coordinates existing stores.
+- **Predictable updates**: deterministic, dependency-ordered commit waves.
+- **Tree-shakeable**: optional adapters and devtools ship as separate entrypoints.
+- **SSR-safe**: no unguarded `window` usage in core.
+
+## License
+
+MIT

package/dist/adapters/atom.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+// src/adapters/atom.ts
+var createAtomAdapter = (initial) => {
+  let current = initial;
+  const subscribers = /* @__PURE__ */ new Set();
+  const notify = () => {
+    subscribers.forEach((cb) => cb());
+  };
+  return {
+    kind: "atom",
+    get: () => current,
+    set: (next) => {
+      if (Object.is(current, next)) {
+        return;
+      }
+      current = next;
+      notify();
+    },
+    patch: (partial) => {
+      if (typeof current !== "object" || current === null) {
+        throw new Error("AtomAdapter patch requires object state.");
+      }
+      current = { ...current, ...partial };
+      notify();
+    },
+    subscribe: (cb) => {
+      subscribers.add(cb);
+      return () => subscribers.delete(cb);
+    }
+  };
+};
+
+exports.createAtomAdapter = createAtomAdapter;
+//# sourceMappingURL=atom.cjs.map
+//# sourceMappingURL=atom.cjs.map

package/dist/adapters/atom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/atom.ts"],"names":[],"mappings":";;;AAMO,IAAM,iBAAA,GAAoB,CAAI,OAAA,KAA+B;AAClE,EAAA,IAAI,OAAA,GAAU,OAAA;AACd,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAgB;AAExC,EAAA,MAAM,SAAS,MAAM;AACnB,IAAA,WAAA,CAAY,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,EAAI,CAAA;AAAA,EAClC,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,MAAA;AAAA,IACN,KAAK,MAAM,OAAA;AAAA,IACX,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,MAAA,IAAI,MAAA,CAAO,EAAA,CAAG,OAAA,EAAS,IAAI,CAAA,EAAG;AAC5B,QAAA;AAAA,MACF;AACA,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,MAAA,EAAO;AAAA,IACT,CAAA;AAAA,IACA,KAAA,EAAO,CAAC,OAAA,KAAY;AAClB,MAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,EAAM;AACnD,QAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,MAC5D;AACA,MAAA,OAAA,GAAU,EAAE,GAAI,OAAA,EAAqC,GAAG,OAAA,EAAQ;AAChE,MAAA,MAAA,EAAO;AAAA,IACT,CAAA;AAAA,IACA,SAAA,EAAW,CAAC,EAAA,KAAgC;AAC1C,MAAA,WAAA,CAAY,IAAI,EAAE,CAAA;AAClB,MAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,EAAE,CAAA;AAAA,IACpC;AAAA,GACF;AACF","file":"atom.cjs","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type AtomAdapter<T> = SourceAdapter<T> & {\n  patch: (partial: Partial<T>) => void;\n};\n\nexport const createAtomAdapter = <T>(initial: T): AtomAdapter<T> => {\n  let current = initial;\n  const subscribers = new Set<Subscriber>();\n\n  const notify = () => {\n    subscribers.forEach((cb) => cb());\n  };\n\n  return {\n    kind: \"atom\",\n    get: () => current,\n    set: (next) => {\n      if (Object.is(current, next)) {\n        return;\n      }\n      current = next;\n      notify();\n    },\n    patch: (partial) => {\n      if (typeof current !== \"object\" || current === null) {\n        throw new Error(\"AtomAdapter patch requires object state.\");\n      }\n      current = { ...(current as Record<string, unknown>), ...partial } as T;\n      notify();\n    },\n    subscribe: (cb: Subscriber): Unsubscribe => {\n      subscribers.add(cb);\n      return () => subscribers.delete(cb);\n    }\n  };\n};\n"]}

package/dist/adapters/atom.d.cts

@@ -0,0 +1,8 @@
+import { d as SourceAdapter } from '../types-B1uzdpYH.cjs';
+
+type AtomAdapter<T> = SourceAdapter<T> & {
+    patch: (partial: Partial<T>) => void;
+};
+declare const createAtomAdapter: <T>(initial: T) => AtomAdapter<T>;
+
+export { type AtomAdapter, createAtomAdapter };

package/dist/adapters/atom.d.ts

@@ -0,0 +1,8 @@
+import { d as SourceAdapter } from '../types-B1uzdpYH.js';
+
+type AtomAdapter<T> = SourceAdapter<T> & {
+    patch: (partial: Partial<T>) => void;
+};
+declare const createAtomAdapter: <T>(initial: T) => AtomAdapter<T>;
+
+export { type AtomAdapter, createAtomAdapter };

package/dist/adapters/atom.js

@@ -0,0 +1,34 @@
+// src/adapters/atom.ts
+var createAtomAdapter = (initial) => {
+  let current = initial;
+  const subscribers = /* @__PURE__ */ new Set();
+  const notify = () => {
+    subscribers.forEach((cb) => cb());
+  };
+  return {
+    kind: "atom",
+    get: () => current,
+    set: (next) => {
+      if (Object.is(current, next)) {
+        return;
+      }
+      current = next;
+      notify();
+    },
+    patch: (partial) => {
+      if (typeof current !== "object" || current === null) {
+        throw new Error("AtomAdapter patch requires object state.");
+      }
+      current = { ...current, ...partial };
+      notify();
+    },
+    subscribe: (cb) => {
+      subscribers.add(cb);
+      return () => subscribers.delete(cb);
+    }
+  };
+};
+
+export { createAtomAdapter };
+//# sourceMappingURL=atom.js.map
+//# sourceMappingURL=atom.js.map

package/dist/adapters/atom.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/atom.ts"],"names":[],"mappings":";AAMO,IAAM,iBAAA,GAAoB,CAAI,OAAA,KAA+B;AAClE,EAAA,IAAI,OAAA,GAAU,OAAA;AACd,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAgB;AAExC,EAAA,MAAM,SAAS,MAAM;AACnB,IAAA,WAAA,CAAY,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,EAAI,CAAA;AAAA,EAClC,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,MAAA;AAAA,IACN,KAAK,MAAM,OAAA;AAAA,IACX,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,MAAA,IAAI,MAAA,CAAO,EAAA,CAAG,OAAA,EAAS,IAAI,CAAA,EAAG;AAC5B,QAAA;AAAA,MACF;AACA,MAAA,OAAA,GAAU,IAAA;AACV,MAAA,MAAA,EAAO;AAAA,IACT,CAAA;AAAA,IACA,KAAA,EAAO,CAAC,OAAA,KAAY;AAClB,MAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,EAAM;AACnD,QAAA,MAAM,IAAI,MAAM,0CAA0C,CAAA;AAAA,MAC5D;AACA,MAAA,OAAA,GAAU,EAAE,GAAI,OAAA,EAAqC,GAAG,OAAA,EAAQ;AAChE,MAAA,MAAA,EAAO;AAAA,IACT,CAAA;AAAA,IACA,SAAA,EAAW,CAAC,EAAA,KAAgC;AAC1C,MAAA,WAAA,CAAY,IAAI,EAAE,CAAA;AAClB,MAAA,OAAO,MAAM,WAAA,CAAY,MAAA,CAAO,EAAE,CAAA;AAAA,IACpC;AAAA,GACF;AACF","file":"atom.js","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type AtomAdapter<T> = SourceAdapter<T> & {\n  patch: (partial: Partial<T>) => void;\n};\n\nexport const createAtomAdapter = <T>(initial: T): AtomAdapter<T> => {\n  let current = initial;\n  const subscribers = new Set<Subscriber>();\n\n  const notify = () => {\n    subscribers.forEach((cb) => cb());\n  };\n\n  return {\n    kind: \"atom\",\n    get: () => current,\n    set: (next) => {\n      if (Object.is(current, next)) {\n        return;\n      }\n      current = next;\n      notify();\n    },\n    patch: (partial) => {\n      if (typeof current !== \"object\" || current === null) {\n        throw new Error(\"AtomAdapter patch requires object state.\");\n      }\n      current = { ...(current as Record<string, unknown>), ...partial } as T;\n      notify();\n    },\n    subscribe: (cb: Subscriber): Unsubscribe => {\n      subscribers.add(cb);\n      return () => subscribers.delete(cb);\n    }\n  };\n};\n"]}

package/dist/adapters/external.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+// src/adapters/external.ts
+var createExternalStoreAdapter = (store, options) => {
+  return {
+    kind: options?.kind ?? "external",
+    get: store.get,
+    set: store.set,
+    patch: options?.patch,
+    subscribe: store.subscribe
+  };
+};
+
+exports.createExternalStoreAdapter = createExternalStoreAdapter;
+//# sourceMappingURL=external.cjs.map
+//# sourceMappingURL=external.cjs.map

package/dist/adapters/external.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/external.ts"],"names":[],"mappings":";;;AAQO,IAAM,0BAAA,GAA6B,CACxC,KAAA,EACA,OAAA,KACqB;AACrB,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAS,IAAA,IAAQ,UAAA;AAAA,IACvB,KAAK,KAAA,CAAM,GAAA;AAAA,IACX,KAAK,KAAA,CAAM,GAAA;AAAA,IACX,OAAO,OAAA,EAAS,KAAA;AAAA,IAChB,WAAW,KAAA,CAAM;AAAA,GACnB;AACF","file":"external.cjs","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type ExternalStore<T> = {\n  get: () => T;\n  set: (next: T) => void;\n  subscribe: (cb: Subscriber) => Unsubscribe;\n};\n\nexport const createExternalStoreAdapter = <T>(\n  store: ExternalStore<T>,\n  options?: { kind?: string; patch?: (partial: Partial<T>) => void }\n): SourceAdapter<T> => {\n  return {\n    kind: options?.kind ?? \"external\",\n    get: store.get,\n    set: store.set,\n    patch: options?.patch,\n    subscribe: store.subscribe\n  };\n};\n"]}

package/dist/adapters/external.d.cts

@@ -0,0 +1,13 @@
+import { e as Subscriber, U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.cjs';
+
+type ExternalStore<T> = {
+    get: () => T;
+    set: (next: T) => void;
+    subscribe: (cb: Subscriber) => Unsubscribe;
+};
+declare const createExternalStoreAdapter: <T>(store: ExternalStore<T>, options?: {
+    kind?: string;
+    patch?: (partial: Partial<T>) => void;
+}) => SourceAdapter<T>;
+
+export { type ExternalStore, createExternalStoreAdapter };

package/dist/adapters/external.d.ts

@@ -0,0 +1,13 @@
+import { e as Subscriber, U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.js';
+
+type ExternalStore<T> = {
+    get: () => T;
+    set: (next: T) => void;
+    subscribe: (cb: Subscriber) => Unsubscribe;
+};
+declare const createExternalStoreAdapter: <T>(store: ExternalStore<T>, options?: {
+    kind?: string;
+    patch?: (partial: Partial<T>) => void;
+}) => SourceAdapter<T>;
+
+export { type ExternalStore, createExternalStoreAdapter };

package/dist/adapters/external.js

@@ -0,0 +1,14 @@
+// src/adapters/external.ts
+var createExternalStoreAdapter = (store, options) => {
+  return {
+    kind: options?.kind ?? "external",
+    get: store.get,
+    set: store.set,
+    patch: options?.patch,
+    subscribe: store.subscribe
+  };
+};
+
+export { createExternalStoreAdapter };
+//# sourceMappingURL=external.js.map
+//# sourceMappingURL=external.js.map

package/dist/adapters/external.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/external.ts"],"names":[],"mappings":";AAQO,IAAM,0BAAA,GAA6B,CACxC,KAAA,EACA,OAAA,KACqB;AACrB,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAS,IAAA,IAAQ,UAAA;AAAA,IACvB,KAAK,KAAA,CAAM,GAAA;AAAA,IACX,KAAK,KAAA,CAAM,GAAA;AAAA,IACX,OAAO,OAAA,EAAS,KAAA;AAAA,IAChB,WAAW,KAAA,CAAM;AAAA,GACnB;AACF","file":"external.js","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type ExternalStore<T> = {\n  get: () => T;\n  set: (next: T) => void;\n  subscribe: (cb: Subscriber) => Unsubscribe;\n};\n\nexport const createExternalStoreAdapter = <T>(\n  store: ExternalStore<T>,\n  options?: { kind?: string; patch?: (partial: Partial<T>) => void }\n): SourceAdapter<T> => {\n  return {\n    kind: options?.kind ?? \"external\",\n    get: store.get,\n    set: store.set,\n    patch: options?.patch,\n    subscribe: store.subscribe\n  };\n};\n"]}

package/dist/adapters/query.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+// src/adapters/query.ts
+var createQueryAdapter = (options) => {
+  return {
+    kind: "query",
+    get: () => options.queryClient.getQueryData(options.queryKey),
+    set: (next) => {
+      options.queryClient.setQueryData(options.queryKey, next);
+    },
+    subscribe: (cb) => options.queryClient.getQueryCache().subscribe(cb)
+  };
+};
+
+exports.createQueryAdapter = createQueryAdapter;
+//# sourceMappingURL=query.cjs.map
+//# sourceMappingURL=query.cjs.map

package/dist/adapters/query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/query.ts"],"names":[],"mappings":";;;AAaO,IAAM,kBAAA,GAAqB,CAAI,OAAA,KAAmD;AACvF,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,OAAA;AAAA,IACN,KAAK,MAAM,OAAA,CAAQ,WAAA,CAAY,YAAA,CAAa,QAAQ,QAAQ,CAAA;AAAA,IAC5D,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,MAAA,OAAA,CAAQ,WAAA,CAAY,YAAA,CAAa,OAAA,CAAQ,QAAA,EAAU,IAAI,CAAA;AAAA,IACzD,CAAA;AAAA,IACA,SAAA,EAAW,CAAC,EAAA,KAAmB,OAAA,CAAQ,YAAY,aAAA,EAAc,CAAE,UAAU,EAAE;AAAA,GACjF;AACF","file":"query.cjs","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type QueryClientLike = {\n  getQueryData: (key: unknown) => unknown;\n  setQueryData: (key: unknown, updater: unknown) => void;\n  getQueryCache: () => { subscribe: (listener: () => void) => Unsubscribe };\n};\n\nexport type QueryAdapterOptions = {\n  queryClient: QueryClientLike;\n  queryKey: unknown;\n};\n\nexport const createQueryAdapter = <T>(options: QueryAdapterOptions): SourceAdapter<T> => {\n  return {\n    kind: \"query\",\n    get: () => options.queryClient.getQueryData(options.queryKey) as T,\n    set: (next) => {\n      options.queryClient.setQueryData(options.queryKey, next);\n    },\n    subscribe: (cb: Subscriber) => options.queryClient.getQueryCache().subscribe(cb)\n  };\n};\n"]}

package/dist/adapters/query.d.cts

@@ -0,0 +1,16 @@
+import { U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.cjs';
+
+type QueryClientLike = {
+    getQueryData: (key: unknown) => unknown;
+    setQueryData: (key: unknown, updater: unknown) => void;
+    getQueryCache: () => {
+        subscribe: (listener: () => void) => Unsubscribe;
+    };
+};
+type QueryAdapterOptions = {
+    queryClient: QueryClientLike;
+    queryKey: unknown;
+};
+declare const createQueryAdapter: <T>(options: QueryAdapterOptions) => SourceAdapter<T>;
+
+export { type QueryAdapterOptions, type QueryClientLike, createQueryAdapter };

package/dist/adapters/query.d.ts

@@ -0,0 +1,16 @@
+import { U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.js';
+
+type QueryClientLike = {
+    getQueryData: (key: unknown) => unknown;
+    setQueryData: (key: unknown, updater: unknown) => void;
+    getQueryCache: () => {
+        subscribe: (listener: () => void) => Unsubscribe;
+    };
+};
+type QueryAdapterOptions = {
+    queryClient: QueryClientLike;
+    queryKey: unknown;
+};
+declare const createQueryAdapter: <T>(options: QueryAdapterOptions) => SourceAdapter<T>;
+
+export { type QueryAdapterOptions, type QueryClientLike, createQueryAdapter };

package/dist/adapters/query.js

@@ -0,0 +1,15 @@
+// src/adapters/query.ts
+var createQueryAdapter = (options) => {
+  return {
+    kind: "query",
+    get: () => options.queryClient.getQueryData(options.queryKey),
+    set: (next) => {
+      options.queryClient.setQueryData(options.queryKey, next);
+    },
+    subscribe: (cb) => options.queryClient.getQueryCache().subscribe(cb)
+  };
+};
+
+export { createQueryAdapter };
+//# sourceMappingURL=query.js.map
+//# sourceMappingURL=query.js.map

package/dist/adapters/query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/query.ts"],"names":[],"mappings":";AAaO,IAAM,kBAAA,GAAqB,CAAI,OAAA,KAAmD;AACvF,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,OAAA;AAAA,IACN,KAAK,MAAM,OAAA,CAAQ,WAAA,CAAY,YAAA,CAAa,QAAQ,QAAQ,CAAA;AAAA,IAC5D,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,MAAA,OAAA,CAAQ,WAAA,CAAY,YAAA,CAAa,OAAA,CAAQ,QAAA,EAAU,IAAI,CAAA;AAAA,IACzD,CAAA;AAAA,IACA,SAAA,EAAW,CAAC,EAAA,KAAmB,OAAA,CAAQ,YAAY,aAAA,EAAc,CAAE,UAAU,EAAE;AAAA,GACjF;AACF","file":"query.js","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type QueryClientLike = {\n  getQueryData: (key: unknown) => unknown;\n  setQueryData: (key: unknown, updater: unknown) => void;\n  getQueryCache: () => { subscribe: (listener: () => void) => Unsubscribe };\n};\n\nexport type QueryAdapterOptions = {\n  queryClient: QueryClientLike;\n  queryKey: unknown;\n};\n\nexport const createQueryAdapter = <T>(options: QueryAdapterOptions): SourceAdapter<T> => {\n  return {\n    kind: \"query\",\n    get: () => options.queryClient.getQueryData(options.queryKey) as T,\n    set: (next) => {\n      options.queryClient.setQueryData(options.queryKey, next);\n    },\n    subscribe: (cb: Subscriber) => options.queryClient.getQueryCache().subscribe(cb)\n  };\n};\n"]}

package/dist/adapters/redux.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+// src/adapters/redux.ts
+var createReduxAdapter = (store, options) => {
+  return {
+    kind: "redux",
+    get: () => options.select(store.getState()),
+    set: (next) => {
+      store.dispatch(options.update(next));
+    },
+    patch: options.patch ? (partial) => {
+      store.dispatch(options.patch?.(partial));
+    } : void 0,
+    subscribe: (cb) => store.subscribe(cb)
+  };
+};
+
+exports.createReduxAdapter = createReduxAdapter;
+//# sourceMappingURL=redux.cjs.map
+//# sourceMappingURL=redux.cjs.map

package/dist/adapters/redux.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/redux.ts"],"names":[],"mappings":";;;AAcO,IAAM,kBAAA,GAAqB,CAChC,KAAA,EACA,OAAA,KACyB;AACzB,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,OAAA;AAAA,IACN,KAAK,MAAM,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,UAAU,CAAA;AAAA,IAC1C,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,MAAA,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,KAAA,EAAO,OAAA,CAAQ,KAAA,GACX,CAAC,OAAA,KAAY;AACX,MAAA,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,KAAA,GAAQ,OAAO,CAAC,CAAA;AAAA,IACzC,CAAA,GACA,MAAA;AAAA,IACJ,SAAA,EAAW,CAAC,EAAA,KAAmB,KAAA,CAAM,UAAU,EAAE;AAAA,GACnD;AACF","file":"redux.cjs","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type ReduxStore<State> = {\n  getState: () => State;\n  dispatch: (action: unknown) => unknown;\n  subscribe: (listener: () => void) => Unsubscribe;\n};\n\nexport type ReduxAdapterOptions<State, Slice> = {\n  select: (state: State) => Slice;\n  update: (next: Slice) => unknown;\n  patch?: (partial: Partial<Slice>) => unknown;\n};\n\nexport const createReduxAdapter = <State, Slice>(\n  store: ReduxStore<State>,\n  options: ReduxAdapterOptions<State, Slice>\n): SourceAdapter<Slice> => {\n  return {\n    kind: \"redux\",\n    get: () => options.select(store.getState()),\n    set: (next) => {\n      store.dispatch(options.update(next));\n    },\n    patch: options.patch\n      ? (partial) => {\n          store.dispatch(options.patch?.(partial));\n        }\n      : undefined,\n    subscribe: (cb: Subscriber) => store.subscribe(cb)\n  };\n};\n"]}

package/dist/adapters/redux.d.cts

@@ -0,0 +1,15 @@
+import { U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.cjs';
+
+type ReduxStore<State> = {
+    getState: () => State;
+    dispatch: (action: unknown) => unknown;
+    subscribe: (listener: () => void) => Unsubscribe;
+};
+type ReduxAdapterOptions<State, Slice> = {
+    select: (state: State) => Slice;
+    update: (next: Slice) => unknown;
+    patch?: (partial: Partial<Slice>) => unknown;
+};
+declare const createReduxAdapter: <State, Slice>(store: ReduxStore<State>, options: ReduxAdapterOptions<State, Slice>) => SourceAdapter<Slice>;
+
+export { type ReduxAdapterOptions, type ReduxStore, createReduxAdapter };

package/dist/adapters/redux.d.ts

@@ -0,0 +1,15 @@
+import { U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.js';
+
+type ReduxStore<State> = {
+    getState: () => State;
+    dispatch: (action: unknown) => unknown;
+    subscribe: (listener: () => void) => Unsubscribe;
+};
+type ReduxAdapterOptions<State, Slice> = {
+    select: (state: State) => Slice;
+    update: (next: Slice) => unknown;
+    patch?: (partial: Partial<Slice>) => unknown;
+};
+declare const createReduxAdapter: <State, Slice>(store: ReduxStore<State>, options: ReduxAdapterOptions<State, Slice>) => SourceAdapter<Slice>;
+
+export { type ReduxAdapterOptions, type ReduxStore, createReduxAdapter };

package/dist/adapters/redux.js

@@ -0,0 +1,18 @@
+// src/adapters/redux.ts
+var createReduxAdapter = (store, options) => {
+  return {
+    kind: "redux",
+    get: () => options.select(store.getState()),
+    set: (next) => {
+      store.dispatch(options.update(next));
+    },
+    patch: options.patch ? (partial) => {
+      store.dispatch(options.patch?.(partial));
+    } : void 0,
+    subscribe: (cb) => store.subscribe(cb)
+  };
+};
+
+export { createReduxAdapter };
+//# sourceMappingURL=redux.js.map
+//# sourceMappingURL=redux.js.map

package/dist/adapters/redux.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/redux.ts"],"names":[],"mappings":";AAcO,IAAM,kBAAA,GAAqB,CAChC,KAAA,EACA,OAAA,KACyB;AACzB,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,OAAA;AAAA,IACN,KAAK,MAAM,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,UAAU,CAAA;AAAA,IAC1C,GAAA,EAAK,CAAC,IAAA,KAAS;AACb,MAAA,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,IACrC,CAAA;AAAA,IACA,KAAA,EAAO,OAAA,CAAQ,KAAA,GACX,CAAC,OAAA,KAAY;AACX,MAAA,KAAA,CAAM,QAAA,CAAS,OAAA,CAAQ,KAAA,GAAQ,OAAO,CAAC,CAAA;AAAA,IACzC,CAAA,GACA,MAAA;AAAA,IACJ,SAAA,EAAW,CAAC,EAAA,KAAmB,KAAA,CAAM,UAAU,EAAE;AAAA,GACnD;AACF","file":"redux.js","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type ReduxStore<State> = {\n  getState: () => State;\n  dispatch: (action: unknown) => unknown;\n  subscribe: (listener: () => void) => Unsubscribe;\n};\n\nexport type ReduxAdapterOptions<State, Slice> = {\n  select: (state: State) => Slice;\n  update: (next: Slice) => unknown;\n  patch?: (partial: Partial<Slice>) => unknown;\n};\n\nexport const createReduxAdapter = <State, Slice>(\n  store: ReduxStore<State>,\n  options: ReduxAdapterOptions<State, Slice>\n): SourceAdapter<Slice> => {\n  return {\n    kind: \"redux\",\n    get: () => options.select(store.getState()),\n    set: (next) => {\n      store.dispatch(options.update(next));\n    },\n    patch: options.patch\n      ? (partial) => {\n          store.dispatch(options.patch?.(partial));\n        }\n      : undefined,\n    subscribe: (cb: Subscriber) => store.subscribe(cb)\n  };\n};\n"]}

package/dist/adapters/url.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+// src/adapters/url.ts
+var defaultGetParams = () => {
+  if (typeof window === "undefined") {
+    return new URLSearchParams();
+  }
+  return new URLSearchParams(window.location.search);
+};
+var defaultSetParams = (params) => {
+  if (typeof window === "undefined") {
+    return;
+  }
+  const url = `${window.location.pathname}?${params.toString()}${window.location.hash}`;
+  window.history.replaceState({}, "", url);
+};
+var defaultSubscribe = (cb) => {
+  if (typeof window === "undefined") {
+    return () => void 0;
+  }
+  const handler = () => cb();
+  window.addEventListener("popstate", handler);
+  return () => window.removeEventListener("popstate", handler);
+};
+var createUrlParamsAdapter = (options) => {
+  const getParams = options.getSearchParams ?? defaultGetParams;
+  const setParams = options.setSearchParams ?? defaultSetParams;
+  const subscribe = options.subscribe ?? defaultSubscribe;
+  return {
+    kind: options.kind ?? "url",
+    get: () => options.parse(getParams()),
+    set: (next) => setParams(options.serialize(next)),
+    subscribe
+  };
+};
+
+exports.createUrlParamsAdapter = createUrlParamsAdapter;
+//# sourceMappingURL=url.cjs.map
+//# sourceMappingURL=url.cjs.map

package/dist/adapters/url.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/url.ts"],"names":[],"mappings":";;;AAWA,IAAM,mBAAmB,MAAM;AAC7B,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,OAAO,IAAI,eAAA,EAAgB;AAAA,EAC7B;AACA,EAAA,OAAO,IAAI,eAAA,CAAgB,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA;AACnD,CAAA;AAEA,IAAM,gBAAA,GAAmB,CAAC,MAAA,KAA4B;AACpD,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA;AAAA,EACF;AACA,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,QAAQ,CAAA,CAAA,EAAI,MAAA,CAAO,QAAA,EAAU,CAAA,EAAG,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA,CAAA;AACnF,EAAA,MAAA,CAAO,OAAA,CAAQ,YAAA,CAAa,EAAC,EAAG,IAAI,GAAG,CAAA;AACzC,CAAA;AAEA,IAAM,gBAAA,GAAmB,CAAC,EAAA,KAAgC;AACxD,EAAA,IAAI,OAAO,WAAW,WAAA,EAAa;AACjC,IAAA,OAAO,MAAM,MAAA;AAAA,EACf;AACA,EAAA,MAAM,OAAA,GAAU,MAAM,EAAA,EAAG;AACzB,EAAA,MAAA,CAAO,gBAAA,CAAiB,YAAY,OAAO,CAAA;AAC3C,EAAA,OAAO,MAAM,MAAA,CAAO,mBAAA,CAAoB,UAAA,EAAY,OAAO,CAAA;AAC7D,CAAA;AAEO,IAAM,sBAAA,GAAyB,CACpC,OAAA,KACqB;AACrB,EAAA,MAAM,SAAA,GAAY,QAAQ,eAAA,IAAmB,gBAAA;AAC7C,EAAA,MAAM,SAAA,GAAY,QAAQ,eAAA,IAAmB,gBAAA;AAC7C,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,gBAAA;AAEvC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,QAAQ,IAAA,IAAQ,KAAA;AAAA,IACtB,GAAA,EAAK,MAAM,OAAA,CAAQ,KAAA,CAAM,WAAW,CAAA;AAAA,IACpC,KAAK,CAAC,IAAA,KAAS,UAAU,OAAA,CAAQ,SAAA,CAAU,IAAI,CAAC,CAAA;AAAA,IAChD;AAAA,GACF;AACF","file":"url.cjs","sourcesContent":["import type { SourceAdapter, Subscriber, Unsubscribe } from \"../core/types\";\n\nexport type UrlAdapterOptions<T> = {\n  parse: (params: URLSearchParams) => T;\n  serialize: (value: T) => URLSearchParams;\n  getSearchParams?: () => URLSearchParams;\n  setSearchParams?: (params: URLSearchParams) => void;\n  subscribe?: (cb: Subscriber) => Unsubscribe;\n  kind?: string;\n};\n\nconst defaultGetParams = () => {\n  if (typeof window === \"undefined\") {\n    return new URLSearchParams();\n  }\n  return new URLSearchParams(window.location.search);\n};\n\nconst defaultSetParams = (params: URLSearchParams) => {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n  const url = `${window.location.pathname}?${params.toString()}${window.location.hash}`;\n  window.history.replaceState({}, \"\", url);\n};\n\nconst defaultSubscribe = (cb: Subscriber): Unsubscribe => {\n  if (typeof window === \"undefined\") {\n    return () => undefined;\n  }\n  const handler = () => cb();\n  window.addEventListener(\"popstate\", handler);\n  return () => window.removeEventListener(\"popstate\", handler);\n};\n\nexport const createUrlParamsAdapter = <T>(\n  options: UrlAdapterOptions<T>\n): SourceAdapter<T> => {\n  const getParams = options.getSearchParams ?? defaultGetParams;\n  const setParams = options.setSearchParams ?? defaultSetParams;\n  const subscribe = options.subscribe ?? defaultSubscribe;\n\n  return {\n    kind: options.kind ?? \"url\",\n    get: () => options.parse(getParams()),\n    set: (next) => setParams(options.serialize(next)),\n    subscribe\n  };\n};\n"]}

package/dist/adapters/url.d.cts

@@ -0,0 +1,13 @@
+import { e as Subscriber, U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.cjs';
+
+type UrlAdapterOptions<T> = {
+    parse: (params: URLSearchParams) => T;
+    serialize: (value: T) => URLSearchParams;
+    getSearchParams?: () => URLSearchParams;
+    setSearchParams?: (params: URLSearchParams) => void;
+    subscribe?: (cb: Subscriber) => Unsubscribe;
+    kind?: string;
+};
+declare const createUrlParamsAdapter: <T>(options: UrlAdapterOptions<T>) => SourceAdapter<T>;
+
+export { type UrlAdapterOptions, createUrlParamsAdapter };

package/dist/adapters/url.d.ts

@@ -0,0 +1,13 @@
+import { e as Subscriber, U as Unsubscribe, d as SourceAdapter } from '../types-B1uzdpYH.js';
+
+type UrlAdapterOptions<T> = {
+    parse: (params: URLSearchParams) => T;
+    serialize: (value: T) => URLSearchParams;
+    getSearchParams?: () => URLSearchParams;
+    setSearchParams?: (params: URLSearchParams) => void;
+    subscribe?: (cb: Subscriber) => Unsubscribe;
+    kind?: string;
+};
+declare const createUrlParamsAdapter: <T>(options: UrlAdapterOptions<T>) => SourceAdapter<T>;
+
+export { type UrlAdapterOptions, createUrlParamsAdapter };