@eifi1/ui-kit 0.7.0 → 0.8.0

package/dist/wizard/types.d.ts

@@ -25,12 +25,83 @@ interface WizardStepConfig {
      *   per-field error messages via `wizard.fieldErrors`.
      */
     validate?: () => ValidateResult | Promise<ValidateResult>;
+    /**
+     * The forward button's label on THIS step, in place of `labels.next` — "Analyse",
+     * "Import", "Send code". On the committing step (see {@link commits}) it labels
+     * Finish instead of `labels.finish`; `labels.submitting` still replaces it while
+     * the commit runs. Like `label`, a node the app has already translated.
+     */
+    nextLabel?: ReactNode;
+    /**
+     * This step's forward button COMMITS: it runs `onComplete` (via `finish`) instead
+     * of just advancing. Without the flag the last step commits, as it always has.
+     *
+     * Flag a step before the last and every step after it becomes a post-commit step —
+     * an import's "here is what happened, set up recurring rules?" page:
+     *  - a successful `onComplete` advances onto the next step (a failed one stays, with
+     *    `wizard.error`, exactly like a last-step Finish);
+     *  - from there Back, the indicator and `goBack`/`goToStep` cannot cross back over
+     *    the commit, and Cancel is hidden — there is nothing left to discard;
+     *  - the last post-commit step's button is Done, which calls `onDone` (and is not
+     *    shown when there is no `onDone`: the step then carries its own way out).
+     *
+     * Only the FIRST flagged step counts. Steps after it may still validate, skip and
+     * use `nextLabel` like any other.
+     */
+    commits?: boolean;
 }
+/**
+ * Where the active step lives. `true` (the default) mirrors it to `?step=N` through
+ * react-router, as every wizard before 0.8 did; `{ param }` renames that param (two
+ * wizards on one page, or a page that already uses `step`); `false` keeps it in
+ * memory only and needs no router at all.
+ *
+ * Read once, at mount: switching it on a mounted wizard has no effect.
+ */
+type WizardUrlSync = boolean | {
+    param?: string;
+};
 interface UseWizardOptions<TData extends Record<string, unknown>> {
     steps: WizardStepConfig[];
     initialData?: Partial<TData>;
     onComplete?: (data: TData) => void | Promise<void>;
     onCancel?: () => void;
+    /**
+     * Leave the wizard BACKWARDS: when given, Back is shown on the first step too and
+     * calls this — keksdose's import panel, whose first step's Back returns to the
+     * dropzone the file came from. No confirm dialog: going back is not discarding.
+     */
+    onExit?: () => void;
+    /**
+     * The Done button on the last step after a committing step (see
+     * {@link WizardStepConfig.commits}). Without it no Done button is rendered, and the
+     * post-commit step is expected to carry its own way out.
+     */
+    onDone?: () => void;
+    /**
+     * Whether the chrome offers Cancel at all. Default `true`. `false` hides the button
+     * (`wizard.canCancel` is false); `wizard.cancel()` still works if the app calls it.
+     */
+    cancellable?: boolean;
+    /**
+     * Whether Cancel asks first ("Discard this form?"). Default `true`. `false` makes
+     * `cancel()` call `onCancel` straight away — for a wizard that has nothing to lose
+     * yet, or one whose data is kept elsewhere.
+     */
+    confirmCancel?: boolean;
+    /**
+     * Mirror the active step to the URL. Default `true` (`?step=N`, needs a router).
+     * See {@link WizardUrlSync}.
+     *
+     * The param is WRITTEN only, never read back (see the note in `use-wizard.ts`). It
+     * is removed again when the wizard is left through the kit: a confirmed Cancel,
+     * `onExit` from the first step's Back, and Done — each before the app's callback
+     * runs, so an app that navigates away navigates from a clean URL. It is NOT removed
+     * after `onComplete` on a last step: an app navigating away there would otherwise
+     * be pulled back by the kit's own URL write. An app that stays on the page after a
+     * final Finish drops the param itself, or uses `urlSync: false`.
+     */
+    urlSync?: WizardUrlSync;
     /**
      * Shown when a step blocks with no per-field detail — an RHF step surfacing
      * its own inline messages, say — so the user learns why the wizard did not
@@ -52,14 +123,35 @@ interface UseWizardReturn<TData extends Record<string, unknown>> {
     steps: WizardStepConfig[];
     isFirstStep: boolean;
     isLastStep: boolean;
-    /** True once every step before the last has been completed or skipped. */
+    /** True once every step before the committing one (the last, unless a step is
+     *  flagged `commits`) has been completed or skipped. */
     canFinish: boolean;
+    /** The step whose forward button commits: the first `commits` step, else the last. */
+    commitStepIndex: number;
+    /** The active step is {@link commitStepIndex}: the chrome shows Finish, not Next. */
+    isCommitStep: boolean;
+    /** `onComplete` has resolved. Once the active step is past the committing one, Back
+     *  cannot cross it and Cancel is hidden. */
+    committed: boolean;
+    /** Whether Back is offered here: not on the first step unless `onExit` was given,
+     *  and never back across a commit. (Disabled, not hidden, while `isSubmitting`.) */
+    canGoBack: boolean;
+    /** Whether Cancel is offered: `cancellable`, and not after a commit. */
+    canCancel: boolean;
+    /** Whether Done is offered: the last step, past a commit, with an `onDone`. */
+    canDone: boolean;
+    /** Whether the indicator may jump to `index` — a completed/skipped/active step on
+     *  the right side of any commit. `goToStep` refuses anything this rejects. */
+    canGoToStep: (index: number) => boolean;
     goNext: () => Promise<void>;
+    /** One step back — or, on the first step, `onExit`. Refused while submitting. */
     goBack: () => void;
     goToStep: (index: number) => void;
     skip: () => void;
     cancel: () => void;
     finish: () => Promise<void>;
+    /** Leave after the post-commit steps: drops the URL param, then calls `onDone`. */
+    done: () => void;
     /** Register a validator for the mounted step (used by useRhfWizardStep). */
     registerStepValidate: (fn: () => ValidateResult | Promise<ValidateResult>) => () => void;
     /** True when the mounted step has blocked forward navigation (Next/Skip disabled). */
@@ -71,6 +163,9 @@ interface UseWizardReturn<TData extends Record<string, unknown>> {
     data: TData;
     updateData: (partial: Partial<TData>) => void;
     isSubmitting: boolean;
+    /** A `goNext`/`finish` is running the step's validators (an async server check,
+     *  say). The chrome shows Next pending — spinner, `aria-busy`, disabled. */
+    isValidating: boolean;
     error: string | null;
     clearError: () => void;
     fieldErrors: FieldErrors;
@@ -85,8 +180,12 @@ interface SummaryItem {
 }
 interface SummarySection {
     label: ReactNode;
-    /** Which step the section's edit button jumps back to. */
-    stepIndex: number;
+    /**
+     * Which step the section's edit button jumps back to. Leave it out for a section
+     * that belongs to no step — file-level counts, a total — and the card has no edit
+     * button, instead of borrowing one from whichever step it was parked under.
+     */
+    stepIndex?: number;
     items: SummaryItem[];
 }
 /**
@@ -131,10 +230,13 @@ interface WizardLabels {
     /** `wizard.error` when `onComplete` rejects with nothing readable — a thrown
      *  non-Error, or an Error whose message is empty. Optional: see above. */
     genericError?: string;
+    /** The button on the last step after a committing step (`onDone`). Optional: see
+     *  `missingRequired`. */
+    done?: string;
 }
 /** Typed with the two optional keys made required, so code reading the defaults
  *  directly (the fallback in `useWizard`) needs no `!`. */
-declare const DEFAULT_WIZARD_LABELS: WizardLabels & Required<Pick<WizardLabels, "missingRequired" | "genericError">>;
+declare const DEFAULT_WIZARD_LABELS: WizardLabels & Required<Pick<WizardLabels, "missingRequired" | "genericError" | "done">>;
 declare function resolveWizardLabels(labels?: Partial<WizardLabels>): WizardLabels;
 
-export { DEFAULT_WIZARD_LABELS, type FieldErrors, type StepStatus, type SummaryItem, type SummarySection, type UseWizardOptions, type UseWizardReturn, type ValidateResult, type WizardLabels, type WizardStepConfig, resolveWizardLabels };
+export { DEFAULT_WIZARD_LABELS, type FieldErrors, type StepStatus, type SummaryItem, type SummarySection, type UseWizardOptions, type UseWizardReturn, type ValidateResult, type WizardLabels, type WizardStepConfig, type WizardUrlSync, resolveWizardLabels };

package/dist/wizard/types.js

@@ -15,7 +15,8 @@ const DEFAULT_WIZARD_LABELS = {
   reviewTitle: "Review",
   edit: "Edit",
   missingRequired: "Please fill in all required fields.",
-  genericError: "An error occurred"
+  genericError: "An error occurred",
+  done: "Done"
 };
 function resolveWizardLabels(labels) {
   return labels ? { ...DEFAULT_WIZARD_LABELS, ...labels } : DEFAULT_WIZARD_LABELS;

package/dist/wizard/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wizard/types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nexport type FieldErrors = Record<string, string>;\n\nexport type ValidateResult = boolean | { ok: boolean; errors?: FieldErrors };\n\nexport interface WizardStepConfig {\n  /** Unique step identifier. */\n  id: string;\n  /**\n   * What the step is called in the indicator.\n   *\n   * A `ReactNode`, not a translation key: the engine never resolves strings.\n   * An app with i18n maps its own keys at the `useWizard` call — the same split\n   * `TourStep` and `DataTableLabels` already use.\n   */\n  label: ReactNode;\n  /** Whether the step can be skipped. */\n  optional?: boolean;\n  /**\n   * Validation gate before advancing.\n   * - Return `true` / `false` to just block.\n   * - Return `{ ok: false, errors: { fieldName: \"message\" } }` to also surface\n   *   per-field error messages via `wizard.fieldErrors`.\n   */\n  validate?: () => ValidateResult | Promise<ValidateResult>;\n}\n\nexport interface UseWizardOptions<TData extends Record<string, unknown>> {\n  steps: WizardStepConfig[];\n  initialData?: Partial<TData>;\n  onComplete?: (data: TData) => void | Promise<void>;\n  onCancel?: () => void;\n  /**\n   * Shown when a step blocks with no per-field detail — an RHF step surfacing\n   * its own inline messages, say — so the user learns why the wizard did not\n   * advance. Falls back to `wizard.missingRequired` from the {@link UiKitProvider},\n   * then to English.\n   */\n  missingRequiredMessage?: string;\n  /**\n   * How to surface {@link missingRequiredMessage}. Defaults to a `sonner` toast\n   * (an optional peer, imported only when this actually fires). Pass your own to\n   * route it somewhere else, or to a no-op to silence it.\n   */\n  onValidationFailed?: (message: string) => void;\n}\n\nexport type StepStatus = \"upcoming\" | \"active\" | \"completed\" | \"skipped\";\n\nexport interface UseWizardReturn<TData extends Record<string, unknown>> {\n  // Navigation\n  currentStepIndex: number;\n  currentStep: WizardStepConfig;\n  steps: WizardStepConfig[];\n  isFirstStep: boolean;\n  isLastStep: boolean;\n  /** True once every step before the last has been completed or skipped. */\n  canFinish: boolean;\n  goNext: () => Promise<void>;\n  goBack: () => void;\n  goToStep: (index: number) => void;\n  skip: () => void;\n  cancel: () => void;\n  finish: () => Promise<void>;\n  /** Register a validator for the mounted step (used by useRhfWizardStep). */\n  registerStepValidate: (\n    fn: () => ValidateResult | Promise<ValidateResult>,\n  ) => () => void;\n  /** True when the mounted step has blocked forward navigation (Next/Skip disabled). */\n  nextBlocked: boolean;\n  /** Set by the active step (via useWizardNextGate) to disable/enable Next+Skip. */\n  setNextBlocked: (blocked: boolean) => void;\n\n  // Step state\n  stepStatus: (index: number) => StepStatus;\n  completedSteps: Set<number>;\n\n  // Data\n  data: TData;\n  updateData: (partial: Partial<TData>) => void;\n\n  // Loading / error\n  isSubmitting: boolean;\n  error: string | null;\n  clearError: () => void;\n\n  // Per-field validation errors (populated by the last failed goNext)\n  fieldErrors: FieldErrors;\n  clearFieldErrors: () => void;\n\n  // Cancel dialog\n  showCancelDialog: boolean;\n  confirmCancel: () => void;\n  dismissCancel: () => void;\n}\n\nexport interface SummaryItem {\n  label: ReactNode;\n  value: ReactNode;\n}\n\nexport interface SummarySection {\n  label: ReactNode;\n  /** Which step the section's edit button jumps back to. */\n  stepIndex: number;\n  items: SummaryItem[];\n}\n\n/**\n * Every string the wizard chrome shows. All optional with English defaults, so a\n * monolingual app can mount `StepperNav` bare; a translated app passes the whole\n * object once (typically from a thin app-side wrapper).\n */\nexport interface WizardLabels {\n  cancel: string;\n  back: string;\n  next: string;\n  skip: string;\n  finish: string;\n  /** Shown on Finish while `isSubmitting`. */\n  submitting: string;\n  /** `aria-label` for the step indicator's `<nav>`. */\n  steps: string;\n  /** The mobile \"Step 2 of 5\" line. */\n  step: (current: number, total: number) => string;\n  /** Heading of the cancel-confirmation dialog. */\n  cancelTitle: string;\n  /** Body of the cancel-confirmation dialog. */\n  confirmCancel: string;\n  /** Confirm button in the cancel dialog. */\n  cancelConfirmLabel: string;\n  /** Dismiss button in the cancel dialog (\"keep editing\"). */\n  cancelDismissLabel: string;\n  /** Heading above a {@link WizardSummary}. */\n  reviewTitle: string;\n  /** `aria-label` on a summary section's edit button. */\n  edit: string;\n  /**\n   * Toasted (or handed to `onValidationFailed`) when a step blocks Next without\n   * saying which field is at fault. `useWizard`'s `missingRequiredMessage` wins.\n   *\n   * This and `genericError` are OPTIONAL, unlike every key above, for the reason\n   * `TwoFactorSettingLabels.qrAlt` is: apps annotate a full translation as\n   * `const DE: WizardLabels = {…}`, and a new required key would be a compile error\n   * in each of them on the next update. The defaults below always carry both.\n   */\n  missingRequired?: string;\n  /** `wizard.error` when `onComplete` rejects with nothing readable — a thrown\n   *  non-Error, or an Error whose message is empty. Optional: see above. */\n  genericError?: string;\n}\n\n/** Typed with the two optional keys made required, so code reading the defaults\n *  directly (the fallback in `useWizard`) needs no `!`. */\nexport const DEFAULT_WIZARD_LABELS: WizardLabels &\n  Required<Pick<WizardLabels, \"missingRequired\" | \"genericError\">> = {\n  cancel: \"Cancel\",\n  back: \"Back\",\n  next: \"Next\",\n  skip: \"Skip\",\n  finish: \"Finish\",\n  submitting: \"Creating…\",\n  steps: \"Steps\",\n  step: (current, total) => `Step ${current} of ${total}`,\n  cancelTitle: \"Discard this form?\",\n  confirmCancel: \"Your entries will be lost.\",\n  cancelConfirmLabel: \"Discard\",\n  cancelDismissLabel: \"Keep editing\",\n  reviewTitle: \"Review\",\n  edit: \"Edit\",\n  missingRequired: \"Please fill in all required fields.\",\n  genericError: \"An error occurred\",\n};\n\nexport function resolveWizardLabels(labels?: Partial<WizardLabels>): WizardLabels {\n  return labels ? { ...DEFAULT_WIZARD_LABELS, ...labels } : DEFAULT_WIZARD_LABELS;\n}\n"],"mappings":";AA2JO,MAAM,wBACwD;AAAA,EACnE,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,MAAM,CAAC,SAAS,UAAU,QAAQ,OAAO,OAAO,KAAK;AAAA,EACrD,aAAa;AAAA,EACb,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,MAAM;AAAA,EACN,iBAAiB;AAAA,EACjB,cAAc;AAChB;AAEO,SAAS,oBAAoB,QAA8C;AAChF,SAAO,SAAS,EAAE,GAAG,uBAAuB,GAAG,OAAO,IAAI;AAC5D;","names":[]}
+{"version":3,"sources":["../../src/wizard/types.ts"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nexport type FieldErrors = Record<string, string>;\n\nexport type ValidateResult = boolean | { ok: boolean; errors?: FieldErrors };\n\nexport interface WizardStepConfig {\n  /** Unique step identifier. */\n  id: string;\n  /**\n   * What the step is called in the indicator.\n   *\n   * A `ReactNode`, not a translation key: the engine never resolves strings.\n   * An app with i18n maps its own keys at the `useWizard` call — the same split\n   * `TourStep` and `DataTableLabels` already use.\n   */\n  label: ReactNode;\n  /** Whether the step can be skipped. */\n  optional?: boolean;\n  /**\n   * Validation gate before advancing.\n   * - Return `true` / `false` to just block.\n   * - Return `{ ok: false, errors: { fieldName: \"message\" } }` to also surface\n   *   per-field error messages via `wizard.fieldErrors`.\n   */\n  validate?: () => ValidateResult | Promise<ValidateResult>;\n  /**\n   * The forward button's label on THIS step, in place of `labels.next` — \"Analyse\",\n   * \"Import\", \"Send code\". On the committing step (see {@link commits}) it labels\n   * Finish instead of `labels.finish`; `labels.submitting` still replaces it while\n   * the commit runs. Like `label`, a node the app has already translated.\n   */\n  nextLabel?: ReactNode;\n  /**\n   * This step's forward button COMMITS: it runs `onComplete` (via `finish`) instead\n   * of just advancing. Without the flag the last step commits, as it always has.\n   *\n   * Flag a step before the last and every step after it becomes a post-commit step —\n   * an import's \"here is what happened, set up recurring rules?\" page:\n   *  - a successful `onComplete` advances onto the next step (a failed one stays, with\n   *    `wizard.error`, exactly like a last-step Finish);\n   *  - from there Back, the indicator and `goBack`/`goToStep` cannot cross back over\n   *    the commit, and Cancel is hidden — there is nothing left to discard;\n   *  - the last post-commit step's button is Done, which calls `onDone` (and is not\n   *    shown when there is no `onDone`: the step then carries its own way out).\n   *\n   * Only the FIRST flagged step counts. Steps after it may still validate, skip and\n   * use `nextLabel` like any other.\n   */\n  commits?: boolean;\n}\n\n/**\n * Where the active step lives. `true` (the default) mirrors it to `?step=N` through\n * react-router, as every wizard before 0.8 did; `{ param }` renames that param (two\n * wizards on one page, or a page that already uses `step`); `false` keeps it in\n * memory only and needs no router at all.\n *\n * Read once, at mount: switching it on a mounted wizard has no effect.\n */\nexport type WizardUrlSync = boolean | { param?: string };\n\nexport interface UseWizardOptions<TData extends Record<string, unknown>> {\n  steps: WizardStepConfig[];\n  initialData?: Partial<TData>;\n  onComplete?: (data: TData) => void | Promise<void>;\n  onCancel?: () => void;\n  /**\n   * Leave the wizard BACKWARDS: when given, Back is shown on the first step too and\n   * calls this — keksdose's import panel, whose first step's Back returns to the\n   * dropzone the file came from. No confirm dialog: going back is not discarding.\n   */\n  onExit?: () => void;\n  /**\n   * The Done button on the last step after a committing step (see\n   * {@link WizardStepConfig.commits}). Without it no Done button is rendered, and the\n   * post-commit step is expected to carry its own way out.\n   */\n  onDone?: () => void;\n  /**\n   * Whether the chrome offers Cancel at all. Default `true`. `false` hides the button\n   * (`wizard.canCancel` is false); `wizard.cancel()` still works if the app calls it.\n   */\n  cancellable?: boolean;\n  /**\n   * Whether Cancel asks first (\"Discard this form?\"). Default `true`. `false` makes\n   * `cancel()` call `onCancel` straight away — for a wizard that has nothing to lose\n   * yet, or one whose data is kept elsewhere.\n   */\n  confirmCancel?: boolean;\n  /**\n   * Mirror the active step to the URL. Default `true` (`?step=N`, needs a router).\n   * See {@link WizardUrlSync}.\n   *\n   * The param is WRITTEN only, never read back (see the note in `use-wizard.ts`). It\n   * is removed again when the wizard is left through the kit: a confirmed Cancel,\n   * `onExit` from the first step's Back, and Done — each before the app's callback\n   * runs, so an app that navigates away navigates from a clean URL. It is NOT removed\n   * after `onComplete` on a last step: an app navigating away there would otherwise\n   * be pulled back by the kit's own URL write. An app that stays on the page after a\n   * final Finish drops the param itself, or uses `urlSync: false`.\n   */\n  urlSync?: WizardUrlSync;\n  /**\n   * Shown when a step blocks with no per-field detail — an RHF step surfacing\n   * its own inline messages, say — so the user learns why the wizard did not\n   * advance. Falls back to `wizard.missingRequired` from the {@link UiKitProvider},\n   * then to English.\n   */\n  missingRequiredMessage?: string;\n  /**\n   * How to surface {@link missingRequiredMessage}. Defaults to a `sonner` toast\n   * (an optional peer, imported only when this actually fires). Pass your own to\n   * route it somewhere else, or to a no-op to silence it.\n   */\n  onValidationFailed?: (message: string) => void;\n}\n\nexport type StepStatus = \"upcoming\" | \"active\" | \"completed\" | \"skipped\";\n\nexport interface UseWizardReturn<TData extends Record<string, unknown>> {\n  // Navigation\n  currentStepIndex: number;\n  currentStep: WizardStepConfig;\n  steps: WizardStepConfig[];\n  isFirstStep: boolean;\n  isLastStep: boolean;\n  /** True once every step before the committing one (the last, unless a step is\n   *  flagged `commits`) has been completed or skipped. */\n  canFinish: boolean;\n  /** The step whose forward button commits: the first `commits` step, else the last. */\n  commitStepIndex: number;\n  /** The active step is {@link commitStepIndex}: the chrome shows Finish, not Next. */\n  isCommitStep: boolean;\n  /** `onComplete` has resolved. Once the active step is past the committing one, Back\n   *  cannot cross it and Cancel is hidden. */\n  committed: boolean;\n  /** Whether Back is offered here: not on the first step unless `onExit` was given,\n   *  and never back across a commit. (Disabled, not hidden, while `isSubmitting`.) */\n  canGoBack: boolean;\n  /** Whether Cancel is offered: `cancellable`, and not after a commit. */\n  canCancel: boolean;\n  /** Whether Done is offered: the last step, past a commit, with an `onDone`. */\n  canDone: boolean;\n  /** Whether the indicator may jump to `index` — a completed/skipped/active step on\n   *  the right side of any commit. `goToStep` refuses anything this rejects. */\n  canGoToStep: (index: number) => boolean;\n  goNext: () => Promise<void>;\n  /** One step back — or, on the first step, `onExit`. Refused while submitting. */\n  goBack: () => void;\n  goToStep: (index: number) => void;\n  skip: () => void;\n  cancel: () => void;\n  finish: () => Promise<void>;\n  /** Leave after the post-commit steps: drops the URL param, then calls `onDone`. */\n  done: () => void;\n  /** Register a validator for the mounted step (used by useRhfWizardStep). */\n  registerStepValidate: (\n    fn: () => ValidateResult | Promise<ValidateResult>,\n  ) => () => void;\n  /** True when the mounted step has blocked forward navigation (Next/Skip disabled). */\n  nextBlocked: boolean;\n  /** Set by the active step (via useWizardNextGate) to disable/enable Next+Skip. */\n  setNextBlocked: (blocked: boolean) => void;\n\n  // Step state\n  stepStatus: (index: number) => StepStatus;\n  completedSteps: Set<number>;\n\n  // Data\n  data: TData;\n  updateData: (partial: Partial<TData>) => void;\n\n  // Loading / error\n  isSubmitting: boolean;\n  /** A `goNext`/`finish` is running the step's validators (an async server check,\n   *  say). The chrome shows Next pending — spinner, `aria-busy`, disabled. */\n  isValidating: boolean;\n  error: string | null;\n  clearError: () => void;\n\n  // Per-field validation errors (populated by the last failed goNext)\n  fieldErrors: FieldErrors;\n  clearFieldErrors: () => void;\n\n  // Cancel dialog\n  showCancelDialog: boolean;\n  confirmCancel: () => void;\n  dismissCancel: () => void;\n}\n\nexport interface SummaryItem {\n  label: ReactNode;\n  value: ReactNode;\n}\n\nexport interface SummarySection {\n  label: ReactNode;\n  /**\n   * Which step the section's edit button jumps back to. Leave it out for a section\n   * that belongs to no step — file-level counts, a total — and the card has no edit\n   * button, instead of borrowing one from whichever step it was parked under.\n   */\n  stepIndex?: number;\n  items: SummaryItem[];\n}\n\n/**\n * Every string the wizard chrome shows. All optional with English defaults, so a\n * monolingual app can mount `StepperNav` bare; a translated app passes the whole\n * object once (typically from a thin app-side wrapper).\n */\nexport interface WizardLabels {\n  cancel: string;\n  back: string;\n  next: string;\n  skip: string;\n  finish: string;\n  /** Shown on Finish while `isSubmitting`. */\n  submitting: string;\n  /** `aria-label` for the step indicator's `<nav>`. */\n  steps: string;\n  /** The mobile \"Step 2 of 5\" line. */\n  step: (current: number, total: number) => string;\n  /** Heading of the cancel-confirmation dialog. */\n  cancelTitle: string;\n  /** Body of the cancel-confirmation dialog. */\n  confirmCancel: string;\n  /** Confirm button in the cancel dialog. */\n  cancelConfirmLabel: string;\n  /** Dismiss button in the cancel dialog (\"keep editing\"). */\n  cancelDismissLabel: string;\n  /** Heading above a {@link WizardSummary}. */\n  reviewTitle: string;\n  /** `aria-label` on a summary section's edit button. */\n  edit: string;\n  /**\n   * Toasted (or handed to `onValidationFailed`) when a step blocks Next without\n   * saying which field is at fault. `useWizard`'s `missingRequiredMessage` wins.\n   *\n   * This and `genericError` are OPTIONAL, unlike every key above, for the reason\n   * `TwoFactorSettingLabels.qrAlt` is: apps annotate a full translation as\n   * `const DE: WizardLabels = {…}`, and a new required key would be a compile error\n   * in each of them on the next update. The defaults below always carry both.\n   */\n  missingRequired?: string;\n  /** `wizard.error` when `onComplete` rejects with nothing readable — a thrown\n   *  non-Error, or an Error whose message is empty. Optional: see above. */\n  genericError?: string;\n  /** The button on the last step after a committing step (`onDone`). Optional: see\n   *  `missingRequired`. */\n  done?: string;\n}\n\n/** Typed with the two optional keys made required, so code reading the defaults\n *  directly (the fallback in `useWizard`) needs no `!`. */\nexport const DEFAULT_WIZARD_LABELS: WizardLabels &\n  Required<Pick<WizardLabels, \"missingRequired\" | \"genericError\" | \"done\">> = {\n  cancel: \"Cancel\",\n  back: \"Back\",\n  next: \"Next\",\n  skip: \"Skip\",\n  finish: \"Finish\",\n  submitting: \"Creating…\",\n  steps: \"Steps\",\n  step: (current, total) => `Step ${current} of ${total}`,\n  cancelTitle: \"Discard this form?\",\n  confirmCancel: \"Your entries will be lost.\",\n  cancelConfirmLabel: \"Discard\",\n  cancelDismissLabel: \"Keep editing\",\n  reviewTitle: \"Review\",\n  edit: \"Edit\",\n  missingRequired: \"Please fill in all required fields.\",\n  genericError: \"An error occurred\",\n  done: \"Done\",\n};\n\nexport function resolveWizardLabels(labels?: Partial<WizardLabels>): WizardLabels {\n  return labels ? { ...DEFAULT_WIZARD_LABELS, ...labels } : DEFAULT_WIZARD_LABELS;\n}\n"],"mappings":";AAgQO,MAAM,wBACiE;AAAA,EAC5E,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,MAAM,CAAC,SAAS,UAAU,QAAQ,OAAO,OAAO,KAAK;AAAA,EACrD,aAAa;AAAA,EACb,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,aAAa;AAAA,EACb,MAAM;AAAA,EACN,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,MAAM;AACR;AAEO,SAAS,oBAAoB,QAA8C;AAChF,SAAO,SAAS,EAAE,GAAG,uBAAuB,GAAG,OAAO,IAAI;AAC5D;","names":[]}

package/dist/wizard/use-wizard.js

@@ -3,6 +3,12 @@ import { useCallback, useEffect, useReducer, useRef, useState } from "react";
 import { useSearchParams } from "react-router";
 import { useKitLabels } from "../i18n/kit-labels.js";
 import { DEFAULT_WIZARD_LABELS } from "./types.js";
+function isAfterCommit(state) {
+  return state.committedStepIndex !== null && state.currentStepIndex > state.committedStepIndex;
+}
+function crossesCommit(state, index) {
+  return isAfterCommit(state) && index <= state.committedStepIndex;
+}
 function createReducer(stepCount) {
   return function reducer(state, action) {
     switch (action.type) {
@@ -15,10 +21,12 @@ function createReducer(stepCount) {
       }
       case "GO_BACK": {
         const prevIndex = Math.max(state.currentStepIndex - 1, 0);
+        if (crossesCommit(state, prevIndex)) return state;
         return { ...state, currentStepIndex: prevIndex, fieldErrors: {} };
       }
       case "GO_TO_STEP": {
         if (action.index < 0 || action.index >= stepCount) return state;
+        if (crossesCommit(state, action.index)) return state;
         if (!state.completedSteps.has(action.index) && action.index > state.currentStepIndex) {
           return state;
         }
@@ -38,8 +46,24 @@ function createReducer(stepCount) {
         }
         return { ...state, data: { ...state.data, ...action.partial }, fieldErrors: nextErrors };
       }
+      case "COMMITTED": {
+        const committed = { ...state, committedStepIndex: action.from };
+        if (action.from !== state.currentStepIndex || action.from >= stepCount - 1) {
+          return committed;
+        }
+        const completed = new Set(state.completedSteps);
+        completed.add(action.from);
+        return {
+          ...committed,
+          currentStepIndex: action.from + 1,
+          completedSteps: completed,
+          fieldErrors: {}
+        };
+      }
       case "SET_SUBMITTING":
         return { ...state, isSubmitting: action.value };
+      case "SET_VALIDATING":
+        return { ...state, isValidating: action.value };
       case "SET_ERROR":
         return { ...state, error: action.error };
       case "SET_FIELD_ERRORS":
@@ -52,7 +76,19 @@ function createReducer(stepCount) {
   };
 }
 function useWizard(options) {
-  const { steps, initialData, onComplete, onCancel, missingRequiredMessage, onValidationFailed } = options;
+  const {
+    steps,
+    initialData,
+    onComplete,
+    onCancel,
+    onExit,
+    onDone,
+    cancellable = true,
+    confirmCancel: askBeforeCancel = true,
+    urlSync = true,
+    missingRequiredMessage,
+    onValidationFailed
+  } = options;
   const stepsRef = useRef(steps);
   stepsRef.current = steps;
   const wizardLabels = useKitLabels("wizard", DEFAULT_WIZARD_LABELS, {
@@ -73,7 +109,10 @@ function useWizard(options) {
     },
     []
   );
-  const [, setUrlParams] = useSearchParams();
+  const [useStepUrl] = useState(() => urlSync === false ? useNoStepUrl : useSearchParamStepUrl);
+  const [urlParam] = useState(
+    () => typeof urlSync === "object" && urlSync.param ? urlSync.param : "step"
+  );
   const initialStep = 0;
   const reducer = createReducer(steps.length);
   const [state, dispatch] = useReducer(reducer, {
@@ -82,27 +121,31 @@ function useWizard(options) {
     skippedSteps: /* @__PURE__ */ new Set(),
     data: initialData ?? {},
     isSubmitting: false,
+    isValidating: false,
     error: null,
     fieldErrors: {},
-    showCancelDialog: false
+    showCancelDialog: false,
+    committedStepIndex: null
   });
   const [nextBlocked, setNextBlockedState] = useState(false);
   const setNextBlocked = useCallback(
     (blocked) => setNextBlockedState(blocked),
     []
   );
-  useEffect(() => {
-    setUrlParams((prev) => {
-      prev.set("step", String(state.currentStepIndex));
-      return prev;
-    }, { replace: true });
-  }, [state.currentStepIndex, setUrlParams]);
-  const currentStep = stepsRef.current[state.currentStepIndex];
+  const clearStepUrl = useStepUrl(urlParam, state.currentStepIndex);
+  const currentStep = steps[state.currentStepIndex];
   const isFirstStep = state.currentStepIndex === 0;
-  const isLastStep = state.currentStepIndex === stepsRef.current.length - 1;
-  const canFinish = stepsRef.current.every(
-    (_, index) => index === stepsRef.current.length - 1 || state.completedSteps.has(index) || state.skippedSteps.has(index)
+  const isLastStep = state.currentStepIndex === steps.length - 1;
+  const flagged = steps.findIndex((s) => s.commits);
+  const commitStepIndex = flagged === -1 ? steps.length - 1 : flagged;
+  const isCommitStep = state.currentStepIndex === commitStepIndex;
+  const afterCommit = isAfterCommit(state);
+  const canFinish = steps.every(
+    (_, index) => index >= commitStepIndex || state.completedSteps.has(index) || state.skippedSteps.has(index)
   );
+  const canGoBack = (!isFirstStep || onExit !== void 0) && !crossesCommit(state, state.currentStepIndex - 1);
+  const canCancel = cancellable && !afterCommit;
+  const canDone = isLastStep && afterCommit && onDone !== void 0;
   const runStepValidators = useCallback(async () => {
     const step = stepsRef.current[state.currentStepIndex];
     const validators = [...validatorsRef.current.values()];
@@ -145,31 +188,53 @@ function useWizard(options) {
     if (advancingRef.current) return;
     advancingRef.current = true;
     const from = state.currentStepIndex;
+    dispatch({ type: "SET_VALIDATING", value: true });
     try {
       if (await runStepValidators()) {
         dispatch({ type: "GO_NEXT", from });
       }
     } finally {
+      dispatch({ type: "SET_VALIDATING", value: false });
       advancingRef.current = false;
     }
   }, [runStepValidators, state.currentStepIndex]);
+  const submittingRef = useRef(false);
   const goBack = useCallback(() => {
+    if (submittingRef.current) return;
+    if (state.currentStepIndex === 0 && onExit) {
+      clearStepUrl();
+      onExit();
+      return;
+    }
     dispatch({ type: "GO_BACK" });
-  }, []);
+  }, [state.currentStepIndex, onExit, clearStepUrl]);
   const goToStep = useCallback((index) => {
     dispatch({ type: "GO_TO_STEP", index });
   }, []);
+  const canGoToStep = useCallback(
+    (index) => index >= 0 && index < steps.length && (index <= state.currentStepIndex || state.completedSteps.has(index)) && !crossesCommit(state, index),
+    [steps.length, state]
+  );
   const skip = useCallback(() => {
     if (advancingRef.current) return;
     dispatch({ type: "SKIP", from: state.currentStepIndex });
   }, [state.currentStepIndex]);
-  const cancel = useCallback(() => {
-    dispatch({ type: "SHOW_CANCEL_DIALOG", show: true });
-  }, []);
   const confirmCancel = useCallback(() => {
     dispatch({ type: "SHOW_CANCEL_DIALOG", show: false });
+    clearStepUrl();
     onCancel?.();
-  }, [onCancel]);
+  }, [onCancel, clearStepUrl]);
+  const cancel = useCallback(() => {
+    if (!askBeforeCancel) {
+      confirmCancel();
+      return;
+    }
+    dispatch({ type: "SHOW_CANCEL_DIALOG", show: true });
+  }, [askBeforeCancel, confirmCancel]);
+  const done = useCallback(() => {
+    clearStepUrl();
+    onDone?.();
+  }, [onDone, clearStepUrl]);
   const dismissCancel = useCallback(() => {
     dispatch({ type: "SHOW_CANCEL_DIALOG", show: false });
   }, []);
@@ -184,24 +249,46 @@ function useWizard(options) {
   }, []);
   const finish = useCallback(async () => {
     if (!onComplete || !canFinish) return;
+    if (commitStepIndex < steps.length - 1 && state.committedStepIndex !== null) return;
     if (advancingRef.current) return;
     advancingRef.current = true;
+    const from = state.currentStepIndex;
     try {
-      if (!await runStepValidators()) return;
+      dispatch({ type: "SET_VALIDATING", value: true });
+      let valid;
+      try {
+        valid = await runStepValidators();
+      } finally {
+        dispatch({ type: "SET_VALIDATING", value: false });
+      }
+      if (!valid) return;
+      submittingRef.current = true;
       dispatch({ type: "SET_SUBMITTING", value: true });
       dispatch({ type: "SET_ERROR", error: null });
       try {
         await onComplete(state.data);
+        dispatch({ type: "COMMITTED", from });
       } catch (err) {
         const message = err instanceof Error && err.message ? err.message : genericError;
         dispatch({ type: "SET_ERROR", error: message });
       } finally {
+        submittingRef.current = false;
         dispatch({ type: "SET_SUBMITTING", value: false });
       }
     } finally {
       advancingRef.current = false;
     }
-  }, [onComplete, canFinish, state.data, runStepValidators, genericError]);
+  }, [
+    onComplete,
+    canFinish,
+    commitStepIndex,
+    steps.length,
+    state.committedStepIndex,
+    state.currentStepIndex,
+    state.data,
+    runStepValidators,
+    genericError
+  ]);
   const stepStatus = useCallback(
     (index) => {
       if (index === state.currentStepIndex) return "active";
@@ -214,16 +301,24 @@ function useWizard(options) {
   return {
     currentStepIndex: state.currentStepIndex,
     currentStep,
-    steps: stepsRef.current,
+    steps,
     isFirstStep,
     isLastStep,
     canFinish,
+    commitStepIndex,
+    isCommitStep,
+    committed: state.committedStepIndex !== null,
+    canGoBack,
+    canCancel,
+    canDone,
+    canGoToStep,
     goNext,
     goBack,
     goToStep,
     skip,
     cancel,
     finish,
+    done,
     registerStepValidate,
     nextBlocked,
     setNextBlocked,
@@ -232,6 +327,7 @@ function useWizard(options) {
     data: state.data,
     updateData,
     isSubmitting: state.isSubmitting,
+    isValidating: state.isValidating,
     error: state.error,
     clearError,
     fieldErrors: state.fieldErrors,
@@ -241,6 +337,30 @@ function useWizard(options) {
     dismissCancel
   };
 }
+function useSearchParamStepUrl(param, index) {
+  const [, setUrlParams] = useSearchParams();
+  const leftRef = useRef(false);
+  useEffect(() => {
+    if (leftRef.current) return;
+    setUrlParams((prev) => {
+      prev.set(param, String(index));
+      return prev;
+    }, { replace: true });
+  }, [param, index, setUrlParams]);
+  return useCallback(() => {
+    if (leftRef.current) return;
+    leftRef.current = true;
+    setUrlParams((prev) => {
+      prev.delete(param);
+      return prev;
+    }, { replace: true });
+  }, [param, setUrlParams]);
+}
+function useNoStepUrl(_param, _index) {
+  return noop;
+}
+function noop() {
+}
 export {
   useWizard
 };

package/dist/wizard/use-wizard.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wizard/use-wizard.ts"],"sourcesContent":["/**\n * The multi-step wizard state machine: step index, completed/skipped sets,\n * per-step async validators, collected data, field errors, submit and the\n * cancel-confirm gate.\n *\n * Domain-free, but NOT router-free: it mirrors the active step to `?step=N`, so\n * it must be mounted inside a react-router context — the same requirement\n * `DataTable` already carries. It only ever WRITES that param (see the note on\n * `initialStep` below for why it deliberately does not read it back).\n */\nimport { useCallback, useEffect, useReducer, useRef, useState } from \"react\";\nimport { useSearchParams } from \"react-router\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { DEFAULT_WIZARD_LABELS } from \"./types\";\nimport type {\n  FieldErrors,\n  StepStatus,\n  UseWizardOptions,\n  UseWizardReturn,\n  ValidateResult,\n  WizardStepConfig,\n} from \"./types\";\n\ninterface WizardState<TData> {\n  currentStepIndex: number;\n  completedSteps: Set<number>;\n  skippedSteps: Set<number>;\n  data: TData;\n  isSubmitting: boolean;\n  error: string | null;\n  fieldErrors: FieldErrors;\n  showCancelDialog: boolean;\n}\n\ntype WizardAction<TData> =\n  // `from` is the step the move was decided ON. A move whose step is no longer the\n  // current one is stale — see `goNext` — and is dropped rather than applied relative\n  // to wherever the wizard has got to since.\n  | { type: \"GO_NEXT\"; from: number }\n  | { type: \"GO_BACK\" }\n  | { type: \"GO_TO_STEP\"; index: number }\n  | { type: \"SKIP\"; from: number }\n  | { type: \"UPDATE_DATA\"; partial: Partial<TData> }\n  | { type: \"SET_SUBMITTING\"; value: boolean }\n  | { type: \"SET_ERROR\"; error: string | null }\n  | { type: \"SET_FIELD_ERRORS\"; errors: FieldErrors }\n  | { type: \"SHOW_CANCEL_DIALOG\"; show: boolean };\n\nfunction createReducer<TData>(stepCount: number) {\n  return function reducer(\n    state: WizardState<TData>,\n    action: WizardAction<TData>,\n  ): WizardState<TData> {\n    switch (action.type) {\n      case \"GO_NEXT\": {\n        if (action.from !== state.currentStepIndex) return state;\n        const completed = new Set(state.completedSteps);\n        completed.add(state.currentStepIndex);\n        const nextIndex = Math.min(state.currentStepIndex + 1, stepCount - 1);\n        return { ...state, currentStepIndex: nextIndex, completedSteps: completed, fieldErrors: {} };\n      }\n      case \"GO_BACK\": {\n        const prevIndex = Math.max(state.currentStepIndex - 1, 0);\n        return { ...state, currentStepIndex: prevIndex, fieldErrors: {} };\n      }\n      case \"GO_TO_STEP\": {\n        if (action.index < 0 || action.index >= stepCount) return state;\n        if (!state.completedSteps.has(action.index) && action.index > state.currentStepIndex) {\n          return state;\n        }\n        return { ...state, currentStepIndex: action.index };\n      }\n      case \"SKIP\": {\n        if (action.from !== state.currentStepIndex) return state;\n        const skipped = new Set(state.skippedSteps);\n        skipped.add(state.currentStepIndex);\n        const nextIndex = Math.min(state.currentStepIndex + 1, stepCount - 1);\n        return { ...state, currentStepIndex: nextIndex, skippedSteps: skipped };\n      }\n      case \"UPDATE_DATA\": {\n        // Clear error for any field that is now being edited (so typing makes\n        // the red message disappear).\n        const nextErrors = { ...state.fieldErrors };\n        for (const key of Object.keys(action.partial)) {\n          delete nextErrors[key];\n        }\n        return { ...state, data: { ...state.data, ...action.partial }, fieldErrors: nextErrors };\n      }\n      case \"SET_SUBMITTING\":\n        return { ...state, isSubmitting: action.value };\n      case \"SET_ERROR\":\n        return { ...state, error: action.error };\n      case \"SET_FIELD_ERRORS\":\n        return { ...state, fieldErrors: action.errors };\n      case \"SHOW_CANCEL_DIALOG\":\n        return { ...state, showCancelDialog: action.show };\n      default:\n        return state;\n    }\n  };\n}\n\nexport function useWizard<TData extends Record<string, unknown>>(\n  options: UseWizardOptions<TData>,\n): UseWizardReturn<TData> {\n  const { steps, initialData, onComplete, onCancel, missingRequiredMessage, onValidationFailed } =\n    options;\n  const stepsRef = useRef<WizardStepConfig[]>(steps);\n  stepsRef.current = steps;\n  // A hook, not a component, but it produces two sentences of its own — the\n  // \"fill in the required fields\" toast and the fallback submit error — and both\n  // reach the user. So it reads the provider like any component does; only the two\n  // strings are depended on below, so the callbacks stay stable across renders.\n  // The `??` is for the type only: both keys are optional on `WizardLabels` (see\n  // there), and the merge never replaces a default with `undefined`.\n  const wizardLabels = useKitLabels(\"wizard\", DEFAULT_WIZARD_LABELS, {\n    missingRequired: missingRequiredMessage,\n  });\n  const missingRequired = wizardLabels.missingRequired ?? DEFAULT_WIZARD_LABELS.missingRequired;\n  const genericError = wizardLabels.genericError ?? DEFAULT_WIZARD_LABELS.genericError;\n\n  // Validators registered by the CURRENT step's mounted components (RHF steps\n  // register via `useRhfWizardStep` through the wizard context). Only the active\n  // step's validators are present — each unregisters on unmount. `goNext` and\n  // `finish` run them (via `runStepValidators`) alongside the step config's own\n  // `validate`.\n  const validatorsRef = useRef(\n    new Map<symbol, () => ValidateResult | Promise<ValidateResult>>(),\n  );\n  const registerStepValidate = useCallback(\n    (fn: () => ValidateResult | Promise<ValidateResult>) => {\n      const token = Symbol();\n      validatorsRef.current.set(token, fn);\n      return () => {\n        validatorsRef.current.delete(token);\n      };\n    },\n    [],\n  );\n\n  const [, setUrlParams] = useSearchParams();\n  // The wizard's entered `data` and `completedSteps` are NOT persisted across a\n  // reload / deep-link (the reducer re-inits to empty defaults on every mount).\n  // Restoring a later step index from `?step=N` would therefore leave the wizard\n  // on (or past) the last step with an EMPTY data set, letting Finish submit an\n  // empty payload. Always start at step 0 so a reload re-runs the wizard from a\n  // valid state instead of losing the entered data silently.\n  const initialStep = 0;\n\n  const reducer = createReducer<TData>(steps.length);\n  const [state, dispatch] = useReducer(reducer, {\n    currentStepIndex: initialStep,\n    completedSteps: new Set<number>(),\n    skippedSteps: new Set<number>(),\n    data: (initialData ?? {}) as TData,\n    isSubmitting: false,\n    error: null,\n    fieldErrors: {},\n    showCancelDialog: false,\n  });\n\n  // A mounted step can DISABLE forward navigation (Next/Skip) while its own\n  // state is invalid (e.g. tenant shares != 100%). Defaults to false, so\n  // wizards that never call setNextBlocked behave exactly as before.\n  const [nextBlocked, setNextBlockedState] = useState(false);\n  const setNextBlocked = useCallback(\n    (blocked: boolean) => setNextBlockedState(blocked),\n    [],\n  );\n\n  // Sync step index to URL\n  useEffect(() => {\n    setUrlParams((prev) => {\n      prev.set(\"step\", String(state.currentStepIndex));\n      return prev;\n    }, { replace: true });\n  }, [state.currentStepIndex, setUrlParams]);\n\n  const currentStep = stepsRef.current[state.currentStepIndex];\n  const isFirstStep = state.currentStepIndex === 0;\n  const isLastStep = state.currentStepIndex === stepsRef.current.length - 1;\n  // Finish is only valid once every step before the last has actually been\n  // walked through (completed or skipped). Guards against a restored/last-step\n  // index submitting a payload built from empty defaults.\n  const canFinish = stepsRef.current.every(\n    (_, index) =>\n      index === stepsRef.current.length - 1 ||\n      state.completedSteps.has(index) ||\n      state.skippedSteps.has(index),\n  );\n\n  // Runs the active step's config `validate` plus every validator its mounted\n  // components registered (RHF steps via useRhfWizardStep), AND-combining the\n  // results and merging any per-field errors. Returns `true` when the step\n  // passes (or registered no validators). Shared by `goNext` and `finish` so a\n  // form-bearing last step is validated (and its values flushed) on Finish too.\n  const runStepValidators = useCallback(async (): Promise<boolean> => {\n    const step = stepsRef.current[state.currentStepIndex];\n    const validators = [...validatorsRef.current.values()];\n    if (step.validate) validators.push(step.validate);\n    if (validators.length === 0) return true;\n    let ok = true;\n    let errors: FieldErrors = {};\n    try {\n      for (const validate of validators) {\n        const result = await validate();\n        const vOk = typeof result === \"boolean\" ? result : result.ok;\n        if (!vOk) {\n          ok = false;\n          if (typeof result !== \"boolean\" && result.errors) {\n            errors = { ...errors, ...result.errors };\n          }\n        }\n      }\n    } catch (err) {\n      // FALL THROUGH, do not return. A bare `return false` here blocked Next while\n      // skipping the `if (!ok)` block below — the only thing that shows a message,\n      // and whose own comment is \"say something anyway, so the user is not left with\n      // a Next button that silently does nothing\". So a validator that threw (an\n      // async one whose request rejected, a null dereference in a field rule)\n      // produced exactly the outcome that block was written to prevent: no field\n      // errors, no toast, `onValidationFailed` never called, nothing in the console.\n      //\n      // The step still must not advance; `ok = false` is what says so. Whatever\n      // partial `errors` the loop had collected before the throw are kept — they are\n      // real, and an empty set is what routes this to the generic message.\n      console.error(\"[wizard] a step validator threw\", err);\n      ok = false;\n    }\n    if (!ok) {\n      dispatch({ type: \"SET_FIELD_ERRORS\", errors });\n      if (Object.keys(errors).length === 0) {\n        // No per-field detail (e.g. an RHF step surfacing its own inline\n        // message) — say something anyway, so the user is not left with a Next\n        // button that silently does nothing.\n        const message = missingRequired;\n        if (onValidationFailed) {\n          onValidationFailed(message);\n        } else {\n          // sonner is an optional peer: imported here, on the failure path only,\n          // so an app that never trips this never has to install it.\n          const { toast } = await import(\"sonner\");\n          toast.error(message);\n        }\n      }\n      return false;\n    }\n    return true;\n  }, [state.currentStepIndex, missingRequired, onValidationFailed]);\n\n  /**\n   * One forward move at a time. A double-click on Next used to validate the CURRENT\n   * step twice and then advance twice — the second GO_NEXT landing on a step whose\n   * own validators never ran, so a required field two steps in could be walked past.\n   * Two layers, because either alone leaves a gap:\n   *\n   *  - this ref refuses a second `goNext`/`skip`/`finish` while one is in flight,\n   *    which covers an async validator (a server check) of any length;\n   *  - the `from` on each action drops a move decided on a step that is no longer\n   *    current, which covers the click that arrives after the first move resolved\n   *    but before React re-rendered — its closure still holds the old step index.\n   */\n  const advancingRef = useRef(false);\n\n  const goNext = useCallback(async () => {\n    if (advancingRef.current) return;\n    advancingRef.current = true;\n    const from = state.currentStepIndex;\n    try {\n      if (await runStepValidators()) {\n        dispatch({ type: \"GO_NEXT\", from });\n      }\n    } finally {\n      advancingRef.current = false;\n    }\n  }, [runStepValidators, state.currentStepIndex]);\n\n  const goBack = useCallback(() => {\n    dispatch({ type: \"GO_BACK\" });\n  }, []);\n\n  const goToStep = useCallback((index: number) => {\n    dispatch({ type: \"GO_TO_STEP\", index });\n  }, []);\n\n  const skip = useCallback(() => {\n    // Not while Next is validating: the skip would land first and the pending GO_NEXT\n    // would then be stale anyway — but the user asked for one move, not a race.\n    if (advancingRef.current) return;\n    dispatch({ type: \"SKIP\", from: state.currentStepIndex });\n  }, [state.currentStepIndex]);\n\n  const cancel = useCallback(() => {\n    dispatch({ type: \"SHOW_CANCEL_DIALOG\", show: true });\n  }, []);\n\n  const confirmCancel = useCallback(() => {\n    dispatch({ type: \"SHOW_CANCEL_DIALOG\", show: false });\n    onCancel?.();\n  }, [onCancel]);\n\n  const dismissCancel = useCallback(() => {\n    dispatch({ type: \"SHOW_CANCEL_DIALOG\", show: false });\n  }, []);\n\n  const updateData = useCallback((partial: Partial<TData>) => {\n    dispatch({ type: \"UPDATE_DATA\", partial });\n  }, []);\n\n  const clearError = useCallback(() => {\n    dispatch({ type: \"SET_ERROR\", error: null });\n  }, []);\n\n  const clearFieldErrors = useCallback(() => {\n    dispatch({ type: \"SET_FIELD_ERRORS\", errors: {} });\n  }, []);\n\n  const finish = useCallback(async () => {\n    if (!onComplete || !canFinish) return;\n    // The same re-entry guard as `goNext`: a double-click on Finish would otherwise\n    // validate twice and call `onComplete` twice — `isSubmitting` is only set once\n    // validation has passed, too late to stop the second click.\n    if (advancingRef.current) return;\n    advancingRef.current = true;\n    try {\n      // Validate the (possibly form-bearing) last step before submitting, matching\n      // the Next gate — review-only steps register no validators and pass through.\n      if (!(await runStepValidators())) return;\n      dispatch({ type: \"SET_SUBMITTING\", value: true });\n      dispatch({ type: \"SET_ERROR\", error: null });\n      try {\n        await onComplete(state.data);\n      } catch (err) {\n        const message = err instanceof Error && err.message ? err.message : genericError;\n        dispatch({ type: \"SET_ERROR\", error: message });\n      } finally {\n        dispatch({ type: \"SET_SUBMITTING\", value: false });\n      }\n    } finally {\n      advancingRef.current = false;\n    }\n  }, [onComplete, canFinish, state.data, runStepValidators, genericError]);\n\n  const stepStatus = useCallback(\n    (index: number): StepStatus => {\n      if (index === state.currentStepIndex) return \"active\";\n      if (state.skippedSteps.has(index)) return \"skipped\";\n      if (state.completedSteps.has(index)) return \"completed\";\n      return \"upcoming\";\n    },\n    [state.currentStepIndex, state.completedSteps, state.skippedSteps],\n  );\n\n  return {\n    currentStepIndex: state.currentStepIndex,\n    currentStep,\n    steps: stepsRef.current,\n    isFirstStep,\n    isLastStep,\n    canFinish,\n    goNext,\n    goBack,\n    goToStep,\n    skip,\n    cancel,\n    finish,\n    registerStepValidate,\n    nextBlocked,\n    setNextBlocked,\n    stepStatus,\n    completedSteps: state.completedSteps,\n    data: state.data,\n    updateData,\n    isSubmitting: state.isSubmitting,\n    error: state.error,\n    clearError,\n    fieldErrors: state.fieldErrors,\n    clearFieldErrors,\n    showCancelDialog: state.showCancelDialog,\n    confirmCancel,\n    dismissCancel,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/wizard/use-wizard.ts"],"sourcesContent":["/**\n * The multi-step wizard state machine: step index, completed/skipped sets,\n * per-step async validators, collected data, field errors, submit and the\n * cancel-confirm gate.\n *\n * Domain-free, and router-free on request. By default it mirrors the active step\n * to `?step=N`, so it must be mounted inside a react-router context — the same\n * requirement `DataTable` already carries. `urlSync: false` keeps the step in\n * memory and needs no router; `urlSync: { param }` renames the param. It only ever\n * WRITES that param (see the note on `initialStep` below for why it deliberately\n * does not read it back), and removes it when the wizard is left through the kit\n * (see `UseWizardOptions.urlSync`).\n *\n * The committing step is the last one unless a step says `commits: true`; the\n * steps after that one are post-commit steps (see `WizardStepConfig.commits`).\n */\nimport { useCallback, useEffect, useReducer, useRef, useState } from \"react\";\nimport { useSearchParams } from \"react-router\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { DEFAULT_WIZARD_LABELS } from \"./types\";\nimport type {\n  FieldErrors,\n  StepStatus,\n  UseWizardOptions,\n  UseWizardReturn,\n  ValidateResult,\n  WizardStepConfig,\n} from \"./types\";\n\ninterface WizardState<TData> {\n  currentStepIndex: number;\n  completedSteps: Set<number>;\n  skippedSteps: Set<number>;\n  data: TData;\n  isSubmitting: boolean;\n  isValidating: boolean;\n  error: string | null;\n  fieldErrors: FieldErrors;\n  showCancelDialog: boolean;\n  /** The step whose `onComplete` resolved, or null before any commit. */\n  committedStepIndex: number | null;\n}\n\n/** Past the commit: the active step comes after the step that committed. Moves to\n *  that step or any before it are refused from here. */\nfunction isAfterCommit(state: { currentStepIndex: number; committedStepIndex: number | null }) {\n  return state.committedStepIndex !== null && state.currentStepIndex > state.committedStepIndex;\n}\n\n/** Whether `index` is on the far side of a commit the wizard has already moved past. */\nfunction crossesCommit(\n  state: { currentStepIndex: number; committedStepIndex: number | null },\n  index: number,\n) {\n  return isAfterCommit(state) && index <= (state.committedStepIndex as number);\n}\n\ntype WizardAction<TData> =\n  // `from` is the step the move was decided ON. A move whose step is no longer the\n  // current one is stale — see `goNext` — and is dropped rather than applied relative\n  // to wherever the wizard has got to since.\n  | { type: \"GO_NEXT\"; from: number }\n  | { type: \"GO_BACK\" }\n  | { type: \"GO_TO_STEP\"; index: number }\n  | { type: \"SKIP\"; from: number }\n  | { type: \"UPDATE_DATA\"; partial: Partial<TData> }\n  | { type: \"COMMITTED\"; from: number }\n  | { type: \"SET_SUBMITTING\"; value: boolean }\n  | { type: \"SET_VALIDATING\"; value: boolean }\n  | { type: \"SET_ERROR\"; error: string | null }\n  | { type: \"SET_FIELD_ERRORS\"; errors: FieldErrors }\n  | { type: \"SHOW_CANCEL_DIALOG\"; show: boolean };\n\nfunction createReducer<TData>(stepCount: number) {\n  return function reducer(\n    state: WizardState<TData>,\n    action: WizardAction<TData>,\n  ): WizardState<TData> {\n    switch (action.type) {\n      case \"GO_NEXT\": {\n        if (action.from !== state.currentStepIndex) return state;\n        const completed = new Set(state.completedSteps);\n        completed.add(state.currentStepIndex);\n        const nextIndex = Math.min(state.currentStepIndex + 1, stepCount - 1);\n        return { ...state, currentStepIndex: nextIndex, completedSteps: completed, fieldErrors: {} };\n      }\n      case \"GO_BACK\": {\n        const prevIndex = Math.max(state.currentStepIndex - 1, 0);\n        if (crossesCommit(state, prevIndex)) return state;\n        return { ...state, currentStepIndex: prevIndex, fieldErrors: {} };\n      }\n      case \"GO_TO_STEP\": {\n        if (action.index < 0 || action.index >= stepCount) return state;\n        if (crossesCommit(state, action.index)) return state;\n        if (!state.completedSteps.has(action.index) && action.index > state.currentStepIndex) {\n          return state;\n        }\n        return { ...state, currentStepIndex: action.index };\n      }\n      case \"SKIP\": {\n        if (action.from !== state.currentStepIndex) return state;\n        const skipped = new Set(state.skippedSteps);\n        skipped.add(state.currentStepIndex);\n        const nextIndex = Math.min(state.currentStepIndex + 1, stepCount - 1);\n        return { ...state, currentStepIndex: nextIndex, skippedSteps: skipped };\n      }\n      case \"UPDATE_DATA\": {\n        // Clear error for any field that is now being edited (so typing makes\n        // the red message disappear).\n        const nextErrors = { ...state.fieldErrors };\n        for (const key of Object.keys(action.partial)) {\n          delete nextErrors[key];\n        }\n        return { ...state, data: { ...state.data, ...action.partial }, fieldErrors: nextErrors };\n      }\n      case \"COMMITTED\": {\n        // Recorded whatever step committed, so `wizard.committed` reads true after any\n        // successful Finish. Only a commit with steps after it MOVES: the default\n        // last-step commit stays where it is and looks exactly as it did before 0.8.\n        const committed = { ...state, committedStepIndex: action.from };\n        if (action.from !== state.currentStepIndex || action.from >= stepCount - 1) {\n          return committed;\n        }\n        const completed = new Set(state.completedSteps);\n        completed.add(action.from);\n        return {\n          ...committed,\n          currentStepIndex: action.from + 1,\n          completedSteps: completed,\n          fieldErrors: {},\n        };\n      }\n      case \"SET_SUBMITTING\":\n        return { ...state, isSubmitting: action.value };\n      case \"SET_VALIDATING\":\n        return { ...state, isValidating: action.value };\n      case \"SET_ERROR\":\n        return { ...state, error: action.error };\n      case \"SET_FIELD_ERRORS\":\n        return { ...state, fieldErrors: action.errors };\n      case \"SHOW_CANCEL_DIALOG\":\n        return { ...state, showCancelDialog: action.show };\n      default:\n        return state;\n    }\n  };\n}\n\nexport function useWizard<TData extends Record<string, unknown>>(\n  options: UseWizardOptions<TData>,\n): UseWizardReturn<TData> {\n  const {\n    steps,\n    initialData,\n    onComplete,\n    onCancel,\n    onExit,\n    onDone,\n    cancellable = true,\n    confirmCancel: askBeforeCancel = true,\n    urlSync = true,\n    missingRequiredMessage,\n    onValidationFailed,\n  } = options;\n  const stepsRef = useRef<WizardStepConfig[]>(steps);\n  stepsRef.current = steps;\n  // A hook, not a component, but it produces two sentences of its own — the\n  // \"fill in the required fields\" toast and the fallback submit error — and both\n  // reach the user. So it reads the provider like any component does; only the two\n  // strings are depended on below, so the callbacks stay stable across renders.\n  // The `??` is for the type only: both keys are optional on `WizardLabels` (see\n  // there), and the merge never replaces a default with `undefined`.\n  const wizardLabels = useKitLabels(\"wizard\", DEFAULT_WIZARD_LABELS, {\n    missingRequired: missingRequiredMessage,\n  });\n  const missingRequired = wizardLabels.missingRequired ?? DEFAULT_WIZARD_LABELS.missingRequired;\n  const genericError = wizardLabels.genericError ?? DEFAULT_WIZARD_LABELS.genericError;\n\n  // Validators registered by the CURRENT step's mounted components (RHF steps\n  // register via `useRhfWizardStep` through the wizard context). Only the active\n  // step's validators are present — each unregisters on unmount. `goNext` and\n  // `finish` run them (via `runStepValidators`) alongside the step config's own\n  // `validate`.\n  const validatorsRef = useRef(\n    new Map<symbol, () => ValidateResult | Promise<ValidateResult>>(),\n  );\n  const registerStepValidate = useCallback(\n    (fn: () => ValidateResult | Promise<ValidateResult>) => {\n      const token = Symbol();\n      validatorsRef.current.set(token, fn);\n      return () => {\n        validatorsRef.current.delete(token);\n      };\n    },\n    [],\n  );\n\n  // Chosen once, at mount: a hook may not be called conditionally, but it may be\n  // chosen once and then called unconditionally on every render — which is what\n  // makes `urlSync: false` work with no router above the wizard at all.\n  const [useStepUrl] = useState(() => (urlSync === false ? useNoStepUrl : useSearchParamStepUrl));\n  const [urlParam] = useState(() =>\n    typeof urlSync === \"object\" && urlSync.param ? urlSync.param : \"step\",\n  );\n  // The wizard's entered `data` and `completedSteps` are NOT persisted across a\n  // reload / deep-link (the reducer re-inits to empty defaults on every mount).\n  // Restoring a later step index from `?step=N` would therefore leave the wizard\n  // on (or past) the last step with an EMPTY data set, letting Finish submit an\n  // empty payload. Always start at step 0 so a reload re-runs the wizard from a\n  // valid state instead of losing the entered data silently.\n  const initialStep = 0;\n\n  const reducer = createReducer<TData>(steps.length);\n  const [state, dispatch] = useReducer(reducer, {\n    currentStepIndex: initialStep,\n    completedSteps: new Set<number>(),\n    skippedSteps: new Set<number>(),\n    data: (initialData ?? {}) as TData,\n    isSubmitting: false,\n    isValidating: false,\n    error: null,\n    fieldErrors: {},\n    showCancelDialog: false,\n    committedStepIndex: null,\n  });\n\n  // A mounted step can DISABLE forward navigation (Next/Skip) while its own\n  // state is invalid (e.g. tenant shares != 100%). Defaults to false, so\n  // wizards that never call setNextBlocked behave exactly as before.\n  const [nextBlocked, setNextBlockedState] = useState(false);\n  const setNextBlocked = useCallback(\n    (blocked: boolean) => setNextBlockedState(blocked),\n    [],\n  );\n\n  // Sync step index to URL (a no-op under `urlSync: false`). `clearStepUrl` drops\n  // the param when the wizard is left through the kit, and stops the sync writing\n  // it back.\n  const clearStepUrl = useStepUrl(urlParam, state.currentStepIndex);\n\n  // `steps`, not `stepsRef.current`: during render the two are the same array, and\n  // reading a ref in render is what the hooks linter (rightly) objects to.\n  const currentStep = steps[state.currentStepIndex];\n  const isFirstStep = state.currentStepIndex === 0;\n  const isLastStep = state.currentStepIndex === steps.length - 1;\n  // The step whose forward button commits: the first one flagged `commits`, else the\n  // last — which is every wizard written before the flag existed.\n  const flagged = steps.findIndex((s) => s.commits);\n  const commitStepIndex = flagged === -1 ? steps.length - 1 : flagged;\n  const isCommitStep = state.currentStepIndex === commitStepIndex;\n  const afterCommit = isAfterCommit(state);\n  // Finish is only valid once every step before the committing one has actually\n  // been walked through (completed or skipped). Guards against a restored/last-step\n  // index submitting a payload built from empty defaults.\n  const canFinish = steps.every(\n    (_, index) =>\n      index >= commitStepIndex ||\n      state.completedSteps.has(index) ||\n      state.skippedSteps.has(index),\n  );\n  const canGoBack =\n    (!isFirstStep || onExit !== undefined) &&\n    !crossesCommit(state, state.currentStepIndex - 1);\n  const canCancel = cancellable && !afterCommit;\n  const canDone = isLastStep && afterCommit && onDone !== undefined;\n\n  // Runs the active step's config `validate` plus every validator its mounted\n  // components registered (RHF steps via useRhfWizardStep), AND-combining the\n  // results and merging any per-field errors. Returns `true` when the step\n  // passes (or registered no validators). Shared by `goNext` and `finish` so a\n  // form-bearing last step is validated (and its values flushed) on Finish too.\n  const runStepValidators = useCallback(async (): Promise<boolean> => {\n    const step = stepsRef.current[state.currentStepIndex];\n    const validators = [...validatorsRef.current.values()];\n    if (step.validate) validators.push(step.validate);\n    if (validators.length === 0) return true;\n    let ok = true;\n    let errors: FieldErrors = {};\n    try {\n      for (const validate of validators) {\n        const result = await validate();\n        const vOk = typeof result === \"boolean\" ? result : result.ok;\n        if (!vOk) {\n          ok = false;\n          if (typeof result !== \"boolean\" && result.errors) {\n            errors = { ...errors, ...result.errors };\n          }\n        }\n      }\n    } catch (err) {\n      // FALL THROUGH, do not return. A bare `return false` here blocked Next while\n      // skipping the `if (!ok)` block below — the only thing that shows a message,\n      // and whose own comment is \"say something anyway, so the user is not left with\n      // a Next button that silently does nothing\". So a validator that threw (an\n      // async one whose request rejected, a null dereference in a field rule)\n      // produced exactly the outcome that block was written to prevent: no field\n      // errors, no toast, `onValidationFailed` never called, nothing in the console.\n      //\n      // The step still must not advance; `ok = false` is what says so. Whatever\n      // partial `errors` the loop had collected before the throw are kept — they are\n      // real, and an empty set is what routes this to the generic message.\n      console.error(\"[wizard] a step validator threw\", err);\n      ok = false;\n    }\n    if (!ok) {\n      dispatch({ type: \"SET_FIELD_ERRORS\", errors });\n      if (Object.keys(errors).length === 0) {\n        // No per-field detail (e.g. an RHF step surfacing its own inline\n        // message) — say something anyway, so the user is not left with a Next\n        // button that silently does nothing.\n        const message = missingRequired;\n        if (onValidationFailed) {\n          onValidationFailed(message);\n        } else {\n          // sonner is an optional peer: imported here, on the failure path only,\n          // so an app that never trips this never has to install it.\n          const { toast } = await import(\"sonner\");\n          toast.error(message);\n        }\n      }\n      return false;\n    }\n    return true;\n  }, [state.currentStepIndex, missingRequired, onValidationFailed]);\n\n  /**\n   * One forward move at a time. A double-click on Next used to validate the CURRENT\n   * step twice and then advance twice — the second GO_NEXT landing on a step whose\n   * own validators never ran, so a required field two steps in could be walked past.\n   * Two layers, because either alone leaves a gap:\n   *\n   *  - this ref refuses a second `goNext`/`skip`/`finish` while one is in flight,\n   *    which covers an async validator (a server check) of any length;\n   *  - the `from` on each action drops a move decided on a step that is no longer\n   *    current, which covers the click that arrives after the first move resolved\n   *    but before React re-rendered — its closure still holds the old step index.\n   */\n  const advancingRef = useRef(false);\n\n  const goNext = useCallback(async () => {\n    if (advancingRef.current) return;\n    advancingRef.current = true;\n    const from = state.currentStepIndex;\n    // Pending state for the chrome (spinner, aria-busy). The ref above is still what\n    // refuses the second click: state would only be seen after a re-render.\n    dispatch({ type: \"SET_VALIDATING\", value: true });\n    try {\n      if (await runStepValidators()) {\n        dispatch({ type: \"GO_NEXT\", from });\n      }\n    } finally {\n      dispatch({ type: \"SET_VALIDATING\", value: false });\n      advancingRef.current = false;\n    }\n  }, [runStepValidators, state.currentStepIndex]);\n\n  // Read by `goBack`, which must not move while `onComplete` runs: the commit was\n  // decided on the data of the step the user is on, and Back mid-commit would show a\n  // step whose edits can no longer reach it. The chrome disables the button too; this\n  // covers an app calling `goBack` itself.\n  const submittingRef = useRef(false);\n\n  const goBack = useCallback(() => {\n    if (submittingRef.current) return;\n    if (state.currentStepIndex === 0 && onExit) {\n      clearStepUrl();\n      onExit();\n      return;\n    }\n    // On step 0 with no `onExit` this stays the no-op move (clearing field errors) it\n    // always was.\n    dispatch({ type: \"GO_BACK\" });\n  }, [state.currentStepIndex, onExit, clearStepUrl]);\n\n  const goToStep = useCallback((index: number) => {\n    dispatch({ type: \"GO_TO_STEP\", index });\n  }, []);\n\n  const canGoToStep = useCallback(\n    (index: number) =>\n      index >= 0 &&\n      index < steps.length &&\n      (index <= state.currentStepIndex || state.completedSteps.has(index)) &&\n      !crossesCommit(state, index),\n    [steps.length, state],\n  );\n\n  const skip = useCallback(() => {\n    // Not while Next is validating: the skip would land first and the pending GO_NEXT\n    // would then be stale anyway — but the user asked for one move, not a race.\n    if (advancingRef.current) return;\n    dispatch({ type: \"SKIP\", from: state.currentStepIndex });\n  }, [state.currentStepIndex]);\n\n  const confirmCancel = useCallback(() => {\n    dispatch({ type: \"SHOW_CANCEL_DIALOG\", show: false });\n    clearStepUrl();\n    onCancel?.();\n  }, [onCancel, clearStepUrl]);\n\n  const cancel = useCallback(() => {\n    if (!askBeforeCancel) {\n      confirmCancel();\n      return;\n    }\n    dispatch({ type: \"SHOW_CANCEL_DIALOG\", show: true });\n  }, [askBeforeCancel, confirmCancel]);\n\n  const done = useCallback(() => {\n    clearStepUrl();\n    onDone?.();\n  }, [onDone, clearStepUrl]);\n\n  const dismissCancel = useCallback(() => {\n    dispatch({ type: \"SHOW_CANCEL_DIALOG\", show: false });\n  }, []);\n\n  const updateData = useCallback((partial: Partial<TData>) => {\n    dispatch({ type: \"UPDATE_DATA\", partial });\n  }, []);\n\n  const clearError = useCallback(() => {\n    dispatch({ type: \"SET_ERROR\", error: null });\n  }, []);\n\n  const clearFieldErrors = useCallback(() => {\n    dispatch({ type: \"SET_FIELD_ERRORS\", errors: {} });\n  }, []);\n\n  const finish = useCallback(async () => {\n    if (!onComplete || !canFinish) return;\n    // A commit with steps after it happens once: those steps exist because the\n    // data has been written. (A last-step commit keeps its old behaviour — the app\n    // may retry Finish after `onComplete` resolved, as it always could.)\n    if (commitStepIndex < steps.length - 1 && state.committedStepIndex !== null) return;\n    // The same re-entry guard as `goNext`: a double-click on Finish would otherwise\n    // validate twice and call `onComplete` twice — `isSubmitting` is only set once\n    // validation has passed, too late to stop the second click.\n    if (advancingRef.current) return;\n    advancingRef.current = true;\n    const from = state.currentStepIndex;\n    try {\n      // Validate the (possibly form-bearing) committing step before submitting,\n      // matching the Next gate — review-only steps register no validators and pass\n      // through.\n      dispatch({ type: \"SET_VALIDATING\", value: true });\n      let valid: boolean;\n      try {\n        valid = await runStepValidators();\n      } finally {\n        dispatch({ type: \"SET_VALIDATING\", value: false });\n      }\n      if (!valid) return;\n      submittingRef.current = true;\n      dispatch({ type: \"SET_SUBMITTING\", value: true });\n      dispatch({ type: \"SET_ERROR\", error: null });\n      try {\n        await onComplete(state.data);\n        dispatch({ type: \"COMMITTED\", from });\n      } catch (err) {\n        const message = err instanceof Error && err.message ? err.message : genericError;\n        dispatch({ type: \"SET_ERROR\", error: message });\n      } finally {\n        submittingRef.current = false;\n        dispatch({ type: \"SET_SUBMITTING\", value: false });\n      }\n    } finally {\n      advancingRef.current = false;\n    }\n  }, [\n    onComplete,\n    canFinish,\n    commitStepIndex,\n    steps.length,\n    state.committedStepIndex,\n    state.currentStepIndex,\n    state.data,\n    runStepValidators,\n    genericError,\n  ]);\n\n  const stepStatus = useCallback(\n    (index: number): StepStatus => {\n      if (index === state.currentStepIndex) return \"active\";\n      if (state.skippedSteps.has(index)) return \"skipped\";\n      if (state.completedSteps.has(index)) return \"completed\";\n      return \"upcoming\";\n    },\n    [state.currentStepIndex, state.completedSteps, state.skippedSteps],\n  );\n\n  return {\n    currentStepIndex: state.currentStepIndex,\n    currentStep,\n    steps,\n    isFirstStep,\n    isLastStep,\n    canFinish,\n    commitStepIndex,\n    isCommitStep,\n    committed: state.committedStepIndex !== null,\n    canGoBack,\n    canCancel,\n    canDone,\n    canGoToStep,\n    goNext,\n    goBack,\n    goToStep,\n    skip,\n    cancel,\n    finish,\n    done,\n    registerStepValidate,\n    nextBlocked,\n    setNextBlocked,\n    stepStatus,\n    completedSteps: state.completedSteps,\n    data: state.data,\n    updateData,\n    isSubmitting: state.isSubmitting,\n    isValidating: state.isValidating,\n    error: state.error,\n    clearError,\n    fieldErrors: state.fieldErrors,\n    clearFieldErrors,\n    showCancelDialog: state.showCancelDialog,\n    confirmCancel,\n    dismissCancel,\n  };\n}\n\n/**\n * `urlSync: true` / `{ param }`: mirror the active step to `?<param>=N`, and hand back\n * the function that removes it again. Once removed it stays removed — the sync effect\n * re-runs whenever react-router hands out a new setter (every search change), and\n * without the latch it would write the param straight back after the exit cleared it.\n */\nfunction useSearchParamStepUrl(param: string, index: number): () => void {\n  const [, setUrlParams] = useSearchParams();\n  const leftRef = useRef(false);\n  useEffect(() => {\n    if (leftRef.current) return;\n    setUrlParams((prev) => {\n      prev.set(param, String(index));\n      return prev;\n    }, { replace: true });\n  }, [param, index, setUrlParams]);\n  return useCallback(() => {\n    if (leftRef.current) return;\n    leftRef.current = true;\n    setUrlParams((prev) => {\n      prev.delete(param);\n      return prev;\n    }, { replace: true });\n  }, [param, setUrlParams]);\n}\n\n/** `urlSync: false`: the step lives in the reducer only. Touches no router context. */\nfunction useNoStepUrl(_param: string, _index: number): () => void {\n  return noop;\n}\n\nfunction noop() {}\n"],"mappings":"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","names":[]}