@eifi1/ui-kit 0.11.0 → 0.13.0

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, 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 { toast } from \"../components/toast\";\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          // The kit's `toast` loads sonner (an optional peer) lazily, so an app\n          // that never trips this never has to install it.\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":[]}
+{"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, useLayoutEffect, useReducer, useRef, useState } from \"react\";\nimport { useSearchParams } from \"react-router\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { DEFAULT_WIZARD_LABELS } from \"./types\";\nimport { toast } from \"../components/toast\";\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  // The latest `steps`, for the stable callbacks below. Synced after commit (before\n  // paint, and before any handler can run) rather than written during render.\n  const stepsRef = useRef<WizardStepConfig[]>(steps);\n  useLayoutEffect(() => {\n    stepsRef.current = steps;\n  }, [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`: reading a ref in render is what the hooks\n  // linter (rightly) objects to, and the ref only catches up after the commit.\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          // The kit's `toast` loads sonner (an optional peer) lazily, so an app\n          // that never trips this never has to install it.\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":[]}

package/dist/wizard/wizard-context.d.ts

@@ -21,5 +21,28 @@ declare function useWizardContext(): WizardContextValue;
  * `@eifi1/ui-kit/rhf`, whose returned `validate` a custom nav can call itself.
  */
 declare function useOptionalWizardContext(): WizardContextValue | null;
+/**
+ * Registers a plain validator for the mounted step — the counterpart to
+ * `useRhfWizardStep` (in `@eifi1/ui-kit/rhf`) for a step that gates on its own state
+ * (a hand-managed list of lines, a sum that has to balance) rather than a form.
+ *
+ * ```tsx
+ * useWizardStepValidate(() => ({ ok: lines.length >= 2, errors: { lines: t("…") } }));
+ * ```
+ *
+ * Next (and Finish) run it with the step's other validators; a `false` or a result
+ * with `ok: false` keeps the wizard where it is. `validate` is read through a ref, so
+ * an inline closure over the latest state registers exactly once. Throws outside a
+ * `<StepperNav>`, like {@link useWizardContext}: a validator with nothing to run it is
+ * a bug to hear about.
+ */
+declare function useWizardStepValidate(validate: () => ValidateResult | Promise<ValidateResult>): void;
+/**
+ * Disables the wizard's Next and Skip while `blocked` holds (tenant shares that do not
+ * add up to 100 %). Unlike {@link useWizardStepValidate}, which answers a click, this
+ * greys the button out before one. The gate is lifted again when the step unmounts, so
+ * the next step starts unblocked.
+ */
+declare function useWizardNextGate(blocked: boolean): void;
 
-export { WizardContextProvider, type WizardContextValue, useOptionalWizardContext, useWizardContext };
+export { WizardContextProvider, type WizardContextValue, useOptionalWizardContext, useWizardContext, useWizardNextGate, useWizardStepValidate };

package/dist/wizard/wizard-context.js

@@ -1,5 +1,5 @@
 "use client";
-import { createContext, useContext } from "react";
+import { createContext, useContext, useEffect, useRef } from "react";
 const WizardContext = createContext(null);
 const WizardContextProvider = WizardContext.Provider;
 function useWizardContext() {
@@ -12,9 +12,26 @@ function useWizardContext() {
 function useOptionalWizardContext() {
   return useContext(WizardContext);
 }
+function useWizardStepValidate(validate) {
+  const { registerStepValidate } = useWizardContext();
+  const ref = useRef(validate);
+  useEffect(() => {
+    ref.current = validate;
+  });
+  useEffect(() => registerStepValidate(() => ref.current()), [registerStepValidate]);
+}
+function useWizardNextGate(blocked) {
+  const { setNextBlocked } = useWizardContext();
+  useEffect(() => {
+    setNextBlocked(blocked);
+    return () => setNextBlocked(false);
+  }, [blocked, setNextBlocked]);
+}
 export {
   WizardContextProvider,
   useOptionalWizardContext,
-  useWizardContext
+  useWizardContext,
+  useWizardNextGate,
+  useWizardStepValidate
 };
 //# sourceMappingURL=wizard-context.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wizard/wizard-context.tsx"],"sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { ValidateResult } from \"./types\";\n\nexport interface WizardContextValue {\n  /**\n   * Register a validator for the currently-mounted step. Returns an unregister\n   * fn (call it in a useEffect cleanup). `goNext` runs every registered\n   * validator for the active step (plus the step config's own `validate`),\n   * AND-combining the results — this replaces the per-page `useRef` +\n   * `validate: () => ref.current?.()` bridge each RHF step used to wire.\n   */\n  registerStepValidate: (\n    fn: () => ValidateResult | Promise<ValidateResult>,\n  ) => () => void;\n  /** Lets the mounted step disable Next/Skip (e.g. invalid tenant shares). */\n  setNextBlocked: (blocked: boolean) => void;\n}\n\nconst WizardContext = createContext<WizardContextValue | null>(null);\n\nexport const WizardContextProvider = WizardContext.Provider;\n\nexport function useWizardContext(): WizardContextValue {\n  const ctx = useContext(WizardContext);\n  if (!ctx) {\n    throw new Error(\"useWizardContext must be used within a <StepperNav>\");\n  }\n  return ctx;\n}\n\n/**\n * The wizard context, or `null` outside a `<StepperNav>`. For a hook that registers\n * with the wizard when there is one and works without it — `useRhfWizardStep` in\n * `@eifi1/ui-kit/rhf`, whose returned `validate` a custom nav can call itself.\n */\nexport function useOptionalWizardContext(): WizardContextValue | null {\n  return useContext(WizardContext);\n}\n"],"mappings":";AAAA,SAAS,eAAe,kBAAkB;AAkB1C,MAAM,gBAAgB,cAAyC,IAAI;AAE5D,MAAM,wBAAwB,cAAc;AAE5C,SAAS,mBAAuC;AACrD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,SAAO;AACT;AAOO,SAAS,2BAAsD;AACpE,SAAO,WAAW,aAAa;AACjC;","names":[]}
+{"version":3,"sources":["../../src/wizard/wizard-context.tsx"],"sourcesContent":["import { createContext, useContext, useEffect, useRef } from \"react\";\nimport type { ValidateResult } from \"./types\";\n\nexport interface WizardContextValue {\n  /**\n   * Register a validator for the currently-mounted step. Returns an unregister\n   * fn (call it in a useEffect cleanup). `goNext` runs every registered\n   * validator for the active step (plus the step config's own `validate`),\n   * AND-combining the results — this replaces the per-page `useRef` +\n   * `validate: () => ref.current?.()` bridge each RHF step used to wire.\n   */\n  registerStepValidate: (\n    fn: () => ValidateResult | Promise<ValidateResult>,\n  ) => () => void;\n  /** Lets the mounted step disable Next/Skip (e.g. invalid tenant shares). */\n  setNextBlocked: (blocked: boolean) => void;\n}\n\nconst WizardContext = createContext<WizardContextValue | null>(null);\n\nexport const WizardContextProvider = WizardContext.Provider;\n\nexport function useWizardContext(): WizardContextValue {\n  const ctx = useContext(WizardContext);\n  if (!ctx) {\n    throw new Error(\"useWizardContext must be used within a <StepperNav>\");\n  }\n  return ctx;\n}\n\n/**\n * The wizard context, or `null` outside a `<StepperNav>`. For a hook that registers\n * with the wizard when there is one and works without it — `useRhfWizardStep` in\n * `@eifi1/ui-kit/rhf`, whose returned `validate` a custom nav can call itself.\n */\nexport function useOptionalWizardContext(): WizardContextValue | null {\n  return useContext(WizardContext);\n}\n\n/**\n * Registers a plain validator for the mounted step — the counterpart to\n * `useRhfWizardStep` (in `@eifi1/ui-kit/rhf`) for a step that gates on its own state\n * (a hand-managed list of lines, a sum that has to balance) rather than a form.\n *\n * ```tsx\n * useWizardStepValidate(() => ({ ok: lines.length >= 2, errors: { lines: t(\"…\") } }));\n * ```\n *\n * Next (and Finish) run it with the step's other validators; a `false` or a result\n * with `ok: false` keeps the wizard where it is. `validate` is read through a ref, so\n * an inline closure over the latest state registers exactly once. Throws outside a\n * `<StepperNav>`, like {@link useWizardContext}: a validator with nothing to run it is\n * a bug to hear about.\n */\nexport function useWizardStepValidate(\n  validate: () => ValidateResult | Promise<ValidateResult>,\n): void {\n  const { registerStepValidate } = useWizardContext();\n  const ref = useRef(validate);\n  useEffect(() => {\n    ref.current = validate;\n  });\n  useEffect(() => registerStepValidate(() => ref.current()), [registerStepValidate]);\n}\n\n/**\n * Disables the wizard's Next and Skip while `blocked` holds (tenant shares that do not\n * add up to 100 %). Unlike {@link useWizardStepValidate}, which answers a click, this\n * greys the button out before one. The gate is lifted again when the step unmounts, so\n * the next step starts unblocked.\n */\nexport function useWizardNextGate(blocked: boolean): void {\n  const { setNextBlocked } = useWizardContext();\n  useEffect(() => {\n    setNextBlocked(blocked);\n    return () => setNextBlocked(false);\n  }, [blocked, setNextBlocked]);\n}\n"],"mappings":";AAAA,SAAS,eAAe,YAAY,WAAW,cAAc;AAkB7D,MAAM,gBAAgB,cAAyC,IAAI;AAE5D,MAAM,wBAAwB,cAAc;AAE5C,SAAS,mBAAuC;AACrD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,SAAO;AACT;AAOO,SAAS,2BAAsD;AACpE,SAAO,WAAW,aAAa;AACjC;AAiBO,SAAS,sBACd,UACM;AACN,QAAM,EAAE,qBAAqB,IAAI,iBAAiB;AAClD,QAAM,MAAM,OAAO,QAAQ;AAC3B,YAAU,MAAM;AACd,QAAI,UAAU;AAAA,EAChB,CAAC;AACD,YAAU,MAAM,qBAAqB,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC;AACnF;AAQO,SAAS,kBAAkB,SAAwB;AACxD,QAAM,EAAE,eAAe,IAAI,iBAAiB;AAC5C,YAAU,MAAM;AACd,mBAAe,OAAO;AACtB,WAAO,MAAM,eAAe,KAAK;AAAA,EACnC,GAAG,CAAC,SAAS,cAAc,CAAC;AAC9B;","names":[]}

package/dist/wizard/wizard-step.d.ts

@@ -1,11 +1,36 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 
-/** The vertical rhythm one wizard step's content sits on. A component rather
- *  than a class string so every step in every app spaces its fields the same. */
-declare function WizardStep({ children, className, }: {
+interface WizardStepProps {
     children: ReactNode;
     className?: string;
-}): react.JSX.Element;
+    /**
+     * The step's heading ("Choose a unit"), drawn in the one style every step shares.
+     * kastlan's steps each hand-wrote `<h3 className="text-lg font-semibold">` (about
+     * sixteen of them: lease-picker-step, lease-unit-step, …), and a hand-written
+     * heading is one that drifts — a size here, a colour there. Omitted: no heading.
+     */
+    title?: ReactNode;
+    /** The line under the title: what the step asks for, or why. Rendered only with a
+     *  `title` or on its own when there is none. */
+    description?: ReactNode;
+    /**
+     * Controls for the step as a whole, at the end of the header row beside the title —
+     * kastlan 43: the buildings step's "Add building" had nowhere to go but UNDER the
+     * list it adds to, where it falls below the fold once there are three buildings.
+     * A header action is where every other kit surface (`PageHeader`, `Card`) puts it.
+     *
+     * Wraps under the title on a narrow screen rather than squeezing it. Renders the
+     * header on its own if there is no `title` either.
+     */
+    actions?: ReactNode;
+    /** The heading's level. Default 3: the page has its `h1` and the wizard's own
+     *  chrome sits at `h2` (the review step, the cancel dialog), so a step is under it. */
+    headingLevel?: 2 | 3 | 4;
+}
+/** The vertical rhythm one wizard step's content sits on. A component rather
+ *  than a class string so every step in every app spaces its fields the same —
+ *  and, with `title` / `description`, heads them the same. */
+declare function WizardStep({ children, className, title, description, headingLevel, actions, }: WizardStepProps): react.JSX.Element;
 
-export { WizardStep };
+export { WizardStep, type WizardStepProps };

package/dist/wizard/wizard-step.js

@@ -1,11 +1,42 @@
 "use client";
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { cn } from "../lib/cn.js";
+const HEADING = { 2: "h2", 3: "h3", 4: "h4" };
 function WizardStep({
   children,
-  className
+  className,
+  title,
+  description,
+  headingLevel = 3,
+  actions
 }) {
-  return /* @__PURE__ */ jsx("div", { className: cn("space-y-6", className), children });
+  const hasTitle = title !== void 0 && title !== null && title !== false && title !== "";
+  const hasDescription = description !== void 0 && description !== null && description !== false && description !== "";
+  const hasActions = actions !== void 0 && actions !== null && actions !== false && actions !== "";
+  const Heading = HEADING[headingLevel];
+  const heading = /* @__PURE__ */ jsxs(Fragment, { children: [
+    hasTitle && /* @__PURE__ */ jsx(Heading, { className: "text-lg font-semibold text-[var(--text-primary)]", children: title }),
+    hasDescription && /* @__PURE__ */ jsx("p", { className: "text-sm text-[var(--text-muted)]", children: description })
+  ] });
+  return /* @__PURE__ */ jsxs("div", { className: cn("space-y-6", className), children: [
+    hasActions ? (
+      // One row: the text takes the room, the actions keep their width at the end
+      // and wrap below it when there is not enough — `basis-64` is the width the
+      // title asks for before that happens (a zero basis would never wrap and
+      // squeeze the title to a word a line instead). `items-start` so a two-line
+      // description does not pull the button down to its middle; `ms-auto` keeps
+      // the actions at the end with no title, and when they wrap.
+      /* @__PURE__ */ jsxs("div", { "data-slot": "wizard-step-header", className: "flex flex-wrap items-start justify-between gap-x-4 gap-y-2", children: [
+        (hasTitle || hasDescription) && /* @__PURE__ */ jsx("div", { className: "min-w-0 grow basis-64 space-y-1", children: heading }),
+        /* @__PURE__ */ jsx("div", { "data-slot": "wizard-step-actions", className: "ms-auto flex shrink-0 flex-wrap items-center gap-2", children: actions })
+      ] })
+    ) : (
+      // Without actions the header is exactly what it was, so a step that passes
+      // none renders as before.
+      (hasTitle || hasDescription) && /* @__PURE__ */ jsx("div", { "data-slot": "wizard-step-header", className: "space-y-1", children: heading })
+    ),
+    children
+  ] });
 }
 export {
   WizardStep

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wizard/wizard-step.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\n\n/** The vertical rhythm one wizard step's content sits on. A component rather\n *  than a class string so every step in every app spaces its fields the same. */\nexport function WizardStep({\n  children,\n  className,\n}: {\n  children: ReactNode;\n  className?: string;\n}) {\n  return <div className={cn(\"space-y-6\", className)}>{children}</div>;\n}\n"],"mappings":";AAYS;AAXT,SAAS,UAAU;AAIZ,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AACF,GAGG;AACD,SAAO,oBAAC,SAAI,WAAW,GAAG,aAAa,SAAS,GAAI,UAAS;AAC/D;","names":[]}
+{"version":3,"sources":["../../src/wizard/wizard-step.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\n\nexport interface WizardStepProps {\n  children: ReactNode;\n  className?: string;\n  /**\n   * The step's heading (\"Choose a unit\"), drawn in the one style every step shares.\n   * kastlan's steps each hand-wrote `<h3 className=\"text-lg font-semibold\">` (about\n   * sixteen of them: lease-picker-step, lease-unit-step, …), and a hand-written\n   * heading is one that drifts — a size here, a colour there. Omitted: no heading.\n   */\n  title?: ReactNode;\n  /** The line under the title: what the step asks for, or why. Rendered only with a\n   *  `title` or on its own when there is none. */\n  description?: ReactNode;\n  /**\n   * Controls for the step as a whole, at the end of the header row beside the title —\n   * kastlan 43: the buildings step's \"Add building\" had nowhere to go but UNDER the\n   * list it adds to, where it falls below the fold once there are three buildings.\n   * A header action is where every other kit surface (`PageHeader`, `Card`) puts it.\n   *\n   * Wraps under the title on a narrow screen rather than squeezing it. Renders the\n   * header on its own if there is no `title` either.\n   */\n  actions?: ReactNode;\n  /** The heading's level. Default 3: the page has its `h1` and the wizard's own\n   *  chrome sits at `h2` (the review step, the cancel dialog), so a step is under it. */\n  headingLevel?: 2 | 3 | 4;\n}\n\nconst HEADING = { 2: \"h2\", 3: \"h3\", 4: \"h4\" } as const;\n\n/** The vertical rhythm one wizard step's content sits on. A component rather\n *  than a class string so every step in every app spaces its fields the same —\n *  and, with `title` / `description`, heads them the same. */\nexport function WizardStep({\n  children,\n  className,\n  title,\n  description,\n  headingLevel = 3,\n  actions,\n}: WizardStepProps) {\n  const hasTitle = title !== undefined && title !== null && title !== false && title !== \"\";\n  const hasDescription =\n    description !== undefined && description !== null && description !== false && description !== \"\";\n  const hasActions = actions !== undefined && actions !== null && actions !== false && actions !== \"\";\n  const Heading = HEADING[headingLevel];\n  const heading = (\n    <>\n      {hasTitle && <Heading className=\"text-lg font-semibold text-[var(--text-primary)]\">{title}</Heading>}\n      {hasDescription && <p className=\"text-sm text-[var(--text-muted)]\">{description}</p>}\n    </>\n  );\n  return (\n    <div className={cn(\"space-y-6\", className)}>\n      {hasActions ? (\n        // One row: the text takes the room, the actions keep their width at the end\n        // and wrap below it when there is not enough — `basis-64` is the width the\n        // title asks for before that happens (a zero basis would never wrap and\n        // squeeze the title to a word a line instead). `items-start` so a two-line\n        // description does not pull the button down to its middle; `ms-auto` keeps\n        // the actions at the end with no title, and when they wrap.\n        <div data-slot=\"wizard-step-header\" className=\"flex flex-wrap items-start justify-between gap-x-4 gap-y-2\">\n          {(hasTitle || hasDescription) && <div className=\"min-w-0 grow basis-64 space-y-1\">{heading}</div>}\n          <div data-slot=\"wizard-step-actions\" className=\"ms-auto flex shrink-0 flex-wrap items-center gap-2\">\n            {actions}\n          </div>\n        </div>\n      ) : (\n        // Without actions the header is exactly what it was, so a step that passes\n        // none renders as before.\n        (hasTitle || hasDescription) && (\n          <div data-slot=\"wizard-step-header\" className=\"space-y-1\">\n            {heading}\n          </div>\n        )\n      )}\n      {children}\n    </div>\n  );\n}\n"],"mappings":";AAkDI,mBACe,KADf;AAjDJ,SAAS,UAAU;AA8BnB,MAAM,UAAU,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK;AAKrC,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf;AACF,GAAoB;AAClB,QAAM,WAAW,UAAU,UAAa,UAAU,QAAQ,UAAU,SAAS,UAAU;AACvF,QAAM,iBACJ,gBAAgB,UAAa,gBAAgB,QAAQ,gBAAgB,SAAS,gBAAgB;AAChG,QAAM,aAAa,YAAY,UAAa,YAAY,QAAQ,YAAY,SAAS,YAAY;AACjG,QAAM,UAAU,QAAQ,YAAY;AACpC,QAAM,UACJ,iCACG;AAAA,gBAAY,oBAAC,WAAQ,WAAU,oDAAoD,iBAAM;AAAA,IACzF,kBAAkB,oBAAC,OAAE,WAAU,oCAAoC,uBAAY;AAAA,KAClF;AAEF,SACE,qBAAC,SAAI,WAAW,GAAG,aAAa,SAAS,GACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOC,qBAAC,SAAI,aAAU,sBAAqB,WAAU,8DAC1C;AAAA,qBAAY,mBAAmB,oBAAC,SAAI,WAAU,mCAAmC,mBAAQ;AAAA,QAC3F,oBAAC,SAAI,aAAU,uBAAsB,WAAU,sDAC5C,mBACH;AAAA,SACF;AAAA;AAAA;AAAA;AAAA,OAIC,YAAY,mBACX,oBAAC,SAAI,aAAU,sBAAqB,WAAU,aAC3C,mBACH;AAAA;AAAA,IAGH;AAAA,KACH;AAEJ;","names":[]}

package/dist/wizard.d.ts

@@ -1,12 +1,59 @@
 export { DEFAULT_WIZARD_LABELS, FieldErrors, StepStatus, SummaryItem, SummarySection, UseWizardOptions, UseWizardReturn, ValidateResult, WizardLabels, WizardStepConfig, WizardUrlSync, resolveWizardLabels } from './wizard/types.js';
 export { useWizard } from './wizard/use-wizard.js';
-export { WizardContextProvider, WizardContextValue, useOptionalWizardContext, useWizardContext } from './wizard/wizard-context.js';
+export { WizardContextProvider, WizardContextValue, useOptionalWizardContext, useWizardContext, useWizardNextGate, useWizardStepValidate } from './wizard/wizard-context.js';
 export { RequiredFieldSpec, requiredFieldsValidator } from './wizard/validation.js';
-export { WizardStep } from './wizard/wizard-step.js';
+export { WizardStep, WizardStepProps } from './wizard/wizard-step.js';
 export { WizardSummary } from './wizard/wizard-summary.js';
 export { StepperNav } from './wizard/stepper-nav.js';
 import 'react';
-import './components/ui.js';
+import './kit-labels-Mz8zZHIF.js';
+import './components/data-table-labels.js';
+import './components/mini-calendar.js';
+import './components/calendar-heatmap.js';
+import './components/popover.js';
+import './components/chip.js';
+import 'lucide-react';
+import './components/field-sync.js';
 import './components/tooltip.js';
 import './hooks/use-anchored-rect.js';
 import './lib/clipping.js';
+import './tour/tour.js';
+import './search/command-palette.js';
+import './search/global-search.js';
+import './search/search-index.js';
+import './components/month-picker.js';
+import './components/page-contents.js';
+import './components/series-chart-labels.js';
+import './components/pie-chart-labels.js';
+import './components/sparkline.js';
+import './components/stat-tile.js';
+import './components/signature-pad.js';
+import './components/password-strength.js';
+import './components/danger-confirm.js';
+import './components/swatch-picker.js';
+import './components/tile-radio.js';
+import './components/icon-picker.js';
+import './components/dialog-frame.js';
+import './components/modal.js';
+import './hooks/use-search-param-state.js';
+import './components/measured-grid.js';
+import './feedback/feedback-attachment.js';
+import './feedback/feedback-dialog.js';
+import './feedback/feedback-thread.js';
+import './feedback/feedback-inbox.js';
+import './components/account-settings-labels.js';
+import './components/confirm-dialog.js';
+import './components/floating-panel.js';
+import './components/bulk-action-bar.js';
+import './components/list.js';
+import './components/breadcrumbs.js';
+import './components/toast.js';
+import './components/description-list.js';
+import './components/line-items.js';
+import './components/progress-bar.js';
+import './components/signed-amount.js';
+import './components/error-boundary.js';
+import './components/authed-image.js';
+import './hooks/use-authed-src.js';
+import './components/image-grid.js';
+import './components/lightbox.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eifi1/ui-kit",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "type": "module",
   "description": "App-agnostic shared design system: domain-free React components, theme and tokens.",
   "_sideEffects": "The barrel (src/index.ts) re-exports EVERY component, including components/chart, which statically imports recharts. Without this field a bundler must assume each of those modules has side effects, so it cannot drop the unused ones: importing a Button from '@eifi1/ui-kit' dragged all 433KB of recharts into the consumer's ENTRY chunk, and Keksdose was preloading it on every page load, login included. Nothing in src/ imports for side effects (no bare imports, no CSS imports from JS, no module-level global writes) — the token stylesheet is its own './tokens.css' export — so this is safe. CSS is still listed so any future stylesheet survives. Re-checked when `flag-icons` left `dependencies` and tsup started emitting a `\"use client\"` banner: neither touches this. The flag stylesheet was never imported from JS in the first place (that was the finding), and a directive prologue is a string literal every bundler lifts out before it decides whether a module is inert.",
@@ -68,23 +68,23 @@
     "LICENSE"
   ],
   "scripts": {
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.node.json",
+    "lint": "eslint . --max-warnings 0",
     "check:tokens": "node scripts/check-token-discipline.mjs",
     "test:coverage": "vitest run --coverage",
     "check:graph": "node scripts/check-module-graph.mjs",
-    "check:package": "node scripts/verify-package.mjs",
+    "check:package": "node scripts/verify-package.mjs --quiet",
     "check:tailwind": "node scripts/check-tailwind-scan.mjs",
     "check:security": "npm audit --audit-level=high",
     "check:commits": "node scripts/check-commit-range.cjs",
     "check": "npm run typecheck && npm run lint && npm run check:tokens && npm run test:coverage && npm run build && npm run check:graph && npm run check:package && npm run build:showcase && npm run check:tailwind && npm run check:security && npm run check:commits",
     "test": "vitest run",
     "test:watch": "vitest",
-    "build": "tsup && node scripts/fix-esm-extensions.mjs",
+    "build": "node scripts/tsup-quiet.mjs && node scripts/fix-esm-extensions.mjs",
     "verify:package": "npm run build && node scripts/verify-package.mjs",
     "dev": "tsup --watch",
     "dev:showcase": "vite --config showcase/vite.config.ts",
-    "build:showcase": "vite build --config showcase/vite.config.ts",
+    "build:showcase": "vite build --config showcase/vite.config.ts --logLevel warn",
     "preview:showcase": "vite preview --config showcase/vite.config.ts",
     "prepublishOnly": "npm run build",
     "release": "commit-and-tag-version",

package/src/chart.ts

@@ -20,3 +20,7 @@ export * from "./components/chart-zoom";
 export * from "./components/toggle-legend";
 export * from "./components/facing-pair";
 export * from "./components/series-chart-labels";
+
+// The part-to-whole chart (donut / pie) — moved here from kastlan's dashboard and reports.
+export * from "./components/pie-chart";
+export * from "./components/pie-chart-labels";