@wizzard-packages/react 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -54,16 +54,17 @@ declare function createWizardFactory<TSchema extends Record<string, any>, StepId
     useWizardContext: () => any;
     useWizardValue: <P extends Path<TSchema>>(path: P, options?: {
         isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;
-    }) => PathValue<TSchema, P>;
+    } | ((a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean)) => PathValue<TSchema, P>;
     useWizardField: <P extends Path<TSchema>>(path: P, options?: {
         isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;
-    }) => [PathValue<TSchema, P>, (value: PathValue<TSchema, P>) => void];
-    useWizardSelector: <TSelected>(selector: (state: IWizardContext$1<TSchema, StepId>) => TSelected, options?: {
+    } | ((a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean)) => [PathValue<TSchema, P>, (value: PathValue<TSchema, P>) => void];
+    useWizardSelector: <TSelected>(selector: (state: IWizardState<TSchema, StepId>) => TSelected, options?: {
         isEqual?: (a: TSelected, b: TSelected) => boolean;
-    }) => TSelected;
+    } | ((a: TSelected, b: TSelected) => boolean)) => TSelected;
+    useWizardShallowSelector: <TSelected>(selector: (state: IWizardState<TSchema, StepId>) => TSelected) => TSelected;
     useWizardError: <P extends Path<TSchema>>(path: P) => string | undefined;
     useWizardActions: () => IWizardActionsTyped<TSchema, StepId>;
-    useWizardState: () => _wizzard_packages_core.IWizardState<TSchema, StepId>;
+    useWizardState: () => IWizardState<TSchema, StepId>;
     useBreadcrumbs: () => _wizzard_packages_core.IBreadcrumb<StepId>[];
     createStep: (config: IStepConfig<TSchema, StepId>) => IStepConfig<TSchema, StepId>;
 };
@@ -90,7 +91,7 @@ declare function useWizardState<T = unknown, StepId extends string = string>():
  */
 declare function useWizardValue<TValue = any>(path: string, options?: {
     isEqual?: (a: TValue, b: TValue) => boolean;
-}): TValue;
+} | ((a: TValue, b: TValue) => boolean)): TValue;
 /**
  * Returns a value and setter for a path (useState-like API).
  */
@@ -106,7 +107,7 @@ declare function useWizardError(path: string): string | undefined;
  */
 declare function useWizardSelector<TSelected = any>(selector: (state: any) => TSelected, options?: {
     isEqual?: (a: TSelected, b: TSelected) => boolean;
-}): TSelected;
+} | ((a: TSelected, b: TSelected) => boolean)): TSelected;
 /**
  * Returns the wizard actions API.
  */
@@ -189,7 +190,7 @@ declare const useWizardStoreState: <T, StepId extends string = string>(store: IW
  */
 declare const useWizardStoreValue: <T, P extends Path<T>>(store: IWizardStore<T, any>, path: P, options?: {
     isEqual?: (a: PathValue<T, P>, b: PathValue<T, P>) => boolean;
-}) => PathValue<T, P>;
+} | ((a: PathValue<T, P>, b: PathValue<T, P>) => boolean)) => PathValue<T, P>;
 /**
  * Hook: value + setter for a path without React Context.
  */
@@ -205,7 +206,7 @@ declare const useWizardStoreError: (store: IWizardStore<any, any>, path: string)
  */
 declare const useWizardStoreSelector: <TSelected>(store: IWizardStore<any, any>, selector: (state: any) => TSelected, options?: {
     isEqual?: (a: TSelected, b: TSelected) => boolean;
-}) => TSelected;
+} | ((a: TSelected, b: TSelected) => boolean)) => TSelected;
 /**
  * Helper: build store-bound hooks for a single store instance.
  */

package/dist/index.d.ts

@@ -54,16 +54,17 @@ declare function createWizardFactory<TSchema extends Record<string, any>, StepId
     useWizardContext: () => any;
     useWizardValue: <P extends Path<TSchema>>(path: P, options?: {
         isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;
-    }) => PathValue<TSchema, P>;
+    } | ((a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean)) => PathValue<TSchema, P>;
     useWizardField: <P extends Path<TSchema>>(path: P, options?: {
         isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;
-    }) => [PathValue<TSchema, P>, (value: PathValue<TSchema, P>) => void];
-    useWizardSelector: <TSelected>(selector: (state: IWizardContext$1<TSchema, StepId>) => TSelected, options?: {
+    } | ((a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean)) => [PathValue<TSchema, P>, (value: PathValue<TSchema, P>) => void];
+    useWizardSelector: <TSelected>(selector: (state: IWizardState<TSchema, StepId>) => TSelected, options?: {
         isEqual?: (a: TSelected, b: TSelected) => boolean;
-    }) => TSelected;
+    } | ((a: TSelected, b: TSelected) => boolean)) => TSelected;
+    useWizardShallowSelector: <TSelected>(selector: (state: IWizardState<TSchema, StepId>) => TSelected) => TSelected;
     useWizardError: <P extends Path<TSchema>>(path: P) => string | undefined;
     useWizardActions: () => IWizardActionsTyped<TSchema, StepId>;
-    useWizardState: () => _wizzard_packages_core.IWizardState<TSchema, StepId>;
+    useWizardState: () => IWizardState<TSchema, StepId>;
     useBreadcrumbs: () => _wizzard_packages_core.IBreadcrumb<StepId>[];
     createStep: (config: IStepConfig<TSchema, StepId>) => IStepConfig<TSchema, StepId>;
 };
@@ -90,7 +91,7 @@ declare function useWizardState<T = unknown, StepId extends string = string>():
  */
 declare function useWizardValue<TValue = any>(path: string, options?: {
     isEqual?: (a: TValue, b: TValue) => boolean;
-}): TValue;
+} | ((a: TValue, b: TValue) => boolean)): TValue;
 /**
  * Returns a value and setter for a path (useState-like API).
  */
@@ -106,7 +107,7 @@ declare function useWizardError(path: string): string | undefined;
  */
 declare function useWizardSelector<TSelected = any>(selector: (state: any) => TSelected, options?: {
     isEqual?: (a: TSelected, b: TSelected) => boolean;
-}): TSelected;
+} | ((a: TSelected, b: TSelected) => boolean)): TSelected;
 /**
  * Returns the wizard actions API.
  */
@@ -189,7 +190,7 @@ declare const useWizardStoreState: <T, StepId extends string = string>(store: IW
  */
 declare const useWizardStoreValue: <T, P extends Path<T>>(store: IWizardStore<T, any>, path: P, options?: {
     isEqual?: (a: PathValue<T, P>, b: PathValue<T, P>) => boolean;
-}) => PathValue<T, P>;
+} | ((a: PathValue<T, P>, b: PathValue<T, P>) => boolean)) => PathValue<T, P>;
 /**
  * Hook: value + setter for a path without React Context.
  */
@@ -205,7 +206,7 @@ declare const useWizardStoreError: (store: IWizardStore<any, any>, path: string)
  */
 declare const useWizardStoreSelector: <TSelected>(store: IWizardStore<any, any>, selector: (state: any) => TSelected, options?: {
     isEqual?: (a: TSelected, b: TSelected) => boolean;
-}) => TSelected;
+} | ((a: TSelected, b: TSelected) => boolean)) => TSelected;
 /**
  * Helper: build store-bound hooks for a single store instance.
  */

package/dist/index.js

@@ -1,20 +1,25 @@
+// src/factory.tsx
+import {
+  shallowEqual as shallowEqual2
+} from "@wizzard-packages/core";
+
 // src/context/WizardContext.tsx
+import {
+  WizardStore,
+  getByPath as getByPath2,
+  setByPath as setByPath2
+} from "@wizzard-packages/core";
+import { MemoryAdapter } from "@wizzard-packages/persistence";
 import {
   createContext,
+  useCallback,
   useContext,
   useEffect,
   useMemo,
+  useRef,
   useState,
-  useCallback,
-  useSyncExternalStore,
-  useRef
+  useSyncExternalStore
 } from "react";
-import {
-  WizardStore,
-  getByPath as getByPath2,
-  setByPath as setByPath2
-} from "@wizzard-packages/core";
-import { MemoryAdapter } from "@wizzard-packages/persistence";
 
 // src/internal/dependencies.ts
 import {
@@ -510,22 +515,25 @@ function useWizardState() {
 function useWizardValue(path, options) {
   const store = useContext(WizardStoreContext);
   if (!store) throw new Error("useWizardValue must be used within a WizardProvider");
-  const lastStateRef = useRef(null);
+  const lastStateRef = useRef(UNSET);
   const lastValueRef = useRef(UNSET);
+  const isEqual = typeof options === "function" ? options : options?.isEqual;
+  const isEqualRef = useRef(isEqual);
+  isEqualRef.current = isEqual;
   const getSnapshot = useCallback(() => {
     const data = store.getSnapshot().data;
     if (data === lastStateRef.current && lastValueRef.current !== UNSET) {
       return lastValueRef.current;
     }
     const value = getByPath2(data, path);
-    if (lastValueRef.current !== UNSET && (options?.isEqual || Object.is)(lastValueRef.current, value)) {
+    if (lastValueRef.current !== UNSET && (isEqualRef.current || Object.is)(lastValueRef.current, value)) {
       lastStateRef.current = data;
       return lastValueRef.current;
     }
     lastStateRef.current = data;
     lastValueRef.current = value;
     return value;
-  }, [store, path, options?.isEqual]);
+  }, [store, path]);
   return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
 }
 function useWizardField(path, options) {
@@ -555,16 +563,27 @@ function useWizardError(path) {
 function useWizardSelector(selector, options) {
   const store = useContext(WizardStoreContext);
   if (!store) throw new Error("useWizardSelector must be used within a WizardProvider");
+  const selectorRef = useRef(selector);
+  selectorRef.current = selector;
+  const isEqual = typeof options === "function" ? options : options?.isEqual;
+  const isEqualRef = useRef(isEqual);
+  isEqualRef.current = isEqual;
+  const lastStateRef = useRef(UNSET);
   const lastResultRef = useRef(UNSET);
   const getSnapshot = useCallback(() => {
     const full = store.getSnapshot();
-    const res = selector(full);
-    if (lastResultRef.current !== UNSET && (options?.isEqual || Object.is)(lastResultRef.current, res)) {
+    if (full === lastStateRef.current && lastResultRef.current !== UNSET) {
+      return lastResultRef.current;
+    }
+    const res = selectorRef.current(full);
+    if (lastResultRef.current !== UNSET && (isEqualRef.current || Object.is)(lastResultRef.current, res)) {
+      lastStateRef.current = full;
       return lastResultRef.current;
     }
+    lastStateRef.current = full;
     lastResultRef.current = res;
     return res;
-  }, [store, selector, options?.isEqual]);
+  }, [store]);
   return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
 }
 function useWizardActions() {
@@ -678,6 +697,9 @@ function createWizardFactory() {
   const useWizardSelector2 = (selector, options) => {
     return useWizardSelector(selector, options);
   };
+  const useWizardShallowSelector = (selector) => {
+    return useWizardSelector2(selector, shallowEqual2);
+  };
   const useWizardError2 = (path) => {
     return useWizardError(path);
   };
@@ -698,6 +720,7 @@ function createWizardFactory() {
     useWizardValue: useWizardValue2,
     useWizardField: useWizardField2,
     useWizardSelector: useWizardSelector2,
+    useWizardShallowSelector,
     useWizardError: useWizardError2,
     useWizardActions: useWizardActions2,
     useWizardState: useWizardState2,
@@ -729,13 +752,13 @@ var WizardStepRenderer = ({
 };
 
 // src/store.ts
-import { useCallback as useCallback2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2 } from "react";
 import {
   WizardStore as WizardStore2,
   getByPath as getByPath3,
   setByPath as setByPath3
 } from "@wizzard-packages/core";
 import { MemoryAdapter as MemoryAdapter2 } from "@wizzard-packages/persistence";
+import { useCallback as useCallback2, useRef as useRef2, useSyncExternalStore as useSyncExternalStore2 } from "react";
 var UNSET2 = /* @__PURE__ */ Symbol("wizard_store_unset");
 var META_KEY = "__wizzard_meta__";
 var applyStoredMeta = (store, adapter) => {
@@ -1037,20 +1060,23 @@ var useWizardStoreState = (store) => {
 var useWizardStoreValue = (store, path, options) => {
   const lastStateRef = useRef2(UNSET2);
   const lastValueRef = useRef2(UNSET2);
+  const isEqual = typeof options === "function" ? options : options?.isEqual;
+  const isEqualRef = useRef2(isEqual);
+  isEqualRef.current = isEqual;
   const getSnapshot = useCallback2(() => {
     const data = store.getSnapshot().data;
     if (data === lastStateRef.current && lastValueRef.current !== UNSET2) {
       return lastValueRef.current;
     }
     const value = getByPath3(data, path);
-    if (lastValueRef.current !== UNSET2 && (options?.isEqual || Object.is)(lastValueRef.current, value)) {
+    if (lastValueRef.current !== UNSET2 && (isEqualRef.current || Object.is)(lastValueRef.current, value)) {
       lastStateRef.current = data;
       return lastValueRef.current;
     }
     lastStateRef.current = data;
     lastValueRef.current = value;
     return value;
-  }, [store, path, options?.isEqual]);
+  }, [store, path]);
   return useSyncExternalStore2(store.subscribe, getSnapshot, getSnapshot);
 };
 var useWizardStoreField = (store, setData, path, options) => {
@@ -1075,16 +1101,27 @@ var useWizardStoreError = (store, path) => {
   return useSyncExternalStore2(store.subscribe, getSnapshot, getSnapshot);
 };
 var useWizardStoreSelector = (store, selector, options) => {
+  const selectorRef = useRef2(selector);
+  selectorRef.current = selector;
+  const isEqual = typeof options === "function" ? options : options?.isEqual;
+  const isEqualRef = useRef2(isEqual);
+  isEqualRef.current = isEqual;
+  const lastStateRef = useRef2(UNSET2);
   const lastResultRef = useRef2(UNSET2);
   const getSnapshot = useCallback2(() => {
     const full = store.getSnapshot();
-    const res = selector(full);
-    if (lastResultRef.current !== UNSET2 && (options?.isEqual || Object.is)(lastResultRef.current, res)) {
+    if (full === lastStateRef.current && lastResultRef.current !== UNSET2) {
+      return lastResultRef.current;
+    }
+    const res = selectorRef.current(full);
+    if (lastResultRef.current !== UNSET2 && (isEqualRef.current || Object.is)(lastResultRef.current, res)) {
+      lastStateRef.current = full;
       return lastResultRef.current;
     }
+    lastStateRef.current = full;
     lastResultRef.current = res;
     return res;
-  }, [store, selector, options?.isEqual]);
+  }, [store]);
   return useSyncExternalStore2(store.subscribe, getSnapshot, getSnapshot);
 };
 var createWizardHooks = (store, actions) => ({