@hurum/react 0.0.1

package/dist/index.cjs

@@ -0,0 +1,149 @@
+'use strict';
+
+var react = require('react');
+var core = require('@hurum/core');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/use-store.ts
+var IS_DEV = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" && globalThis.process?.env?.["NODE_ENV"] !== "production";
+var singletonMap = /* @__PURE__ */ new WeakMap();
+var contextMap = /* @__PURE__ */ new WeakMap();
+var NULL_CONTEXT = react.createContext(null);
+function getSingleton(def) {
+  let instance = singletonMap.get(def);
+  if (!instance) {
+    if (IS_DEV && typeof window === "undefined") {
+      console.warn(
+        "[hurum/react] Singleton accessed on the server. Use Provider + Store.create() for SSR."
+      );
+    }
+    instance = def.create();
+    singletonMap.set(def, instance);
+  }
+  return instance;
+}
+function getContext(def) {
+  let ctx = contextMap.get(def);
+  if (!ctx) {
+    ctx = react.createContext(null);
+    contextMap.set(def, ctx);
+  }
+  return ctx;
+}
+function createFieldHook(getStore, fieldName) {
+  return function useField() {
+    const store = getStore();
+    const subscribe = react.useCallback(
+      (onStoreChange) => store.subscribe(onStoreChange),
+      [store]
+    );
+    const getSnapshot = react.useCallback(
+      () => store.getState()[fieldName],
+      [store]
+    );
+    return react.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  };
+}
+function createUseProxy(getStore) {
+  const hookCache = /* @__PURE__ */ new Map();
+  return new Proxy({}, {
+    get(_target, prop) {
+      if (typeof prop !== "string") return void 0;
+      let hook = hookCache.get(prop);
+      if (!hook) {
+        hook = createFieldHook(getStore, prop);
+        hookCache.set(prop, hook);
+      }
+      return hook;
+    }
+  });
+}
+function useSelectorHook(store, fnOrSelector) {
+  if (core.isSelector(fnOrSelector)) {
+    return useSelectorFromObject(fnOrSelector);
+  }
+  return useSelectorFromFn(store, fnOrSelector);
+}
+function useSelectorFromObject(selector) {
+  const subscribe = react.useCallback(
+    (onStoreChange) => selector.subscribe(() => onStoreChange()),
+    [selector]
+  );
+  return react.useSyncExternalStore(subscribe, selector.get, selector.get);
+}
+function useSelectorFromFn(store, selectorFn) {
+  const fnRef = react.useRef(selectorFn);
+  fnRef.current = selectorFn;
+  const lastRef = react.useRef({ value: void 0, initialized: false });
+  const subscribe = react.useCallback(
+    (onStoreChange) => store.subscribe(onStoreChange),
+    [store]
+  );
+  const getSnapshot = react.useCallback(() => {
+    const state = store.getState();
+    const next = fnRef.current(state);
+    if (lastRef.current.initialized && core.structuralEqual(lastRef.current.value, next)) {
+      return lastRef.current.value;
+    }
+    lastRef.current = { value: next, initialized: true };
+    return next;
+  }, [store]);
+  return react.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+
+// src/use-store.ts
+function useStore(defOrInstance) {
+  const isDef = core.isStoreDefinition(defOrInstance);
+  const ctx = react.useContext(isDef ? getContext(defOrInstance) : NULL_CONTEXT);
+  const store = isDef ? ctx ?? getSingleton(defOrInstance) : defOrInstance;
+  return useStoreHandle(store);
+}
+function useStoreHandle(store) {
+  const handle = react.useMemo(() => {
+    const useProxy = createUseProxy(
+      () => store
+    );
+    return {
+      use: useProxy,
+      useSelector: (fnOrSelector) => {
+        return useSelectorHook(store, fnOrSelector);
+      },
+      // Use store.send directly — it's already a Proxy with intent shortcuts.
+      // Don't use .bind() which would create a plain function losing the Proxy.
+      send: store.send,
+      cancel: store.cancel.bind(store),
+      cancelAll: store.cancelAll.bind(store),
+      getState: store.getState.bind(store),
+      subscribe: store.subscribe.bind(store),
+      dispose: store.dispose.bind(store),
+      scope: store.scope
+    };
+  }, [store]);
+  return handle;
+}
+function StoreProvider(props) {
+  const { of: def, children } = props;
+  const Context = getContext(def);
+  const externalStore = props.store;
+  const [autoStore] = react.useState(() => {
+    if (externalStore) return null;
+    return def.create(props);
+  });
+  const instance = externalStore ?? autoStore;
+  return /* @__PURE__ */ jsxRuntime.jsx(Context.Provider, { value: instance, children });
+}
+function withProvider(def, WrappedComponent) {
+  const Context = getContext(def);
+  function WithProvider(props) {
+    const [store] = react.useState(() => def.create());
+    return /* @__PURE__ */ jsxRuntime.jsx(Context.Provider, { value: store, children: /* @__PURE__ */ jsxRuntime.jsx(WrappedComponent, { ...props }) });
+  }
+  WithProvider.displayName = `withProvider(${WrappedComponent.displayName ?? WrappedComponent.name ?? "Component"})`;
+  return WithProvider;
+}
+
+exports.StoreProvider = StoreProvider;
+exports.useStore = useStore;
+exports.withProvider = withProvider;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/singleton.ts","../src/hooks.ts","../src/use-selector.ts","../src/use-store.ts","../src/store-provider.tsx","../src/with-provider.tsx"],"names":["createContext","useCallback","useSyncExternalStore","isSelector","useRef","structuralEqual","isStoreDefinition","useContext","useMemo","useState","jsx"],"mappings":"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","file":"index.cjs","sourcesContent":["// @hurum/react — Singleton management\n// Manages per-StoreDefinition singleton instances and React contexts\n\nimport { createContext } from 'react'\nimport type { StoreDefinition, StoreInstance } from '@hurum/core'\n\nconst IS_DEV = typeof globalThis !== 'undefined'\n  && typeof (globalThis as { process?: { env?: Record<string, string> } }).process !== 'undefined'\n  && (globalThis as { process?: { env?: Record<string, string> } }).process?.env?.['NODE_ENV'] !== 'production'\n\n// WeakMaps keyed by StoreDefinition for per-store metadata\nconst singletonMap = new WeakMap<StoreDefinition, StoreInstance>()\nconst contextMap = new WeakMap<StoreDefinition, React.Context<StoreInstance | null>>()\n\n/** Stable context that always returns null — used when useStore receives an instance directly */\nexport const NULL_CONTEXT = createContext<StoreInstance | null>(null)\n\n/**\n * Get or create the singleton instance for a StoreDefinition.\n * Warns in dev mode if called on the server.\n */\nexport function getSingleton(def: StoreDefinition): StoreInstance {\n  let instance = singletonMap.get(def)\n  if (!instance) {\n    if (IS_DEV && typeof window === 'undefined') {\n      console.warn(\n        '[hurum/react] Singleton accessed on the server. Use Provider + Store.create() for SSR.',\n      )\n    }\n    instance = def.create()\n    singletonMap.set(def, instance)\n  }\n  return instance\n}\n\n/**\n * Get or create the React Context for a StoreDefinition.\n * Each StoreDefinition gets its own Context.\n */\nexport function getContext(def: StoreDefinition): React.Context<StoreInstance | null> {\n  let ctx = contextMap.get(def)\n  if (!ctx) {\n    ctx = createContext<StoreInstance | null>(null)\n    contextMap.set(def, ctx)\n  }\n  return ctx\n}\n","// @hurum/react — Core hooks using useSyncExternalStore\n\nimport { useCallback, useSyncExternalStore } from 'react'\nimport type { StoreInstance } from '@hurum/core'\n\n/**\n * Create a `use.fieldName()` hook for a specific field on a specific store instance.\n * Uses `useSyncExternalStore` internally.\n */\nfunction createFieldHook(getStore: () => StoreInstance, fieldName: string) {\n  return function useField() {\n    const store = getStore()\n    const subscribe = useCallback(\n      (onStoreChange: () => void) => store.subscribe(onStoreChange),\n      [store],\n    )\n    const getSnapshot = useCallback(\n      () => (store.getState() as Record<string, unknown>)[fieldName],\n      [store],\n    )\n    // getServerSnapshot returns the same snapshot — the store instance\n    // is already initialized with correct state on the server via Store.create()\n    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n  }\n}\n\n/**\n * Create the `use.*` proxy for a store.\n * Accessing `use.fieldName` returns a hook that reads that field.\n */\nexport function createUseProxy(getStore: () => StoreInstance): Record<string, () => unknown> {\n  const hookCache = new Map<string, () => unknown>()\n  return new Proxy({} as Record<string, () => unknown>, {\n    get(_target, prop) {\n      if (typeof prop !== 'string') return undefined\n      let hook = hookCache.get(prop)\n      if (!hook) {\n        hook = createFieldHook(getStore, prop)\n        hookCache.set(prop, hook)\n      }\n      return hook\n    },\n  })\n}\n","// @hurum/react — useSelector hook\n\nimport { useCallback, useRef, useSyncExternalStore } from 'react'\nimport type { StoreInstance, ResolvedState, Selector } from '@hurum/core'\nimport { isSelector, structuralEqual } from '@hurum/core'\n\n/**\n * React hook for derived state from a store.\n *\n * Accepts either:\n * - An inline selector function: `(state) => derivedValue`\n * - A pre-built Selector object from `store.selector(fn)`\n *\n * Uses structural equality to prevent unnecessary re-renders.\n */\nexport function useSelectorHook<TRawState, TComputed, T>(\n  store: StoreInstance<unknown, TRawState, TComputed>,\n  fnOrSelector: ((state: ResolvedState<TRawState> & TComputed) => T) | Selector<T>,\n): T {\n  if (isSelector(fnOrSelector)) {\n    return useSelectorFromObject(fnOrSelector)\n  }\n  return useSelectorFromFn(store, fnOrSelector)\n}\n\nfunction useSelectorFromObject<T>(selector: Selector<T>): T {\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => selector.subscribe(() => onStoreChange()),\n    [selector],\n  )\n  return useSyncExternalStore(subscribe, selector.get, selector.get)\n}\n\nfunction useSelectorFromFn<TRawState, TComputed, T>(\n  store: StoreInstance<unknown, TRawState, TComputed>,\n  selectorFn: (state: ResolvedState<TRawState> & TComputed) => T,\n): T {\n  // Ref for latest selector fn — keeps subscribe/getSnapshot stable\n  const fnRef = useRef(selectorFn)\n  fnRef.current = selectorFn\n\n  // Ref for structural equality memoization\n  const lastRef = useRef<{ value: T; initialized: boolean }>({ value: undefined as T, initialized: false })\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => store.subscribe(onStoreChange),\n    [store],\n  )\n\n  const getSnapshot = useCallback((): T => {\n    const state = store.getState()\n    const next = fnRef.current(state)\n\n    if (lastRef.current.initialized && structuralEqual(lastRef.current.value, next)) {\n      return lastRef.current.value\n    }\n\n    lastRef.current = { value: next, initialized: true }\n    return next\n  }, [store])\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n}\n","// @hurum/react — useStore hook\n\nimport { useContext, useMemo } from 'react'\nimport type { StoreDefinition, StoreInstance, IntentRef, ResolvedState, ScopeOf, SendFn, Selector } from '@hurum/core'\nimport { isStoreDefinition } from '@hurum/core'\nimport type { EventInstance } from '@hurum/core'\nimport { getContext, getSingleton, NULL_CONTEXT } from './singleton'\nimport { createUseProxy } from './hooks'\nimport { useSelectorHook } from './use-selector'\n\n/**\n * The object returned by useStore(). Provides:\n * - `.use.fieldName()` hooks for reading individual fields\n * - `.useSelector(fn)` for derived state with structural equality\n * - `.send()` for dispatching intents (supports PreparedIntent + named shortcuts)\n * - `.cancel()` / `.cancelAll()` for cancellation\n * - `.subscribe()` for event subscriptions\n * - `.scope` for nested store access\n * - `.getState()` for reading full state\n * - `.dispose()` for cleanup\n */\nexport interface UseStoreReturn<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {\n  readonly use: {\n    readonly [K in keyof (ResolvedState<TRawState> & TComputed)]: () => (ResolvedState<TRawState> & TComputed)[K]\n  }\n  /** Derived state hook with structural equality memoization. */\n  useSelector<T>(fn: (state: ResolvedState<TRawState> & TComputed) => T): T\n  useSelector<T>(selector: Selector<T>): T\n  send: SendFn<TIntents>\n  cancel(ref: IntentRef): void\n  cancelAll(): void\n  getState(): ResolvedState<TRawState> & TComputed\n  subscribe(cb: (state: ResolvedState<TRawState> & TComputed) => void): () => void\n  subscribe(type: 'events', cb: (event: EventInstance) => void): () => void\n  dispose(): void\n  readonly scope: ScopeOf<TRawState>\n}\n\n/**\n * Context-aware hook to get a store handle.\n *\n * Accepts either a StoreDefinition or a StoreInstance:\n * - `useStore(def)` — Inside Provider → scoped instance. Outside → singleton fallback.\n * - `useStore(instance)` — Uses the given instance directly.\n *\n * The returned object has `.use.fieldName()` hooks for granular subscriptions.\n */\nexport function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  def: StoreDefinition<TDeps, TRawState, TComputed, TIntents>,\n): UseStoreReturn<TRawState, TComputed, TIntents>\nexport function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  instance: StoreInstance<TDeps, TRawState, TComputed, TIntents>,\n): UseStoreReturn<TRawState, TComputed, TIntents>\nexport function useStore(\n  defOrInstance: StoreDefinition | StoreInstance,\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseStoreReturn<any, any, any> {\n  const isDef = isStoreDefinition(defOrInstance)\n  // Always call useContext unconditionally (hooks rules). NULL_CONTEXT when receiving instance.\n  const ctx = useContext(isDef ? getContext(defOrInstance as StoreDefinition) : NULL_CONTEXT)\n  const store = isDef\n    ? (ctx ?? getSingleton(defOrInstance as StoreDefinition))\n    : (defOrInstance as StoreInstance)\n  return useStoreHandle(store)\n}\n\nfunction useStoreHandle<TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  store: StoreInstance<unknown, TRawState, TComputed, TIntents>,\n): UseStoreReturn<TRawState, TComputed, TIntents> {\n  const handle = useMemo(() => {\n    const useProxy = createUseProxy(\n      () => store,\n    )\n    return {\n      use: useProxy as UseStoreReturn<TRawState, TComputed, TIntents>['use'],\n      useSelector: <T>(fnOrSelector: ((state: ResolvedState<TRawState> & TComputed) => T) | Selector<T>): T => {\n        return useSelectorHook(store, fnOrSelector)\n      },\n      // Use store.send directly — it's already a Proxy with intent shortcuts.\n      // Don't use .bind() which would create a plain function losing the Proxy.\n      send: store.send as SendFn<TIntents>,\n      cancel: store.cancel.bind(store),\n      cancelAll: store.cancelAll.bind(store),\n      getState: store.getState.bind(store) as () => ResolvedState<TRawState> & TComputed,\n      subscribe: store.subscribe.bind(store) as UseStoreReturn<TRawState, TComputed, TIntents>['subscribe'],\n      dispose: store.dispose.bind(store),\n      scope: store.scope as ScopeOf<TRawState>,\n    }\n  }, [store])\n\n  return handle\n}\n","// @hurum/react — StoreProvider component\n\nimport { useState, type ReactNode } from 'react'\nimport type { StoreDefinition, StoreInstance } from '@hurum/core'\nimport { getContext } from './singleton'\n\nexport type StoreProviderProps =\n  | {\n      of: StoreDefinition\n      store: StoreInstance\n      children: ReactNode\n    }\n  | {\n      of: StoreDefinition\n      store?: undefined\n      initialState?: unknown\n      deps?: unknown\n      children: ReactNode\n    }\n\n/**\n * Provides a scoped store instance to descendant components.\n *\n * Two modes:\n * - `<StoreProvider of={Def} store={instance}>` — uses the given instance\n * - `<StoreProvider of={Def}>` — auto-creates a new instance (with optional initialState/deps)\n *\n * Does NOT auto-dispose on unmount (React Strict Mode compatible).\n */\nexport function StoreProvider(props: StoreProviderProps): ReactNode {\n  const { of: def, children } = props\n  const Context = getContext(def)\n  const externalStore = props.store\n\n  // Always call useState for hook order stability\n  const [autoStore] = useState(() => {\n    if (externalStore) return null\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return def.create(props as any)\n  })\n\n  const instance = externalStore ?? autoStore!\n\n  return <Context.Provider value={instance}>{children}</Context.Provider>\n}\n","// @hurum/react — withProvider HOC\n\nimport { useState, type ComponentType } from 'react'\nimport type { StoreDefinition } from '@hurum/core'\nimport { getContext } from './singleton'\n\n/**\n * HOC that wraps a component with a fresh store instance on each mount.\n * Useful for modals, wizards, and other isolated UI.\n */\nexport function withProvider<P extends object>(\n  def: StoreDefinition,\n  WrappedComponent: ComponentType<P>,\n): ComponentType<P> {\n  const Context = getContext(def)\n\n  function WithProvider(props: P) {\n    const [store] = useState(() => def.create())\n    return (\n      <Context.Provider value={store}>\n        <WrappedComponent {...props} />\n      </Context.Provider>\n    )\n  }\n\n  WithProvider.displayName = `withProvider(${WrappedComponent.displayName ?? WrappedComponent.name ?? 'Component'})`\n  return WithProvider\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,71 @@
+import { ResolvedState, Selector, SendFn, IntentRef, EventInstance, ScopeOf, StoreDefinition, StoreInstance } from '@hurum/core';
+import { ReactNode, ComponentType } from 'react';
+
+/**
+ * The object returned by useStore(). Provides:
+ * - `.use.fieldName()` hooks for reading individual fields
+ * - `.useSelector(fn)` for derived state with structural equality
+ * - `.send()` for dispatching intents (supports PreparedIntent + named shortcuts)
+ * - `.cancel()` / `.cancelAll()` for cancellation
+ * - `.subscribe()` for event subscriptions
+ * - `.scope` for nested store access
+ * - `.getState()` for reading full state
+ * - `.dispose()` for cleanup
+ */
+interface UseStoreReturn<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {
+    readonly use: {
+        readonly [K in keyof (ResolvedState<TRawState> & TComputed)]: () => (ResolvedState<TRawState> & TComputed)[K];
+    };
+    /** Derived state hook with structural equality memoization. */
+    useSelector<T>(fn: (state: ResolvedState<TRawState> & TComputed) => T): T;
+    useSelector<T>(selector: Selector<T>): T;
+    send: SendFn<TIntents>;
+    cancel(ref: IntentRef): void;
+    cancelAll(): void;
+    getState(): ResolvedState<TRawState> & TComputed;
+    subscribe(cb: (state: ResolvedState<TRawState> & TComputed) => void): () => void;
+    subscribe(type: 'events', cb: (event: EventInstance) => void): () => void;
+    dispose(): void;
+    readonly scope: ScopeOf<TRawState>;
+}
+/**
+ * Context-aware hook to get a store handle.
+ *
+ * Accepts either a StoreDefinition or a StoreInstance:
+ * - `useStore(def)` — Inside Provider → scoped instance. Outside → singleton fallback.
+ * - `useStore(instance)` — Uses the given instance directly.
+ *
+ * The returned object has `.use.fieldName()` hooks for granular subscriptions.
+ */
+declare function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(def: StoreDefinition<TDeps, TRawState, TComputed, TIntents>): UseStoreReturn<TRawState, TComputed, TIntents>;
+declare function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(instance: StoreInstance<TDeps, TRawState, TComputed, TIntents>): UseStoreReturn<TRawState, TComputed, TIntents>;
+
+type StoreProviderProps = {
+    of: StoreDefinition;
+    store: StoreInstance;
+    children: ReactNode;
+} | {
+    of: StoreDefinition;
+    store?: undefined;
+    initialState?: unknown;
+    deps?: unknown;
+    children: ReactNode;
+};
+/**
+ * Provides a scoped store instance to descendant components.
+ *
+ * Two modes:
+ * - `<StoreProvider of={Def} store={instance}>` — uses the given instance
+ * - `<StoreProvider of={Def}>` — auto-creates a new instance (with optional initialState/deps)
+ *
+ * Does NOT auto-dispose on unmount (React Strict Mode compatible).
+ */
+declare function StoreProvider(props: StoreProviderProps): ReactNode;
+
+/**
+ * HOC that wraps a component with a fresh store instance on each mount.
+ * Useful for modals, wizards, and other isolated UI.
+ */
+declare function withProvider<P extends object>(def: StoreDefinition, WrappedComponent: ComponentType<P>): ComponentType<P>;
+
+export { StoreProvider, type StoreProviderProps, type UseStoreReturn, useStore, withProvider };

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { ResolvedState, Selector, SendFn, IntentRef, EventInstance, ScopeOf, StoreDefinition, StoreInstance } from '@hurum/core';
+import { ReactNode, ComponentType } from 'react';
+
+/**
+ * The object returned by useStore(). Provides:
+ * - `.use.fieldName()` hooks for reading individual fields
+ * - `.useSelector(fn)` for derived state with structural equality
+ * - `.send()` for dispatching intents (supports PreparedIntent + named shortcuts)
+ * - `.cancel()` / `.cancelAll()` for cancellation
+ * - `.subscribe()` for event subscriptions
+ * - `.scope` for nested store access
+ * - `.getState()` for reading full state
+ * - `.dispose()` for cleanup
+ */
+interface UseStoreReturn<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {
+    readonly use: {
+        readonly [K in keyof (ResolvedState<TRawState> & TComputed)]: () => (ResolvedState<TRawState> & TComputed)[K];
+    };
+    /** Derived state hook with structural equality memoization. */
+    useSelector<T>(fn: (state: ResolvedState<TRawState> & TComputed) => T): T;
+    useSelector<T>(selector: Selector<T>): T;
+    send: SendFn<TIntents>;
+    cancel(ref: IntentRef): void;
+    cancelAll(): void;
+    getState(): ResolvedState<TRawState> & TComputed;
+    subscribe(cb: (state: ResolvedState<TRawState> & TComputed) => void): () => void;
+    subscribe(type: 'events', cb: (event: EventInstance) => void): () => void;
+    dispose(): void;
+    readonly scope: ScopeOf<TRawState>;
+}
+/**
+ * Context-aware hook to get a store handle.
+ *
+ * Accepts either a StoreDefinition or a StoreInstance:
+ * - `useStore(def)` — Inside Provider → scoped instance. Outside → singleton fallback.
+ * - `useStore(instance)` — Uses the given instance directly.
+ *
+ * The returned object has `.use.fieldName()` hooks for granular subscriptions.
+ */
+declare function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(def: StoreDefinition<TDeps, TRawState, TComputed, TIntents>): UseStoreReturn<TRawState, TComputed, TIntents>;
+declare function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(instance: StoreInstance<TDeps, TRawState, TComputed, TIntents>): UseStoreReturn<TRawState, TComputed, TIntents>;
+
+type StoreProviderProps = {
+    of: StoreDefinition;
+    store: StoreInstance;
+    children: ReactNode;
+} | {
+    of: StoreDefinition;
+    store?: undefined;
+    initialState?: unknown;
+    deps?: unknown;
+    children: ReactNode;
+};
+/**
+ * Provides a scoped store instance to descendant components.
+ *
+ * Two modes:
+ * - `<StoreProvider of={Def} store={instance}>` — uses the given instance
+ * - `<StoreProvider of={Def}>` — auto-creates a new instance (with optional initialState/deps)
+ *
+ * Does NOT auto-dispose on unmount (React Strict Mode compatible).
+ */
+declare function StoreProvider(props: StoreProviderProps): ReactNode;
+
+/**
+ * HOC that wraps a component with a fresh store instance on each mount.
+ * Useful for modals, wizards, and other isolated UI.
+ */
+declare function withProvider<P extends object>(def: StoreDefinition, WrappedComponent: ComponentType<P>): ComponentType<P>;
+
+export { StoreProvider, type StoreProviderProps, type UseStoreReturn, useStore, withProvider };

package/dist/index.js

@@ -0,0 +1,145 @@
+import { createContext, useContext, useMemo, useState, useCallback, useSyncExternalStore, useRef } from 'react';
+import { isStoreDefinition, isSelector, structuralEqual } from '@hurum/core';
+import { jsx } from 'react/jsx-runtime';
+
+// src/use-store.ts
+var IS_DEV = typeof globalThis !== "undefined" && typeof globalThis.process !== "undefined" && globalThis.process?.env?.["NODE_ENV"] !== "production";
+var singletonMap = /* @__PURE__ */ new WeakMap();
+var contextMap = /* @__PURE__ */ new WeakMap();
+var NULL_CONTEXT = createContext(null);
+function getSingleton(def) {
+  let instance = singletonMap.get(def);
+  if (!instance) {
+    if (IS_DEV && typeof window === "undefined") {
+      console.warn(
+        "[hurum/react] Singleton accessed on the server. Use Provider + Store.create() for SSR."
+      );
+    }
+    instance = def.create();
+    singletonMap.set(def, instance);
+  }
+  return instance;
+}
+function getContext(def) {
+  let ctx = contextMap.get(def);
+  if (!ctx) {
+    ctx = createContext(null);
+    contextMap.set(def, ctx);
+  }
+  return ctx;
+}
+function createFieldHook(getStore, fieldName) {
+  return function useField() {
+    const store = getStore();
+    const subscribe = useCallback(
+      (onStoreChange) => store.subscribe(onStoreChange),
+      [store]
+    );
+    const getSnapshot = useCallback(
+      () => store.getState()[fieldName],
+      [store]
+    );
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  };
+}
+function createUseProxy(getStore) {
+  const hookCache = /* @__PURE__ */ new Map();
+  return new Proxy({}, {
+    get(_target, prop) {
+      if (typeof prop !== "string") return void 0;
+      let hook = hookCache.get(prop);
+      if (!hook) {
+        hook = createFieldHook(getStore, prop);
+        hookCache.set(prop, hook);
+      }
+      return hook;
+    }
+  });
+}
+function useSelectorHook(store, fnOrSelector) {
+  if (isSelector(fnOrSelector)) {
+    return useSelectorFromObject(fnOrSelector);
+  }
+  return useSelectorFromFn(store, fnOrSelector);
+}
+function useSelectorFromObject(selector) {
+  const subscribe = useCallback(
+    (onStoreChange) => selector.subscribe(() => onStoreChange()),
+    [selector]
+  );
+  return useSyncExternalStore(subscribe, selector.get, selector.get);
+}
+function useSelectorFromFn(store, selectorFn) {
+  const fnRef = useRef(selectorFn);
+  fnRef.current = selectorFn;
+  const lastRef = useRef({ value: void 0, initialized: false });
+  const subscribe = useCallback(
+    (onStoreChange) => store.subscribe(onStoreChange),
+    [store]
+  );
+  const getSnapshot = useCallback(() => {
+    const state = store.getState();
+    const next = fnRef.current(state);
+    if (lastRef.current.initialized && structuralEqual(lastRef.current.value, next)) {
+      return lastRef.current.value;
+    }
+    lastRef.current = { value: next, initialized: true };
+    return next;
+  }, [store]);
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+
+// src/use-store.ts
+function useStore(defOrInstance) {
+  const isDef = isStoreDefinition(defOrInstance);
+  const ctx = useContext(isDef ? getContext(defOrInstance) : NULL_CONTEXT);
+  const store = isDef ? ctx ?? getSingleton(defOrInstance) : defOrInstance;
+  return useStoreHandle(store);
+}
+function useStoreHandle(store) {
+  const handle = useMemo(() => {
+    const useProxy = createUseProxy(
+      () => store
+    );
+    return {
+      use: useProxy,
+      useSelector: (fnOrSelector) => {
+        return useSelectorHook(store, fnOrSelector);
+      },
+      // Use store.send directly — it's already a Proxy with intent shortcuts.
+      // Don't use .bind() which would create a plain function losing the Proxy.
+      send: store.send,
+      cancel: store.cancel.bind(store),
+      cancelAll: store.cancelAll.bind(store),
+      getState: store.getState.bind(store),
+      subscribe: store.subscribe.bind(store),
+      dispose: store.dispose.bind(store),
+      scope: store.scope
+    };
+  }, [store]);
+  return handle;
+}
+function StoreProvider(props) {
+  const { of: def, children } = props;
+  const Context = getContext(def);
+  const externalStore = props.store;
+  const [autoStore] = useState(() => {
+    if (externalStore) return null;
+    return def.create(props);
+  });
+  const instance = externalStore ?? autoStore;
+  return /* @__PURE__ */ jsx(Context.Provider, { value: instance, children });
+}
+function withProvider(def, WrappedComponent) {
+  const Context = getContext(def);
+  function WithProvider(props) {
+    const [store] = useState(() => def.create());
+    return /* @__PURE__ */ jsx(Context.Provider, { value: store, children: /* @__PURE__ */ jsx(WrappedComponent, { ...props }) });
+  }
+  WithProvider.displayName = `withProvider(${WrappedComponent.displayName ?? WrappedComponent.name ?? "Component"})`;
+  return WithProvider;
+}
+
+export { StoreProvider, useStore, withProvider };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/singleton.ts","../src/hooks.ts","../src/use-selector.ts","../src/use-store.ts","../src/store-provider.tsx","../src/with-provider.tsx"],"names":["useCallback","useSyncExternalStore","useState","jsx"],"mappings":"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","file":"index.js","sourcesContent":["// @hurum/react — Singleton management\n// Manages per-StoreDefinition singleton instances and React contexts\n\nimport { createContext } from 'react'\nimport type { StoreDefinition, StoreInstance } from '@hurum/core'\n\nconst IS_DEV = typeof globalThis !== 'undefined'\n  && typeof (globalThis as { process?: { env?: Record<string, string> } }).process !== 'undefined'\n  && (globalThis as { process?: { env?: Record<string, string> } }).process?.env?.['NODE_ENV'] !== 'production'\n\n// WeakMaps keyed by StoreDefinition for per-store metadata\nconst singletonMap = new WeakMap<StoreDefinition, StoreInstance>()\nconst contextMap = new WeakMap<StoreDefinition, React.Context<StoreInstance | null>>()\n\n/** Stable context that always returns null — used when useStore receives an instance directly */\nexport const NULL_CONTEXT = createContext<StoreInstance | null>(null)\n\n/**\n * Get or create the singleton instance for a StoreDefinition.\n * Warns in dev mode if called on the server.\n */\nexport function getSingleton(def: StoreDefinition): StoreInstance {\n  let instance = singletonMap.get(def)\n  if (!instance) {\n    if (IS_DEV && typeof window === 'undefined') {\n      console.warn(\n        '[hurum/react] Singleton accessed on the server. Use Provider + Store.create() for SSR.',\n      )\n    }\n    instance = def.create()\n    singletonMap.set(def, instance)\n  }\n  return instance\n}\n\n/**\n * Get or create the React Context for a StoreDefinition.\n * Each StoreDefinition gets its own Context.\n */\nexport function getContext(def: StoreDefinition): React.Context<StoreInstance | null> {\n  let ctx = contextMap.get(def)\n  if (!ctx) {\n    ctx = createContext<StoreInstance | null>(null)\n    contextMap.set(def, ctx)\n  }\n  return ctx\n}\n","// @hurum/react — Core hooks using useSyncExternalStore\n\nimport { useCallback, useSyncExternalStore } from 'react'\nimport type { StoreInstance } from '@hurum/core'\n\n/**\n * Create a `use.fieldName()` hook for a specific field on a specific store instance.\n * Uses `useSyncExternalStore` internally.\n */\nfunction createFieldHook(getStore: () => StoreInstance, fieldName: string) {\n  return function useField() {\n    const store = getStore()\n    const subscribe = useCallback(\n      (onStoreChange: () => void) => store.subscribe(onStoreChange),\n      [store],\n    )\n    const getSnapshot = useCallback(\n      () => (store.getState() as Record<string, unknown>)[fieldName],\n      [store],\n    )\n    // getServerSnapshot returns the same snapshot — the store instance\n    // is already initialized with correct state on the server via Store.create()\n    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n  }\n}\n\n/**\n * Create the `use.*` proxy for a store.\n * Accessing `use.fieldName` returns a hook that reads that field.\n */\nexport function createUseProxy(getStore: () => StoreInstance): Record<string, () => unknown> {\n  const hookCache = new Map<string, () => unknown>()\n  return new Proxy({} as Record<string, () => unknown>, {\n    get(_target, prop) {\n      if (typeof prop !== 'string') return undefined\n      let hook = hookCache.get(prop)\n      if (!hook) {\n        hook = createFieldHook(getStore, prop)\n        hookCache.set(prop, hook)\n      }\n      return hook\n    },\n  })\n}\n","// @hurum/react — useSelector hook\n\nimport { useCallback, useRef, useSyncExternalStore } from 'react'\nimport type { StoreInstance, ResolvedState, Selector } from '@hurum/core'\nimport { isSelector, structuralEqual } from '@hurum/core'\n\n/**\n * React hook for derived state from a store.\n *\n * Accepts either:\n * - An inline selector function: `(state) => derivedValue`\n * - A pre-built Selector object from `store.selector(fn)`\n *\n * Uses structural equality to prevent unnecessary re-renders.\n */\nexport function useSelectorHook<TRawState, TComputed, T>(\n  store: StoreInstance<unknown, TRawState, TComputed>,\n  fnOrSelector: ((state: ResolvedState<TRawState> & TComputed) => T) | Selector<T>,\n): T {\n  if (isSelector(fnOrSelector)) {\n    return useSelectorFromObject(fnOrSelector)\n  }\n  return useSelectorFromFn(store, fnOrSelector)\n}\n\nfunction useSelectorFromObject<T>(selector: Selector<T>): T {\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => selector.subscribe(() => onStoreChange()),\n    [selector],\n  )\n  return useSyncExternalStore(subscribe, selector.get, selector.get)\n}\n\nfunction useSelectorFromFn<TRawState, TComputed, T>(\n  store: StoreInstance<unknown, TRawState, TComputed>,\n  selectorFn: (state: ResolvedState<TRawState> & TComputed) => T,\n): T {\n  // Ref for latest selector fn — keeps subscribe/getSnapshot stable\n  const fnRef = useRef(selectorFn)\n  fnRef.current = selectorFn\n\n  // Ref for structural equality memoization\n  const lastRef = useRef<{ value: T; initialized: boolean }>({ value: undefined as T, initialized: false })\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => store.subscribe(onStoreChange),\n    [store],\n  )\n\n  const getSnapshot = useCallback((): T => {\n    const state = store.getState()\n    const next = fnRef.current(state)\n\n    if (lastRef.current.initialized && structuralEqual(lastRef.current.value, next)) {\n      return lastRef.current.value\n    }\n\n    lastRef.current = { value: next, initialized: true }\n    return next\n  }, [store])\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n}\n","// @hurum/react — useStore hook\n\nimport { useContext, useMemo } from 'react'\nimport type { StoreDefinition, StoreInstance, IntentRef, ResolvedState, ScopeOf, SendFn, Selector } from '@hurum/core'\nimport { isStoreDefinition } from '@hurum/core'\nimport type { EventInstance } from '@hurum/core'\nimport { getContext, getSingleton, NULL_CONTEXT } from './singleton'\nimport { createUseProxy } from './hooks'\nimport { useSelectorHook } from './use-selector'\n\n/**\n * The object returned by useStore(). Provides:\n * - `.use.fieldName()` hooks for reading individual fields\n * - `.useSelector(fn)` for derived state with structural equality\n * - `.send()` for dispatching intents (supports PreparedIntent + named shortcuts)\n * - `.cancel()` / `.cancelAll()` for cancellation\n * - `.subscribe()` for event subscriptions\n * - `.scope` for nested store access\n * - `.getState()` for reading full state\n * - `.dispose()` for cleanup\n */\nexport interface UseStoreReturn<TRawState = unknown, TComputed = unknown, TIntents extends Record<string, unknown> = Record<string, never>> {\n  readonly use: {\n    readonly [K in keyof (ResolvedState<TRawState> & TComputed)]: () => (ResolvedState<TRawState> & TComputed)[K]\n  }\n  /** Derived state hook with structural equality memoization. */\n  useSelector<T>(fn: (state: ResolvedState<TRawState> & TComputed) => T): T\n  useSelector<T>(selector: Selector<T>): T\n  send: SendFn<TIntents>\n  cancel(ref: IntentRef): void\n  cancelAll(): void\n  getState(): ResolvedState<TRawState> & TComputed\n  subscribe(cb: (state: ResolvedState<TRawState> & TComputed) => void): () => void\n  subscribe(type: 'events', cb: (event: EventInstance) => void): () => void\n  dispose(): void\n  readonly scope: ScopeOf<TRawState>\n}\n\n/**\n * Context-aware hook to get a store handle.\n *\n * Accepts either a StoreDefinition or a StoreInstance:\n * - `useStore(def)` — Inside Provider → scoped instance. Outside → singleton fallback.\n * - `useStore(instance)` — Uses the given instance directly.\n *\n * The returned object has `.use.fieldName()` hooks for granular subscriptions.\n */\nexport function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  def: StoreDefinition<TDeps, TRawState, TComputed, TIntents>,\n): UseStoreReturn<TRawState, TComputed, TIntents>\nexport function useStore<TDeps, TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  instance: StoreInstance<TDeps, TRawState, TComputed, TIntents>,\n): UseStoreReturn<TRawState, TComputed, TIntents>\nexport function useStore(\n  defOrInstance: StoreDefinition | StoreInstance,\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\n): UseStoreReturn<any, any, any> {\n  const isDef = isStoreDefinition(defOrInstance)\n  // Always call useContext unconditionally (hooks rules). NULL_CONTEXT when receiving instance.\n  const ctx = useContext(isDef ? getContext(defOrInstance as StoreDefinition) : NULL_CONTEXT)\n  const store = isDef\n    ? (ctx ?? getSingleton(defOrInstance as StoreDefinition))\n    : (defOrInstance as StoreInstance)\n  return useStoreHandle(store)\n}\n\nfunction useStoreHandle<TRawState, TComputed, TIntents extends Record<string, unknown> = Record<string, never>>(\n  store: StoreInstance<unknown, TRawState, TComputed, TIntents>,\n): UseStoreReturn<TRawState, TComputed, TIntents> {\n  const handle = useMemo(() => {\n    const useProxy = createUseProxy(\n      () => store,\n    )\n    return {\n      use: useProxy as UseStoreReturn<TRawState, TComputed, TIntents>['use'],\n      useSelector: <T>(fnOrSelector: ((state: ResolvedState<TRawState> & TComputed) => T) | Selector<T>): T => {\n        return useSelectorHook(store, fnOrSelector)\n      },\n      // Use store.send directly — it's already a Proxy with intent shortcuts.\n      // Don't use .bind() which would create a plain function losing the Proxy.\n      send: store.send as SendFn<TIntents>,\n      cancel: store.cancel.bind(store),\n      cancelAll: store.cancelAll.bind(store),\n      getState: store.getState.bind(store) as () => ResolvedState<TRawState> & TComputed,\n      subscribe: store.subscribe.bind(store) as UseStoreReturn<TRawState, TComputed, TIntents>['subscribe'],\n      dispose: store.dispose.bind(store),\n      scope: store.scope as ScopeOf<TRawState>,\n    }\n  }, [store])\n\n  return handle\n}\n","// @hurum/react — StoreProvider component\n\nimport { useState, type ReactNode } from 'react'\nimport type { StoreDefinition, StoreInstance } from '@hurum/core'\nimport { getContext } from './singleton'\n\nexport type StoreProviderProps =\n  | {\n      of: StoreDefinition\n      store: StoreInstance\n      children: ReactNode\n    }\n  | {\n      of: StoreDefinition\n      store?: undefined\n      initialState?: unknown\n      deps?: unknown\n      children: ReactNode\n    }\n\n/**\n * Provides a scoped store instance to descendant components.\n *\n * Two modes:\n * - `<StoreProvider of={Def} store={instance}>` — uses the given instance\n * - `<StoreProvider of={Def}>` — auto-creates a new instance (with optional initialState/deps)\n *\n * Does NOT auto-dispose on unmount (React Strict Mode compatible).\n */\nexport function StoreProvider(props: StoreProviderProps): ReactNode {\n  const { of: def, children } = props\n  const Context = getContext(def)\n  const externalStore = props.store\n\n  // Always call useState for hook order stability\n  const [autoStore] = useState(() => {\n    if (externalStore) return null\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return def.create(props as any)\n  })\n\n  const instance = externalStore ?? autoStore!\n\n  return <Context.Provider value={instance}>{children}</Context.Provider>\n}\n","// @hurum/react — withProvider HOC\n\nimport { useState, type ComponentType } from 'react'\nimport type { StoreDefinition } from '@hurum/core'\nimport { getContext } from './singleton'\n\n/**\n * HOC that wraps a component with a fresh store instance on each mount.\n * Useful for modals, wizards, and other isolated UI.\n */\nexport function withProvider<P extends object>(\n  def: StoreDefinition,\n  WrappedComponent: ComponentType<P>,\n): ComponentType<P> {\n  const Context = getContext(def)\n\n  function WithProvider(props: P) {\n    const [store] = useState(() => def.create())\n    return (\n      <Context.Provider value={store}>\n        <WrappedComponent {...props} />\n      </Context.Provider>\n    )\n  }\n\n  WithProvider.displayName = `withProvider(${WrappedComponent.displayName ?? WrappedComponent.name ?? 'Component'})`\n  return WithProvider\n}\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@hurum/react",
+  "version": "0.0.1",
+  "description": "React bindings for @hurum/core — useStore, StoreProvider, withProvider",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "dependencies": {
+    "@hurum/core": "0.0.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.2.0",
+    "@types/react": "^19.0.8",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.4.0",
+    "vitest": "^3.0.5",
+    "typescript": "^5.7.3",
+    "jsdom": "^26.0.0"
+  },
+  "sideEffects": false,
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:typecheck": "vitest typecheck",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}