@lunarhue/store 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LunarHUE
+
+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,63 @@
+# `@lunarhue/store`
+
+Framework-agnostic state built on top of `@tanstack/store`, with plugin
+composition and React bindings.
+
+## Install
+
+```sh
+npm install @lunarhue/store
+```
+
+## Entry points
+
+- `@lunarhue/store/core`
+- `@lunarhue/store/react`
+- `@lunarhue/store/plugins/actions`
+- `@lunarhue/store/plugins/persist`
+
+There is no root package barrel export.
+
+## Basic usage
+
+```ts
+import { createStore } from '@lunarhue/store/core'
+
+const CounterStore = createStore({
+  count: 0,
+})
+
+const store = CounterStore.create()
+
+store.setState((prev) => ({
+  ...prev,
+  count: prev.count + 1,
+}))
+```
+
+## React usage
+
+```tsx
+import { createStore } from '@lunarhue/store/core'
+import { StoreProvider, useStoreSelector } from '@lunarhue/store/react'
+
+const CounterStore = createStore({ count: 0 })
+
+function CounterValue() {
+  const count = useStoreSelector(CounterStore, (state) => state.count)
+  return <span>{count}</span>
+}
+
+function App() {
+  return (
+    <StoreProvider builder={CounterStore}>
+      <CounterValue />
+    </StoreProvider>
+  )
+}
+```
+
+## Docs
+
+- Repo README: https://github.com/LunarHUE/store#readme
+- API and architecture docs: https://github.com/LunarHUE/store/tree/main/docs

package/dist/chunk-IP5Y4BHA.js

@@ -0,0 +1,103 @@
+import { getStoreBuilder } from './chunk-PCSRXZL4.js';
+import { useRef, useEffect, useContext, createContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+import { useStore as useStore$1 } from '@tanstack/react-store';
+
+var contextMap = /* @__PURE__ */ new WeakMap();
+function getStoreContext(builder) {
+  let context = contextMap.get(builder);
+  if (!context) {
+    context = createContext(void 0);
+    contextMap.set(builder, context);
+  }
+  return context;
+}
+function StoreProvider(props) {
+  if (props.builder !== void 0) {
+    return /* @__PURE__ */ jsx(BuilderOwnedStoreProvider, { builder: props.builder, children: props.children });
+  }
+  return /* @__PURE__ */ jsx(ExternalStoreProvider, { store: props.store, children: props.children });
+}
+function BuilderOwnedStoreProvider({
+  builder,
+  children
+}) {
+  const context = getStoreContext(builder);
+  const builderRef = useRef(null);
+  const storeRef = useRef(null);
+  if (!builderRef.current) {
+    builderRef.current = builder;
+  } else if (builderRef.current !== builder) {
+    throw new Error("StoreProvider builder prop must remain stable.");
+  }
+  if (!storeRef.current) {
+    storeRef.current = builder.create();
+  }
+  useEffect(() => {
+    const ownedStore = storeRef.current;
+    return () => {
+      if (!ownedStore) {
+        return;
+      }
+      void ownedStore.dispose();
+    };
+  }, []);
+  const content = typeof children === "function" ? children({ store: storeRef.current }) : children;
+  return /* @__PURE__ */ jsx(context.Provider, { value: storeRef.current, children: content });
+}
+function ExternalStoreProvider({
+  children,
+  store
+}) {
+  const builder = getStoreBuilder(store);
+  if (!builder) {
+    throw new Error(
+      "StoreProvider could not resolve a builder for the provided store. Pass a store created by @lunarhue/store."
+    );
+  }
+  const context = getStoreContext(builder);
+  const content = typeof children === "function" ? children({ store }) : children;
+  return /* @__PURE__ */ jsx(context.Provider, { value: store, children: content });
+}
+function useLocalStore(builder) {
+  const localStoreRef = useRef(null);
+  if (!localStoreRef.current) {
+    localStoreRef.current = builder.create();
+  }
+  useEffect(() => {
+    const localStore = localStoreRef.current;
+    return () => {
+      if (!localStore) {
+        return;
+      }
+      void localStore.dispose();
+    };
+  }, []);
+  return localStoreRef.current;
+}
+function useSelector(store, selector, compare) {
+  return useStore$1(
+    store,
+    selector,
+    compare
+  );
+}
+function useStore(builder) {
+  const contextValue = useContext(getStoreContext(builder));
+  if (!contextValue) {
+    throw new Error(
+      "useStore(builder) requires a matching <StoreProvider builder={...}> or <StoreProvider store={...}> ancestor."
+    );
+  }
+  return contextValue;
+}
+
+// src/react/use-store-selector.ts
+function useStoreSelector(builder, selector, compare) {
+  const store = useStore(builder);
+  return useSelector(store, selector, compare);
+}
+
+export { StoreProvider, useLocalStore, useSelector, useStore, useStoreSelector };
+//# sourceMappingURL=chunk-IP5Y4BHA.js.map
+//# sourceMappingURL=chunk-IP5Y4BHA.js.map

package/dist/chunk-IP5Y4BHA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/context.ts","../src/react/provider.tsx","../src/react/use-local-store.ts","../src/react/use-selector.ts","../src/react/use-store.ts","../src/react/use-store-selector.ts"],"names":["useRef","useEffect","useTanStackStore"],"mappings":"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","file":"chunk-IP5Y4BHA.js","sourcesContent":["import { createContext, type Context } from 'react'\n\nimport type { Store, StoreBuilder } from '../core'\n\nexport type StoreContext<TState, TPlugins> = Context<\n  Store<TState, TPlugins> | undefined\n>\n\nconst contextMap = new WeakMap<StoreBuilder<any, any>, StoreContext<any, any>>()\n\nexport function getStoreContext<TState, TPlugins>(\n  builder: StoreBuilder<TState, TPlugins>,\n): StoreContext<TState, TPlugins> {\n  let context = contextMap.get(builder)\n\n  if (!context) {\n    context = createContext<Store<TState, TPlugins> | undefined>(undefined)\n    contextMap.set(builder, context)\n  }\n\n  return context\n}\n","import { useEffect, useRef, type ReactNode } from 'react'\n\nimport { getStoreBuilder } from '../core/builder-registry'\nimport { getStoreContext } from './context'\n\nimport type { Store, StoreBuilder } from '../core'\n\ntype StoreProviderChildren<TState, TPlugins> =\n  | ReactNode\n  | ((args: { store: Store<TState, TPlugins> }) => ReactNode)\n\ntype BuilderProviderProps<TState, TPlugins> = {\n  builder: StoreBuilder<TState, TPlugins>\n  children?: StoreProviderChildren<TState, TPlugins>\n  store?: never\n}\n\ntype StoreProviderProps<TState, TPlugins> = {\n  builder?: never\n  children?: StoreProviderChildren<TState, TPlugins>\n  store: Store<TState, TPlugins>\n}\n\nexport type ProviderProps<TState, TPlugins> =\n  | BuilderProviderProps<TState, TPlugins>\n  | StoreProviderProps<TState, TPlugins>\n\nexport function StoreProvider<TState, TPlugins>(\n  props: ProviderProps<TState, TPlugins>,\n) {\n  if (props.builder !== undefined) {\n    return (\n      <BuilderOwnedStoreProvider builder={props.builder}>\n        {props.children}\n      </BuilderOwnedStoreProvider>\n    )\n  }\n\n  return (\n    <ExternalStoreProvider store={props.store}>\n      {props.children}\n    </ExternalStoreProvider>\n  )\n}\n\nfunction BuilderOwnedStoreProvider<TState, TPlugins>({\n  builder,\n  children,\n}: BuilderProviderProps<TState, TPlugins>) {\n  const context = getStoreContext(builder)\n  const builderRef = useRef<StoreBuilder<TState, TPlugins> | null>(null)\n  const storeRef = useRef<Store<TState, TPlugins> | null>(null)\n\n  if (!builderRef.current) {\n    builderRef.current = builder\n  } else if (builderRef.current !== builder) {\n    throw new Error('StoreProvider builder prop must remain stable.')\n  }\n\n  if (!storeRef.current) {\n    storeRef.current = builder.create()\n  }\n\n  useEffect(() => {\n    const ownedStore = storeRef.current\n\n    return () => {\n      if (!ownedStore) {\n        return\n      }\n\n      void ownedStore.dispose()\n    }\n  }, [])\n\n  const content =\n    typeof children === 'function'\n      ? children({ store: storeRef.current })\n      : children\n\n  return <context.Provider value={storeRef.current}>{content}</context.Provider>\n}\n\nfunction ExternalStoreProvider<TState, TPlugins>({\n  children,\n  store,\n}: StoreProviderProps<TState, TPlugins>) {\n  const builder = getStoreBuilder(store)\n\n  if (!builder) {\n    throw new Error(\n      'StoreProvider could not resolve a builder for the provided store. Pass a store created by @lunarhue/store.',\n    )\n  }\n\n  const context = getStoreContext(builder)\n  const content = typeof children === 'function' ? children({ store }) : children\n\n  return <context.Provider value={store}>{content}</context.Provider>\n}\n","import { useEffect, useRef } from 'react'\n\nimport type { Store, StoreBuilder } from '../core'\n\nexport function useLocalStore<TState, TPlugins>(\n  builder: StoreBuilder<TState, TPlugins>,\n): Store<TState, TPlugins> {\n  const localStoreRef = useRef<Store<TState, TPlugins> | null>(null)\n\n  if (!localStoreRef.current) {\n    localStoreRef.current = builder.create()\n  }\n\n  useEffect(() => {\n    const localStore = localStoreRef.current\n\n    return () => {\n      if (!localStore) {\n        return\n      }\n\n      void localStore.dispose()\n    }\n  }, [])\n\n  return localStoreRef.current\n}\n","import { useStore as useTanStackStore } from '@tanstack/react-store'\n\nimport type { AnyStore, StoreState, TanStackStore } from '../core'\n\nexport function useSelector<\n  TStore extends AnyStore,\n  TSelected,\n  TState extends StoreState<TStore>,\n>(\n  store: TStore,\n  selector: (snapshot: TState) => TSelected,\n  compare?: (a: TSelected, b: TSelected) => boolean,\n): TSelected {\n  return useTanStackStore<TanStackStore<TState>, TSelected>(\n    store as TanStackStore<TState>,\n    selector,\n    compare,\n  )\n}\n","import { useContext } from 'react'\n\nimport { getStoreContext } from './context'\n\nimport type { Store, StoreBuilder } from '../core'\n\nexport function useStore<TState, TPlugins>(\n  builder: StoreBuilder<TState, TPlugins>,\n): Store<TState, TPlugins> {\n  const contextValue = useContext(getStoreContext(builder))\n\n  if (!contextValue) {\n    throw new Error(\n      'useStore(builder) requires a matching <StoreProvider builder={...}> or <StoreProvider store={...}> ancestor.',\n    )\n  }\n\n  return contextValue\n}\n","import { useStore } from './use-store'\nimport { useSelector } from './use-selector'\n\nimport type { StoreBuilder, StoreState } from '../core'\n\nexport function useStoreSelector<\n  TState,\n  TPlugins,\n  TSelected,\n  TBuilder extends StoreBuilder<TState, TPlugins>,\n>(\n  builder: TBuilder,\n  selector: (snapshot: StoreState<ReturnType<TBuilder['create']>>) => TSelected,\n  compare?: (a: TSelected, b: TSelected) => boolean,\n): TSelected {\n  const store = useStore(builder)\n\n  return useSelector(store, selector, compare)\n}\n"]}

package/dist/chunk-MIBJNMOV.js

@@ -0,0 +1,45 @@
+import { createStore } from '@tanstack/store';
+
+// src/core/store-instance.ts
+function createStoreInstance(initialState) {
+  const store = createStore(initialState);
+  const cleanups = [];
+  let disposePromise = null;
+  const instance = store;
+  Object.defineProperty(instance, "dispose", {
+    configurable: true,
+    enumerable: true,
+    value: async () => {
+      if (disposePromise) {
+        return disposePromise;
+      }
+      disposePromise = (async () => {
+        for (const cleanup of [...cleanups].reverse()) {
+          await cleanup();
+        }
+      })();
+      return disposePromise;
+    }
+  });
+  return {
+    store: instance,
+    onDispose(cleanup) {
+      cleanups.push(cleanup);
+    },
+    attachSurface(surface) {
+      for (const key of Reflect.ownKeys(surface)) {
+        if (key in instance) {
+          throw new Error(`Store plugin surface collision on "${String(key)}".`);
+        }
+      }
+      Object.defineProperties(
+        instance,
+        Object.getOwnPropertyDescriptors(surface)
+      );
+    }
+  };
+}
+
+export { createStoreInstance };
+//# sourceMappingURL=chunk-MIBJNMOV.js.map
+//# sourceMappingURL=chunk-MIBJNMOV.js.map

package/dist/chunk-MIBJNMOV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/store-instance.ts"],"names":["createTanStackStore"],"mappings":";;;AAUO,SAAS,oBACd,YAAA,EACyB;AACzB,EAAA,MAAM,KAAA,GAAQA,YAAoB,YAAY,CAAA;AAC9C,EAAA,MAAM,WAA2B,EAAC;AAClC,EAAA,IAAI,cAAA,GAAuC,IAAA;AAE3C,EAAA,MAAM,QAAA,GAAW,KAAA;AAEjB,EAAA,MAAA,CAAO,cAAA,CAAe,UAAU,SAAA,EAAW;AAAA,IACzC,YAAA,EAAc,IAAA;AAAA,IACd,UAAA,EAAY,IAAA;AAAA,IACZ,OAAO,YAAY;AACjB,MAAA,IAAI,cAAA,EAAgB;AAClB,QAAA,OAAO,cAAA;AAAA,MACT;AAEA,MAAA,cAAA,GAAA,CAAkB,YAAY;AAC5B,QAAA,KAAA,MAAW,WAAW,CAAC,GAAG,QAAQ,CAAA,CAAE,SAAQ,EAAG;AAC7C,UAAA,MAAM,OAAA,EAAQ;AAAA,QAChB;AAAA,MACF,CAAA,GAAG;AAEH,MAAA,OAAO,cAAA;AAAA,IACT;AAAA,GACD,CAAA;AAED,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,QAAA;AAAA,IACP,UAAU,OAAA,EAAS;AACjB,MAAA,QAAA,CAAS,KAAK,OAAO,CAAA;AAAA,IACvB,CAAA;AAAA,IACA,cAAc,OAAA,EAAS;AACrB,MAAA,KAAA,MAAW,GAAA,IAAO,OAAA,CAAQ,OAAA,CAAQ,OAAO,CAAA,EAAG;AAC1C,QAAA,IAAI,OAAO,QAAA,EAAU;AACnB,UAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mCAAA,EAAsC,MAAA,CAAO,GAAG,CAAC,CAAA,EAAA,CAAI,CAAA;AAAA,QACvE;AAAA,MACF;AAEA,MAAA,MAAA,CAAO,gBAAA;AAAA,QACL,QAAA;AAAA,QACA,MAAA,CAAO,0BAA0B,OAAO;AAAA,OAC1C;AAAA,IACF;AAAA,GACF;AACF","file":"chunk-MIBJNMOV.js","sourcesContent":["import { createStore as createTanStackStore } from '@tanstack/store'\n\nimport type { StoreCleanup, Store } from './types'\n\ntype StoreController<TState> = {\n  store: Store<TState>\n  onDispose(cleanup: StoreCleanup): void\n  attachSurface(surface: object): void\n}\n\nexport function createStoreInstance<TState>(\n  initialState: TState,\n): StoreController<TState> {\n  const store = createTanStackStore(initialState)\n  const cleanups: StoreCleanup[] = []\n  let disposePromise: Promise<void> | null = null\n\n  const instance = store as Store<TState>\n\n  Object.defineProperty(instance, 'dispose', {\n    configurable: true,\n    enumerable: true,\n    value: async () => {\n      if (disposePromise) {\n        return disposePromise\n      }\n\n      disposePromise = (async () => {\n        for (const cleanup of [...cleanups].reverse()) {\n          await cleanup()\n        }\n      })()\n\n      return disposePromise\n    },\n  })\n\n  return {\n    store: instance,\n    onDispose(cleanup) {\n      cleanups.push(cleanup)\n    },\n    attachSurface(surface) {\n      for (const key of Reflect.ownKeys(surface)) {\n        if (key in instance) {\n          throw new Error(`Store plugin surface collision on \"${String(key)}\".`)\n        }\n      }\n\n      Object.defineProperties(\n        instance,\n        Object.getOwnPropertyDescriptors(surface),\n      )\n    },\n  }\n}\n"]}

package/dist/chunk-PCSRXZL4.js

@@ -0,0 +1,12 @@
+// src/core/builder-registry.ts
+var storeBuilderMap = /* @__PURE__ */ new WeakMap();
+function registerStoreBuilder(store, builder) {
+  storeBuilderMap.set(store, builder);
+}
+function getStoreBuilder(store) {
+  return storeBuilderMap.get(store);
+}
+
+export { getStoreBuilder, registerStoreBuilder };
+//# sourceMappingURL=chunk-PCSRXZL4.js.map
+//# sourceMappingURL=chunk-PCSRXZL4.js.map

package/dist/chunk-PCSRXZL4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/builder-registry.ts"],"names":[],"mappings":";AAEA,IAAM,eAAA,uBAAsB,OAAA,EAAiD;AAEtE,SAAS,oBAAA,CACd,OACA,OAAA,EACM;AACN,EAAA,eAAA,CAAgB,GAAA,CAAI,OAAO,OAAO,CAAA;AACpC;AAEO,SAAS,gBACd,KAAA,EAC4C;AAC5C,EAAA,OAAO,eAAA,CAAgB,IAAI,KAAK,CAAA;AAClC","file":"chunk-PCSRXZL4.js","sourcesContent":["import type { Store, StoreBuilder } from './types'\n\nconst storeBuilderMap = new WeakMap<Store<any, any>, StoreBuilder<any, any>>()\n\nexport function registerStoreBuilder<TState, TPlugins>(\n  store: Store<TState, TPlugins>,\n  builder: StoreBuilder<TState, TPlugins>,\n): void {\n  storeBuilderMap.set(store, builder)\n}\n\nexport function getStoreBuilder<TState, TPlugins>(\n  store: Store<TState, TPlugins>,\n): StoreBuilder<TState, TPlugins> | undefined {\n  return storeBuilderMap.get(store) as StoreBuilder<TState, TPlugins> | undefined\n}\n"]}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+import { S as StoreBuilder } from '../types-ByMGdUb-.js';
+export { A as AnyStore, a as Store, b as StoreBrand, c as StoreCleanup, d as StorePlugin, e as StorePluginContext, f as StorePlugins, g as StoreState, T as TanStackStore } from '../types-ByMGdUb-.js';
+import '@tanstack/store';
+
+declare function createStore<TState>(initialState: TState): StoreBuilder<TState>;
+
+export { StoreBuilder, createStore };

package/dist/core/index.js

@@ -0,0 +1,32 @@
+import { createStoreInstance } from '../chunk-MIBJNMOV.js';
+import { registerStoreBuilder } from '../chunk-PCSRXZL4.js';
+
+// src/core/create-store.ts
+function createStore(initialState) {
+  const createBuilder = (plugins) => {
+    const builder = {
+      create() {
+        const controller = createStoreInstance(initialState);
+        for (const plugin of plugins) {
+          const surface = plugin({
+            store: controller.store,
+            onDispose: (cleanup) => controller.onDispose(cleanup)
+          });
+          controller.attachSurface(surface);
+        }
+        const store = controller.store;
+        registerStoreBuilder(store, builder);
+        return store;
+      },
+      extend(plugin) {
+        return createBuilder([...plugins, plugin]);
+      }
+    };
+    return builder;
+  };
+  return createBuilder([]);
+}
+
+export { createStore };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/create-store.ts"],"names":[],"mappings":";;;;AAMO,SAAS,YACd,YAAA,EACsB;AAGtB,EAAA,MAAM,aAAA,GAAgB,CACpB,OAAA,KACmC;AACnC,IAAA,MAAM,OAAA,GAA0C;AAAA,MAC9C,MAAA,GAAS;AACP,QAAA,MAAM,UAAA,GAAa,oBAAoB,YAAY,CAAA;AAEnD,QAAA,KAAA,MAAW,UAAU,OAAA,EAAS;AAC5B,UAAA,MAAM,UAAU,MAAA,CAAO;AAAA,YACrB,OAAO,UAAA,CAAW,KAAA;AAAA,YAClB,SAAA,EAAW,CAAC,OAAA,KAAY,UAAA,CAAW,UAAU,OAAO;AAAA,WACrD,CAAA;AAED,UAAA,UAAA,CAAW,cAAc,OAAO,CAAA;AAAA,QAClC;AAEA,QAAA,MAAM,QAAQ,UAAA,CAAW,KAAA;AACzB,QAAA,oBAAA,CAAqB,OAAO,OAAO,CAAA;AAEnC,QAAA,OAAO,KAAA;AAAA,MACT,CAAA;AAAA,MACA,OACE,MAAA,EACA;AACA,QAAA,OAAO,aAAA,CAAuC,CAAC,GAAG,OAAA,EAAS,MAAM,CAAC,CAAA;AAAA,MACpE;AAAA,KACF;AAEA,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO,aAAA,CAAkB,EAAE,CAAA;AAC7B","file":"index.js","sourcesContent":["\nimport { createStoreInstance } from './store-instance'\nimport { registerStoreBuilder } from './builder-registry'\n\nimport type { Store, StoreBuilder, StorePlugin } from './types'\n\nexport function createStore<TState>(\n  initialState: TState,\n): StoreBuilder<TState> {\n  type PluginList = ReadonlyArray<StorePlugin<TState, any, any>>\n\n  const createBuilder = <TPlugins>(\n    plugins: PluginList,\n  ): StoreBuilder<TState, TPlugins> => {\n    const builder: StoreBuilder<TState, TPlugins> = {\n      create() {\n        const controller = createStoreInstance(initialState)\n\n        for (const plugin of plugins) {\n          const surface = plugin({\n            store: controller.store as Store<TState, any>,\n            onDispose: (cleanup) => controller.onDispose(cleanup),\n          })\n\n          controller.attachSurface(surface)\n        }\n\n        const store = controller.store as Store<TState, TPlugins>\n        registerStoreBuilder(store, builder)\n\n        return store\n      },\n      extend<TNextPlugins>(\n        plugin: StorePlugin<TState, TPlugins, TNextPlugins>,\n      ) {\n        return createBuilder<TPlugins & TNextPlugins>([...plugins, plugin])\n      },\n    }\n\n    return builder\n  }\n\n  return createBuilder<{}>([])\n}\n"]}

package/dist/plugins/actions/index.d.ts

@@ -0,0 +1,33 @@
+import { b as StoreBrand, d as StorePlugin, a as Store } from '../../types-ByMGdUb-.js';
+import '@tanstack/store';
+
+declare const actionsBrand: unique symbol;
+declare const actionDefinitionBrand: unique symbol;
+declare const bindActionDefinition: unique symbol;
+type ActionsBrand = StoreBrand<typeof actionsBrand>;
+type ActionsPluginSurface<TState, TActions> = {
+    readonly actions: BoundActions<TState, TActions>;
+} & ActionsBrand;
+type ActionsPlugin<TState, TActions> = StorePlugin<TState, any, ActionsPluginSurface<TState, TActions>>;
+type ActionsBuilderHelpers<TState> = {
+    getState: () => TState;
+    setState: (updater: (prev: TState) => TState) => void;
+};
+type ActionCallback<TState, TArgs extends unknown[] = [], TReturn = void> = (helpers: ActionsBuilderHelpers<TState>, ...args: TArgs) => TReturn;
+type ActionDefinition<TState, TArgs extends unknown[] = [], TReturn = void> = {
+    readonly [actionDefinitionBrand]: true;
+    readonly [bindActionDefinition]: (helpers: ActionsBuilderHelpers<TState>) => (...args: TArgs) => TReturn;
+};
+type BoundActions<TState, TActions> = {
+    [TKey in keyof TActions]: TActions[TKey] extends ActionDefinition<TState, infer TArgs, infer TReturn> ? (...args: TArgs) => TReturn : TActions[TKey];
+};
+
+declare function createAction<TState, TArgs extends unknown[] = [], TReturn = void>(callback: ActionCallback<TState, TArgs, TReturn>): ActionDefinition<TState, TArgs, TReturn>;
+declare function actions<TState, TActions>(builder: (helpers: {
+    getState: () => TState;
+    setState: (updater: (prev: TState) => TState) => void;
+}) => TActions): ActionsPlugin<TState, TActions>;
+
+declare function useActions<TState, TActions>(store: Store<TState, ActionsPluginSurface<TState, TActions>>): ActionsPluginSurface<TState, TActions>['actions'];
+
+export { type ActionCallback, type ActionDefinition, type ActionsBrand, type ActionsBuilderHelpers, type ActionsPluginSurface, type BoundActions, actionDefinitionBrand, actions, actionsBrand, createAction, useActions };

package/dist/plugins/actions/index.js

@@ -0,0 +1,46 @@
+// src/plugins/actions/types.ts
+var actionsBrand = /* @__PURE__ */ Symbol("lunarhue.store.actions");
+var actionDefinitionBrand = /* @__PURE__ */ Symbol("lunarhue.store.actionDefinition");
+var bindActionDefinition = /* @__PURE__ */ Symbol("lunarhue.store.bindActionDefinition");
+
+// src/plugins/actions/plugin.ts
+function isActionDefinition(value) {
+  return typeof value === "object" && value !== null && actionDefinitionBrand in value && bindActionDefinition in value;
+}
+function bindActions(declaredActions, helpers) {
+  const boundActions = {};
+  for (const key of Reflect.ownKeys(declaredActions)) {
+    const action = declaredActions[key];
+    boundActions[key] = isActionDefinition(action) ? action[bindActionDefinition](helpers) : action;
+  }
+  return boundActions;
+}
+function createAction(callback) {
+  return {
+    [actionDefinitionBrand]: true,
+    [bindActionDefinition](helpers) {
+      return (...args) => callback(helpers, ...args);
+    }
+  };
+}
+function actions(builder) {
+  return ({ store }) => {
+    const helpers = {
+      getState: () => store.get(),
+      setState: (updater) => store.setState(updater)
+    };
+    return {
+      [actionsBrand]: true,
+      actions: bindActions(builder(helpers), helpers)
+    };
+  };
+}
+
+// src/plugins/actions/react.tsx
+function useActions(store) {
+  return store.actions;
+}
+
+export { actionDefinitionBrand, actions, actionsBrand, createAction, useActions };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/plugins/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/actions/types.ts","../../../src/plugins/actions/plugin.ts","../../../src/plugins/actions/react.tsx"],"names":[],"mappings":";AAEO,IAAM,YAAA,0BAAsB,wBAAwB;AACpD,IAAM,qBAAA,0BAA+B,iCAAiC;AACtE,IAAM,oBAAA,0BAA8B,qCAAqC,CAAA;;;ACUhF,SAAS,mBACP,KAAA,EACuD;AACvD,EAAA,OACE,OAAO,KAAA,KAAU,QAAA,IACjB,UAAU,IAAA,IACV,qBAAA,IAAyB,SACzB,oBAAA,IAAwB,KAAA;AAE5B;AAEA,SAAS,WAAA,CACP,iBACA,OAAA,EACgC;AAChC,EAAA,MAAM,eAAe,EAAC;AAEtB,EAAA,KAAA,MAAW,GAAA,IAAO,OAAA,CAAQ,OAAA,CAAQ,eAAyB,CAAA,EAExD;AACD,IAAA,MAAM,MAAA,GAAS,gBAAgB,GAAG,CAAA;AAElC,IAAA,YAAA,CAAa,GAAG,IACd,kBAAA,CAA2B,MAAM,IAC7B,MAAA,CAAO,oBAAoB,CAAA,CAAE,OAAO,CAAA,GACpC,MAAA;AAAA,EAER;AAEA,EAAA,OAAO,YAAA;AACT;AAEO,SAAS,aAKd,QAAA,EAC0C;AAC1C,EAAA,OAAO;AAAA,IACL,CAAC,qBAAqB,GAAG,IAAA;AAAA,IACzB,CAAC,oBAAoB,CAAA,CAAE,OAAA,EAAS;AAC9B,MAAA,OAAO,CAAA,GAAI,IAAA,KAAS,QAAA,CAAS,OAAA,EAAS,GAAG,IAAI,CAAA;AAAA,IAC/C;AAAA,GACF;AACF;AAEO,SAAS,QACd,OAAA,EAIiC;AACjC,EAAA,OAAO,CAAC,EAAE,KAAA,EAAM,KAAM;AACpB,IAAA,MAAM,OAAA,GAAU;AAAA,MACd,QAAA,EAAU,MAAM,KAAA,CAAM,GAAA,EAAI;AAAA,MAC1B,QAAA,EAAU,CAAC,OAAA,KAAsC,KAAA,CAAM,SAAS,OAAO;AAAA,KACzE;AAEA,IAAA,OAAO;AAAA,MACL,CAAC,YAAY,GAAG,IAAA;AAAA,MAChB,OAAA,EAAS,WAAA,CAAY,OAAA,CAAQ,OAAO,GAAG,OAAO;AAAA,KAChD;AAAA,EACF,CAAA;AACF;;;AC1EO,SAAS,WACd,KAAA,EACmD;AACnD,EAAA,OAAO,KAAA,CAAM,OAAA;AACf","file":"index.js","sourcesContent":["import type { StoreBrand, StorePlugin } from '../../core'\n\nexport const actionsBrand = Symbol('lunarhue.store.actions')\nexport const actionDefinitionBrand = Symbol('lunarhue.store.actionDefinition')\nexport const bindActionDefinition = Symbol('lunarhue.store.bindActionDefinition')\n\nexport type ActionsBrand = StoreBrand<typeof actionsBrand>\n\nexport type ActionsPluginSurface<TState, TActions> = {\n  readonly actions: BoundActions<TState, TActions>\n} & ActionsBrand\n\nexport type ActionsPlugin<TState, TActions> = StorePlugin<\n  TState,\n  any,\n  ActionsPluginSurface<TState, TActions>\n>\n\nexport type ActionsBuilderHelpers<TState> = {\n  getState: () => TState\n  setState: (updater: (prev: TState) => TState) => void\n}\n\nexport type ActionCallback<\n  TState,\n  TArgs extends unknown[] = [],\n  TReturn = void,\n> = (\n  helpers: ActionsBuilderHelpers<TState>,\n  ...args: TArgs\n) => TReturn\n\nexport type ActionDefinition<\n  TState,\n  TArgs extends unknown[] = [],\n  TReturn = void,\n> = {\n  readonly [actionDefinitionBrand]: true\n  readonly [bindActionDefinition]: (\n    helpers: ActionsBuilderHelpers<TState>,\n  ) => (...args: TArgs) => TReturn\n}\n\nexport type BoundActions<TState, TActions> = {\n  [TKey in keyof TActions]: TActions[TKey] extends ActionDefinition<\n    TState,\n    infer TArgs,\n    infer TReturn\n  >\n    ? (...args: TArgs) => TReturn\n    : TActions[TKey]\n}\n","import {\n  actionDefinitionBrand,\n  actionsBrand,\n  bindActionDefinition,\n} from './types'\n\nimport type {\n  ActionCallback,\n  ActionDefinition,\n  ActionsBuilderHelpers,\n  ActionsPlugin,\n  BoundActions,\n} from './types'\n\nfunction isActionDefinition<TState>(\n  value: unknown,\n): value is ActionDefinition<TState, unknown[], unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    actionDefinitionBrand in value &&\n    bindActionDefinition in value\n  )\n}\n\nfunction bindActions<TState, TActions>(\n  declaredActions: TActions,\n  helpers: ActionsBuilderHelpers<TState>,\n): BoundActions<TState, TActions> {\n  const boundActions = {} as BoundActions<TState, TActions>\n\n  for (const key of Reflect.ownKeys(declaredActions as object) as Array<\n    keyof TActions\n  >) {\n    const action = declaredActions[key]\n\n    boundActions[key] = (\n      isActionDefinition<TState>(action)\n        ? action[bindActionDefinition](helpers)\n        : action\n    ) as BoundActions<TState, TActions>[typeof key]\n  }\n\n  return boundActions\n}\n\nexport function createAction<\n  TState,\n  TArgs extends unknown[] = [],\n  TReturn = void,\n>(\n  callback: ActionCallback<TState, TArgs, TReturn>,\n): ActionDefinition<TState, TArgs, TReturn> {\n  return {\n    [actionDefinitionBrand]: true,\n    [bindActionDefinition](helpers) {\n      return (...args) => callback(helpers, ...args)\n    },\n  }\n}\n\nexport function actions<TState, TActions>(\n  builder: (helpers: {\n    getState: () => TState\n    setState: (updater: (prev: TState) => TState) => void\n  }) => TActions,\n): ActionsPlugin<TState, TActions> {\n  return ({ store }) => {\n    const helpers = {\n      getState: () => store.get(),\n      setState: (updater: (prev: TState) => TState) => store.setState(updater),\n    }\n\n    return {\n      [actionsBrand]: true,\n      actions: bindActions(builder(helpers), helpers),\n    }\n  }\n}\n","import type { Store } from '../../core'\n\nimport type { ActionsPluginSurface } from './types'\n\nexport function useActions<TState, TActions>(\n  store: Store<TState, ActionsPluginSurface<TState, TActions>>,\n): ActionsPluginSurface<TState, TActions>['actions'] {\n  return store.actions\n}\n"]}

package/dist/plugins/persist/index.d.ts

@@ -0,0 +1,100 @@
+import { b as StoreBrand, a as Store, d as StorePlugin, S as StoreBuilder } from '../../types-ByMGdUb-.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import '@tanstack/store';
+
+declare const persistBrand: unique symbol;
+declare const persistControllerKey: unique symbol;
+type PersistBrand = StoreBrand<typeof persistBrand>;
+type PersistMeta = {
+    isHydrated: boolean;
+    pending: boolean;
+    persisting: boolean;
+    lastPersistedAt: number | null;
+    error: unknown | null;
+};
+type PersistHydrateArgs<TState> = {
+    key: string;
+    store: PersistedStore<TState>;
+};
+type PersistPersistArgs<TState> = {
+    key: string;
+    previousState: TState;
+    nextState: TState;
+};
+type PersistRuntimeOptions<TState> = {
+    key?: string;
+    enabled?: boolean;
+    delay?: number;
+    hydrate?: (args: PersistHydrateArgs<TState>) => Promise<void>;
+    onPersist?: (args: PersistPersistArgs<TState>) => Promise<void>;
+};
+type PersistPluginOptions<TState> = {
+    flushOnDispose?: boolean;
+    hydratedOnCreate?: boolean;
+    serializeState?: (state: TState) => TState;
+} & Omit<PersistRuntimeOptions<TState>, 'key'>;
+type PersistController<TState> = {
+    meta: Store<PersistMeta>;
+    connect(store: PersistedStore<TState>, options: PersistRuntimeOptions<TState>): () => void;
+    flush(): Promise<void>;
+    hydrate(nextState: TState): Promise<void>;
+};
+type PersistPluginSurface<TState> = PersistBrand & {
+    hydrate(nextState: TState): Promise<void>;
+    persist: {
+        flush(): Promise<void>;
+        hydrate(nextState: TState): Promise<void>;
+        meta: Store<PersistMeta>;
+        [persistControllerKey]: PersistController<TState>;
+    };
+};
+type PersistedStore<TState, TPlugins = {}> = Store<TState, TPlugins & PersistPluginSurface<TState>>;
+type PersistPlugin<TState> = StorePlugin<TState, any, PersistPluginSurface<TState>>;
+
+declare function persist<TState>(options?: PersistPluginOptions<TState>): PersistPlugin<TState>;
+
+type PersistentStoreResult<TState, TPlugins = {}> = {
+    store: PersistedStore<TState, TPlugins>;
+    flush(): Promise<void>;
+};
+type PersistStoreProviderChildren<TState, TPlugins> = ReactNode | ((args: PersistentStoreResult<TState, TPlugins>) => ReactNode);
+type BuilderPersistStoreProviderProps<TState, TPlugins> = {
+    builder: StoreBuilder<TState, TPlugins & PersistPluginSurface<TState>>;
+    children?: PersistStoreProviderChildren<TState, TPlugins>;
+    flushOnBackground?: boolean;
+    flushOnPageHide?: boolean;
+    flushOnUnmount?: boolean;
+    persist?: PersistRuntimeOptions<TState>;
+    store?: never;
+};
+type ExternalPersistStoreProviderProps<TState, TPlugins> = {
+    builder?: never;
+    children?: PersistStoreProviderChildren<TState, TPlugins>;
+    flushOnBackground?: boolean;
+    flushOnPageHide?: boolean;
+    flushOnUnmount?: boolean;
+    persist?: PersistRuntimeOptions<TState>;
+    store: PersistedStore<TState, TPlugins>;
+};
+type PersistStoreProviderProps<TState, TPlugins = {}> = BuilderPersistStoreProviderProps<TState, TPlugins> | ExternalPersistStoreProviderProps<TState, TPlugins>;
+/**
+ * @deprecated Prefer PersistStoreProvider flush options. This boundary remains
+ * as a compatibility escape hatch for sub-tree flush behavior.
+ */
+type PersistenceBoundaryProps<TState> = {
+    store: PersistedStore<TState>;
+    flushOnUnmount?: boolean;
+    flushOnPageHide?: boolean;
+    flushOnBackground?: boolean;
+    children?: ReactNode;
+};
+declare function usePersistentStore<TState, TPlugins>(builder: StoreBuilder<TState, TPlugins & PersistPluginSurface<TState>>): PersistentStoreResult<TState, TPlugins>;
+declare function PersistStoreProvider<TState, TPlugins = {}>(props: PersistStoreProviderProps<TState, TPlugins>): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Prefer PersistStoreProvider flush options. This boundary remains
+ * as a compatibility escape hatch for sub-tree flush behavior.
+ */
+declare function PersistenceBoundary<TState>({ children, flushOnBackground, flushOnPageHide, flushOnUnmount, store, }: PersistenceBoundaryProps<TState>): react_jsx_runtime.JSX.Element;
+
+export { type PersistBrand, type PersistController, type PersistHydrateArgs, type PersistMeta, type PersistPersistArgs, type PersistPluginOptions, type PersistPluginSurface, type PersistRuntimeOptions, PersistStoreProvider, type PersistStoreProviderProps, type PersistedStore, PersistenceBoundary, type PersistenceBoundaryProps, type PersistentStoreResult, persist, persistBrand, usePersistentStore };

package/dist/plugins/persist/index.js

@@ -0,0 +1,408 @@
+import { createStoreInstance } from '../../chunk-MIBJNMOV.js';
+import { StoreProvider } from '../../chunk-IP5Y4BHA.js';
+import { getStoreBuilder } from '../../chunk-PCSRXZL4.js';
+import { useContext, createContext, useEffect, useEffectEvent } from 'react';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+// src/plugins/persist/controller.ts
+var DEFAULT_META = {
+  isHydrated: false,
+  pending: false,
+  persisting: false,
+  lastPersistedAt: null,
+  error: null
+};
+var nextGeneratedPersistKeyId = 0;
+function getInitialMeta(options) {
+  return {
+    ...DEFAULT_META,
+    isHydrated: options?.hydratedOnCreate ?? false
+  };
+}
+function createPersistController(store, pluginOptions) {
+  const meta = createStoreInstance(getInitialMeta(pluginOptions)).store;
+  const fallbackKey = `persist:${++nextGeneratedPersistKeyId}`;
+  let runtimeOptions = null;
+  let subscription = null;
+  let timer = null;
+  let queuedTransition = null;
+  let lastObservedState = store.get();
+  let currentKey = null;
+  let currentFlushPromise = null;
+  let hydrating = false;
+  let isConnected = false;
+  let hasRequestedHydrationForKey = false;
+  const resolveKey = (key) => key ?? fallbackKey;
+  const clearTimer = () => {
+    if (!timer) {
+      return;
+    }
+    clearTimeout(timer);
+    timer = null;
+  };
+  const updateMeta = (updater) => {
+    meta.setState(updater);
+  };
+  const resolveRuntimeOptions = (options) => {
+    const onPersist = options.onPersist ?? pluginOptions?.onPersist;
+    if (!onPersist) {
+      throw new Error(
+        "Persist runtime requires onPersist to be provided either in persist(...) or at runtime."
+      );
+    }
+    return {
+      key: resolveKey(options.key),
+      enabled: options.enabled ?? pluginOptions?.enabled ?? true,
+      delay: options.delay ?? pluginOptions?.delay ?? 0,
+      hydrate: options.hydrate ?? pluginOptions?.hydrate,
+      onPersist
+    };
+  };
+  const resetForKey = (key) => {
+    currentKey = key;
+    queuedTransition = null;
+    clearTimer();
+    hasRequestedHydrationForKey = false;
+    lastObservedState = store.get();
+    meta.setState(() => getInitialMeta(pluginOptions));
+  };
+  const ensureSubscription = () => {
+    if (subscription) {
+      return;
+    }
+    subscription = store.subscribe((nextState) => {
+      const previousState = lastObservedState;
+      lastObservedState = nextState;
+      if (hydrating || !isConnected || !runtimeOptions?.enabled || Object.is(previousState, nextState)) {
+        return;
+      }
+      queuedTransition = queuedTransition ? {
+        previousState: queuedTransition.previousState,
+        nextState
+      } : {
+        previousState,
+        nextState
+      };
+      updateMeta((prev) => ({
+        ...prev,
+        pending: true,
+        error: null
+      }));
+      clearTimer();
+      timer = setTimeout(() => {
+        void flush();
+      }, runtimeOptions.delay);
+    });
+  };
+  const maybeHydrate = async (runtimeStore, options) => {
+    if (!options.enabled || hasRequestedHydrationForKey) {
+      return;
+    }
+    hasRequestedHydrationForKey = true;
+    if (!options.hydrate) {
+      updateMeta((prev) => ({
+        ...prev,
+        isHydrated: true,
+        error: null
+      }));
+      return;
+    }
+    try {
+      await options.hydrate({
+        key: options.key,
+        store: runtimeStore
+      });
+    } catch (error) {
+      updateMeta((prev) => ({
+        ...prev,
+        error
+      }));
+      throw error;
+    }
+  };
+  const flush = () => {
+    if (currentFlushPromise) {
+      return currentFlushPromise;
+    }
+    const runFlush = async () => {
+      clearTimer();
+      while (queuedTransition) {
+        if (!runtimeOptions?.enabled) {
+          return;
+        }
+        const transition = queuedTransition;
+        queuedTransition = null;
+        updateMeta((prev) => ({
+          ...prev,
+          pending: false,
+          persisting: true,
+          error: null
+        }));
+        try {
+          const nextState = pluginOptions?.serializeState ? pluginOptions.serializeState(transition.nextState) : transition.nextState;
+          await runtimeOptions.onPersist({
+            key: resolveKey(runtimeOptions.key),
+            previousState: transition.previousState,
+            nextState
+          });
+          updateMeta((prev) => ({
+            ...prev,
+            persisting: false,
+            lastPersistedAt: Date.now(),
+            error: null
+          }));
+        } catch (error) {
+          queuedTransition = transition;
+          updateMeta((prev) => ({
+            ...prev,
+            pending: true,
+            persisting: false,
+            error
+          }));
+          throw error;
+        }
+      }
+    };
+    currentFlushPromise = runFlush().finally(() => {
+      currentFlushPromise = null;
+    });
+    return currentFlushPromise;
+  };
+  return {
+    meta,
+    connect(runtimeStore, options) {
+      const resolvedOptions = resolveRuntimeOptions(options);
+      runtimeOptions = resolvedOptions;
+      if (currentKey !== resolvedOptions.key) {
+        resetForKey(resolvedOptions.key);
+      }
+      isConnected = true;
+      ensureSubscription();
+      void maybeHydrate(runtimeStore, resolvedOptions).catch(() => {
+      });
+      return () => {
+        if (currentKey !== resolvedOptions.key) {
+          return;
+        }
+        isConnected = false;
+        clearTimer();
+        updateMeta((prev) => ({
+          ...prev,
+          persisting: false
+        }));
+      };
+    },
+    flush() {
+      return flush();
+    },
+    async hydrate(nextState) {
+      clearTimer();
+      queuedTransition = null;
+      hydrating = true;
+      try {
+        store.setState(() => nextState);
+        lastObservedState = nextState;
+        updateMeta((prev) => ({
+          ...prev,
+          isHydrated: true,
+          pending: false,
+          error: null
+        }));
+      } finally {
+        hydrating = false;
+      }
+    }
+  };
+}
+
+// src/plugins/persist/types.ts
+var persistBrand = /* @__PURE__ */ Symbol("lunarhue.store.persist");
+var persistControllerKey = /* @__PURE__ */ Symbol("lunarhue.store.persist.controller");
+
+// src/plugins/persist/plugin.ts
+function persist(options) {
+  return ({ onDispose, store }) => {
+    const controller = createPersistController(store, options);
+    if (options?.flushOnDispose) {
+      onDispose(async () => {
+        await controller.flush();
+      });
+    }
+    return {
+      [persistBrand]: true,
+      hydrate(nextState) {
+        return controller.hydrate(nextState);
+      },
+      persist: {
+        flush() {
+          return controller.flush();
+        },
+        hydrate(nextState) {
+          return controller.hydrate(nextState);
+        },
+        meta: controller.meta,
+        [persistControllerKey]: controller
+      }
+    };
+  };
+}
+var persistContextMap = /* @__PURE__ */ new WeakMap();
+function getPersistStoreContext(builder) {
+  let context = persistContextMap.get(builder);
+  if (!context) {
+    context = createContext(void 0);
+    persistContextMap.set(builder, context);
+  }
+  return context;
+}
+function usePersistentRuntime(store, options) {
+  const onPersist = useEffectEvent(async (args) => {
+    if (!options.onPersist) {
+      return;
+    }
+    await options.onPersist(args);
+  });
+  const hydrate = useEffectEvent(async (args) => {
+    if (!options.hydrate) {
+      return;
+    }
+    await options.hydrate(args);
+  });
+  useEffect(() => {
+    return store.persist[persistControllerKey].connect(store, {
+      key: options.key,
+      enabled: options.enabled,
+      delay: options.delay,
+      onPersist: options.onPersist ? (args) => onPersist(args) : void 0,
+      hydrate: options.hydrate ? (args) => hydrate(args) : void 0
+    });
+  }, [
+    options.delay,
+    options.enabled,
+    options.key,
+    store,
+    Boolean(options.hydrate)
+  ]);
+  return {
+    store,
+    flush() {
+      return store.persist.flush();
+    }
+  };
+}
+function usePersistentStore(builder) {
+  const contextValue = useContext(
+    getPersistStoreContext(builder)
+  );
+  if (!contextValue) {
+    throw new Error(
+      "usePersistentStore(builder) requires a matching <PersistStoreProvider builder={...}> or <PersistStoreProvider store={...}> ancestor."
+    );
+  }
+  return contextValue;
+}
+function usePersistenceBoundary(store, {
+  flushOnBackground,
+  flushOnPageHide,
+  flushOnUnmount
+}) {
+  useEffect(() => {
+    if (!flushOnUnmount) {
+      return;
+    }
+    return () => {
+      void store.persist.flush();
+    };
+  }, [flushOnUnmount, store]);
+  useEffect(() => {
+    if (!flushOnPageHide || typeof window === "undefined") {
+      return;
+    }
+    const handlePageHide = () => {
+      void store.persist.flush();
+    };
+    window.addEventListener("pagehide", handlePageHide);
+    return () => {
+      window.removeEventListener("pagehide", handlePageHide);
+    };
+  }, [flushOnPageHide, store]);
+  useEffect(() => {
+    if (!flushOnBackground) {
+      return;
+    }
+  }, [flushOnBackground]);
+}
+function PersistStoreProviderContent({
+  builder,
+  flushOnBackground,
+  flushOnPageHide,
+  flushOnUnmount,
+  children,
+  persist: persist2,
+  store
+}) {
+  const persistentStore = usePersistentRuntime(
+    store,
+    persist2 ?? {}
+  );
+  const Context = getPersistStoreContext(builder);
+  usePersistenceBoundary(store, {
+    flushOnBackground,
+    flushOnPageHide,
+    flushOnUnmount
+  });
+  const content = typeof children === "function" ? children(persistentStore) : children;
+  return /* @__PURE__ */ jsx(Context.Provider, { value: persistentStore, children: content });
+}
+function PersistStoreProvider(props) {
+  if (props.builder !== void 0) {
+    return /* @__PURE__ */ jsx(StoreProvider, { builder: props.builder, children: ({ store }) => /* @__PURE__ */ jsx(
+      PersistStoreProviderContent,
+      {
+        builder: props.builder,
+        store,
+        persist: props.persist,
+        flushOnUnmount: props.flushOnUnmount,
+        flushOnPageHide: props.flushOnPageHide,
+        flushOnBackground: props.flushOnBackground,
+        children: props.children
+      }
+    ) });
+  }
+  const builder = getStoreBuilder(props.store);
+  if (!builder) {
+    throw new Error(
+      "PersistStoreProvider could not resolve a builder for the provided store. Pass a persisted store created by @lunarhue/store."
+    );
+  }
+  return /* @__PURE__ */ jsx(StoreProvider, { store: props.store, children: ({ store }) => /* @__PURE__ */ jsx(
+    PersistStoreProviderContent,
+    {
+      builder,
+      store,
+      persist: props.persist,
+      flushOnUnmount: props.flushOnUnmount,
+      flushOnPageHide: props.flushOnPageHide,
+      flushOnBackground: props.flushOnBackground,
+      children: props.children
+    }
+  ) });
+}
+function PersistenceBoundary({
+  children,
+  flushOnBackground,
+  flushOnPageHide,
+  flushOnUnmount,
+  store
+}) {
+  usePersistenceBoundary(store, {
+    flushOnBackground,
+    flushOnPageHide,
+    flushOnUnmount
+  });
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+
+export { PersistStoreProvider, PersistenceBoundary, persist, persistBrand, usePersistentStore };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/plugins/persist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/persist/controller.ts","../../../src/plugins/persist/types.ts","../../../src/plugins/persist/plugin.ts","../../../src/plugins/persist/react.tsx"],"names":["persist"],"mappings":"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","file":"index.js","sourcesContent":["import type {\n  PersistController,\n  PersistMeta,\n  PersistPluginOptions,\n  PersistRuntimeOptions,\n  PersistedStore,\n} from './types'\nimport type { Store } from '../../core'\nimport { createStoreInstance } from '../../core/store-instance'\n\nconst DEFAULT_META: PersistMeta = {\n  isHydrated: false,\n  pending: false,\n  persisting: false,\n  lastPersistedAt: null,\n  error: null,\n}\n\nlet nextGeneratedPersistKeyId = 0\n\nfunction getInitialMeta<TState>(\n  options?: PersistPluginOptions<TState>,\n): PersistMeta {\n  return {\n    ...DEFAULT_META,\n    isHydrated: options?.hydratedOnCreate ?? false,\n  }\n}\n\ntype RuntimeOptions<TState> = Required<\n  Omit<PersistRuntimeOptions<TState>, 'hydrate'>\n> & {\n  hydrate?: PersistRuntimeOptions<TState>['hydrate']\n}\n\nexport function createPersistController<TState>(\n  store: Store<TState>,\n  pluginOptions?: PersistPluginOptions<TState>,\n): PersistController<TState> {\n  const meta = createStoreInstance(getInitialMeta(pluginOptions)).store\n  const fallbackKey = `persist:${++nextGeneratedPersistKeyId}`\n  let runtimeOptions: RuntimeOptions<TState> | null = null\n  let subscription: { unsubscribe(): void } | null = null\n  let timer: ReturnType<typeof setTimeout> | null = null\n  let queuedTransition: {\n    previousState: TState\n    nextState: TState\n  } | null = null\n  let lastObservedState = store.get()\n  let currentKey: string | null = null\n  let currentFlushPromise: Promise<void> | null = null\n  let hydrating = false\n  let isConnected = false\n  let hasRequestedHydrationForKey = false\n\n  const resolveKey = (key?: string) => key ?? fallbackKey\n\n  const clearTimer = () => {\n    if (!timer) {\n      return\n    }\n\n    clearTimeout(timer)\n    timer = null\n  }\n\n  const updateMeta = (updater: (prev: PersistMeta) => PersistMeta) => {\n    meta.setState(updater)\n  }\n\n  const resolveRuntimeOptions = (\n    options: PersistRuntimeOptions<TState>,\n  ): RuntimeOptions<TState> => {\n    const onPersist = options.onPersist ?? pluginOptions?.onPersist\n\n    if (!onPersist) {\n      throw new Error(\n        'Persist runtime requires onPersist to be provided either in persist(...) or at runtime.',\n      )\n    }\n\n    return {\n      key: resolveKey(options.key),\n      enabled: options.enabled ?? pluginOptions?.enabled ?? true,\n      delay: options.delay ?? pluginOptions?.delay ?? 0,\n      hydrate: options.hydrate ?? pluginOptions?.hydrate,\n      onPersist,\n    }\n  }\n\n  const resetForKey = (key: string) => {\n    currentKey = key\n    queuedTransition = null\n    clearTimer()\n    hasRequestedHydrationForKey = false\n    lastObservedState = store.get()\n    meta.setState(() => getInitialMeta(pluginOptions))\n  }\n\n  const ensureSubscription = () => {\n    if (subscription) {\n      return\n    }\n\n    subscription = store.subscribe((nextState) => {\n      const previousState = lastObservedState\n      lastObservedState = nextState\n\n      if (\n        hydrating ||\n        !isConnected ||\n        !runtimeOptions?.enabled ||\n        Object.is(previousState, nextState)\n      ) {\n        return\n      }\n\n      queuedTransition = queuedTransition\n        ? {\n            previousState: queuedTransition.previousState,\n            nextState,\n          }\n        : {\n            previousState,\n            nextState,\n          }\n\n      updateMeta((prev) => ({\n        ...prev,\n        pending: true,\n        error: null,\n      }))\n\n      clearTimer()\n      timer = setTimeout(() => {\n        void flush()\n      }, runtimeOptions.delay)\n    })\n  }\n\n  const maybeHydrate = async (\n    runtimeStore: PersistedStore<TState>,\n    options: RuntimeOptions<TState>,\n  ) => {\n    if (!options.enabled || hasRequestedHydrationForKey) {\n      return\n    }\n\n    hasRequestedHydrationForKey = true\n\n    if (!options.hydrate) {\n      updateMeta((prev) => ({\n        ...prev,\n        isHydrated: true,\n        error: null,\n      }))\n      return\n    }\n\n    try {\n      await options.hydrate({\n        key: options.key,\n        store: runtimeStore,\n      })\n    } catch (error) {\n      updateMeta((prev) => ({\n        ...prev,\n        error,\n      }))\n      throw error\n    }\n  }\n\n  const flush = (): Promise<void> => {\n    if (currentFlushPromise) {\n      return currentFlushPromise\n    }\n\n    const runFlush = async () => {\n      clearTimer()\n\n      while (queuedTransition) {\n        if (!runtimeOptions?.enabled) {\n          return\n        }\n\n        const transition = queuedTransition\n        queuedTransition = null\n\n        updateMeta((prev) => ({\n          ...prev,\n          pending: false,\n          persisting: true,\n          error: null,\n        }))\n\n        try {\n          const nextState = pluginOptions?.serializeState\n            ? pluginOptions.serializeState(transition.nextState)\n            : transition.nextState\n\n          await runtimeOptions.onPersist({\n            key: resolveKey(runtimeOptions.key),\n            previousState: transition.previousState,\n            nextState,\n          })\n\n          updateMeta((prev) => ({\n            ...prev,\n            persisting: false,\n            lastPersistedAt: Date.now(),\n            error: null,\n          }))\n        } catch (error) {\n          queuedTransition = transition\n          updateMeta((prev) => ({\n            ...prev,\n            pending: true,\n            persisting: false,\n            error,\n          }))\n          throw error\n        }\n      }\n    }\n\n    currentFlushPromise = runFlush().finally(() => {\n      currentFlushPromise = null\n    })\n\n    return currentFlushPromise\n  }\n\n  return {\n    meta,\n    connect(runtimeStore, options) {\n      const resolvedOptions = resolveRuntimeOptions(options)\n      runtimeOptions = resolvedOptions\n\n      if (currentKey !== resolvedOptions.key) {\n        resetForKey(resolvedOptions.key)\n      }\n\n      isConnected = true\n      ensureSubscription()\n      void maybeHydrate(runtimeStore, resolvedOptions).catch(() => {})\n\n      return () => {\n        if (currentKey !== resolvedOptions.key) {\n          return\n        }\n\n        isConnected = false\n        clearTimer()\n        updateMeta((prev) => ({\n          ...prev,\n          persisting: false,\n        }))\n      }\n    },\n    flush() {\n      return flush()\n    },\n    async hydrate(nextState) {\n      clearTimer()\n      queuedTransition = null\n      hydrating = true\n\n      try {\n        store.setState(() => nextState)\n        lastObservedState = nextState\n        updateMeta((prev) => ({\n          ...prev,\n          isHydrated: true,\n          pending: false,\n          error: null,\n        }))\n      } finally {\n        hydrating = false\n      }\n    },\n  }\n}\n","import type { Store, StoreBrand, StorePlugin } from '../../core'\n\nexport const persistBrand = Symbol('lunarhue.store.persist')\nexport const persistControllerKey = Symbol('lunarhue.store.persist.controller')\n\nexport type PersistBrand = StoreBrand<typeof persistBrand>\n\nexport type PersistMeta = {\n  isHydrated: boolean\n  pending: boolean\n  persisting: boolean\n  lastPersistedAt: number | null\n  error: unknown | null\n}\n\nexport type PersistHydrateArgs<TState> = {\n  key: string\n  store: PersistedStore<TState>\n}\n\nexport type PersistPersistArgs<TState> = {\n  key: string\n  previousState: TState\n  nextState: TState\n}\n\nexport type PersistRuntimeOptions<TState> = {\n  key?: string\n  enabled?: boolean\n  delay?: number\n  hydrate?: (args: PersistHydrateArgs<TState>) => Promise<void>\n  onPersist?: (args: PersistPersistArgs<TState>) => Promise<void>\n}\n\nexport type PersistPluginOptions<TState> = {\n  flushOnDispose?: boolean\n  hydratedOnCreate?: boolean\n  serializeState?: (state: TState) => TState\n} & Omit<PersistRuntimeOptions<TState>, 'key'>\n\nexport type PersistController<TState> = {\n  meta: Store<PersistMeta>\n  connect(\n    store: PersistedStore<TState>,\n    options: PersistRuntimeOptions<TState>,\n  ): () => void\n  flush(): Promise<void>\n  hydrate(nextState: TState): Promise<void>\n}\n\nexport type PersistPluginSurface<TState> = PersistBrand & {\n  hydrate(nextState: TState): Promise<void>\n  persist: {\n    flush(): Promise<void>\n    hydrate(nextState: TState): Promise<void>\n    meta: Store<PersistMeta>\n    [persistControllerKey]: PersistController<TState>\n  }\n}\n\nexport type PersistedStore<TState, TPlugins = {}> = Store<\n  TState,\n  TPlugins & PersistPluginSurface<TState>\n>\n\nexport type PersistPlugin<TState> = StorePlugin<\n  TState,\n  any,\n  PersistPluginSurface<TState>\n>\n","import { createPersistController } from './controller'\nimport { persistBrand, persistControllerKey } from './types'\n\nimport type { PersistPlugin, PersistPluginOptions } from './types'\n\nexport function persist<TState>(\n  options?: PersistPluginOptions<TState>,\n): PersistPlugin<TState> {\n  return ({ onDispose, store }) => {\n    const controller = createPersistController(store, options)\n\n    if (options?.flushOnDispose) {\n      onDispose(async () => {\n        await controller.flush()\n      })\n    }\n\n    return {\n      [persistBrand]: true,\n      hydrate(nextState: TState) {\n        return controller.hydrate(nextState)\n      },\n      persist: {\n        flush() {\n          return controller.flush()\n        },\n        hydrate(nextState: TState) {\n          return controller.hydrate(nextState)\n        },\n        meta: controller.meta,\n        [persistControllerKey]: controller,\n      },\n    }\n  }\n}\n","import {\n  createContext,\n  type Context,\n  type ReactNode,\n  useContext,\n  useEffect,\n  useEffectEvent,\n} from 'react'\n\nimport type { StoreBuilder } from '../../core'\nimport { getStoreBuilder } from '../../core/builder-registry'\nimport { StoreProvider, useSelector } from '../../react'\n\nimport {\n  persistControllerKey,\n  type PersistHydrateArgs,\n  type PersistMeta,\n  type PersistPersistArgs,\n  type PersistPluginSurface,\n  type PersistRuntimeOptions,\n  type PersistedStore,\n} from './types'\n\nexport type PersistentStoreResult<TState, TPlugins = {}> = {\n  store: PersistedStore<TState, TPlugins>\n  flush(): Promise<void>\n}\n\ntype PersistStoreContext<TState, TPlugins> = Context<\n  PersistentStoreResult<TState, TPlugins> | undefined\n>\n\nconst persistContextMap = new WeakMap<\n  StoreBuilder<any, any>,\n  PersistStoreContext<any, any>\n>()\n\ntype PersistStoreProviderChildren<TState, TPlugins> =\n  | ReactNode\n  | ((args: PersistentStoreResult<TState, TPlugins>) => ReactNode)\n\ntype BuilderPersistStoreProviderProps<TState, TPlugins> = {\n  builder: StoreBuilder<TState, TPlugins & PersistPluginSurface<TState>>\n  children?: PersistStoreProviderChildren<TState, TPlugins>\n  flushOnBackground?: boolean\n  flushOnPageHide?: boolean\n  flushOnUnmount?: boolean\n  persist?: PersistRuntimeOptions<TState>\n  store?: never\n}\n\ntype ExternalPersistStoreProviderProps<TState, TPlugins> = {\n  builder?: never\n  children?: PersistStoreProviderChildren<TState, TPlugins>\n  flushOnBackground?: boolean\n  flushOnPageHide?: boolean\n  flushOnUnmount?: boolean\n  persist?: PersistRuntimeOptions<TState>\n  store: PersistedStore<TState, TPlugins>\n}\n\nexport type PersistStoreProviderProps<TState, TPlugins = {}> =\n  | BuilderPersistStoreProviderProps<TState, TPlugins>\n  | ExternalPersistStoreProviderProps<TState, TPlugins>\n\n/**\n * @deprecated Prefer PersistStoreProvider flush options. This boundary remains\n * as a compatibility escape hatch for sub-tree flush behavior.\n */\nexport type PersistenceBoundaryProps<TState> = {\n  store: PersistedStore<TState>\n  flushOnUnmount?: boolean\n  flushOnPageHide?: boolean\n  flushOnBackground?: boolean\n  children?: ReactNode\n}\n\ntype PersistenceBoundaryOptions = {\n  flushOnBackground?: boolean\n  flushOnPageHide?: boolean\n  flushOnUnmount?: boolean\n}\n\nfunction getPersistStoreContext<TState, TPlugins>(\n  builder: StoreBuilder<TState, TPlugins & PersistPluginSurface<TState>>,\n): PersistStoreContext<TState, TPlugins> {\n  let context = persistContextMap.get(builder)\n\n  if (!context) {\n    context = createContext<\n      PersistentStoreResult<TState, TPlugins> | undefined\n    >(undefined)\n    persistContextMap.set(builder, context)\n  }\n\n  return context\n}\n\nfunction usePersistentRuntime<TState, TPlugins = {}>(\n  store: PersistedStore<TState, TPlugins>,\n  options: PersistRuntimeOptions<TState>,\n): PersistentStoreResult<TState, TPlugins> {\n  const onPersist = useEffectEvent(async (args: PersistPersistArgs<TState>) => {\n    if (!options.onPersist) {\n      return\n    }\n\n    await options.onPersist(args)\n  })\n  const hydrate = useEffectEvent(async (args: PersistHydrateArgs<TState>) => {\n    if (!options.hydrate) {\n      return\n    }\n\n    await options.hydrate(args)\n  })\n\n  useEffect(() => {\n    return store.persist[persistControllerKey].connect(store, {\n      key: options.key,\n      enabled: options.enabled,\n      delay: options.delay,\n      onPersist: options.onPersist ? (args) => onPersist(args) : undefined,\n      hydrate: options.hydrate ? (args) => hydrate(args) : undefined,\n    })\n  }, [\n    options.delay,\n    options.enabled,\n    options.key,\n    store,\n    Boolean(options.hydrate),\n  ])\n\n  return {\n    store,\n    flush() {\n      return store.persist.flush()\n    },\n  }\n}\n\nexport function usePersistentStore<TState, TPlugins>(\n  builder: StoreBuilder<TState, TPlugins & PersistPluginSurface<TState>>,\n): PersistentStoreResult<TState, TPlugins> {\n  const contextValue = useContext(\n    getPersistStoreContext<TState, TPlugins>(builder),\n  )\n\n  if (!contextValue) {\n    throw new Error(\n      'usePersistentStore(builder) requires a matching <PersistStoreProvider builder={...}> or <PersistStoreProvider store={...}> ancestor.',\n    )\n  }\n\n  return contextValue\n}\n\nfunction usePersistenceBoundary<TState>(\n  store: PersistedStore<TState>,\n  {\n    flushOnBackground,\n    flushOnPageHide,\n    flushOnUnmount,\n  }: PersistenceBoundaryOptions,\n) {\n  useEffect(() => {\n    if (!flushOnUnmount) {\n      return\n    }\n\n    return () => {\n      void store.persist.flush()\n    }\n  }, [flushOnUnmount, store])\n\n  useEffect(() => {\n    if (!flushOnPageHide || typeof window === 'undefined') {\n      return\n    }\n\n    const handlePageHide = () => {\n      void store.persist.flush()\n    }\n\n    window.addEventListener('pagehide', handlePageHide)\n\n    return () => {\n      window.removeEventListener('pagehide', handlePageHide)\n    }\n  }, [flushOnPageHide, store])\n\n  useEffect(() => {\n    if (!flushOnBackground) {\n      return\n    }\n\n    // Web has no app background lifecycle equivalent here yet.\n  }, [flushOnBackground])\n}\n\ninterface PersistStoreProviderContentProps<TState, TPlugins> {\n  builder: StoreBuilder<TState, TPlugins & PersistPluginSurface<TState>>\n  children?: PersistStoreProviderChildren<TState, TPlugins>\n  flushOnBackground?: boolean\n  flushOnPageHide?: boolean\n  flushOnUnmount?: boolean\n  persist?: PersistRuntimeOptions<TState>\n  store: PersistedStore<TState, TPlugins>\n}\n\nfunction PersistStoreProviderContent<TState, TPlugins>({\n  builder,\n  flushOnBackground,\n  flushOnPageHide,\n  flushOnUnmount,\n  children,\n  persist,\n  store,\n}: PersistStoreProviderContentProps<TState, TPlugins>) {\n  const persistentStore = usePersistentRuntime<TState, TPlugins>(\n    store,\n    persist ?? {},\n  )\n  const Context = getPersistStoreContext<TState, TPlugins>(builder)\n\n  usePersistenceBoundary(store, {\n    flushOnBackground,\n    flushOnPageHide,\n    flushOnUnmount,\n  })\n\n  const content =\n    typeof children === 'function' ? children(persistentStore) : children\n\n  return <Context.Provider value={persistentStore}>{content}</Context.Provider>\n}\n\nexport function PersistStoreProvider<TState, TPlugins = {}>(\n  props: PersistStoreProviderProps<TState, TPlugins>,\n) {\n  if (props.builder !== undefined) {\n    return (\n      <StoreProvider builder={props.builder}>\n        {({ store }) => (\n          <PersistStoreProviderContent\n            builder={props.builder}\n            store={store}\n            persist={props.persist}\n            flushOnUnmount={props.flushOnUnmount}\n            flushOnPageHide={props.flushOnPageHide}\n            flushOnBackground={props.flushOnBackground}\n          >\n            {props.children}\n          </PersistStoreProviderContent>\n        )}\n      </StoreProvider>\n    )\n  }\n\n  const builder = getStoreBuilder(props.store)\n\n  if (!builder) {\n    throw new Error(\n      'PersistStoreProvider could not resolve a builder for the provided store. Pass a persisted store created by @lunarhue/store.',\n    )\n  }\n\n  return (\n    <StoreProvider store={props.store}>\n      {({ store }) => (\n        <PersistStoreProviderContent\n          builder={\n            builder as StoreBuilder<\n              TState,\n              TPlugins & PersistPluginSurface<TState>\n            >\n          }\n          store={store as PersistedStore<TState, TPlugins>}\n          persist={props.persist}\n          flushOnUnmount={props.flushOnUnmount}\n          flushOnPageHide={props.flushOnPageHide}\n          flushOnBackground={props.flushOnBackground}\n        >\n          {props.children}\n        </PersistStoreProviderContent>\n      )}\n    </StoreProvider>\n  )\n}\n\n/**\n * @deprecated Prefer PersistStoreProvider flush options. This boundary remains\n * as a compatibility escape hatch for sub-tree flush behavior.\n */\nexport function PersistenceBoundary<TState>({\n  children,\n  flushOnBackground,\n  flushOnPageHide,\n  flushOnUnmount,\n  store,\n}: PersistenceBoundaryProps<TState>) {\n  usePersistenceBoundary(store, {\n    flushOnBackground,\n    flushOnPageHide,\n    flushOnUnmount,\n  })\n\n  return <>{children}</>\n}\n"]}

package/dist/react/index.d.ts

@@ -0,0 +1,30 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { S as StoreBuilder, a as Store, A as AnyStore, g as StoreState } from '../types-ByMGdUb-.js';
+import '@tanstack/store';
+
+type StoreProviderChildren<TState, TPlugins> = ReactNode | ((args: {
+    store: Store<TState, TPlugins>;
+}) => ReactNode);
+type BuilderProviderProps<TState, TPlugins> = {
+    builder: StoreBuilder<TState, TPlugins>;
+    children?: StoreProviderChildren<TState, TPlugins>;
+    store?: never;
+};
+type StoreProviderProps<TState, TPlugins> = {
+    builder?: never;
+    children?: StoreProviderChildren<TState, TPlugins>;
+    store: Store<TState, TPlugins>;
+};
+type ProviderProps<TState, TPlugins> = BuilderProviderProps<TState, TPlugins> | StoreProviderProps<TState, TPlugins>;
+declare function StoreProvider<TState, TPlugins>(props: ProviderProps<TState, TPlugins>): react_jsx_runtime.JSX.Element;
+
+declare function useLocalStore<TState, TPlugins>(builder: StoreBuilder<TState, TPlugins>): Store<TState, TPlugins>;
+
+declare function useSelector<TStore extends AnyStore, TSelected, TState extends StoreState<TStore>>(store: TStore, selector: (snapshot: TState) => TSelected, compare?: (a: TSelected, b: TSelected) => boolean): TSelected;
+
+declare function useStore<TState, TPlugins>(builder: StoreBuilder<TState, TPlugins>): Store<TState, TPlugins>;
+
+declare function useStoreSelector<TState, TPlugins, TSelected, TBuilder extends StoreBuilder<TState, TPlugins>>(builder: TBuilder, selector: (snapshot: StoreState<ReturnType<TBuilder['create']>>) => TSelected, compare?: (a: TSelected, b: TSelected) => boolean): TSelected;
+
+export { StoreProvider, type ProviderProps as StoreProviderProps, useLocalStore, useSelector, useStore, useStoreSelector };

package/dist/react/index.js

@@ -0,0 +1,4 @@
+export { StoreProvider, useLocalStore, useSelector, useStore, useStoreSelector } from '../chunk-IP5Y4BHA.js';
+import '../chunk-PCSRXZL4.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types-ByMGdUb-.d.ts

@@ -0,0 +1,28 @@
+import { Store as Store$1 } from '@tanstack/store';
+
+type StoreBrand<TKey extends symbol> = {
+    readonly [K in TKey]: true;
+};
+type StoreCleanup = () => void | Promise<void>;
+type TanStackStore<TState> = Store$1<TState>;
+type Store<TState, TPlugins = {}> = TanStackStore<TState> & {
+    dispose(): Promise<void>;
+} & TPlugins;
+type AnyStore = Store<any, any>;
+type StorePlugins<TStore extends AnyStore> = TStore extends {
+    [K in keyof TStore]: TStore[K] extends (...args: any[]) => any ? TStore[K] : never;
+} ? TStore : never;
+type StoreState<TStore extends AnyStore> = TStore extends {
+    get: () => infer TState;
+} ? TState : never;
+type StorePluginContext<TState, TPlugins> = {
+    store: Store<TState, TPlugins>;
+    onDispose(cleanup: StoreCleanup): void;
+};
+type StorePlugin<TState, TPlugins, TNextPlugins> = (context: StorePluginContext<TState, TPlugins>) => TNextPlugins;
+type StoreBuilder<TState, TPlugins = {}> = {
+    create(): Store<TState, TPlugins>;
+    extend<TNextPlugins>(plugin: StorePlugin<TState, TPlugins, TNextPlugins>): StoreBuilder<TState, TPlugins & TNextPlugins>;
+};
+
+export type { AnyStore as A, StoreBuilder as S, TanStackStore as T, Store as a, StoreBrand as b, StoreCleanup as c, StorePlugin as d, StorePluginContext as e, StorePlugins as f, StoreState as g };

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@lunarhue/store",
+  "version": "0.1.0",
+  "description": "Framework-agnostic state built on top of @tanstack/store with typed plugins and React bindings.",
+  "license": "MIT",
+  "homepage": "https://github.com/LunarHUE/store#readme",
+  "bugs": {
+    "url": "https://github.com/LunarHUE/store/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LunarHUE/store.git",
+    "directory": "packages/store"
+  },
+  "keywords": [
+    "state",
+    "store",
+    "tanstack",
+    "react",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/core/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./plugins/actions": {
+      "types": "./dist/plugins/actions/index.d.ts",
+      "import": "./dist/plugins/actions/index.js"
+    },
+    "./plugins/persist": {
+      "types": "./dist/plugins/persist/index.d.ts",
+      "import": "./dist/plugins/persist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "check": "bun run typecheck && bun run test"
+  },
+  "dependencies": {
+    "@tanstack/react-store": "0.9.2",
+    "@tanstack/store": "0.9.2"
+  },
+  "peerDependencies": {
+    "react": "^19.1.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^19.1.12",
+    "@types/react-dom": "^19.1.9",
+    "jsdom": "^27.0.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  }
+}