@lunarhue/store 0.2.0 → 0.3.0

package/dist/react/index.d.ts

@@ -1,30 +1,101 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { S as StoreBuilder, a as Store, e as StoreState } from '../types-BfzW2j9T.js';
+import { S as StoreBuilder, a as Store, c as StoreInitialStateLoader, h as StoreState } from '../types-CugArdrs.js';
 import '@tanstack/store';
 
 type StoreProviderChildren<TState, TPlugins> = ReactNode | ((args: {
     store: Store<TState, TPlugins>;
 }) => ReactNode);
-type BuilderProviderProps<TState, TPlugins> = {
+type BuilderProviderBaseProps<TState, TPlugins> = {
     builder: StoreBuilder<TState, TPlugins>;
     children?: StoreProviderChildren<TState, TPlugins>;
+    hasInitialState?: boolean;
     store?: never;
 };
+type BuilderProviderWithInitialStateProps<TState, TPlugins> = BuilderProviderBaseProps<TState, TPlugins> & {
+    initialState: TState;
+    loadInitialState?: never;
+};
+type BuilderProviderWithLoadInitialStateProps<TState, TPlugins> = BuilderProviderBaseProps<TState, TPlugins> & {
+    initialState?: never;
+    loadInitialState: StoreInitialStateLoader<TState, TPlugins>;
+};
+type BuilderProviderWithDeclaredInitialStateProps<TState, TPlugins> = BuilderProviderBaseProps<TState, TPlugins> & {
+    initialState?: never;
+    loadInitialState?: never;
+};
+type BuilderProviderProps<TState, TPlugins> = BuilderProviderWithDeclaredInitialStateProps<TState, TPlugins> | BuilderProviderWithInitialStateProps<TState, TPlugins> | BuilderProviderWithLoadInitialStateProps<TState, TPlugins>;
 type StoreProviderProps<TState, TPlugins> = {
     builder?: never;
     children?: StoreProviderChildren<TState, TPlugins>;
     store: Store<TState, TPlugins>;
 };
-type ProviderProps<TState, TPlugins> = BuilderProviderProps<TState, TPlugins> | StoreProviderProps<TState, TPlugins>;
+/**
+ * Props for {@link StoreProvider}.
+ *
+ * Use either `builder` to let the provider create and own the runtime store,
+ * or `store` to provide an already-created runtime store. When a builder has
+ * no declared initial state, the builder-owned form must also provide either
+ * `initialState` or `loadInitialState`.
+ */
+type ProviderProps<TState, TPlugins = {}> = BuilderProviderProps<TState, TPlugins> | StoreProviderProps<TState, TPlugins>;
+/**
+ * Provides a builder-scoped runtime store to React descendants.
+ *
+ * Builder-owned providers create and dispose the runtime store automatically.
+ * External-store providers reuse an existing runtime store and do not own its
+ * disposal. The `builder` prop must remain stable for the provider lifetime.
+ * Children may be plain JSX or a render prop that receives the resolved
+ * runtime store instance.
+ */
 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>;
+type LocalStoreOptionsBase = {};
+type LocalStoreWithInitialStateOptions<TState> = LocalStoreOptionsBase & {
+    initialState: TState;
+    loadInitialState?: never;
+};
+type LocalStoreWithLoadInitialStateOptions<TState, TPlugins> = LocalStoreOptionsBase & {
+    initialState?: never;
+    loadInitialState: StoreInitialStateLoader<TState, TPlugins>;
+};
+type LocalStoreDeclaredInitialStateOptions = LocalStoreOptionsBase & {
+    initialState?: never;
+    loadInitialState?: never;
+};
+type LocalStoreOptions<TState, TPlugins> = LocalStoreDeclaredInitialStateOptions | LocalStoreWithInitialStateOptions<TState> | LocalStoreWithLoadInitialStateOptions<TState, TPlugins>;
+/**
+ * Creates and owns a local runtime store for the current hook call site.
+ *
+ * The returned store is disposed on unmount. Pass `initialState` to start the
+ * local store ready immediately, or `loadInitialState` to initialize a builder
+ * that was declared without a default value. Without a declared default or one
+ * of those options, the returned runtime store begins uninitialized.
+ */
+declare function useLocalStore<TState, TPlugins>(builder: StoreBuilder<TState, TPlugins>, options?: LocalStoreOptions<TState, TPlugins>): Store<TState, TPlugins>;
 
+/**
+ * Subscribes to a selected slice of a runtime store instance.
+ *
+ * Use this when you already have a runtime store object. For builder-scoped
+ * selection through context, use {@link useStoreSelector}.
+ */
 declare function useSelector<TStore extends Store<any, any>, TSelected, TState extends StoreState<TStore>>(store: TStore, selector: (snapshot: TState) => TSelected, compare?: (a: TSelected, b: TSelected) => boolean): TSelected;
 
+/**
+ * Returns the runtime store provided for a builder.
+ *
+ * This hook requires a matching {@link StoreProvider} ancestor using either
+ * the same builder or a runtime store created from that builder.
+ */
 declare function useStore<TState, TPlugins>(builder: StoreBuilder<TState, TPlugins>): Store<TState, TPlugins>;
 
+/**
+ * Convenience hook that resolves a builder-scoped runtime store from context
+ * and subscribes to a selected slice of its state.
+ *
+ * This has the same matching-provider requirement as {@link useStore}.
+ */
 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

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

package/dist/types-CugArdrs.d.ts

@@ -0,0 +1,107 @@
+import { Readable, Store as Store$1 } from '@tanstack/store';
+
+/**
+ * Cleanup registered by a plugin to run when a runtime store is disposed.
+ */
+type StoreCleanup = () => void | Promise<void>;
+/**
+ * Minimal read-only store surface exposed for lifecycle and metadata stores.
+ */
+type ReadableStore<TState> = Pick<Readable<TState>, 'get' | 'subscribe'> & {
+    /**
+     * Current snapshot.
+     */
+    readonly state: TState;
+};
+/**
+ * Initialization state for a runtime store.
+ */
+type StoreLifecycleStatus = 'uninitialized' | 'initializing' | 'ready' | 'error';
+/**
+ * Current initialization metadata for a runtime store.
+ */
+type StoreLifecycleMeta = {
+    /**
+     * Current readiness state for the runtime store.
+     */
+    status: StoreLifecycleStatus;
+    /**
+     * Initialization error captured while resolving initial state.
+     */
+    error: unknown | null;
+};
+/**
+ * Loads initial state for a runtime store that was created without a declared
+ * default value.
+ */
+type StoreInitialStateLoader<TState, TPlugins = {}> = (args: {
+    store: Store<TState, TPlugins>;
+}) => Promise<TState> | TState;
+type StoreLifecycleSurface<TState> = {
+    /**
+     * Initializes a runtime store that was created without a ready state.
+     *
+     * This may only be called once per runtime store.
+     */
+    setInitialState(nextState: TState): Promise<void>;
+    lifecycle: {
+        /**
+         * Read-only lifecycle metadata for the runtime store.
+         */
+        meta: ReadableStore<StoreLifecycleMeta>;
+    };
+};
+/**
+ * Runtime Lunarhue store surface.
+ *
+ * This extends the TanStack store instance with lifecycle metadata,
+ * one-time initialization for uninitialized stores, disposal, and any plugin
+ * surfaces attached through the builder.
+ */
+type Store<TState, TPlugins = {}> = Store$1<TState> & StoreLifecycleSurface<TState> & {
+    dispose(): Promise<void>;
+} & TPlugins;
+/**
+ * Infers the state shape from a runtime store type.
+ */
+type StoreState<TStore extends Store<any, any>> = TStore extends {
+    get: () => infer TState;
+} ? TState : never;
+/**
+ * Context passed to a store plugin while a runtime store is being created.
+ */
+type StorePluginContext<TState, TPlugins> = {
+    /**
+     * Runtime store instance being extended.
+     */
+    store: Store<TState, TPlugins>;
+    /**
+     * Registers cleanup work to run when the runtime store is disposed.
+     */
+    onDispose(cleanup: StoreCleanup): void;
+};
+/**
+ * Additive plugin that extends the runtime store surface without storing
+ * plugin metadata inside application state.
+ */
+type StorePlugin<TState, TPlugins, TNextPlugins> = (context: StorePluginContext<TState, TPlugins>) => TNextPlugins;
+/**
+ * Immutable builder used to declare plugins once and create fresh runtime
+ * stores on demand.
+ */
+type StoreBuilder<TState, TPlugins = {}> = {
+    /**
+     * Creates a fresh runtime store instance.
+     *
+     * Passing `initialState` makes the runtime store ready immediately even when
+     * the builder was declared without a default value.
+     */
+    create(initialState?: TState): Store<TState, TPlugins>;
+    /**
+     * Returns a new builder with the plugin surface merged into the runtime
+     * store type.
+     */
+    extend<TNextPlugins>(plugin: StorePlugin<TState, TPlugins, TNextPlugins>): StoreBuilder<TState, TPlugins & TNextPlugins>;
+};
+
+export type { ReadableStore as R, StoreBuilder as S, Store as a, StoreCleanup as b, StoreInitialStateLoader as c, StoreLifecycleMeta as d, StoreLifecycleStatus as e, StorePlugin as f, StorePluginContext as g, StoreState as h };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunarhue/store",
-  "version": "0.2.0",
+  "version": "0.3.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",
@@ -47,6 +47,7 @@
   },
   "scripts": {
     "build": "tsup",
+    "dev": "tsup --watch",
     "contract": "bun run build && node ./scripts/check-package-contract.mjs",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",

package/dist/chunk-ALACXQX3.js

@@ -1,103 +0,0 @@
-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-ALACXQX3.js.map
-//# sourceMappingURL=chunk-ALACXQX3.js.map

package/dist/chunk-ALACXQX3.js.map

@@ -1 +0,0 @@
-{"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-ALACXQX3.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'\nimport type { Store as BaseStore } from '@tanstack/store'\n\nimport type { Store, StoreState } from '../core'\n\nexport function useSelector<\n  TStore extends Store<any, any>,\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<BaseStore<TState>, TSelected>(\n    store as BaseStore<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

@@ -1,45 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/types-BfzW2j9T.d.ts

@@ -1,20 +0,0 @@
-import { Store as Store$1 } from '@tanstack/store';
-
-type StoreCleanup = () => void | Promise<void>;
-type Store<TState, TPlugins = {}> = Store$1<TState> & {
-    dispose(): Promise<void>;
-} & TPlugins;
-type StoreState<TStore extends Store<any, any>> = 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 { StoreBuilder as S, Store as a, StoreCleanup as b, StorePlugin as c, StorePluginContext as d, StoreState as e };