@eifi1/ui-kit 0.12.0 → 0.13.0

package/dist/tour/tour.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/tour/tour.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n} from \"react\";\nimport type { CSSProperties, ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/cn\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { Button } from \"../components/ui\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { dirOf, horizontalStep } from \"../lib/direction\";\nimport type { Direction } from \"../lib/direction\";\n\n/**\n * `start`/`end` follow the reading direction (`end` is the right side in LTR and the\n * left side in RTL) and are what a translated app wants. `left`/`right` stay physical\n * for the steps that genuinely mean a screen side.\n */\nexport type TourPlacement = \"top\" | \"right\" | \"bottom\" | \"left\" | \"start\" | \"end\" | \"center\";\n\nexport interface TourStep {\n  /** CSS selector for the element to spotlight. Omit for a centered step\n   *  (welcome/finish). If the target isn't found/visible, the step centers. */\n  target?: string;\n  title: string;\n  body: ReactNode;\n  /** Extra footer content, e.g. a \"load sample data\" shortcut. */\n  action?: ReactNode;\n  /** Spotlight padding around the target, px (default 8). */\n  padding?: number;\n  /** Where the card sits relative to the target. Omit for auto placement\n   *  (below → above → centered). \"center\" ignores the target and centers on\n   *  screen. \"start\"/\"end\" are the logical sides and flip in RTL; \"left\"/\"right\"\n   *  are physical. An explicit side flips to the opposite side if it would\n   *  overflow, then clamps into the viewport. */\n  placement?: TourPlacement;\n  /** Advance only when the user clicks the spotlighted target itself (not the\n   *  card's Next button). Requires `target`: the real control's own handler runs\n   *  first, then the tour steps forward on a microtask. The spotlight hole stays\n   *  click-through to the target; the rest of the page does not. */\n  awaitClick?: boolean;\n  /** Runs before the step is shown — e.g. navigate to a route, open a panel.\n   *  May be async; the step waits for it, then locates the target. */\n  beforeStep?: () => void | Promise<void>;\n}\n\nexport interface TourLabels {\n  next: string;\n  back: string;\n  skip: string;\n  done: string;\n  /** Shown in place of the Next button on an `awaitClick` step. */\n  awaitClickHint: string;\n  /** Step counter, e.g. (2, 7) => \"2 / 7\". */\n  step: (current: number, total: number) => string;\n}\n\nexport const DEFAULT_TOUR_LABELS: TourLabels = {\n  next: \"Next\",\n  back: \"Back\",\n  skip: \"Skip\",\n  done: \"Done\",\n  awaitClickHint: \"Click the highlighted element to continue\",\n  step: (c, t) => `${c} / ${t}`,\n};\n\ninterface StartOptions {\n  /** Stable id of the tour, surfaced as `activeId` so the app can mirror it to\n   *  the URL (deep-link / evaluation tracking) and record completion. */\n  id?: string;\n  /** Start at this step index instead of 0 (clamped) — for URL/deep-link resume. */\n  startIndex?: number;\n  /** Fires synchronously when the tour starts (e.g. enable a mock interceptor). */\n  onStart?: () => void;\n  onFinish?: () => void;\n  onSkip?: () => void;\n}\n\ninterface TourContextValue {\n  active: boolean;\n  /** Id of the running tour (from {@link StartOptions.id}), else null. */\n  activeId: string | null;\n  /** Start a tour with the given steps. */\n  start: (steps: TourStep[], opts?: StartOptions) => void;\n  /** End the current tour (no callbacks fire). */\n  stop: () => void;\n  /** Advance one step; past the last step it finishes the tour (fires onFinish). */\n  next: () => void;\n  /** Go back one step (no-op on the first). */\n  prev: () => void;\n  /** Jump to a step by index, clamped to range — e.g. for URL/deep-link resume. */\n  goToStep: (index: number) => void;\n  /** Current step (0-based; 0 while inactive). */\n  index: number;\n  /** Total steps (0 while inactive). */\n  total: number;\n}\n\nconst TourContext = createContext<TourContextValue | null>(null);\n\nexport function useTour(): TourContextValue {\n  const ctx = useContext(TourContext);\n  if (!ctx) throw new Error(\"useTour must be used within <TourProvider>\");\n  return ctx;\n}\n\n/**\n * The tour engine if it is there, `null` if it is not — for a control that is a\n * DECORATION rather than a participant.\n *\n * {@link useTour}'s throw is correct and stays: a component that runs a tour cannot do\n * its job without the provider, and failing loudly is how that gets fixed. But the\n * throw's blast radius is whatever error boundary is above it, and for a launcher in\n * the app shell that is the whole app.\n *\n * Keksdose feedback dev#524 is what that costs: an `@hb/ui` module was edited while a\n * dev server was running, vite re-evaluated it, and the module's freshly created\n * context object was no longer the one the mounted provider was providing. React's\n * `useContext` then answers `null` for a provider that is, structurally, right there —\n * and the top bar's tour menu took the entire shell down with it. **Build-time module\n * graphs cannot produce that**, so it is a development-only failure; a menu that\n * disappears for a second is the proportionate response to it either way.\n *\n * Only for controls that can honestly render nothing. If a component would show a\n * broken half of itself without the tour, it wants {@link useTour}.\n */\nexport function useTourOptional(): TourContextValue | null {\n  return useContext(TourContext);\n}\n\n/**\n * Provides the guided-tour engine: a dimmed spotlight overlay + step card driven\n * by a list of {@link TourStep}s. Domain-free — the app supplies the steps (copy,\n * selectors, per-step navigation, placement) and the translated {@link TourLabels}.\n * Mount once inside the router; start a tour from anywhere via {@link useTour},\n * which also exposes step control (`next`/`prev`/`goToStep`) and the current\n * `index`/`total` for URL mirroring, `awaitClick` and deep-link resume.\n */\nexport function TourProvider({\n  children,\n  labels,\n}: {\n  children: ReactNode;\n  labels?: Partial<TourLabels>;\n}) {\n  // `labels` over the provider's `tour` over English. Resolved once here and handed\n  // down: the step card is portalled, but context crosses portals anyway — this is\n  // simply the one place that already owned the merge.\n  const merged = useKitLabels(\"tour\", DEFAULT_TOUR_LABELS, labels);\n  const [steps, setSteps] = useState<TourStep[] | null>(null);\n  const [index, setIndex] = useState(0);\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const optsRef = useRef<StartOptions>({});\n  // Live mirrors so the step-control callbacks can stay stable (identity-safe for\n  // consumers) while still reading the current steps/index.\n  const stepsRef = useRef<TourStep[] | null>(null);\n  stepsRef.current = steps;\n  const indexRef = useRef(0);\n  indexRef.current = index;\n  const active = !!steps && steps.length > 0;\n  const total = steps?.length ?? 0;\n\n  const start = useCallback((s: TourStep[], opts?: StartOptions) => {\n    optsRef.current = opts ?? {};\n    optsRef.current.onStart?.();\n    setIndex(Math.min(Math.max(0, opts?.startIndex ?? 0), Math.max(0, s.length - 1)));\n    setActiveId(opts?.id ?? null);\n    setSteps(s);\n  }, []);\n  const stop = useCallback(() => {\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n  const finish = useCallback(() => {\n    optsRef.current.onFinish?.();\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n  const skip = useCallback(() => {\n    optsRef.current.onSkip?.();\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n\n  const goToStep = useCallback((i: number) => {\n    const len = stepsRef.current?.length ?? 0;\n    if (len === 0) return;\n    setIndex(Math.min(Math.max(0, i), len - 1));\n  }, []);\n  const next = useCallback(() => {\n    const len = stepsRef.current?.length ?? 0;\n    if (len === 0) return;\n    if (indexRef.current >= len - 1) finish();\n    else setIndex(indexRef.current + 1);\n  }, [finish]);\n  const prev = useCallback(() => {\n    if (indexRef.current > 0) setIndex(indexRef.current - 1);\n  }, []);\n\n  return (\n    <TourContext.Provider value={{ active, activeId, start, stop, next, prev, goToStep, index, total }}>\n      {children}\n      {active && (\n        <TourOverlay\n          steps={steps!}\n          index={index}\n          labels={merged}\n          onNext={next}\n          onPrev={prev}\n          onSkip={skip}\n        />\n      )}\n    </TourContext.Provider>\n  );\n}\n\ninterface Rect {\n  top: number;\n  left: number;\n  width: number;\n  height: number;\n}\n\nfunction isVisible(el: Element): boolean {\n  // A non-zero box already rules out display:none on the element or any ancestor\n  // (an unrendered element measures 0x0). We deliberately do NOT test\n  // offsetParent: it is null for position:fixed elements even when fully visible,\n  // which made the mobile bottom-nav bar (fixed) un-highlightable on mobile\n  // (feedback #313). visibility:hidden keeps a box, so check it explicitly.\n  const r = el.getBoundingClientRect();\n  if (r.width <= 0 || r.height <= 0) return false;\n  const style = getComputedStyle(el);\n  return style.visibility !== \"hidden\" && style.display !== \"none\";\n}\n\n// The first VISIBLE element matching the selector, not merely the first in DOM\n// order. This lets a step target the same control across layouts with one\n// combined selector — e.g. the desktop sidebar link AND the mobile bottom-bar\n// link — where the off-layout copy is present but `display:none` (feedback\n// #313). Returns null while none is visible so the finder keeps retrying.\nfunction queryVisibleTarget(selector: string): Element | null {\n  const els = document.querySelectorAll(selector);\n  for (const el of els) {\n    if (isVisible(el)) return el;\n  }\n  return null;\n}\n\nfunction sameRect(a: Rect | null, b: Rect | null): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return a.top === b.top && a.left === b.left && a.width === b.width && a.height === b.height;\n}\n\nfunction TourOverlay({\n  steps,\n  index,\n  labels,\n  onNext,\n  onPrev,\n  onSkip,\n}: {\n  steps: TourStep[];\n  index: number;\n  labels: TourLabels;\n  onNext: () => void;\n  onPrev: () => void;\n  onSkip: () => void;\n}) {\n  const step = steps[index];\n  const isFirst = index === 0;\n  const isLast = index === steps.length - 1;\n  const [rect, setRect] = useState<Rect | null>(null);\n  const [ready, setReady] = useState(false);\n  // The overlay is portalled to <body>, out of whatever `dir` subtree the app set, so it\n  // takes the direction of the element it spotlights (the document's for a centered\n  // step). Arrow keys and start/end placement read it.\n  const [dir, setDir] = useState<Direction>(() => dirOf(null));\n  const rootRef = useRef<HTMLDivElement>(null);\n\n  // Run beforeStep, then locate the target (retrying across route/render lag).\n  useEffect(() => {\n    let cancelled = false;\n    let raf = 0;\n    setReady(false);\n    setRect(null);\n    void (async () => {\n      await step.beforeStep?.();\n      if (cancelled) return;\n      if (!step.target) {\n        setDir(dirOf(null));\n        setReady(true);\n        return;\n      }\n      let tries = 0;\n      const find = () => {\n        if (cancelled) return;\n        const el = queryVisibleTarget(step.target!);\n        if (el) {\n          el.scrollIntoView({ block: \"center\", behavior: \"smooth\" });\n          const r = el.getBoundingClientRect();\n          setRect({ top: r.top, left: r.left, width: r.width, height: r.height });\n          setDir(dirOf(el));\n          setReady(true);\n          return;\n        }\n        if (tries++ < 45) raf = requestAnimationFrame(find);\n        else {\n          setDir(dirOf(null));\n          setReady(true); // give up → render centered\n        }\n      };\n      find();\n    })();\n    return () => {\n      cancelled = true;\n      cancelAnimationFrame(raf);\n    };\n  }, [index, step]);\n\n  // Follow the target as the page scrolls / reflows.\n  useEffect(() => {\n    if (!step.target) return;\n    const update = () => {\n      const el = queryVisibleTarget(step.target!);\n      if (el) {\n        const r = el.getBoundingClientRect();\n        const next = { top: r.top, left: r.left, width: r.width, height: r.height };\n        setRect((prev) => (sameRect(prev, next) ? prev : next));\n      }\n    };\n    window.addEventListener(\"scroll\", update, true);\n    window.addEventListener(\"resize\", update);\n    const id = window.setInterval(update, 250);\n    return () => {\n      window.removeEventListener(\"scroll\", update, true);\n      window.removeEventListener(\"resize\", update);\n      clearInterval(id);\n    };\n  }, [index, step]);\n\n  // awaitClick: advance when the *real* target is clicked. The spotlight hole is\n  // click-through (see the shields in the render below) so the element's own\n  // handler runs first; we step forward on the next macrotask.\n  useEffect(() => {\n    if (!ready || !step.awaitClick || !step.target) return;\n    const el = queryVisibleTarget(step.target);\n    if (!el) return;\n    const onClick = () => window.setTimeout(() => onNext(), 0);\n    el.addEventListener(\"click\", onClick, { once: true });\n    return () => el.removeEventListener(\"click\", onClick);\n  }, [ready, index, step, onNext]);\n\n  // Keyboard: Esc skips, Enter and the reading-direction arrow advance (→ in LTR,\n  // ← in RTL), the other arrow goes back. On awaitClick steps Enter is ignored (it\n  // would fire the target's click AND advance) — the forward arrow stays as an escape\n  // hatch.\n  //\n  // Enter on a focused control belongs to that control. This used to advance from\n  // anywhere, so Enter on a focused Skip or Back ran the button's own click AND stepped\n  // forward: Back moved nowhere, Skip skipped and then called `next` on a dead tour.\n  // The same goes for arrows in a text field a step's `action` might contain.\n  useEffect(() => {\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") {\n        onSkip();\n        return;\n      }\n      if (e.key === \"Enter\") {\n        if (step.awaitClick || ownsKey(e.target, \"Enter\")) return;\n        e.preventDefault();\n        onNext();\n        return;\n      }\n      if (ownsKey(e.target, e.key)) return;\n      // The overlay root carries `dir`; before it paints, the document's answers.\n      const delta = horizontalStep(e.key, rootRef.current);\n      if (delta === 1) {\n        e.preventDefault();\n        onNext();\n      } else if (delta === -1) {\n        if (!isFirst) onPrev();\n      }\n    };\n    document.addEventListener(\"keydown\", onKey);\n    return () => document.removeEventListener(\"keydown\", onKey);\n  }, [isFirst, step, onNext, onPrev, onSkip]);\n\n  if (!ready) return null;\n\n  const pad = step.padding ?? 8;\n  const spot: Rect | null = rect\n    ? { top: rect.top - pad, left: rect.left - pad, width: rect.width + pad * 2, height: rect.height + pad * 2 }\n    : null;\n\n  // `aria-modal` promises the page behind is out of reach, and the card's focus trap\n  // keeps that promise for the keyboard. The pointer used to get no such treatment: the\n  // root is `pointer-events-none` so that the spotlight hole can stay live for\n  // `awaitClick`, and the scrim is a box-shadow, which takes no clicks — so every\n  // control on the dimmed page stayed clickable. Four shields now tile the viewport\n  // around the hole: the page is blocked, the card and the spotlighted target are not.\n  // Keeping `aria-modal` (rather than dropping it) is the coherent half: the tour\n  // really is modal — focus is trapped and Esc/Skip is the way out.\n  return createPortal(\n    <div\n      ref={rootRef}\n      className=\"pointer-events-none fixed inset-0 z-[60]\"\n      role=\"dialog\"\n      aria-modal=\"true\"\n      aria-label={step.title}\n      dir={dir}\n    >\n      {spot && <SpotlightShields spot={spot} />}\n      {spot ? (\n        <div\n          className=\"pointer-events-none fixed rounded-lg transition-all duration-200 ease-out\"\n          style={{\n            top: spot.top,\n            left: spot.left,\n            width: spot.width,\n            height: spot.height,\n            // A two-tone frame, not a single translucent ring.\n            //\n            // The old treatment was `ring-2 ring-white/80` over a 55% scrim, and it\n            // \"was barely visible\" on the app's blue-tinted surfaces. Two reasons,\n            // and a single ring can't fix either: at 55% the surround stays bright\n            // enough that the un-dimmed hole barely reads AS a hole, and a 80%-white\n            // ring sitting on the edge of a light card is white-on-near-white.\n            //\n            // So: an opaque white band immediately around the target, a dark keyline\n            // outside it, then the scrim. Whatever the target's own colour is, one of\n            // the two bands is always in contrast with it and the other is always in\n            // contrast with the dimmed surround — there is no background that can\n            // swallow both. The blurred layer between them softens the step so the\n            // frame reads as lighting rather than as a pasted-on rectangle.\n            boxShadow: [\n              \"0 0 0 3px rgba(255,255,255,0.98)\",\n              \"0 0 0 5px rgba(15,23,42,0.92)\",\n              \"0 0 18px 6px rgba(15,23,42,0.45)\",\n              \"0 0 0 9999px rgba(15,23,42,0.70)\",\n            ].join(\", \"),\n          }}\n        />\n      ) : (\n        <div className=\"pointer-events-auto fixed inset-0 bg-black/70\" />\n      )}\n      <TourCard\n        step={step}\n        index={index}\n        total={steps.length}\n        labels={labels}\n        isFirst={isFirst}\n        isLast={isLast}\n        rect={spot}\n        dir={dir}\n        onBack={onPrev}\n        onNext={onNext}\n        onSkip={onSkip}\n      />\n    </div>,\n    document.body,\n  );\n}\n\n/** Does the focused element handle `key` itself? Enter on a button or link, and any\n *  editing key in a text field or select, is the control's — not the tour's. */\nfunction ownsKey(target: EventTarget | null, key: string): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  const tag = target.tagName;\n  if (tag === \"TEXTAREA\" || tag === \"SELECT\") return true;\n  if (tag === \"INPUT\") {\n    const type = (target as HTMLInputElement).type;\n    // Enter on a checkbox does nothing natively, but ←/→ on a radio moves it.\n    return key !== \"Enter\" || type !== \"checkbox\";\n  }\n  if (key !== \"Enter\") return false;\n  return (\n    tag === \"BUTTON\" ||\n    (tag === \"A\" && target.hasAttribute(\"href\")) ||\n    target.getAttribute(\"role\") === \"button\" ||\n    target.getAttribute(\"role\") === \"link\"\n  );\n}\n\n/**\n * Transparent pointer blockers tiling the viewport around the spotlight hole: one\n * full-width band above and below, one on each side at the hole's own height. The hole\n * itself stays uncovered, so the target keeps its clicks.\n */\nfunction SpotlightShields({ spot }: { spot: Rect }) {\n  const shield = \"pointer-events-auto fixed\";\n  const bottom = spot.top + spot.height;\n  return (\n    <>\n      <div data-tour-shield=\"\" className={shield} style={{ top: 0, left: 0, right: 0, height: Math.max(0, spot.top) }} />\n      <div data-tour-shield=\"\" className={shield} style={{ top: bottom, left: 0, right: 0, bottom: 0 }} />\n      <div\n        data-tour-shield=\"\"\n        className={shield}\n        style={{ top: spot.top, left: 0, width: Math.max(0, spot.left), height: spot.height }}\n      />\n      <div\n        data-tour-shield=\"\"\n        className={shield}\n        style={{ top: spot.top, left: spot.left + spot.width, right: 0, height: spot.height }}\n      />\n    </>\n  );\n}\n\n/**\n * Card position (viewport px) for the given placement relative to the padded\n * spotlight `rect`. Omitted placement keeps the original auto behavior\n * (below → above → vertically centered); an explicit side flips to its opposite\n * if it would overflow, then clamps into the viewport. \"center\" (or no rect)\n * centers on screen.\n */\nfunction placeCard(\n  rect: Rect | null,\n  cw: number,\n  ch: number,\n  vw: number,\n  vh: number,\n  m: number,\n  placement?: TourPlacement,\n  dir: Direction = \"ltr\",\n): { top: number; left: number } {\n  // The logical sides resolve to a physical one here, and only here.\n  if (placement === \"start\") placement = dir === \"rtl\" ? \"right\" : \"left\";\n  else if (placement === \"end\") placement = dir === \"rtl\" ? \"left\" : \"right\";\n  if (!rect || placement === \"center\") {\n    return { top: Math.max(m, (vh - ch) / 2), left: Math.max(m, (vw - cw) / 2) };\n  }\n  const clampX = (x: number) => Math.min(Math.max(m, x), Math.max(m, vw - cw - m));\n  const clampY = (y: number) => Math.min(Math.max(m, y), Math.max(m, vh - ch - m));\n  const centerX = clampX(rect.left + rect.width / 2 - cw / 2);\n  const centerY = clampY(rect.top + rect.height / 2 - ch / 2);\n  const belowTop = rect.top + rect.height + m;\n  const aboveTop = rect.top - ch - m;\n  const rightLeft = rect.left + rect.width + m;\n  const leftLeft = rect.left - cw - m;\n  const fitsBelow = belowTop + ch <= vh;\n  const fitsAbove = aboveTop >= 0;\n  const fitsRight = rightLeft + cw <= vw;\n  const fitsLeft = leftLeft >= 0;\n\n  switch (placement) {\n    case \"top\":\n      return { top: fitsAbove ? aboveTop : fitsBelow ? belowTop : clampY(aboveTop), left: centerX };\n    case \"bottom\":\n      return { top: fitsBelow ? belowTop : fitsAbove ? aboveTop : clampY(belowTop), left: centerX };\n    case \"right\":\n      return { top: centerY, left: fitsRight ? rightLeft : fitsLeft ? leftLeft : clampX(rightLeft) };\n    case \"left\":\n      return { top: centerY, left: fitsLeft ? leftLeft : fitsRight ? rightLeft : clampX(leftLeft) };\n    default:\n      if (fitsBelow) return { top: belowTop, left: centerX };\n      if (fitsAbove) return { top: aboveTop, left: centerX };\n      return { top: Math.max(m, (vh - ch) / 2), left: centerX };\n  }\n}\n\nfunction TourCard({\n  step,\n  index,\n  total,\n  labels,\n  isFirst,\n  isLast,\n  rect,\n  dir,\n  onBack,\n  onNext,\n  onSkip,\n}: {\n  step: TourStep;\n  index: number;\n  total: number;\n  labels: TourLabels;\n  isFirst: boolean;\n  isLast: boolean;\n  rect: Rect | null;\n  dir: Direction;\n  onBack: () => void;\n  onNext: () => void;\n  onSkip: () => void;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const [style, setStyle] = useState<CSSProperties>({ opacity: 0 });\n\n  /**\n   * The card holds the focus, because the card is what the tour IS.\n   *\n   * The overlay above declares `role=\"dialog\" aria-modal=\"true\"` — it always has — and\n   * then left focus wherever the page had put it. For a tour that is the most pointed\n   * version of the audit's *\"Only Modal manages focus\"*: the whole component exists to\n   * say \"look here\", and for a keyboard user \"here\" is the focus ring. They were told\n   * the page was hidden, given no way to reach the Next button without Tabbing through\n   * it, and left on a control the screen reader would no longer describe.\n   *\n   * It re-engages on every step, without any bookkeeping here, because `TourOverlay`\n   * returns null while it re-locates the next target: the card genuinely unmounts and\n   * remounts between steps. That is what keeps focus honest when the BUTTONS change —\n   * \"Back\" does not exist on the first step, so stepping back onto it destroys the\n   * control the press came from, and focus would otherwise fall to `<body>`, outside\n   * this trap's own listener, where Tab walks straight into the page the overlay claims\n   * to have hidden.\n   *\n   * **The cost, written down:** on an `awaitClick` step the user is asked to click the\n   * spotlighted element, and they can no longer Tab to it. ArrowRight still advances\n   * (the key handler in `TourOverlay` is on the document and does not care where focus\n   * is), which is the escape hatch that step already documents for the case where the\n   * target cannot be found. Containment is worth that: an `awaitClick` step is a\n   * minority of steps, while focus stranded behind `aria-modal` is every step.\n   */\n  useFocusTrap(ref, { active: true });\n\n  useLayoutEffect(() => {\n    const card = ref.current;\n    if (!card) return;\n    setStyle(\n      placeCard(rect, card.offsetWidth, card.offsetHeight, window.innerWidth, window.innerHeight, 12, step.placement, dir),\n    );\n  }, [rect, index, step.placement, dir]);\n\n  return (\n    <div\n      ref={ref}\n      // Focusable but not tabbable: the trap above focuses the card itself rather than\n      // its first button, so a screen reader reads the step's title and body before it\n      // reads \"Next\" — and without this the container cannot take focus at all and the\n      // trap silently does nothing.\n      tabIndex={-1}\n      style={style}\n      className=\"pointer-events-auto fixed z-[61] w-80 max-w-[calc(100vw-1.5rem)] rounded-lg border border-[var(--border)] bg-[var(--bg-surface)] p-4 shadow-xl outline-none transition-all duration-200 ease-out\"\n    >\n      <div className=\"text-sm font-semibold text-[var(--text-primary)]\">{step.title}</div>\n      <div className=\"mt-1 text-sm leading-relaxed text-[var(--text-secondary)]\">{step.body}</div>\n      {step.action && <div className=\"mt-3\">{step.action}</div>}\n      <div className=\"mt-4 space-y-2\">\n        <div className=\"flex items-center justify-between gap-2\">\n          <button\n            type=\"button\"\n            onClick={onSkip}\n            className=\"text-xs text-[var(--text-placeholder)] hover:text-[var(--text-secondary)]\"\n          >\n            {labels.skip}\n          </button>\n          <div className=\"flex items-center gap-2\">\n            <span className=\"whitespace-nowrap text-xs tabular-nums text-[var(--text-placeholder)]\">\n              {labels.step(index + 1, total)}\n            </span>\n            {!isFirst && (\n              <Button variant=\"secondary\" onClick={onBack} className=\"px-2.5 py-1 text-xs\">\n                {labels.back}\n              </Button>\n            )}\n            {/* On an awaitClick step the Next button is replaced by a hint on its\n                own row below, so it doesn't cram the counter + buttons and wrap.\n                Only when the target was actually FOUND, though — `rect` is null\n                when the finder gave up, and the click listener early-returns on\n                the same absence. Keyed on `step.target` alone this hid the only\n                way forward on any step whose anchor happens not to be rendered\n                for this user (a guest sees no \"add account\" button), leaving the\n                undocumented ArrowRight key as the sole escape. */}\n            {!(step.awaitClick && step.target && rect) && (\n              <Button variant=\"brand\" onClick={onNext} className={cn(\"px-2.5 py-1 text-xs\")}>\n                {isLast ? labels.done : labels.next}\n              </Button>\n            )}\n          </div>\n        </div>\n        {step.awaitClick && step.target && rect && (\n          <div className=\"text-center text-xs italic text-[var(--text-placeholder)]\">\n            {labels.awaitClickHint}\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/tour/tour.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useRef,\n  useState,\n} from \"react\";\nimport type { CSSProperties, ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { cn } from \"../lib/cn\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { Button } from \"../components/ui\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { dirOf, horizontalStep } from \"../lib/direction\";\nimport type { Direction } from \"../lib/direction\";\n\n/**\n * `start`/`end` follow the reading direction (`end` is the right side in LTR and the\n * left side in RTL) and are what a translated app wants. `left`/`right` stay physical\n * for the steps that genuinely mean a screen side.\n */\nexport type TourPlacement = \"top\" | \"right\" | \"bottom\" | \"left\" | \"start\" | \"end\" | \"center\";\n\nexport interface TourStep {\n  /** CSS selector for the element to spotlight. Omit for a centered step\n   *  (welcome/finish). If the target isn't found/visible, the step centers. */\n  target?: string;\n  title: string;\n  body: ReactNode;\n  /** Extra footer content, e.g. a \"load sample data\" shortcut. */\n  action?: ReactNode;\n  /** Spotlight padding around the target, px (default 8). */\n  padding?: number;\n  /** Where the card sits relative to the target. Omit for auto placement\n   *  (below → above → centered). \"center\" ignores the target and centers on\n   *  screen. \"start\"/\"end\" are the logical sides and flip in RTL; \"left\"/\"right\"\n   *  are physical. An explicit side flips to the opposite side if it would\n   *  overflow, then clamps into the viewport. */\n  placement?: TourPlacement;\n  /** Advance only when the user clicks the spotlighted target itself (not the\n   *  card's Next button). Requires `target`: the real control's own handler runs\n   *  first, then the tour steps forward on a microtask. The spotlight hole stays\n   *  click-through to the target; the rest of the page does not. */\n  awaitClick?: boolean;\n  /** Runs before the step is shown — e.g. navigate to a route, open a panel.\n   *  May be async; the step waits for it, then locates the target. */\n  beforeStep?: () => void | Promise<void>;\n}\n\nexport interface TourLabels {\n  next: string;\n  back: string;\n  skip: string;\n  done: string;\n  /** Shown in place of the Next button on an `awaitClick` step. */\n  awaitClickHint: string;\n  /** Step counter, e.g. (2, 7) => \"2 / 7\". */\n  step: (current: number, total: number) => string;\n}\n\nexport const DEFAULT_TOUR_LABELS: TourLabels = {\n  next: \"Next\",\n  back: \"Back\",\n  skip: \"Skip\",\n  done: \"Done\",\n  awaitClickHint: \"Click the highlighted element to continue\",\n  step: (c, t) => `${c} / ${t}`,\n};\n\ninterface StartOptions {\n  /** Stable id of the tour, surfaced as `activeId` so the app can mirror it to\n   *  the URL (deep-link / evaluation tracking) and record completion. */\n  id?: string;\n  /** Start at this step index instead of 0 (clamped) — for URL/deep-link resume. */\n  startIndex?: number;\n  /** Fires synchronously when the tour starts (e.g. enable a mock interceptor). */\n  onStart?: () => void;\n  onFinish?: () => void;\n  onSkip?: () => void;\n}\n\ninterface TourContextValue {\n  active: boolean;\n  /** Id of the running tour (from {@link StartOptions.id}), else null. */\n  activeId: string | null;\n  /** Start a tour with the given steps. */\n  start: (steps: TourStep[], opts?: StartOptions) => void;\n  /** End the current tour (no callbacks fire). */\n  stop: () => void;\n  /** Advance one step; past the last step it finishes the tour (fires onFinish). */\n  next: () => void;\n  /** Go back one step (no-op on the first). */\n  prev: () => void;\n  /** Jump to a step by index, clamped to range — e.g. for URL/deep-link resume. */\n  goToStep: (index: number) => void;\n  /** Current step (0-based; 0 while inactive). */\n  index: number;\n  /** Total steps (0 while inactive). */\n  total: number;\n}\n\nconst TourContext = createContext<TourContextValue | null>(null);\n\nexport function useTour(): TourContextValue {\n  const ctx = useContext(TourContext);\n  if (!ctx) throw new Error(\"useTour must be used within <TourProvider>\");\n  return ctx;\n}\n\n/**\n * The tour engine if it is there, `null` if it is not — for a control that is a\n * DECORATION rather than a participant.\n *\n * {@link useTour}'s throw is correct and stays: a component that runs a tour cannot do\n * its job without the provider, and failing loudly is how that gets fixed. But the\n * throw's blast radius is whatever error boundary is above it, and for a launcher in\n * the app shell that is the whole app.\n *\n * Keksdose feedback dev#524 is what that costs: an `@hb/ui` module was edited while a\n * dev server was running, vite re-evaluated it, and the module's freshly created\n * context object was no longer the one the mounted provider was providing. React's\n * `useContext` then answers `null` for a provider that is, structurally, right there —\n * and the top bar's tour menu took the entire shell down with it. **Build-time module\n * graphs cannot produce that**, so it is a development-only failure; a menu that\n * disappears for a second is the proportionate response to it either way.\n *\n * Only for controls that can honestly render nothing. If a component would show a\n * broken half of itself without the tour, it wants {@link useTour}.\n */\nexport function useTourOptional(): TourContextValue | null {\n  return useContext(TourContext);\n}\n\n/**\n * Provides the guided-tour engine: a dimmed spotlight overlay + step card driven\n * by a list of {@link TourStep}s. Domain-free — the app supplies the steps (copy,\n * selectors, per-step navigation, placement) and the translated {@link TourLabels}.\n * Mount once inside the router; start a tour from anywhere via {@link useTour},\n * which also exposes step control (`next`/`prev`/`goToStep`) and the current\n * `index`/`total` for URL mirroring, `awaitClick` and deep-link resume.\n */\nexport function TourProvider({\n  children,\n  labels,\n}: {\n  children: ReactNode;\n  labels?: Partial<TourLabels>;\n}) {\n  // `labels` over the provider's `tour` over English. Resolved once here and handed\n  // down: the step card is portalled, but context crosses portals anyway — this is\n  // simply the one place that already owned the merge.\n  const merged = useKitLabels(\"tour\", DEFAULT_TOUR_LABELS, labels);\n  const [steps, setSteps] = useState<TourStep[] | null>(null);\n  const [index, setIndex] = useState(0);\n  const [activeId, setActiveId] = useState<string | null>(null);\n  const optsRef = useRef<StartOptions>({});\n  // Live mirrors so the step-control callbacks can stay stable (identity-safe for\n  // consumers) while still reading the current steps/index. Synced in a layout\n  // effect — after the commit, before paint and before any passive effect or event\n  // can call them — rather than written during render.\n  const stepsRef = useRef<TourStep[] | null>(null);\n  const indexRef = useRef(0);\n  useLayoutEffect(() => {\n    stepsRef.current = steps;\n    indexRef.current = index;\n  }, [steps, index]);\n  const active = !!steps && steps.length > 0;\n  const total = steps?.length ?? 0;\n\n  const start = useCallback((s: TourStep[], opts?: StartOptions) => {\n    optsRef.current = opts ?? {};\n    optsRef.current.onStart?.();\n    setIndex(Math.min(Math.max(0, opts?.startIndex ?? 0), Math.max(0, s.length - 1)));\n    setActiveId(opts?.id ?? null);\n    setSteps(s);\n  }, []);\n  const stop = useCallback(() => {\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n  const finish = useCallback(() => {\n    optsRef.current.onFinish?.();\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n  const skip = useCallback(() => {\n    optsRef.current.onSkip?.();\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n\n  const goToStep = useCallback((i: number) => {\n    const len = stepsRef.current?.length ?? 0;\n    if (len === 0) return;\n    setIndex(Math.min(Math.max(0, i), len - 1));\n  }, []);\n  const next = useCallback(() => {\n    const len = stepsRef.current?.length ?? 0;\n    if (len === 0) return;\n    if (indexRef.current >= len - 1) finish();\n    else setIndex(indexRef.current + 1);\n  }, [finish]);\n  const prev = useCallback(() => {\n    if (indexRef.current > 0) setIndex(indexRef.current - 1);\n  }, []);\n\n  return (\n    <TourContext.Provider value={{ active, activeId, start, stop, next, prev, goToStep, index, total }}>\n      {children}\n      {active && (\n        <TourOverlay\n          steps={steps!}\n          index={index}\n          labels={merged}\n          onNext={next}\n          onPrev={prev}\n          onSkip={skip}\n        />\n      )}\n    </TourContext.Provider>\n  );\n}\n\ninterface Rect {\n  top: number;\n  left: number;\n  width: number;\n  height: number;\n}\n\nfunction isVisible(el: Element): boolean {\n  // A non-zero box already rules out display:none on the element or any ancestor\n  // (an unrendered element measures 0x0). We deliberately do NOT test\n  // offsetParent: it is null for position:fixed elements even when fully visible,\n  // which made the mobile bottom-nav bar (fixed) un-highlightable on mobile\n  // (feedback #313). visibility:hidden keeps a box, so check it explicitly.\n  const r = el.getBoundingClientRect();\n  if (r.width <= 0 || r.height <= 0) return false;\n  const style = getComputedStyle(el);\n  return style.visibility !== \"hidden\" && style.display !== \"none\";\n}\n\n// The first VISIBLE element matching the selector, not merely the first in DOM\n// order. This lets a step target the same control across layouts with one\n// combined selector — e.g. the desktop sidebar link AND the mobile bottom-bar\n// link — where the off-layout copy is present but `display:none` (feedback\n// #313). Returns null while none is visible so the finder keeps retrying.\nfunction queryVisibleTarget(selector: string): Element | null {\n  const els = document.querySelectorAll(selector);\n  for (const el of els) {\n    if (isVisible(el)) return el;\n  }\n  return null;\n}\n\nfunction sameRect(a: Rect | null, b: Rect | null): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return a.top === b.top && a.left === b.left && a.width === b.width && a.height === b.height;\n}\n\nfunction TourOverlay({\n  steps,\n  index,\n  labels,\n  onNext,\n  onPrev,\n  onSkip,\n}: {\n  steps: TourStep[];\n  index: number;\n  labels: TourLabels;\n  onNext: () => void;\n  onPrev: () => void;\n  onSkip: () => void;\n}) {\n  const step = steps[index];\n  const isFirst = index === 0;\n  const isLast = index === steps.length - 1;\n  const [rect, setRect] = useState<Rect | null>(null);\n  const [ready, setReady] = useState(false);\n  // A new step starts unlocated: reset during render when the step changes, so the\n  // previous step's spotlight never paints over the new one. The effect below then\n  // locates it.\n  const [locating, setLocating] = useState({ index, step });\n  if (locating.index !== index || locating.step !== step) {\n    setLocating({ index, step });\n    setReady(false);\n    setRect(null);\n  }\n  // The overlay is portalled to <body>, out of whatever `dir` subtree the app set, so it\n  // takes the direction of the element it spotlights (the document's for a centered\n  // step). Arrow keys and start/end placement read it.\n  const [dir, setDir] = useState<Direction>(() => dirOf(null));\n  const rootRef = useRef<HTMLDivElement>(null);\n\n  // Run beforeStep, then locate the target (retrying across route/render lag).\n  useEffect(() => {\n    let cancelled = false;\n    let raf = 0;\n    void (async () => {\n      await step.beforeStep?.();\n      if (cancelled) return;\n      if (!step.target) {\n        setDir(dirOf(null));\n        setReady(true);\n        return;\n      }\n      let tries = 0;\n      const find = () => {\n        if (cancelled) return;\n        const el = queryVisibleTarget(step.target!);\n        if (el) {\n          el.scrollIntoView({ block: \"center\", behavior: \"smooth\" });\n          const r = el.getBoundingClientRect();\n          setRect({ top: r.top, left: r.left, width: r.width, height: r.height });\n          setDir(dirOf(el));\n          setReady(true);\n          return;\n        }\n        if (tries++ < 45) raf = requestAnimationFrame(find);\n        else {\n          setDir(dirOf(null));\n          setReady(true); // give up → render centered\n        }\n      };\n      find();\n    })();\n    return () => {\n      cancelled = true;\n      cancelAnimationFrame(raf);\n    };\n  }, [index, step]);\n\n  // Follow the target as the page scrolls / reflows.\n  useEffect(() => {\n    if (!step.target) return;\n    const update = () => {\n      const el = queryVisibleTarget(step.target!);\n      if (el) {\n        const r = el.getBoundingClientRect();\n        const next = { top: r.top, left: r.left, width: r.width, height: r.height };\n        setRect((prev) => (sameRect(prev, next) ? prev : next));\n      }\n    };\n    window.addEventListener(\"scroll\", update, true);\n    window.addEventListener(\"resize\", update);\n    const id = window.setInterval(update, 250);\n    return () => {\n      window.removeEventListener(\"scroll\", update, true);\n      window.removeEventListener(\"resize\", update);\n      clearInterval(id);\n    };\n  }, [index, step]);\n\n  // awaitClick: advance when the *real* target is clicked. The spotlight hole is\n  // click-through (see the shields in the render below) so the element's own\n  // handler runs first; we step forward on the next macrotask.\n  useEffect(() => {\n    if (!ready || !step.awaitClick || !step.target) return;\n    const el = queryVisibleTarget(step.target);\n    if (!el) return;\n    const onClick = () => window.setTimeout(() => onNext(), 0);\n    el.addEventListener(\"click\", onClick, { once: true });\n    return () => el.removeEventListener(\"click\", onClick);\n  }, [ready, index, step, onNext]);\n\n  // Keyboard: Esc skips, Enter and the reading-direction arrow advance (→ in LTR,\n  // ← in RTL), the other arrow goes back. On awaitClick steps Enter is ignored (it\n  // would fire the target's click AND advance) — the forward arrow stays as an escape\n  // hatch.\n  //\n  // Enter on a focused control belongs to that control. This used to advance from\n  // anywhere, so Enter on a focused Skip or Back ran the button's own click AND stepped\n  // forward: Back moved nowhere, Skip skipped and then called `next` on a dead tour.\n  // The same goes for arrows in a text field a step's `action` might contain.\n  useEffect(() => {\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\") {\n        onSkip();\n        return;\n      }\n      if (e.key === \"Enter\") {\n        if (step.awaitClick || ownsKey(e.target, \"Enter\")) return;\n        e.preventDefault();\n        onNext();\n        return;\n      }\n      if (ownsKey(e.target, e.key)) return;\n      // The overlay root carries `dir`; before it paints, the document's answers.\n      const delta = horizontalStep(e.key, rootRef.current);\n      if (delta === 1) {\n        e.preventDefault();\n        onNext();\n      } else if (delta === -1) {\n        if (!isFirst) onPrev();\n      }\n    };\n    document.addEventListener(\"keydown\", onKey);\n    return () => document.removeEventListener(\"keydown\", onKey);\n  }, [isFirst, step, onNext, onPrev, onSkip]);\n\n  if (!ready) return null;\n\n  const pad = step.padding ?? 8;\n  const spot: Rect | null = rect\n    ? { top: rect.top - pad, left: rect.left - pad, width: rect.width + pad * 2, height: rect.height + pad * 2 }\n    : null;\n\n  // `aria-modal` promises the page behind is out of reach, and the card's focus trap\n  // keeps that promise for the keyboard. The pointer used to get no such treatment: the\n  // root is `pointer-events-none` so that the spotlight hole can stay live for\n  // `awaitClick`, and the scrim is a box-shadow, which takes no clicks — so every\n  // control on the dimmed page stayed clickable. Four shields now tile the viewport\n  // around the hole: the page is blocked, the card and the spotlighted target are not.\n  // Keeping `aria-modal` (rather than dropping it) is the coherent half: the tour\n  // really is modal — focus is trapped and Esc/Skip is the way out.\n  return createPortal(\n    <div\n      ref={rootRef}\n      className=\"pointer-events-none fixed inset-0 z-[60]\"\n      role=\"dialog\"\n      aria-modal=\"true\"\n      aria-label={step.title}\n      dir={dir}\n    >\n      {spot && <SpotlightShields spot={spot} />}\n      {spot ? (\n        <div\n          className=\"pointer-events-none fixed rounded-lg transition-all duration-200 ease-out\"\n          style={{\n            top: spot.top,\n            left: spot.left,\n            width: spot.width,\n            height: spot.height,\n            // A two-tone frame, not a single translucent ring.\n            //\n            // The old treatment was `ring-2 ring-white/80` over a 55% scrim, and it\n            // \"was barely visible\" on the app's blue-tinted surfaces. Two reasons,\n            // and a single ring can't fix either: at 55% the surround stays bright\n            // enough that the un-dimmed hole barely reads AS a hole, and a 80%-white\n            // ring sitting on the edge of a light card is white-on-near-white.\n            //\n            // So: an opaque white band immediately around the target, a dark keyline\n            // outside it, then the scrim. Whatever the target's own colour is, one of\n            // the two bands is always in contrast with it and the other is always in\n            // contrast with the dimmed surround — there is no background that can\n            // swallow both. The blurred layer between them softens the step so the\n            // frame reads as lighting rather than as a pasted-on rectangle.\n            boxShadow: [\n              \"0 0 0 3px rgba(255,255,255,0.98)\",\n              \"0 0 0 5px rgba(15,23,42,0.92)\",\n              \"0 0 18px 6px rgba(15,23,42,0.45)\",\n              \"0 0 0 9999px rgba(15,23,42,0.70)\",\n            ].join(\", \"),\n          }}\n        />\n      ) : (\n        <div className=\"pointer-events-auto fixed inset-0 bg-black/70\" />\n      )}\n      <TourCard\n        step={step}\n        index={index}\n        total={steps.length}\n        labels={labels}\n        isFirst={isFirst}\n        isLast={isLast}\n        rect={spot}\n        dir={dir}\n        onBack={onPrev}\n        onNext={onNext}\n        onSkip={onSkip}\n      />\n    </div>,\n    document.body,\n  );\n}\n\n/** Does the focused element handle `key` itself? Enter on a button or link, and any\n *  editing key in a text field or select, is the control's — not the tour's. */\nfunction ownsKey(target: EventTarget | null, key: string): boolean {\n  if (!(target instanceof HTMLElement)) return false;\n  if (target.isContentEditable) return true;\n  const tag = target.tagName;\n  if (tag === \"TEXTAREA\" || tag === \"SELECT\") return true;\n  if (tag === \"INPUT\") {\n    const type = (target as HTMLInputElement).type;\n    // Enter on a checkbox does nothing natively, but ←/→ on a radio moves it.\n    return key !== \"Enter\" || type !== \"checkbox\";\n  }\n  if (key !== \"Enter\") return false;\n  return (\n    tag === \"BUTTON\" ||\n    (tag === \"A\" && target.hasAttribute(\"href\")) ||\n    target.getAttribute(\"role\") === \"button\" ||\n    target.getAttribute(\"role\") === \"link\"\n  );\n}\n\n/**\n * Transparent pointer blockers tiling the viewport around the spotlight hole: one\n * full-width band above and below, one on each side at the hole's own height. The hole\n * itself stays uncovered, so the target keeps its clicks.\n */\nfunction SpotlightShields({ spot }: { spot: Rect }) {\n  const shield = \"pointer-events-auto fixed\";\n  const bottom = spot.top + spot.height;\n  return (\n    <>\n      <div data-tour-shield=\"\" className={shield} style={{ top: 0, left: 0, right: 0, height: Math.max(0, spot.top) }} />\n      <div data-tour-shield=\"\" className={shield} style={{ top: bottom, left: 0, right: 0, bottom: 0 }} />\n      <div\n        data-tour-shield=\"\"\n        className={shield}\n        style={{ top: spot.top, left: 0, width: Math.max(0, spot.left), height: spot.height }}\n      />\n      <div\n        data-tour-shield=\"\"\n        className={shield}\n        style={{ top: spot.top, left: spot.left + spot.width, right: 0, height: spot.height }}\n      />\n    </>\n  );\n}\n\n/**\n * Card position (viewport px) for the given placement relative to the padded\n * spotlight `rect`. Omitted placement keeps the original auto behavior\n * (below → above → vertically centered); an explicit side flips to its opposite\n * if it would overflow, then clamps into the viewport. \"center\" (or no rect)\n * centers on screen.\n */\nfunction placeCard(\n  rect: Rect | null,\n  cw: number,\n  ch: number,\n  vw: number,\n  vh: number,\n  m: number,\n  placement?: TourPlacement,\n  dir: Direction = \"ltr\",\n): { top: number; left: number } {\n  // The logical sides resolve to a physical one here, and only here.\n  if (placement === \"start\") placement = dir === \"rtl\" ? \"right\" : \"left\";\n  else if (placement === \"end\") placement = dir === \"rtl\" ? \"left\" : \"right\";\n  if (!rect || placement === \"center\") {\n    return { top: Math.max(m, (vh - ch) / 2), left: Math.max(m, (vw - cw) / 2) };\n  }\n  const clampX = (x: number) => Math.min(Math.max(m, x), Math.max(m, vw - cw - m));\n  const clampY = (y: number) => Math.min(Math.max(m, y), Math.max(m, vh - ch - m));\n  const centerX = clampX(rect.left + rect.width / 2 - cw / 2);\n  const centerY = clampY(rect.top + rect.height / 2 - ch / 2);\n  const belowTop = rect.top + rect.height + m;\n  const aboveTop = rect.top - ch - m;\n  const rightLeft = rect.left + rect.width + m;\n  const leftLeft = rect.left - cw - m;\n  const fitsBelow = belowTop + ch <= vh;\n  const fitsAbove = aboveTop >= 0;\n  const fitsRight = rightLeft + cw <= vw;\n  const fitsLeft = leftLeft >= 0;\n\n  switch (placement) {\n    case \"top\":\n      return { top: fitsAbove ? aboveTop : fitsBelow ? belowTop : clampY(aboveTop), left: centerX };\n    case \"bottom\":\n      return { top: fitsBelow ? belowTop : fitsAbove ? aboveTop : clampY(belowTop), left: centerX };\n    case \"right\":\n      return { top: centerY, left: fitsRight ? rightLeft : fitsLeft ? leftLeft : clampX(rightLeft) };\n    case \"left\":\n      return { top: centerY, left: fitsLeft ? leftLeft : fitsRight ? rightLeft : clampX(leftLeft) };\n    default:\n      if (fitsBelow) return { top: belowTop, left: centerX };\n      if (fitsAbove) return { top: aboveTop, left: centerX };\n      return { top: Math.max(m, (vh - ch) / 2), left: centerX };\n  }\n}\n\nfunction TourCard({\n  step,\n  index,\n  total,\n  labels,\n  isFirst,\n  isLast,\n  rect,\n  dir,\n  onBack,\n  onNext,\n  onSkip,\n}: {\n  step: TourStep;\n  index: number;\n  total: number;\n  labels: TourLabels;\n  isFirst: boolean;\n  isLast: boolean;\n  rect: Rect | null;\n  dir: Direction;\n  onBack: () => void;\n  onNext: () => void;\n  onSkip: () => void;\n}) {\n  const ref = useRef<HTMLDivElement>(null);\n  const [style, setStyle] = useState<CSSProperties>({ opacity: 0 });\n\n  /**\n   * The card holds the focus, because the card is what the tour IS.\n   *\n   * The overlay above declares `role=\"dialog\" aria-modal=\"true\"` — it always has — and\n   * then left focus wherever the page had put it. For a tour that is the most pointed\n   * version of the audit's *\"Only Modal manages focus\"*: the whole component exists to\n   * say \"look here\", and for a keyboard user \"here\" is the focus ring. They were told\n   * the page was hidden, given no way to reach the Next button without Tabbing through\n   * it, and left on a control the screen reader would no longer describe.\n   *\n   * It re-engages on every step, without any bookkeeping here, because `TourOverlay`\n   * returns null while it re-locates the next target: the card genuinely unmounts and\n   * remounts between steps. That is what keeps focus honest when the BUTTONS change —\n   * \"Back\" does not exist on the first step, so stepping back onto it destroys the\n   * control the press came from, and focus would otherwise fall to `<body>`, outside\n   * this trap's own listener, where Tab walks straight into the page the overlay claims\n   * to have hidden.\n   *\n   * **The cost, written down:** on an `awaitClick` step the user is asked to click the\n   * spotlighted element, and they can no longer Tab to it. ArrowRight still advances\n   * (the key handler in `TourOverlay` is on the document and does not care where focus\n   * is), which is the escape hatch that step already documents for the case where the\n   * target cannot be found. Containment is worth that: an `awaitClick` step is a\n   * minority of steps, while focus stranded behind `aria-modal` is every step.\n   */\n  useFocusTrap(ref, { active: true });\n\n  useLayoutEffect(() => {\n    const card = ref.current;\n    if (!card) return;\n    setStyle(\n      placeCard(rect, card.offsetWidth, card.offsetHeight, window.innerWidth, window.innerHeight, 12, step.placement, dir),\n    );\n  }, [rect, index, step.placement, dir]);\n\n  return (\n    <div\n      ref={ref}\n      // Focusable but not tabbable: the trap above focuses the card itself rather than\n      // its first button, so a screen reader reads the step's title and body before it\n      // reads \"Next\" — and without this the container cannot take focus at all and the\n      // trap silently does nothing.\n      tabIndex={-1}\n      style={style}\n      className=\"pointer-events-auto fixed z-[61] w-80 max-w-[calc(100vw-1.5rem)] rounded-lg border border-[var(--border)] bg-[var(--bg-surface)] p-4 shadow-xl outline-none transition-all duration-200 ease-out\"\n    >\n      <div className=\"text-sm font-semibold text-[var(--text-primary)]\">{step.title}</div>\n      <div className=\"mt-1 text-sm leading-relaxed text-[var(--text-secondary)]\">{step.body}</div>\n      {step.action && <div className=\"mt-3\">{step.action}</div>}\n      <div className=\"mt-4 space-y-2\">\n        <div className=\"flex items-center justify-between gap-2\">\n          <button\n            type=\"button\"\n            onClick={onSkip}\n            className=\"text-xs text-[var(--text-placeholder)] hover:text-[var(--text-secondary)]\"\n          >\n            {labels.skip}\n          </button>\n          <div className=\"flex items-center gap-2\">\n            <span className=\"whitespace-nowrap text-xs tabular-nums text-[var(--text-placeholder)]\">\n              {labels.step(index + 1, total)}\n            </span>\n            {!isFirst && (\n              <Button variant=\"secondary\" onClick={onBack} className=\"px-2.5 py-1 text-xs\">\n                {labels.back}\n              </Button>\n            )}\n            {/* On an awaitClick step the Next button is replaced by a hint on its\n                own row below, so it doesn't cram the counter + buttons and wrap.\n                Only when the target was actually FOUND, though — `rect` is null\n                when the finder gave up, and the click listener early-returns on\n                the same absence. Keyed on `step.target` alone this hid the only\n                way forward on any step whose anchor happens not to be rendered\n                for this user (a guest sees no \"add account\" button), leaving the\n                undocumented ArrowRight key as the sole escape. */}\n            {!(step.awaitClick && step.target && rect) && (\n              <Button variant=\"brand\" onClick={onNext} className={cn(\"px-2.5 py-1 text-xs\")}>\n                {isLast ? labels.done : labels.next}\n              </Button>\n            )}\n          </div>\n        </div>\n        {step.awaitClick && step.target && rect && (\n          <div className=\"text-center text-xs italic text-[var(--text-placeholder)]\">\n            {labels.awaitClickHint}\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/wizard/stepper-nav.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { f as ButtonVariant } from '../kit-labels-v3biUF1L.js';
+import { f as ButtonVariant } from '../kit-labels-Mz8zZHIF.js';
 import { UseWizardReturn, WizardLabels } from './types.js';
 import '../components/data-table-labels.js';
 import '../components/mini-calendar.js';

package/dist/wizard/use-wizard.js

@@ -1,5 +1,5 @@
 "use client";
-import { useCallback, useEffect, useReducer, useRef, useState } from "react";
+import { useCallback, useEffect, useLayoutEffect, useReducer, useRef, useState } from "react";
 import { useSearchParams } from "react-router";
 import { useKitLabels } from "../i18n/kit-labels.js";
 import { DEFAULT_WIZARD_LABELS } from "./types.js";
@@ -91,7 +91,9 @@ function useWizard(options) {
     onValidationFailed
   } = options;
   const stepsRef = useRef(steps);
-  stepsRef.current = steps;
+  useLayoutEffect(() => {
+    stepsRef.current = steps;
+  }, [steps]);
   const wizardLabels = useKitLabels("wizard", DEFAULT_WIZARD_LABELS, {
     missingRequired: missingRequiredMessage
   });

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

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

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

@@ -14,6 +14,16 @@ interface WizardStepProps {
     /** The line under the title: what the step asks for, or why. Rendered only with a
      *  `title` or on its own when there is none. */
     description?: ReactNode;
+    /**
+     * Controls for the step as a whole, at the end of the header row beside the title —
+     * kastlan 43: the buildings step's "Add building" had nowhere to go but UNDER the
+     * list it adds to, where it falls below the fold once there are three buildings.
+     * A header action is where every other kit surface (`PageHeader`, `Card`) puts it.
+     *
+     * Wraps under the title on a narrow screen rather than squeezing it. Renders the
+     * header on its own if there is no `title` either.
+     */
+    actions?: ReactNode;
     /** The heading's level. Default 3: the page has its `h1` and the wizard's own
      *  chrome sits at `h2` (the review step, the cancel dialog), so a step is under it. */
     headingLevel?: 2 | 3 | 4;
@@ -21,6 +31,6 @@ 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. */
-declare function WizardStep({ children, className, title, description, headingLevel, }: WizardStepProps): react.JSX.Element;
+declare function WizardStep({ children, className, title, description, headingLevel, actions, }: WizardStepProps): react.JSX.Element;
 
 export { WizardStep, type WizardStepProps };

package/dist/wizard/wizard-step.js

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

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  /** 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}: WizardStepProps) {\n  const hasTitle = title !== undefined && title !== null && title !== false && title !== \"\";\n  const hasDescription =\n    description !== undefined && description !== null && description !== false && description !== \"\";\n  const Heading = HEADING[headingLevel];\n  return (\n    <div className={cn(\"space-y-6\", className)}>\n      {(hasTitle || hasDescription) && (\n        <div data-slot=\"wizard-step-header\" className=\"space-y-1\">\n          {hasTitle && (\n            <Heading className=\"text-lg font-semibold text-[var(--text-primary)]\">{title}</Heading>\n          )}\n          {hasDescription && <p className=\"text-sm text-[var(--text-muted)]\">{description}</p>}\n        </div>\n      )}\n      {children}\n    </div>\n  );\n}\n"],"mappings":";AAwCQ,SAEI,KAFJ;AAvCR,SAAS,UAAU;AAoBnB,MAAM,UAAU,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK;AAKrC,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,eAAe;AACjB,GAAoB;AAClB,QAAM,WAAW,UAAU,UAAa,UAAU,QAAQ,UAAU,SAAS,UAAU;AACvF,QAAM,iBACJ,gBAAgB,UAAa,gBAAgB,QAAQ,gBAAgB,SAAS,gBAAgB;AAChG,QAAM,UAAU,QAAQ,YAAY;AACpC,SACE,qBAAC,SAAI,WAAW,GAAG,aAAa,SAAS,GACrC;AAAA,iBAAY,mBACZ,qBAAC,SAAI,aAAU,sBAAqB,WAAU,aAC3C;AAAA,kBACC,oBAAC,WAAQ,WAAU,oDAAoD,iBAAM;AAAA,MAE9E,kBAAkB,oBAAC,OAAE,WAAU,oCAAoC,uBAAY;AAAA,OAClF;AAAA,IAED;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({\n  children,\n  className,\n  title,\n  description,\n  headingLevel = 3,\n  actions,\n}: WizardStepProps) {\n  const hasTitle = title !== undefined && title !== null && title !== false && title !== \"\";\n  const hasDescription =\n    description !== undefined && description !== null && description !== false && description !== \"\";\n  const hasActions = actions !== undefined && actions !== null && actions !== false && actions !== \"\";\n  const Heading = HEADING[headingLevel];\n  const heading = (\n    <>\n      {hasTitle && <Heading className=\"text-lg font-semibold text-[var(--text-primary)]\">{title}</Heading>}\n      {hasDescription && <p className=\"text-sm text-[var(--text-muted)]\">{description}</p>}\n    </>\n  );\n  return (\n    <div className={cn(\"space-y-6\", className)}>\n      {hasActions ? (\n        // One row: the text takes the room, the actions keep their width at the end\n        // and wrap below it when there is not enough — `basis-64` is the width the\n        // title asks for before that happens (a zero basis would never wrap and\n        // squeeze the title to a word a line instead). `items-start` so a two-line\n        // description does not pull the button down to its middle; `ms-auto` keeps\n        // the actions at the end with no title, and when they wrap.\n        <div data-slot=\"wizard-step-header\" className=\"flex flex-wrap items-start justify-between gap-x-4 gap-y-2\">\n          {(hasTitle || hasDescription) && <div className=\"min-w-0 grow basis-64 space-y-1\">{heading}</div>}\n          <div data-slot=\"wizard-step-actions\" className=\"ms-auto flex shrink-0 flex-wrap items-center gap-2\">\n            {actions}\n          </div>\n        </div>\n      ) : (\n        // Without actions the header is exactly what it was, so a step that passes\n        // none renders as before.\n        (hasTitle || hasDescription) && (\n          <div data-slot=\"wizard-step-header\" className=\"space-y-1\">\n            {heading}\n          </div>\n        )\n      )}\n      {children}\n    </div>\n  );\n}\n"],"mappings":";AAkDI,mBACe,KADf;AAjDJ,SAAS,UAAU;AA8BnB,MAAM,UAAU,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK;AAKrC,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,eAAe;AAAA,EACf;AACF,GAAoB;AAClB,QAAM,WAAW,UAAU,UAAa,UAAU,QAAQ,UAAU,SAAS,UAAU;AACvF,QAAM,iBACJ,gBAAgB,UAAa,gBAAgB,QAAQ,gBAAgB,SAAS,gBAAgB;AAChG,QAAM,aAAa,YAAY,UAAa,YAAY,QAAQ,YAAY,SAAS,YAAY;AACjG,QAAM,UAAU,QAAQ,YAAY;AACpC,QAAM,UACJ,iCACG;AAAA,gBAAY,oBAAC,WAAQ,WAAU,oDAAoD,iBAAM;AAAA,IACzF,kBAAkB,oBAAC,OAAE,WAAU,oCAAoC,uBAAY;AAAA,KAClF;AAEF,SACE,qBAAC,SAAI,WAAW,GAAG,aAAa,SAAS,GACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAOC,qBAAC,SAAI,aAAU,sBAAqB,WAAU,8DAC1C;AAAA,qBAAY,mBAAmB,oBAAC,SAAI,WAAU,mCAAmC,mBAAQ;AAAA,QAC3F,oBAAC,SAAI,aAAU,uBAAsB,WAAU,sDAC5C,mBACH;AAAA,SACF;AAAA;AAAA;AAAA;AAAA,OAIC,YAAY,mBACX,oBAAC,SAAI,aAAU,sBAAqB,WAAU,aAC3C,mBACH;AAAA;AAAA,IAGH;AAAA,KACH;AAEJ;","names":[]}

package/dist/wizard.d.ts

@@ -6,7 +6,7 @@ export { WizardStep, WizardStepProps } from './wizard/wizard-step.js';
 export { WizardSummary } from './wizard/wizard-summary.js';
 export { StepperNav } from './wizard/stepper-nav.js';
 import 'react';
-import './kit-labels-v3biUF1L.js';
+import './kit-labels-Mz8zZHIF.js';
 import './components/data-table-labels.js';
 import './components/mini-calendar.js';
 import './components/calendar-heatmap.js';

package/package.json

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