@lumeweb/portal-framework-ui 0.0.1 → 0.1.0

package/dist/cjs/components/form/StepControlContext.cjs

@@ -0,0 +1,265 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/components/form/StepControlContext.tsx
+/**
+* Provider component for step control functionality
+* Handles step navigation logic and state management
+*/
+function StepControlProvider({ children, defaultStep, handleStepSubmit, isBackValidate, onStepChange, onStepRetry, onNavigationStart, onNavigationEnd, onNavigationError, totalSteps, triggerValidation }) {
+	const stepControl = useCreateStepControl({
+		defaultStep: defaultStep ?? 1,
+		handleStepSubmit,
+		isBackValidate: isBackValidate ?? false,
+		onStepChange,
+		onStepRetry,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError,
+		totalSteps: totalSteps ?? 1,
+		triggerValidation
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StepControlContext.Provider, {
+		value: stepControl,
+		children
+	});
+}
+function useCreateStepControl({ defaultStep = 1, handleStepSubmit, isBackValidate = false, onStepChange, onStepRetry, onNavigationStart, onNavigationEnd, onNavigationError, totalSteps: totalStepsProp, triggerValidation }) {
+	const [currentStep, setCurrentStep] = (0, react.useState)(defaultStep);
+	const [retryCount, setRetryCount] = (0, react.useState)(0);
+	const [transitionState, setTransitionState] = (0, react.useState)({
+		direction: null,
+		enteringStep: null,
+		exitingStep: null
+	});
+	const isFirstStep = currentStep === 1;
+	const isLastStep = currentStep === totalStepsProp;
+	const goToStep = (0, react.useCallback)((step) => {
+		const targetStep = Math.max(1, Math.min(step, totalStepsProp));
+		try {
+			onNavigationStart?.(currentStep, targetStep, "goTo");
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "goTo", error);
+			return;
+		}
+		if (targetStep === currentStep) {
+			onNavigationEnd?.(currentStep, targetStep, "goTo");
+			return;
+		}
+		setRetryCount(0);
+		setTransitionState({
+			direction: targetStep > currentStep ? "forward" : "backward",
+			enteringStep: targetStep,
+			exitingStep: currentStep
+		});
+		setTimeout(() => {
+			try {
+				setCurrentStep(targetStep);
+				setTransitionState({
+					direction: null,
+					enteringStep: null,
+					exitingStep: null
+				});
+				onStepChange?.(targetStep);
+				onNavigationEnd?.(currentStep, targetStep, "goTo");
+			} catch (error) {
+				onNavigationError?.(currentStep, targetStep, "goTo", error);
+			}
+		}, 300);
+	}, [
+		totalStepsProp,
+		onStepChange,
+		currentStep,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError
+	]);
+	const jumpTo = (0, react.useCallback)((step) => {
+		const targetStep = Math.max(1, Math.min(step, totalStepsProp));
+		try {
+			onNavigationStart?.(currentStep, targetStep, "jumpTo");
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "jumpTo", error);
+			return;
+		}
+		if (targetStep === currentStep) {
+			onNavigationEnd?.(currentStep, targetStep, "jumpTo");
+			return;
+		}
+		setRetryCount(0);
+		try {
+			setCurrentStep(targetStep);
+			onStepChange?.(targetStep);
+			onNavigationEnd?.(currentStep, targetStep, "jumpTo");
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "jumpTo", error);
+		}
+	}, [
+		totalStepsProp,
+		onStepChange,
+		currentStep,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError
+	]);
+	const handleRetry = (0, react.useCallback)(async () => {
+		try {
+			onNavigationStart?.(currentStep, currentStep, "retry");
+		} catch (error) {
+			onNavigationError?.(currentStep, currentStep, "retry", error);
+			return;
+		}
+		setRetryCount((prev) => prev + 1);
+		setTransitionState({
+			direction: null,
+			enteringStep: currentStep,
+			exitingStep: currentStep
+		});
+		setTimeout(() => {
+			try {
+				setTransitionState({
+					direction: null,
+					enteringStep: null,
+					exitingStep: null
+				});
+				setCurrentStep(currentStep);
+				onStepRetry?.(currentStep);
+				onNavigationEnd?.(currentStep, currentStep, "retry");
+			} catch (error) {
+				onNavigationError?.(currentStep, currentStep, "retry", error);
+			}
+		}, 300);
+	}, [
+		currentStep,
+		onStepRetry,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError
+	]);
+	const handleNext = (0, react.useCallback)(async () => {
+		if (isLastStep) return;
+		const targetStep = currentStep + 1;
+		try {
+			onNavigationStart?.(currentStep, targetStep, "next");
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "next", error);
+			return;
+		}
+		if (handleStepSubmit) try {
+			await handleStepSubmit();
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "next", error);
+			return;
+		}
+		goToStep(targetStep);
+	}, [
+		currentStep,
+		isLastStep,
+		goToStep,
+		handleStepSubmit,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError
+	]);
+	const handlePrevious = (0, react.useCallback)(async () => {
+		if (isFirstStep) return;
+		const targetStep = currentStep - 1;
+		try {
+			onNavigationStart?.(currentStep, targetStep, "previous");
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "previous", error);
+			return;
+		}
+		if (isBackValidate && triggerValidation) try {
+			if (!await triggerValidation()) {
+				onNavigationError?.(currentStep, targetStep, "previous", /* @__PURE__ */ new Error("Validation failed"));
+				return;
+			}
+		} catch (error) {
+			onNavigationError?.(currentStep, targetStep, "previous", error);
+			return;
+		}
+		goToStep(targetStep);
+	}, [
+		currentStep,
+		isFirstStep,
+		isBackValidate,
+		triggerValidation,
+		goToStep,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError
+	]);
+	return (0, react.useMemo)(() => ({
+		currentStep,
+		goToStep,
+		jumpTo,
+		handleNext,
+		handlePrevious,
+		handleRetry,
+		retryCount,
+		isFirstStep,
+		isLastStep,
+		totalSteps: totalStepsProp,
+		transitionState
+	}), [
+		currentStep,
+		totalStepsProp,
+		isFirstStep,
+		isLastStep,
+		goToStep,
+		jumpTo,
+		handleNext,
+		handlePrevious,
+		handleRetry,
+		retryCount,
+		transitionState
+	]);
+}
+/**
+* Hook to optionally consume the step control context
+* @returns StepControlContextType | undefined - Step control methods and state, or undefined if not in context
+*/
+function useOptionalStepControlContext() {
+	return (0, react.useContext)(StepControlContext);
+}
+/**
+* Backward compatibility hook
+* This maintains the original API where useStepControl could be used as both
+* a context consumer and a creator depending on whether options were passed
+*/
+function useStepControl(options) {
+	if (options) return useCreateStepControl(options);
+	return useStepControlContext();
+}
+/**
+* Hook to consume the step control context
+* @returns StepControlContextType - Step control methods and state
+* @throws Error if used outside StepControlProvider
+*/
+function useStepControlContext() {
+	const context = (0, react.useContext)(StepControlContext);
+	if (context === void 0) throw new Error("useStepControl must be used within a StepControlProvider");
+	return context;
+}
+var StepControlContext;
+var init_StepControlContext = require_rolldown_runtime.__esmMin((() => {
+	StepControlContext = (0, react.createContext)(void 0);
+}));
+
+//#endregion
+init_StepControlContext();
+exports.StepControlProvider = StepControlProvider;
+Object.defineProperty(exports, 'init_StepControlContext', {
+  enumerable: true,
+  get: function () {
+    return init_StepControlContext;
+  }
+});
+exports.useCreateStepControl = useCreateStepControl;
+exports.useOptionalStepControlContext = useOptionalStepControlContext;
+exports.useStepControl = useStepControl;
+exports.useStepControlContext = useStepControlContext;
+//# sourceMappingURL=StepControlContext.cjs.map

package/dist/cjs/components/form/StepControlContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepControlContext.cjs","names":[],"sources":["../../../../src/components/form/StepControlContext.tsx"],"sourcesContent":["import React, {\n  createContext,\n  useCallback,\n  useContext,\n  useMemo,\n  useState,\n} from \"react\";\n\nimport type { NavigationType } from \"@/components\";\n\n/**\n * Interface for step control context values\n */\nexport interface StepControlContextType {\n  /**\n   * Current active step index\n   */\n  currentStep: number;\n  /**\n   * Navigate to a specific step\n   * @param step - The step index to navigate to\n   */\n  goToStep: (step: number) => void;\n  /**\n   * Jump to a specific step without transition animation\n   * @param step - The step index to jump to\n   */\n  jumpTo: (step: number) => void;\n  /**\n   * Navigate to the next step\n   */\n  handleNext: () => Promise<void>;\n  /**\n   * Navigate to the previous step\n   */\n  handlePrevious: () => Promise<void>;\n  /**\n   * Retry the current step\n   */\n  handleRetry: () => Promise<void>;\n  /**\n   * Number of times the current step has been retried\n   */\n  retryCount: number;\n  /**\n   * Whether the current step is the first step\n   */\n  isFirstStep: boolean;\n  /**\n   * Whether the current step is the last step\n   */\n  isLastStep: boolean;\n  /**\n   * Total number of steps\n   */\n  totalSteps: number;\n  /**\n   * Transition state with navigation direction\n   */\n  transitionState: {\n    direction: \"backward\" | \"forward\" | null;\n    enteringStep: null | number;\n    exitingStep: null | number;\n  };\n}\n\nconst StepControlContext = createContext<StepControlContextType | undefined>(\n  undefined,\n);\n\nexport interface StepControlProviderProps {\n  children: React.ReactNode;\n  /**\n   * Default step to start on\n   */\n  defaultStep?: number;\n  /**\n   * Function to handle step submission\n   */\n  handleStepSubmit?: () => Promise<void>;\n  /**\n   * Whether to validate when going back steps\n   */\n  isBackValidate?: boolean;\n  /**\n   * Callback when step changes\n   */\n  onStepChange?: (step: number) => void;\n  /**\n   * Callback when step is retried\n   */\n  onStepRetry?: (step: number) => void;\n  /**\n   * Callback when navigation starts\n   */\n  onNavigationStart?: (\n    fromStep: number,\n    toStep: number,\n    type: NavigationType,\n  ) => void;\n  /**\n   * Callback when navigation ends successfully\n   */\n  onNavigationEnd?: (\n    fromStep: number,\n    toStep: number,\n    type: NavigationType,\n  ) => void;\n  /**\n   * Callback when navigation fails\n   */\n  onNavigationError?: (\n    fromStep: number,\n    toStep: number,\n    type: NavigationType,\n    error: any,\n  ) => void;\n  /**\n   * Total number of steps\n   */\n  totalSteps?: number;\n  /**\n   * Function to trigger validation for the current step\n   */\n  triggerValidation?: () => Promise<boolean>;\n}\n\n/**\n * Hook to create step control state independently\n * This hook can be used outside of StepControlProvider\n */\nexport interface UseCreateStepControlOptions {\n  /**\n   * Default step to start on\n   * @default 1\n   */\n  defaultStep?: number;\n  /**\n   * Function to handle step submission\n   */\n  handleStepSubmit?: () => Promise<void>;\n  /**\n   * Whether to validate when going back steps\n   * @default false\n   */\n  isBackValidate?: boolean;\n  /**\n   * Callback when step changes\n   */\n  onStepChange?: (step: number) => void;\n  /**\n   * Callback when step is retried\n   */\n  onStepRetry?: (step: number) => void;\n  /**\n   * Callback when navigation starts\n   */\n  onNavigationStart?: (\n    fromStep: number,\n    toStep: number,\n    type: NavigationType,\n  ) => void;\n  /**\n   * Callback when navigation ends successfully\n   */\n  onNavigationEnd?: (\n    fromStep: number,\n    toStep: number,\n    type: NavigationType,\n  ) => void;\n  /**\n   * Callback when navigation fails\n   */\n  onNavigationError?: (\n    fromStep: number,\n    toStep: number,\n    type: NavigationType,\n    error: any,\n  ) => void;\n  /**\n   * Total number of steps\n   */\n  totalSteps: number;\n  /**\n   * Function to trigger validation for the current step\n   */\n  triggerValidation?: () => Promise<boolean>;\n}\n\n/**\n * Provider component for step control functionality\n * Handles step navigation logic and state management\n */\nexport function StepControlProvider({\n  children,\n  defaultStep,\n  handleStepSubmit,\n  isBackValidate,\n  onStepChange,\n  onStepRetry,\n  onNavigationStart,\n  onNavigationEnd,\n  onNavigationError,\n  totalSteps,\n  triggerValidation,\n}: StepControlProviderProps) {\n  const stepControl = useCreateStepControl({\n    defaultStep: defaultStep ?? 1,\n    handleStepSubmit,\n    isBackValidate: isBackValidate ?? false,\n    onStepChange,\n    onStepRetry,\n    onNavigationStart,\n    onNavigationEnd,\n    onNavigationError,\n    totalSteps: totalSteps ?? 1,\n    triggerValidation,\n  });\n\n  return (\n    <StepControlContext.Provider value={stepControl}>\n      {children}\n    </StepControlContext.Provider>\n  );\n}\n\nexport function useCreateStepControl({\n  defaultStep = 1,\n  handleStepSubmit,\n  isBackValidate = false,\n  onStepChange,\n  onStepRetry,\n  onNavigationStart,\n  onNavigationEnd,\n  onNavigationError,\n  totalSteps: totalStepsProp,\n  triggerValidation,\n}: UseCreateStepControlOptions): StepControlContextType {\n  const [currentStep, setCurrentStep] = useState(defaultStep);\n  const [retryCount, setRetryCount] = useState(0);\n  const [transitionState, setTransitionState] = useState<{\n    direction: \"backward\" | \"forward\" | null;\n    enteringStep: null | number;\n    exitingStep: null | number;\n  }>({\n    direction: null,\n    enteringStep: null,\n    exitingStep: null,\n  });\n\n  const isFirstStep = currentStep === 1;\n  const isLastStep = currentStep === totalStepsProp;\n\n  const goToStep = useCallback(\n    (step: number) => {\n      const targetStep = Math.max(1, Math.min(step, totalStepsProp));\n\n      // Call navigation start callback\n      try {\n        onNavigationStart?.(currentStep, targetStep, \"goTo\");\n      } catch (error) {\n        onNavigationError?.(currentStep, targetStep, \"goTo\", error);\n        return;\n      }\n\n      if (targetStep === currentStep) {\n        onNavigationEnd?.(currentStep, targetStep, \"goTo\");\n        return;\n      }\n\n      // Reset retry count when navigating to a different step\n      setRetryCount(0);\n\n      // Determine navigation direction\n      const direction = targetStep > currentStep ? \"forward\" : \"backward\";\n\n      setTransitionState({\n        direction,\n        enteringStep: targetStep,\n        exitingStep: currentStep,\n      });\n\n      // After transition duration, update the current step\n      setTimeout(() => {\n        try {\n          setCurrentStep(targetStep);\n          setTransitionState({\n            direction: null,\n            enteringStep: null,\n            exitingStep: null,\n          });\n          onStepChange?.(targetStep);\n          onNavigationEnd?.(currentStep, targetStep, \"goTo\");\n        } catch (error) {\n          onNavigationError?.(currentStep, targetStep, \"goTo\", error);\n        }\n      }, 300);\n    },\n    [\n      totalStepsProp,\n      onStepChange,\n      currentStep,\n      onNavigationStart,\n      onNavigationEnd,\n      onNavigationError,\n    ],\n  );\n\n  const jumpTo = useCallback(\n    (step: number) => {\n      const targetStep = Math.max(1, Math.min(step, totalStepsProp));\n\n      // Call navigation start callback\n      try {\n        onNavigationStart?.(currentStep, targetStep, \"jumpTo\");\n      } catch (error) {\n        onNavigationError?.(currentStep, targetStep, \"jumpTo\", error);\n        return;\n      }\n\n      if (targetStep === currentStep) {\n        onNavigationEnd?.(currentStep, targetStep, \"jumpTo\");\n        return;\n      }\n\n      // Reset retry count when jumping to a different step\n      setRetryCount(0);\n\n      // Skip transition animation and directly set the step\n      try {\n        setCurrentStep(targetStep);\n        onStepChange?.(targetStep);\n        onNavigationEnd?.(currentStep, targetStep, \"jumpTo\");\n      } catch (error) {\n        onNavigationError?.(currentStep, targetStep, \"jumpTo\", error);\n      }\n    },\n    [\n      totalStepsProp,\n      onStepChange,\n      currentStep,\n      onNavigationStart,\n      onNavigationEnd,\n      onNavigationError,\n    ],\n  );\n\n  const handleRetry = useCallback(async () => {\n    // Call navigation start callback\n    try {\n      onNavigationStart?.(currentStep, currentStep, \"retry\");\n    } catch (error) {\n      onNavigationError?.(currentStep, currentStep, \"retry\", error);\n      return;\n    }\n\n    // Increment retry count\n    setRetryCount((prev) => prev + 1);\n\n    // Trigger transition animation for retry\n    setTransitionState({\n      direction: null,\n      enteringStep: currentStep,\n      exitingStep: currentStep,\n    });\n\n    // After transition duration, reset transition state, set current step to force reprocessing, and trigger callback\n    setTimeout(() => {\n      try {\n        setTransitionState({\n          direction: null,\n          enteringStep: null,\n          exitingStep: null,\n        });\n        setCurrentStep(currentStep);\n        onStepRetry?.(currentStep);\n        onNavigationEnd?.(currentStep, currentStep, \"retry\");\n      } catch (error) {\n        onNavigationError?.(currentStep, currentStep, \"retry\", error);\n      }\n    }, 300);\n  }, [\n    currentStep,\n    onStepRetry,\n    onNavigationStart,\n    onNavigationEnd,\n    onNavigationError,\n  ]);\n\n  const handleNext = useCallback(async () => {\n    if (isLastStep) return;\n\n    const targetStep = currentStep + 1;\n\n    // Call navigation start callback\n    try {\n      onNavigationStart?.(currentStep, targetStep, \"next\");\n    } catch (error) {\n      onNavigationError?.(currentStep, targetStep, \"next\", error);\n      return;\n    }\n\n    // Handle step submission if provided\n    if (handleStepSubmit) {\n      try {\n        await handleStepSubmit();\n      } catch (error) {\n        onNavigationError?.(currentStep, targetStep, \"next\", error);\n        return;\n      }\n    }\n\n    goToStep(targetStep);\n  }, [\n    currentStep,\n    isLastStep,\n    goToStep,\n    handleStepSubmit,\n    onNavigationStart,\n    onNavigationEnd,\n    onNavigationError,\n  ]);\n\n  const handlePrevious = useCallback(async () => {\n    if (isFirstStep) return;\n\n    const targetStep = currentStep - 1;\n\n    // Call navigation start callback\n    try {\n      onNavigationStart?.(currentStep, targetStep, \"previous\");\n    } catch (error) {\n      onNavigationError?.(currentStep, targetStep, \"previous\", error);\n      return;\n    }\n\n    if (isBackValidate && triggerValidation) {\n      try {\n        const isValid = await triggerValidation();\n        if (!isValid) {\n          onNavigationError?.(\n            currentStep,\n            targetStep,\n            \"previous\",\n            new Error(\"Validation failed\"),\n          );\n          return;\n        }\n      } catch (error) {\n        onNavigationError?.(currentStep, targetStep, \"previous\", error);\n        return;\n      }\n    }\n\n    goToStep(targetStep);\n  }, [\n    currentStep,\n    isFirstStep,\n    isBackValidate,\n    triggerValidation,\n    goToStep,\n    onNavigationStart,\n    onNavigationEnd,\n    onNavigationError,\n  ]);\n\n  return useMemo(\n    () => ({\n      currentStep,\n      goToStep,\n      jumpTo,\n      handleNext,\n      handlePrevious,\n      handleRetry,\n      retryCount,\n      isFirstStep,\n      isLastStep,\n      totalSteps: totalStepsProp,\n      transitionState,\n    }),\n    [\n      currentStep,\n      totalStepsProp,\n      isFirstStep,\n      isLastStep,\n      goToStep,\n      jumpTo,\n      handleNext,\n      handlePrevious,\n      handleRetry,\n      retryCount,\n      transitionState,\n    ],\n  );\n}\n\n/**\n * Hook to optionally consume the step control context\n * @returns StepControlContextType | undefined - Step control methods and state, or undefined if not in context\n */\nexport function useOptionalStepControlContext() {\n  return useContext(StepControlContext);\n}\n\n/**\n * Backward compatibility hook\n * This maintains the original API where useStepControl could be used as both\n * a context consumer and a creator depending on whether options were passed\n */\nexport function useStepControl(\n  options?: UseCreateStepControlOptions,\n): StepControlContextType {\n  // If options are provided, create step control state independently\n  if (options) {\n    return useCreateStepControl(options);\n  }\n\n  // Otherwise, consume context (original behavior)\n  return useStepControlContext();\n}\n\n/**\n * Hook to consume the step control context\n * @returns StepControlContextType - Step control methods and state\n * @throws Error if used outside StepControlProvider\n */\nexport function useStepControlContext() {\n  const context = useContext(StepControlContext);\n  if (context === undefined) {\n    throw new Error(\"useStepControl must be used within a StepControlProvider\");\n  }\n  return context;\n}\n"],"mappings":"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"}

package/dist/cjs/components/form/StepControlContext.d.cts

@@ -0,0 +1,200 @@
+import { NavigationType } from "../shared/types/header.cjs";
+import "../index.cjs";
+import React from "react";
+
+//#region src/components/form/StepControlContext.d.ts
+/**
+ * Interface for step control context values
+ */
+interface StepControlContextType {
+  /**
+   * Current active step index
+   */
+  currentStep: number;
+  /**
+   * Navigate to a specific step
+   * @param step - The step index to navigate to
+   */
+  goToStep: (step: number) => void;
+  /**
+   * Jump to a specific step without transition animation
+   * @param step - The step index to jump to
+   */
+  jumpTo: (step: number) => void;
+  /**
+   * Navigate to the next step
+   */
+  handleNext: () => Promise<void>;
+  /**
+   * Navigate to the previous step
+   */
+  handlePrevious: () => Promise<void>;
+  /**
+   * Retry the current step
+   */
+  handleRetry: () => Promise<void>;
+  /**
+   * Number of times the current step has been retried
+   */
+  retryCount: number;
+  /**
+   * Whether the current step is the first step
+   */
+  isFirstStep: boolean;
+  /**
+   * Whether the current step is the last step
+   */
+  isLastStep: boolean;
+  /**
+   * Total number of steps
+   */
+  totalSteps: number;
+  /**
+   * Transition state with navigation direction
+   */
+  transitionState: {
+    direction: "backward" | "forward" | null;
+    enteringStep: null | number;
+    exitingStep: null | number;
+  };
+}
+interface StepControlProviderProps {
+  children: React.ReactNode;
+  /**
+   * Default step to start on
+   */
+  defaultStep?: number;
+  /**
+   * Function to handle step submission
+   */
+  handleStepSubmit?: () => Promise<void>;
+  /**
+   * Whether to validate when going back steps
+   */
+  isBackValidate?: boolean;
+  /**
+   * Callback when step changes
+   */
+  onStepChange?: (step: number) => void;
+  /**
+   * Callback when step is retried
+   */
+  onStepRetry?: (step: number) => void;
+  /**
+   * Callback when navigation starts
+   */
+  onNavigationStart?: (fromStep: number, toStep: number, type: NavigationType) => void;
+  /**
+   * Callback when navigation ends successfully
+   */
+  onNavigationEnd?: (fromStep: number, toStep: number, type: NavigationType) => void;
+  /**
+   * Callback when navigation fails
+   */
+  onNavigationError?: (fromStep: number, toStep: number, type: NavigationType, error: any) => void;
+  /**
+   * Total number of steps
+   */
+  totalSteps?: number;
+  /**
+   * Function to trigger validation for the current step
+   */
+  triggerValidation?: () => Promise<boolean>;
+}
+/**
+ * Hook to create step control state independently
+ * This hook can be used outside of StepControlProvider
+ */
+interface UseCreateStepControlOptions {
+  /**
+   * Default step to start on
+   * @default 1
+   */
+  defaultStep?: number;
+  /**
+   * Function to handle step submission
+   */
+  handleStepSubmit?: () => Promise<void>;
+  /**
+   * Whether to validate when going back steps
+   * @default false
+   */
+  isBackValidate?: boolean;
+  /**
+   * Callback when step changes
+   */
+  onStepChange?: (step: number) => void;
+  /**
+   * Callback when step is retried
+   */
+  onStepRetry?: (step: number) => void;
+  /**
+   * Callback when navigation starts
+   */
+  onNavigationStart?: (fromStep: number, toStep: number, type: NavigationType) => void;
+  /**
+   * Callback when navigation ends successfully
+   */
+  onNavigationEnd?: (fromStep: number, toStep: number, type: NavigationType) => void;
+  /**
+   * Callback when navigation fails
+   */
+  onNavigationError?: (fromStep: number, toStep: number, type: NavigationType, error: any) => void;
+  /**
+   * Total number of steps
+   */
+  totalSteps: number;
+  /**
+   * Function to trigger validation for the current step
+   */
+  triggerValidation?: () => Promise<boolean>;
+}
+/**
+ * Provider component for step control functionality
+ * Handles step navigation logic and state management
+ */
+declare function StepControlProvider({
+  children,
+  defaultStep,
+  handleStepSubmit,
+  isBackValidate,
+  onStepChange,
+  onStepRetry,
+  onNavigationStart,
+  onNavigationEnd,
+  onNavigationError,
+  totalSteps,
+  triggerValidation
+}: StepControlProviderProps): any;
+declare function useCreateStepControl({
+  defaultStep,
+  handleStepSubmit,
+  isBackValidate,
+  onStepChange,
+  onStepRetry,
+  onNavigationStart,
+  onNavigationEnd,
+  onNavigationError,
+  totalSteps: totalStepsProp,
+  triggerValidation
+}: UseCreateStepControlOptions): StepControlContextType;
+/**
+ * Hook to optionally consume the step control context
+ * @returns StepControlContextType | undefined - Step control methods and state, or undefined if not in context
+ */
+declare function useOptionalStepControlContext(): any;
+/**
+ * Backward compatibility hook
+ * This maintains the original API where useStepControl could be used as both
+ * a context consumer and a creator depending on whether options were passed
+ */
+declare function useStepControl(options?: UseCreateStepControlOptions): StepControlContextType;
+/**
+ * Hook to consume the step control context
+ * @returns StepControlContextType - Step control methods and state
+ * @throws Error if used outside StepControlProvider
+ */
+declare function useStepControlContext(): any;
+//#endregion
+export { StepControlContextType, StepControlProvider, StepControlProviderProps, UseCreateStepControlOptions, useCreateStepControl, useOptionalStepControlContext, useStepControl, useStepControlContext };
+//# sourceMappingURL=StepControlContext.d.cts.map

package/dist/cjs/components/form/StepSchemaForm.cjs

@@ -0,0 +1,196 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_components_dialog_Dialog_types = require('../dialog/Dialog.types.cjs');
+const require_components_dialog_Dialog_context = require('../dialog/Dialog.context.cjs');
+const require_components_form_context = require('./context.cjs');
+const require_components_form_StepControlContext = require('./StepControlContext.cjs');
+const require_components_form_types = require('./types.cjs');
+const require_components_form_SchemaForm = require('./SchemaForm.cjs');
+const require_components_form_handlers_step = require('./handlers/step.cjs');
+const require_components_form_utils_stepRetry = require('./utils/stepRetry.cjs');
+const require_components_form_WizardStepContent = require('./WizardStepContent.cjs');
+const require_components_shared_types_form = require('../shared/types/form.cjs');
+const require_components_shared_environment_builders = require('../shared/environment/builders.cjs');
+const require_components_shared_UnifiedFooter = require('../shared/UnifiedFooter.cjs');
+const require_components_index = require('../index.cjs');
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/components/form/StepSchemaForm.tsx
+function StepSchemaForm({ closeDialog, config, onNavigationStart, onNavigationEnd, onNavigationError }) {
+	const { currentDialog, formMethods } = require_components_dialog_Dialog_context.useDialog();
+	const existingStepControl = require_components_form_StepControlContext.useOptionalStepControlContext();
+	if (existingStepControl && existingStepControl.totalSteps > 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StepSchemaFormContent, {
+		closeDialog,
+		config,
+		currentDialog,
+		formMethods,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_form_StepControlContext.StepControlProvider, {
+		defaultStep: config.stepBehavior?.defaultStep,
+		isBackValidate: config.stepBehavior?.isBackValidate,
+		onStepRetry: require_components_form_utils_stepRetry.createStepRetryHandler(config.steps),
+		totalSteps: config.steps.length,
+		onNavigationStart,
+		onNavigationEnd,
+		onNavigationError,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(StepSchemaFormContent, {
+			closeDialog,
+			config,
+			currentDialog,
+			formMethods,
+			onNavigationStart,
+			onNavigationEnd,
+			onNavigationError
+		})
+	});
+}
+function getStepFooterConfig(isActive, footerConfig, stepMethods, triggerSubmit) {
+	if (!isActive) return false;
+	if (footerConfig === false) return false;
+	return function StepFooterComponent(props) {
+		const { closeDialog, currentDialog, formMethods } = props;
+		return (footerConfig ?? defaultStepFormFooter)({
+			...stepMethods,
+			handleSubmit: triggerSubmit
+		}, formMethods?.current, closeDialog, currentDialog);
+	};
+}
+function StepSchemaFormContent({ closeDialog, config, formMethods, onNavigationStart, onNavigationEnd, onNavigationError }) {
+	const { currentStep, goToStep, jumpTo, handleNext, handlePrevious, handleRetry, isFirstStep, isLastStep, totalSteps, transitionState } = require_components_form_StepControlContext.useStepControl();
+	const triggerSubmit = (0, react.useCallback)(() => {
+		if (!formMethods?.current?.handleSubmit) return;
+		require_components_form_handlers_step.handleStepSubmission({
+			closeDialog,
+			config: {
+				...config,
+				onSuccess: require_components_form_handlers_step.getStepOnSuccessHandler(config, formMethods?.current, isLastStep, closeDialog)
+			},
+			currentStep,
+			formMethods: formMethods?.current,
+			goToNextStep: handleNext,
+			isLastStep,
+			stepConfig: config.steps[currentStep - 1]
+		});
+	}, [
+		formMethods?.current,
+		config,
+		currentStep,
+		isLastStep,
+		closeDialog,
+		handleNext
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "grid grid-cols-1 grid-rows-1",
+		children: (0, react.useMemo)(() => {
+			const stepMethods = {
+				currentStep,
+				goToStep,
+				jumpTo,
+				handleNext,
+				handlePrevious,
+				handleRetry,
+				isFirstStep,
+				isLastStep,
+				totalSteps
+			};
+			return config.steps.map((step, index) => {
+				const isActive = currentStep === index + 1;
+				const isExiting = transitionState.exitingStep === index + 1;
+				const isEntering = transitionState.enteringStep === index + 1;
+				const formConfig = {
+					...config,
+					fields: step.fields,
+					footer: getStepFooterConfig(isActive, config.footer, stepMethods, triggerSubmit),
+					validationSchema: step.validationSchema
+				};
+				const schemaForm = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_form_SchemaForm.SchemaForm, {
+					active: isActive,
+					closeDialog,
+					config: formConfig
+				});
+				const formContent = require_components_shared_types_form.isWizardForm(config) ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_form_WizardStepContent.WizardStepContent, {
+					className: "space-y-6",
+					description: step.description,
+					icon: step.icon,
+					isActive,
+					isEntering,
+					isExiting,
+					title: step.title,
+					children: schemaForm
+				}) : schemaForm;
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_form_context.FormProvider, {
+					adapter: config.adapter ?? require_components_form_types.AdapterType.RHF,
+					config: {
+						...formConfig,
+						steps: config.steps
+					},
+					formInstance: formMethods,
+					children: formContent
+				}, `step-${index}`);
+			});
+		}, [
+			config,
+			currentStep,
+			goToStep,
+			jumpTo,
+			handleNext,
+			handlePrevious,
+			handleRetry,
+			isFirstStep,
+			isLastStep,
+			totalSteps,
+			triggerSubmit,
+			closeDialog,
+			formMethods,
+			transitionState,
+			onNavigationStart,
+			onNavigationEnd,
+			onNavigationError
+		])
+	});
+}
+var defaultStepFormFooter;
+var init_StepSchemaForm = require_rolldown_runtime.__esmMin((() => {
+	require_components_form_types.init_types();
+	require_components_index.init_components();
+	require_components_form_context.init_context();
+	require_components_form_handlers_step.init_step();
+	require_components_form_SchemaForm.init_SchemaForm();
+	require_components_form_StepControlContext.init_StepControlContext();
+	require_components_form_utils_stepRetry.init_stepRetry();
+	require_components_form_WizardStepContent.init_WizardStepContent();
+	defaultStepFormFooter = (stepMethods, formMethods, currentDialog) => {
+		const footerEnvironment = require_components_shared_environment_builders.Environment.footer().standalone().stepForm({
+			isSubmitting: formMethods?.formState?.isSubmitting || false,
+			methods: formMethods
+		}).step({
+			current: stepMethods.currentStep,
+			isFirst: stepMethods.isFirstStep,
+			isLast: stepMethods.isLastStep,
+			jumpTo: stepMethods.jumpTo,
+			onNext: stepMethods.handleSubmit || stepMethods.handleNext,
+			onPrevious: stepMethods.handlePrevious,
+			onRetry: stepMethods.handleRetry,
+			total: stepMethods.totalSteps
+		}).build();
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_shared_UnifiedFooter.UnifiedFooter, {
+			config: require_components_dialog_Dialog_types.isFormDialog(currentDialog) || require_components_dialog_Dialog_types.isWizardDialogConfig(currentDialog) ? currentDialog.formConfig : currentDialog,
+			environment: footerEnvironment
+		});
+	};
+}));
+
+//#endregion
+init_StepSchemaForm();
+exports.StepSchemaForm = StepSchemaForm;
+Object.defineProperty(exports, 'init_StepSchemaForm', {
+  enumerable: true,
+  get: function () {
+    return init_StepSchemaForm;
+  }
+});
+//# sourceMappingURL=StepSchemaForm.cjs.map