@eifi1/ui-kit 0.50.0 → 0.51.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 { 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"]}
+{"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 * `scrollable`'s cap (0.51, DevMenu): the glass under the bar. Under `TopBar` the panel\n * starts about 50px down — the `size-9` trigger centred in the `h-12` bar ends at 42px,\n * and `HoverMenu` hangs the panel `pt-2` below it — so 4rem (64px) leaves some 14px clear\n * under the last row. `dvh`, not `vh`: on a phone `100vh` is the viewport with the\n * browser's toolbars put away, taller than the glass while they show.\n * `overscroll-contain`, so a fling past the last row does not scroll the page behind.\n */\nconst SCROLLABLE_PANEL = \"max-h-[calc(100dvh-4rem)] overflow-y-auto overscroll-contain\";\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. A menu that can grow taller than a phone's glass passes\n * `scrollable` (0.51), since that clamp is sideways only.\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  scrollable = false,\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  /**\n   * Cap the panel at the glass under the top bar and scroll the rows inside it (0.51,\n   * `DevMenu`). `HoverMenu` keeps a panel inside the viewport sideways only, so a tall\n   * one ran off the bottom of the screen: DevMenu's ~25 rows on a 390×844 phone, with\n   * the last ones out of reach — the page cannot scroll them up, the panel hangs from\n   * the sticky bar.\n   *\n   * Off by default: a menu that fits keeps its natural height and has no scroll\n   * container (`TourMenu` keeps its own `max-h-[70vh]`). The keyboard needs nothing\n   * extra: `HoverMenu`'s roving focus is a plain `focus()`, which the browser follows by\n   * scrolling the panel to the row, so ↓, ↑, Home and End reach a row below the cap. The\n   * header and the footer are inside the list and scroll with the rows.\n   */\n  scrollable?: boolean;\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\", scrollable && SCROLLABLE_PANEL, 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.d.ts

@@ -41,7 +41,9 @@ export { TourMenu } from "./shell/tour-menu.js";
 export type { TourMenuProps, TourMenuTour } from "./shell/tour-menu.js";
 export { SyncStatusIndicator, syncState } from "./shell/sync-status-indicator.js";
 export type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from "./shell/sync-status-indicator.js";
-export { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from "./shell/dev-switchers.js";
+export { DevMenu, DEV_ORIGINAL_ROLE_KEY } from "./shell/dev-menu.js";
+export type { DevMenuProps, DevMenuSection } from "./shell/dev-menu.js";
+export { DevSwitchers } from "./shell/dev-switchers.js";
 export type { DevSwitchersProps } from "./shell/dev-switchers.js";
 export { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from "./shell/top-bar-parts-labels.js";
 export type { TopBarPartsLabels, TourMenuLabels, SyncStatusLabels, DevSwitchersLabels, } from "./shell/top-bar-parts-labels.js";

package/dist/shell.js

@@ -44,7 +44,8 @@ import { AccountMenuLanguage } from "./shell/account-menu-language.js";
 import { AccountMenuTextSize } from "./shell/account-menu-text-size.js";
 import { TourMenu } from "./shell/tour-menu.js";
 import { SyncStatusIndicator, syncState } from "./shell/sync-status-indicator.js";
-import { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from "./shell/dev-switchers.js";
+import { DevMenu, DEV_ORIGINAL_ROLE_KEY } from "./shell/dev-menu.js";
+import { DevSwitchers } from "./shell/dev-switchers.js";
 import { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from "./shell/top-bar-parts-labels.js";
 export {
   AccountMenuLanguage,
@@ -54,6 +55,7 @@ export {
   DEFAULT_LAST_VISITED_EXCLUDES,
   DEFAULT_TOP_BAR_PARTS_LABELS,
   DEV_ORIGINAL_ROLE_KEY,
+  DevMenu,
   DevSwitchers,
   FILL_HEIGHT_CLASS,
   FillHeight,

package/dist/shell.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.40.0: the list page's fill (docs/page-layout-harmonization.md §1.3).\nexport { FillHeight, FILL_HEIGHT_CLASS } from \"./shell/fill-height\";\nexport type { FillHeightProps } from \"./shell/fill-height\";\n// 0.42.0: the account menu's \"Administration\" row, as an entry and as a HoverMenu row\n// (docs/admin-harmonization.md §2.1, §6.6).\nexport { adminMenuEntry, AdminMenuRow } from \"./shell/admin-menu\";\nexport type { AdminMenuEntryOptions, AdminMenuRowProps } from \"./shell/admin-menu\";\n// 0.43.0 (kastlan): the entry with the provider's words.\nexport { useAdminMenuEntry } from \"./shell/admin-menu\";\nexport type { UseAdminMenuEntryOptions } from \"./shell/admin-menu\";\n// 0.45.0 (docs/admin-harmonization.md §9.3.4): the row's waiting pill on its own, for\n// IconButton's `badge` (kastlan's platform button); its name is `adminArea.waitingLabel`.\nexport { AdminWaitingBadge } from \"./shell/admin-menu\";\nexport type { AdminWaitingBadgeProps } from \"./shell/admin-menu\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n// 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in\n// §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the\n// local-dev switchers, and their words.\nexport { TopBarActions, TOP_BAR_ACTION_ORDER } from \"./shell/top-bar-actions\";\nexport type { TopBarActionsProps } from \"./shell/top-bar-actions\";\nexport { AccountMenuLanguage } from \"./shell/account-menu-language\";\nexport type { AccountMenuLanguageProps, AccountMenuLanguageOption } from \"./shell/account-menu-language\";\n// 0.46.0 (keksdose live #426): A− / A+ for the text size, beside the language.\nexport { AccountMenuTextSize } from \"./shell/account-menu-text-size\";\nexport type { AccountMenuTextSizeProps } from \"./shell/account-menu-text-size\";\nexport { TourMenu } from \"./shell/tour-menu\";\nexport type { TourMenuProps, TourMenuTour } from \"./shell/tour-menu\";\nexport { SyncStatusIndicator, syncState } from \"./shell/sync-status-indicator\";\nexport type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from \"./shell/sync-status-indicator\";\nexport { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from \"./shell/dev-switchers\";\nexport type { DevSwitchersProps } from \"./shell/dev-switchers\";\nexport { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from \"./shell/top-bar-parts-labels\";\nexport type {\n  TopBarPartsLabels,\n  TourMenuLabels,\n  SyncStatusLabels,\n  DevSwitchersLabels,\n} from \"./shell/top-bar-parts-labels\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,YAAY,yBAAyB;AAI9C,SAAS,gBAAgB,oBAAoB;AAG7C,SAAS,yBAAyB;AAIlC,SAAS,yBAAyB;AAGlC,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;AAK7B,SAAS,eAAe,4BAA4B;AAEpD,SAAS,2BAA2B;AAGpC,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB,iBAAiB;AAE/C,SAAS,cAAc,6BAA6B;AAEpD,SAAS,8BAA8B,4BAA4B;","names":[]}
+{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.40.0: the list page's fill (docs/page-layout-harmonization.md §1.3).\nexport { FillHeight, FILL_HEIGHT_CLASS } from \"./shell/fill-height\";\nexport type { FillHeightProps } from \"./shell/fill-height\";\n// 0.42.0: the account menu's \"Administration\" row, as an entry and as a HoverMenu row\n// (docs/admin-harmonization.md §2.1, §6.6).\nexport { adminMenuEntry, AdminMenuRow } from \"./shell/admin-menu\";\nexport type { AdminMenuEntryOptions, AdminMenuRowProps } from \"./shell/admin-menu\";\n// 0.43.0 (kastlan): the entry with the provider's words.\nexport { useAdminMenuEntry } from \"./shell/admin-menu\";\nexport type { UseAdminMenuEntryOptions } from \"./shell/admin-menu\";\n// 0.45.0 (docs/admin-harmonization.md §9.3.4): the row's waiting pill on its own, for\n// IconButton's `badge` (kastlan's platform button); its name is `adminArea.waitingLabel`.\nexport { AdminWaitingBadge } from \"./shell/admin-menu\";\nexport type { AdminWaitingBadgeProps } from \"./shell/admin-menu\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n// 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in\n// §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the\n// local-dev switchers, and their words.\nexport { TopBarActions, TOP_BAR_ACTION_ORDER } from \"./shell/top-bar-actions\";\nexport type { TopBarActionsProps } from \"./shell/top-bar-actions\";\nexport { AccountMenuLanguage } from \"./shell/account-menu-language\";\nexport type { AccountMenuLanguageProps, AccountMenuLanguageOption } from \"./shell/account-menu-language\";\n// 0.46.0 (keksdose live #426): A− / A+ for the text size, beside the language.\nexport { AccountMenuTextSize } from \"./shell/account-menu-text-size\";\nexport type { AccountMenuTextSizeProps } from \"./shell/account-menu-text-size\";\nexport { TourMenu } from \"./shell/tour-menu\";\nexport type { TourMenuProps, TourMenuTour } from \"./shell/tour-menu\";\nexport { SyncStatusIndicator, syncState } from \"./shell/sync-status-indicator\";\nexport type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from \"./shell/sync-status-indicator\";\n// 0.51 (§2.7.1, keksdose): one flask, the kit's Account section and the app's own dev\n// sections; `DevSwitchers` is a deprecated wrapper over it until 0.52.\nexport { DevMenu, DEV_ORIGINAL_ROLE_KEY } from \"./shell/dev-menu\";\nexport type { DevMenuProps, DevMenuSection } from \"./shell/dev-menu\";\nexport { DevSwitchers } from \"./shell/dev-switchers\";\nexport type { DevSwitchersProps } from \"./shell/dev-switchers\";\nexport { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from \"./shell/top-bar-parts-labels\";\nexport type {\n  TopBarPartsLabels,\n  TourMenuLabels,\n  SyncStatusLabels,\n  DevSwitchersLabels,\n} from \"./shell/top-bar-parts-labels\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,YAAY,yBAAyB;AAI9C,SAAS,gBAAgB,oBAAoB;AAG7C,SAAS,yBAAyB;AAIlC,SAAS,yBAAyB;AAGlC,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;AAK7B,SAAS,eAAe,4BAA4B;AAEpD,SAAS,2BAA2B;AAGpC,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB,iBAAiB;AAI/C,SAAS,SAAS,6BAA6B;AAE/C,SAAS,oBAAoB;AAE7B,SAAS,8BAA8B,4BAA4B;","names":[]}

package/dist/testing/index.d.ts

@@ -1,2 +1,3 @@
 export { KIT_CSS_VARIABLES, declaredCustomProperties, undeclaredCssVariables, type UndeclaredCssVariablesOptions, } from "./css-variables.js";
 export { setViewportWidth, stubResizeObserver, stubViewportWidth, viewportMatchMedia, type ResizeObserverStub, type StubbedBoxSize, type ViewportOptions, } from "./viewport.js";
+export { tourStepContext, type TestTourStepContext, type TourStepContextOptions, type TourStepVia, } from "./tour.js";

package/dist/testing/index.js

@@ -10,12 +10,16 @@ import {
   stubViewportWidth,
   viewportMatchMedia
 } from "./viewport.js";
+import {
+  tourStepContext
+} from "./tour.js";
 export {
   KIT_CSS_VARIABLES,
   declaredCustomProperties,
   setViewportWidth,
   stubResizeObserver,
   stubViewportWidth,
+  tourStepContext,
   undeclaredCssVariables,
   viewportMatchMedia
 };

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// `@eifi1/ui-kit/testing` — helpers an app runs from its OWN test suite (0.33).\n//\n// Not part of the main barrel: nothing here renders, and an app's production bundle has\n// no business carrying it. Browser-safe like the rest of the kit (no `node:fs`): each\n// helper takes texts, so an app collects them with `import.meta.glob` or `node:fs`, as\n// its setup allows. The first content is the guard against undeclared CSS custom\n// properties (docs/colour-roles-harmonization.md §8).\nexport {\n  KIT_CSS_VARIABLES,\n  declaredCustomProperties,\n  undeclaredCssVariables,\n  type UndeclaredCssVariablesOptions,\n} from \"./css-variables\";\n// 0.34 (refactor audit 2026-10, TST-10): the environment jsdom lacks — a `matchMedia`\n// that answers from a viewport width (right at every text size) and a `ResizeObserver`\n// the test drives. Framework-free: each returns its own undo. 0.35: `setViewportWidth`,\n// a live resize of the stub in force — its lists flip and fire `change` (keksdose).\nexport {\n  setViewportWidth,\n  stubResizeObserver,\n  stubViewportWidth,\n  viewportMatchMedia,\n  type ResizeObserverStub,\n  type StubbedBoxSize,\n  type ViewportOptions,\n} from \"./viewport\";\n"],"mappings":";AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAKP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;","names":[]}
+{"version":3,"sources":["../../src/testing/index.ts"],"sourcesContent":["// `@eifi1/ui-kit/testing` — helpers an app runs from its OWN test suite (0.33).\n//\n// Not part of the main barrel: nothing here renders, and an app's production bundle has\n// no business carrying it. Browser-safe like the rest of the kit (no `node:fs`): each\n// helper takes texts, so an app collects them with `import.meta.glob` or `node:fs`, as\n// its setup allows. The first content is the guard against undeclared CSS custom\n// properties (docs/colour-roles-harmonization.md §8).\nexport {\n  KIT_CSS_VARIABLES,\n  declaredCustomProperties,\n  undeclaredCssVariables,\n  type UndeclaredCssVariablesOptions,\n} from \"./css-variables\";\n// 0.34 (refactor audit 2026-10, TST-10): the environment jsdom lacks — a `matchMedia`\n// that answers from a viewport width (right at every text size) and a `ResizeObserver`\n// the test drives. Framework-free: each returns its own undo. 0.35: `setViewportWidth`,\n// a live resize of the stub in force — its lists flip and fire `change` (keksdose).\nexport {\n  setViewportWidth,\n  stubResizeObserver,\n  stubViewportWidth,\n  viewportMatchMedia,\n  type ResizeObserverStub,\n  type StubbedBoxSize,\n  type ViewportOptions,\n} from \"./viewport\";\n// 0.50.1 (keksdose N4): a valid `TourStepContext` for a test that calls a step's\n// `beforeStep` or `when` itself — `beforeStep!(tourStepContext())`.\nexport {\n  tourStepContext,\n  type TestTourStepContext,\n  type TourStepContextOptions,\n  type TourStepVia,\n} from \"./tour\";\n"],"mappings":";AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAKP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAGP;AAAA,EACE;AAAA,OAIK;","names":[]}

package/dist/testing/tour.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 0.50.1 (keksdose N4): a `TourStepContext` for a test that calls a step's `beforeStep` or
+ * `when` itself. 0.50 gave both the context, so `beforeStep!()` is a type error;
+ * `beforeStep!(tourStepContext())` is the drop-in.
+ *
+ * Spelled out here rather than imported from the tour module, so `@eifi1/ui-kit/testing`
+ * still reaches no package (the tour module reaches React); the kit's own test pins that it
+ * is assignable to `TourStepContext`.
+ */
+/** How a step is entered: `TourStepContext["via"]`. */
+export type TourStepVia = "start" | "at" | "next" | "back" | "goto";
+/** The shape of `TourStepContext` (`@eifi1/ui-kit/tour`). */
+export interface TestTourStepContext {
+    gate(key: string): boolean | undefined;
+    via: TourStepVia;
+}
+export interface TourStepContextOptions {
+    /** How the step is entered. Default `"start"`. */
+    via?: TourStepVia;
+    /**
+     * The published gates, as the form would publish them: `{ "txn.transfer": true }`. A key
+     * left out answers `undefined` (nobody publishes it). Default: none.
+     */
+    gates?: Readonly<Record<string, boolean | undefined>>;
+}
+/**
+ * A valid step context: `via: "start"` and no gates published, unless `options` say
+ * otherwise. `step.beforeStep!(tourStepContext())`, `step.when!(tourStepContext({ gates:
+ * { "txn.transfer": true } }))`, `tourStepContext({ via: "at" })` for a "Guide me" entry.
+ */
+export declare function tourStepContext(options?: TourStepContextOptions): TestTourStepContext;

package/dist/testing/tour.js

@@ -0,0 +1,12 @@
+"use client";
+function tourStepContext(options = {}) {
+  const gates = options.gates ?? {};
+  return {
+    gate: (key) => Object.prototype.hasOwnProperty.call(gates, key) ? gates[key] : void 0,
+    via: options.via ?? "start"
+  };
+}
+export {
+  tourStepContext
+};
+//# sourceMappingURL=tour.js.map

package/dist/testing/tour.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/tour.ts"],"sourcesContent":["/**\n * 0.50.1 (keksdose N4): a `TourStepContext` for a test that calls a step's `beforeStep` or\n * `when` itself. 0.50 gave both the context, so `beforeStep!()` is a type error;\n * `beforeStep!(tourStepContext())` is the drop-in.\n *\n * Spelled out here rather than imported from the tour module, so `@eifi1/ui-kit/testing`\n * still reaches no package (the tour module reaches React); the kit's own test pins that it\n * is assignable to `TourStepContext`.\n */\n\n/** How a step is entered: `TourStepContext[\"via\"]`. */\nexport type TourStepVia = \"start\" | \"at\" | \"next\" | \"back\" | \"goto\";\n\n/** The shape of `TourStepContext` (`@eifi1/ui-kit/tour`). */\nexport interface TestTourStepContext {\n  gate(key: string): boolean | undefined;\n  via: TourStepVia;\n}\n\nexport interface TourStepContextOptions {\n  /** How the step is entered. Default `\"start\"`. */\n  via?: TourStepVia;\n  /**\n   * The published gates, as the form would publish them: `{ \"txn.transfer\": true }`. A key\n   * left out answers `undefined` (nobody publishes it). Default: none.\n   */\n  gates?: Readonly<Record<string, boolean | undefined>>;\n}\n\n/**\n * A valid step context: `via: \"start\"` and no gates published, unless `options` say\n * otherwise. `step.beforeStep!(tourStepContext())`, `step.when!(tourStepContext({ gates:\n * { \"txn.transfer\": true } }))`, `tourStepContext({ via: \"at\" })` for a \"Guide me\" entry.\n */\nexport function tourStepContext(options: TourStepContextOptions = {}): TestTourStepContext {\n  const gates = options.gates ?? {};\n  return {\n    gate: (key) => (Object.prototype.hasOwnProperty.call(gates, key) ? gates[key] : undefined),\n    via: options.via ?? \"start\",\n  };\n}\n"],"mappings":";AAkCO,SAAS,gBAAgB,UAAkC,CAAC,GAAwB;AACzF,QAAM,QAAQ,QAAQ,SAAS,CAAC;AAChC,SAAO;AAAA,IACL,MAAM,CAAC,QAAS,OAAO,UAAU,eAAe,KAAK,OAAO,GAAG,IAAI,MAAM,GAAG,IAAI;AAAA,IAChF,KAAK,QAAQ,OAAO;AAAA,EACtB;AACF;","names":[]}

package/dist/theme/palette-presets.d.ts

@@ -32,9 +32,6 @@ export declare const DEFAULT_PRESET: PalettePreset;
  * reachable only as `var(--chart-9)`.
  */
 export declare const PAUL_TOL_PRESET: PalettePreset;
-/** @deprecated 0.49 — use `DEFAULT_PRESET` (Imprint IS the default now); removed in 0.51.
- *  A persisted `"imprint"` id resolves to it through `presetById`'s fallback. */
-export declare const IMPRINT_PRESET: PalettePreset;
 /**
  * Presets DERIVED rather than picked, by `derivePalette` from one brand colour each.
  *

package/dist/theme/palette-presets.js

@@ -115,7 +115,6 @@ const PAUL_TOL_PRESET = {
     }
   }
 };
-const IMPRINT_PRESET = DEFAULT_PRESET;
 const KIT_RAMP = {
   light: DEFAULT_PRESET.light.chart,
   dark: DEFAULT_PRESET.dark.chart
@@ -372,7 +371,6 @@ function applyTokenSet(el, t, contrast = el.getAttribute("data-contrast") === "m
 export {
   DEFAULT_PRESET,
   DERIVED_PRESETS,
-  IMPRINT_PRESET,
   PALETTES,
   PAUL_TOL_PRESET,
   applyTokenSet,

package/dist/theme/palette-presets.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/palette-presets.ts"],"sourcesContent":["// Appearance presets — the single source of truth for the \"palette switcher\"\n// (feedback #307). Each preset is a full set of design-token values for BOTH\n// light and dark, covering the page/surface backgrounds, the brand accent, the\n// semantic money trio and the categorical chart palette (anyplot's eight \"Imprint\"\n// hues by default since 0.49, Paul Tol's nine in `PAUL_TOL_PRESET`), plus the\n// heatmap stops. A preset is applied at runtime by writing these as CSS custom\n// properties onto <html> (see palette-store.ts), which instantly re-skins every\n// token-driven surface and chart. The two heatmaps and the treemap interpolate\n// concrete hex in JS, so they read the same values from here via the hooks in\n// palette-store.\n//\n// The default preset here mirrors the :root/.dark blocks in tokens.css exactly. The\n// five hand-picked alternatives of #307 (`ALTERNATIVE_PRESETS`, a reference bank that\n// `presetById` never resolved) were removed in 0.35 (refactor audit 2026-10, API-6c;\n// deprecated in 0.34): `PALETTES` is what an app offers, and `derivePalette` makes a\n// palette of its own.\n\nimport type { HeatStops } from \"./chart-palette\";\nimport { contrastStep, rememberTokenSet } from \"./contrast-tokens\";\n\nexport interface TokenSet {\n  // Backgrounds & chrome\n  bgPage: string;\n  bgSurface: string;\n  bgSurface2: string;\n  border: string;\n  textPrimary: string;\n  // The two quieter text roles. Derived per preset by blending `textPrimary` toward\n  // that preset's own surfaces until the contrast against the WORST of bgPage /\n  // bgSurface / bgSurface2 hits 7:1 and 4.8:1 — so both clear WCAG AA for normal text\n  // (4.5:1) on every surface they can land on, and both inherit the preset's warmth\n  // instead of importing a cool grey from Tailwind's palette.\n  textSecondary: string;\n  textMuted: string;\n  // Interactive brand accent\n  brand: string;\n  brandHover: string;\n  brandContrast: string;\n  // Semantic money (never red/green — CVD-safe, paired with +/- cues elsewhere)\n  moneyIncome: string;\n  moneyExpense: string;\n  moneyNet: string;\n  moneyNeutral: string;\n  // Categorical chart series, written as `--chart-1…9`. anyplot's eight \"Imprint\" hues by\n  // default (0.49), Paul Tol \"Muted\"'s nine in `PAUL_TOL_PRESET`. `paletteFor` cycles\n  // eight; a shorter ramp is repeated to fill `--chart-9` (see `applyTokenSet`).\n  chart: string[];\n  // Heatmap interpolation stops (variance diverging + spending sequential)\n  heat: HeatStops;\n}\n\nexport interface PalettePreset {\n  id: string;\n  name: string;\n  blurb: string;\n  light: TokenSet;\n  dark: TokenSet;\n}\n\n// ── \"Imprint\" chart hues (feedback #119; the default since 0.49) ─────────────\n// anyplot's categorical palette (https://anyplot.ai/palette), by a colleague of\n// Marcel's. 8 hues + an amber semantic anchor, derived from Wong 2011 by a\n// Petroff-style max-min ΔE search in CAM02-UCS with Machado 2009 CVD simulation —\n// the same lineage as Paul Tol \"Muted\", one generation on, and tuned for exactly the\n// warm cream paper our light theme uses.\n//\n// 0.49 (Marcel, 2026-10-22): the DEFAULT, in anyplot's slot order, eight slots — amber\n// #DDCC77 left the pool, it is anyplot's semantic warning anchor, not a series colour.\n// The SAME hues in both themes: 0.48 lifted matte red and rose for the dark ground\n// (#BF413E, #A25083), which made the dark chart a different palette from the light one.\n// anyplot answers a hue under 3:1 with a 1px ink edge instead, and so does the kit now\n// (`chartEdge`, drawn by SeriesChart's bars and areas and by Treemap's tiles).\n//\n// Measured on our surfaces (CIEDE2000, Machado severity-100, 8 like-for-like slots on\n// the cream light surface #f6ecd9) — neither palette dominates:\n//   Paul Tol Muted  min-contrast 1.38 · worst-CVD ΔE00 11.8 · normal ΔE00 16.1\n//   imprint         min-contrast 1.95 · worst-CVD ΔE00  7.2 · normal ΔE00 22.2\n// i.e. imprint is punchier and has no near-invisible pale slot (Tol's #88ccee sits at\n// 1.5:1 on cream), while Tol separates better under colour-vision deficiency — which is\n// why `paletteFor` offers anyplot's CVD-optimal order (`{ order: \"cvd\" }`).\nconst IMPRINT_HUES = [\n  \"#009e73\", // brand green   — first series, always\n  \"#c475fd\", // lavender      — creative\n  \"#4467a3\", // blue          — cool / info\n  \"#bd8233\", // ochre         — earth / commodity\n  \"#ae3030\", // matte red     — bad / loss / error\n  \"#2abccd\", // cyan          — sky / tech-cool\n  \"#954477\", // rose          — wellness / health\n  \"#99b314\", // lime          — growth / nature\n];\n\n/** anyplot's scales (0.49): sequential green → blue, diverging blue (under) ↔ paper or\n *  ink (0) ↔ matte red (over). `chart-palette.ts`'s `HEATMAP_HEX` holds the same. */\nconst ANYPLOT_HEAT: Record<\"light\" | \"dark\", HeatStops> = {\n  light: {\n    neutral: \"#faf8f1\",\n    under: \"#4467a3\",\n    over: \"#ae3030\",\n    seqLow: \"#009e73\",\n    seqHigh: \"#4467a3\",\n    empty: \"rgba(148,163,184,0.14)\",\n  },\n  dark: {\n    neutral: \"#1a1a17\",\n    under: \"#4467a3\",\n    over: \"#ae3030\",\n    seqLow: \"#009e73\",\n    seqHigh: \"#4467a3\",\n    empty: \"rgba(148,163,184,0.10)\",\n  },\n};\n\n// The shipped default (feedback #328): SOLAR-DUSK warm light + INDIGO-NOIR deep\n// dark surfaces — the two curated presets the user picked per mode — but with a\n// SINGLE unified brand accent (indigo) across both modes rather than each\n// preset's own accent (the user asked for the brand accent to stay the same).\n// So the light block is Solar Dusk with its teal brand overridden to indigo, and\n// the dark block is Indigo Noir (already indigo). The money trio\n// (income/expense/net) drives the chart bars and stays palette-driven so those\n// semantic colours adapt to each mode's contrast (best practice — feedback #328).\n//\n// 0.49: its chart ramp and heat stops are anyplot's (\"Imprint\", above) — the money\n// trio stays the kit's own (Marcel, 2026-10-22: chart income/expense/net/neutral keep\n// the money tokens, never anyplot's green/red). The 0.48 default, the same surfaces\n// with Paul Tol's ramp, is `PAUL_TOL_PRESET`.\nexport const DEFAULT_PRESET: PalettePreset = {\n  id: \"default\",\n  name: \"Imprint\",\n  blurb: \"anyplot.ai chart hues · solar-dusk light · indigo-noir dark\",\n  light: {\n    // Solar Dusk (light) surfaces, with the brand unified to indigo (see above).\n    bgPage: \"#ede3cf\",\n    bgSurface: \"#f6ecd9\",\n    // The well is the page in light (0.33, k26): #f3ead6 stood 1.02:1 from the card it\n    // is inset in. Every light preset does the same; see SURFACE_L in palette-derive.ts.\n    bgSurface2: \"#ede3cf\",\n    border: \"#e2d6bd\",\n    textPrimary: \"#463f33\",\n    textSecondary: \"#50493c\",\n    textMuted: \"#696153\",\n    brand: \"#4f46e5\",\n    brandHover: \"#4338ca\",\n    brandContrast: \"#ffffff\",\n    moneyIncome: \"#0b6650\",\n    moneyExpense: \"#905902\",\n    moneyNet: \"#7a4fa3\",\n    moneyNeutral: \"#6b6453\",\n    chart: IMPRINT_HUES,\n    heat: ANYPLOT_HEAT.light,\n  },\n  dark: {\n    // Indigo Noir (dark)\n    bgPage: \"#0e0f1c\",\n    bgSurface: \"#181a2c\",\n    bgSurface2: \"#21243a\",\n    border: \"#2e3252\",\n    textPrimary: \"#e6e8f4\",\n    textSecondary: \"#adafbe\",\n    textMuted: \"#8d90a0\",\n    brand: \"#8b93f8\",\n    brandHover: \"#aab1fb\",\n    brandContrast: \"#16182b\",\n    moneyIncome: \"#22c3b6\",\n    // Amber-400 (#fbbf24) sat at OKLab L 0.84 while every other dark token lives\n    // at 0.68–0.74, so outflows outshouted the inflows they are paired with. Same\n    // hue and chroma, pulled to L 0.785 (dev#434). The heat stops below keep the\n    // brighter amber on purpose: a gradient endpoint is meant to be the loudest\n    // thing in its scale, and it is a fill, not a figure.\n    moneyExpense: \"#e4b035\",\n    moneyNet: \"#b39aef\",\n    moneyNeutral: \"#9aa1bd\",\n    chart: IMPRINT_HUES,\n    heat: ANYPLOT_HEAT.dark,\n  },\n};\n\n\n/**\n * The 0.48 default: the same surfaces, brand and money, with Paul Tol's \"Muted\" nine\n * as the chart ramp and the teal/amber heat stops that went with it. Selectable, no\n * longer the default (0.49). `paletteFor` cycles eight, so its ninth hue (#aa4499) is\n * reachable only as `var(--chart-9)`.\n */\nexport const PAUL_TOL_PRESET: PalettePreset = {\n  id: \"paul-tol\",\n  name: \"Paul Tol muted\",\n  blurb: \"Paul Tol's CVD-safe chart hues · solar-dusk light · indigo-noir dark\",\n  light: {\n    ...DEFAULT_PRESET.light,\n    chart: [\"#332288\", \"#88ccee\", \"#44aa99\", \"#117733\", \"#999933\", \"#ddcc77\", \"#cc6677\", \"#882255\", \"#aa4499\"],\n    heat: {\n      neutral: \"#f1e7d2\",\n      under: \"#0b6650\",\n      over: \"#9c6418\",\n      seqLow: \"#f6ecd0\",\n      seqHigh: \"#9c6418\",\n      empty: \"rgba(148,163,184,0.14)\",\n    },\n  },\n  dark: {\n    ...DEFAULT_PRESET.dark,\n    chart: [\"#7e72d6\", \"#9fd8f2\", \"#5fc4b0\", \"#3fa45f\", \"#bfbf5e\", \"#e8dda0\", \"#e08c9a\", \"#c25a78\", \"#cc78be\"],\n    heat: {\n      neutral: \"#363a5a\",\n      under: \"#22c3b6\",\n      over: \"#fbbf24\",\n      seqLow: \"#3a2c14\",\n      seqHigh: \"#fbbf24\",\n      empty: \"rgba(148,163,184,0.10)\",\n    },\n  },\n};\n\n/** @deprecated 0.49 — use `DEFAULT_PRESET` (Imprint IS the default now); removed in 0.51.\n *  A persisted `\"imprint\"` id resolves to it through `presetById`'s fallback. */\nexport const IMPRINT_PRESET: PalettePreset = DEFAULT_PRESET;\n\n// The full-theme switcher from #307 stayed retired (feedback #328) — the default\n// is still the single source of truth for surfaces, brand and money (its five\n// alternatives are gone, see the header). What IS selectable is\n// the categorical chart ramp (feedback #119), so Imprint (the default) and Paul Tol are\n// the live set; presetById falls back to the default for any stale persisted id.\n/**\n * The categorical chart ramp, shared by every derived preset below.\n *\n * The default's ramp (anyplot's eight since 0.49, Paul Tol's \"Muted\" before), and\n * deliberately NOT re-derived per preset. A\n * categorical ramp solves a different problem from a UI palette — separability among\n * nine unknown siblings, rather than contrast against one known surface — and a set\n * optimised against real dichromat confusion lines beats one spaced evenly by formula.\n * `auditChartRamp` in palette-derive.ts measures it: 0.059 minimum separation in the\n * light variant, which is the number MIN_SEPARATION was calibrated under.\n *\n * It pays for that in contrast: four of the nine light hues sit below the 3:1 WCAG\n * 1.4.11 asks of a filled shape. That is not fixable by darkening them — see\n * SINGLE_LIGHTNESS_MAX_SERIES — so a chart with more than four series must carry a\n * second channel (a direct label, a pattern, a legend adjacent to the mark).\n */\nconst KIT_RAMP = {\n  light: DEFAULT_PRESET.light.chart,\n  dark: DEFAULT_PRESET.dark.chart,\n} as const;\n\n/**\n * Presets DERIVED rather than picked, by `derivePalette` from one brand colour each.\n *\n * Every text role here was solved to a contrast target against the worst of the three\n * surfaces it can land on, every semantic colour against both the page and its own badge\n * tint, and the whole set is re-checked by `__tests__/palette-audit.test.ts` (\"derived\n * presets\") — which re-runs the deriver and fails if these committed values drift from\n * what it now produces.\n *\n * They are committed rather than derived at import because deriving eight token sets\n * costs ~34ms, and charging every consumer that at startup for palettes most of them\n * will never select is the wrong trade. The test is what keeps the two in agreement.\n *\n * Regenerated in 0.34 (round 0.34 BUG-8): the solve now measures the hex it ships rather\n * than the float before rounding, and the audit no longer lets a hex pair pass 0.05 under\n * its threshold. 52 values moved one step (66 counting the heat stops that repeat them);\n * Contrast's neutrals lost half their slate tint, its brand having half the chroma at\n * which the neutrals carry a hue in full.\n */\nexport const DERIVED_PRESETS: PalettePreset[] = [\n  {\n    id: \"ink\",\n    name: \"Ink\",\n    blurb: \"Cool blue-grey ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#dce2ef\",\n      bgSurface: \"#e6edfa\",\n      bgSurface2: \"#dce2ef\",\n      border: \"#b0bace\",\n      textPrimary: \"#2e3139\",\n      textSecondary: \"#454850\",\n      textMuted: \"#5f636c\",\n      brand: \"#2f5fd0\",\n      brandHover: \"#1f4cbc\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#61646c\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#dce2ef\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#090d15\",\n      bgSurface: \"#131720\",\n      bgSurface2: \"#1d212b\",\n      border: \"#363e4f\",\n      textPrimary: \"#c8ccd6\",\n      textSecondary: \"#a7abb5\",\n      textMuted: \"#858a92\",\n      brand: \"#3466d7\",\n      brandHover: \"#2353c3\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a1a5ac\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#1d212b\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"moss\",\n    name: \"Moss\",\n    blurb: \"Green ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#d8e6dd\",\n      bgSurface: \"#e3f1e8\",\n      bgSurface2: \"#d8e6dd\",\n      border: \"#abbfb2\",\n      textPrimary: \"#2c332e\",\n      textSecondary: \"#424b45\",\n      textMuted: \"#5d6660\",\n      brand: \"#2f7a52\",\n      brandHover: \"#196842\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#5f6662\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#d8e6dd\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#060f0a\",\n      bgSurface: \"#101a14\",\n      bgSurface2: \"#1a241e\",\n      border: \"#314337\",\n      textPrimary: \"#c6cfc9\",\n      textSecondary: \"#a5aea8\",\n      textMuted: \"#838c86\",\n      brand: \"#317b53\",\n      brandHover: \"#1c6943\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b87c2a\",\n      moneyNet: \"#977ac9\",\n      moneyNeutral: \"#9fa7a2\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#1a241e\",\n        under: \"#009a80\",\n        over: \"#b87c2a\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b87c2a\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"plum\",\n    name: \"Plum\",\n    blurb: \"Violet ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#e7dfea\",\n      bgSurface: \"#f2e9f5\",\n      bgSurface2: \"#e7dfea\",\n      border: \"#c2b5c6\",\n      textPrimary: \"#352f36\",\n      textSecondary: \"#4c464e\",\n      textMuted: \"#676169\",\n      brand: \"#7b3f8f\",\n      brandHover: \"#692d7d\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7355a2\",\n      moneyNeutral: \"#676269\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#e7dfea\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#100b12\",\n      bgSurface: \"#1b151d\",\n      bgSurface2: \"#251f27\",\n      border: \"#453b48\",\n      textPrimary: \"#d0cad2\",\n      textSecondary: \"#afa9b1\",\n      textMuted: \"#8d8790\",\n      brand: \"#9154a6\",\n      brandHover: \"#7f4293\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009980\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a8a2aa\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#251f27\",\n        under: \"#009980\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"contrast\",\n    name: \"High contrast\",\n    blurb: \"Near-neutral ground · text solved to 13:1 / 8.5:1 / 5.5:1\",\n    light: {\n      bgPage: \"#e1e2e3\",\n      bgSurface: \"#ecedee\",\n      bgSurface2: \"#e1e2e3\",\n      border: \"#b8babc\",\n      textPrimary: \"#1b1d21\",\n      textSecondary: \"#3a3c40\",\n      textMuted: \"#55585c\",\n      brand: \"#1f2937\",\n      brandHover: \"#111b28\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7255a1\",\n      moneyNeutral: \"#616467\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#e1e2e3\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#0c0d0e\",\n      bgSurface: \"#171718\",\n      bgSurface2: \"#212122\",\n      border: \"#3d3e3f\",\n      textPrimary: \"#e4e8ec\",\n      textSecondary: \"#b9bdc1\",\n      textMuted: \"#95979c\",\n      brand: \"#556c8e\",\n      brandHover: \"#455b7c\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a2a5a8\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#212122\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n];\n\nexport const PALETTES: PalettePreset[] = [DEFAULT_PRESET, PAUL_TOL_PRESET, ...DERIVED_PRESETS];\n\nexport function presetById(id: string): PalettePreset {\n  return PALETTES.find((p) => p.id === id) ?? DEFAULT_PRESET;\n}\n\n/**\n * Write a token set onto an element's inline style as CSS custom properties.\n *\n * This is the only writer, and there is no un-writer: `presetById` falls back to\n * `DEFAULT_PRESET` and this then writes the full set, so returning to the default\n * APPLIES it rather than clearing anything. A `clearTokenSet` and the hand-kept\n * 24-name `TOKEN_VARS` list it looped over used to live here, both exported, both\n * called by nobody in either consumer — a second copy of these property names with\n * nothing comparing the two, so adding a token here and forgetting it there would\n * have been silent and only a dead function would have noticed. The list is gone;\n * the test beside this asserts instead that every field of a `TokenSet` reaches the\n * element, which is what that list was standing in for.\n *\n * **More contrast (0.32, docs/text-size-harmonization.md §5, §10.5).** With `contrast`\n * the text and border tokens are written one step stronger — in a light set the well and\n * the four money colours too (0.36, docs/colour-roles-harmonization.md §13) — and `--text-placeholder` —\n * otherwise derived in tokens.css — is written inline too; without it that inline\n * placeholder is removed again, so the stylesheet's formula applies. The step is made\n * HERE because these tokens are inline: no `[data-contrast=more]` rule could beat them.\n *\n * `contrast` defaults to the element's own `data-contrast=\"more\"`, which the contrast\n * layer (`applyContrast`, `useApplyContrast`) sets first. That is how the palette and the\n * contrast cooperate without knowing each other: a palette change re-applies through\n * here and keeps the contrast, and a contrast change re-applies the set remembered here.\n */\nexport function applyTokenSet(\n  el: HTMLElement,\n  t: TokenSet,\n  contrast: boolean = el.getAttribute(\"data-contrast\") === \"more\",\n): void {\n  rememberTokenSet(el, t);\n  const step = contrast ? contrastStep(t) : null;\n  el.style.setProperty(\"--bg-page\", t.bgPage);\n  el.style.setProperty(\"--bg-surface\", t.bgSurface);\n  // The light well and money step under More contrast (0.36, colour-roles §13); in dark\n  // and at Standard `well` is null and the set's own are written.\n  el.style.setProperty(\"--bg-surface-2\", step?.well?.bgSurface2 ?? t.bgSurface2);\n  el.style.setProperty(\"--border\", step?.border ?? t.border);\n  el.style.setProperty(\"--text-primary\", t.textPrimary);\n  el.style.setProperty(\"--text-secondary\", step?.textSecondary ?? t.textSecondary);\n  el.style.setProperty(\"--text-muted\", step?.textMuted ?? t.textMuted);\n  if (step) el.style.setProperty(\"--text-placeholder\", step.textPlaceholder);\n  else el.style.removeProperty(\"--text-placeholder\");\n  el.style.setProperty(\"--brand\", t.brand);\n  el.style.setProperty(\"--brand-hover\", t.brandHover);\n  el.style.setProperty(\"--brand-contrast\", t.brandContrast);\n  el.style.setProperty(\"--money-income\", step?.well?.moneyIncome ?? t.moneyIncome);\n  el.style.setProperty(\"--money-expense\", step?.well?.moneyExpense ?? t.moneyExpense);\n  el.style.setProperty(\"--money-net\", step?.well?.moneyNet ?? t.moneyNet);\n  el.style.setProperty(\"--money-neutral\", step?.well?.moneyNeutral ?? t.moneyNeutral);\n  // All nine `--chart-N`, a shorter ramp repeated: Imprint's eight write `--chart-9` as\n  // slot 0 — what `paletteFor(8)` names — so a host addressing `var(--chart-9)` directly\n  // follows the cycle, and switching away from Paul Tol's nine leaves no stale ninth hue.\n  // An empty ramp (a `derivePalette` set) leaves whatever was there, deliberately.\n  if (t.chart.length > 0) {\n    for (let i = 0; i < 9; i++) el.style.setProperty(`--chart-${i + 1}`, t.chart[i % t.chart.length]);\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/theme/palette-presets.ts"],"sourcesContent":["// Appearance presets — the single source of truth for the \"palette switcher\"\n// (feedback #307). Each preset is a full set of design-token values for BOTH\n// light and dark, covering the page/surface backgrounds, the brand accent, the\n// semantic money trio and the categorical chart palette (anyplot's eight \"Imprint\"\n// hues by default since 0.49, Paul Tol's nine in `PAUL_TOL_PRESET`), plus the\n// heatmap stops. A preset is applied at runtime by writing these as CSS custom\n// properties onto <html> (see palette-store.ts), which instantly re-skins every\n// token-driven surface and chart. The two heatmaps and the treemap interpolate\n// concrete hex in JS, so they read the same values from here via the hooks in\n// palette-store.\n//\n// The default preset here mirrors the :root/.dark blocks in tokens.css exactly. The\n// five hand-picked alternatives of #307 (`ALTERNATIVE_PRESETS`, a reference bank that\n// `presetById` never resolved) were removed in 0.35 (refactor audit 2026-10, API-6c;\n// deprecated in 0.34): `PALETTES` is what an app offers, and `derivePalette` makes a\n// palette of its own.\n\nimport type { HeatStops } from \"./chart-palette\";\nimport { contrastStep, rememberTokenSet } from \"./contrast-tokens\";\n\nexport interface TokenSet {\n  // Backgrounds & chrome\n  bgPage: string;\n  bgSurface: string;\n  bgSurface2: string;\n  border: string;\n  textPrimary: string;\n  // The two quieter text roles. Derived per preset by blending `textPrimary` toward\n  // that preset's own surfaces until the contrast against the WORST of bgPage /\n  // bgSurface / bgSurface2 hits 7:1 and 4.8:1 — so both clear WCAG AA for normal text\n  // (4.5:1) on every surface they can land on, and both inherit the preset's warmth\n  // instead of importing a cool grey from Tailwind's palette.\n  textSecondary: string;\n  textMuted: string;\n  // Interactive brand accent\n  brand: string;\n  brandHover: string;\n  brandContrast: string;\n  // Semantic money (never red/green — CVD-safe, paired with +/- cues elsewhere)\n  moneyIncome: string;\n  moneyExpense: string;\n  moneyNet: string;\n  moneyNeutral: string;\n  // Categorical chart series, written as `--chart-1…9`. anyplot's eight \"Imprint\" hues by\n  // default (0.49), Paul Tol \"Muted\"'s nine in `PAUL_TOL_PRESET`. `paletteFor` cycles\n  // eight; a shorter ramp is repeated to fill `--chart-9` (see `applyTokenSet`).\n  chart: string[];\n  // Heatmap interpolation stops (variance diverging + spending sequential)\n  heat: HeatStops;\n}\n\nexport interface PalettePreset {\n  id: string;\n  name: string;\n  blurb: string;\n  light: TokenSet;\n  dark: TokenSet;\n}\n\n// ── \"Imprint\" chart hues (feedback #119; the default since 0.49) ─────────────\n// anyplot's categorical palette (https://anyplot.ai/palette), by a colleague of\n// Marcel's. 8 hues + an amber semantic anchor, derived from Wong 2011 by a\n// Petroff-style max-min ΔE search in CAM02-UCS with Machado 2009 CVD simulation —\n// the same lineage as Paul Tol \"Muted\", one generation on, and tuned for exactly the\n// warm cream paper our light theme uses.\n//\n// 0.49 (Marcel, 2026-10-22): the DEFAULT, in anyplot's slot order, eight slots — amber\n// #DDCC77 left the pool, it is anyplot's semantic warning anchor, not a series colour.\n// The SAME hues in both themes: 0.48 lifted matte red and rose for the dark ground\n// (#BF413E, #A25083), which made the dark chart a different palette from the light one.\n// anyplot answers a hue under 3:1 with a 1px ink edge instead, and so does the kit now\n// (`chartEdge`, drawn by SeriesChart's bars and areas and by Treemap's tiles).\n//\n// Measured on our surfaces (CIEDE2000, Machado severity-100, 8 like-for-like slots on\n// the cream light surface #f6ecd9) — neither palette dominates:\n//   Paul Tol Muted  min-contrast 1.38 · worst-CVD ΔE00 11.8 · normal ΔE00 16.1\n//   imprint         min-contrast 1.95 · worst-CVD ΔE00  7.2 · normal ΔE00 22.2\n// i.e. imprint is punchier and has no near-invisible pale slot (Tol's #88ccee sits at\n// 1.5:1 on cream), while Tol separates better under colour-vision deficiency — which is\n// why `paletteFor` offers anyplot's CVD-optimal order (`{ order: \"cvd\" }`).\nconst IMPRINT_HUES = [\n  \"#009e73\", // brand green   — first series, always\n  \"#c475fd\", // lavender      — creative\n  \"#4467a3\", // blue          — cool / info\n  \"#bd8233\", // ochre         — earth / commodity\n  \"#ae3030\", // matte red     — bad / loss / error\n  \"#2abccd\", // cyan          — sky / tech-cool\n  \"#954477\", // rose          — wellness / health\n  \"#99b314\", // lime          — growth / nature\n];\n\n/** anyplot's scales (0.49): sequential green → blue, diverging blue (under) ↔ paper or\n *  ink (0) ↔ matte red (over). `chart-palette.ts`'s `HEATMAP_HEX` holds the same. */\nconst ANYPLOT_HEAT: Record<\"light\" | \"dark\", HeatStops> = {\n  light: {\n    neutral: \"#faf8f1\",\n    under: \"#4467a3\",\n    over: \"#ae3030\",\n    seqLow: \"#009e73\",\n    seqHigh: \"#4467a3\",\n    empty: \"rgba(148,163,184,0.14)\",\n  },\n  dark: {\n    neutral: \"#1a1a17\",\n    under: \"#4467a3\",\n    over: \"#ae3030\",\n    seqLow: \"#009e73\",\n    seqHigh: \"#4467a3\",\n    empty: \"rgba(148,163,184,0.10)\",\n  },\n};\n\n// The shipped default (feedback #328): SOLAR-DUSK warm light + INDIGO-NOIR deep\n// dark surfaces — the two curated presets the user picked per mode — but with a\n// SINGLE unified brand accent (indigo) across both modes rather than each\n// preset's own accent (the user asked for the brand accent to stay the same).\n// So the light block is Solar Dusk with its teal brand overridden to indigo, and\n// the dark block is Indigo Noir (already indigo). The money trio\n// (income/expense/net) drives the chart bars and stays palette-driven so those\n// semantic colours adapt to each mode's contrast (best practice — feedback #328).\n//\n// 0.49: its chart ramp and heat stops are anyplot's (\"Imprint\", above) — the money\n// trio stays the kit's own (Marcel, 2026-10-22: chart income/expense/net/neutral keep\n// the money tokens, never anyplot's green/red). The 0.48 default, the same surfaces\n// with Paul Tol's ramp, is `PAUL_TOL_PRESET`.\nexport const DEFAULT_PRESET: PalettePreset = {\n  id: \"default\",\n  name: \"Imprint\",\n  blurb: \"anyplot.ai chart hues · solar-dusk light · indigo-noir dark\",\n  light: {\n    // Solar Dusk (light) surfaces, with the brand unified to indigo (see above).\n    bgPage: \"#ede3cf\",\n    bgSurface: \"#f6ecd9\",\n    // The well is the page in light (0.33, k26): #f3ead6 stood 1.02:1 from the card it\n    // is inset in. Every light preset does the same; see SURFACE_L in palette-derive.ts.\n    bgSurface2: \"#ede3cf\",\n    border: \"#e2d6bd\",\n    textPrimary: \"#463f33\",\n    textSecondary: \"#50493c\",\n    textMuted: \"#696153\",\n    brand: \"#4f46e5\",\n    brandHover: \"#4338ca\",\n    brandContrast: \"#ffffff\",\n    moneyIncome: \"#0b6650\",\n    moneyExpense: \"#905902\",\n    moneyNet: \"#7a4fa3\",\n    moneyNeutral: \"#6b6453\",\n    chart: IMPRINT_HUES,\n    heat: ANYPLOT_HEAT.light,\n  },\n  dark: {\n    // Indigo Noir (dark)\n    bgPage: \"#0e0f1c\",\n    bgSurface: \"#181a2c\",\n    bgSurface2: \"#21243a\",\n    border: \"#2e3252\",\n    textPrimary: \"#e6e8f4\",\n    textSecondary: \"#adafbe\",\n    textMuted: \"#8d90a0\",\n    brand: \"#8b93f8\",\n    brandHover: \"#aab1fb\",\n    brandContrast: \"#16182b\",\n    moneyIncome: \"#22c3b6\",\n    // Amber-400 (#fbbf24) sat at OKLab L 0.84 while every other dark token lives\n    // at 0.68–0.74, so outflows outshouted the inflows they are paired with. Same\n    // hue and chroma, pulled to L 0.785 (dev#434). The heat stops below keep the\n    // brighter amber on purpose: a gradient endpoint is meant to be the loudest\n    // thing in its scale, and it is a fill, not a figure.\n    moneyExpense: \"#e4b035\",\n    moneyNet: \"#b39aef\",\n    moneyNeutral: \"#9aa1bd\",\n    chart: IMPRINT_HUES,\n    heat: ANYPLOT_HEAT.dark,\n  },\n};\n\n\n/**\n * The 0.48 default: the same surfaces, brand and money, with Paul Tol's \"Muted\" nine\n * as the chart ramp and the teal/amber heat stops that went with it. Selectable, no\n * longer the default (0.49). `paletteFor` cycles eight, so its ninth hue (#aa4499) is\n * reachable only as `var(--chart-9)`.\n */\nexport const PAUL_TOL_PRESET: PalettePreset = {\n  id: \"paul-tol\",\n  name: \"Paul Tol muted\",\n  blurb: \"Paul Tol's CVD-safe chart hues · solar-dusk light · indigo-noir dark\",\n  light: {\n    ...DEFAULT_PRESET.light,\n    chart: [\"#332288\", \"#88ccee\", \"#44aa99\", \"#117733\", \"#999933\", \"#ddcc77\", \"#cc6677\", \"#882255\", \"#aa4499\"],\n    heat: {\n      neutral: \"#f1e7d2\",\n      under: \"#0b6650\",\n      over: \"#9c6418\",\n      seqLow: \"#f6ecd0\",\n      seqHigh: \"#9c6418\",\n      empty: \"rgba(148,163,184,0.14)\",\n    },\n  },\n  dark: {\n    ...DEFAULT_PRESET.dark,\n    chart: [\"#7e72d6\", \"#9fd8f2\", \"#5fc4b0\", \"#3fa45f\", \"#bfbf5e\", \"#e8dda0\", \"#e08c9a\", \"#c25a78\", \"#cc78be\"],\n    heat: {\n      neutral: \"#363a5a\",\n      under: \"#22c3b6\",\n      over: \"#fbbf24\",\n      seqLow: \"#3a2c14\",\n      seqHigh: \"#fbbf24\",\n      empty: \"rgba(148,163,184,0.10)\",\n    },\n  },\n};\n\n// The full-theme switcher from #307 stayed retired (feedback #328) — the default\n// is still the single source of truth for surfaces, brand and money (its five\n// alternatives are gone, see the header). What IS selectable is\n// the categorical chart ramp (feedback #119), so Imprint (the default) and Paul Tol are\n// the live set; presetById falls back to the default for any stale persisted id.\n/**\n * The categorical chart ramp, shared by every derived preset below.\n *\n * The default's ramp (anyplot's eight since 0.49, Paul Tol's \"Muted\" before), and\n * deliberately NOT re-derived per preset. A\n * categorical ramp solves a different problem from a UI palette — separability among\n * nine unknown siblings, rather than contrast against one known surface — and a set\n * optimised against real dichromat confusion lines beats one spaced evenly by formula.\n * `auditChartRamp` in palette-derive.ts measures it: 0.059 minimum separation in the\n * light variant, which is the number MIN_SEPARATION was calibrated under.\n *\n * It pays for that in contrast: four of the nine light hues sit below the 3:1 WCAG\n * 1.4.11 asks of a filled shape. That is not fixable by darkening them — see\n * SINGLE_LIGHTNESS_MAX_SERIES — so a chart with more than four series must carry a\n * second channel (a direct label, a pattern, a legend adjacent to the mark).\n */\nconst KIT_RAMP = {\n  light: DEFAULT_PRESET.light.chart,\n  dark: DEFAULT_PRESET.dark.chart,\n} as const;\n\n/**\n * Presets DERIVED rather than picked, by `derivePalette` from one brand colour each.\n *\n * Every text role here was solved to a contrast target against the worst of the three\n * surfaces it can land on, every semantic colour against both the page and its own badge\n * tint, and the whole set is re-checked by `__tests__/palette-audit.test.ts` (\"derived\n * presets\") — which re-runs the deriver and fails if these committed values drift from\n * what it now produces.\n *\n * They are committed rather than derived at import because deriving eight token sets\n * costs ~34ms, and charging every consumer that at startup for palettes most of them\n * will never select is the wrong trade. The test is what keeps the two in agreement.\n *\n * Regenerated in 0.34 (round 0.34 BUG-8): the solve now measures the hex it ships rather\n * than the float before rounding, and the audit no longer lets a hex pair pass 0.05 under\n * its threshold. 52 values moved one step (66 counting the heat stops that repeat them);\n * Contrast's neutrals lost half their slate tint, its brand having half the chroma at\n * which the neutrals carry a hue in full.\n */\nexport const DERIVED_PRESETS: PalettePreset[] = [\n  {\n    id: \"ink\",\n    name: \"Ink\",\n    blurb: \"Cool blue-grey ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#dce2ef\",\n      bgSurface: \"#e6edfa\",\n      bgSurface2: \"#dce2ef\",\n      border: \"#b0bace\",\n      textPrimary: \"#2e3139\",\n      textSecondary: \"#454850\",\n      textMuted: \"#5f636c\",\n      brand: \"#2f5fd0\",\n      brandHover: \"#1f4cbc\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#61646c\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#dce2ef\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#090d15\",\n      bgSurface: \"#131720\",\n      bgSurface2: \"#1d212b\",\n      border: \"#363e4f\",\n      textPrimary: \"#c8ccd6\",\n      textSecondary: \"#a7abb5\",\n      textMuted: \"#858a92\",\n      brand: \"#3466d7\",\n      brandHover: \"#2353c3\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a1a5ac\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#1d212b\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"moss\",\n    name: \"Moss\",\n    blurb: \"Green ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#d8e6dd\",\n      bgSurface: \"#e3f1e8\",\n      bgSurface2: \"#d8e6dd\",\n      border: \"#abbfb2\",\n      textPrimary: \"#2c332e\",\n      textSecondary: \"#424b45\",\n      textMuted: \"#5d6660\",\n      brand: \"#2f7a52\",\n      brandHover: \"#196842\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00725f\",\n      moneyExpense: \"#8e5900\",\n      moneyNet: \"#7356a2\",\n      moneyNeutral: \"#5f6662\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#d8e6dd\",\n        under: \"#00725f\",\n        over: \"#8e5900\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8e5900\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#060f0a\",\n      bgSurface: \"#101a14\",\n      bgSurface2: \"#1a241e\",\n      border: \"#314337\",\n      textPrimary: \"#c6cfc9\",\n      textSecondary: \"#a5aea8\",\n      textMuted: \"#838c86\",\n      brand: \"#317b53\",\n      brandHover: \"#1c6943\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b87c2a\",\n      moneyNet: \"#977ac9\",\n      moneyNeutral: \"#9fa7a2\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#1a241e\",\n        under: \"#009a80\",\n        over: \"#b87c2a\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b87c2a\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"plum\",\n    name: \"Plum\",\n    blurb: \"Violet ground · solved for AAA body text\",\n    light: {\n      bgPage: \"#e7dfea\",\n      bgSurface: \"#f2e9f5\",\n      bgSurface2: \"#e7dfea\",\n      border: \"#c2b5c6\",\n      textPrimary: \"#352f36\",\n      textSecondary: \"#4c464e\",\n      textMuted: \"#676169\",\n      brand: \"#7b3f8f\",\n      brandHover: \"#692d7d\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7355a2\",\n      moneyNeutral: \"#676269\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#e7dfea\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#100b12\",\n      bgSurface: \"#1b151d\",\n      bgSurface2: \"#251f27\",\n      border: \"#453b48\",\n      textPrimary: \"#d0cad2\",\n      textSecondary: \"#afa9b1\",\n      textMuted: \"#8d8790\",\n      brand: \"#9154a6\",\n      brandHover: \"#7f4293\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009980\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a8a2aa\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#251f27\",\n        under: \"#009980\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n  {\n    id: \"contrast\",\n    name: \"High contrast\",\n    blurb: \"Near-neutral ground · text solved to 13:1 / 8.5:1 / 5.5:1\",\n    light: {\n      bgPage: \"#e1e2e3\",\n      bgSurface: \"#ecedee\",\n      bgSurface2: \"#e1e2e3\",\n      border: \"#b8babc\",\n      textPrimary: \"#1b1d21\",\n      textSecondary: \"#3a3c40\",\n      textMuted: \"#55585c\",\n      brand: \"#1f2937\",\n      brandHover: \"#111b28\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#00715e\",\n      moneyExpense: \"#8d5800\",\n      moneyNet: \"#7255a1\",\n      moneyNeutral: \"#616467\",\n      chart: KIT_RAMP.light,\n      heat: {\n        neutral: \"#e1e2e3\",\n        under: \"#00715e\",\n        over: \"#8d5800\",\n        seqLow: \"#fee3c5\",\n        seqHigh: \"#8d5800\",\n        empty: \"rgba(120,110,95,0.14)\",\n      },\n    },\n    dark: {\n      bgPage: \"#0c0d0e\",\n      bgSurface: \"#171718\",\n      bgSurface2: \"#212122\",\n      border: \"#3d3e3f\",\n      textPrimary: \"#e4e8ec\",\n      textSecondary: \"#b9bdc1\",\n      textMuted: \"#95979c\",\n      brand: \"#556c8e\",\n      brandHover: \"#455b7c\",\n      brandContrast: \"#ffffff\",\n      moneyIncome: \"#009a80\",\n      moneyExpense: \"#b77b29\",\n      moneyNet: \"#9679c9\",\n      moneyNeutral: \"#a2a5a8\",\n      chart: KIT_RAMP.dark,\n      heat: {\n        neutral: \"#212122\",\n        under: \"#009a80\",\n        over: \"#b77b29\",\n        seqLow: \"#331f05\",\n        seqHigh: \"#b77b29\",\n        empty: \"rgba(160,170,190,0.10)\",\n      },\n    },\n  },\n];\n\nexport const PALETTES: PalettePreset[] = [DEFAULT_PRESET, PAUL_TOL_PRESET, ...DERIVED_PRESETS];\n\nexport function presetById(id: string): PalettePreset {\n  return PALETTES.find((p) => p.id === id) ?? DEFAULT_PRESET;\n}\n\n/**\n * Write a token set onto an element's inline style as CSS custom properties.\n *\n * This is the only writer, and there is no un-writer: `presetById` falls back to\n * `DEFAULT_PRESET` and this then writes the full set, so returning to the default\n * APPLIES it rather than clearing anything. A `clearTokenSet` and the hand-kept\n * 24-name `TOKEN_VARS` list it looped over used to live here, both exported, both\n * called by nobody in either consumer — a second copy of these property names with\n * nothing comparing the two, so adding a token here and forgetting it there would\n * have been silent and only a dead function would have noticed. The list is gone;\n * the test beside this asserts instead that every field of a `TokenSet` reaches the\n * element, which is what that list was standing in for.\n *\n * **More contrast (0.32, docs/text-size-harmonization.md §5, §10.5).** With `contrast`\n * the text and border tokens are written one step stronger — in a light set the well and\n * the four money colours too (0.36, docs/colour-roles-harmonization.md §13) — and `--text-placeholder` —\n * otherwise derived in tokens.css — is written inline too; without it that inline\n * placeholder is removed again, so the stylesheet's formula applies. The step is made\n * HERE because these tokens are inline: no `[data-contrast=more]` rule could beat them.\n *\n * `contrast` defaults to the element's own `data-contrast=\"more\"`, which the contrast\n * layer (`applyContrast`, `useApplyContrast`) sets first. That is how the palette and the\n * contrast cooperate without knowing each other: a palette change re-applies through\n * here and keeps the contrast, and a contrast change re-applies the set remembered here.\n */\nexport function applyTokenSet(\n  el: HTMLElement,\n  t: TokenSet,\n  contrast: boolean = el.getAttribute(\"data-contrast\") === \"more\",\n): void {\n  rememberTokenSet(el, t);\n  const step = contrast ? contrastStep(t) : null;\n  el.style.setProperty(\"--bg-page\", t.bgPage);\n  el.style.setProperty(\"--bg-surface\", t.bgSurface);\n  // The light well and money step under More contrast (0.36, colour-roles §13); in dark\n  // and at Standard `well` is null and the set's own are written.\n  el.style.setProperty(\"--bg-surface-2\", step?.well?.bgSurface2 ?? t.bgSurface2);\n  el.style.setProperty(\"--border\", step?.border ?? t.border);\n  el.style.setProperty(\"--text-primary\", t.textPrimary);\n  el.style.setProperty(\"--text-secondary\", step?.textSecondary ?? t.textSecondary);\n  el.style.setProperty(\"--text-muted\", step?.textMuted ?? t.textMuted);\n  if (step) el.style.setProperty(\"--text-placeholder\", step.textPlaceholder);\n  else el.style.removeProperty(\"--text-placeholder\");\n  el.style.setProperty(\"--brand\", t.brand);\n  el.style.setProperty(\"--brand-hover\", t.brandHover);\n  el.style.setProperty(\"--brand-contrast\", t.brandContrast);\n  el.style.setProperty(\"--money-income\", step?.well?.moneyIncome ?? t.moneyIncome);\n  el.style.setProperty(\"--money-expense\", step?.well?.moneyExpense ?? t.moneyExpense);\n  el.style.setProperty(\"--money-net\", step?.well?.moneyNet ?? t.moneyNet);\n  el.style.setProperty(\"--money-neutral\", step?.well?.moneyNeutral ?? t.moneyNeutral);\n  // All nine `--chart-N`, a shorter ramp repeated: Imprint's eight write `--chart-9` as\n  // slot 0 — what `paletteFor(8)` names — so a host addressing `var(--chart-9)` directly\n  // follows the cycle, and switching away from Paul Tol's nine leaves no stale ninth hue.\n  // An empty ramp (a `derivePalette` set) leaves whatever was there, deliberately.\n  if (t.chart.length > 0) {\n    for (let i = 0; i < 9; i++) el.style.setProperty(`--chart-${i + 1}`, t.chart[i % t.chart.length]);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/tour/tour-engine.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 0.50.1 (keksdose N1): the tour engine a launcher is handed as its fourth argument — one
+ * object for the life of the provider (or of `useTourUrlSync`) whose fields always read the
+ * engine's LATEST render: `engine.active`, `engine.index` after an `await` are current, and
+ * `engine.stop()` mid-run stops the run that is up now. Internal: the type is `TourEngine`.
+ *
+ * `set` is called from a layout effect with each render's engine; `engine` reads it.
+ */
+export declare function liveEngine<T extends object>(keys: readonly (keyof T & string)[], initial?: T | null): {
+    engine: T;
+    set: (current: T) => void;
+};

package/dist/tour/tour-engine.js

@@ -0,0 +1,31 @@
+"use client";
+function liveEngine(keys, initial = null) {
+  let current = initial;
+  const read = () => {
+    if (!current)
+      throw new Error(
+        "[ui-kit] The tour engine was read before its provider rendered."
+      );
+    return current;
+  };
+  const engine = {};
+  for (const key of keys) {
+    Object.defineProperty(engine, key, {
+      enumerable: true,
+      get: () => {
+        const value = read()[key];
+        return typeof value === "function" ? (...args) => read()[key](...args) : value;
+      }
+    });
+  }
+  return {
+    engine,
+    set: (next) => {
+      current = next;
+    }
+  };
+}
+export {
+  liveEngine
+};
+//# sourceMappingURL=tour-engine.js.map

package/dist/tour/tour-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tour/tour-engine.ts"],"sourcesContent":["/**\n * 0.50.1 (keksdose N1): the tour engine a launcher is handed as its fourth argument — one\n * object for the life of the provider (or of `useTourUrlSync`) whose fields always read the\n * engine's LATEST render: `engine.active`, `engine.index` after an `await` are current, and\n * `engine.stop()` mid-run stops the run that is up now. Internal: the type is `TourEngine`.\n *\n * `set` is called from a layout effect with each render's engine; `engine` reads it.\n */\nexport function liveEngine<T extends object>(\n  keys: readonly (keyof T & string)[],\n  initial: T | null = null,\n): { engine: T; set: (current: T) => void } {\n  let current = initial;\n  const read = () => {\n    if (!current)\n      throw new Error(\n        \"[ui-kit] The tour engine was read before its provider rendered.\",\n      );\n    return current;\n  };\n  const engine = {} as T;\n  for (const key of keys) {\n    Object.defineProperty(engine, key, {\n      enumerable: true,\n      get: () => {\n        const value = read()[key];\n        // A method is looked up when it is CALLED, so a kept `engine.stop` is the latest too.\n        return typeof value === \"function\"\n          ? (...args: unknown[]) =>\n              (read()[key] as (...a: unknown[]) => unknown)(...args)\n          : value;\n      },\n    });\n  }\n  return {\n    engine,\n    set: (next) => {\n      current = next;\n    },\n  };\n}\n"],"mappings":";AAQO,SAAS,WACd,MACA,UAAoB,MACsB;AAC1C,MAAI,UAAU;AACd,QAAM,OAAO,MAAM;AACjB,QAAI,CAAC;AACH,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AACF,WAAO;AAAA,EACT;AACA,QAAM,SAAS,CAAC;AAChB,aAAW,OAAO,MAAM;AACtB,WAAO,eAAe,QAAQ,KAAK;AAAA,MACjC,YAAY;AAAA,MACZ,KAAK,MAAM;AACT,cAAM,QAAQ,KAAK,EAAE,GAAG;AAExB,eAAO,OAAO,UAAU,aACpB,IAAI,SACD,KAAK,EAAE,GAAG,EAAmC,GAAG,IAAI,IACvD;AAAA,MACN;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AAAA,IACL;AAAA,IACA,KAAK,CAAC,SAAS;AACb,gBAAU;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}

package/dist/tour/tour.d.ts

@@ -160,13 +160,24 @@ export type TourStart = TourContextValue["start"];
  * `useTourUrlSync`.
  *
  * `start` is the provider's own `start` (keksdose N4), so the launcher needs no ref to a
- * component below the provider and may be defined above it. `useTourUrlSync` passes it too
- * (under a provider). A two-argument launcher that reaches `start` its own way still works.
+ * component below the provider and may be defined above it. `engine` (0.50.1, keksdose N1)
+ * is the rest of the engine — `stop`, `next`, `active`, … — read live, see {@link TourEngine}.
+ * `useTourUrlSync` passes both (under a provider). A launcher taking fewer arguments still
+ * works.
  */
 export type TourLauncher = (id: string, opts: {
     startIndex?: number;
     at?: TourAt;
-}, start: TourStart) => void | Promise<unknown>;
+}, start: TourStart, engine: TourEngine) => void | Promise<unknown>;
+/**
+ * 0.50.1 (keksdose N1): the whole engine `useTour()` returns, handed to a launcher as its
+ * FOURTH argument by `TourProvider` and `useTourUrlSync`, so a tour built above the provider
+ * can also `stop`, `next` or read `active` with no `useTour()` registered from below. One
+ * object per provider whose fields read the latest render (`engine.active` after an
+ * `await` is current); its methods are the provider's own. `start` (the third argument) is
+ * `engine.start`.
+ */
+export type TourEngine = TourContextValue;
 interface StartOptions {
     /** Stable id of the tour, surfaced as `activeId` so the app can mirror it to
      *  the URL (deep-link / evaluation tracking) and record completion. Defaults to