@wizzard-packages/react 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/context/WizardContext.tsx","../src/hooks/useWizard.ts","../src/factory.tsx","../src/components/WizardStepRenderer.tsx"],"sourcesContent":["export * from './factory';\nexport * from './context/WizardContext';\nexport * from './components/WizardStepRenderer';\nexport * from './hooks/useWizard';\nexport * from './types';\n\n// Re-export core for convenience and backward compatibility\nexport { WizardStore } from '@wizzard-packages/core';\nexport { loggerMiddleware } from '@wizzard-packages/middleware';\nexport type {\n  IWizardState,\n  IWizardActions,\n  IWizardContext,\n  IStepConfig,\n  IWizardConfig,\n  ValidationResult,\n  IValidatorAdapter,\n  PersistenceMode,\n  WizardMiddleware,\n} from '@wizzard-packages/core';\n","import React, {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  useCallback,\n  useSyncExternalStore,\n  useRef,\n} from 'react';\nimport {\n  type IWizardConfig,\n  type IPersistenceAdapter,\n  type IStepConfig,\n  type IWizardContext,\n  type IWizardState,\n  type IWizardActions,\n  type IWizardStore,\n  type WizardEventHandler,\n  type WizardEventName,\n  WizardStore,\n  getByPath,\n  setByPath,\n} from '@wizzard-packages/core';\nimport { MemoryAdapter } from '@wizzard-packages/persistence';\n\nconst WizardStateContext = createContext<IWizardState<any, any> | undefined>(undefined);\nconst WizardActionsContext = createContext<IWizardActions<any> | undefined>(undefined);\nconst WizardStoreContext = createContext<IWizardStore<any, any> | undefined>(undefined);\n\n/**\n * Props for WizardProvider.\n */\nexport interface WizardProviderProps<T, StepId extends string> {\n  config: IWizardConfig<T, StepId>;\n  initialData?: T;\n  initialStepId?: StepId;\n  children: React.ReactNode;\n}\n\n/**\n * Component that provides the wizard context to its children.\n */\nexport function WizardProvider<T extends Record<string, any>, StepId extends string = string>({\n  config,\n  initialData,\n  initialStepId,\n  children,\n}: WizardProviderProps<T, StepId>) {\n  const [localConfig, setLocalConfig] = useState<IWizardConfig<T, StepId>>(config);\n\n  const storeRef = useRef<IWizardStore<T, StepId>>(null as unknown as IWizardStore<T, StepId>);\n\n  if (!storeRef.current) {\n    storeRef.current = new WizardStore<T, StepId>((initialData || {}) as T, config.middlewares);\n  }\n\n  const isInitialized = useRef(false);\n\n  const persistenceAdapter = useMemo<IPersistenceAdapter>(() => {\n    return localConfig.persistence?.adapter || new MemoryAdapter();\n  }, [localConfig.persistence?.adapter]);\n\n  const persistenceMode = localConfig.persistence?.mode || 'onStepChange';\n  const META_KEY = '__wizzard_meta__';\n\n  const snapshot = useSyncExternalStore<IWizardState<T, StepId>>(\n    storeRef.current.subscribe,\n    storeRef.current.getSnapshot\n  );\n\n  const {\n    activeSteps,\n    currentStepId,\n    history,\n    visitedSteps,\n    completedSteps,\n    data,\n    errors: _errors,\n  } = snapshot;\n\n  const stepsMap = useMemo(() => {\n    const map = new Map<StepId, IStepConfig<T, StepId>>();\n    localConfig.steps.forEach((step: IStepConfig<T, StepId>) => map.set(step.id, step));\n    return map;\n  }, [localConfig.steps]);\n\n  useEffect(() => {\n    setLocalConfig(config);\n  }, [config]);\n\n  const activeStepsIndexMap = useMemo(() => {\n    const map = new Map<StepId, number>();\n    activeSteps.forEach((s: IStepConfig<T, StepId>, i: number) => map.set(s.id, i));\n    return map;\n  }, [activeSteps]);\n\n  const stateRef = useRef({\n    config: localConfig,\n    stepsMap,\n    activeSteps,\n    activeStepsIndexMap,\n    visitedSteps,\n    completedSteps,\n    persistenceMode,\n    persistenceAdapter,\n    currentStepId,\n    history,\n  });\n\n  const validationDebounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  useEffect(() => {\n    stateRef.current = {\n      config: localConfig,\n      stepsMap,\n      activeSteps,\n      activeStepsIndexMap,\n      visitedSteps,\n      completedSteps,\n      persistenceMode,\n      persistenceAdapter,\n      currentStepId,\n      history,\n    };\n  });\n\n  useEffect(() => {\n    return () => {\n      if (validationDebounceRef.current) {\n        clearTimeout(validationDebounceRef.current);\n      }\n    };\n  }, []);\n\n  const trackEvent = useCallback<WizardEventHandler<StepId>>(\n    (name: WizardEventName, payload: any) => {\n      localConfig.analytics?.onEvent(name as any, payload);\n    },\n    [localConfig.analytics]\n  );\n\n  const resolveActiveStepsHelper = useCallback(\n    (data: T) => storeRef.current.resolveActiveSteps(data),\n    []\n  );\n\n  const validateStep = useCallback((stepId: StepId) => storeRef.current.validateStep(stepId), []);\n\n  const goToStep = useCallback(\n    async (\n      stepId: StepId,\n      providedActiveSteps?: IStepConfig<T, StepId>[],\n      options: { validate?: boolean } = { validate: true }\n    ): Promise<boolean> => {\n      return storeRef.current.goToStep(stepId, {\n        validate: options.validate,\n        providedActiveSteps: providedActiveSteps as any,\n      });\n    },\n    []\n  );\n\n  const goToNextStep = useCallback(async () => {\n    const { currentStepId } = stateRef.current;\n    if (!currentStepId) return;\n\n    const currentData = storeRef.current.getSnapshot().data;\n    const step = stepsMap.get(currentStepId as StepId);\n\n    const shouldVal = step?.autoValidate ?? localConfig.autoValidate ?? !!step?.validationAdapter;\n\n    if (shouldVal) {\n      const ok = await validateStep(currentStepId as StepId);\n      if (!ok) return;\n    }\n\n    const resolvedSteps = await resolveActiveStepsHelper(currentData);\n    const idx = resolvedSteps.findIndex((s: IStepConfig<T, StepId>) => s.id === currentStepId);\n\n    if (idx !== -1 && idx < resolvedSteps.length - 1) {\n      const nextStepId = resolvedSteps[idx + 1].id;\n      const success = await goToStep(nextStepId as any, resolvedSteps as any, {\n        validate: false,\n      });\n      if (success) {\n        const currentSnapshot = storeRef.current.getSnapshot();\n        if (!currentSnapshot.errorSteps.has(currentStepId as StepId)) {\n          const nextComp = new Set(currentSnapshot.completedSteps);\n          nextComp.add(currentStepId as StepId);\n          storeRef.current.dispatch({\n            type: 'SET_COMPLETED_STEPS',\n            payload: { steps: nextComp },\n          });\n        }\n      }\n    }\n  }, [goToStep, resolveActiveStepsHelper, validateStep, stepsMap, localConfig]);\n\n  const goToPrevStep = useCallback(async () => {\n    const { currentStepId, activeSteps, activeStepsIndexMap } = stateRef.current;\n    const idx = activeStepsIndexMap.get(currentStepId as StepId) ?? -1;\n    if (idx > 0) await goToStep(activeSteps[idx - 1].id as any);\n  }, [goToStep]);\n\n  const handleStepDependencies = useCallback(\n    (paths: string[], initialData: any) => {\n      let currentData = { ...initialData };\n      const allClearedPaths = new Set<string>();\n      const { completedSteps, visitedSteps } = storeRef.current.getSnapshot();\n      const nextComp = new Set(completedSteps);\n      const nextVis = new Set(visitedSteps);\n      let statusChanged = false;\n\n      const processDependencies = (changedPaths: string[]) => {\n        const newlyClearedPaths: string[] = [];\n\n        localConfig.steps.forEach((step: IStepConfig<T, StepId>) => {\n          const isDependent = step.dependsOn?.some((p: string) =>\n            changedPaths.some(\n              (path) => path === p || p.startsWith(path + '.') || path.startsWith(p + '.')\n            )\n          );\n\n          if (isDependent) {\n            if (nextComp.delete(step.id as StepId)) {\n              statusChanged = true;\n            }\n            if (nextVis.delete(step.id as StepId)) {\n              statusChanged = true;\n            }\n\n            if (step.clearData) {\n              if (typeof step.clearData === 'function') {\n                const patch = step.clearData(currentData, changedPaths);\n                Object.keys(patch).forEach((key) => {\n                  if (currentData[key] !== patch[key]) {\n                    currentData[key] = patch[key];\n                    newlyClearedPaths.push(key);\n                    allClearedPaths.add(key);\n                  }\n                });\n              } else {\n                const pathsToClear = Array.isArray(step.clearData)\n                  ? step.clearData\n                  : [step.clearData];\n                pathsToClear.forEach((p: string) => {\n                  const val = getByPath(currentData, p);\n                  if (val !== undefined) {\n                    currentData = setByPath(currentData, p, undefined);\n                    newlyClearedPaths.push(p);\n                    allClearedPaths.add(p);\n                  }\n                });\n              }\n            }\n          }\n        });\n\n        if (newlyClearedPaths.length > 0) {\n          processDependencies(newlyClearedPaths);\n        }\n      };\n\n      processDependencies(paths);\n\n      if (statusChanged) {\n        storeRef.current.dispatch({\n          type: 'SET_COMPLETED_STEPS',\n          payload: { steps: nextComp },\n        });\n        storeRef.current.dispatch({\n          type: 'SET_VISITED_STEPS',\n          payload: { steps: nextVis },\n        });\n      }\n\n      return {\n        newData: currentData,\n        hasClearing: allClearedPaths.size > 0,\n        clearedPaths: Array.from(allClearedPaths),\n      };\n    },\n    [localConfig.steps]\n  );\n\n  const setData = useCallback(\n    (path: string, value: any, options?: { debounceValidation?: number }) => {\n      const { stepsMap, currentStepId } = stateRef.current;\n      const prevData = storeRef.current.getSnapshot().data;\n      if (getByPath(prevData, path) === value) return;\n\n      const baseData = setByPath(prevData, path, value);\n      const { newData, hasClearing } = handleStepDependencies([path], baseData);\n\n      if (!hasClearing) {\n        storeRef.current.dispatch({\n          type: 'SET_DATA',\n          payload: {\n            path,\n            value,\n            options: { ...options, __from_set_data__: true },\n          },\n        });\n      } else {\n        storeRef.current.dispatch({\n          type: 'UPDATE_DATA',\n          payload: {\n            data: newData,\n            options: { replace: true, __from_set_data__: true, path },\n          },\n        });\n      }\n\n      if (currentStepId) {\n        storeRef.current.deleteError(currentStepId as StepId, path);\n        const step = stepsMap.get(currentStepId as StepId);\n        const mode = step?.validationMode || localConfig.validationMode || 'onStepChange';\n\n        if (mode === 'onChange') {\n          const debounceMs =\n            options?.debounceValidation ?? localConfig.validationDebounceTime ?? 300;\n          if (validationDebounceRef.current) {\n            clearTimeout(validationDebounceRef.current);\n          }\n          validationDebounceRef.current = setTimeout(() => {\n            validateStep(currentStepId as StepId);\n          }, debounceMs);\n        }\n      }\n    },\n    [localConfig, validateStep, handleStepDependencies]\n  );\n\n  const updateData = useCallback(\n    (data: Partial<T>, options?: { replace?: boolean; persist?: boolean }) => {\n      const prev = storeRef.current.getSnapshot().data;\n      const baseData = (options?.replace ? (data as T) : { ...prev, ...data }) as T;\n\n      const { newData } = handleStepDependencies(Object.keys(data), baseData);\n\n      storeRef.current.update(newData as T, Object.keys(data));\n      if (options?.persist) {\n        if (storeRef.current.save) {\n          storeRef.current.save(storeRef.current.getSnapshot().currentStepId as StepId);\n        }\n      }\n    },\n    [handleStepDependencies]\n  );\n\n  const reset = useCallback(() => {\n    storeRef.current.setInitialData(initialData || ({} as T));\n    storeRef.current.update((initialData || {}) as T);\n    storeRef.current.updateErrors({} as Record<StepId, Record<string, string>>);\n    storeRef.current.dispatch({\n      type: 'SET_VISITED_STEPS',\n      payload: { steps: new Set() },\n    });\n    storeRef.current.dispatch({\n      type: 'SET_COMPLETED_STEPS',\n      payload: { steps: new Set() },\n    });\n    storeRef.current.dispatch({\n      type: 'SET_ERROR_STEPS',\n      payload: { steps: new Set() },\n    });\n    if (activeSteps.length > 0) {\n      const startId = activeSteps[0].id;\n      storeRef.current.dispatch({\n        type: 'SET_CURRENT_STEP_ID',\n        payload: { stepId: startId as StepId },\n      });\n      storeRef.current.dispatch({\n        type: 'SET_HISTORY',\n        payload: { history: [startId as StepId] },\n      });\n    } else {\n      storeRef.current.dispatch({\n        type: 'SET_CURRENT_STEP_ID',\n        payload: { stepId: '' as StepId },\n      });\n      storeRef.current.dispatch({\n        type: 'SET_HISTORY',\n        payload: { history: [] },\n      });\n    }\n    persistenceAdapter.clear();\n    trackEvent('wizard_reset', { data: initialData } as any);\n  }, [initialData, activeSteps, persistenceAdapter, trackEvent]);\n\n  const stateValue = useMemo<IWizardState<T, StepId>>(\n    () => ({\n      ...snapshot,\n      config: localConfig,\n    }),\n    [snapshot, localConfig]\n  );\n\n  const actionsValue = useMemo<IWizardActions<StepId>>(\n    () => ({\n      goToNextStep,\n      goToPrevStep,\n      goToStep: (sid: StepId, optionsOrUndefined?: any, thirdArg?: any) => {\n        // Handle both signatures:\n        // 1. goToStep(id, options)\n        // 2. goToStep(id, undefined, options) - mistakenly used by user but likely legacy or internal leak\n\n        let finalOptions = optionsOrUndefined;\n        if (thirdArg && optionsOrUndefined === undefined) {\n          finalOptions = thirdArg;\n        }\n\n        return goToStep(sid, undefined, finalOptions);\n      },\n      setStepData: (_stepId: StepId, data: any) => {\n        const next = { ...storeRef.current.getSnapshot().data, ...data };\n        storeRef.current.update(next as T, Object.keys(data));\n      },\n      handleStepChange: (f: string, v: any) => {\n        if (stateRef.current.currentStepId) setData(f, v);\n      },\n      validateStep: (sid: StepId) => validateStep(sid),\n      validateAll: async () => {\n        storeRef.current.updateMeta({ isBusy: true });\n        const data = storeRef.current.getSnapshot().data;\n        const active = await resolveActiveStepsHelper(data);\n        const results = await Promise.all(\n          active.map((s: IStepConfig<T, StepId>) => validateStep(s.id as StepId))\n        );\n        storeRef.current.updateMeta({ isBusy: false });\n        return {\n          isValid: results.every(Boolean),\n          errors: storeRef.current.getSnapshot().errors,\n        };\n      },\n      save: (ids?: StepId | StepId[] | boolean) => {\n        if (ids === true) {\n          localConfig.steps.forEach((s: IStepConfig<T, StepId>) =>\n            storeRef.current.save(s.id as StepId)\n          );\n        } else if (!ids) {\n          storeRef.current.save();\n        } else {\n          (Array.isArray(ids) ? ids : [ids]).forEach((id) => storeRef.current.save(id as StepId));\n        }\n      },\n      clearStorage: () => persistenceAdapter.clear(),\n      reset,\n      setData,\n      updateData,\n      getData: (p: string, d?: any) => getByPath(storeRef.current.getSnapshot().data, p, d),\n      updateConfig: (nc: any) => {\n        setLocalConfig((prev: IWizardConfig<T, StepId>) => ({ ...prev, ...nc }));\n      },\n    }),\n    [\n      goToNextStep,\n      goToPrevStep,\n      goToStep,\n      validateStep,\n      reset,\n      setData,\n      updateData,\n      persistenceAdapter,\n      localConfig,\n      resolveActiveStepsHelper,\n    ]\n  );\n\n  useEffect(() => {\n    if (!isInitialized.current) {\n      storeRef.current.injectPersistence(persistenceAdapter);\n      storeRef.current.dispatch({\n        type: 'INIT',\n        payload: { data: initialData || ({} as T), config: localConfig as any },\n      });\n      storeRef.current.hydrate();\n      isInitialized.current = true;\n    } else {\n      storeRef.current.updateMeta({ config: localConfig as any });\n    }\n  }, [initialData, localConfig, persistenceAdapter]);\n\n  useEffect(() => {\n    let isMounted = true;\n    const timeoutId = setTimeout(async () => {\n      const resolved = await resolveActiveStepsHelper(data);\n      if (isMounted) {\n        storeRef.current.dispatch({\n          type: 'SET_ACTIVE_STEPS',\n          payload: { steps: resolved as any },\n        });\n      }\n    }, 200);\n\n    return () => {\n      isMounted = false;\n      clearTimeout(timeoutId);\n    };\n  }, [data, resolveActiveStepsHelper]);\n\n  const hasHydratedRef = useRef(false);\n\n  useEffect(() => {\n    if (hasHydratedRef.current) return;\n    hasHydratedRef.current = true;\n\n    const meta = persistenceAdapter.getStep<{\n      currentStepId: string;\n      visited: string[];\n      completed: string[];\n      history: string[];\n    }>(META_KEY);\n    if (meta) {\n      if (meta.currentStepId) {\n        storeRef.current.dispatch({\n          type: 'SET_CURRENT_STEP_ID',\n          payload: { stepId: meta.currentStepId as StepId },\n        });\n      }\n      if (meta.visited)\n        storeRef.current.dispatch({\n          type: 'SET_VISITED_STEPS',\n          payload: { steps: new Set(meta.visited as StepId[]) },\n        });\n      if (meta.completed)\n        storeRef.current.dispatch({\n          type: 'SET_COMPLETED_STEPS',\n          payload: { steps: new Set(meta.completed as StepId[]) },\n        });\n      if (meta.history) {\n        storeRef.current.dispatch({\n          type: 'SET_HISTORY',\n          payload: { history: meta.history as StepId[] },\n        });\n      }\n    }\n\n    const currentSnapshot = storeRef.current.getSnapshot();\n    const currentActiveSteps = currentSnapshot.activeSteps;\n\n    if (!currentSnapshot.currentStepId && currentActiveSteps.length > 0) {\n      const startId =\n        initialStepId &&\n        currentActiveSteps.some((s: IStepConfig<T, StepId>) => s.id === initialStepId)\n          ? initialStepId\n          : currentActiveSteps[0].id;\n\n      storeRef.current.dispatch({\n        type: 'SET_CURRENT_STEP_ID',\n        payload: { stepId: startId as StepId },\n      });\n\n      if (currentSnapshot.history.length === 0) {\n        storeRef.current.dispatch({\n          type: 'SET_HISTORY',\n          payload: { history: [startId as StepId] },\n        });\n      }\n\n      const currentVisited = new Set(currentSnapshot.visitedSteps);\n      if (!currentVisited.has(startId as StepId)) {\n        currentVisited.add(startId as StepId);\n        storeRef.current.dispatch({\n          type: 'SET_VISITED_STEPS',\n          payload: { steps: currentVisited },\n        });\n      }\n    }\n\n    if (currentActiveSteps.length > 0 && currentSnapshot.isLoading) {\n      storeRef.current.updateMeta({ isLoading: false });\n    }\n  }, [activeSteps, initialStepId, persistenceAdapter]);\n\n  return (\n    <WizardStoreContext.Provider value={storeRef.current as any}>\n      <WizardStateContext.Provider value={stateValue}>\n        <WizardActionsContext.Provider value={actionsValue}>\n          {children}\n        </WizardActionsContext.Provider>\n      </WizardStateContext.Provider>\n    </WizardStoreContext.Provider>\n  );\n}\n\n/**\n * Reads the full wizard state.\n */\nexport function useWizardState<T = unknown, StepId extends string = string>(): IWizardState<\n  T,\n  StepId\n> {\n  const context = useContext(WizardStateContext);\n  if (!context) throw new Error('useWizardState must be used within a WizardProvider');\n  return context as IWizardState<T, StepId>;\n}\n\n/**\n * Subscribes to a specific data value by path.\n */\nexport function useWizardValue<TValue = any>(\n  path: string,\n  options?: { isEqual?: (a: TValue, b: TValue) => boolean }\n): TValue {\n  const store = useContext(WizardStoreContext);\n  if (!store) throw new Error('useWizardValue must be used within a WizardProvider');\n  const lastStateRef = useRef<any>(null);\n  const lastValueRef = useRef<any>(null);\n  const getSnapshot = useCallback(() => {\n    const data = store.getSnapshot().data;\n    if (data === lastStateRef.current) return lastValueRef.current;\n    const value = getByPath(data, path) as TValue;\n    if (\n      lastValueRef.current !== undefined &&\n      (options?.isEqual || Object.is)(lastValueRef.current, value)\n    ) {\n      lastStateRef.current = data;\n      return lastValueRef.current;\n    }\n    lastStateRef.current = data;\n    lastValueRef.current = value;\n    return value;\n  }, [store, path, options?.isEqual]);\n  return useSyncExternalStore(store.subscribe, getSnapshot);\n}\n\n/**\n * Returns the first error message for a path across all steps.\n */\nexport function useWizardError(path: string): string | undefined {\n  const store = useContext(WizardStoreContext);\n  if (!store) throw new Error('useWizardError must be used within a WizardProvider');\n  const getSnapshot = useCallback(() => {\n    const errors = store.getSnapshot().errors;\n    for (const [_, stepErrors] of Object.entries(errors)) {\n      const typed = stepErrors as Record<string, string>;\n      if (typed[path]) return typed[path];\n    }\n    return undefined;\n  }, [store, path]);\n  return useSyncExternalStore(store.subscribe, getSnapshot);\n}\n\n/**\n * Selects a derived value from the wizard state with optional equality check.\n */\nexport function useWizardSelector<TSelected = any>(\n  selector: (state: any) => TSelected,\n  options?: { isEqual?: (a: TSelected, b: TSelected) => boolean }\n): TSelected {\n  const store = useContext(WizardStoreContext);\n  if (!store) throw new Error('useWizardSelector must be used within a WizardProvider');\n\n  const lastResultRef = useRef<TSelected | null>(null);\n\n  const getSnapshot = useCallback(() => {\n    const full = store.getSnapshot();\n    const res = selector(full);\n\n    if (\n      lastResultRef.current !== null &&\n      (options?.isEqual || Object.is)(lastResultRef.current, res)\n    ) {\n      return lastResultRef.current;\n    }\n\n    lastResultRef.current = res;\n    return res;\n  }, [store, selector, options?.isEqual]);\n\n  return useSyncExternalStore(store.subscribe, getSnapshot);\n}\n\n/**\n * Returns the wizard actions API.\n */\nexport function useWizardActions<StepId extends string = string>(): IWizardActions<StepId> {\n  const context = useContext(WizardActionsContext);\n  if (!context) throw new Error('useWizardActions must be used within a WizardProvider');\n  return context as IWizardActions<StepId>;\n}\n\n/**\n * Returns combined wizard state, actions, and derived errors.\n */\nexport function useWizardContext<T = any, StepId extends string = string>(): IWizardContext<\n  T,\n  StepId\n> {\n  const state = useWizardState<T, StepId>();\n  const actions = useWizardActions<StepId>();\n  const store = useContext(WizardStoreContext) as IWizardStore<T, StepId>;\n  const data = useWizardSelector((s: IWizardState<T, StepId>) => s.data);\n  const allErrors = useWizardSelector((s: IWizardState<T, StepId>) => s.errors);\n  const errors = useMemo(() => {\n    const flat: Record<string, string> = {};\n    Object.values(allErrors).forEach((stepErrors) => {\n      Object.assign(flat, stepErrors as Record<string, string>);\n    });\n    return flat;\n  }, [allErrors]);\n\n  const { data: _d, errors: _e, ...stateProps } = state as any;\n  return useMemo(\n    () => ({\n      ...stateProps,\n      ...actions,\n      data,\n      allErrors,\n      errors,\n      store,\n    }),\n    [stateProps, actions, data, allErrors, errors, store]\n  ) as IWizardContext<T, StepId>;\n}\n","import { useWizardContext } from '../context/WizardContext';\nimport type { IWizardContext } from '../types';\n\n/**\n * Alias for useWizardContext.\n */\nexport const useWizard = <T = any, StepId extends string = string>(): IWizardContext<T, StepId> => {\n  return useWizardContext<T, StepId>();\n};\n","import React from 'react';\nimport {\n  WizardProvider as BaseWizardProvider,\n  useWizardContext as useBaseWizardContext,\n  useWizardValue as useBaseWizardValue,\n  useWizardSelector as useBaseWizardSelector,\n  useWizardError as useBaseWizardError,\n  useWizardActions as useBaseWizardActions,\n  useWizardState as useBaseWizardState,\n} from './context/WizardContext';\nimport { useWizard as useBaseWizard } from './hooks/useWizard';\nimport type { IWizardConfig, IWizardContext, IStepConfig, Path, PathValue } from '@wizzard-packages/core';\n\n/**\n * createWizardFactory\n *\n * Creates a strongly-typed set of Wizard components and hooks for a specific data schema.\n *\n * @template TSchema The shape of your wizard's global data state\n */\nexport function createWizardFactory<\n  TSchema extends Record<string, any>,\n  StepId extends string = string,\n>() {\n  const WizardProvider = ({\n    config,\n    initialData,\n    children,\n  }: {\n    config: IWizardConfig<TSchema, StepId>;\n    initialData?: Partial<TSchema>;\n    children: React.ReactNode;\n  }) => {\n    return (\n      <BaseWizardProvider<TSchema, StepId> config={config} initialData={initialData as TSchema}>\n        {children}\n      </BaseWizardProvider>\n    );\n  };\n\n  const useWizard = (): IWizardContext<TSchema, StepId> => {\n    return useBaseWizard<TSchema, StepId>() as any;\n  };\n\n  const useWizardContext = () => {\n    return useBaseWizardContext<TSchema, StepId>() as any;\n  };\n\n  const useWizardValue = <P extends Path<TSchema>>(\n    path: P,\n    options?: {\n      isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;\n    }\n  ): PathValue<TSchema, P> => {\n    return useBaseWizardValue<PathValue<TSchema, P>>(path as string, options);\n  };\n\n  const useWizardSelector = <TSelected,>(\n    selector: (state: IWizardContext<TSchema, StepId>) => TSelected,\n    options?: { isEqual?: (a: TSelected, b: TSelected) => boolean }\n  ): TSelected => {\n    return useBaseWizardSelector<TSelected>(selector as any, options);\n  };\n\n  const useWizardError = <P extends Path<TSchema>>(path: P): string | undefined => {\n    return useBaseWizardError(path as string);\n  };\n\n  const useWizardActions = () => {\n    return useBaseWizardActions<StepId>();\n  };\n\n  const useWizardState = () => {\n    return useBaseWizardState<TSchema, StepId>();\n  };\n\n  const useBreadcrumbs = () => {\n    return useBaseWizardState<TSchema, StepId>().breadcrumbs;\n  };\n\n  const createStep = (config: IStepConfig<TSchema, StepId>) => config;\n\n  return {\n    WizardProvider,\n    useWizard,\n    useWizardContext,\n    useWizardValue,\n    useWizardSelector,\n    useWizardError,\n    useWizardActions,\n    useWizardState,\n    useBreadcrumbs,\n    createStep,\n  };\n}\n","import React, { useMemo, Suspense } from 'react';\nimport { useWizardContext } from '../context/WizardContext';\n\n/**\n * Props for rendering the current step component.\n */\nexport interface WizardStepRendererProps {\n  wrapper?: React.ComponentType<{ children: React.ReactNode; key: string }>;\n  fallback?: React.ReactNode;\n}\n\n/**\n * Renders the active step component with optional wrapper and suspense fallback.\n */\nexport const WizardStepRenderer: React.FC<WizardStepRendererProps> = ({\n  wrapper: Wrapper,\n  fallback = null,\n}) => {\n  const { currentStep } = useWizardContext();\n\n  const StepComponent = useMemo(() => {\n    if (!currentStep?.component) return null;\n    return currentStep.component;\n  }, [currentStep]);\n\n  if (!currentStep || !StepComponent) {\n    return null;\n  }\n\n  const content = (\n    <Suspense fallback={fallback}>\n      <StepComponent />\n    </Suspense>\n  );\n\n  if (Wrapper) {\n    return <Wrapper key={currentStep.id}>{content}</Wrapper>;\n  }\n\n  return content;\n};\n"],"mappings":"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","names":["data","currentStepId","activeSteps","activeStepsIndexMap","initialData","completedSteps","visitedSteps","stepsMap","import_jsx_runtime","WizardProvider","useWizard","useWizardContext","useWizardValue","useWizardSelector","useWizardError","useWizardActions","useWizardState","import_react","import_jsx_runtime","import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,116 @@
+import * as _wizzard_packages_core from '@wizzard-packages/core';
+import { IWizardConfig, IWizardContext as IWizardContext$1, Path, PathValue, IStepConfig, IWizardState, IWizardActions as IWizardActions$1 } from '@wizzard-packages/core';
+export { IStepConfig, IValidatorAdapter, IWizardActions, IWizardConfig, IWizardContext, IWizardState, PersistenceMode, ValidationResult, WizardMiddleware, WizardStore } from '@wizzard-packages/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+export { loggerMiddleware } from '@wizzard-packages/middleware';
+
+/**
+ * createWizardFactory
+ *
+ * Creates a strongly-typed set of Wizard components and hooks for a specific data schema.
+ *
+ * @template TSchema The shape of your wizard's global data state
+ */
+declare function createWizardFactory<TSchema extends Record<string, any>, StepId extends string = string>(): {
+    WizardProvider: ({ config, initialData, children, }: {
+        config: IWizardConfig<TSchema, StepId>;
+        initialData?: Partial<TSchema>;
+        children: React.ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    useWizard: () => IWizardContext$1<TSchema, StepId>;
+    useWizardContext: () => any;
+    useWizardValue: <P extends Path<TSchema>>(path: P, options?: {
+        isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;
+    }) => PathValue<TSchema, P>;
+    useWizardSelector: <TSelected>(selector: (state: IWizardContext$1<TSchema, StepId>) => TSelected, options?: {
+        isEqual?: (a: TSelected, b: TSelected) => boolean;
+    }) => TSelected;
+    useWizardError: <P extends Path<TSchema>>(path: P) => string | undefined;
+    useWizardActions: () => _wizzard_packages_core.IWizardActions<StepId>;
+    useWizardState: () => _wizzard_packages_core.IWizardState<TSchema, StepId>;
+    useBreadcrumbs: () => _wizzard_packages_core.IBreadcrumb<StepId>[];
+    createStep: (config: IStepConfig<TSchema, StepId>) => IStepConfig<TSchema, StepId>;
+};
+
+/**
+ * Props for WizardProvider.
+ */
+interface WizardProviderProps<T, StepId extends string> {
+    config: IWizardConfig<T, StepId>;
+    initialData?: T;
+    initialStepId?: StepId;
+    children: React.ReactNode;
+}
+/**
+ * Component that provides the wizard context to its children.
+ */
+declare function WizardProvider<T extends Record<string, any>, StepId extends string = string>({ config, initialData, initialStepId, children, }: WizardProviderProps<T, StepId>): react_jsx_runtime.JSX.Element;
+/**
+ * Reads the full wizard state.
+ */
+declare function useWizardState<T = unknown, StepId extends string = string>(): IWizardState<T, StepId>;
+/**
+ * Subscribes to a specific data value by path.
+ */
+declare function useWizardValue<TValue = any>(path: string, options?: {
+    isEqual?: (a: TValue, b: TValue) => boolean;
+}): TValue;
+/**
+ * Returns the first error message for a path across all steps.
+ */
+declare function useWizardError(path: string): string | undefined;
+/**
+ * Selects a derived value from the wizard state with optional equality check.
+ */
+declare function useWizardSelector<TSelected = any>(selector: (state: any) => TSelected, options?: {
+    isEqual?: (a: TSelected, b: TSelected) => boolean;
+}): TSelected;
+/**
+ * Returns the wizard actions API.
+ */
+declare function useWizardActions<StepId extends string = string>(): IWizardActions$1<StepId>;
+/**
+ * Returns combined wizard state, actions, and derived errors.
+ */
+declare function useWizardContext<T = any, StepId extends string = string>(): IWizardContext$1<T, StepId>;
+
+/**
+ * Props for rendering the current step component.
+ */
+interface WizardStepRendererProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+        key: string;
+    }>;
+    fallback?: React.ReactNode;
+}
+/**
+ * Renders the active step component with optional wrapper and suspense fallback.
+ */
+declare const WizardStepRenderer: React.FC<WizardStepRendererProps>;
+
+/**
+ * Handle returned by components for imperative access to the wizard.
+ */
+interface IWizardHandle<T = unknown, StepId extends string = string> {
+    state: IWizardState<T, StepId>;
+    actions: IWizardActions<StepId>;
+}
+/**
+ * React-specific actions
+ */
+interface IWizardActions<StepId extends string = string> extends IWizardActions$1<StepId> {
+}
+/**
+ * Core Wizard Context State
+ */
+interface IWizardContext<T = unknown, StepId extends string = string> extends IWizardContext$1<T, StepId> {
+}
+
+/**
+ * Alias for useWizardContext.
+ */
+declare const useWizard: <T = any, StepId extends string = string>() => IWizardContext<T, StepId>;
+
+export { type IWizardHandle, WizardProvider, type WizardProviderProps, WizardStepRenderer, type WizardStepRendererProps, createWizardFactory, useWizard, useWizardActions, useWizardContext, useWizardError, useWizardSelector, useWizardState, useWizardValue };

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+import * as _wizzard_packages_core from '@wizzard-packages/core';
+import { IWizardConfig, IWizardContext as IWizardContext$1, Path, PathValue, IStepConfig, IWizardState, IWizardActions as IWizardActions$1 } from '@wizzard-packages/core';
+export { IStepConfig, IValidatorAdapter, IWizardActions, IWizardConfig, IWizardContext, IWizardState, PersistenceMode, ValidationResult, WizardMiddleware, WizardStore } from '@wizzard-packages/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+export { loggerMiddleware } from '@wizzard-packages/middleware';
+
+/**
+ * createWizardFactory
+ *
+ * Creates a strongly-typed set of Wizard components and hooks for a specific data schema.
+ *
+ * @template TSchema The shape of your wizard's global data state
+ */
+declare function createWizardFactory<TSchema extends Record<string, any>, StepId extends string = string>(): {
+    WizardProvider: ({ config, initialData, children, }: {
+        config: IWizardConfig<TSchema, StepId>;
+        initialData?: Partial<TSchema>;
+        children: React.ReactNode;
+    }) => react_jsx_runtime.JSX.Element;
+    useWizard: () => IWizardContext$1<TSchema, StepId>;
+    useWizardContext: () => any;
+    useWizardValue: <P extends Path<TSchema>>(path: P, options?: {
+        isEqual?: (a: PathValue<TSchema, P>, b: PathValue<TSchema, P>) => boolean;
+    }) => PathValue<TSchema, P>;
+    useWizardSelector: <TSelected>(selector: (state: IWizardContext$1<TSchema, StepId>) => TSelected, options?: {
+        isEqual?: (a: TSelected, b: TSelected) => boolean;
+    }) => TSelected;
+    useWizardError: <P extends Path<TSchema>>(path: P) => string | undefined;
+    useWizardActions: () => _wizzard_packages_core.IWizardActions<StepId>;
+    useWizardState: () => _wizzard_packages_core.IWizardState<TSchema, StepId>;
+    useBreadcrumbs: () => _wizzard_packages_core.IBreadcrumb<StepId>[];
+    createStep: (config: IStepConfig<TSchema, StepId>) => IStepConfig<TSchema, StepId>;
+};
+
+/**
+ * Props for WizardProvider.
+ */
+interface WizardProviderProps<T, StepId extends string> {
+    config: IWizardConfig<T, StepId>;
+    initialData?: T;
+    initialStepId?: StepId;
+    children: React.ReactNode;
+}
+/**
+ * Component that provides the wizard context to its children.
+ */
+declare function WizardProvider<T extends Record<string, any>, StepId extends string = string>({ config, initialData, initialStepId, children, }: WizardProviderProps<T, StepId>): react_jsx_runtime.JSX.Element;
+/**
+ * Reads the full wizard state.
+ */
+declare function useWizardState<T = unknown, StepId extends string = string>(): IWizardState<T, StepId>;
+/**
+ * Subscribes to a specific data value by path.
+ */
+declare function useWizardValue<TValue = any>(path: string, options?: {
+    isEqual?: (a: TValue, b: TValue) => boolean;
+}): TValue;
+/**
+ * Returns the first error message for a path across all steps.
+ */
+declare function useWizardError(path: string): string | undefined;
+/**
+ * Selects a derived value from the wizard state with optional equality check.
+ */
+declare function useWizardSelector<TSelected = any>(selector: (state: any) => TSelected, options?: {
+    isEqual?: (a: TSelected, b: TSelected) => boolean;
+}): TSelected;
+/**
+ * Returns the wizard actions API.
+ */
+declare function useWizardActions<StepId extends string = string>(): IWizardActions$1<StepId>;
+/**
+ * Returns combined wizard state, actions, and derived errors.
+ */
+declare function useWizardContext<T = any, StepId extends string = string>(): IWizardContext$1<T, StepId>;
+
+/**
+ * Props for rendering the current step component.
+ */
+interface WizardStepRendererProps {
+    wrapper?: React.ComponentType<{
+        children: React.ReactNode;
+        key: string;
+    }>;
+    fallback?: React.ReactNode;
+}
+/**
+ * Renders the active step component with optional wrapper and suspense fallback.
+ */
+declare const WizardStepRenderer: React.FC<WizardStepRendererProps>;
+
+/**
+ * Handle returned by components for imperative access to the wizard.
+ */
+interface IWizardHandle<T = unknown, StepId extends string = string> {
+    state: IWizardState<T, StepId>;
+    actions: IWizardActions<StepId>;
+}
+/**
+ * React-specific actions
+ */
+interface IWizardActions<StepId extends string = string> extends IWizardActions$1<StepId> {
+}
+/**
+ * Core Wizard Context State
+ */
+interface IWizardContext<T = unknown, StepId extends string = string> extends IWizardContext$1<T, StepId> {
+}
+
+/**
+ * Alias for useWizardContext.
+ */
+declare const useWizard: <T = any, StepId extends string = string>() => IWizardContext<T, StepId>;
+
+export { type IWizardHandle, WizardProvider, type WizardProviderProps, WizardStepRenderer, type WizardStepRendererProps, createWizardFactory, useWizard, useWizardActions, useWizardContext, useWizardError, useWizardSelector, useWizardState, useWizardValue };