@eifi1/ui-kit 0.46.1 → 0.48.0

package/dist/shell/topbar-action-menu.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shell/topbar-action-menu.tsx"],"sourcesContent":["import { useId, useLayoutEffect, useRef } from \"react\";\nimport type { KeyboardEvent as ReactKeyboardEvent, ReactNode } from \"react\";\nimport { Link } from \"react-router\";\nimport { cn } from \"../lib/cn\";\nimport { HoverMenu, type HoverMenuProps } from \"../components/hover-menu\";\nimport { MenuItem } from \"../components/menu-item\";\nimport type { MenuItemTone } from \"../components/menu-item\";\nimport { StatusDot } from \"../components/status-dot\";\nimport type { UserAvatarBadge } from \"../components/user-avatar\";\nimport { TOPBAR_TRIGGER_CLASS } from \"./topbar-controls\";\n\n/**\n * One row of a {@link TopBarActionMenu}. An `action` (default) runs `onSelect`, a\n * `link` navigates via react-router, a `divider` draws a rule, and a `heading` names\n * the rows after it. Action and link rows close the menu automatically when chosen.\n * `kind` may be omitted for actions, keeping the common case terse.\n *\n * The rows are {@link MenuItem}s, so they take its options: `tone: \"danger\"` for the\n * log-out row, `checked` (+ `checkable`) for a choice, `current` for the link to the\n * page already open, `disabled`.\n */\nexport type TopBarMenuEntry =\n  | {\n      kind?: \"action\";\n      key: string;\n      icon?: ReactNode;\n      label: ReactNode;\n      trailing?: ReactNode;\n      onSelect: () => void;\n      tone?: MenuItemTone;\n      /** Makes the row a choice (`menuitemradio`, or `menuitemcheckbox` with\n       *  `checkable: \"checkbox\"`) and says whether it is chosen. */\n      checked?: boolean;\n      checkable?: \"radio\" | \"checkbox\";\n      disabled?: boolean;\n    }\n  | {\n      kind: \"link\";\n      key: string;\n      icon?: ReactNode;\n      label: ReactNode;\n      trailing?: ReactNode;\n      to: string;\n      tone?: MenuItemTone;\n      /** The link to the page already open: `aria-current=\"page\"` and a check mark. */\n      current?: boolean;\n      disabled?: boolean;\n    }\n  | { kind: \"divider\"; key: string }\n  | {\n      /**\n       * A group heading (0.23, keksdose's guided-tours menu): the rows after it, up to\n       * the next heading, the next `divider` or the end of `entries`, are ONE group\n       * named by `label`. keksdose files its tours by topic and separated the blocks\n       * with bare dividers — \"the kit's menu has no heading row to name them with\"\n       * (tour-menu.tsx) — so a sighted reader had to guess what each block was and a\n       * screen reader was told nothing at all.\n       *\n       * Not a row: it takes no focus, the arrow keys (and Home/End) pass over it, and it\n       * never closes the menu. It is announced the way the kit's other grouped lists\n       * announce theirs (`CommandPalette`): the group's rows sit in a `role=\"group\"`\n       * whose `aria-labelledby` is this heading, so a reader says \"On this page, group\"\n       * when the focus enters the first row, and nothing between rows.\n       *\n       * A divider ENDS the group, so a closing row such as \"All tours…\" behind a rule\n       * belongs to no topic. A heading with no rows under it is not drawn — an empty\n       * group names nothing; build the list from data and it may well be empty.\n       *\n       * The menu-wide `heading` prop is the panel's title, drawn once above everything;\n       * with group headings it is usually redundant (two stacked caps lines read as one),\n       * and the trigger's `aria-label` already names the menu.\n       */\n      kind: \"heading\";\n      key: string;\n      /** The group's name, shown above its rows and announced as the group's name. Keep\n       *  it short: it is set in small caps and wraps on a narrow panel. */\n      label: ReactNode;\n    };\n\ntype HeadingEntry = Extract<TopBarMenuEntry, { kind: \"heading\" }>;\ntype DividerEntry = Extract<TopBarMenuEntry, { kind: \"divider\" }>;\ntype RowEntry = Exclude<TopBarMenuEntry, HeadingEntry | DividerEntry>;\n\n/** What the panel draws from `entries`: loose rows and rules, and headed groups. */\ntype Block = { kind: \"loose\"; entry: RowEntry | DividerEntry } | { kind: \"group\"; heading: HeadingEntry; rows: RowEntry[] };\n\n/**\n * Cut `entries` into blocks: a heading opens a group that takes the rows after it until\n * the next heading or divider; everything else stands alone, as it always has.\n */\nfunction toBlocks(entries: readonly TopBarMenuEntry[]): Block[] {\n  const blocks: Block[] = [];\n  let group: Extract<Block, { kind: \"group\" }> | null = null;\n  for (const entry of entries) {\n    if (entry.kind === \"heading\") {\n      group = { kind: \"group\", heading: entry, rows: [] };\n      blocks.push(group);\n    } else if (entry.kind === \"divider\") {\n      group = null;\n      blocks.push({ kind: \"loose\", entry });\n    } else if (group) {\n      group.rows.push(entry);\n    } else {\n      blocks.push({ kind: \"loose\", entry });\n    }\n  }\n  // A heading with nothing under it names nothing: not drawn (see the `heading` kind).\n  return blocks.filter((block) => block.kind === \"loose\" || block.rows.length > 0);\n}\n\n/**\n * The non-interactive identity block at the top of an account menu — kastlan's name +\n * role, keksdose's display name + email + role chip. It is text, not a `menuitem`: the\n * arrow keys pass over it.\n */\nexport interface TopBarMenuHeader {\n  /** The first line — the user's name. */\n  title: ReactNode;\n  /** The muted second line — an email, a role. */\n  subtitle?: ReactNode;\n  /**\n   * Anything below — a role chip. A link or button here stays out of the arrow keys\n   * and in the Tab order, like the footer's.\n   *\n   * Pass a function to get `close`, as `footer` does — keksdose F7: its admin role\n   * chip links to the admin area, and a router link does not unmount the menu, so\n   * without `close` the panel stayed open over the page it had just navigated to.\n   */\n  extra?: ReactNode | ((close: () => void) => ReactNode);\n}\n\n/** What a control is, as far as `HoverMenu` is concerned, when it lives in the header\n *  or the footer: not a menu row. */\nconst SECTION_CONTROLS = \"a[href]:not([role]),button:not([role])\";\nconst TABBABLE = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]';\n\n/**\n * A header or footer inside the menu panel.\n *\n * `HoverMenu` promotes EVERY role-less button and link in its panel to a `menuitem` out\n * of the Tab order, and turns every list into `role=\"none\"` — right for the rows, wrong\n * for a footer of legal links, which would join the arrow-key cycle and drop out of Tab.\n * So before it looks (a child's layout effect runs before its parent's), the controls\n * in here get their own role spelled out, which `HoverMenu` leaves alone, and any list\n * keeps its list semantics.\n */\nfunction MenuSection({ className, children }: { className: string; children: ReactNode }) {\n  const ref = useRef<HTMLLIElement>(null);\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    for (const c of el.querySelectorAll<HTMLElement>(SECTION_CONTROLS)) {\n      c.setAttribute(\"role\", c.tagName === \"A\" ? \"link\" : \"button\");\n    }\n    for (const l of el.querySelectorAll<HTMLElement>(\"ul:not([role]),ol:not([role])\")) l.setAttribute(\"role\", \"list\");\n    for (const l of el.querySelectorAll<HTMLElement>(\"li:not([role])\")) l.setAttribute(\"role\", \"listitem\");\n  });\n  return (\n    <li ref={ref} role=\"none\" className={className}>\n      {children}\n    </li>\n  );\n}\n\n/**\n * `HoverMenu` closes on any Tab inside the panel — right when Tab leaves it, wrong when\n * Tab is on its way from a row to a footer link, or from one footer link to the next:\n * the panel would unmount under the focus. So a Tab whose next stop is still inside the\n * panel stops here and the browser moves focus; one that leaves reaches `HoverMenu`,\n * which closes.\n */\nfunction keepTabInsidePanel(e: ReactKeyboardEvent<HTMLUListElement>) {\n  if (e.key !== \"Tab\") return;\n  const from = e.target as HTMLElement;\n  const stops = Array.from(e.currentTarget.querySelectorAll<HTMLElement>(TABBABLE)).filter(\n    (el) => el.getAttribute(\"tabindex\") !== \"-1\",\n  );\n  const way = e.shiftKey ? Node.DOCUMENT_POSITION_PRECEDING : Node.DOCUMENT_POSITION_FOLLOWING;\n  if (stops.some((el) => el !== from && from.compareDocumentPosition(el) & way)) e.stopPropagation();\n}\n\n/**\n * A top-bar icon button that opens a {@link HoverMenu} of actions and/or links,\n * with an optional uppercase heading and divider rules. Generic glue over the\n * shared top-bar chrome — e.g. the feedback launcher or the guided-tours menu —\n * so those call sites describe their rows as data instead of rebuilding the\n * trigger + list markup. For a checkmarked value-switcher use\n * {@link OptionSwitcherMenu} instead.\n *\n * It is also the ACCOUNT menu kastlan and keksdose each hand-build on `HoverMenu`: a\n * custom `trigger` (the avatar), a `header` (name + role / email), the rows, and a\n * free-content `footer` (the legal links).\n *\n * A long menu is grouped by topic with `{ kind: \"heading\" }` entries (0.23) — see\n * {@link TopBarMenuEntry}. There is no separate phone layout: the panel is the same\n * hover panel at 390px, kept inside the viewport by `HoverMenu`, and a heading wraps\n * rather than widening it.\n */\nexport function TopBarActionMenu({\n  icon,\n  iconBadge,\n  trigger,\n  triggerClassName,\n  href,\n  \"aria-label\": ariaLabel,\n  heading,\n  header,\n  entries,\n  leading,\n  children,\n  footer,\n  footerLabel,\n  align,\n  panelClassName,\n  triggerAttributes,\n}: {\n  /** The trigger's face for the usual icon button. Ignored when `trigger` is given. */\n  icon?: ReactNode;\n  /**\n   * A status dot in the top-end corner of `icon` — keksdose's unread-support dot on the\n   * feedback trigger. Like `UserAvatar`'s `badge`, its `label` joins the trigger's name\n   * (\"Send feedback 2 unread\"), so the dot is not something only the eye is told about.\n   * Ignored with `trigger`: give the face its own badge there.\n   */\n  iconBadge?: UserAvatarBadge | null;\n  /**\n   * A face of your own for the trigger — the account menu's `UserAvatar`. It is drawn\n   * INSIDE the kit's button, which keeps the wiring: `aria-haspopup`, `aria-expanded`,\n   * the toggle, the keyboard. `open` is there for a chevron that turns.\n   *\n   * The button is named by `aria-label` followed by any readable text in the face — a\n   * `UserAvatar` `badge` label reaches a screen reader that way (\"Account menu 3\n   * unread\"), where an `aria-label` on the button would have hidden it. A\n   * `UserAvatar`'s initials are `aria-hidden`, so the person's name is only in the\n   * name if `aria-label` carries it (\"Marcel Eifert, account menu\").\n   */\n  trigger?: (state: { open: boolean }) => ReactNode;\n  /** Extra classes for the trigger button — `rounded-full` round an avatar. */\n  triggerClassName?: string;\n  /**\n   * Make the trigger a LINK to this route (keksdose dev #585, Marcel: \"clicking on the\n   * guided tours icon shall lead to the tours page like the all tours element does\").\n   * A click or Enter follows it and shuts the panel; hover still opens the panel after\n   * the usual delay, and ↓/↑ on the focused trigger still open it onto the first/last\n   * row, so the rows stay reachable by keyboard. A tap on a touch screen follows the\n   * link — so use it where the destination offers everything the menu does. Rendered as\n   * an `<a>` (the router's `Link`) with `aria-haspopup=\"menu\"` and `aria-expanded`,\n   * named by `aria-label`: a link inside the kit's button would be interactive content\n   * inside interactive content.\n   */\n  href?: string;\n  /** Names the trigger and the menu. Required: the trigger is an icon (refactor audit\n   *  2026-10, API-1 — the `ariaLabel` spelling went in 0.35). */\n  \"aria-label\": string;\n  heading?: string;\n  /** A non-interactive identity block above the rows. */\n  header?: TopBarMenuHeader;\n  entries: TopBarMenuEntry[];\n  /**\n   * Rows the entry data cannot describe (a `Disclosure` sub-list, an app's own\n   * section), after `entries`. Render `<li>`s holding `MenuItem`s or plain controls;\n   * `close` shuts the menu.\n   */\n  children?: (close: () => void) => ReactNode;\n  /**\n   * Rows like {@link children}, but BEFORE `entries`, under the header — the account\n   * menu's `AccountMenuLanguage`, which goes first after the app's context rows (§6.5)\n   * in a menu whose other rows are all entries (kastlan, build review B1). Render `<li>`s;\n   * `close` shuts the menu.\n   */\n  leading?: (close: () => void) => ReactNode;\n  /**\n   * Free content below the rows, behind a rule — the legal links. Its links and\n   * buttons are NOT menu rows: the arrow keys skip them and Tab reaches them. Pass a\n   * function to get `close` for the links' `onClick`.\n   */\n  footer?: ReactNode | ((close: () => void) => ReactNode);\n  /** Wraps the footer in a `<nav>` with this name (\"Legal\"). Without it, a plain block. */\n  footerLabel?: string;\n  /** Which edge of the trigger the panel lines up with, `start` or `end` in the reading\n   *  direction (see `HoverMenu`, whose type this is). Default `end`. */\n  align?: HoverMenuProps[\"align\"];\n  panelClassName?: string;\n  /** `data-*` attributes for the trigger itself — a tour's anchor (`data-tour`), a test\n   *  hook. The parts built on this menu (`TourMenu`) pass theirs through here. */\n  triggerAttributes?: { [key: `data-${string}`]: string | number | boolean | undefined };\n}) {\n  // Names the groups' headings for `aria-labelledby`. Positional rather than from the\n  // entry's `key`, which is the caller's text and may hold a space — and a space in\n  // `aria-labelledby` is a list separator.\n  const uid = useId();\n  return (\n    <HoverMenu\n      aria-label={ariaLabel}\n      align={align}\n      trigger={({ open, toggle, close }) => {\n        // One element for both kinds: the router's link when `href` is set, else the\n        // kit's button. Same classes and face either way.\n        const control = (className: string, children: ReactNode, label?: string) =>\n          href ? (\n            <Link {...triggerAttributes} to={href} onClick={close} aria-label={label} className={className}>\n              {children}\n            </Link>\n          ) : (\n            <button {...triggerAttributes} type=\"button\" onClick={toggle} aria-label={label} className={className}>\n              {children}\n            </button>\n          );\n        if (trigger) {\n          return control(\n            cn(TOPBAR_TRIGGER_CLASS, \"relative\", triggerClassName),\n            <>\n              <span className=\"sr-only\">{ariaLabel}</span>\n              {/* The space keeps the name from running into the face's text (\"Account\n                  menu3 unread\"); as a flex item it takes no room. */}\n              {\" \"}\n              {trigger({ open })}\n            </>,\n          );\n        }\n        if (iconBadge) {\n          // Named by its content, like the custom-trigger branch, so the badge label is\n          // part of the name; an `aria-label` would have hidden it.\n          return control(\n            cn(TOPBAR_TRIGGER_CLASS, \"relative\", triggerClassName),\n            <>\n              <span className=\"sr-only\">{ariaLabel}</span>{\" \"}\n              <span aria-hidden className=\"relative inline-flex\">\n                {icon}\n                <StatusDot ring tone={iconBadge.tone ?? \"danger\"} className=\"absolute -end-0.5 -top-0.5\" />\n              </span>{\" \"}\n              <span className=\"sr-only\">{iconBadge.label}</span>\n            </>,\n          );\n        }\n        return control(cn(TOPBAR_TRIGGER_CLASS, triggerClassName), icon, ariaLabel);\n      }}\n    >\n      {(close) => {\n        const footerBody = typeof footer === \"function\" ? footer(close) : footer;\n        const headerExtra = typeof header?.extra === \"function\" ? header.extra(close) : header?.extra;\n        const footerClass =\n          \"flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted [&_a:hover]:text-primary [&_a]:rounded-sm [&_a:focus-visible]:outline-none [&_a:focus-visible]:ring-focus [&_a:focus-visible]:ring-brand\";\n        /** One action or link row — loose, or inside a heading's group. */\n        const row = (entry: RowEntry) => (\n          <li key={entry.key}>\n            {entry.kind === \"link\" ? (\n              <MenuItem\n                href={entry.to}\n                renderLink={({ href, ...p }) => <Link to={href} {...p} />}\n                onClick={close}\n                leading={entry.icon}\n                trailing={entry.trailing}\n                tone={entry.tone}\n                current={entry.current}\n                disabled={entry.disabled}\n              >\n                {entry.label}\n              </MenuItem>\n            ) : (\n              <MenuItem\n                onClick={() => {\n                  entry.onSelect();\n                  close();\n                }}\n                leading={entry.icon}\n                trailing={entry.trailing}\n                tone={entry.tone}\n                checked={entry.checked}\n                checkable={entry.checkable}\n                disabled={entry.disabled}\n              >\n                {entry.label}\n              </MenuItem>\n            )}\n          </li>\n        );\n        return (\n          // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- a Tab bubbling up from a row or footer link, see keepTabInsidePanel\n          <ul className={cn(\"py-1\", panelClassName)} onKeyDown={keepTabInsidePanel}>\n            {header && (\n              <MenuSection className=\"mb-1 border-b border-subtle px-3 py-2\">\n                <div className=\"truncate text-sm font-medium text-primary\">{header.title}</div>\n                {header.subtitle != null && (\n                  <div className=\"truncate text-xs text-muted\">{header.subtitle}</div>\n                )}\n                {headerExtra != null && headerExtra !== false && <div className=\"mt-1\">{headerExtra}</div>}\n              </MenuSection>\n            )}\n            {heading && (\n              <li className=\"px-3 py-1 text-micro font-semibold uppercase tracking-wide text-placeholder\">\n                {heading}\n              </li>\n            )}\n            {leading?.(close)}\n            {toBlocks(entries).map((block, i, blocks) => {\n              if (block.kind === \"loose\") {\n                const entry = block.entry;\n                if (entry.kind === \"divider\") {\n                  return <li key={entry.key} className=\"my-1 border-t border-subtle\" />;\n                }\n                return row(entry);\n              }\n              const headingId = `${uid}-group-${i}`;\n              const before = blocks[i - 1];\n              // Under a rule (or at the top of the rows) the rule's margin is the gap;\n              // straight under another group's last row the heading makes its own.\n              const tight = !before || (before.kind === \"loose\" && before.entry.kind === \"divider\");\n              return (\n                <li key={block.heading.key} role=\"none\">\n                  <div\n                    id={headingId}\n                    role=\"presentation\"\n                    className={cn(\n                      \"px-3 pb-0.5 text-caption font-semibold uppercase tracking-wide text-muted [overflow-wrap:anywhere]\",\n                      tight ? \"pt-1\" : \"pt-2.5\",\n                    )}\n                  >\n                    {block.heading.label}\n                  </div>\n                  <ul role=\"group\" aria-labelledby={headingId}>\n                    {block.rows.map(row)}\n                  </ul>\n                </li>\n              );\n            })}\n            {children?.(close)}\n            {footerBody != null && footerBody !== false && (\n              <MenuSection className=\"mt-1 border-t border-subtle px-3 py-2\">\n                {footerLabel ? (\n                  <nav aria-label={footerLabel} className={footerClass}>\n                    {footerBody}\n                  </nav>\n                ) : (\n                  <div className={footerClass}>{footerBody}</div>\n                )}\n              </MenuSection>\n            )}\n          </ul>\n        );\n      }}\n    </HoverMenu>\n  );\n}\n"],"mappings":"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","names":["children","href"]}
+{"version":3,"sources":["../../src/shell/topbar-action-menu.tsx"],"sourcesContent":["import { useId, useLayoutEffect, useRef } from \"react\";\nimport type { KeyboardEvent as ReactKeyboardEvent, ReactNode } from \"react\";\nimport { Link } from \"react-router\";\nimport { cn } from \"../lib/cn\";\nimport { HoverMenu, type HoverMenuProps } from \"../components/hover-menu\";\nimport { MenuItem } from \"../components/menu-item\";\nimport type { MenuItemTone } from \"../components/menu-item\";\nimport { StatusDot } from \"../components/status-dot\";\nimport { Tooltip } from \"../components/tooltip\";\nimport type { UserAvatarBadge } from \"../components/user-avatar\";\nimport { TOPBAR_TRIGGER_CLASS } from \"./topbar-controls\";\n\n/**\n * One row of a {@link TopBarActionMenu}. An `action` (default) runs `onSelect`, a\n * `link` navigates via react-router, a `divider` draws a rule, and a `heading` names\n * the rows after it. Action and link rows close the menu automatically when chosen.\n * `kind` may be omitted for actions, keeping the common case terse.\n *\n * The rows are {@link MenuItem}s, so they take its options: `tone: \"danger\"` for the\n * log-out row, `checked` (+ `checkable`) for a choice, `current` for the link to the\n * page already open, `disabled`.\n */\nexport type TopBarMenuEntry =\n  | {\n      kind?: \"action\";\n      key: string;\n      icon?: ReactNode;\n      label: ReactNode;\n      trailing?: ReactNode;\n      onSelect: () => void;\n      tone?: MenuItemTone;\n      /** Makes the row a choice (`menuitemradio`, or `menuitemcheckbox` with\n       *  `checkable: \"checkbox\"`) and says whether it is chosen. */\n      checked?: boolean;\n      checkable?: \"radio\" | \"checkbox\";\n      disabled?: boolean;\n    }\n  | {\n      kind: \"link\";\n      key: string;\n      icon?: ReactNode;\n      label: ReactNode;\n      trailing?: ReactNode;\n      to: string;\n      tone?: MenuItemTone;\n      /** The link to the page already open: `aria-current=\"page\"` and a check mark. */\n      current?: boolean;\n      disabled?: boolean;\n    }\n  | { kind: \"divider\"; key: string }\n  | {\n      /**\n       * A group heading (0.23, keksdose's guided-tours menu): the rows after it, up to\n       * the next heading, the next `divider` or the end of `entries`, are ONE group\n       * named by `label`. keksdose files its tours by topic and separated the blocks\n       * with bare dividers — \"the kit's menu has no heading row to name them with\"\n       * (tour-menu.tsx) — so a sighted reader had to guess what each block was and a\n       * screen reader was told nothing at all.\n       *\n       * Not a row: it takes no focus, the arrow keys (and Home/End) pass over it, and it\n       * never closes the menu. It is announced the way the kit's other grouped lists\n       * announce theirs (`CommandPalette`): the group's rows sit in a `role=\"group\"`\n       * whose `aria-labelledby` is this heading, so a reader says \"On this page, group\"\n       * when the focus enters the first row, and nothing between rows.\n       *\n       * A divider ENDS the group, so a closing row such as \"All tours…\" behind a rule\n       * belongs to no topic. A heading with no rows under it is not drawn — an empty\n       * group names nothing; build the list from data and it may well be empty.\n       *\n       * The menu-wide `heading` prop is the panel's title, drawn once above everything;\n       * with group headings it is usually redundant (two stacked caps lines read as one),\n       * and the trigger's `aria-label` already names the menu.\n       */\n      kind: \"heading\";\n      key: string;\n      /** The group's name, shown above its rows and announced as the group's name. Keep\n       *  it short: it is set in small caps and wraps on a narrow panel. */\n      label: ReactNode;\n    };\n\ntype HeadingEntry = Extract<TopBarMenuEntry, { kind: \"heading\" }>;\ntype DividerEntry = Extract<TopBarMenuEntry, { kind: \"divider\" }>;\ntype RowEntry = Exclude<TopBarMenuEntry, HeadingEntry | DividerEntry>;\n\n/** What the panel draws from `entries`: loose rows and rules, and headed groups. */\ntype Block = { kind: \"loose\"; entry: RowEntry | DividerEntry } | { kind: \"group\"; heading: HeadingEntry; rows: RowEntry[] };\n\n/**\n * Cut `entries` into blocks: a heading opens a group that takes the rows after it until\n * the next heading or divider; everything else stands alone, as it always has.\n */\nfunction toBlocks(entries: readonly TopBarMenuEntry[]): Block[] {\n  const blocks: Block[] = [];\n  let group: Extract<Block, { kind: \"group\" }> | null = null;\n  for (const entry of entries) {\n    if (entry.kind === \"heading\") {\n      group = { kind: \"group\", heading: entry, rows: [] };\n      blocks.push(group);\n    } else if (entry.kind === \"divider\") {\n      group = null;\n      blocks.push({ kind: \"loose\", entry });\n    } else if (group) {\n      group.rows.push(entry);\n    } else {\n      blocks.push({ kind: \"loose\", entry });\n    }\n  }\n  // A heading with nothing under it names nothing: not drawn (see the `heading` kind).\n  return blocks.filter((block) => block.kind === \"loose\" || block.rows.length > 0);\n}\n\n/**\n * The non-interactive identity block at the top of an account menu — kastlan's name +\n * role, keksdose's display name + email + role chip. It is text, not a `menuitem`: the\n * arrow keys pass over it.\n */\nexport interface TopBarMenuHeader {\n  /** The first line — the user's name. */\n  title: ReactNode;\n  /** The muted second line — an email, a role. */\n  subtitle?: ReactNode;\n  /**\n   * Anything below — a role chip. A link or button here stays out of the arrow keys\n   * and in the Tab order, like the footer's.\n   *\n   * Pass a function to get `close`, as `footer` does — keksdose F7: its admin role\n   * chip links to the admin area, and a router link does not unmount the menu, so\n   * without `close` the panel stayed open over the page it had just navigated to.\n   */\n  extra?: ReactNode | ((close: () => void) => ReactNode);\n}\n\n/** What a control is, as far as `HoverMenu` is concerned, when it lives in the header\n *  or the footer: not a menu row. */\nconst SECTION_CONTROLS = \"a[href]:not([role]),button:not([role])\";\nconst TABBABLE = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]';\n\n/**\n * A header or footer inside the menu panel.\n *\n * `HoverMenu` promotes EVERY role-less button and link in its panel to a `menuitem` out\n * of the Tab order, and turns every list into `role=\"none\"` — right for the rows, wrong\n * for a footer of legal links, which would join the arrow-key cycle and drop out of Tab.\n * So before it looks (a child's layout effect runs before its parent's), the controls\n * in here get their own role spelled out, which `HoverMenu` leaves alone, and any list\n * keeps its list semantics.\n */\nfunction MenuSection({ className, children }: { className: string; children: ReactNode }) {\n  const ref = useRef<HTMLLIElement>(null);\n  useLayoutEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    for (const c of el.querySelectorAll<HTMLElement>(SECTION_CONTROLS)) {\n      c.setAttribute(\"role\", c.tagName === \"A\" ? \"link\" : \"button\");\n    }\n    for (const l of el.querySelectorAll<HTMLElement>(\"ul:not([role]),ol:not([role])\")) l.setAttribute(\"role\", \"list\");\n    for (const l of el.querySelectorAll<HTMLElement>(\"li:not([role])\")) l.setAttribute(\"role\", \"listitem\");\n  });\n  return (\n    <li ref={ref} role=\"none\" className={className}>\n      {children}\n    </li>\n  );\n}\n\n/**\n * `HoverMenu` closes on any Tab inside the panel — right when Tab leaves it, wrong when\n * Tab is on its way from a row to a footer link, or from one footer link to the next:\n * the panel would unmount under the focus. So a Tab whose next stop is still inside the\n * panel stops here and the browser moves focus; one that leaves reaches `HoverMenu`,\n * which closes.\n */\nfunction keepTabInsidePanel(e: ReactKeyboardEvent<HTMLUListElement>) {\n  if (e.key !== \"Tab\") return;\n  const from = e.target as HTMLElement;\n  const stops = Array.from(e.currentTarget.querySelectorAll<HTMLElement>(TABBABLE)).filter(\n    (el) => el.getAttribute(\"tabindex\") !== \"-1\",\n  );\n  const way = e.shiftKey ? Node.DOCUMENT_POSITION_PRECEDING : Node.DOCUMENT_POSITION_FOLLOWING;\n  if (stops.some((el) => el !== from && from.compareDocumentPosition(el) & way)) e.stopPropagation();\n}\n\n/**\n * A top-bar icon button that opens a {@link HoverMenu} of actions and/or links,\n * with an optional uppercase heading and divider rules. Generic glue over the\n * shared top-bar chrome — e.g. the feedback launcher or the guided-tours menu —\n * so those call sites describe their rows as data instead of rebuilding the\n * trigger + list markup. For a checkmarked value-switcher use\n * {@link OptionSwitcherMenu} instead.\n *\n * It is also the ACCOUNT menu kastlan and keksdose each hand-build on `HoverMenu`: a\n * custom `trigger` (the avatar), a `header` (name + role / email), the rows, and a\n * free-content `footer` (the legal links).\n *\n * A long menu is grouped by topic with `{ kind: \"heading\" }` entries (0.23) — see\n * {@link TopBarMenuEntry}. There is no separate phone layout: the panel is the same\n * hover panel at 390px, kept inside the viewport by `HoverMenu`, and a heading wraps\n * rather than widening it.\n */\nexport function TopBarActionMenu({\n  icon,\n  iconBadge,\n  trigger,\n  triggerClassName,\n  href,\n  \"aria-label\": ariaLabel,\n  heading,\n  header,\n  entries,\n  leading,\n  children,\n  footer,\n  footerLabel,\n  align,\n  panelClassName,\n  triggerAttributes,\n}: {\n  /** The trigger's face for the usual icon button. Ignored when `trigger` is given. */\n  icon?: ReactNode;\n  /**\n   * A status dot in the top-end corner of `icon` — keksdose's unread-support dot on the\n   * feedback trigger. Like `UserAvatar`'s `badge`, its `label` joins the trigger's name\n   * (\"Send feedback 2 unread\"), so the dot is not something only the eye is told about.\n   * Ignored with `trigger`: give the face its own badge there.\n   */\n  iconBadge?: UserAvatarBadge | null;\n  /**\n   * A face of your own for the trigger — the account menu's `UserAvatar`. It is drawn\n   * INSIDE the kit's button, which keeps the wiring: `aria-haspopup`, `aria-expanded`,\n   * the toggle, the keyboard. `open` is there for a chevron that turns.\n   *\n   * The button is named by `aria-label` followed by any readable text in the face — a\n   * `UserAvatar` `badge` label reaches a screen reader that way (\"Account menu 3\n   * unread\"), where an `aria-label` on the button would have hidden it. A\n   * `UserAvatar`'s initials are `aria-hidden`, so the person's name is only in the\n   * name if `aria-label` carries it (\"Marcel Eifert, account menu\").\n   */\n  trigger?: (state: { open: boolean }) => ReactNode;\n  /** Extra classes for the trigger button — `rounded-full` round an avatar. */\n  triggerClassName?: string;\n  /**\n   * Make the trigger a LINK to this route (keksdose dev #585, Marcel: \"clicking on the\n   * guided tours icon shall lead to the tours page like the all tours element does\").\n   * A click or Enter follows it and shuts the panel; hover still opens the panel after\n   * the usual delay, and ↓/↑ on the focused trigger still open it onto the first/last\n   * row, so the rows stay reachable by keyboard. A tap on a touch screen follows the\n   * link — so use it where the destination offers everything the menu does. Rendered as\n   * an `<a>` (the router's `Link`) with `aria-haspopup=\"menu\"` and `aria-expanded`,\n   * named by `aria-label`: a link inside the kit's button would be interactive content\n   * inside interactive content.\n   */\n  href?: string;\n  /** Names the trigger and the menu. Required: the trigger is an icon (refactor audit\n   *  2026-10, API-1 — the `ariaLabel` spelling went in 0.35). */\n  \"aria-label\": string;\n  heading?: string;\n  /** A non-interactive identity block above the rows. */\n  header?: TopBarMenuHeader;\n  entries: TopBarMenuEntry[];\n  /**\n   * Rows the entry data cannot describe (a `Disclosure` sub-list, an app's own\n   * section), after `entries`. Render `<li>`s holding `MenuItem`s or plain controls;\n   * `close` shuts the menu.\n   */\n  children?: (close: () => void) => ReactNode;\n  /**\n   * Rows like {@link children}, but BEFORE `entries`, under the header — the account\n   * menu's `AccountMenuLanguage`, which goes first after the app's context rows (§6.5)\n   * in a menu whose other rows are all entries (kastlan, build review B1). Render `<li>`s;\n   * `close` shuts the menu.\n   */\n  leading?: (close: () => void) => ReactNode;\n  /**\n   * Free content below the rows, behind a rule — the legal links. Its links and\n   * buttons are NOT menu rows: the arrow keys skip them and Tab reaches them. Pass a\n   * function to get `close` for the links' `onClick`.\n   */\n  footer?: ReactNode | ((close: () => void) => ReactNode);\n  /** Wraps the footer in a `<nav>` with this name (\"Legal\"). Without it, a plain block. */\n  footerLabel?: string;\n  /** Which edge of the trigger the panel lines up with, `start` or `end` in the reading\n   *  direction (see `HoverMenu`, whose type this is). Default `end`. */\n  align?: HoverMenuProps[\"align\"];\n  panelClassName?: string;\n  /** `data-*` attributes for the trigger itself — a tour's anchor (`data-tour`), a test\n   *  hook. The parts built on this menu (`TourMenu`) pass theirs through here. */\n  triggerAttributes?: { [key: `data-${string}`]: string | number | boolean | undefined };\n}) {\n  // Names the groups' headings for `aria-labelledby`. Positional rather than from the\n  // entry's `key`, which is the caller's text and may hold a space — and a space in\n  // `aria-labelledby` is a list separator.\n  const uid = useId();\n  return (\n    <HoverMenu\n      aria-label={ariaLabel}\n      align={align}\n      trigger={({ open, toggle, close }) => {\n        // One element for both kinds: the router's link when `href` is set, else the\n        // kit's button. Same classes and face either way.\n        //\n        // Its name in the kit's Tooltip on hover and focus (0.48, keksdose dev#610): an\n        // icon alone told a sighted user nothing the screen reader was told. In a\n        // fragment, as IconButton does it, so the bubble is not the trigger's\n        // `aria-describedby` — the name it repeats is the trigger's own, and a reader\n        // would hear it twice. Portalled, like the top bar's other triggers.\n        const control = (className: string, children: ReactNode, label?: string) => (\n          <Tooltip label={ariaLabel} portal>\n            <>\n              {href ? (\n                <Link {...triggerAttributes} to={href} onClick={close} aria-label={label} className={className}>\n                  {children}\n                </Link>\n              ) : (\n                <button {...triggerAttributes} type=\"button\" onClick={toggle} aria-label={label} className={className}>\n                  {children}\n                </button>\n              )}\n            </>\n          </Tooltip>\n        );\n        if (trigger) {\n          return control(\n            cn(TOPBAR_TRIGGER_CLASS, \"relative\", triggerClassName),\n            <>\n              <span className=\"sr-only\">{ariaLabel}</span>\n              {/* The space keeps the name from running into the face's text (\"Account\n                  menu3 unread\"); as a flex item it takes no room. */}\n              {\" \"}\n              {trigger({ open })}\n            </>,\n          );\n        }\n        if (iconBadge) {\n          // Named by its content, like the custom-trigger branch, so the badge label is\n          // part of the name; an `aria-label` would have hidden it.\n          return control(\n            cn(TOPBAR_TRIGGER_CLASS, \"relative\", triggerClassName),\n            <>\n              <span className=\"sr-only\">{ariaLabel}</span>{\" \"}\n              <span aria-hidden className=\"relative inline-flex\">\n                {icon}\n                <StatusDot ring tone={iconBadge.tone ?? \"danger\"} className=\"absolute -end-0.5 -top-0.5\" />\n              </span>{\" \"}\n              <span className=\"sr-only\">{iconBadge.label}</span>\n            </>,\n          );\n        }\n        return control(cn(TOPBAR_TRIGGER_CLASS, triggerClassName), icon, ariaLabel);\n      }}\n    >\n      {(close) => {\n        const footerBody = typeof footer === \"function\" ? footer(close) : footer;\n        const headerExtra = typeof header?.extra === \"function\" ? header.extra(close) : header?.extra;\n        const footerClass =\n          \"flex flex-wrap gap-x-3 gap-y-1 text-xs text-muted [&_a:hover]:text-primary [&_a]:rounded-sm [&_a:focus-visible]:outline-none [&_a:focus-visible]:ring-focus [&_a:focus-visible]:ring-brand\";\n        /** One action or link row — loose, or inside a heading's group. */\n        const row = (entry: RowEntry) => (\n          <li key={entry.key}>\n            {entry.kind === \"link\" ? (\n              <MenuItem\n                href={entry.to}\n                renderLink={({ href, ...p }) => <Link to={href} {...p} />}\n                onClick={close}\n                leading={entry.icon}\n                trailing={entry.trailing}\n                tone={entry.tone}\n                current={entry.current}\n                disabled={entry.disabled}\n              >\n                {entry.label}\n              </MenuItem>\n            ) : (\n              <MenuItem\n                onClick={() => {\n                  entry.onSelect();\n                  close();\n                }}\n                leading={entry.icon}\n                trailing={entry.trailing}\n                tone={entry.tone}\n                checked={entry.checked}\n                checkable={entry.checkable}\n                disabled={entry.disabled}\n              >\n                {entry.label}\n              </MenuItem>\n            )}\n          </li>\n        );\n        return (\n          // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- a Tab bubbling up from a row or footer link, see keepTabInsidePanel\n          <ul className={cn(\"py-1\", panelClassName)} onKeyDown={keepTabInsidePanel}>\n            {header && (\n              <MenuSection className=\"mb-1 border-b border-subtle px-3 py-2\">\n                <div className=\"truncate text-sm font-medium text-primary\">{header.title}</div>\n                {header.subtitle != null && (\n                  <div className=\"truncate text-xs text-muted\">{header.subtitle}</div>\n                )}\n                {headerExtra != null && headerExtra !== false && <div className=\"mt-1\">{headerExtra}</div>}\n              </MenuSection>\n            )}\n            {heading && (\n              <li className=\"px-3 py-1 text-micro font-semibold uppercase tracking-wide text-placeholder\">\n                {heading}\n              </li>\n            )}\n            {leading?.(close)}\n            {toBlocks(entries).map((block, i, blocks) => {\n              if (block.kind === \"loose\") {\n                const entry = block.entry;\n                if (entry.kind === \"divider\") {\n                  return <li key={entry.key} className=\"my-1 border-t border-subtle\" />;\n                }\n                return row(entry);\n              }\n              const headingId = `${uid}-group-${i}`;\n              const before = blocks[i - 1];\n              // Under a rule (or at the top of the rows) the rule's margin is the gap;\n              // straight under another group's last row the heading makes its own.\n              const tight = !before || (before.kind === \"loose\" && before.entry.kind === \"divider\");\n              return (\n                <li key={block.heading.key} role=\"none\">\n                  <div\n                    id={headingId}\n                    role=\"presentation\"\n                    className={cn(\n                      \"px-3 pb-0.5 text-caption font-semibold uppercase tracking-wide text-muted [overflow-wrap:anywhere]\",\n                      tight ? \"pt-1\" : \"pt-2.5\",\n                    )}\n                  >\n                    {block.heading.label}\n                  </div>\n                  <ul role=\"group\" aria-labelledby={headingId}>\n                    {block.rows.map(row)}\n                  </ul>\n                </li>\n              );\n            })}\n            {children?.(close)}\n            {footerBody != null && footerBody !== false && (\n              <MenuSection className=\"mt-1 border-t border-subtle px-3 py-2\">\n                {footerLabel ? (\n                  <nav aria-label={footerLabel} className={footerClass}>\n                    {footerBody}\n                  </nav>\n                ) : (\n                  <div className={footerClass}>{footerBody}</div>\n                )}\n              </MenuSection>\n            )}\n          </ul>\n        );\n      }}\n    </HoverMenu>\n  );\n}\n"],"mappings":"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","names":["children","href"]}

package/dist/shell/topbar-controls.js

@@ -1,5 +1,5 @@
 "use client";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Check, Globe, Moon, Palette, Sun } from "lucide-react";
 import { cn } from "../lib/cn.js";
 import { HoverMenu } from "../components/hover-menu.js";
@@ -20,7 +20,7 @@ function ThemeToggle({
 }) {
   const labels = useKitLabels("topBar", DEFAULT_TOP_BAR_LABELS, { theme: ariaLabel });
   const Icon = mode === "dark" ? Moon : Sun;
-  return /* @__PURE__ */ jsx(Tooltip, { label: title, portal: true, children: /* @__PURE__ */ jsx(
+  const button = /* @__PURE__ */ jsx(
     "button",
     {
       type: "button",
@@ -32,7 +32,9 @@ function ThemeToggle({
       className: cn(TOPBAR_TRIGGER_CLASS, className),
       children: /* @__PURE__ */ jsx(Icon, { className: "size-5" })
     }
-  ) });
+  );
+  const tip = title ?? labels.theme;
+  return /* @__PURE__ */ jsx(Tooltip, { label: tip, portal: true, children: tip === labels.theme ? /* @__PURE__ */ jsx(Fragment, { children: button }) : button });
 }
 function PaletteMenu({
   palettes,

package/dist/shell/topbar-controls.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shell/topbar-controls.tsx"],"sourcesContent":["import { Check, Globe, Moon, Palette, Sun } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { HoverMenu } from \"../components/hover-menu\";\nimport type { PalettePreset } from \"../theme/palette-presets\";\nimport type { ThemeMode } from \"../theme/theme-store\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { DEFAULT_TOP_BAR_LABELS, useKitLabels } from \"../i18n/kit-labels\";\n\n/** Shared square icon-button styling for top-bar triggers, so app-owned controls\n *  (account/feedback menus) line up with the shared ones. */\nexport const TOPBAR_TRIGGER_CLASS =\n  \"size-9 rounded-md flex items-center justify-center text-secondary hover:text-primary hover:bg-hover\";\n\n/** Shared row styling for the top-bar hover-menu items. `text-start`, so a label that\n *  wraps aligns to the reading edge in RTL too. */\nexport const TOPBAR_MENU_ITEM_CLASS =\n  \"flex w-full items-center justify-between gap-3 px-3 py-2 text-sm text-start text-secondary hover:bg-hover\";\n\n/** The small uppercase heading row the top-bar menus share (`heading`). */\nfunction MenuHeading({ children }: { children: string }) {\n  return (\n    <li className=\"px-3 py-1 text-micro font-semibold uppercase tracking-wide text-placeholder\">\n      {children}\n    </li>\n  );\n}\n\n/**\n * Sun/Moon toggle for the light/dark theme. Controlled: the app owns the mode, and the\n * toggle keeps no storage key of its own (docs/top-bar-harmonization.md §6.4).\n *\n * `mode` is the theme ON SCREEN — the resolved one, so with a \"system\" preference it is\n * whatever the OS gives. A tap asks for the opposite of that: `onChange(\"light\")` while\n * dark is shown, `onChange(\"dark\")` while light is. The app writes it as its theme\n * preference (an explicit light or dark), where Settings → Appearance keeps the three-way\n * choice. `onToggle` is the older way to hear the tap, without the next mode; both fire.\n */\nexport function ThemeToggle({\n  mode,\n  onToggle,\n  onChange,\n  \"aria-label\": ariaLabel,\n  title,\n  className,\n}: {\n  /** The resolved light/dark on screen (`useThemeStore`'s `mode`, not its preference). */\n  mode: ThemeMode;\n  /** Hears a tap. Kept for 0.41's callers; `onChange` says what to switch to. */\n  onToggle?: () => void;\n  /** 0.42: the mode to switch to — always the opposite of `mode`. */\n  onChange?: (next: ThemeMode) => void;\n  /** Default: `topBar.theme` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  title?: string;\n  className?: string;\n}) {\n  // This had no default at all, so a toggle rendered without `aria-label` was an\n  // icon button with no name — a reader heard \"button\" and nothing else.\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { theme: ariaLabel });\n  const Icon = mode === \"dark\" ? Moon : Sun;\n  return (\n    <Tooltip label={title} portal>\n      <button\n        type=\"button\"\n        onClick={() => {\n          onChange?.(mode === \"dark\" ? \"light\" : \"dark\");\n          onToggle?.();\n        }}\n        aria-label={labels.theme}\n        className={cn(TOPBAR_TRIGGER_CLASS, className)}\n      >\n        <Icon className=\"size-5\" />\n      </button>\n    </Tooltip>\n  );\n}\n\n/** Appearance-preset switcher: a hover menu of palette presets with per-theme\n *  colour swatches. Controlled — the app owns the active id and applies it. */\nexport function PaletteMenu({\n  palettes,\n  activeId,\n  mode,\n  onSelect,\n  \"aria-label\": ariaLabel,\n  heading,\n}: {\n  palettes: PalettePreset[];\n  activeId: string;\n  mode: ThemeMode;\n  onSelect: (id: string) => void;\n  /** Default: `topBar.palette` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  /** Optional small heading row above the list. */\n  heading?: string;\n}) {\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { palette: ariaLabel });\n  const activeName = palettes.find((p) => p.id === activeId)?.name ?? activeId;\n  return (\n    <HoverMenu\n      aria-label={labels.palette}\n      trigger={({ toggle }) => (\n        <Tooltip label={activeName} portal>\n          <button\n            type=\"button\"\n            onClick={toggle}\n            aria-label={labels.palette}\n            className={TOPBAR_TRIGGER_CLASS}\n          >\n            {/* A DATA colour, not a semantic one: the palette mark is the\n                \"colour\" control, so it carries a colour, and which hue is\n                arbitrary. `--chart-1` is the violet end of the CVD-safe\n                categorical ramp and flips per theme — a fixed `violet-500` did\n                not, and stayed a cool violet island on a warm page. */}\n            <Palette className=\"size-5 text-[var(--chart-1)]\" />\n          </button>\n        </Tooltip>\n      )}\n    >\n      {(close) => (\n        <ul className=\"w-60 py-1\">\n          {heading && <MenuHeading>{heading}</MenuHeading>}\n          {palettes.map((p) => {\n            const ts = p[mode];\n            const swatches = [ts.bgPage, ts.brand, ts.moneyIncome, ts.moneyExpense, ts.moneyNet];\n            return (\n              <li key={p.id}>\n                <button\n                  type=\"button\"\n                  onClick={() => {\n                    onSelect(p.id);\n                    close();\n                  }}\n                  className={TOPBAR_MENU_ITEM_CLASS}\n                >\n                  <span className=\"flex min-w-0 items-center gap-2\">\n                    <span className=\"flex shrink-0 gap-0.5\">\n                      {/* Deliberately a neutral at 10% and not a token: this hairline\n                          sits on an ARBITRARY preset colour, so it has to read against\n                          whatever that preset paints, which no themed border does. */}\n                      {swatches.map((c, i) => (\n                        <span\n                          key={i}\n                          className=\"size-3.5 rounded-sm ring-1 ring-inset ring-black/10 dark:ring-white/10\"\n                          style={{ background: c }}\n                        />\n                      ))}\n                    </span>\n                    <span className=\"flex min-w-0 flex-col text-start\">\n                      <span className=\"truncate\">{p.name}</span>\n                      <span className=\"truncate text-caption text-placeholder\">\n                        {p.blurb}\n                      </span>\n                    </span>\n                  </span>\n                  {activeId === p.id && (\n                    <Check className=\"size-4 shrink-0 text-secondary\" />\n                  )}\n                </button>\n              </li>\n            );\n          })}\n        </ul>\n      )}\n    </HoverMenu>\n  );\n}\n\nexport interface LanguageOption {\n  code: string;\n  label: string;\n  /** ISO 3166-1 alpha-2 country code (lowercase) for the flag-icons flag. */\n  country: string;\n}\n\n/** Language switcher: a hover menu of options with flags and a check on the\n *  active one. Controlled — the app owns the current code and change handler.\n *\n *  The trigger is the *active* option's flag, not an icon: lucide's `Languages`\n *  glyph (文A) is the same mark Chrome puts in the omnibox for \"translate this\n *  page\", so it read as machine-translation rather than \"pick the UI language\"\n *  (Keksdose feedback #121). The flag also shows which language is currently on,\n *  which no icon can, and costs the same width on a crowded mobile bar. A globe\n *  covers the case where `current` matches nothing in `options`. */\nexport function LanguageMenu({\n  options,\n  current,\n  onChange,\n  \"aria-label\": ariaLabel,\n  heading,\n}: {\n  options: LanguageOption[];\n  current: string | undefined;\n  onChange: (code: string) => void;\n  /** Default: `topBar.language` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  /** Optional small heading row above the list — as on `TopBarActionMenu`,\n   *  `OptionSwitcherMenu` and `PaletteMenu`. */\n  heading?: string;\n}) {\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { language: ariaLabel });\n  const active = options.find((o) => o.code === current);\n  return (\n    <HoverMenu\n      aria-label={labels.language}\n      trigger={({ toggle }) => (\n        <Tooltip label={active?.label ?? labels.language} portal>\n          <button\n            type=\"button\"\n            onClick={toggle}\n            aria-label={labels.language}\n            className={TOPBAR_TRIGGER_CLASS}\n          >\n            {active ? (\n              <span\n                aria-hidden\n                className={`fi fi-${active.country} inline-block h-[0.9375rem] w-5 shrink-0 rounded-sm shadow-[0_0_0_1px_rgba(0,0,0,0.08)]`}\n              />\n            ) : (\n              <Globe className=\"size-5\" />\n            )}\n          </button>\n        </Tooltip>\n      )}\n    >\n      {(close) => (\n        <ul className=\"py-1\">\n          {heading && <MenuHeading>{heading}</MenuHeading>}\n          {options.map((lang) => {\n            const isActive = lang.code === current;\n            return (\n              <li key={lang.code}>\n                <button\n                  type=\"button\"\n                  onClick={() => {\n                    onChange(lang.code);\n                    close();\n                  }}\n                  className={TOPBAR_MENU_ITEM_CLASS}\n                >\n                  <span className=\"flex items-center gap-2\">\n                    <span\n                      aria-hidden\n                      className={`fi fi-${lang.country} inline-block h-[0.9375rem] w-5 shrink-0 rounded-sm shadow-[0_0_0_1px_rgba(0,0,0,0.08)]`}\n                    />\n                    {lang.label}\n                  </span>\n                  {isActive && <Check className=\"size-4 text-secondary\" />}\n                </button>\n              </li>\n            );\n          })}\n        </ul>\n      )}\n    </HoverMenu>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/shell/topbar-controls.tsx"],"sourcesContent":["import { Check, Globe, Moon, Palette, Sun } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { HoverMenu } from \"../components/hover-menu\";\nimport type { PalettePreset } from \"../theme/palette-presets\";\nimport type { ThemeMode } from \"../theme/theme-store\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { DEFAULT_TOP_BAR_LABELS, useKitLabels } from \"../i18n/kit-labels\";\n\n/** Shared square icon-button styling for top-bar triggers, so app-owned controls\n *  (account/feedback menus) line up with the shared ones. */\nexport const TOPBAR_TRIGGER_CLASS =\n  \"size-9 rounded-md flex items-center justify-center text-secondary hover:text-primary hover:bg-hover\";\n\n/** Shared row styling for the top-bar hover-menu items. `text-start`, so a label that\n *  wraps aligns to the reading edge in RTL too. */\nexport const TOPBAR_MENU_ITEM_CLASS =\n  \"flex w-full items-center justify-between gap-3 px-3 py-2 text-sm text-start text-secondary hover:bg-hover\";\n\n/** The small uppercase heading row the top-bar menus share (`heading`). */\nfunction MenuHeading({ children }: { children: string }) {\n  return (\n    <li className=\"px-3 py-1 text-micro font-semibold uppercase tracking-wide text-placeholder\">\n      {children}\n    </li>\n  );\n}\n\n/**\n * Sun/Moon toggle for the light/dark theme. Controlled: the app owns the mode, and the\n * toggle keeps no storage key of its own (docs/top-bar-harmonization.md §6.4).\n *\n * `mode` is the theme ON SCREEN — the resolved one, so with a \"system\" preference it is\n * whatever the OS gives. A tap asks for the opposite of that: `onChange(\"light\")` while\n * dark is shown, `onChange(\"dark\")` while light is. The app writes it as its theme\n * preference (an explicit light or dark), where Settings → Appearance keeps the three-way\n * choice. `onToggle` is the older way to hear the tap, without the next mode; both fire.\n */\nexport function ThemeToggle({\n  mode,\n  onToggle,\n  onChange,\n  \"aria-label\": ariaLabel,\n  title,\n  className,\n}: {\n  /** The resolved light/dark on screen (`useThemeStore`'s `mode`, not its preference). */\n  mode: ThemeMode;\n  /** Hears a tap. Kept for 0.41's callers; `onChange` says what to switch to. */\n  onToggle?: () => void;\n  /** 0.42: the mode to switch to — always the opposite of `mode`. */\n  onChange?: (next: ThemeMode) => void;\n  /** Default: `topBar.theme` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  title?: string;\n  className?: string;\n}) {\n  // This had no default at all, so a toggle rendered without `aria-label` was an\n  // icon button with no name — a reader heard \"button\" and nothing else.\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { theme: ariaLabel });\n  const Icon = mode === \"dark\" ? Moon : Sun;\n  const button = (\n    <button\n      type=\"button\"\n      onClick={() => {\n        onChange?.(mode === \"dark\" ? \"light\" : \"dark\");\n        onToggle?.();\n      }}\n      aria-label={labels.theme}\n      className={cn(TOPBAR_TRIGGER_CLASS, className)}\n    >\n      <Icon className=\"size-5\" />\n    </button>\n  );\n  // The name on hover and focus even without a `title` (0.48, keksdose dev#610); a bubble\n  // that only repeats it is visual, in a fragment as on IconButton — see OptionSwitcherMenu.\n  const tip = title ?? labels.theme;\n  return (\n    <Tooltip label={tip} portal>\n      {tip === labels.theme ? <>{button}</> : button}\n    </Tooltip>\n  );\n}\n\n/** Appearance-preset switcher: a hover menu of palette presets with per-theme\n *  colour swatches. Controlled — the app owns the active id and applies it. */\nexport function PaletteMenu({\n  palettes,\n  activeId,\n  mode,\n  onSelect,\n  \"aria-label\": ariaLabel,\n  heading,\n}: {\n  palettes: PalettePreset[];\n  activeId: string;\n  mode: ThemeMode;\n  onSelect: (id: string) => void;\n  /** Default: `topBar.palette` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  /** Optional small heading row above the list. */\n  heading?: string;\n}) {\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { palette: ariaLabel });\n  const activeName = palettes.find((p) => p.id === activeId)?.name ?? activeId;\n  return (\n    <HoverMenu\n      aria-label={labels.palette}\n      trigger={({ toggle }) => (\n        <Tooltip label={activeName} portal>\n          <button\n            type=\"button\"\n            onClick={toggle}\n            aria-label={labels.palette}\n            className={TOPBAR_TRIGGER_CLASS}\n          >\n            {/* A DATA colour, not a semantic one: the palette mark is the\n                \"colour\" control, so it carries a colour, and which hue is\n                arbitrary. `--chart-1` is the violet end of the CVD-safe\n                categorical ramp and flips per theme — a fixed `violet-500` did\n                not, and stayed a cool violet island on a warm page. */}\n            <Palette className=\"size-5 text-[var(--chart-1)]\" />\n          </button>\n        </Tooltip>\n      )}\n    >\n      {(close) => (\n        <ul className=\"w-60 py-1\">\n          {heading && <MenuHeading>{heading}</MenuHeading>}\n          {palettes.map((p) => {\n            const ts = p[mode];\n            const swatches = [ts.bgPage, ts.brand, ts.moneyIncome, ts.moneyExpense, ts.moneyNet];\n            return (\n              <li key={p.id}>\n                <button\n                  type=\"button\"\n                  onClick={() => {\n                    onSelect(p.id);\n                    close();\n                  }}\n                  className={TOPBAR_MENU_ITEM_CLASS}\n                >\n                  <span className=\"flex min-w-0 items-center gap-2\">\n                    <span className=\"flex shrink-0 gap-0.5\">\n                      {/* Deliberately a neutral at 10% and not a token: this hairline\n                          sits on an ARBITRARY preset colour, so it has to read against\n                          whatever that preset paints, which no themed border does. */}\n                      {swatches.map((c, i) => (\n                        <span\n                          key={i}\n                          className=\"size-3.5 rounded-sm ring-1 ring-inset ring-black/10 dark:ring-white/10\"\n                          style={{ background: c }}\n                        />\n                      ))}\n                    </span>\n                    <span className=\"flex min-w-0 flex-col text-start\">\n                      <span className=\"truncate\">{p.name}</span>\n                      <span className=\"truncate text-caption text-placeholder\">\n                        {p.blurb}\n                      </span>\n                    </span>\n                  </span>\n                  {activeId === p.id && (\n                    <Check className=\"size-4 shrink-0 text-secondary\" />\n                  )}\n                </button>\n              </li>\n            );\n          })}\n        </ul>\n      )}\n    </HoverMenu>\n  );\n}\n\nexport interface LanguageOption {\n  code: string;\n  label: string;\n  /** ISO 3166-1 alpha-2 country code (lowercase) for the flag-icons flag. */\n  country: string;\n}\n\n/** Language switcher: a hover menu of options with flags and a check on the\n *  active one. Controlled — the app owns the current code and change handler.\n *\n *  The trigger is the *active* option's flag, not an icon: lucide's `Languages`\n *  glyph (文A) is the same mark Chrome puts in the omnibox for \"translate this\n *  page\", so it read as machine-translation rather than \"pick the UI language\"\n *  (Keksdose feedback #121). The flag also shows which language is currently on,\n *  which no icon can, and costs the same width on a crowded mobile bar. A globe\n *  covers the case where `current` matches nothing in `options`. */\nexport function LanguageMenu({\n  options,\n  current,\n  onChange,\n  \"aria-label\": ariaLabel,\n  heading,\n}: {\n  options: LanguageOption[];\n  current: string | undefined;\n  onChange: (code: string) => void;\n  /** Default: `topBar.language` from the {@link UiKitProvider}, else English. */\n  \"aria-label\"?: string;\n  /** Optional small heading row above the list — as on `TopBarActionMenu`,\n   *  `OptionSwitcherMenu` and `PaletteMenu`. */\n  heading?: string;\n}) {\n  const labels = useKitLabels(\"topBar\", DEFAULT_TOP_BAR_LABELS, { language: ariaLabel });\n  const active = options.find((o) => o.code === current);\n  return (\n    <HoverMenu\n      aria-label={labels.language}\n      trigger={({ toggle }) => (\n        <Tooltip label={active?.label ?? labels.language} portal>\n          <button\n            type=\"button\"\n            onClick={toggle}\n            aria-label={labels.language}\n            className={TOPBAR_TRIGGER_CLASS}\n          >\n            {active ? (\n              <span\n                aria-hidden\n                className={`fi fi-${active.country} inline-block h-[0.9375rem] w-5 shrink-0 rounded-sm shadow-[0_0_0_1px_rgba(0,0,0,0.08)]`}\n              />\n            ) : (\n              <Globe className=\"size-5\" />\n            )}\n          </button>\n        </Tooltip>\n      )}\n    >\n      {(close) => (\n        <ul className=\"py-1\">\n          {heading && <MenuHeading>{heading}</MenuHeading>}\n          {options.map((lang) => {\n            const isActive = lang.code === current;\n            return (\n              <li key={lang.code}>\n                <button\n                  type=\"button\"\n                  onClick={() => {\n                    onChange(lang.code);\n                    close();\n                  }}\n                  className={TOPBAR_MENU_ITEM_CLASS}\n                >\n                  <span className=\"flex items-center gap-2\">\n                    <span\n                      aria-hidden\n                      className={`fi fi-${lang.country} inline-block h-[0.9375rem] w-5 shrink-0 rounded-sm shadow-[0_0_0_1px_rgba(0,0,0,0.08)]`}\n                    />\n                    {lang.label}\n                  </span>\n                  {isActive && <Check className=\"size-4 text-secondary\" />}\n                </button>\n              </li>\n            );\n          })}\n        </ul>\n      )}\n    </HoverMenu>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/theme/theme-store.d.ts

@@ -16,10 +16,10 @@ export interface ThemeState {
 /**
  * Pre-hydration: read the theme PREFERENCE persisted under `storageKey` straight
  * from localStorage, resolve it to a concrete light/dark mode, and toggle the
- * `.dark` class on <html> — BEFORE React and the store mount, so the first paint
- * already has the right theme (no flash). Returns the resolved mode so the caller
- * can chain {@link applyPersistedPalette}. Encapsulates the zustand-persist
- * envelope + the legacy `mode`→`preference` fallback so apps never re-type the
+ * `.dark` class (and `color-scheme`) on <html> — BEFORE React and the store mount,
+ * so the first paint already has the right theme (no flash). Returns the resolved
+ * mode so the caller can chain {@link applyPersistedPalette}. Encapsulates the
+ * zustand-persist envelope + the legacy `mode`→`preference` fallback so apps never re-type the
  * storage shape in their entrypoint.
  */
 export declare function applyPersistedTheme(storageKey: string): ThemeMode;

package/dist/theme/theme-store.js

@@ -25,6 +25,7 @@ function applyThemeClass(mode) {
   const root = document.documentElement;
   if (mode === "dark") root.classList.add("dark");
   else root.classList.remove("dark");
+  root.style.colorScheme = mode;
 }
 function applyPersistedTheme(storageKey) {
   let preference = "system";

package/dist/theme/theme-store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/theme-store.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { create } from \"zustand\";\nimport { persist } from \"zustand/middleware\";\nimport { logger } from \"../lib/logger\";\nimport { registerDeviceSetting } from \"../lib/device-settings\";\n\nexport type ThemeMode = \"light\" | \"dark\";\n/** What the user chose; \"system\" tracks the OS `prefers-color-scheme`. */\nexport type ThemePreference = \"light\" | \"dark\" | \"system\";\n\nexport interface ThemeState {\n  /** The user's choice (persisted). */\n  preference: ThemePreference;\n  /** The RESOLVED light/dark actually in effect (system → OS). Read this for\n   *  anything that needs the concrete theme (e.g. token selection, toasts). */\n  mode: ThemeMode;\n  setPreference: (preference: ThemePreference) => void;\n  /** Set an explicit light/dark choice (preference follows). */\n  setMode: (mode: ThemeMode) => void;\n  /** Flip the effective theme to the opposite explicit choice. */\n  toggle: () => void;\n}\n\nfunction systemPreference(): ThemeMode {\n  try {\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n  } catch {\n    return \"light\";\n  }\n}\n\nfunction resolve(preference: ThemePreference): ThemeMode {\n  return preference === \"system\" ? systemPreference() : preference;\n}\n\n/** Normalize a persisted theme-state blob to a valid preference. Older blobs\n *  persisted the concrete `mode` (light/dark); carry that over as an explicit\n *  preference so the choice survives. Shared by the store's `migrate` and the\n *  pre-hydration {@link applyPersistedTheme}. */\nfunction preferenceFromState(\n  s: { mode?: string; preference?: string } | null | undefined,\n): ThemePreference {\n  if (s?.preference === \"light\" || s?.preference === \"dark\" || s?.preference === \"system\") {\n    return s.preference;\n  }\n  if (s?.mode === \"light\" || s?.mode === \"dark\") return s.mode;\n  return \"system\";\n}\n\n/** Toggle the `.dark` class on <html> for a resolved light/dark mode. */\nfunction applyThemeClass(mode: ThemeMode): void {\n  const root = document.documentElement;\n  if (mode === \"dark\") root.classList.add(\"dark\");\n  else root.classList.remove(\"dark\");\n}\n\n/**\n * Pre-hydration: read the theme PREFERENCE persisted under `storageKey` straight\n * from localStorage, resolve it to a concrete light/dark mode, and toggle the\n * `.dark` class on <html> — BEFORE React and the store mount, so the first paint\n * already has the right theme (no flash). Returns the resolved mode so the caller\n * can chain {@link applyPersistedPalette}. Encapsulates the zustand-persist\n * envelope + the legacy `mode`→`preference` fallback so apps never re-type the\n * storage shape in their entrypoint.\n */\nexport function applyPersistedTheme(storageKey: string): ThemeMode {\n  let preference: ThemePreference = \"system\";\n  try {\n    const blob = JSON.parse(localStorage.getItem(storageKey) ?? \"{}\") as {\n      state?: { mode?: string; preference?: string };\n    };\n    preference = preferenceFromState(blob.state);\n  } catch {\n    /* malformed storage → system */\n  }\n  const mode = resolve(preference);\n  applyThemeClass(mode);\n  return mode;\n}\n\n/**\n * Build a theme store bound to a consumer-supplied localStorage key. Tracks a\n * light/dark/system PREFERENCE (feedback #330) and exposes the resolved `mode`.\n * Returns the `useTheme` hook plus a `useApplyTheme` effect that toggles the\n * `.dark` class on <html> and, while on \"system\", follows OS theme changes live.\n */\nexport function createThemeStore(storageKey: string) {\n  const useTheme = create<ThemeState>()(\n    logger(\n      persist(\n        (set, get) => ({\n          preference: \"system\" as ThemePreference,\n          mode: systemPreference(),\n          setPreference: (preference) => set({ preference, mode: resolve(preference) }),\n          setMode: (mode) => set({ preference: mode, mode }),\n          toggle: () => {\n            const next: ThemeMode = get().mode === \"dark\" ? \"light\" : \"dark\";\n            set({ preference: next, mode: next });\n          },\n        }),\n        {\n          name: storageKey,\n          version: 2,\n          // Only the preference is persisted; `mode` is derived on load.\n          partialize: (s) => ({ preference: s.preference }),\n          migrate: (persistedState): { preference: ThemePreference } => ({\n            preference: preferenceFromState(\n              persistedState as { mode?: string; preference?: string } | null,\n            ),\n          }),\n          onRehydrateStorage: () => (state) => {\n            // The persisted preference decides the concrete mode at load.\n            if (state) state.mode = resolve(state.preference);\n          },\n        },\n      ),\n      \"theme\",\n    ),\n  );\n  // Reset this device's settings (docs/settings-harmonization.md §11.4): back to\n  // \"System\" through the setter, which re-resolves `mode`; `useApplyTheme` puts the\n  // class back and follows the OS again, and the persisted blob is what the pre-paint\n  // `applyPersistedTheme` reads next load.\n  registerDeviceSetting({\n    key: storageKey,\n    kind: \"appearance\",\n    reset: () => useTheme.getState().setPreference(\"system\"),\n  });\n\n  function useApplyTheme(): void {\n    const mode = useTheme((s) => s.mode);\n    const preference = useTheme((s) => s.preference);\n    useEffect(() => {\n      applyThemeClass(mode);\n    }, [mode]);\n    // While tracking the system, follow OS theme changes live.\n    useEffect(() => {\n      if (preference !== \"system\") return;\n      let mq: MediaQueryList;\n      try {\n        mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n      } catch {\n        return;\n      }\n      const onChange = () => useTheme.setState({ mode: mq.matches ? \"dark\" : \"light\" });\n      onChange();\n      mq.addEventListener?.(\"change\", onChange);\n      return () => mq.removeEventListener?.(\"change\", onChange);\n    }, [preference]);\n  }\n\n  return { useTheme, useApplyTheme };\n}\n\nexport type ThemeStore = ReturnType<typeof createThemeStore>;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/theme/theme-store.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { create } from \"zustand\";\nimport { persist } from \"zustand/middleware\";\nimport { logger } from \"../lib/logger\";\nimport { registerDeviceSetting } from \"../lib/device-settings\";\n\nexport type ThemeMode = \"light\" | \"dark\";\n/** What the user chose; \"system\" tracks the OS `prefers-color-scheme`. */\nexport type ThemePreference = \"light\" | \"dark\" | \"system\";\n\nexport interface ThemeState {\n  /** The user's choice (persisted). */\n  preference: ThemePreference;\n  /** The RESOLVED light/dark actually in effect (system → OS). Read this for\n   *  anything that needs the concrete theme (e.g. token selection, toasts). */\n  mode: ThemeMode;\n  setPreference: (preference: ThemePreference) => void;\n  /** Set an explicit light/dark choice (preference follows). */\n  setMode: (mode: ThemeMode) => void;\n  /** Flip the effective theme to the opposite explicit choice. */\n  toggle: () => void;\n}\n\nfunction systemPreference(): ThemeMode {\n  try {\n    return window.matchMedia(\"(prefers-color-scheme: dark)\").matches ? \"dark\" : \"light\";\n  } catch {\n    return \"light\";\n  }\n}\n\nfunction resolve(preference: ThemePreference): ThemeMode {\n  return preference === \"system\" ? systemPreference() : preference;\n}\n\n/** Normalize a persisted theme-state blob to a valid preference. Older blobs\n *  persisted the concrete `mode` (light/dark); carry that over as an explicit\n *  preference so the choice survives. Shared by the store's `migrate` and the\n *  pre-hydration {@link applyPersistedTheme}. */\nfunction preferenceFromState(\n  s: { mode?: string; preference?: string } | null | undefined,\n): ThemePreference {\n  if (s?.preference === \"light\" || s?.preference === \"dark\" || s?.preference === \"system\") {\n    return s.preference;\n  }\n  if (s?.mode === \"light\" || s?.mode === \"dark\") return s.mode;\n  return \"system\";\n}\n\n/**\n * Toggle the `.dark` class on <html> for a resolved light/dark mode, and say the same\n * to the BROWSER through `color-scheme` (0.47, keksdose dev #600): the class switches\n * the kit's tokens, but everything the browser paints itself — a native `<select>`'s\n * open list, a date input's popup, scrollbars, autofill — follows `color-scheme` only,\n * and stayed light on the dark theme. Inline on <html>, so it holds whatever an app's\n * stylesheet says, and it is set by the pre-paint {@link applyPersistedTheme} too.\n */\nfunction applyThemeClass(mode: ThemeMode): void {\n  const root = document.documentElement;\n  if (mode === \"dark\") root.classList.add(\"dark\");\n  else root.classList.remove(\"dark\");\n  root.style.colorScheme = mode;\n}\n\n/**\n * Pre-hydration: read the theme PREFERENCE persisted under `storageKey` straight\n * from localStorage, resolve it to a concrete light/dark mode, and toggle the\n * `.dark` class (and `color-scheme`) on <html> — BEFORE React and the store mount,\n * so the first paint already has the right theme (no flash). Returns the resolved\n * mode so the caller can chain {@link applyPersistedPalette}. Encapsulates the\n * zustand-persist envelope + the legacy `mode`→`preference` fallback so apps never re-type the\n * storage shape in their entrypoint.\n */\nexport function applyPersistedTheme(storageKey: string): ThemeMode {\n  let preference: ThemePreference = \"system\";\n  try {\n    const blob = JSON.parse(localStorage.getItem(storageKey) ?? \"{}\") as {\n      state?: { mode?: string; preference?: string };\n    };\n    preference = preferenceFromState(blob.state);\n  } catch {\n    /* malformed storage → system */\n  }\n  const mode = resolve(preference);\n  applyThemeClass(mode);\n  return mode;\n}\n\n/**\n * Build a theme store bound to a consumer-supplied localStorage key. Tracks a\n * light/dark/system PREFERENCE (feedback #330) and exposes the resolved `mode`.\n * Returns the `useTheme` hook plus a `useApplyTheme` effect that toggles the\n * `.dark` class on <html> and, while on \"system\", follows OS theme changes live.\n */\nexport function createThemeStore(storageKey: string) {\n  const useTheme = create<ThemeState>()(\n    logger(\n      persist(\n        (set, get) => ({\n          preference: \"system\" as ThemePreference,\n          mode: systemPreference(),\n          setPreference: (preference) => set({ preference, mode: resolve(preference) }),\n          setMode: (mode) => set({ preference: mode, mode }),\n          toggle: () => {\n            const next: ThemeMode = get().mode === \"dark\" ? \"light\" : \"dark\";\n            set({ preference: next, mode: next });\n          },\n        }),\n        {\n          name: storageKey,\n          version: 2,\n          // Only the preference is persisted; `mode` is derived on load.\n          partialize: (s) => ({ preference: s.preference }),\n          migrate: (persistedState): { preference: ThemePreference } => ({\n            preference: preferenceFromState(\n              persistedState as { mode?: string; preference?: string } | null,\n            ),\n          }),\n          onRehydrateStorage: () => (state) => {\n            // The persisted preference decides the concrete mode at load.\n            if (state) state.mode = resolve(state.preference);\n          },\n        },\n      ),\n      \"theme\",\n    ),\n  );\n  // Reset this device's settings (docs/settings-harmonization.md §11.4): back to\n  // \"System\" through the setter, which re-resolves `mode`; `useApplyTheme` puts the\n  // class back and follows the OS again, and the persisted blob is what the pre-paint\n  // `applyPersistedTheme` reads next load.\n  registerDeviceSetting({\n    key: storageKey,\n    kind: \"appearance\",\n    reset: () => useTheme.getState().setPreference(\"system\"),\n  });\n\n  function useApplyTheme(): void {\n    const mode = useTheme((s) => s.mode);\n    const preference = useTheme((s) => s.preference);\n    useEffect(() => {\n      applyThemeClass(mode);\n    }, [mode]);\n    // While tracking the system, follow OS theme changes live.\n    useEffect(() => {\n      if (preference !== \"system\") return;\n      let mq: MediaQueryList;\n      try {\n        mq = window.matchMedia(\"(prefers-color-scheme: dark)\");\n      } catch {\n        return;\n      }\n      const onChange = () => useTheme.setState({ mode: mq.matches ? \"dark\" : \"light\" });\n      onChange();\n      mq.addEventListener?.(\"change\", onChange);\n      return () => mq.removeEventListener?.(\"change\", onChange);\n    }, [preference]);\n  }\n\n  return { useTheme, useApplyTheme };\n}\n\nexport type ThemeStore = ReturnType<typeof createThemeStore>;\n"],"mappings":";AAAA,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,6BAA6B;AAmBtC,SAAS,mBAA8B;AACrC,MAAI;AACF,WAAO,OAAO,WAAW,8BAA8B,EAAE,UAAU,SAAS;AAAA,EAC9E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,QAAQ,YAAwC;AACvD,SAAO,eAAe,WAAW,iBAAiB,IAAI;AACxD;AAMA,SAAS,oBACP,GACiB;AACjB,MAAI,GAAG,eAAe,WAAW,GAAG,eAAe,UAAU,GAAG,eAAe,UAAU;AACvF,WAAO,EAAE;AAAA,EACX;AACA,MAAI,GAAG,SAAS,WAAW,GAAG,SAAS,OAAQ,QAAO,EAAE;AACxD,SAAO;AACT;AAUA,SAAS,gBAAgB,MAAuB;AAC9C,QAAM,OAAO,SAAS;AACtB,MAAI,SAAS,OAAQ,MAAK,UAAU,IAAI,MAAM;AAAA,MACzC,MAAK,UAAU,OAAO,MAAM;AACjC,OAAK,MAAM,cAAc;AAC3B;AAWO,SAAS,oBAAoB,YAA+B;AACjE,MAAI,aAA8B;AAClC,MAAI;AACF,UAAM,OAAO,KAAK,MAAM,aAAa,QAAQ,UAAU,KAAK,IAAI;AAGhE,iBAAa,oBAAoB,KAAK,KAAK;AAAA,EAC7C,QAAQ;AAAA,EAER;AACA,QAAM,OAAO,QAAQ,UAAU;AAC/B,kBAAgB,IAAI;AACpB,SAAO;AACT;AAQO,SAAS,iBAAiB,YAAoB;AACnD,QAAM,WAAW,OAAmB;AAAA,IAClC;AAAA,MACE;AAAA,QACE,CAAC,KAAK,SAAS;AAAA,UACb,YAAY;AAAA,UACZ,MAAM,iBAAiB;AAAA,UACvB,eAAe,CAAC,eAAe,IAAI,EAAE,YAAY,MAAM,QAAQ,UAAU,EAAE,CAAC;AAAA,UAC5E,SAAS,CAAC,SAAS,IAAI,EAAE,YAAY,MAAM,KAAK,CAAC;AAAA,UACjD,QAAQ,MAAM;AACZ,kBAAM,OAAkB,IAAI,EAAE,SAAS,SAAS,UAAU;AAC1D,gBAAI,EAAE,YAAY,MAAM,MAAM,KAAK,CAAC;AAAA,UACtC;AAAA,QACF;AAAA,QACA;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA;AAAA,UAET,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW;AAAA,UAC/C,SAAS,CAAC,oBAAqD;AAAA,YAC7D,YAAY;AAAA,cACV;AAAA,YACF;AAAA,UACF;AAAA,UACA,oBAAoB,MAAM,CAAC,UAAU;AAEnC,gBAAI,MAAO,OAAM,OAAO,QAAQ,MAAM,UAAU;AAAA,UAClD;AAAA,QACF;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAKA,wBAAsB;AAAA,IACpB,KAAK;AAAA,IACL,MAAM;AAAA,IACN,OAAO,MAAM,SAAS,SAAS,EAAE,cAAc,QAAQ;AAAA,EACzD,CAAC;AAED,WAAS,gBAAsB;AAC7B,UAAM,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI;AACnC,UAAM,aAAa,SAAS,CAAC,MAAM,EAAE,UAAU;AAC/C,cAAU,MAAM;AACd,sBAAgB,IAAI;AAAA,IACtB,GAAG,CAAC,IAAI,CAAC;AAET,cAAU,MAAM;AACd,UAAI,eAAe,SAAU;AAC7B,UAAI;AACJ,UAAI;AACF,aAAK,OAAO,WAAW,8BAA8B;AAAA,MACvD,QAAQ;AACN;AAAA,MACF;AACA,YAAM,WAAW,MAAM,SAAS,SAAS,EAAE,MAAM,GAAG,UAAU,SAAS,QAAQ,CAAC;AAChF,eAAS;AACT,SAAG,mBAAmB,UAAU,QAAQ;AACxC,aAAO,MAAM,GAAG,sBAAsB,UAAU,QAAQ;AAAA,IAC1D,GAAG,CAAC,UAAU,CAAC;AAAA,EACjB;AAEA,SAAO,EAAE,UAAU,cAAc;AACnC;","names":[]}

package/dist/tour/tour.js

@@ -297,6 +297,7 @@ function TourOverlay({
         className: cn("pointer-events-none fixed inset-0", interactive ? "z-[45]" : "z-[60]"),
         role: "dialog",
         "aria-modal": interactive ? void 0 : "true",
+        "data-tour-overlay": "",
         "data-tour-interactive": interactive ? "" : void 0,
         "aria-label": step.title,
         dir,

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, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Button } from \"../components/button\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { sameRect } from \"../hooks/use-anchored-rect\";\nimport { dirOf, horizontalStep } from \"../lib/direction\";\nimport type { Direction } from \"../lib/direction\";\nimport { DEFAULT_TOUR_LABELS } from \"./tour-labels\";\nimport type { TourInfo } from \"./tour-info\";\nimport { completeStored, rememberAccount, rememberMigrate, type UseTourProgressOptions } from \"./use-tour-progress\";\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  /**\n   * The spotlighted control is for USING, not only for looking at (0.46, keksdose live\n   * #436): the layers it opens sit above the scrim and work. A plain step's overlay is\n   * `z-[60]`, over every kit layer, so a field whose number pad (`NumberPadSheet`), a\n   * select's menu or a popover opens at `z-50` opened UNDER the shields, where nothing\n   * could be tapped. Here the overlay drops to `z-[45]`: still over the top bar and the\n   * page (`z-40` and below, still dimmed and shielded), under every `z-50` layer the\n   * target opens — so an app's own layer wants `z-50` or more to clear it. Keys pressed\n   * in the target or in such a layer are theirs (Escape closes the pad, arrows walk a\n   * list); from the card the tour's keys work as on any step. The overlay is not\n   * `aria-modal` then, and carries `data-tour-interactive`.\n   *\n   * The card is in the same layer as the scrim, so an open pad or sheet may cover it\n   * until it closes. Requires `target`. A `HoverMenu` (`z-40`, the top bar's menus) stays\n   * under the scrim: point an `awaitClick` step at its trigger instead.\n   */\n  interactive?: boolean;\n  /**\n   * Advance once a value was ENTERED in the spotlighted control (0.46, keksdose live\n   * #436) — `awaitClick` for a field. Implies `interactive`. Counted when focus leaves\n   * the target (the number pad's Done, a Tab, a tap elsewhere), or Enter is pressed in\n   * it, and one of its fields (`input`, `textarea`, `select`: the target itself or\n   * inside it) then holds another value than when the step began; a native `change`\n   * (a select, a checkbox) counts at once. The card swaps Next for `awaitInputHint`,\n   * as for `awaitClick`. A picker whose value is not a field's (the kit's `Select`\n   * button) has nothing to compare: call `useTour().next()` from its `onChange`.\n   */\n  awaitInput?: 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  /** Shown in place of the Next button on an `awaitInput` step (0.46). */\n  awaitInputHint: string;\n  /** Step counter, e.g. (2, 7) => \"2 / 7\". */\n  step: (current: number, total: number) => string;\n}\n\n// Defined in ./tour-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_TOUR_LABELS };\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. Defaults to\n   *  `tour.id`. */\n  id?: string;\n  /** The tour being started, as the app lists it (docs/tours-harmonization.md §9.6.1).\n   *  When its last step is finished, the provider records the completion in its\n   *  `progress` and hands this to `onComplete`. */\n  tour?: TourInfo;\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  /** After the last step: runs after the provider's progress write and `onComplete`. */\n  onFinish?: () => void;\n  onSkip?: () => void;\n}\n\n/** What `TourProvider`'s `onComplete` learns besides the tour (§9.1, §9.6). */\nexport interface TourCompletion {\n  /**\n   * `true` when the completion counts anew (the first time, or the first time after the\n   * tour's update, §8): the moment for the app's points toast. `false` for a replay, and\n   * when the stored text is in an old shape no `migrate` reads: nothing is overwritten\n   * then, and the error goes to `console.error` (keksdose B-1). `undefined` when the provider has no `progress` or the start carried no `tour`, so\n   * nothing was recorded.\n   */\n  awarded: boolean | undefined;\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/** The kit's dev switch (as number-input's): a development build, never under vitest. */\nfunction devWarnings(): boolean {\n  return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;\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 *\n * **Completion in one place** (docs/tours-harmonization.md §9.6): give the provider the\n * app's `progress` (the same `{storageKey, migrate}` as `useTourProgress`) and start each\n * tour with `start(steps, {tour})`. When the last step is finished the provider writes the\n * completion ONCE, through the store every `useTourProgress` reader of the key shares\n * (never a second copy), then calls `onComplete(tour, {awarded})`, then the start's own\n * `onFinish`. A skip or `stop()` records nothing and calls neither. The app removes its\n * own `complete()` from `onFinish`, or that second write answers `false`.\n *\n * Both props are optional: without `progress` or a `tour` on the start, `onComplete`\n * still fires, with `awarded: undefined` (and `tour` as given, possibly `undefined`). A\n * new `storageKey` (an account switch on a shared PC) is followed on the next\n * completion, without a remount.\n */\nexport function TourProvider({\n  children,\n  labels,\n  progress,\n  onComplete,\n}: {\n  children: ReactNode;\n  labels?: LabelOverride<TourLabels>;\n  /** The app's tour progress: the same options its `useTourProgress` readers use. */\n  progress?: UseTourProgressOptions;\n  /** A tour's last step was finished; see {@link TourCompletion}. */\n  onComplete?: (tour: TourInfo | undefined, completion: TourCompletion) => void;\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  // The latest props, read at the finish: a new `storageKey` or callback needs no remount.\n  const progressRef = useRef(progress);\n  const onCompleteRef = useRef(onComplete);\n  useLayoutEffect(() => {\n    progressRef.current = progress;\n    onCompleteRef.current = onComplete;\n  });\n  // The provider's migrate becomes the key's, for readers that pass none (keksdose B-2).\n  const storageKey = progress?.storageKey;\n  const migrate = progress?.migrate;\n  // 0.45: and its `account` (§10.3), so a finish on an account key is sent as readers' are.\n  const account = progress?.account;\n  useLayoutEffect(() => {\n    if (storageKey !== undefined) rememberMigrate(storageKey, migrate);\n    if (storageKey !== undefined) rememberAccount(storageKey, account);\n  }, [storageKey, migrate, account]);\n  const warnedNoTourRef = useRef(false);\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 ?? opts?.tour?.id ?? null);\n    setSteps(s);\n  }, []);\n  const stop = useCallback(() => {\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n  const finish = useCallback(() => {\n    // Once per tour: a second \"Done\" before the overlay unmounts records nothing more.\n    if (!stepsRef.current) return;\n    stepsRef.current = null;\n    const { tour, onFinish } = optsRef.current;\n    const store = progressRef.current;\n    // Exactly one write per completion (§9.6.2), so `awarded` is what `complete(tour)` answered.\n    let awarded: boolean | undefined;\n    if (store && tour) {\n      try {\n        awarded = completeStored(store.storageKey, store.migrate, tour);\n      } catch (error) {\n        // A stored text no migrate reads is left as it is (keksdose B-1); the tour still ends.\n        console.error(error);\n        awarded = false;\n      }\n    } else if (store && !tour && devWarnings() && !warnedNoTourRef.current) {\n      warnedNoTourRef.current = true;\n      console.warn(\n        \"[ui-kit] TourProvider has `progress`, but a finished tour's start carried no `tour`: \" +\n          \"nothing was recorded and `awarded` is undefined. Start it with `start(steps, { tour })`.\",\n      );\n    }\n    onCompleteRef.current?.(tour, { awarded });\n    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 rectOf(el: Element): Rect {\n  const r = el.getBoundingClientRect();\n  return { top: r.top, left: r.left, width: r.width, height: r.height };\n}\n\n/**\n * What the finder established for ONE step: where its target is (`null` = no target,\n * or not on the page), and the reading direction the card takes from it.\n *\n * It carries the step it was found for, and the overlay only believes it for that\n * step — which is the whole fix for keksdose's tours audit 2026-10-02, §1.0 A (\"stale\n * spotlight on the step after a spotlighted one\", 15 steps in 16 tours, desktop and\n * phone, mouse and keyboard). When step N spotlit a target and step N+1 had none (or\n * its anchor was missing), N+1 kept N's hole and parked its card beside it, so a\n * centred \"You're all set\" read as pointing at the Import & Export link; Back→Next kept\n * it for as long as anyone watched.\n *\n * The overlay used to hold `rect` and `ready` as separate states and reset them\n * DURING RENDER when the step changed. React 19 does not keep a render-phase update\n * while an earlier, lower-priority update to the same hook is still queued — it only\n * writes the result to the base state \"unless the queue is empty\" — and the follow\n * interval below queues exactly such an update every 250 ms (eagerly bailed out because\n * the rect had not moved, but left in the queue for rebasing). So the click's render\n * showed the reset, and the very next render (the finder saying \"ready\") re-based on\n * the old rect. A deep link was fine because nothing had queued anything yet.\n *\n * Keying the result to its step does not depend on any of that ordering: a rect found\n * for another step is not this step's rect, whatever the queue does with it, and a\n * missing anchor reads as \"no target\" instead of as the last thing that was lit.\n */\ninterface Located {\n  index: number;\n  step: TourStep;\n  rect: Rect | null;\n  dir: Direction;\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  // A new step starts unlocated: whatever was found for another step (see `Located`)\n  // is ignored, so the overlay renders nothing until the effect below has located THIS\n  // step, and never the previous step's spotlight.\n  const [located, setLocated] = useState<Located | null>(null);\n  const current = located !== null && located.index === index && located.step === step ? located : null;\n  const ready = current !== null;\n  const rect = current?.rect ?? null;\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: Direction = current?.dir ?? \"ltr\";\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    // `null` = untargeted, or the finder gave up → the card centres, with no hole.\n    const settle = (el: Element | null) =>\n      setLocated({ index, step, rect: el ? rectOf(el) : null, dir: dirOf(el) });\n    void (async () => {\n      await step.beforeStep?.();\n      if (cancelled) return;\n      if (!step.target) {\n        settle(null);\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          settle(el);\n          return;\n        }\n        if (tries++ < 45) raf = requestAnimationFrame(find);\n        else settle(null); // give up → render centered\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 — only once THIS step is located,\n  // and only into this step's result.\n  useEffect(() => {\n    if (!step.target) return;\n    const update = () => {\n      const el = queryVisibleTarget(step.target!);\n      if (el) {\n        const next = rectOf(el);\n        setLocated((prev) =>\n          prev && prev.index === index && prev.step === step && !sameRect(prev.rect, next)\n            ? { ...prev, rect: next }\n            : prev,\n        );\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  //\n  // Re-armed when the target turns up after the finder gave up (the follow effect\n  // lights it late): the card swaps Next for the \"click the highlighted element\" hint\n  // as soon as there is a rect, so the click must work from that moment too.\n  const spotted = rect !== null;\n  useEffect(() => {\n    if (!ready || !spotted || !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, spotted, index, step, onNext]);\n\n  // An interactive step (see `TourStep.interactive`): only while the target is lit — a\n  // step whose target is missing centres its card over a full scrim, modal as ever.\n  const interactive = spotted && !!step.target && !!(step.interactive || step.awaitInput);\n\n  // awaitInput: advance once the target's fields hold another value than when the step\n  // was armed, checked when focus leaves the target or Enter is pressed in it — on the\n  // next macrotask, after the field's own blur/Enter commit has rendered. A value the\n  // number pad typed fires no native `change`, so comparing is what catches it.\n  useEffect(() => {\n    if (!ready || !spotted || !step.awaitInput || !step.target) return;\n    const el = queryVisibleTarget(step.target) as HTMLElement | null;\n    if (!el) return;\n    const read = () => fieldValues(el);\n    const before = read();\n    let timer = 0;\n    let done = false;\n    const check = () => {\n      window.clearTimeout(timer);\n      timer = window.setTimeout(() => {\n        if (done || read() === before) return;\n        done = true;\n        onNext();\n      }, 0);\n    };\n    const onFocusOut = (e: FocusEvent) => {\n      if (e.relatedTarget instanceof Node && el.contains(e.relatedTarget)) return;\n      check();\n    };\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"Enter\") check();\n    };\n    el.addEventListener(\"focusout\", onFocusOut);\n    el.addEventListener(\"keydown\", onKeyDown);\n    el.addEventListener(\"change\", check);\n    return () => {\n      window.clearTimeout(timer);\n      el.removeEventListener(\"focusout\", onFocusOut);\n      el.removeEventListener(\"keydown\", onKeyDown);\n      el.removeEventListener(\"change\", check);\n    };\n  }, [ready, spotted, 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      // On an interactive step a key pressed in the target, or in a layer it opened (the\n      // number pad's Escape, a menu's arrows), is the page's. The card's and the bare\n      // page's (focus on <body>) stay the tour's.\n      if (interactive && e.target instanceof Node && e.target !== document.body && !rootRef.current?.contains(e.target)) {\n        return;\n      }\n      if (e.key === \"Escape\") {\n        onSkip();\n        return;\n      }\n      if (e.key === \"Enter\") {\n        if (step.awaitClick || step.awaitInput || 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, interactive, 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      // z-[45] on an interactive step: over the top bar (z-40), under the z-50 layers the\n      // target opens. See `TourStep.interactive`.\n      className={cn(\"pointer-events-none fixed inset-0\", interactive ? \"z-[45]\" : \"z-[60]\")}\n      role=\"dialog\"\n      aria-modal={interactive ? undefined : \"true\"}\n      data-tour-interactive={interactive ? \"\" : undefined}\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/** The values of the fields at or inside `el`, as one string to compare (`awaitInput`). */\nfunction fieldValues(el: Element): string {\n  const fields = el.matches(\"input,textarea,select\") ? [el] : Array.from(el.querySelectorAll(\"input,textarea,select\"));\n  return fields\n    .map((f) =>\n      f instanceof HTMLInputElement && (f.type === \"checkbox\" || f.type === \"radio\")\n        ? String(f.checked)\n        : (f as HTMLInputElement).value,\n    )\n    .join(\"\\u0000\");\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-subtle bg-surface p-4 shadow-xl outline-none transition-all duration-200 ease-out\"\n    >\n      <div className=\"text-sm font-semibold text-primary\">{step.title}</div>\n      <div className=\"mt-1 text-sm leading-relaxed 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-placeholder hover: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-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.awaitInput) && 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.awaitInput) && step.target && rect && (\n          <div className=\"text-center text-xs italic text-placeholder\">\n            {step.awaitInput && !step.awaitClick ? labels.awaitInputHint : 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, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Button } from \"../components/button\";\nimport { useFocusTrap } from \"../hooks/use-focus-trap\";\nimport { sameRect } from \"../hooks/use-anchored-rect\";\nimport { dirOf, horizontalStep } from \"../lib/direction\";\nimport type { Direction } from \"../lib/direction\";\nimport { DEFAULT_TOUR_LABELS } from \"./tour-labels\";\nimport type { TourInfo } from \"./tour-info\";\nimport { completeStored, rememberAccount, rememberMigrate, type UseTourProgressOptions } from \"./use-tour-progress\";\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  /**\n   * The spotlighted control is for USING, not only for looking at (0.46, keksdose live\n   * #436): the layers it opens sit above the scrim and work. A plain step's overlay is\n   * `z-[60]`, over every kit layer, so a field whose number pad (`NumberPadSheet`), a\n   * select's menu or a popover opens at `z-50` opened UNDER the shields, where nothing\n   * could be tapped. Here the overlay drops to `z-[45]`: still over the top bar and the\n   * page (`z-40` and below, still dimmed and shielded), under every `z-50` layer the\n   * target opens — so an app's own layer wants `z-50` or more to clear it. Keys pressed\n   * in the target or in such a layer are theirs (Escape closes the pad, arrows walk a\n   * list); from the card the tour's keys work as on any step. The overlay is not\n   * `aria-modal` then, and carries `data-tour-interactive`.\n   *\n   * The card is in the same layer as the scrim, so an open pad or sheet may cover it\n   * until it closes. Requires `target`. A `HoverMenu` (`z-40`, the top bar's menus) stays\n   * under the scrim: point an `awaitClick` step at its trigger instead.\n   */\n  interactive?: boolean;\n  /**\n   * Advance once a value was ENTERED in the spotlighted control (0.46, keksdose live\n   * #436) — `awaitClick` for a field. Implies `interactive`. Counted when focus leaves\n   * the target (the number pad's Done, a Tab, a tap elsewhere), or Enter is pressed in\n   * it, and one of its fields (`input`, `textarea`, `select`: the target itself or\n   * inside it) then holds another value than when the step began; a native `change`\n   * (a select, a checkbox) counts at once. The card swaps Next for `awaitInputHint`,\n   * as for `awaitClick`. A picker whose value is not a field's (the kit's `Select`\n   * button) has nothing to compare: call `useTour().next()` from its `onChange`.\n   */\n  awaitInput?: 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  /** Shown in place of the Next button on an `awaitInput` step (0.46). */\n  awaitInputHint: string;\n  /** Step counter, e.g. (2, 7) => \"2 / 7\". */\n  step: (current: number, total: number) => string;\n}\n\n// Defined in ./tour-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_TOUR_LABELS };\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. Defaults to\n   *  `tour.id`. */\n  id?: string;\n  /** The tour being started, as the app lists it (docs/tours-harmonization.md §9.6.1).\n   *  When its last step is finished, the provider records the completion in its\n   *  `progress` and hands this to `onComplete`. */\n  tour?: TourInfo;\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  /** After the last step: runs after the provider's progress write and `onComplete`. */\n  onFinish?: () => void;\n  onSkip?: () => void;\n}\n\n/** What `TourProvider`'s `onComplete` learns besides the tour (§9.1, §9.6). */\nexport interface TourCompletion {\n  /**\n   * `true` when the completion counts anew (the first time, or the first time after the\n   * tour's update, §8): the moment for the app's points toast. `false` for a replay, and\n   * when the stored text is in an old shape no `migrate` reads: nothing is overwritten\n   * then, and the error goes to `console.error` (keksdose B-1). `undefined` when the provider has no `progress` or the start carried no `tour`, so\n   * nothing was recorded.\n   */\n  awarded: boolean | undefined;\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/** The kit's dev switch (as number-input's): a development build, never under vitest. */\nfunction devWarnings(): boolean {\n  return Boolean(import.meta.env?.DEV) && !import.meta.env?.VITEST;\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 *\n * **Completion in one place** (docs/tours-harmonization.md §9.6): give the provider the\n * app's `progress` (the same `{storageKey, migrate}` as `useTourProgress`) and start each\n * tour with `start(steps, {tour})`. When the last step is finished the provider writes the\n * completion ONCE, through the store every `useTourProgress` reader of the key shares\n * (never a second copy), then calls `onComplete(tour, {awarded})`, then the start's own\n * `onFinish`. A skip or `stop()` records nothing and calls neither. The app removes its\n * own `complete()` from `onFinish`, or that second write answers `false`.\n *\n * Both props are optional: without `progress` or a `tour` on the start, `onComplete`\n * still fires, with `awarded: undefined` (and `tour` as given, possibly `undefined`). A\n * new `storageKey` (an account switch on a shared PC) is followed on the next\n * completion, without a remount.\n */\nexport function TourProvider({\n  children,\n  labels,\n  progress,\n  onComplete,\n}: {\n  children: ReactNode;\n  labels?: LabelOverride<TourLabels>;\n  /** The app's tour progress: the same options its `useTourProgress` readers use. */\n  progress?: UseTourProgressOptions;\n  /** A tour's last step was finished; see {@link TourCompletion}. */\n  onComplete?: (tour: TourInfo | undefined, completion: TourCompletion) => void;\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  // The latest props, read at the finish: a new `storageKey` or callback needs no remount.\n  const progressRef = useRef(progress);\n  const onCompleteRef = useRef(onComplete);\n  useLayoutEffect(() => {\n    progressRef.current = progress;\n    onCompleteRef.current = onComplete;\n  });\n  // The provider's migrate becomes the key's, for readers that pass none (keksdose B-2).\n  const storageKey = progress?.storageKey;\n  const migrate = progress?.migrate;\n  // 0.45: and its `account` (§10.3), so a finish on an account key is sent as readers' are.\n  const account = progress?.account;\n  useLayoutEffect(() => {\n    if (storageKey !== undefined) rememberMigrate(storageKey, migrate);\n    if (storageKey !== undefined) rememberAccount(storageKey, account);\n  }, [storageKey, migrate, account]);\n  const warnedNoTourRef = useRef(false);\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 ?? opts?.tour?.id ?? null);\n    setSteps(s);\n  }, []);\n  const stop = useCallback(() => {\n    setSteps(null);\n    setActiveId(null);\n  }, []);\n  const finish = useCallback(() => {\n    // Once per tour: a second \"Done\" before the overlay unmounts records nothing more.\n    if (!stepsRef.current) return;\n    stepsRef.current = null;\n    const { tour, onFinish } = optsRef.current;\n    const store = progressRef.current;\n    // Exactly one write per completion (§9.6.2), so `awarded` is what `complete(tour)` answered.\n    let awarded: boolean | undefined;\n    if (store && tour) {\n      try {\n        awarded = completeStored(store.storageKey, store.migrate, tour);\n      } catch (error) {\n        // A stored text no migrate reads is left as it is (keksdose B-1); the tour still ends.\n        console.error(error);\n        awarded = false;\n      }\n    } else if (store && !tour && devWarnings() && !warnedNoTourRef.current) {\n      warnedNoTourRef.current = true;\n      console.warn(\n        \"[ui-kit] TourProvider has `progress`, but a finished tour's start carried no `tour`: \" +\n          \"nothing was recorded and `awarded` is undefined. Start it with `start(steps, { tour })`.\",\n      );\n    }\n    onCompleteRef.current?.(tour, { awarded });\n    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 rectOf(el: Element): Rect {\n  const r = el.getBoundingClientRect();\n  return { top: r.top, left: r.left, width: r.width, height: r.height };\n}\n\n/**\n * What the finder established for ONE step: where its target is (`null` = no target,\n * or not on the page), and the reading direction the card takes from it.\n *\n * It carries the step it was found for, and the overlay only believes it for that\n * step — which is the whole fix for keksdose's tours audit 2026-10-02, §1.0 A (\"stale\n * spotlight on the step after a spotlighted one\", 15 steps in 16 tours, desktop and\n * phone, mouse and keyboard). When step N spotlit a target and step N+1 had none (or\n * its anchor was missing), N+1 kept N's hole and parked its card beside it, so a\n * centred \"You're all set\" read as pointing at the Import & Export link; Back→Next kept\n * it for as long as anyone watched.\n *\n * The overlay used to hold `rect` and `ready` as separate states and reset them\n * DURING RENDER when the step changed. React 19 does not keep a render-phase update\n * while an earlier, lower-priority update to the same hook is still queued — it only\n * writes the result to the base state \"unless the queue is empty\" — and the follow\n * interval below queues exactly such an update every 250 ms (eagerly bailed out because\n * the rect had not moved, but left in the queue for rebasing). So the click's render\n * showed the reset, and the very next render (the finder saying \"ready\") re-based on\n * the old rect. A deep link was fine because nothing had queued anything yet.\n *\n * Keying the result to its step does not depend on any of that ordering: a rect found\n * for another step is not this step's rect, whatever the queue does with it, and a\n * missing anchor reads as \"no target\" instead of as the last thing that was lit.\n */\ninterface Located {\n  index: number;\n  step: TourStep;\n  rect: Rect | null;\n  dir: Direction;\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  // A new step starts unlocated: whatever was found for another step (see `Located`)\n  // is ignored, so the overlay renders nothing until the effect below has located THIS\n  // step, and never the previous step's spotlight.\n  const [located, setLocated] = useState<Located | null>(null);\n  const current = located !== null && located.index === index && located.step === step ? located : null;\n  const ready = current !== null;\n  const rect = current?.rect ?? null;\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: Direction = current?.dir ?? \"ltr\";\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    // `null` = untargeted, or the finder gave up → the card centres, with no hole.\n    const settle = (el: Element | null) =>\n      setLocated({ index, step, rect: el ? rectOf(el) : null, dir: dirOf(el) });\n    void (async () => {\n      await step.beforeStep?.();\n      if (cancelled) return;\n      if (!step.target) {\n        settle(null);\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          settle(el);\n          return;\n        }\n        if (tries++ < 45) raf = requestAnimationFrame(find);\n        else settle(null); // give up → render centered\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 — only once THIS step is located,\n  // and only into this step's result.\n  useEffect(() => {\n    if (!step.target) return;\n    const update = () => {\n      const el = queryVisibleTarget(step.target!);\n      if (el) {\n        const next = rectOf(el);\n        setLocated((prev) =>\n          prev && prev.index === index && prev.step === step && !sameRect(prev.rect, next)\n            ? { ...prev, rect: next }\n            : prev,\n        );\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  //\n  // Re-armed when the target turns up after the finder gave up (the follow effect\n  // lights it late): the card swaps Next for the \"click the highlighted element\" hint\n  // as soon as there is a rect, so the click must work from that moment too.\n  const spotted = rect !== null;\n  useEffect(() => {\n    if (!ready || !spotted || !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, spotted, index, step, onNext]);\n\n  // An interactive step (see `TourStep.interactive`): only while the target is lit — a\n  // step whose target is missing centres its card over a full scrim, modal as ever.\n  const interactive = spotted && !!step.target && !!(step.interactive || step.awaitInput);\n\n  // awaitInput: advance once the target's fields hold another value than when the step\n  // was armed, checked when focus leaves the target or Enter is pressed in it — on the\n  // next macrotask, after the field's own blur/Enter commit has rendered. A value the\n  // number pad typed fires no native `change`, so comparing is what catches it.\n  useEffect(() => {\n    if (!ready || !spotted || !step.awaitInput || !step.target) return;\n    const el = queryVisibleTarget(step.target) as HTMLElement | null;\n    if (!el) return;\n    const read = () => fieldValues(el);\n    const before = read();\n    let timer = 0;\n    let done = false;\n    const check = () => {\n      window.clearTimeout(timer);\n      timer = window.setTimeout(() => {\n        if (done || read() === before) return;\n        done = true;\n        onNext();\n      }, 0);\n    };\n    const onFocusOut = (e: FocusEvent) => {\n      if (e.relatedTarget instanceof Node && el.contains(e.relatedTarget)) return;\n      check();\n    };\n    const onKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"Enter\") check();\n    };\n    el.addEventListener(\"focusout\", onFocusOut);\n    el.addEventListener(\"keydown\", onKeyDown);\n    el.addEventListener(\"change\", check);\n    return () => {\n      window.clearTimeout(timer);\n      el.removeEventListener(\"focusout\", onFocusOut);\n      el.removeEventListener(\"keydown\", onKeyDown);\n      el.removeEventListener(\"change\", check);\n    };\n  }, [ready, spotted, 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      // On an interactive step a key pressed in the target, or in a layer it opened (the\n      // number pad's Escape, a menu's arrows), is the page's. The card's and the bare\n      // page's (focus on <body>) stay the tour's.\n      if (interactive && e.target instanceof Node && e.target !== document.body && !rootRef.current?.contains(e.target)) {\n        return;\n      }\n      if (e.key === \"Escape\") {\n        onSkip();\n        return;\n      }\n      if (e.key === \"Enter\") {\n        if (step.awaitClick || step.awaitInput || 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, interactive, 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      // z-[45] on an interactive step: over the top bar (z-40), under the z-50 layers the\n      // target opens. See `TourStep.interactive`.\n      className={cn(\"pointer-events-none fixed inset-0\", interactive ? \"z-[45]\" : \"z-[60]\")}\n      role=\"dialog\"\n      aria-modal={interactive ? undefined : \"true\"}\n      // A stable marker for the overlay, on every step (0.48, keksdose dev#611–613): an\n      // app that hides its floating help launcher while a modal is open excepts the\n      // tour, which may spotlight that launcher — `[aria-modal=\"true\"]:not([data-tour-overlay])`.\n      // keksdose matched the `pointer-events-none` class until now, which is the kit's to change.\n      data-tour-overlay=\"\"\n      data-tour-interactive={interactive ? \"\" : undefined}\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/** The values of the fields at or inside `el`, as one string to compare (`awaitInput`). */\nfunction fieldValues(el: Element): string {\n  const fields = el.matches(\"input,textarea,select\") ? [el] : Array.from(el.querySelectorAll(\"input,textarea,select\"));\n  return fields\n    .map((f) =>\n      f instanceof HTMLInputElement && (f.type === \"checkbox\" || f.type === \"radio\")\n        ? String(f.checked)\n        : (f as HTMLInputElement).value,\n    )\n    .join(\"\\u0000\");\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-subtle bg-surface p-4 shadow-xl outline-none transition-all duration-200 ease-out\"\n    >\n      <div className=\"text-sm font-semibold text-primary\">{step.title}</div>\n      <div className=\"mt-1 text-sm leading-relaxed 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-placeholder hover: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-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.awaitInput) && 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.awaitInput) && step.target && rect && (\n          <div className=\"text-center text-xs italic text-placeholder\">\n            {step.awaitInput && !step.awaitClick ? labels.awaitInputHint : labels.awaitClickHint}\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eifi1/ui-kit",
-  "version": "0.46.1",
+  "version": "0.48.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.",
@@ -213,7 +213,7 @@
     "tsup": "^8.5.0",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.70.1",
-    "vite": "^8.3.1",
+    "vite": "^8.3.4",
     "vitest": "^5.0.2"
   },
   "license": "MIT",