@eifi1/ui-kit 0.51.4 → 0.51.5

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, 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  WizardFinishResult,\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 (): Promise<boolean | undefined> => {\n    if (advancingRef.current) return undefined;\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        return true;\n      }\n      return false;\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 (): Promise<WizardFinishResult | undefined> => {\n    if (!onComplete || !canFinish) return undefined;\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 undefined;\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 undefined;\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 { ok: false };\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        return { ok: true };\n      } catch (err) {\n        const message = err instanceof Error && err.message ? err.message : genericError;\n        dispatch({ type: \"SET_ERROR\", error: message });\n        return { ok: false, error: err instanceof Error && err.message ? err.message : undefined };\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    // Their outcomes are what StepperNav tells a running tour (0.50); the declared types stay\n    // `Promise<void>`, so an app's `let p: Promise<void> = wizard.goNext()` still compiles.\n    goNext: goNext as () => Promise<void>,\n    goBack,\n    goToStep,\n    skip,\n    cancel,\n    finish: finish as () => Promise<void>,\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  WizardFinishResult,\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(state: { currentStepIndex: number; committedStepIndex: number | null }, index: number) {\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(state: WizardState<TData>, action: WizardAction<TData>): 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(new Map<symbol, () => ValidateResult | Promise<ValidateResult>>());\n  const registerStepValidate = useCallback((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  // 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(() => (typeof urlSync === \"object\" && urlSync.param ? urlSync.param : \"step\"));\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((blocked: boolean) => setNextBlockedState(blocked), []);\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) => index >= commitStepIndex || state.completedSteps.has(index) || state.skippedSteps.has(index),\n  );\n  const canGoBack = (!isFirstStep || onExit !== undefined) && !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 (): Promise<boolean | undefined> => {\n    if (advancingRef.current) return undefined;\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        return true;\n      }\n      return false;\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 (): Promise<WizardFinishResult | undefined> => {\n    if (!onComplete || !canFinish) return undefined;\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 undefined;\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 undefined;\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 { ok: false };\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        return { ok: true };\n      } catch (err) {\n        const message = err instanceof Error && err.message ? err.message : genericError;\n        dispatch({ type: \"SET_ERROR\", error: message });\n        return { ok: false, error: err instanceof Error && err.message ? err.message : undefined };\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    // Their outcomes are what StepperNav tells a running tour (0.50); the declared types stay\n    // `Promise<void>`, so an app's `let p: Promise<void> = wizard.goNext()` still compiles.\n    goNext: goNext as () => Promise<void>,\n    goBack,\n    goToStep,\n    skip,\n    cancel,\n    finish: finish as () => Promise<void>,\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(\n      (prev) => {\n        prev.set(param, String(index));\n        return prev;\n      },\n      { replace: true },\n    );\n  }, [param, index, setUrlParams]);\n  return useCallback(() => {\n    if (leftRef.current) return;\n    leftRef.current = true;\n    setUrlParams(\n      (prev) => {\n        prev.delete(param);\n        return prev;\n      },\n      { replace: true },\n    );\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/validation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wizard/validation.ts"],"sourcesContent":["import type { ValidateResult, FieldErrors } from \"./types\";\n\nexport interface RequiredFieldSpec<T> {\n  key: keyof T;\n  /**\n   * Custom predicate (e.g. numeric `> 0` or range checks). Defaults to a\n   * \"present\" check: a non-empty trimmed string, or a non-null id/enum.\n   */\n  valid?: (value: unknown, data: T) => boolean;\n  /** Per-field message override (defaults to the shared `defaultMessage`). */\n  message?: string;\n}\n\n/**\n * Folds the copy-pasted `const errors = {}; if (!data.x) errors.x = required; …`\n * step-validate block reimplemented across the single-file entity wizards.\n * Pure-required fields need only `{ key }`; numeric constraints (amount `> 0`,\n * rate in range) pass a `valid` predicate. The message is caller-supplied so\n * each page keeps its own namespace (e.g. `t(\"common:validation.required\")`).\n */\nexport function requiredFieldsValidator<T extends Record<string, unknown>>(\n  data: T,\n  fields: RequiredFieldSpec<T>[],\n  defaultMessage: string,\n): ValidateResult {\n  const errors: FieldErrors = {};\n  for (const f of fields) {\n    const v = data[f.key];\n    const ok = f.valid\n      ? f.valid(v, data)\n      : typeof v === \"string\"\n        ? v.trim() !== \"\"\n        : v != null;\n    if (!ok) errors[String(f.key)] = f.message ?? defaultMessage;\n  }\n  return { ok: Object.keys(errors).length === 0, errors };\n}\n"],"mappings":";AAoBO,SAAS,wBACd,MACA,QACA,gBACgB;AAChB,QAAM,SAAsB,CAAC;AAC7B,aAAW,KAAK,QAAQ;AACtB,UAAM,IAAI,KAAK,EAAE,GAAG;AACpB,UAAM,KAAK,EAAE,QACT,EAAE,MAAM,GAAG,IAAI,IACf,OAAO,MAAM,WACX,EAAE,KAAK,MAAM,KACb,KAAK;AACX,QAAI,CAAC,GAAI,QAAO,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW;AAAA,EAChD;AACA,SAAO,EAAE,IAAI,OAAO,KAAK,MAAM,EAAE,WAAW,GAAG,OAAO;AACxD;","names":[]}
+{"version":3,"sources":["../../src/wizard/validation.ts"],"sourcesContent":["import type { ValidateResult, FieldErrors } from \"./types\";\n\nexport interface RequiredFieldSpec<T> {\n  key: keyof T;\n  /**\n   * Custom predicate (e.g. numeric `> 0` or range checks). Defaults to a\n   * \"present\" check: a non-empty trimmed string, or a non-null id/enum.\n   */\n  valid?: (value: unknown, data: T) => boolean;\n  /** Per-field message override (defaults to the shared `defaultMessage`). */\n  message?: string;\n}\n\n/**\n * Folds the copy-pasted `const errors = {}; if (!data.x) errors.x = required; …`\n * step-validate block reimplemented across the single-file entity wizards.\n * Pure-required fields need only `{ key }`; numeric constraints (amount `> 0`,\n * rate in range) pass a `valid` predicate. The message is caller-supplied so\n * each page keeps its own namespace (e.g. `t(\"common:validation.required\")`).\n */\nexport function requiredFieldsValidator<T extends Record<string, unknown>>(\n  data: T,\n  fields: RequiredFieldSpec<T>[],\n  defaultMessage: string,\n): ValidateResult {\n  const errors: FieldErrors = {};\n  for (const f of fields) {\n    const v = data[f.key];\n    const ok = f.valid ? f.valid(v, data) : typeof v === \"string\" ? v.trim() !== \"\" : v != null;\n    if (!ok) errors[String(f.key)] = f.message ?? defaultMessage;\n  }\n  return { ok: Object.keys(errors).length === 0, errors };\n}\n"],"mappings":";AAoBO,SAAS,wBACd,MACA,QACA,gBACgB;AAChB,QAAM,SAAsB,CAAC;AAC7B,aAAW,KAAK,QAAQ;AACtB,UAAM,IAAI,KAAK,EAAE,GAAG;AACpB,UAAM,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,MAAM,WAAW,EAAE,KAAK,MAAM,KAAK,KAAK;AACvF,QAAI,CAAC,GAAI,QAAO,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW;AAAA,EAChD;AACA,SAAO,EAAE,IAAI,OAAO,KAAK,MAAM,EAAE,WAAW,GAAG,OAAO;AACxD;","names":[]}

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

@@ -1 +1 @@
-{"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":[]}
+{"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: (fn: () => ValidateResult | Promise<ValidateResult>) => () => 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(validate: () => ValidateResult | Promise<ValidateResult>): 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;AAgB7D,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,sBAAsB,UAAgE;AACpG,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

@@ -29,4 +29,4 @@ export interface WizardStepProps {
 /** 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. */
-export declare function WizardStep({ children, className, title, description, headingLevel, actions, }: WizardStepProps): import("react").JSX.Element;
+export declare function WizardStep({ children, className, title, description, headingLevel, actions }: WizardStepProps): import("react").JSX.Element;

package/dist/wizard/wizard-step.js

@@ -2,14 +2,7 @@
 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,
-  title,
-  description,
-  headingLevel = 3,
-  actions
-}) {
+function WizardStep({ children, className, title, description, headingLevel = 3, actions }) {
   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 !== "";

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\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-primary\">{title}</Heading>}\n      {hasDescription && <p className=\"text-sm 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,sCAAsC,iBAAM;AAAA,IAC3E,kBAAkB,oBAAC,OAAE,WAAU,sBAAsB,uBAAY;AAAA,KACpE;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":[]}
+{"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({ children, className, title, description, headingLevel = 3, actions }: 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-primary\">{title}</Heading>}\n      {hasDescription && <p className=\"text-sm 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":";AA2CI,mBACe,KADf;AA1CJ,SAAS,UAAU;AA8BnB,MAAM,UAAU,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK;AAKrC,SAAS,WAAW,EAAE,UAAU,WAAW,OAAO,aAAa,eAAe,GAAG,QAAQ,GAAoB;AAClH,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,sCAAsC,iBAAM;AAAA,IAC3E,kBAAkB,oBAAC,OAAE,WAAU,sBAAsB,uBAAY;AAAA,KACpE;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/wizard-summary.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/wizard/wizard-summary.tsx"],"sourcesContent":["import { Pencil } from \"lucide-react\";\nimport { Card, CardAction, CardContent, CardHeader, CardTitle } from \"../components/card\";\nimport { IconButton } from \"../components/icon-button\";\nimport { Tooltip } from \"../components/tooltip\";\nimport type { SummarySection, WizardLabels } from \"./types\";\nimport { DEFAULT_WIZARD_LABELS } from \"./types\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\n\n/**\n * The review step: one card per section, each row a label/value pair, each card\n * carrying an edit button back to the step it came from.\n *\n * Sections are data, not children, because \"jump back to step N\" is the whole\n * point of the component and a caller assembling its own cards invariably drops\n * it. Labels and values are `ReactNode`, so a value can be a badge or a link.\n *\n * A section with no `stepIndex` (file-level counts, a total) is a card without an\n * edit button. `disabled` greys every edit button at once — while the commit runs,\n * when jumping back would show a step whose edits can no longer reach the request.\n */\nexport function WizardSummary({\n  sections,\n  onEditStep,\n  disabled = false,\n  labels,\n}: {\n  sections: SummarySection[];\n  /** Called with the section's `stepIndex`. Optional only for a summary whose\n   *  sections name no step at all. */\n  onEditStep?: (stepIndex: number) => void;\n  /** Disable every edit button (e.g. `wizard.isSubmitting`). */\n  disabled?: boolean;\n  labels?: LabelOverride<WizardLabels>;\n}) {\n  const l = useKitLabels(\"wizard\", DEFAULT_WIZARD_LABELS, labels);\n\n  return (\n    <div className=\"space-y-4\">\n      <h2 className=\"text-lg font-semibold text-primary\">{l.reviewTitle}</h2>\n      {sections.map((section, sIdx) => (\n        <Card key={sIdx}>\n          {/* CardHeader is a grid, and CardAction is the top-right column it\n              reserves — the edit button has to go through it or it stacks under\n              the title instead of sitting beside it. `stackAction={false}`: the pencil\n              is named by `aria-label` and stays an icon at Large, so it keeps its\n              place beside the title there too (0.32.1). */}\n          <CardHeader className=\"pb-2\" stackAction={false}>\n            <CardTitle className=\"text-base\">{section.label}</CardTitle>\n            {section.stepIndex !== undefined && onEditStep && (\n              <CardAction>\n                {/* The kit Tooltip, not a native `title`: it shows on keyboard focus too,\n                    and an app with a one-tooltip rule (keksdose dev#523) sees one. */}\n                <Tooltip label={l.edit}>\n                  <IconButton\n                    size=\"sm\"\n                    variant=\"ghost\"\n                    aria-label={l.edit}\n                    disabled={disabled}\n                    onClick={() => onEditStep(section.stepIndex as number)}\n                  >\n                    <Pencil />\n                  </IconButton>\n                </Tooltip>\n              </CardAction>\n            )}\n          </CardHeader>\n          <CardContent>\n            <dl className=\"grid gap-2 text-sm\">\n              {section.items.map((item, iIdx) => (\n                <div key={iIdx}>\n                  {iIdx > 0 && (\n                    <div className=\"mb-2 border-t border-subtle\" role=\"presentation\" />\n                  )}\n                  <div className=\"flex items-start justify-between gap-4\">\n                    <dt className=\"text-muted\">{item.label}</dt>\n                    <dd className=\"text-end font-medium text-primary\">\n                      {item.value}\n                    </dd>\n                  </div>\n                </div>\n              ))}\n            </dl>\n          </CardContent>\n        </Card>\n      ))}\n    </div>\n  );\n}\n"],"mappings":";AAsCM,cAQI,YARJ;AAtCN,SAAS,cAAc;AACvB,SAAS,MAAM,YAAY,aAAa,YAAY,iBAAiB;AACrE,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AAExB,SAAS,6BAA6B;AACtC,SAAS,oBAAwC;AAc1C,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AACF,GAQG;AACD,QAAM,IAAI,aAAa,UAAU,uBAAuB,MAAM;AAE9D,SACE,qBAAC,SAAI,WAAU,aACb;AAAA,wBAAC,QAAG,WAAU,sCAAsC,YAAE,aAAY;AAAA,IACjE,SAAS,IAAI,CAAC,SAAS,SACtB,qBAAC,QAMC;AAAA,2BAAC,cAAW,WAAU,QAAO,aAAa,OACxC;AAAA,4BAAC,aAAU,WAAU,aAAa,kBAAQ,OAAM;AAAA,QAC/C,QAAQ,cAAc,UAAa,cAClC,oBAAC,cAGC,8BAAC,WAAQ,OAAO,EAAE,MAChB;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,SAAQ;AAAA,YACR,cAAY,EAAE;AAAA,YACd;AAAA,YACA,SAAS,MAAM,WAAW,QAAQ,SAAmB;AAAA,YAErD,8BAAC,UAAO;AAAA;AAAA,QACV,GACF,GACF;AAAA,SAEJ;AAAA,MACA,oBAAC,eACC,8BAAC,QAAG,WAAU,sBACX,kBAAQ,MAAM,IAAI,CAAC,MAAM,SACxB,qBAAC,SACE;AAAA,eAAO,KACN,oBAAC,SAAI,WAAU,+BAA8B,MAAK,gBAAe;AAAA,QAEnE,qBAAC,SAAI,WAAU,0CACb;AAAA,8BAAC,QAAG,WAAU,cAAc,eAAK,OAAM;AAAA,UACvC,oBAAC,QAAG,WAAU,qCACX,eAAK,OACR;AAAA,WACF;AAAA,WATQ,IAUV,CACD,GACH,GACF;AAAA,SA1CS,IA2CX,CACD;AAAA,KACH;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/wizard/wizard-summary.tsx"],"sourcesContent":["import { Pencil } from \"lucide-react\";\nimport { Card, CardAction, CardContent, CardHeader, CardTitle } from \"../components/card\";\nimport { IconButton } from \"../components/icon-button\";\nimport { Tooltip } from \"../components/tooltip\";\nimport type { SummarySection, WizardLabels } from \"./types\";\nimport { DEFAULT_WIZARD_LABELS } from \"./types\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\n\n/**\n * The review step: one card per section, each row a label/value pair, each card\n * carrying an edit button back to the step it came from.\n *\n * Sections are data, not children, because \"jump back to step N\" is the whole\n * point of the component and a caller assembling its own cards invariably drops\n * it. Labels and values are `ReactNode`, so a value can be a badge or a link.\n *\n * A section with no `stepIndex` (file-level counts, a total) is a card without an\n * edit button. `disabled` greys every edit button at once — while the commit runs,\n * when jumping back would show a step whose edits can no longer reach the request.\n */\nexport function WizardSummary({\n  sections,\n  onEditStep,\n  disabled = false,\n  labels,\n}: {\n  sections: SummarySection[];\n  /** Called with the section's `stepIndex`. Optional only for a summary whose\n   *  sections name no step at all. */\n  onEditStep?: (stepIndex: number) => void;\n  /** Disable every edit button (e.g. `wizard.isSubmitting`). */\n  disabled?: boolean;\n  labels?: LabelOverride<WizardLabels>;\n}) {\n  const l = useKitLabels(\"wizard\", DEFAULT_WIZARD_LABELS, labels);\n\n  return (\n    <div className=\"space-y-4\">\n      <h2 className=\"text-lg font-semibold text-primary\">{l.reviewTitle}</h2>\n      {sections.map((section, sIdx) => (\n        <Card key={sIdx}>\n          {/* CardHeader is a grid, and CardAction is the top-right column it\n              reserves — the edit button has to go through it or it stacks under\n              the title instead of sitting beside it. `stackAction={false}`: the pencil\n              is named by `aria-label` and stays an icon at Large, so it keeps its\n              place beside the title there too (0.32.1). */}\n          <CardHeader className=\"pb-2\" stackAction={false}>\n            <CardTitle className=\"text-base\">{section.label}</CardTitle>\n            {section.stepIndex !== undefined && onEditStep && (\n              <CardAction>\n                {/* The kit Tooltip, not a native `title`: it shows on keyboard focus too,\n                    and an app with a one-tooltip rule (keksdose dev#523) sees one. */}\n                <Tooltip label={l.edit}>\n                  <IconButton\n                    size=\"sm\"\n                    variant=\"ghost\"\n                    aria-label={l.edit}\n                    disabled={disabled}\n                    onClick={() => onEditStep(section.stepIndex as number)}\n                  >\n                    <Pencil />\n                  </IconButton>\n                </Tooltip>\n              </CardAction>\n            )}\n          </CardHeader>\n          <CardContent>\n            <dl className=\"grid gap-2 text-sm\">\n              {section.items.map((item, iIdx) => (\n                <div key={iIdx}>\n                  {iIdx > 0 && <div className=\"mb-2 border-t border-subtle\" role=\"presentation\" />}\n                  <div className=\"flex items-start justify-between gap-4\">\n                    <dt className=\"text-muted\">{item.label}</dt>\n                    <dd className=\"text-end font-medium text-primary\">{item.value}</dd>\n                  </div>\n                </div>\n              ))}\n            </dl>\n          </CardContent>\n        </Card>\n      ))}\n    </div>\n  );\n}\n"],"mappings":";AAsCM,cAQI,YARJ;AAtCN,SAAS,cAAc;AACvB,SAAS,MAAM,YAAY,aAAa,YAAY,iBAAiB;AACrE,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AAExB,SAAS,6BAA6B;AACtC,SAAS,oBAAwC;AAc1C,SAAS,cAAc;AAAA,EAC5B;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX;AACF,GAQG;AACD,QAAM,IAAI,aAAa,UAAU,uBAAuB,MAAM;AAE9D,SACE,qBAAC,SAAI,WAAU,aACb;AAAA,wBAAC,QAAG,WAAU,sCAAsC,YAAE,aAAY;AAAA,IACjE,SAAS,IAAI,CAAC,SAAS,SACtB,qBAAC,QAMC;AAAA,2BAAC,cAAW,WAAU,QAAO,aAAa,OACxC;AAAA,4BAAC,aAAU,WAAU,aAAa,kBAAQ,OAAM;AAAA,QAC/C,QAAQ,cAAc,UAAa,cAClC,oBAAC,cAGC,8BAAC,WAAQ,OAAO,EAAE,MAChB;AAAA,UAAC;AAAA;AAAA,YACC,MAAK;AAAA,YACL,SAAQ;AAAA,YACR,cAAY,EAAE;AAAA,YACd;AAAA,YACA,SAAS,MAAM,WAAW,QAAQ,SAAmB;AAAA,YAErD,8BAAC,UAAO;AAAA;AAAA,QACV,GACF,GACF;AAAA,SAEJ;AAAA,MACA,oBAAC,eACC,8BAAC,QAAG,WAAU,sBACX,kBAAQ,MAAM,IAAI,CAAC,MAAM,SACxB,qBAAC,SACE;AAAA,eAAO,KAAK,oBAAC,SAAI,WAAU,+BAA8B,MAAK,gBAAe;AAAA,QAC9E,qBAAC,SAAI,WAAU,0CACb;AAAA,8BAAC,QAAG,WAAU,cAAc,eAAK,OAAM;AAAA,UACvC,oBAAC,QAAG,WAAU,qCAAqC,eAAK,OAAM;AAAA,WAChE;AAAA,WALQ,IAMV,CACD,GACH,GACF;AAAA,SAtCS,IAuCX,CACD;AAAA,KACH;AAEJ;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eifi1/ui-kit",
-  "version": "0.51.4",
+  "version": "0.51.5",
   "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.",
@@ -111,7 +111,9 @@
     "check:commits": "node scripts/check-commit-range.cjs",
     "check:commit-rules": "node scripts/check-commit-rules.mjs",
     "sync:commit-rules": "node scripts/sync-commit-rules.mjs",
-    "check:static": "npm run typecheck && npm run lint && npm run check:tokens && npm run check:security && npm run check:commit-rules && npm run check:commits",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:static": "npm run format:check && npm run typecheck && npm run lint && npm run check:tokens && npm run check:security && npm run check:commit-rules && npm run check:commits",
     "check:test": "npm run test:coverage",
     "check:build": "npm run build && npm run check:graph && npm run check:package && node scripts/gen-export-inventory.mjs --check && node scripts/gen-styling-inventory.mjs --check && npm run build:showcase && npm run check:tailwind",
     "check": "node scripts/check.mjs",
@@ -213,6 +215,7 @@
     "lucide-react": "^1.47.0",
     "modern-screenshot": "^4.7.0",
     "playwright-core": "~1.63.0",
+    "prettier": "3.9.10",
     "react-hook-form": "^7.88.0",
     "react-router": "^8.3.0",
     "recharts": "^3.8.1",

package/src/account/account-settings-labels.ts

@@ -223,8 +223,7 @@ export function useAccountSettingsLabels<K extends keyof AccountSettingsLabels>(
   prop?: Partial<AccountSettingsLabels[K]>,
 ): AccountSettingsLabels[K] {
   const fromProvider = useKitLabelOverrides("accountSettings")?.[section] as
-    | Partial<AccountSettingsLabels[K]>
-    | undefined;
+    Partial<AccountSettingsLabels[K]> | undefined;
   return useMemo(
     () => ({
       ...DEFAULT_ACCOUNT_SETTINGS_LABELS[section],

package/src/account/account-settings.tsx

@@ -19,11 +19,7 @@ import { useKitLabelOverrides, useKitLabels, type LabelOverride } from "../i18n/
 import { Chip } from "../components/chip";
 import { useAccountSettingsLabels } from "./account-settings-labels";
 import { SettingsCardTitle } from "../settings/settings-heading";
-import type {
-  PasswordSettingLabels,
-  ProfileSettingLabels,
-  TwoFactorSettingLabels,
-} from "./account-settings-labels";
+import type { PasswordSettingLabels, ProfileSettingLabels, TwoFactorSettingLabels } from "./account-settings-labels";
 import { COMMIT_EXCEPT_BILLING } from "../components/write-lock";
 import { AlertBanner } from "../components/alert-banner";
 import { hasContent } from "../lib/presence";
@@ -527,9 +523,7 @@ type PasswordField = "current" | "next" | "confirm";
  * base64-encoded SVG image — is what the section took before, which made every app
  * render a QR library to a static string and base64 it only for the kit to draw it back.
  */
-export type TwoFactorSetupData =
-  | { qrSvg: string; secret: string }
-  | { otpauthUri: string; secret?: string };
+export type TwoFactorSetupData = { qrSvg: string; secret: string } | { otpauthUri: string; secret?: string };
 
 /** The `secret` parameter of an `otpauth://` URI, or null. */
 function otpauthSecret(uri: string): string | null {
@@ -594,9 +588,7 @@ export function TwoFactorSetting({
   //    pasted from an authenticator that groups its digits used to reach `onEnable`
   //    with the space in it.
   //  - one `code` state for both, as before.
-  const secret = setup
-    ? (setup.secret ?? ("otpauthUri" in setup ? otpauthSecret(setup.otpauthUri) : null))
-    : null;
+  const secret = setup ? (setup.secret ?? ("otpauthUri" in setup ? otpauthSecret(setup.otpauthUri) : null)) : null;
 
   return (
     <Card id={id} className="p-4 space-y-3">
@@ -637,11 +629,7 @@ export function TwoFactorSetting({
             </div>
           ) : (
             <div data-private className="inline-block rounded-md bg-white p-2">
-              <img
-                alt={labels.qrAlt}
-                src={`data:image/svg+xml;base64,${setup.qrSvg}`}
-                className="h-48 w-48"
-              />
+              <img alt={labels.qrAlt} src={`data:image/svg+xml;base64,${setup.qrSvg}`} className="h-48 w-48" />
             </div>
           )}
           {secret && (
@@ -680,7 +668,13 @@ export function TwoFactorSetting({
       {enabled && (
         <div className="space-y-3 border-t border-subtle pt-3">
           <div className="text-sm font-medium">{labels.disableSection}</div>
-          <Input type="password" autoComplete="current-password" label={labels.password} value={password} onChange={(e) => setPassword(e.target.value)} />
+          <Input
+            type="password"
+            autoComplete="current-password"
+            label={labels.password}
+            value={password}
+            onChange={(e) => setPassword(e.target.value)}
+          />
           <OneTimeCodeInput
             readOnlyUntilFocus
             length={8}

package/src/account/delete-account-setting.tsx

@@ -283,12 +283,7 @@ export function DeleteAccountSetting({
   };
 
   return (
-    <Card
-      {...rest}
-      data-state={done ? "done" : "form"}
-      tone="danger"
-      className={cn("p-4 space-y-3", className)}
-    >
+    <Card {...rest} data-state={done ? "done" : "form"} tone="danger" className={cn("p-4 space-y-3", className)}>
       <div>
         <SettingsCardTitle>{labels.title}</SettingsCardTitle>
         <div className={CARD_DESCRIPTION_CLASS}>{modeSentence}</div>

package/src/account/email-change-setting-labels.ts

@@ -20,8 +20,7 @@ export const DEFAULT_EMAIL_CHANGE_LABELS: EmailChangeLabels = {
   emailTaken: "An account with this email address already exists.",
   wrongPassword: "The password is incorrect.",
   pending: (newEmail) => `Confirm the link we sent to ${newEmail}.`,
-  pendingHint: (currentEmail) =>
-    `Until you do, you keep signing in with ${currentEmail}. Check your spam folder too.`,
+  pendingHint: (currentEmail) => `Until you do, you keep signing in with ${currentEmail}. Check your spam folder too.`,
   resend: "Send the link again",
   resent: "We sent the link again.",
   cancel: "Cancel the change",

package/src/account/email-change-setting.tsx

@@ -252,7 +252,9 @@ export function EmailChangeSetting({
       <Card {...rest} data-state="pending" className={cn("p-4 space-y-3", className)}>
         <div>
           <SettingsCardTitle id={titleId}>{labels.title}</SettingsCardTitle>
-          <div className={cn(CARD_DESCRIPTION_CLASS, "break-all")}>{common.fieldValue(labels.current, currentEmail)}</div>
+          <div className={cn(CARD_DESCRIPTION_CLASS, "break-all")}>
+            {common.fieldValue(labels.current, currentEmail)}
+          </div>
         </div>
         {/* Focusable, not a control: the request's answer is read out when it takes the
             focus from the submit that went with the form. */}

package/src/account/passkeys-setting.tsx

@@ -249,9 +249,7 @@ export function PasskeysSetting<Id extends PasskeyId = PasskeyId>({
       <div>
         <SettingsCardTitle>{labels.title}</SettingsCardTitle>
         <div className="text-xs text-muted">
-          {mode === "alongside"
-            ? labels.descriptionAlongside
-            : labels.description}
+          {mode === "alongside" ? labels.descriptionAlongside : labels.description}
         </div>
       </div>
       {body}

package/src/account/sessions-setting.tsx

@@ -83,8 +83,10 @@ export interface SessionItem<Id extends SessionId = SessionId> {
 /** Which request failed — {@link SessionsSettingProps.describeError}'s second argument. */
 export type SessionsAction = "sign-out-everywhere" | "revoke";
 
-export interface SessionsSettingProps<Id extends SessionId = SessionId>
-  extends Omit<ComponentPropsWithRef<"div">, "children"> {
+export interface SessionsSettingProps<Id extends SessionId = SessionId> extends Omit<
+  ComponentPropsWithRef<"div">,
+  "children"
+> {
   /**
    * End every session (`POST /auth/logout`, auth §6.3) — this one included. Asked
    * first; resolve once the server answered, then sign this page out: the card says

package/src/admin/admin-action-confirm.tsx

@@ -206,7 +206,8 @@ function refusalOf(
 }
 
 /** The selector for the first field among the caller's `children` — what opening focuses. */
-const FIELD = 'input:not([type="hidden"]):not(:disabled), select:not(:disabled), textarea:not(:disabled), [role="combobox"]';
+const FIELD =
+  'input:not([type="hidden"]):not(:disabled), select:not(:disabled), textarea:not(:disabled), [role="combobox"]';
 
 export function AdminActionConfirm({
   level,
@@ -406,9 +407,7 @@ export function AdminActionConfirm({
 
   const submit = () => {
     if (busy || guardReason !== undefined) return;
-    perform(() =>
-      onConfirm(askTyped ? { confirmEmail: typed.trim(), acknowledged: true } : { acknowledged: true }),
-    );
+    perform(() => onConfirm(askTyped ? { confirmEmail: typed.trim(), acknowledged: true } : { acknowledged: true }));
   };
 
   const lines = Array.isArray(consequence)
@@ -467,9 +466,7 @@ export function AdminActionConfirm({
             ))}
           </ul>
         ) : (
-          hasContent(consequence as ReactNode) && (
-            <p className="text-sm text-secondary">{consequence as ReactNode}</p>
-          )
+          hasContent(consequence as ReactNode) && <p className="text-sm text-secondary">{consequence as ReactNode}</p>
         )}
         {Children.toArray(children).some(hasContent) && (
           <div ref={slotRef} className="space-y-3">

package/src/admin/admin-action-log.tsx

@@ -414,37 +414,37 @@ export function AdminActionLog({
             const to = (entry.renamed?.to ?? "").trim();
             const renamed = entry.action === "group_rename" && from !== "" && to !== "";
             return (
-            <li key={entry.id} data-action={entry.action} className="space-y-0.5 py-2 first:pt-0 last:pb-0">
-              <div className="flex flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5">
-                <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-0.5 text-sm">
-                  <span className="font-medium text-primary">{actionText(entry.action)}</span>
-                  {renamed ? (
-                    <span data-private data-renamed className="min-w-0 break-words text-primary">
-                      {labels.renamedFromTo(from, to)}
-                    </span>
-                  ) : (
-                    entry.target !== undefined && <span className="min-w-0 break-words">{targetNode(entry)}</span>
-                  )}
-                  {entry.group && (
-                    <span data-group className="min-w-0 break-words text-xs text-muted">
-                      {groupText(entry.group)}
-                    </span>
+              <li key={entry.id} data-action={entry.action} className="space-y-0.5 py-2 first:pt-0 last:pb-0">
+                <div className="flex flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5">
+                  <div className="flex min-w-0 flex-wrap items-baseline gap-x-2 gap-y-0.5 text-sm">
+                    <span className="font-medium text-primary">{actionText(entry.action)}</span>
+                    {renamed ? (
+                      <span data-private data-renamed className="min-w-0 break-words text-primary">
+                        {labels.renamedFromTo(from, to)}
+                      </span>
+                    ) : (
+                      entry.target !== undefined && <span className="min-w-0 break-words">{targetNode(entry)}</span>
+                    )}
+                    {entry.group && (
+                      <span data-group className="min-w-0 break-words text-xs text-muted">
+                        {groupText(entry.group)}
+                      </span>
+                    )}
+                  </div>
+                  <DateMark value={entry.at} display="relative" className="text-xs text-muted" />
+                </div>
+                <div className="text-xs text-muted">
+                  <span data-private={entry.actor !== null && entry.actor !== "self" ? true : undefined}>
+                    {actorText(entry)}
+                  </span>
+                  {entry.detail !== undefined && entry.detail !== null && entry.detail !== "" && (
+                    <>
+                      {" · "}
+                      <span className="text-secondary">{entry.detail}</span>
+                    </>
                   )}
                 </div>
-                <DateMark value={entry.at} display="relative" className="text-xs text-muted" />
-              </div>
-              <div className="text-xs text-muted">
-                <span data-private={entry.actor !== null && entry.actor !== "self" ? true : undefined}>
-                  {actorText(entry)}
-                </span>
-                {entry.detail !== undefined && entry.detail !== null && entry.detail !== "" && (
-                  <>
-                    {" · "}
-                    <span className="text-secondary">{entry.detail}</span>
-                  </>
-                )}
-              </div>
-            </li>
+              </li>
             );
           })}
         </ol>

package/src/admin/admin-area-labels.ts

@@ -82,7 +82,10 @@ export const DEFAULT_ADMIN_AREA_LABELS: AdminAreaLabels = {
   sections: {
     overview: { title: "Overview", help: "What is waiting, at a glance." },
     users: { title: "Users", help: "Who has an account, and what each may do." },
-    invitations: { title: "Invitations", help: "Invite people by e-mail in their language; resend or revoke what’s still open." },
+    invitations: {
+      title: "Invitations",
+      help: "Invite people by e-mail in their language; resend or revoke what’s still open.",
+    },
     billing: { title: "Billing", help: "The plan, the payment and the invoices." },
     activity: { title: "Activity", help: "What the admins did, newest first." },
   },

package/src/admin/admin-overview.tsx

@@ -201,7 +201,9 @@ export function AdminOverview({
       key: "users_total",
       label: labels.tiles.users,
       description:
-        attention && typeof attention.users_new_7d === "number" ? labels.tiles.usersNew(attention.users_new_7d) : undefined,
+        attention && typeof attention.users_new_7d === "number"
+          ? labels.tiles.usersNew(attention.users_new_7d)
+          : undefined,
     },
   ];
   const feedbackWords: Record<AdminFeedbackTileKey, { label: string; description: string }> = {
@@ -227,7 +229,11 @@ export function AdminOverview({
   ].filter((t) => loading || (t.count !== null && t.count !== undefined));
   if (!loading && tiles.length === 0) return error ? errorBox(true) : null;
   const grid = (
-    <StatTileGrid data-slot={error ? undefined : "admin-overview"} loading={loading} className={error ? undefined : className}>
+    <StatTileGrid
+      data-slot={error ? undefined : "admin-overview"}
+      loading={loading}
+      className={error ? undefined : className}
+    >
       {tiles.map((t) => (
         <AttentionTile
           key={t.key}

package/src/admin/admin-sections.tsx

@@ -61,7 +61,9 @@ export interface AdminSectionOrderOptions<L extends AdminSharedSection = AdminSh
   leaveOut?: readonly L[];
 }
 
-export interface AdminSectionsOptions<L extends AdminSharedSection = AdminSharedSection> extends AdminSectionOrderOptions<L> {
+export interface AdminSectionsOptions<
+  L extends AdminSharedSection = AdminSharedSection,
+> extends AdminSectionOrderOptions<L> {
   /**
    * A shared section that is in the catalogue but hidden for now, as
    * {@link SettingsGroup.visible}: kastlan's `{ billing: billingEnabled }` (settings §5),