@lunarhue/store 0.3.0 → 0.4.0

package/README.md

@@ -38,6 +38,27 @@ uninitialized runtime store. In that case, provide `initialState` or
 `loadInitialState` when using the React provider, or call
 `store.setInitialState(...)` before reading or writing state directly.
 
+## Runtime debugging
+
+Debugging is explicit and per runtime store instance.
+
+```ts
+const events = []
+const store = CounterStore.create(undefined, {
+  debug: {
+    level: 'trace',
+    console: false,
+    sink(event) {
+      events.push(event)
+    },
+  },
+})
+```
+
+Builder-owned `StoreProvider` and `PersistStoreProvider` also accept `debug`,
+and `useLocalStore(builder, { debug: ... })` forwards the same config for
+locally owned runtimes.
+
 ## React usage
 
 ```tsx

package/dist/chunk-JB6XVML6.js

@@ -0,0 +1,146 @@
+// src/core/logger.ts
+var builderLoggerMetadataKey = /* @__PURE__ */ Symbol("lunarhue.store.logger.builder");
+var storeLoggerMetadataKey = /* @__PURE__ */ Symbol("lunarhue.store.logger.store");
+var debugLevelRank = {
+  basic: 0,
+  verbose: 1,
+  trace: 2
+};
+var nextBuilderId = 1;
+var nextStoreId = 1;
+var nextSubscriptionId = 1;
+function createBuilderLoggerMetadata() {
+  return {
+    builderId: `b${nextBuilderId++}`
+  };
+}
+function defineBuilderLoggerMetadata(builder, metadata) {
+  Object.defineProperty(builder, builderLoggerMetadataKey, {
+    configurable: false,
+    enumerable: false,
+    value: metadata,
+    writable: false
+  });
+}
+function createStoreLoggerMetadata(args) {
+  return {
+    builderId: args.builderId,
+    storeId: `s${nextStoreId++}`,
+    sequence: 0,
+    options: resolveStoreDebugOptions(args.debug)
+  };
+}
+function defineStoreLoggerMetadata(store, metadata) {
+  Object.defineProperty(store, storeLoggerMetadataKey, {
+    configurable: false,
+    enumerable: false,
+    value: metadata,
+    writable: false
+  });
+}
+function getStoreLoggerMetadata(store) {
+  return store[storeLoggerMetadataKey];
+}
+function createSubscriptionLoggerId() {
+  return `sub${nextSubscriptionId++}`;
+}
+function shouldEmitStoreDebugEvent(configuredLevel, minimumLevel) {
+  return debugLevelRank[configuredLevel] >= debugLevelRank[minimumLevel];
+}
+function emitStoreDebugEvent(store, args) {
+  const metadata = getStoreLoggerMetadata(store);
+  if (!metadata?.options.enabled) {
+    return null;
+  }
+  const minimumLevel = args.minimumLevel ?? "basic";
+  if (!shouldEmitStoreDebugEvent(metadata.options.level, minimumLevel)) {
+    return null;
+  }
+  const event = {
+    builderId: metadata.builderId,
+    event: args.event,
+    level: metadata.options.level,
+    sequence: ++metadata.sequence,
+    source: args.source,
+    storeId: metadata.storeId,
+    timestamp: Date.now()
+  };
+  if (args.detail !== void 0) {
+    event.detail = args.detail;
+  }
+  if (args.error !== void 0) {
+    event.error = args.error;
+  }
+  if (args.status !== void 0) {
+    event.status = args.status;
+  }
+  if (args.subscriptionId !== void 0) {
+    event.subscriptionId = args.subscriptionId;
+  }
+  if (metadata.options.level === "trace") {
+    if (args.previousState !== void 0) {
+      event.previousState = args.previousState;
+    }
+    if (args.nextState !== void 0) {
+      event.nextState = args.nextState;
+    }
+  }
+  if (metadata.options.console) {
+    writeStoreDebugConsoleEvent(event);
+  }
+  if (metadata.options.sink) {
+    try {
+      metadata.options.sink(event);
+    } catch (error) {
+      console.error("[lunarhue/store][debug] sink failed", error);
+    }
+  }
+  return event;
+}
+function transitionStoreLifecycle(store, lifecycleMeta, nextState, args) {
+  const previousState = lifecycleMeta.get();
+  lifecycleMeta.setState(() => nextState);
+  if (previousState.status === nextState.status && Object.is(previousState.error, nextState.error)) {
+    return;
+  }
+  emitStoreDebugEvent(store, {
+    detail: args?.detail,
+    error: nextState.error ?? void 0,
+    event: "store.lifecycle.changed",
+    minimumLevel: args?.minimumLevel,
+    source: args?.source ?? "core",
+    status: nextState.status
+  });
+}
+function resolveStoreDebugOptions(debug) {
+  if (!debug) {
+    return {
+      console: false,
+      enabled: false,
+      level: "basic"
+    };
+  }
+  return {
+    console: debug.console ?? true,
+    enabled: true,
+    level: debug.level ?? "basic",
+    sink: debug.sink
+  };
+}
+function writeStoreDebugConsoleEvent(event) {
+  const method = event.error !== void 0 || event.event.endsWith(".error") || event.event.endsWith(".failed") ? console.error : console.log;
+  method("[lunarhue/store][debug]", event);
+}
+
+// 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 { createBuilderLoggerMetadata, createStoreLoggerMetadata, createSubscriptionLoggerId, defineBuilderLoggerMetadata, defineStoreLoggerMetadata, emitStoreDebugEvent, getStoreBuilder, registerStoreBuilder, transitionStoreLifecycle };
+//# sourceMappingURL=chunk-JB6XVML6.js.map
+//# sourceMappingURL=chunk-JB6XVML6.js.map

package/dist/chunk-JB6XVML6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/logger.ts","../src/core/builder-registry.ts"],"names":[],"mappings":"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","file":"chunk-JB6XVML6.js","sourcesContent":["import type { Store } from './types'\nimport type {\n  StoreDebugEvent,\n  StoreDebugEventName,\n  StoreDebugLevel,\n  StoreDebugLogArgs,\n  StoreDebugOptions,\n  StoreLifecycleMeta,\n} from './types'\n\nconst builderLoggerMetadataKey = Symbol('lunarhue.store.logger.builder')\nconst storeLoggerMetadataKey = Symbol('lunarhue.store.logger.store')\n\nconst debugLevelRank: Record<StoreDebugLevel, number> = {\n  basic: 0,\n  verbose: 1,\n  trace: 2,\n}\n\nlet nextBuilderId = 1\nlet nextStoreId = 1\nlet nextSubscriptionId = 1\n\ntype ResolvedStoreDebugOptions<TState> = {\n  enabled: boolean\n  level: StoreDebugLevel\n  console: boolean\n  sink?: ((event: StoreDebugEvent<TState>) => void) | undefined\n}\n\nexport type StoreBuilderLoggerMetadata = {\n  builderId: string\n}\n\nexport type StoreLoggerMetadata<TState> = {\n  builderId: string\n  storeId: string\n  sequence: number\n  options: ResolvedStoreDebugOptions<TState>\n}\n\ntype WritableReadableStore<TState> = {\n  get(): TState\n  setState(updater: (prev: TState) => TState): void\n}\n\nexport function createBuilderLoggerMetadata(): StoreBuilderLoggerMetadata {\n  return {\n    builderId: `b${nextBuilderId++}`,\n  }\n}\n\nexport function defineBuilderLoggerMetadata<TBuilder extends object>(\n  builder: TBuilder,\n  metadata: StoreBuilderLoggerMetadata,\n): void {\n  Object.defineProperty(builder, builderLoggerMetadataKey, {\n    configurable: false,\n    enumerable: false,\n    value: metadata,\n    writable: false,\n  })\n}\n\nexport function getBuilderLoggerMetadata<TBuilder extends object>(\n  builder: TBuilder,\n): StoreBuilderLoggerMetadata | undefined {\n  return (\n    builder as TBuilder & {\n      [builderLoggerMetadataKey]?: StoreBuilderLoggerMetadata\n    }\n  )[builderLoggerMetadataKey]\n}\n\nexport function createStoreLoggerMetadata<TState>(args: {\n  builderId: string\n  debug?: StoreDebugOptions<TState>\n}): StoreLoggerMetadata<TState> {\n  return {\n    builderId: args.builderId,\n    storeId: `s${nextStoreId++}`,\n    sequence: 0,\n    options: resolveStoreDebugOptions(args.debug),\n  }\n}\n\nexport function defineStoreLoggerMetadata<TState>(\n  store: Store<TState, any>,\n  metadata: StoreLoggerMetadata<TState>,\n): void {\n  Object.defineProperty(store, storeLoggerMetadataKey, {\n    configurable: false,\n    enumerable: false,\n    value: metadata,\n    writable: false,\n  })\n}\n\nexport function getStoreLoggerMetadata<TState>(\n  store: Store<TState, any>,\n): StoreLoggerMetadata<TState> | undefined {\n  return (\n    store as Store<TState, any> & {\n      [storeLoggerMetadataKey]?: StoreLoggerMetadata<TState>\n    }\n  )[storeLoggerMetadataKey]\n}\n\nexport function createSubscriptionLoggerId(): string {\n  return `sub${nextSubscriptionId++}`\n}\n\nexport function shouldEmitStoreDebugEvent(\n  configuredLevel: StoreDebugLevel,\n  minimumLevel: StoreDebugLevel,\n): boolean {\n  return debugLevelRank[configuredLevel] >= debugLevelRank[minimumLevel]\n}\n\nexport function emitStoreDebugEvent<TState>(\n  store: Store<TState, any>,\n  args: StoreDebugLogArgs<TState>,\n): StoreDebugEvent<TState> | null {\n  const metadata = getStoreLoggerMetadata(store)\n\n  if (!metadata?.options.enabled) {\n    return null\n  }\n\n  const minimumLevel = args.minimumLevel ?? 'basic'\n\n  if (!shouldEmitStoreDebugEvent(metadata.options.level, minimumLevel)) {\n    return null\n  }\n\n  const event: StoreDebugEvent<TState> = {\n    builderId: metadata.builderId,\n    event: args.event,\n    level: metadata.options.level,\n    sequence: ++metadata.sequence,\n    source: args.source,\n    storeId: metadata.storeId,\n    timestamp: Date.now(),\n  }\n\n  if (args.detail !== undefined) {\n    event.detail = args.detail\n  }\n\n  if (args.error !== undefined) {\n    event.error = args.error\n  }\n\n  if (args.status !== undefined) {\n    event.status = args.status\n  }\n\n  if (args.subscriptionId !== undefined) {\n    event.subscriptionId = args.subscriptionId\n  }\n\n  if (metadata.options.level === 'trace') {\n    if (args.previousState !== undefined) {\n      event.previousState = args.previousState\n    }\n\n    if (args.nextState !== undefined) {\n      event.nextState = args.nextState\n    }\n  }\n\n  if (metadata.options.console) {\n    writeStoreDebugConsoleEvent(event)\n  }\n\n  if (metadata.options.sink) {\n    try {\n      metadata.options.sink(event)\n    } catch (error) {\n      console.error('[lunarhue/store][debug] sink failed', error)\n    }\n  }\n\n  return event\n}\n\nexport function transitionStoreLifecycle<TState>(\n  store: Store<TState, any>,\n  lifecycleMeta: WritableReadableStore<StoreLifecycleMeta>,\n  nextState: StoreLifecycleMeta,\n  args?: {\n    source?: string\n    minimumLevel?: StoreDebugLevel\n    detail?: Record<string, unknown>\n  },\n): void {\n  const previousState = lifecycleMeta.get()\n  lifecycleMeta.setState(() => nextState)\n\n  if (\n    previousState.status === nextState.status &&\n    Object.is(previousState.error, nextState.error)\n  ) {\n    return\n  }\n\n  emitStoreDebugEvent(store, {\n    detail: args?.detail,\n    error: nextState.error ?? undefined,\n    event: 'store.lifecycle.changed',\n    minimumLevel: args?.minimumLevel,\n    source: args?.source ?? 'core',\n    status: nextState.status,\n  })\n}\n\nfunction resolveStoreDebugOptions<TState>(\n  debug?: StoreDebugOptions<TState>,\n): ResolvedStoreDebugOptions<TState> {\n  if (!debug) {\n    return {\n      console: false,\n      enabled: false,\n      level: 'basic',\n    }\n  }\n\n  return {\n    console: debug.console ?? true,\n    enabled: true,\n    level: debug.level ?? 'basic',\n    sink: debug.sink,\n  }\n}\n\nfunction writeStoreDebugConsoleEvent<TState>(\n  event: StoreDebugEvent<TState>,\n): void {\n  const method =\n    event.error !== undefined ||\n    event.event.endsWith('.error') ||\n    event.event.endsWith('.failed')\n      ? console.error\n      : console.log\n\n  method('[lunarhue/store][debug]', event)\n}\n","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/{chunk-GHGDIRN2.js → chunk-SOWFT4FH.js}

@@ -1,4 +1,4 @@
-import { getStoreBuilder } from './chunk-PCSRXZL4.js';
+import { emitStoreDebugEvent, transitionStoreLifecycle, getStoreBuilder } from './chunk-JB6XVML6.js';
 import { useRef, useState, useEffectEvent, useEffect, useContext, createContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 import { useStore as useStore$1 } from '@tanstack/react-store';
@@ -18,6 +18,7 @@ function StoreProvider(props) {
       BuilderOwnedStoreProvider,
       {
         builder: props.builder,
+        debug: props.debug,
         hasInitialState: "initialState" in props,
         initialState: props.initialState,
         loadInitialState: props.loadInitialState,
@@ -27,12 +28,10 @@ function StoreProvider(props) {
   }
   return /* @__PURE__ */ jsx(ExternalStoreProvider, { store: props.store, children: props.children });
 }
-function updateLifecycleMeta(store, updater) {
-  store.lifecycle.meta.setState(updater);
-}
 function BuilderOwnedStoreProvider({
   builder,
   children,
+  debug,
   hasInitialState,
   initialState,
   loadInitialState
@@ -53,26 +52,67 @@ function BuilderOwnedStoreProvider({
     }
   }
   if (!storeRef.current) {
-    storeRef.current = hasInitialState ? builder.create(initialState) : builder.create();
+    storeRef.current = builder.create(
+      hasInitialState ? initialState : void 0,
+      { debug }
+    );
   }
   const initializeStore = useEffectEvent(async () => {
     const ownedStore2 = storeRef.current;
     if (!ownedStore2 || !loadInitialState) {
       return;
     }
-    updateLifecycleMeta(ownedStore2, (prev) => ({
-      ...prev,
-      status: "initializing",
-      error: null
-    }));
+    emitStoreDebugEvent(ownedStore2, {
+      detail: {
+        initMode: "loadInitialState",
+        owner: "provider"
+      },
+      event: "provider.initialize.started",
+      source: "react"
+    });
+    transitionStoreLifecycle(
+      ownedStore2,
+      ownedStore2.lifecycle.meta,
+      {
+        status: "initializing",
+        error: null
+      },
+      {
+        source: "react"
+      }
+    );
     try {
       const nextState = await loadInitialState({ store: ownedStore2 });
       await ownedStore2.setInitialState(nextState);
+      emitStoreDebugEvent(ownedStore2, {
+        detail: {
+          initMode: "loadInitialState",
+          owner: "provider"
+        },
+        event: "provider.initialize.completed",
+        source: "react"
+      });
     } catch (error) {
-      updateLifecycleMeta(ownedStore2, () => ({
-        status: "error",
-        error
-      }));
+      emitStoreDebugEvent(ownedStore2, {
+        detail: {
+          initMode: "loadInitialState",
+          owner: "provider"
+        },
+        error,
+        event: "provider.initialize.failed",
+        source: "react"
+      });
+      transitionStoreLifecycle(
+        ownedStore2,
+        ownedStore2.lifecycle.meta,
+        {
+          status: "error",
+          error
+        },
+        {
+          source: "react"
+        }
+      );
     }
   });
   useEffect(() => {
@@ -80,10 +120,28 @@ function BuilderOwnedStoreProvider({
     if (!ownedStore2) {
       return;
     }
+    emitStoreDebugEvent(ownedStore2, {
+      detail: {
+        mode: "builder",
+        owner: "provider"
+      },
+      event: "provider.mount",
+      minimumLevel: "verbose",
+      source: "react"
+    });
     const subscription = ownedStore2.lifecycle.meta.subscribe(() => {
       forceRender((value) => value + 1);
     });
     return () => {
+      emitStoreDebugEvent(ownedStore2, {
+        detail: {
+          mode: "builder",
+          owner: "provider"
+        },
+        event: "provider.unmount",
+        minimumLevel: "verbose",
+        source: "react"
+      });
       subscription.unsubscribe();
       if (!ownedStore2) {
         return;
@@ -125,6 +183,28 @@ function ExternalStoreProvider({
       "StoreProvider could not resolve a builder for the provided store. Pass a store created by @lunarhue/store."
     );
   }
+  useEffect(() => {
+    emitStoreDebugEvent(store, {
+      detail: {
+        mode: "external",
+        owner: "provider"
+      },
+      event: "provider.mount",
+      minimumLevel: "verbose",
+      source: "react"
+    });
+    return () => {
+      emitStoreDebugEvent(store, {
+        detail: {
+          mode: "external",
+          owner: "provider"
+        },
+        event: "provider.unmount",
+        minimumLevel: "verbose",
+        source: "react"
+      });
+    };
+  }, [store]);
   const context = getStoreContext(builder);
   const content = typeof children === "function" ? children({ store }) : children;
   return /* @__PURE__ */ jsx(context.Provider, { value: store, children: content });
@@ -132,25 +212,86 @@ function ExternalStoreProvider({
 function useLocalStore(builder, options) {
   const initializeStartedRef = useRef(false);
   const localStoreRef = useRef(null);
+  const [, forceRender] = useState(0);
   const hasInitialState = options !== void 0 && Object.prototype.hasOwnProperty.call(options, "initialState");
   if (!localStoreRef.current) {
-    localStoreRef.current = hasInitialState ? builder.create(options?.initialState) : builder.create();
+    localStoreRef.current = builder.create(
+      hasInitialState ? options?.initialState : void 0,
+      { debug: options?.debug }
+    );
   }
   const initializeStore = useEffectEvent(async () => {
     const localStore = localStoreRef.current;
     if (!localStore || !options?.loadInitialState) {
       return;
     }
-    const nextState = await options.loadInitialState({ store: localStore });
-    await localStore.setInitialState(nextState);
+    emitStoreDebugEvent(localStore, {
+      detail: {
+        initMode: "loadInitialState",
+        owner: "local"
+      },
+      event: "local.initialize.started",
+      source: "react"
+    });
+    transitionStoreLifecycle(
+      localStore,
+      localStore.lifecycle.meta,
+      {
+        status: "initializing",
+        error: null
+      },
+      {
+        source: "react"
+      }
+    );
+    try {
+      const nextState = await options.loadInitialState({ store: localStore });
+      await localStore.setInitialState(nextState);
+      emitStoreDebugEvent(localStore, {
+        detail: {
+          initMode: "loadInitialState",
+          owner: "local"
+        },
+        event: "local.initialize.completed",
+        source: "react"
+      });
+    } catch (error) {
+      emitStoreDebugEvent(localStore, {
+        detail: {
+          initMode: "loadInitialState",
+          owner: "local"
+        },
+        error,
+        event: "local.initialize.failed",
+        source: "react"
+      });
+      transitionStoreLifecycle(
+        localStore,
+        localStore.lifecycle.meta,
+        {
+          status: "error",
+          error
+        },
+        {
+          source: "react"
+        }
+      );
+    }
   });
   useEffect(() => {
     const localStore = localStoreRef.current;
+    if (!localStore) {
+      return;
+    }
+    const subscription = localStore.lifecycle.meta.subscribe(() => {
+      forceRender((value) => value + 1);
+    });
     if (localStore && !initializeStartedRef.current && localStore.lifecycle.meta.get().status === "uninitialized" && options?.loadInitialState) {
       initializeStartedRef.current = true;
       void initializeStore();
     }
     return () => {
+      subscription.unsubscribe();
       if (!localStore) {
         return;
       }
@@ -183,5 +324,5 @@ function useStoreSelector(builder, selector, compare) {
 }
 
 export { StoreProvider, useLocalStore, useSelector, useStore, useStoreSelector };
-//# sourceMappingURL=chunk-GHGDIRN2.js.map
-//# sourceMappingURL=chunk-GHGDIRN2.js.map
+//# sourceMappingURL=chunk-SOWFT4FH.js.map
+//# sourceMappingURL=chunk-SOWFT4FH.js.map

package/dist/chunk-SOWFT4FH.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":["ownedStore","useRef","useState","useEffectEvent","useEffect","useTanStackStore"],"mappings":"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","file":"chunk-SOWFT4FH.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 {\n  useEffect,\n  useEffectEvent,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react'\n\nimport { emitStoreDebugEvent, transitionStoreLifecycle } from '../core/logger'\nimport { getStoreBuilder } from '../core/builder-registry'\nimport { getStoreContext } from './context'\n\nimport type {\n  Store,\n  StoreBuilder,\n  StoreDebugOptions,\n  StoreInitialStateLoader,\n  StoreLifecycleMeta,\n} from '../core'\n\ntype StoreProviderChildren<TState, TPlugins> =\n  | ReactNode\n  | ((args: { store: Store<TState, TPlugins> }) => ReactNode)\n\ntype BuilderProviderBaseProps<TState, TPlugins> = {\n  builder: StoreBuilder<TState, TPlugins>\n  children?: StoreProviderChildren<TState, TPlugins>\n  debug?: StoreDebugOptions<TState>\n  hasInitialState?: boolean\n  store?: never\n}\n\ntype BuilderProviderWithInitialStateProps<TState, TPlugins> =\n  BuilderProviderBaseProps<TState, TPlugins> & {\n    initialState: TState\n    loadInitialState?: never\n  }\n\ntype BuilderProviderWithLoadInitialStateProps<TState, TPlugins> =\n  BuilderProviderBaseProps<TState, TPlugins> & {\n    initialState?: never\n    loadInitialState: StoreInitialStateLoader<TState, TPlugins>\n  }\n\ntype BuilderProviderWithDeclaredInitialStateProps<TState, TPlugins> =\n  BuilderProviderBaseProps<TState, TPlugins> & {\n    initialState?: never\n    loadInitialState?: never\n  }\n\ntype BuilderProviderProps<TState, TPlugins> =\n  | BuilderProviderWithDeclaredInitialStateProps<TState, TPlugins>\n  | BuilderProviderWithInitialStateProps<TState, TPlugins>\n  | BuilderProviderWithLoadInitialStateProps<TState, TPlugins>\n\ntype BuilderOwnedStoreProviderProps<TState, TPlugins> = {\n  builder: StoreBuilder<TState, TPlugins>\n  children?: StoreProviderChildren<TState, TPlugins>\n  debug?: StoreDebugOptions<TState>\n  hasInitialState: boolean\n  initialState?: TState\n  loadInitialState?: StoreInitialStateLoader<TState, TPlugins>\n}\n\ntype StoreProviderProps<TState, TPlugins> = {\n  builder?: never\n  children?: StoreProviderChildren<TState, TPlugins>\n  store: Store<TState, TPlugins>\n}\n\n/**\n * Props for {@link StoreProvider}.\n *\n * Use either `builder` to let the provider create and own the runtime store,\n * or `store` to provide an already-created runtime store. When a builder has\n * no declared initial state, the builder-owned form must also provide either\n * `initialState` or `loadInitialState`.\n */\nexport type ProviderProps<TState, TPlugins = {}> =\n  | BuilderProviderProps<TState, TPlugins>\n  | StoreProviderProps<TState, TPlugins>\n\n/**\n * Provides a builder-scoped runtime store to React descendants.\n *\n * Builder-owned providers create and dispose the runtime store automatically.\n * External-store providers reuse an existing runtime store and do not own its\n * disposal. The `builder` prop must remain stable for the provider lifetime.\n * Children may be plain JSX or a render prop that receives the resolved\n * runtime store instance.\n */\nexport function StoreProvider<TState, TPlugins>(\n  props: ProviderProps<TState, TPlugins>,\n) {\n  if (props.builder !== undefined) {\n    return (\n      <BuilderOwnedStoreProvider\n        builder={props.builder}\n        debug={props.debug}\n        hasInitialState={'initialState' in props}\n        initialState={props.initialState}\n        loadInitialState={props.loadInitialState}\n      >\n        {props.children}\n      </BuilderOwnedStoreProvider>\n    )\n  }\n\n  return (\n    <ExternalStoreProvider store={props.store}>\n      {props.children}\n    </ExternalStoreProvider>\n  )\n}\n\n// Native and Expo declare this globally in development mode.\ndeclare const __DEV__: boolean\n\nfunction BuilderOwnedStoreProvider<TState, TPlugins>({\n  builder,\n  children,\n  debug,\n  hasInitialState,\n  initialState,\n  loadInitialState,\n}: BuilderOwnedStoreProviderProps<TState, TPlugins>) {\n  const context = getStoreContext(builder)\n  const builderRef = useRef<StoreBuilder<TState, TPlugins> | null>(null)\n  const initializeStartedRef = useRef(false)\n  const storeRef = useRef<Store<TState, TPlugins> | null>(null)\n  const [, forceRender] = useState(0)\n\n  if (!builderRef.current) {\n    builderRef.current = builder\n  } else if (builderRef.current !== builder) {\n    const isDev =\n      process.env.NODE_ENV !== 'production' ||\n      (typeof __DEV__ !== 'undefined' && __DEV__)\n\n    if (isDev) {\n      console.warn('StoreProvider builder prop must remain stable.')\n    } else {\n      throw new Error('StoreProvider builder prop must remain stable.')\n    }\n  }\n\n  if (!storeRef.current) {\n    storeRef.current = builder.create(\n      hasInitialState ? (initialState as TState) : undefined,\n      { debug },\n    )\n  }\n\n  const initializeStore = useEffectEvent(async () => {\n    const ownedStore = storeRef.current\n\n    if (!ownedStore || !loadInitialState) {\n      return\n    }\n\n    emitStoreDebugEvent(ownedStore, {\n      detail: {\n        initMode: 'loadInitialState',\n        owner: 'provider',\n      },\n      event: 'provider.initialize.started',\n      source: 'react',\n    })\n    transitionStoreLifecycle(\n      ownedStore,\n      ownedStore.lifecycle.meta as unknown as WritableReadableStore<StoreLifecycleMeta>,\n      {\n        status: 'initializing',\n        error: null,\n      },\n      {\n        source: 'react',\n      },\n    )\n\n    try {\n      const nextState = await loadInitialState({ store: ownedStore })\n      await ownedStore.setInitialState(nextState)\n      emitStoreDebugEvent(ownedStore, {\n        detail: {\n          initMode: 'loadInitialState',\n          owner: 'provider',\n        },\n        event: 'provider.initialize.completed',\n        source: 'react',\n      })\n    } catch (error) {\n      emitStoreDebugEvent(ownedStore, {\n        detail: {\n          initMode: 'loadInitialState',\n          owner: 'provider',\n        },\n        error,\n        event: 'provider.initialize.failed',\n        source: 'react',\n      })\n      transitionStoreLifecycle(\n        ownedStore,\n        ownedStore.lifecycle.meta as unknown as WritableReadableStore<StoreLifecycleMeta>,\n        {\n          status: 'error',\n          error,\n        },\n        {\n          source: 'react',\n        },\n      )\n    }\n  })\n\n  useEffect(() => {\n    const ownedStore = storeRef.current\n\n    if (!ownedStore) {\n      return\n    }\n\n    emitStoreDebugEvent(ownedStore, {\n      detail: {\n        mode: 'builder',\n        owner: 'provider',\n      },\n      event: 'provider.mount',\n      minimumLevel: 'verbose',\n      source: 'react',\n    })\n\n    const subscription = ownedStore.lifecycle.meta.subscribe(() => {\n      forceRender((value) => value + 1)\n    })\n\n    return () => {\n      emitStoreDebugEvent(ownedStore, {\n        detail: {\n          mode: 'builder',\n          owner: 'provider',\n        },\n        event: 'provider.unmount',\n        minimumLevel: 'verbose',\n        source: 'react',\n      })\n      subscription.unsubscribe()\n\n      if (!ownedStore) {\n        return\n      }\n\n      void ownedStore.dispose()\n    }\n  }, [])\n\n  useEffect(() => {\n    const ownedStore = storeRef.current\n\n    if (\n      !ownedStore ||\n      initializeStartedRef.current ||\n      ownedStore.lifecycle.meta.get().status !== 'uninitialized' ||\n      !loadInitialState\n    ) {\n      return\n    }\n\n    initializeStartedRef.current = true\n    void initializeStore()\n  }, [loadInitialState, initializeStore])\n\n  const ownedStore = storeRef.current\n  const lifecycleMeta = ownedStore.lifecycle.meta.get()\n\n  if (lifecycleMeta.status === 'error') {\n    throw lifecycleMeta.error ?? new Error('Store initialization failed.')\n  }\n\n  if (lifecycleMeta.status === 'uninitialized' && !loadInitialState) {\n    throw new Error(\n      'StoreProvider requires initialState or loadInitialState when the builder has no declared initial state.',\n    )\n  }\n\n  if (\n    lifecycleMeta.status === 'uninitialized' ||\n    lifecycleMeta.status === 'initializing'\n  ) {\n    return <context.Provider value={ownedStore}>{null}</context.Provider>\n  }\n\n  const content =\n    typeof children === 'function'\n      ? children({ store: ownedStore })\n      : children\n\n  return <context.Provider value={ownedStore}>{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  useEffect(() => {\n    emitStoreDebugEvent(store, {\n      detail: {\n        mode: 'external',\n        owner: 'provider',\n      },\n      event: 'provider.mount',\n      minimumLevel: 'verbose',\n      source: 'react',\n    })\n\n    return () => {\n      emitStoreDebugEvent(store, {\n        detail: {\n          mode: 'external',\n          owner: 'provider',\n        },\n        event: 'provider.unmount',\n        minimumLevel: 'verbose',\n        source: 'react',\n      })\n    }\n  }, [store])\n\n  const context = getStoreContext(builder)\n  const content =\n    typeof children === 'function' ? children({ store }) : children\n\n  return <context.Provider value={store}>{content}</context.Provider>\n}\n\ntype WritableReadableStore<TState> = {\n  get(): TState\n  setState(updater: (prev: TState) => TState): void\n}\n","import { useEffect, useEffectEvent, useRef, useState } from 'react'\n\nimport { emitStoreDebugEvent, transitionStoreLifecycle } from '../core/logger'\nimport type { Store, StoreBuilder, StoreInitialStateLoader } from '../core'\nimport type { StoreDebugOptions, StoreLifecycleMeta } from '../core'\n\ntype LocalStoreOptionsBase<TState> = {\n  debug?: StoreDebugOptions<TState>\n}\n\ntype LocalStoreWithInitialStateOptions<TState> = LocalStoreOptionsBase<TState> & {\n  initialState: TState\n  loadInitialState?: never\n}\n\ntype LocalStoreWithLoadInitialStateOptions<TState, TPlugins> =\n  LocalStoreOptionsBase<TState> & {\n    initialState?: never\n    loadInitialState: StoreInitialStateLoader<TState, TPlugins>\n  }\n\ntype LocalStoreDeclaredInitialStateOptions<TState> = LocalStoreOptionsBase<TState> & {\n  initialState?: never\n  loadInitialState?: never\n}\n\ntype LocalStoreOptions<TState, TPlugins> =\n  | LocalStoreDeclaredInitialStateOptions<TState>\n  | LocalStoreWithInitialStateOptions<TState>\n  | LocalStoreWithLoadInitialStateOptions<TState, TPlugins>\n\n/**\n * Creates and owns a local runtime store for the current hook call site.\n *\n * The returned store is disposed on unmount. Pass `initialState` to start the\n * local store ready immediately, or `loadInitialState` to initialize a builder\n * that was declared without a default value. Without a declared default or one\n * of those options, the returned runtime store begins uninitialized.\n */\nexport function useLocalStore<TState, TPlugins>(\n  builder: StoreBuilder<TState, TPlugins>,\n  options?: LocalStoreOptions<TState, TPlugins>,\n): Store<TState, TPlugins> {\n  const initializeStartedRef = useRef(false)\n  const localStoreRef = useRef<Store<TState, TPlugins> | null>(null)\n  const [, forceRender] = useState(0)\n  const hasInitialState =\n    options !== undefined &&\n    Object.prototype.hasOwnProperty.call(options, 'initialState')\n\n  if (!localStoreRef.current) {\n    localStoreRef.current = builder.create(\n      hasInitialState ? (options?.initialState as TState) : undefined,\n      { debug: options?.debug },\n    )\n  }\n\n  const initializeStore = useEffectEvent(async () => {\n    const localStore = localStoreRef.current\n\n    if (!localStore || !options?.loadInitialState) {\n      return\n    }\n\n    emitStoreDebugEvent(localStore, {\n      detail: {\n        initMode: 'loadInitialState',\n        owner: 'local',\n      },\n      event: 'local.initialize.started',\n      source: 'react',\n    })\n    transitionStoreLifecycle(\n      localStore,\n      localStore.lifecycle.meta as unknown as WritableReadableStore<StoreLifecycleMeta>,\n      {\n        status: 'initializing',\n        error: null,\n      },\n      {\n        source: 'react',\n      },\n    )\n\n    try {\n      const nextState = await options.loadInitialState({ store: localStore })\n      await localStore.setInitialState(nextState)\n      emitStoreDebugEvent(localStore, {\n        detail: {\n          initMode: 'loadInitialState',\n          owner: 'local',\n        },\n        event: 'local.initialize.completed',\n        source: 'react',\n      })\n    } catch (error) {\n      emitStoreDebugEvent(localStore, {\n        detail: {\n          initMode: 'loadInitialState',\n          owner: 'local',\n        },\n        error,\n        event: 'local.initialize.failed',\n        source: 'react',\n      })\n      transitionStoreLifecycle(\n        localStore,\n        localStore.lifecycle.meta as unknown as WritableReadableStore<StoreLifecycleMeta>,\n        {\n          status: 'error',\n          error,\n        },\n        {\n          source: 'react',\n        },\n      )\n    }\n  })\n\n  useEffect(() => {\n    const localStore = localStoreRef.current\n\n    if (!localStore) {\n      return\n    }\n\n    const subscription = localStore.lifecycle.meta.subscribe(() => {\n      forceRender((value) => value + 1)\n    })\n\n    if (\n      localStore &&\n      !initializeStartedRef.current &&\n      localStore.lifecycle.meta.get().status === 'uninitialized' &&\n      options?.loadInitialState\n    ) {\n      initializeStartedRef.current = true\n      void initializeStore()\n    }\n\n    return () => {\n      subscription.unsubscribe()\n\n      if (!localStore) {\n        return\n      }\n\n      void localStore.dispose()\n    }\n  }, [initializeStore, options?.loadInitialState])\n\n  return localStoreRef.current\n}\n\ntype WritableReadableStore<TState> = {\n  get(): TState\n  setState(updater: (prev: TState) => TState): void\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\n/**\n * Subscribes to a selected slice of a runtime store instance.\n *\n * Use this when you already have a runtime store object. For builder-scoped\n * selection through context, use {@link useStoreSelector}.\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\n/**\n * Returns the runtime store provided for a builder.\n *\n * This hook requires a matching {@link StoreProvider} ancestor using either\n * the same builder or a runtime store created from that builder.\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\n/**\n * Convenience hook that resolves a builder-scoped runtime store from context\n * and subscribes to a selected slice of its state.\n *\n * This has the same matching-provider requirement as {@link useStore}.\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"]}