@eifi1/ui-kit 0.11.0 → 0.13.0

package/dist/shell/app-shell.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shell/app-shell.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useId, useRef, useState } from \"react\";\nimport type { ComponentPropsWithoutRef, ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { NavLink, matchPath, useLocation } from \"react-router\";\nimport { ChevronRight, PanelLeftClose, PanelLeftOpen } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { dirOf, type Direction } from \"../lib/direction\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { useAnchoredRect } from \"../hooks/use-anchored-rect\";\nimport { useEscapeKey } from \"../hooks/use-dismiss\";\nimport { useMediaQuery } from \"../hooks/use-media-query\";\nimport { DEFAULT_APP_SHELL_LABELS, useKitLabels } from \"../i18n/kit-labels\";\n\nexport interface AppShellSubItem {\n  to: string;\n  label: string;\n  icon: LucideIcon;\n  /** Passed to NavLink's `end` (exact match). Defaults to true. */\n  end?: boolean;\n}\n\nexport interface AppShellNavItem {\n  to: string;\n  label: string;\n  /** Optional shorter label for the MOBILE BOTTOM BAR only (the sidebar, its\n   *  tooltips and any palette built on this list keep `label`).\n   *\n   *  The bar divides the viewport into `nav.length` equal cells, so a label's room\n   *  shrinks with every entry added — at six entries on a 406 px phone that is ~67 px,\n   *  and \"Import & Export\" wrapped to two lines and pushed the row taller than its\n   *  neighbours (keksdose feedback live #210). A per-item override is better than\n   *  shortening the real label, which the sidebar has ample room for and which is the\n   *  name the rest of the product uses. */\n  shortLabel?: string;\n  icon: LucideIcon;\n  /** Passed to NavLink's `end` (exact match). Defaults to true. */\n  end?: boolean;\n  /** Optional `data-tour` value rendered on this item's link (both the desktop\n   *  sidebar and the mobile bottom bar), so a guided tour can spotlight ONE nav\n   *  entry precisely instead of matching by href (feedback #338). */\n  dataTour?: string;\n  /** Optional sub-items. When present, hovering (or focusing) the item opens a\n   *  flyout to the right of the sidebar with a header (this item's label) and the\n   *  sub-items as icon + title links. Works collapsed or expanded; the mobile\n   *  bottom bar ignores sub-items and links to `to`. */\n  items?: AppShellSubItem[];\n}\n\n/**\n * Exported and `<div>`-shaped. This is the outermost element of every consuming app, so\n * there is nothing above it to hang an id, a landmark label or a `data-tour` anchor on —\n * and nothing a consumer can wrap it in either, since the root owns the `h-dvh` and\n * `overflow-hidden` the whole layout is built on (audit §api-design).\n */\nexport interface AppShellProps extends ComponentPropsWithoutRef<\"div\"> {\n  /** Navigation entries — shared by the desktop sidebar and mobile bottom bar. */\n  nav: AppShellNavItem[];\n  /** The composed top bar (e.g. the shared TopBar with app-owned actions). */\n  topBar: ReactNode;\n  /** Main content — typically the router `<Outlet />`. */\n  children: ReactNode;\n  /** Desktop-only footer rendered below the content (hidden on mobile). */\n  footer?: ReactNode;\n  /** Extra sidebar content above the collapse toggle (e.g. a version link).\n   *  Receives the collapsed state so it can render compact vs. full. */\n  sidebarFooter?: (collapsed: boolean) => ReactNode;\n  /** localStorage key for the persisted collapse state. */\n  collapseStorageKey?: string;\n  /** Default: `appShell.collapse` from the {@link UiKitProvider}, else English. */\n  collapseLabel?: string;\n  /** Default: `appShell.expand` from the {@link UiKitProvider}, else English. */\n  expandLabel?: string;\n  /** How an entry's `items` are revealed in the EXPANDED desktop sidebar.\n   *\n   *  - `\"flyout\"` (default) — a panel beside the sidebar on hover/focus. Compact: the\n   *    sidebar stays one row per group however many pages a group holds.\n   *  - `\"inline\"` — a disclosure under the entry, the pattern of MUI's nested List and\n   *    most documentation sites. Every page is visible at once, and the group holding\n   *    the current page opens on its own, so the reader can see where they are without\n   *    hovering anything.\n   *\n   *  The icon-only (collapsed) sidebar always uses the flyout: an indented list has no\n   *  room there. The mobile bottom bar ignores `items` in both modes. */\n  subNav?: \"flyout\" | \"inline\";\n  /** Accessible name of the inline disclosure button, given the group's label.\n   *  Only used with `subNav=\"inline\"`. Its expanded state is carried by\n   *  `aria-expanded`, so one wording serves both directions. Default:\n   *  `appShell.toggleGroup` from the {@link UiKitProvider}, else English. */\n  toggleGroupLabel?: (groupLabel: string) => string;\n  /** Below `md`: show the current group's `items` as a scrollable row above the\n   *  bottom bar — the phone's counterpart of the sidebar's second level. Default true;\n   *  `false` keeps the single bar, where a group entry only links to its own `to`. */\n  mobileSubNav?: boolean;\n  /**\n   * Lay the shell out inside its PARENT'S box instead of the viewport: `h-full` rather\n   * than `h-dvh`, its own scroll container at every width, a bottom bar pinned to the\n   * shell rather than the window, `--app-nav-h` published on the shell alone, and no\n   * persisted collapse state unless `collapseStorageKey` is passed. For an app preview,\n   * a device frame, a docs example.\n   *\n   * Implied for a shell rendered inside another AppShell, which is the case this\n   * exists for: the inner one used to publish its own nav height on `<html>`, fight\n   * the outer one over it, and remove it on unmount from under the outer app.\n   */\n  embedded?: boolean;\n}\n\n/** True below an AppShell — how a nested shell knows it is one. */\nconst AppShellNesting = createContext(false);\n\n/**\n * The bottom nav's own height, published as `--app-nav-h` so anything that has to sit\n * ON it can stop guessing.\n *\n * Keksdose live #314 is what this is for. Its rework — *\"Stick it to the bottom\n * touching the bottom icon bar with budget, accounts, … Currently there is a small gap\n * which confuses\"* — was a receipt footer pinned at `bottom-20`, because `<main>`\n * reserves `pb-20` for this nav and 20 looked like the nav's height. It is not: the\n * padding is generous CLEARANCE, and the nav is content-sized (icon + label + `py-2`,\n * about 56px), so the footer floated ~24px above the bar.\n *\n * Measured rather than named, because the height is not a constant anyone owns: it is\n * an icon, a translated label that can wrap or truncate, and whatever the platform does\n * with the safe-area inset. A hard-coded `bottom-14` would be the same guess one number\n * lower, and it would be wrong again the first time a label needed two lines.\n *\n * `0px` when the nav is not rendered — above `md` it is `display:none`, which observes\n * as a zero box — so a consumer can write `bottom-[var(--app-nav-h,0px)]` once and get\n * the right answer at both widths without a breakpoint of its own.\n */\nfunction useNavHeightVar(\n  ref: React.RefObject<HTMLElement | null>,\n  shellRef: React.RefObject<HTMLElement | null>,\n  embedded: boolean,\n): void {\n  // Re-run when the breakpoint flips. A ResizeObserver SKIPS an element that is not\n  // being rendered, so the nav going `display:none` above `md` fires no callback and\n  // would leave the last phone height published — a desktop footer would then sit 56px\n  // off the bottom after a live resize. The query is the one the nav's own `md:hidden`\n  // compiles to, so the two cannot disagree about where the boundary is.\n  const isMdUp = useMediaQuery(\"(min-width: 768px)\", false);\n  useEffect(() => {\n    const node = ref.current;\n    const shell = shellRef.current;\n    // Always on the shell's own root, so everything inside it — a nested shell's\n    // content included — reads the nearest bar's height. On <html> as well only for\n    // the OUTERMOST shell, for what it portals to <body> (a sheet docking on the bar).\n    // The DOM check backs up the context for a shell mounted in a separate React root.\n    const global = !embedded && !shell?.parentElement?.closest(\"[data-app-shell]\");\n    const targets = [shell, global ? document.documentElement : null].filter(\n      (el): el is HTMLElement => el !== null,\n    );\n    // `getBoundingClientRect().height`, rounded DOWN — not `offsetHeight`, and not\n    // ceil. Measured on the running app at 406x816: the bar is **55.5px** tall, and\n    // both `offsetHeight` and `Math.ceil` answer 56. That is why live #314 round four\n    // was *\"No change. Still a pixel inbetween\"* — the previous fix was arithmetically\n    // a no-op on the very value it was meant to correct.\n    //\n    // 56 is the wrong side. A sticky element with `bottom: X` puts its bottom edge X\n    // above the viewport bottom, and the bar's TOP edge is at its own height: so\n    // X = 56 lands the footer at y=760.0 against a bar starting at y=760.5, i.e. half\n    // a CSS pixel of page showing through — about 1.4 device pixels on his phone,\n    // which is exactly the hairline in the screenshot.\n    //\n    // The two errors are not symmetric, and I had them backwards the first time.\n    // Too SMALL tucks the sticky element under a bar that is opaque and painted above\n    // it (`z-30` against `z-10`): invisible. Too LARGE opens the seam. So floor, and\n    // consumers subtract a further pixel (see `invoice-line-totals.tsx`) for the case\n    // where the height lands on a whole pixel and floor leaves no overlap at all.\n    const publish = () => {\n      const value = `${node ? Math.floor(node.getBoundingClientRect().height) : 0}px`;\n      for (const el of targets) el.style.setProperty(\"--app-nav-h\", value);\n    };\n    publish();\n    // The observer is the refinement, not the mechanism: `publish()` above is already\n    // right for a static nav, and jsdom has no ResizeObserver unless a test stubs one.\n    // ONE cleanup for every branch, though — an early `return` on the no-observer path\n    // left the variable behind on unmount, which a stale `bottom:` offset on whatever\n    // rendered next would have inherited.\n    const ro = node && typeof ResizeObserver !== \"undefined\" ? new ResizeObserver(publish) : null;\n    if (ro && node) ro.observe(node);\n    return () => {\n      ro?.disconnect();\n      for (const el of targets) el.style.removeProperty(\"--app-nav-h\");\n    };\n  }, [ref, shellRef, embedded, isMdUp]);\n}\n\n/**\n * The responsive application shell: a top bar, a collapsible desktop sidebar\n * (icon-only when collapsed, with tooltips), a mobile bottom nav bar, the main\n * content area, and an optional desktop footer. Router-aware via react-router\n * `NavLink`; domain-free — nav items, brand, footer and the top bar's actions\n * are all supplied by the app.\n */\nexport function AppShell({\n  nav,\n  topBar,\n  children,\n  footer,\n  sidebarFooter,\n  collapseStorageKey: collapseStorageKeyProp,\n  collapseLabel,\n  expandLabel,\n  subNav = \"flyout\",\n  mobileSubNav = true,\n  toggleGroupLabel,\n  embedded: embeddedProp,\n  className,\n  ...rest\n}: AppShellProps) {\n  const embedded = useContext(AppShellNesting) || !!embeddedProp;\n  // An embedded shell sharing the default key would overwrite the outer app's sidebar\n  // preference with its own — so it persists only when given a key of its own.\n  const collapseStorageKey =\n    collapseStorageKeyProp ?? (embedded ? null : \"appLayout.sidebarCollapsed\");\n  // The three props are per-shell overrides of the provider's `appShell`; one left\n  // undefined falls through to the provider rather than to English.\n  const labels = useKitLabels(\"appShell\", DEFAULT_APP_SHELL_LABELS, {\n    collapse: collapseLabel,\n    expand: expandLabel,\n    toggleGroup: toggleGroupLabel,\n  });\n  // Through the guarded helpers, not `window.localStorage` directly. The read runs\n  // inside a `useState` initialiser — i.e. during render of the top-level shell — and\n  // `localStorage` THROWS where site data is blocked (Safari private browsing, a\n  // partitioned webview). Unguarded, that was not a lost sidebar preference: nothing\n  // in the application mounted at all.\n  const [collapsed, setCollapsed] = useState(\n    () => collapseStorageKey !== null && readStored(collapseStorageKey) === \"1\",\n  );\n  // The inline sidebar is an ACCORDION: one group open at a time, keyed by its `to`.\n  // Held here rather than per group so opening one can close the other — two lists\n  // open at once pushed every entry below them off a laptop screen.\n  const [openGroup, setOpenGroup] = useState<string | null>(null);\n  // Publishes `--app-nav-h` for anything that has to sit on the bottom bar.\n  const navRef = useRef<HTMLDivElement>(null);\n  const rootRef = useRef<HTMLDivElement>(null);\n  useNavHeightVar(navRef, rootRef, embedded);\n  useEffect(() => {\n    if (collapseStorageKey !== null) writeStored(collapseStorageKey, collapsed ? \"1\" : \"0\");\n  }, [collapsed, collapseStorageKey]);\n\n  return (\n    // The caller's attributes go on the shell's own root, never on the `data-tour=\"nav\"`\n    // wrappers below — those are the kit's anchors for its own guided tour (#313/#322),\n    // and a second element answering to the same selector is a tour that highlights the\n    // wrong thing or nothing at all.\n    <AppShellNesting.Provider value={true}>\n      <div\n        {...rest}\n        ref={rootRef}\n        data-app-shell=\"\"\n        className={cn(\n          \"relative flex flex-col\",\n          embedded\n            ? // `contain: layout` makes this box the containing block for the `fixed`\n              // bottom bar below, so it pins to the shell rather than to the window.\n              \"h-full min-h-0 overflow-hidden [contain:layout]\"\n            : \"min-h-screen md:h-dvh md:overflow-hidden\",\n          className,\n        )}\n      >\n        {topBar}\n        <div className=\"flex flex-1 min-h-0\">\n          <aside\n            className={cn(\n              // `border-e`: the sidebar sits at the START, which is the right in RTL.\n              \"hidden md:flex md:flex-col border-e border-[var(--border)] bg-[var(--bg-surface)] transition-[width] duration-200 ease-out overflow-hidden\",\n              // Embedded, the row it sits in is already the shell's height; the sticky\n              // offsets below are measured against the window's top bar.\n              embedded ? \"md:self-stretch\" : \"md:sticky md:top-12 md:self-start md:h-[calc(100vh-3rem)]\",\n              collapsed ? \"md:w-14\" : \"md:w-60\",\n            )}\n          >\n            {/* The `<nav>` is flex-1 so it fills the sidebar's height (with empty\n                space below the items); the data-tour marker goes on the INNER,\n                fit-content wrapper so the guided-tour spotlight hugs the actual nav\n                items instead of the whole tall column (feedback #322). The marker\n                also tags the mobile bottom bar below; the tour targets\n                `[data-tour=\"nav\"]` and resolves to whichever is visible (#313). */}\n            <nav className=\"flex-1 px-2 py-3 overflow-y-auto overflow-x-hidden\">\n              <div data-tour=\"nav\" className=\"space-y-1\">\n                {nav.map((item) => (\n                  <SidebarNavItem\n                    key={item.to}\n                    item={item}\n                    collapsed={collapsed}\n                    inline={subNav === \"inline\"}\n                    toggleGroupLabel={labels.toggleGroup}\n                    openGroup={openGroup}\n                    setOpenGroup={setOpenGroup}\n                  />\n                ))}\n              </div>\n            </nav>\n            {sidebarFooter?.(collapsed)}\n            <div className=\"border-t border-[var(--border)] p-2\">\n              {collapsed ? (\n                <Tooltip label={labels.expand} side=\"end\" portal className=\"block\">\n                  <button\n                    type=\"button\"\n                    onClick={() => setCollapsed(false)}\n                    aria-label={labels.expand}\n                    className=\"flex w-full items-center justify-center min-h-9 rounded-md text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\"\n                  >\n                    <PanelLeftOpen className=\"size-4 shrink-0 rtl:-scale-x-100\" />\n                  </button>\n                </Tooltip>\n              ) : (\n                <button\n                  type=\"button\"\n                  onClick={() => setCollapsed(true)}\n                  aria-label={labels.collapse}\n                  className=\"flex w-full items-center gap-3 min-h-9 px-3 py-2 rounded-md text-sm text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\"\n                >\n                  <PanelLeftClose className=\"size-4 shrink-0 rtl:-scale-x-100\" />\n                  <span className=\"truncate\">{labels.collapse}</span>\n                </button>\n              )}\n            </div>\n          </aside>\n\n          {/* Content column beside the sidebar. main grows to fill so the footer\n              sits at the bottom — at the viewport edge when content is short,\n              beside the sidebar rather than under it. */}\n          <div className=\"flex flex-1 flex-col min-w-0 md:min-h-0\">\n            {/* `scrollbar-gutter: stable` reserves the scrollbar's track whether or\n                not it is currently needed. Without it this element — the app's only\n                scroll container from md up — narrows its own client box by the\n                scrollbar width the moment a page's content outgrows it, and widens\n                it again when the next page fits. Every centred `mx-auto` container\n                inside then jumps sideways by half a scrollbar, and any fluid-width\n                content changes width outright. Keksdose feedback #403 caught it as\n                \"slight width increase/decrease\" when switching to the notifications\n                settings section and back: that section is the only one tall enough\n                to scroll. Platform-dependent, which is why it is easy to miss —\n                overlay scrollbars (macOS, most Linux builds) take no layout space,\n                classic ones (Windows) take ~15px.\n\n                `both-edges`, not the bare `stable`: a one-sided reservation keeps the\n                width stable but moves the middle. On a page short enough not to\n                scroll, nothing is painted into the reserved track, so every centred\n                `mx-auto` container sits half a scrollbar left of the optical centre\n                and every full-bleed child stops ~15px short on the right. Keksdose\n                feedback #491 (/settings#data) and #498 (/budgets) both reported it as\n                \"the left boundary looks smaller / cut off compared to the right\" on\n                the one element per page whose frame is a saturated colour — the rose\n                destructive-action cards. Reserving the track on both edges keeps the\n                content centred whether or not the scrollbar is showing. */}\n            {/* `relative` makes <main> the containing block for everything absolutely\n                positioned inside it. Tailwind's `sr-only` is `position:absolute`; with no\n                positioned ancestor it resolves against the INITIAL containing block, is\n                laid out at its offset from the top of the DOCUMENT, and grows\n                `<html>`'s scroll height past the viewport — a second scrollbar beside this\n                one that scrolls into empty space. Guarding it per component (see\n                sr-only-containment.test) could never be complete: any page's own\n                `sr-only` span re-opened it. Here it is closed for every child at once. */}\n            <main\n              className={cn(\n                \"relative flex-1 max-w-full overflow-x-clip pb-[calc(var(--app-nav-h,4rem)+1.5rem)] md:pb-0 md:min-h-0 md:overflow-y-auto md:[scrollbar-gutter:stable_both-edges]\",\n                // Embedded there is no document scroll to lean on below `md` either.\n                embedded && \"min-h-0 overflow-y-auto\",\n              )}\n            >\n              {children}\n            </main>\n            {footer}\n          </div>\n        </div>\n\n        {/* The phone navigation: the group bar, and above it — when the current page\n            belongs to a group with pages of its own — the row of those pages. The pair\n            is the phone's version of the sidebar's two levels; without the upper row a\n            group's `items` were simply unreachable below `md`. ONE measured box, so\n            `--app-nav-h` covers both rows and whatever docks on the bar sits on the\n            whole of it. */}\n        <div\n          ref={navRef}\n          className=\"md:hidden fixed bottom-0 inset-x-0 z-30 border-t border-[var(--border)] bg-[var(--bg-surface)]\"\n        >\n          {mobileSubNav && <MobileSubNav nav={nav} />}\n          <nav\n            data-tour=\"nav\"\n            className=\"grid\"\n            style={{ gridTemplateColumns: `repeat(${nav.length}, minmax(0, 1fr))` }}\n          >\n            {nav.map((item) => (\n              <MobileNavItem key={item.to} item={item} />\n            ))}\n          </nav>\n        </div>\n      </div>\n    </AppShellNesting.Provider>\n  );\n}\n\n/** One cell of the phone's group bar. Marked while the group's own page OR any of its\n *  pages is current — NavLink alone only knows its own `to`, which left the bar with\n *  nothing marked on every sub-page (the same defect the sidebar had). */\nfunction MobileNavItem({ item }: { item: AppShellNavItem }) {\n  const subActive = useSubItemActive(item);\n  return (\n    <NavLink\n      to={item.to}\n      end={item.end ?? true}\n      data-tour={item.dataTour}\n      className={({ isActive }) =>\n        // The active page needs a clear marker, not just a subtle text\n        // shade (feedback #327): brand-accent icon + label, bolder weight,\n        // and a top accent bar spanning the cell so it reads at a glance.\n        cn(\n          \"relative flex flex-col items-center justify-center py-2 text-[11px] gap-0.5 transition-colors\",\n          \"before:absolute before:content-[''] before:inset-x-4 before:top-0 before:h-0.5 before:rounded-full before:transition-colors\",\n          isActive || subActive\n            ? \"font-semibold text-[var(--brand)] before:bg-[var(--brand)]\"\n            : \"text-[var(--text-muted)] before:bg-transparent\",\n        )\n      }\n    >\n      <span className=\"relative\">\n        <item.icon className=\"size-5\" />\n      </span>\n      {/* One line, always. `truncate` is the backstop for the case a\n          `shortLabel` was not supplied (or a translation is longer than its\n          author expected): an ellipsis in one cell is a far smaller problem\n          than a bar whose rows are different heights. */}\n      <span className=\"max-w-full truncate px-0.5\">{item.shortLabel ?? item.label}</span>\n    </NavLink>\n  );\n}\n\n/**\n * The upper row of the phone navigation: the pages of the group the reader is in, as\n * a sideways-scrolling row of pills. Rendered only while such a group is current —\n * on a page outside every group the bar stays one row, rather than showing an empty\n * shelf or guessing a group.\n *\n * It slides in over 200ms (fade only under reduced motion) and wraps onto more rows\n * rather than scrolling, so every page of the group is in view at once.\n */\nfunction MobileSubNav({ nav }: { nav: AppShellNavItem[] }) {\n  const { pathname } = useLocation();\n  const group = nav.find(\n    (item) =>\n      !!item.items?.length &&\n      (matchPath({ path: item.to, end: item.end ?? true }, pathname) ||\n        item.items.some((sub) => matchPath({ path: sub.to, end: sub.end ?? true }, pathname))),\n  );\n\n  if (!group) return null;\n  return (\n    <nav\n      aria-label={group.label}\n      // Keyed by group so switching groups replays the entrance.\n      key={group.to}\n      className=\"animate-subnav border-b border-[var(--border)]\"\n    >\n      <ul\n        // Wraps onto as many rows as the group needs rather than scrolling sideways: a\n        // sideways row hides pages past the edge, and every page of the group in view\n        // is the point of the row. The bar grows with it — `--app-nav-h` measures it.\n        className=\"flex flex-wrap gap-1.5 px-3 py-2\"\n      >\n        {group.items!.map((sub) => (\n          <li key={sub.to} className=\"shrink-0\">\n            <NavLink\n              to={sub.to}\n              end={sub.end ?? true}\n              className={({ isActive }) =>\n                cn(\n                  \"flex items-center gap-1.5 rounded-full border px-3 py-1 text-xs transition-colors\",\n                  isActive\n                    ? \"border-[var(--brand)] bg-[var(--brand)] font-medium text-[var(--brand-contrast)]\"\n                    : \"border-[var(--border)] text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\",\n                )\n              }\n            >\n              <sub.icon className=\"size-3.5 shrink-0\" aria-hidden />\n              {sub.label}\n            </NavLink>\n          </li>\n        ))}\n      </ul>\n    </nav>\n  );\n}\n\n/** `strong` is the current page; `trail` is the group that CONTAINS the current page\n *  while the page itself is shown elsewhere (the inline list below it). */\nconst navLinkClass = (collapsed: boolean, forceActive: boolean, trail = false) =>\n  ({ isActive }: { isActive: boolean }) =>\n    `flex items-center gap-3 min-h-9 ${collapsed ? \"justify-center px-2\" : \"px-3\"} py-2 rounded-md text-sm transition-colors duration-150 ${\n      isActive || (forceActive && !trail)\n        ? \"bg-[var(--bg-inverse)] text-[var(--text-inverse)]\"\n        : forceActive\n          ? \"font-medium text-[var(--text-primary)] hover:bg-[var(--bg-hover)]\"\n          : \"text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\"\n    }`;\n\n/** Whether any of an entry's sub-items is the current route. NavLink only knows about\n *  its OWN `to`, so without this a group whose pages live at sibling paths\n *  (`/fields`, `/numbers`, …) lost its highlight the moment the reader left the one\n *  page the group linked to — the sidebar then marked nothing at all, and the only\n *  \"you are here\" left was inside a flyout that is closed unless hovered. */\nfunction useSubItemActive(item: AppShellNavItem): boolean {\n  const { pathname } = useLocation();\n  return !!item.items?.some((sub) => matchPath({ path: sub.to, end: sub.end ?? true }, pathname));\n}\n\n/** A single desktop sidebar entry. Plain link (with a tooltip when collapsed) —\n *  unless it has sub-items, in which case hovering/focusing opens a flyout, or (with\n *  `inline`) a disclosure lists them underneath. */\nfunction SidebarNavItem({\n  item,\n  collapsed,\n  inline,\n  toggleGroupLabel,\n  openGroup,\n  setOpenGroup,\n}: {\n  item: AppShellNavItem;\n  collapsed: boolean;\n  inline: boolean;\n  toggleGroupLabel: (groupLabel: string) => string;\n  openGroup: string | null;\n  setOpenGroup: (to: string | null) => void;\n}) {\n  const hasSub = !!item.items?.length;\n  const subActive = useSubItemActive(item);\n\n  // In the EXPANDED sidebar a group is one component in both styles, so switching\n  // between them is a transition of the same element (the page list folding away or\n  // unfolding) rather than one tree replaced by another. The icon-only sidebar keeps\n  // the plain flyout below: an indented list has no room there.\n  if (hasSub && !collapsed) {\n    return (\n      <SidebarGroup\n        item={item}\n        subActive={subActive}\n        inline={inline}\n        toggleGroupLabel={toggleGroupLabel}\n        open={openGroup === item.to}\n        setOpenGroup={setOpenGroup}\n      />\n    );\n  }\n\n  const link = (\n    <NavLink\n      to={item.to}\n      end={item.end ?? true}\n      data-tour={item.dataTour}\n      className={navLinkClass(collapsed, subActive)}\n      aria-haspopup={hasSub ? \"menu\" : undefined}\n    >\n      <span className=\"relative shrink-0\">\n        <item.icon className=\"size-4\" />\n      </span>\n      {/* Wraps rather than truncates: in the sidebar a label cut to \"Checkbox, switch\n          & sl…\" hides the one word that tells two pages apart, and there is height\n          to spare. (The phone bar keeps `truncate` — its cells must stay one row.) */}\n      {!collapsed && <span className=\"min-w-0 flex-1 break-words leading-snug\">{item.label}</span>}\n      {!collapsed && hasSub && <ChevronRight className=\"size-3.5 shrink-0 opacity-60 rtl:-scale-x-100\" />}\n    </NavLink>\n  );\n\n  if (hasSub) return <SidebarFlyout item={item}>{link}</SidebarFlyout>;\n  return collapsed ? (\n    <Tooltip label={item.label} side=\"end\" portal className=\"block\">\n      {link}\n    </Tooltip>\n  ) : (\n    link\n  );\n}\n\n/**\n * An entry with sub-items in the expanded sidebar.\n *\n * - `inline`: the entry's own link (its overview page) plus a chevron button that\n *   shows or hides the sub-items indented beneath it. Two controls rather than one\n *   because they do two different things — a row that both navigated AND toggled\n *   would make \"open the overview\" and \"peek at the pages\" the same click.\n * - flyout: the link alone, with the sub-items in a panel beside the sidebar on\n *   hover/focus. The inline list is still rendered, folded shut, so that switching\n *   styles animates it rather than swapping it.\n *\n * THE FOLD is a `grid-template-rows` transition from `0fr` to `1fr` — the one way to\n * animate to a content-sized height without measuring it, so a translated label that\n * wraps to two lines unfolds exactly as far as it needs. `visibility` rides the same\n * transition so a shut list drops out of the accessibility tree only once it has\n * finished closing, and `inert` takes its links out of the tab order immediately.\n */\nfunction SidebarGroup({\n  item,\n  subActive,\n  inline,\n  toggleGroupLabel,\n  open,\n  setOpenGroup,\n}: {\n  item: AppShellNavItem;\n  subActive: boolean;\n  inline: boolean;\n  toggleGroupLabel: (groupLabel: string) => string;\n  /** Whether this is the sidebar's one open group (see AppShell's `openGroup`). */\n  open: boolean;\n  setOpenGroup: (to: string | null) => void;\n}) {\n  const listId = useId();\n  const { pathname } = useLocation();\n  const onOwnPage = !!matchPath({ path: item.to, end: item.end ?? true }, pathname);\n  // Opening follows the reader: arriving on this group's overview or one of its pages\n  // (by link, by the pager, by Back) opens it — and, the sidebar holding ONE open\n  // group, closes whichever was open before. Both folds run at once, so the eye sees\n  // one list hand over to the other. Run in an effect after mount, so the current\n  // group UNFOLDS into view on load rather than appearing already open.\n  const here = subActive || onOwnPage;\n  useEffect(() => {\n    // eslint-disable-next-line react-hooks/set-state-in-effect -- follows the route, see above\n    if (here) setOpenGroup(item.to);\n  }, [here, item.to, setOpenGroup]);\n  const expanded = inline && open;\n\n  const link = (\n    <NavLink\n      to={item.to}\n      end={item.end ?? true}\n      data-tour={item.dataTour}\n      aria-haspopup={inline ? undefined : \"menu\"}\n      // `trail` (inline only): while a page of the group is current, the group row is\n      // the breadcrumb, not the destination — the page's own row below carries the\n      // strong marker, and two inverse rows would say \"you are here\" twice. In the\n      // flyout style the pages are out of sight, so the group row IS the marker.\n      className={(state) => cn(navLinkClass(false, subActive, inline)(state), \"min-w-0 flex-1\")}\n    >\n      <span className=\"relative shrink-0\">\n        <item.icon className=\"size-4\" />\n      </span>\n      <span className=\"min-w-0 flex-1 break-words leading-snug\">{item.label}</span>\n      {!inline && <ChevronRight className=\"size-3.5 shrink-0 opacity-60 rtl:-scale-x-100\" />}\n    </NavLink>\n  );\n\n  return (\n    <div>\n      {inline ? (\n        <div className=\"flex items-center gap-0.5\">\n          {link}\n          <button\n            type=\"button\"\n            aria-expanded={open}\n            aria-controls={listId}\n            aria-label={toggleGroupLabel(item.label)}\n            onClick={() => setOpenGroup(open ? null : item.to)}\n            className=\"flex size-9 shrink-0 items-center justify-center rounded-md text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\"\n          >\n            <ChevronRight\n              aria-hidden\n              className={cn(\n                \"size-3.5 transition-transform duration-200 ease-out motion-reduce:transition-none rtl:-scale-x-100\",\n                // Under dir=\"rtl\" the chevron is MIRRORED first (scale applies before rotate), so\n                // it starts pointing left and a +90° turn would point it UP — hence −90° there.\n                open && \"rotate-90 rtl:-rotate-90\",\n              )}\n            />\n          </button>\n        </div>\n      ) : (\n        <SidebarFlyout item={item}>{link}</SidebarFlyout>\n      )}\n      <div\n        id={listId}\n        inert={!expanded}\n        className=\"grid transition-[grid-template-rows,visibility] duration-200 ease-out motion-reduce:transition-none\"\n        style={{\n          gridTemplateRows: expanded ? \"1fr\" : \"0fr\",\n          visibility: expanded ? \"visible\" : \"hidden\",\n        }}\n      >\n        <div\n          className={cn(\n            \"min-h-0 overflow-hidden transition-opacity duration-200 ease-out motion-reduce:transition-none\",\n            expanded ? \"opacity-100\" : \"opacity-0\",\n          )}\n        >\n          {/* The rule and indent live on the list INSIDE the clipping box: margin or\n              padding on the element whose row is collapsing to 0fr would hold it open\n              by that much. */}\n          <ul className=\"ms-[1.3rem] mt-0.5 space-y-0.5 border-s border-[var(--border)] ps-2\">\n            {item.items!.map((sub) => (\n              <li key={sub.to}>\n                <NavLink\n                  to={sub.to}\n                  end={sub.end ?? true}\n                  className={({ isActive }) =>\n                    cn(\n                      \"flex min-h-8 items-center gap-2.5 rounded-md px-2.5 py-1.5 text-sm transition-colors\",\n                      isActive\n                        ? \"bg-[var(--bg-inverse)] text-[var(--text-inverse)]\"\n                        : \"text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\",\n                    )\n                  }\n                >\n                  <sub.icon className=\"size-4 shrink-0 opacity-70\" aria-hidden />\n                  <span className=\"min-w-0 break-words leading-snug\">{sub.label}</span>\n                </NavLink>\n              </li>\n            ))}\n          </ul>\n        </div>\n      </div>\n    </div>\n  );\n}\n\n// Only ONE sidebar flyout should be on screen at a time. Each open flyout parks its\n// \"close now\" here so the next item to open can dismiss it immediately, instead of\n// leaving the previous panel up for the 140ms travel delay while the cursor moves\n// down the nav list — which showed two panels at once.\nlet activeFlyoutClose: (() => void) | null = null;\n\n/**\n * Wraps a nav item that has sub-items: on hover or keyboard focus it opens a\n * portalled flyout to the right of the sidebar (portalled so the sidebar's\n * `overflow-hidden` can't clip it) with the item's label as a header and each\n * sub-item as an icon + title link. A short close delay lets the cursor travel\n * from the item onto the panel; Escape / outside-move close it.\n */\nfunction SidebarFlyout({ item, children }: { item: AppShellNavItem; children: ReactNode }) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const closeTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const [open, setOpen] = useState(false);\n  // The flyout is portalled out of the subtree whose `dir` it inherited; read on open.\n  const [dir, setDir] = useState<Direction>(\"ltr\");\n\n  // Anchor the flyout to the item's END edge — its right, or its left in RTL, where\n  // the sidebar sits on the right of the window. The hook re-measures on\n  // scroll/resize (the nav list can scroll).\n  const rect = useAnchoredRect(wrapperRef, open);\n  const pos = rect\n    ? dir === \"rtl\"\n      ? { top: rect.top, right: window.innerWidth - rect.left }\n      : { top: rect.top, left: rect.right }\n    : null;\n\n  const cancelClose = useCallback(() => {\n    if (closeTimer.current) {\n      clearTimeout(closeTimer.current);\n      closeTimer.current = null;\n    }\n  }, []);\n  // Stable identity: the coordinator above holds this so a sibling item can close\n  // THIS flyout without waiting out its travel delay.\n  const closeNow = useCallback(() => {\n    cancelClose();\n    setOpen(false);\n  }, [cancelClose]);\n  const openMenu = useCallback(() => {\n    cancelClose();\n    if (activeFlyoutClose && activeFlyoutClose !== closeNow) activeFlyoutClose();\n    activeFlyoutClose = closeNow;\n    setDir(dirOf(wrapperRef.current));\n    setOpen(true);\n  }, [cancelClose, closeNow]);\n  const scheduleClose = useCallback(() => {\n    cancelClose();\n    closeTimer.current = setTimeout(() => {\n      setOpen(false);\n      if (activeFlyoutClose === closeNow) activeFlyoutClose = null;\n    }, 140);\n  }, [cancelClose, closeNow]);\n\n  // Close on Escape while open.\n  useEscapeKey(() => setOpen(false), open);\n\n  useEffect(\n    () => () => {\n      cancelClose();\n      if (activeFlyoutClose === closeNow) activeFlyoutClose = null;\n    },\n    [cancelClose, closeNow],\n  );\n\n  return (\n    <div\n      ref={wrapperRef}\n      className=\"relative\"\n      onMouseEnter={openMenu}\n      onMouseLeave={scheduleClose}\n      onFocus={openMenu}\n      onBlur={scheduleClose}\n    >\n      {children}\n      {open &&\n        pos &&\n        createPortal(\n          <div\n            dir={dir}\n            style={{ position: \"fixed\", ...pos }}\n            className=\"z-40 ps-1\"\n            onMouseEnter={cancelClose}\n            onMouseLeave={scheduleClose}\n          >\n            <div\n              role=\"menu\"\n              aria-label={item.label}\n              className=\"animate-flyout min-w-52 overflow-hidden rounded-md border border-[var(--border)] bg-[var(--bg-surface)] shadow-lg\"\n            >\n              <div className=\"border-b border-[var(--border)] px-3 py-2 text-[11px] font-semibold uppercase tracking-wide text-[var(--text-muted)]\">\n                {item.label}\n              </div>\n              <ul className=\"py-1\">\n                {item.items!.map((sub) => (\n                  <li key={sub.to}>\n                    <NavLink\n                      to={sub.to}\n                      end={sub.end ?? true}\n                      role=\"menuitem\"\n                      onClick={() => setOpen(false)}\n                      className={({ isActive }) =>\n                        cn(\n                          \"flex items-center gap-2.5 px-3 py-2 text-sm\",\n                          isActive\n                            ? \"bg-[var(--bg-active)] font-medium text-[var(--text-primary)]\"\n                            : \"text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\",\n                        )\n                      }\n                    >\n                      <sub.icon className=\"size-4 shrink-0 text-[var(--text-placeholder)]\" />\n                      <span className=\"min-w-0 break-words leading-snug\">{sub.label}</span>\n                    </NavLink>\n                  </li>\n                ))}\n              </ul>\n            </div>\n          </div>,\n          document.body,\n        )}\n    </div>\n  );\n}\n"],"mappings":";AA8RkB,cA0BF,YA1BE;AA9RlB,SAAS,eAAe,aAAa,YAAY,WAAW,OAAO,QAAQ,gBAAgB;AAE3F,SAAS,oBAAoB;AAC7B,SAAS,SAAS,WAAW,mBAAmB;AAChD,SAAS,cAAc,gBAAgB,qBAAqB;AAE5D,SAAS,UAAU;AACnB,SAAS,aAA6B;AACtC,SAAS,YAAY,mBAAmB;AACxC,SAAS,eAAe;AACxB,SAAS,uBAAuB;AAChC,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,0BAA0B,oBAAoB;AAiGvD,MAAM,kBAAkB,cAAc,KAAK;AAsB3C,SAAS,gBACP,KACA,UACA,UACM;AAMN,QAAM,SAAS,cAAc,sBAAsB,KAAK;AACxD,YAAU,MAAM;AACd,UAAM,OAAO,IAAI;AACjB,UAAM,QAAQ,SAAS;AAKvB,UAAM,SAAS,CAAC,YAAY,CAAC,OAAO,eAAe,QAAQ,kBAAkB;AAC7E,UAAM,UAAU,CAAC,OAAO,SAAS,SAAS,kBAAkB,IAAI,EAAE;AAAA,MAChE,CAAC,OAA0B,OAAO;AAAA,IACpC;AAkBA,UAAM,UAAU,MAAM;AACpB,YAAM,QAAQ,GAAG,OAAO,KAAK,MAAM,KAAK,sBAAsB,EAAE,MAAM,IAAI,CAAC;AAC3E,iBAAW,MAAM,QAAS,IAAG,MAAM,YAAY,eAAe,KAAK;AAAA,IACrE;AACA,YAAQ;AAMR,UAAM,KAAK,QAAQ,OAAO,mBAAmB,cAAc,IAAI,eAAe,OAAO,IAAI;AACzF,QAAI,MAAM,KAAM,IAAG,QAAQ,IAAI;AAC/B,WAAO,MAAM;AACX,UAAI,WAAW;AACf,iBAAW,MAAM,QAAS,IAAG,MAAM,eAAe,aAAa;AAAA,IACjE;AAAA,EACF,GAAG,CAAC,KAAK,UAAU,UAAU,MAAM,CAAC;AACtC;AASO,SAAS,SAAS;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAAoB;AAAA,EACpB;AAAA,EACA;AAAA,EACA,SAAS;AAAA,EACT,eAAe;AAAA,EACf;AAAA,EACA,UAAU;AAAA,EACV;AAAA,EACA,GAAG;AACL,GAAkB;AAChB,QAAM,WAAW,WAAW,eAAe,KAAK,CAAC,CAAC;AAGlD,QAAM,qBACJ,2BAA2B,WAAW,OAAO;AAG/C,QAAM,SAAS,aAAa,YAAY,0BAA0B;AAAA,IAChE,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,aAAa;AAAA,EACf,CAAC;AAMD,QAAM,CAAC,WAAW,YAAY,IAAI;AAAA,IAChC,MAAM,uBAAuB,QAAQ,WAAW,kBAAkB,MAAM;AAAA,EAC1E;AAIA,QAAM,CAAC,WAAW,YAAY,IAAI,SAAwB,IAAI;AAE9D,QAAM,SAAS,OAAuB,IAAI;AAC1C,QAAM,UAAU,OAAuB,IAAI;AAC3C,kBAAgB,QAAQ,SAAS,QAAQ;AACzC,YAAU,MAAM;AACd,QAAI,uBAAuB,KAAM,aAAY,oBAAoB,YAAY,MAAM,GAAG;AAAA,EACxF,GAAG,CAAC,WAAW,kBAAkB,CAAC;AAElC;AAAA;AAAA;AAAA;AAAA;AAAA,IAKE,oBAAC,gBAAgB,UAAhB,EAAyB,OAAO,MAC/B;AAAA,MAAC;AAAA;AAAA,QACE,GAAG;AAAA,QACJ,KAAK;AAAA,QACL,kBAAe;AAAA,QACf,WAAW;AAAA,UACT;AAAA,UACA;AAAA;AAAA;AAAA,YAGI;AAAA,cACA;AAAA,UACJ;AAAA,QACF;AAAA,QAEC;AAAA;AAAA,UACD,qBAAC,SAAI,WAAU,uBACb;AAAA;AAAA,cAAC;AAAA;AAAA,gBACC,WAAW;AAAA;AAAA,kBAET;AAAA;AAAA;AAAA,kBAGA,WAAW,oBAAoB;AAAA,kBAC/B,YAAY,YAAY;AAAA,gBAC1B;AAAA,gBAQA;AAAA,sCAAC,SAAI,WAAU,sDACb,8BAAC,SAAI,aAAU,OAAM,WAAU,aAC5B,cAAI,IAAI,CAAC,SACR;AAAA,oBAAC;AAAA;AAAA,sBAEC;AAAA,sBACA;AAAA,sBACA,QAAQ,WAAW;AAAA,sBACnB,kBAAkB,OAAO;AAAA,sBACzB;AAAA,sBACA;AAAA;AAAA,oBANK,KAAK;AAAA,kBAOZ,CACD,GACH,GACF;AAAA,kBACC,gBAAgB,SAAS;AAAA,kBAC1B,oBAAC,SAAI,WAAU,uCACZ,sBACC,oBAAC,WAAQ,OAAO,OAAO,QAAQ,MAAK,OAAM,QAAM,MAAC,WAAU,SACzD;AAAA,oBAAC;AAAA;AAAA,sBACC,MAAK;AAAA,sBACL,SAAS,MAAM,aAAa,KAAK;AAAA,sBACjC,cAAY,OAAO;AAAA,sBACnB,WAAU;AAAA,sBAEV,8BAAC,iBAAc,WAAU,oCAAmC;AAAA;AAAA,kBAC9D,GACF,IAEA;AAAA,oBAAC;AAAA;AAAA,sBACC,MAAK;AAAA,sBACL,SAAS,MAAM,aAAa,IAAI;AAAA,sBAChC,cAAY,OAAO;AAAA,sBACnB,WAAU;AAAA,sBAEV;AAAA,4CAAC,kBAAe,WAAU,oCAAmC;AAAA,wBAC7D,oBAAC,UAAK,WAAU,YAAY,iBAAO,UAAS;AAAA;AAAA;AAAA,kBAC9C,GAEJ;AAAA;AAAA;AAAA,YACF;AAAA,YAKA,qBAAC,SAAI,WAAU,2CAgCb;AAAA;AAAA,gBAAC;AAAA;AAAA,kBACC,WAAW;AAAA,oBACT;AAAA;AAAA,oBAEA,YAAY;AAAA,kBACd;AAAA,kBAEC;AAAA;AAAA,cACH;AAAA,cACC;AAAA,eACH;AAAA,aACF;AAAA,UAQA;AAAA,YAAC;AAAA;AAAA,cACC,KAAK;AAAA,cACL,WAAU;AAAA,cAET;AAAA,gCAAgB,oBAAC,gBAAa,KAAU;AAAA,gBACzC;AAAA,kBAAC;AAAA;AAAA,oBACC,aAAU;AAAA,oBACV,WAAU;AAAA,oBACV,OAAO,EAAE,qBAAqB,UAAU,IAAI,MAAM,oBAAoB;AAAA,oBAErE,cAAI,IAAI,CAAC,SACR,oBAAC,iBAA4B,QAAT,KAAK,EAAgB,CAC1C;AAAA;AAAA,gBACH;AAAA;AAAA;AAAA,UACF;AAAA;AAAA;AAAA,IACF,GACF;AAAA;AAEJ;AAKA,SAAS,cAAc,EAAE,KAAK,GAA8B;AAC1D,QAAM,YAAY,iBAAiB,IAAI;AACvC,SACE;AAAA,IAAC;AAAA;AAAA,MACC,IAAI,KAAK;AAAA,MACT,KAAK,KAAK,OAAO;AAAA,MACjB,aAAW,KAAK;AAAA,MAChB,WAAW,CAAC,EAAE,SAAS;AAAA;AAAA;AAAA;AAAA,QAIrB;AAAA,UACE;AAAA,UACA;AAAA,UACA,YAAY,YACR,+DACA;AAAA,QACN;AAAA;AAAA,MAGF;AAAA,4BAAC,UAAK,WAAU,YACd,8BAAC,KAAK,MAAL,EAAU,WAAU,UAAS,GAChC;AAAA,QAKA,oBAAC,UAAK,WAAU,8BAA8B,eAAK,cAAc,KAAK,OAAM;AAAA;AAAA;AAAA,EAC9E;AAEJ;AAWA,SAAS,aAAa,EAAE,IAAI,GAA+B;AACzD,QAAM,EAAE,SAAS,IAAI,YAAY;AACjC,QAAM,QAAQ,IAAI;AAAA,IAChB,CAAC,SACC,CAAC,CAAC,KAAK,OAAO,WACb,UAAU,EAAE,MAAM,KAAK,IAAI,KAAK,KAAK,OAAO,KAAK,GAAG,QAAQ,KAC3D,KAAK,MAAM,KAAK,CAAC,QAAQ,UAAU,EAAE,MAAM,IAAI,IAAI,KAAK,IAAI,OAAO,KAAK,GAAG,QAAQ,CAAC;AAAA,EAC1F;AAEA,MAAI,CAAC,MAAO,QAAO;AACnB,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,MAAM;AAAA,MAGlB,WAAU;AAAA,MAEV;AAAA,QAAC;AAAA;AAAA,UAIC,WAAU;AAAA,UAET,gBAAM,MAAO,IAAI,CAAC,QACjB,oBAAC,QAAgB,WAAU,YACzB;AAAA,YAAC;AAAA;AAAA,cACC,IAAI,IAAI;AAAA,cACR,KAAK,IAAI,OAAO;AAAA,cAChB,WAAW,CAAC,EAAE,SAAS,MACrB;AAAA,gBACE;AAAA,gBACA,WACI,qFACA;AAAA,cACN;AAAA,cAGF;AAAA,oCAAC,IAAI,MAAJ,EAAS,WAAU,qBAAoB,eAAW,MAAC;AAAA,gBACnD,IAAI;AAAA;AAAA;AAAA,UACP,KAfO,IAAI,EAgBb,CACD;AAAA;AAAA,MACH;AAAA;AAAA,IA5BK,MAAM;AAAA,EA6Bb;AAEJ;AAIA,MAAM,eAAe,CAAC,WAAoB,aAAsB,QAAQ,UACtE,CAAC,EAAE,SAAS,MACV,mCAAmC,YAAY,wBAAwB,MAAM,2DAC3E,YAAa,eAAe,CAAC,QACzB,sDACA,cACE,sEACA,yDACR;AAOJ,SAAS,iBAAiB,MAAgC;AACxD,QAAM,EAAE,SAAS,IAAI,YAAY;AACjC,SAAO,CAAC,CAAC,KAAK,OAAO,KAAK,CAAC,QAAQ,UAAU,EAAE,MAAM,IAAI,IAAI,KAAK,IAAI,OAAO,KAAK,GAAG,QAAQ,CAAC;AAChG;AAKA,SAAS,eAAe;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOG;AACD,QAAM,SAAS,CAAC,CAAC,KAAK,OAAO;AAC7B,QAAM,YAAY,iBAAiB,IAAI;AAMvC,MAAI,UAAU,CAAC,WAAW;AACxB,WACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,MAAM,cAAc,KAAK;AAAA,QACzB;AAAA;AAAA,IACF;AAAA,EAEJ;AAEA,QAAM,OACJ;AAAA,IAAC;AAAA;AAAA,MACC,IAAI,KAAK;AAAA,MACT,KAAK,KAAK,OAAO;AAAA,MACjB,aAAW,KAAK;AAAA,MAChB,WAAW,aAAa,WAAW,SAAS;AAAA,MAC5C,iBAAe,SAAS,SAAS;AAAA,MAEjC;AAAA,4BAAC,UAAK,WAAU,qBACd,8BAAC,KAAK,MAAL,EAAU,WAAU,UAAS,GAChC;AAAA,QAIC,CAAC,aAAa,oBAAC,UAAK,WAAU,2CAA2C,eAAK,OAAM;AAAA,QACpF,CAAC,aAAa,UAAU,oBAAC,gBAAa,WAAU,iDAAgD;AAAA;AAAA;AAAA,EACnG;AAGF,MAAI,OAAQ,QAAO,oBAAC,iBAAc,MAAa,gBAAK;AACpD,SAAO,YACL,oBAAC,WAAQ,OAAO,KAAK,OAAO,MAAK,OAAM,QAAM,MAAC,WAAU,SACrD,gBACH,IAEA;AAEJ;AAmBA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAQG;AACD,QAAM,SAAS,MAAM;AACrB,QAAM,EAAE,SAAS,IAAI,YAAY;AACjC,QAAM,YAAY,CAAC,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,KAAK,KAAK,OAAO,KAAK,GAAG,QAAQ;AAMhF,QAAM,OAAO,aAAa;AAC1B,YAAU,MAAM;AAEd,QAAI,KAAM,cAAa,KAAK,EAAE;AAAA,EAChC,GAAG,CAAC,MAAM,KAAK,IAAI,YAAY,CAAC;AAChC,QAAM,WAAW,UAAU;AAE3B,QAAM,OACJ;AAAA,IAAC;AAAA;AAAA,MACC,IAAI,KAAK;AAAA,MACT,KAAK,KAAK,OAAO;AAAA,MACjB,aAAW,KAAK;AAAA,MAChB,iBAAe,SAAS,SAAY;AAAA,MAKpC,WAAW,CAAC,UAAU,GAAG,aAAa,OAAO,WAAW,MAAM,EAAE,KAAK,GAAG,gBAAgB;AAAA,MAExF;AAAA,4BAAC,UAAK,WAAU,qBACd,8BAAC,KAAK,MAAL,EAAU,WAAU,UAAS,GAChC;AAAA,QACA,oBAAC,UAAK,WAAU,2CAA2C,eAAK,OAAM;AAAA,QACrE,CAAC,UAAU,oBAAC,gBAAa,WAAU,iDAAgD;AAAA;AAAA;AAAA,EACtF;AAGF,SACE,qBAAC,SACE;AAAA,aACC,qBAAC,SAAI,WAAU,6BACZ;AAAA;AAAA,MACD;AAAA,QAAC;AAAA;AAAA,UACC,MAAK;AAAA,UACL,iBAAe;AAAA,UACf,iBAAe;AAAA,UACf,cAAY,iBAAiB,KAAK,KAAK;AAAA,UACvC,SAAS,MAAM,aAAa,OAAO,OAAO,KAAK,EAAE;AAAA,UACjD,WAAU;AAAA,UAEV;AAAA,YAAC;AAAA;AAAA,cACC,eAAW;AAAA,cACX,WAAW;AAAA,gBACT;AAAA;AAAA;AAAA,gBAGA,QAAQ;AAAA,cACV;AAAA;AAAA,UACF;AAAA;AAAA,MACF;AAAA,OACF,IAEA,oBAAC,iBAAc,MAAa,gBAAK;AAAA,IAEnC;AAAA,MAAC;AAAA;AAAA,QACC,IAAI;AAAA,QACJ,OAAO,CAAC;AAAA,QACR,WAAU;AAAA,QACV,OAAO;AAAA,UACL,kBAAkB,WAAW,QAAQ;AAAA,UACrC,YAAY,WAAW,YAAY;AAAA,QACrC;AAAA,QAEA;AAAA,UAAC;AAAA;AAAA,YACC,WAAW;AAAA,cACT;AAAA,cACA,WAAW,gBAAgB;AAAA,YAC7B;AAAA,YAKA,8BAAC,QAAG,WAAU,uEACX,eAAK,MAAO,IAAI,CAAC,QAChB,oBAAC,QACC;AAAA,cAAC;AAAA;AAAA,gBACC,IAAI,IAAI;AAAA,gBACR,KAAK,IAAI,OAAO;AAAA,gBAChB,WAAW,CAAC,EAAE,SAAS,MACrB;AAAA,kBACE;AAAA,kBACA,WACI,sDACA;AAAA,gBACN;AAAA,gBAGF;AAAA,sCAAC,IAAI,MAAJ,EAAS,WAAU,8BAA6B,eAAW,MAAC;AAAA,kBAC7D,oBAAC,UAAK,WAAU,oCAAoC,cAAI,OAAM;AAAA;AAAA;AAAA,YAChE,KAfO,IAAI,EAgBb,CACD,GACH;AAAA;AAAA,QACF;AAAA;AAAA,IACF;AAAA,KACF;AAEJ;AAMA,IAAI,oBAAyC;AAS7C,SAAS,cAAc,EAAE,MAAM,SAAS,GAAmD;AACzF,QAAM,aAAa,OAAuB,IAAI;AAC9C,QAAM,aAAa,OAA6C,IAAI;AACpE,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AAEtC,QAAM,CAAC,KAAK,MAAM,IAAI,SAAoB,KAAK;AAK/C,QAAM,OAAO,gBAAgB,YAAY,IAAI;AAC7C,QAAM,MAAM,OACR,QAAQ,QACN,EAAE,KAAK,KAAK,KAAK,OAAO,OAAO,aAAa,KAAK,KAAK,IACtD,EAAE,KAAK,KAAK,KAAK,MAAM,KAAK,MAAM,IACpC;AAEJ,QAAM,cAAc,YAAY,MAAM;AACpC,QAAI,WAAW,SAAS;AACtB,mBAAa,WAAW,OAAO;AAC/B,iBAAW,UAAU;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,CAAC;AAGL,QAAM,WAAW,YAAY,MAAM;AACjC,gBAAY;AACZ,YAAQ,KAAK;AAAA,EACf,GAAG,CAAC,WAAW,CAAC;AAChB,QAAM,WAAW,YAAY,MAAM;AACjC,gBAAY;AACZ,QAAI,qBAAqB,sBAAsB,SAAU,mBAAkB;AAC3E,wBAAoB;AACpB,WAAO,MAAM,WAAW,OAAO,CAAC;AAChC,YAAQ,IAAI;AAAA,EACd,GAAG,CAAC,aAAa,QAAQ,CAAC;AAC1B,QAAM,gBAAgB,YAAY,MAAM;AACtC,gBAAY;AACZ,eAAW,UAAU,WAAW,MAAM;AACpC,cAAQ,KAAK;AACb,UAAI,sBAAsB,SAAU,qBAAoB;AAAA,IAC1D,GAAG,GAAG;AAAA,EACR,GAAG,CAAC,aAAa,QAAQ,CAAC;AAG1B,eAAa,MAAM,QAAQ,KAAK,GAAG,IAAI;AAEvC;AAAA,IACE,MAAM,MAAM;AACV,kBAAY;AACZ,UAAI,sBAAsB,SAAU,qBAAoB;AAAA,IAC1D;AAAA,IACA,CAAC,aAAa,QAAQ;AAAA,EACxB;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC,KAAK;AAAA,MACL,WAAU;AAAA,MACV,cAAc;AAAA,MACd,cAAc;AAAA,MACd,SAAS;AAAA,MACT,QAAQ;AAAA,MAEP;AAAA;AAAA,QACA,QACC,OACA;AAAA,UACE;AAAA,YAAC;AAAA;AAAA,cACC;AAAA,cACA,OAAO,EAAE,UAAU,SAAS,GAAG,IAAI;AAAA,cACnC,WAAU;AAAA,cACV,cAAc;AAAA,cACd,cAAc;AAAA,cAEd;AAAA,gBAAC;AAAA;AAAA,kBACC,MAAK;AAAA,kBACL,cAAY,KAAK;AAAA,kBACjB,WAAU;AAAA,kBAEV;AAAA,wCAAC,SAAI,WAAU,wHACZ,eAAK,OACR;AAAA,oBACA,oBAAC,QAAG,WAAU,QACX,eAAK,MAAO,IAAI,CAAC,QAChB,oBAAC,QACC;AAAA,sBAAC;AAAA;AAAA,wBACC,IAAI,IAAI;AAAA,wBACR,KAAK,IAAI,OAAO;AAAA,wBAChB,MAAK;AAAA,wBACL,SAAS,MAAM,QAAQ,KAAK;AAAA,wBAC5B,WAAW,CAAC,EAAE,SAAS,MACrB;AAAA,0BACE;AAAA,0BACA,WACI,iEACA;AAAA,wBACN;AAAA,wBAGF;AAAA,8CAAC,IAAI,MAAJ,EAAS,WAAU,kDAAiD;AAAA,0BACrE,oBAAC,UAAK,WAAU,oCAAoC,cAAI,OAAM;AAAA;AAAA;AAAA,oBAChE,KAjBO,IAAI,EAkBb,CACD,GACH;AAAA;AAAA;AAAA,cACF;AAAA;AAAA,UACF;AAAA,UACA,SAAS;AAAA,QACX;AAAA;AAAA;AAAA,EACJ;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/shell/app-shell.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useId, useRef, useState } from \"react\";\nimport type { ComponentPropsWithoutRef, ReactNode } from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { Link, NavLink, matchPath, useLocation } from \"react-router\";\nimport { ChevronRight, PanelLeftClose, PanelLeftOpen } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { dirOf, type Direction } from \"../lib/direction\";\nimport { readStored, writeStored } from \"../lib/safe-storage\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { pickLinkRenderer } from \"../components/text-link\";\nimport { useAnchoredRect } from \"../hooks/use-anchored-rect\";\nimport { useEscapeKey } from \"../hooks/use-dismiss\";\nimport { useMediaQuery } from \"../hooks/use-media-query\";\nimport { DEFAULT_APP_SHELL_LABELS, useKitLabels, useKitLink } from \"../i18n/kit-labels\";\nimport type { KitLinkComponent, KitLinkProps } from \"../i18n/kit-labels\";\n\nexport interface AppShellSubItem {\n  to: string;\n  label: string;\n  icon: LucideIcon;\n  /** Passed to NavLink's `end` (exact match). Defaults to true. */\n  end?: boolean;\n}\n\nexport interface AppShellNavItem {\n  to: string;\n  label: string;\n  /** Optional shorter label for the MOBILE BOTTOM BAR only (the sidebar, its\n   *  tooltips and any palette built on this list keep `label`).\n   *\n   *  The bar divides the viewport into `nav.length` equal cells, so a label's room\n   *  shrinks with every entry added — at six entries on a 406 px phone that is ~67 px,\n   *  and \"Import & Export\" wrapped to two lines and pushed the row taller than its\n   *  neighbours (keksdose feedback live #210). A per-item override is better than\n   *  shortening the real label, which the sidebar has ample room for and which is the\n   *  name the rest of the product uses. */\n  shortLabel?: string;\n  icon: LucideIcon;\n  /** Passed to NavLink's `end` (exact match). Defaults to true. */\n  end?: boolean;\n  /** Optional `data-tour` value rendered on this item's link (both the desktop\n   *  sidebar and the mobile bottom bar), so a guided tour can spotlight ONE nav\n   *  entry precisely instead of matching by href (feedback #338). */\n  dataTour?: string;\n  /** Optional sub-items. When present, hovering (or focusing) the item opens a\n   *  flyout to the right of the sidebar with a header (this item's label) and the\n   *  sub-items as icon + title links. Works collapsed or expanded; the mobile\n   *  bottom bar ignores sub-items and links to `to`. */\n  items?: AppShellSubItem[];\n}\n\n/**\n * One entry of the sidebar's bottom area ({@link AppShellProps.sidebarFooterItems}) —\n * the version link and the legal links kastlan hand-built in `sidebarFooter`.\n *\n * - `link` (default): one link. Expanded it shows `icon` + `text` (default `label`),\n *   with `hint` as a tooltip if given; collapsed it is the icon alone, named and\n *   tooltipped by `label`.\n * - `links`: a small group — the legal links. Expanded, a `<nav>` named `label` holding\n *   the links as a wrapping row of small text; collapsed, ONE icon link to `to` (default\n *   the first link's), named and tooltipped by `label`, since a column of icons for\n *   \"Imprint\", \"Privacy\" and \"Terms\" would say nothing an icon can.\n */\nexport type AppShellSidebarFooterItem =\n  | {\n      kind?: \"link\";\n      key: string;\n      to: string;\n      icon: LucideIcon;\n      /** The link's name, and the tooltip when collapsed (\"What's new · v1.4.0\"). */\n      label: string;\n      /** Visible text when expanded (\"Kastlan v1.4.0\"). Default `label`. */\n      text?: ReactNode;\n      /** A tooltip on the expanded link (\"What's new\"). */\n      hint?: string;\n      /** Leaves the app: a plain `<a target=\"_blank\" rel=\"noopener noreferrer\">`. */\n      external?: boolean;\n    }\n  | {\n      kind: \"links\";\n      key: string;\n      icon: LucideIcon;\n      /** The group's name — its `<nav>` label, and the collapsed icon's name (\"Legal\"). */\n      label: string;\n      /** The collapsed icon's target. Default the first link's `to`. */\n      to?: string;\n      links: { to: string; label: string; external?: boolean }[];\n    };\n\n/**\n * Exported and `<div>`-shaped. This is the outermost element of every consuming app, so\n * there is nothing above it to hang an id, a landmark label or a `data-tour` anchor on —\n * and nothing a consumer can wrap it in either, since the root owns the `h-dvh` and\n * `overflow-hidden` the whole layout is built on (audit §api-design).\n */\nexport interface AppShellProps extends ComponentPropsWithoutRef<\"div\"> {\n  /** Navigation entries — shared by the desktop sidebar and mobile bottom bar. */\n  nav: AppShellNavItem[];\n  /** The composed top bar (e.g. the shared TopBar with app-owned actions). */\n  topBar: ReactNode;\n  /** Main content — typically the router `<Outlet />`. */\n  children: ReactNode;\n  /** Desktop-only footer rendered below the content (hidden on mobile). */\n  footer?: ReactNode;\n  /** Extra sidebar content above the collapse toggle (e.g. a version link).\n   *  Receives the collapsed state so it can render compact vs. full. */\n  sidebarFooter?: (collapsed: boolean) => ReactNode;\n  /** The sidebar's bottom area as data — a version link, the legal links — drawn full\n   *  when expanded and as icon + tooltip when collapsed. Rendered above\n   *  `sidebarFooter`, which stays for anything the data cannot describe. */\n  sidebarFooterItems?: AppShellSidebarFooterItem[];\n  /** The router link for `sidebarFooterItems`. Default: the provider's\n   *  `linkComponent`, else react-router's `Link`. */\n  renderLink?: KitLinkComponent;\n  /** localStorage key for the persisted collapse state. */\n  collapseStorageKey?: string;\n  /** Default: `appShell.collapse` from the {@link UiKitProvider}, else English. */\n  collapseLabel?: string;\n  /** Default: `appShell.expand` from the {@link UiKitProvider}, else English. */\n  expandLabel?: string;\n  /** How an entry's `items` are revealed in the EXPANDED desktop sidebar.\n   *\n   *  - `\"flyout\"` (default) — a panel beside the sidebar on hover/focus. Compact: the\n   *    sidebar stays one row per group however many pages a group holds.\n   *  - `\"inline\"` — a disclosure under the entry, the pattern of MUI's nested List and\n   *    most documentation sites. Every page is visible at once, and the group holding\n   *    the current page opens on its own, so the reader can see where they are without\n   *    hovering anything.\n   *\n   *  The icon-only (collapsed) sidebar always uses the flyout: an indented list has no\n   *  room there. The mobile bottom bar ignores `items` in both modes. */\n  subNav?: \"flyout\" | \"inline\";\n  /** Accessible name of the inline disclosure button, given the group's label.\n   *  Only used with `subNav=\"inline\"`. Its expanded state is carried by\n   *  `aria-expanded`, so one wording serves both directions. Default:\n   *  `appShell.toggleGroup` from the {@link UiKitProvider}, else English. */\n  toggleGroupLabel?: (groupLabel: string) => string;\n  /** Below `md`: show the current group's `items` as a scrollable row above the\n   *  bottom bar — the phone's counterpart of the sidebar's second level. Default true;\n   *  `false` keeps the single bar, where a group entry only links to its own `to`. */\n  mobileSubNav?: boolean;\n  /**\n   * Lay the shell out inside its PARENT'S box instead of the viewport: `h-full` rather\n   * than `h-dvh`, its own scroll container at every width, a bottom bar pinned to the\n   * shell rather than the window, `--app-nav-h` published on the shell alone, and no\n   * persisted collapse state unless `collapseStorageKey` is passed. For an app preview,\n   * a device frame, a docs example.\n   *\n   * Implied for a shell rendered inside another AppShell, which is the case this\n   * exists for: the inner one used to publish its own nav height on `<html>`, fight\n   * the outer one over it, and remove it on unmount from under the outer app.\n   */\n  embedded?: boolean;\n}\n\n/** True below an AppShell — how a nested shell knows it is one. */\nconst AppShellNesting = createContext(false);\n\n/**\n * The bottom nav's own height, published as `--app-nav-h` so anything that has to sit\n * ON it can stop guessing.\n *\n * Keksdose live #314 is what this is for. Its rework — *\"Stick it to the bottom\n * touching the bottom icon bar with budget, accounts, … Currently there is a small gap\n * which confuses\"* — was a receipt footer pinned at `bottom-20`, because `<main>`\n * reserves `pb-20` for this nav and 20 looked like the nav's height. It is not: the\n * padding is generous CLEARANCE, and the nav is content-sized (icon + label + `py-2`,\n * about 56px), so the footer floated ~24px above the bar.\n *\n * Measured rather than named, because the height is not a constant anyone owns: it is\n * an icon, a translated label that can wrap or truncate, and whatever the platform does\n * with the safe-area inset. A hard-coded `bottom-14` would be the same guess one number\n * lower, and it would be wrong again the first time a label needed two lines.\n *\n * `0px` when the nav is not rendered — above `md` it is `display:none`, which observes\n * as a zero box — so a consumer can write `bottom-[var(--app-nav-h,0px)]` once and get\n * the right answer at both widths without a breakpoint of its own.\n */\nfunction useNavHeightVar(\n  ref: React.RefObject<HTMLElement | null>,\n  shellRef: React.RefObject<HTMLElement | null>,\n  embedded: boolean,\n): void {\n  // Re-run when the breakpoint flips. A ResizeObserver SKIPS an element that is not\n  // being rendered, so the nav going `display:none` above `md` fires no callback and\n  // would leave the last phone height published — a desktop footer would then sit 56px\n  // off the bottom after a live resize. The query is the one the nav's own `md:hidden`\n  // compiles to, so the two cannot disagree about where the boundary is.\n  const isMdUp = useMediaQuery(\"(min-width: 768px)\", false);\n  useEffect(() => {\n    const node = ref.current;\n    const shell = shellRef.current;\n    // Always on the shell's own root, so everything inside it — a nested shell's\n    // content included — reads the nearest bar's height. On <html> as well only for\n    // the OUTERMOST shell, for what it portals to <body> (a sheet docking on the bar).\n    // The DOM check backs up the context for a shell mounted in a separate React root.\n    const global = !embedded && !shell?.parentElement?.closest(\"[data-app-shell]\");\n    const targets = [shell, global ? document.documentElement : null].filter(\n      (el): el is HTMLElement => el !== null,\n    );\n    // `getBoundingClientRect().height`, rounded DOWN — not `offsetHeight`, and not\n    // ceil. Measured on the running app at 406x816: the bar is **55.5px** tall, and\n    // both `offsetHeight` and `Math.ceil` answer 56. That is why live #314 round four\n    // was *\"No change. Still a pixel inbetween\"* — the previous fix was arithmetically\n    // a no-op on the very value it was meant to correct.\n    //\n    // 56 is the wrong side. A sticky element with `bottom: X` puts its bottom edge X\n    // above the viewport bottom, and the bar's TOP edge is at its own height: so\n    // X = 56 lands the footer at y=760.0 against a bar starting at y=760.5, i.e. half\n    // a CSS pixel of page showing through — about 1.4 device pixels on his phone,\n    // which is exactly the hairline in the screenshot.\n    //\n    // The two errors are not symmetric, and I had them backwards the first time.\n    // Too SMALL tucks the sticky element under a bar that is opaque and painted above\n    // it (`z-30` against `z-10`): invisible. Too LARGE opens the seam. So floor, and\n    // consumers subtract a further pixel (see `invoice-line-totals.tsx`) for the case\n    // where the height lands on a whole pixel and floor leaves no overlap at all.\n    const publish = () => {\n      const value = `${node ? Math.floor(node.getBoundingClientRect().height) : 0}px`;\n      for (const el of targets) el.style.setProperty(\"--app-nav-h\", value);\n    };\n    publish();\n    // The observer is the refinement, not the mechanism: `publish()` above is already\n    // right for a static nav, and jsdom has no ResizeObserver unless a test stubs one.\n    // ONE cleanup for every branch, though — an early `return` on the no-observer path\n    // left the variable behind on unmount, which a stale `bottom:` offset on whatever\n    // rendered next would have inherited.\n    const ro = node && typeof ResizeObserver !== \"undefined\" ? new ResizeObserver(publish) : null;\n    if (ro && node) ro.observe(node);\n    return () => {\n      ro?.disconnect();\n      for (const el of targets) el.style.removeProperty(\"--app-nav-h\");\n    };\n  }, [ref, shellRef, embedded, isMdUp]);\n}\n\n/**\n * The responsive application shell: a top bar, a collapsible desktop sidebar\n * (icon-only when collapsed, with tooltips), a mobile bottom nav bar, the main\n * content area, and an optional desktop footer. Router-aware via react-router\n * `NavLink`; domain-free — nav items, brand, footer and the top bar's actions\n * are all supplied by the app.\n */\nexport function AppShell({\n  nav,\n  topBar,\n  children,\n  footer,\n  sidebarFooter,\n  sidebarFooterItems,\n  renderLink,\n  collapseStorageKey: collapseStorageKeyProp,\n  collapseLabel,\n  expandLabel,\n  subNav = \"flyout\",\n  mobileSubNav = true,\n  toggleGroupLabel,\n  embedded: embeddedProp,\n  className,\n  ...rest\n}: AppShellProps) {\n  const embedded = useContext(AppShellNesting) || !!embeddedProp;\n  // An embedded shell sharing the default key would overwrite the outer app's sidebar\n  // preference with its own — so it persists only when given a key of its own.\n  const collapseStorageKey =\n    collapseStorageKeyProp ?? (embedded ? null : \"appLayout.sidebarCollapsed\");\n  // The three props are per-shell overrides of the provider's `appShell`; one left\n  // undefined falls through to the provider rather than to English.\n  const labels = useKitLabels(\"appShell\", DEFAULT_APP_SHELL_LABELS, {\n    collapse: collapseLabel,\n    expand: expandLabel,\n    toggleGroup: toggleGroupLabel,\n  });\n  // Through the guarded helpers, not `window.localStorage` directly. The read runs\n  // inside a `useState` initialiser — i.e. during render of the top-level shell — and\n  // `localStorage` THROWS where site data is blocked (Safari private browsing, a\n  // partitioned webview). Unguarded, that was not a lost sidebar preference: nothing\n  // in the application mounted at all.\n  const [collapsed, setCollapsed] = useState(\n    () => collapseStorageKey !== null && readStored(collapseStorageKey) === \"1\",\n  );\n  // The inline sidebar is an ACCORDION: one group open at a time, keyed by its `to`.\n  // Held here rather than per group so opening one can close the other — two lists\n  // open at once pushed every entry below them off a laptop screen.\n  const [openGroup, setOpenGroup] = useState<string | null>(null);\n  // Publishes `--app-nav-h` for anything that has to sit on the bottom bar.\n  const navRef = useRef<HTMLDivElement>(null);\n  const rootRef = useRef<HTMLDivElement>(null);\n  useNavHeightVar(navRef, rootRef, embedded);\n  useEffect(() => {\n    if (collapseStorageKey !== null) writeStored(collapseStorageKey, collapsed ? \"1\" : \"0\");\n  }, [collapsed, collapseStorageKey]);\n\n  return (\n    // The caller's attributes go on the shell's own root, never on the `data-tour=\"nav\"`\n    // wrappers below — those are the kit's anchors for its own guided tour (#313/#322),\n    // and a second element answering to the same selector is a tour that highlights the\n    // wrong thing or nothing at all.\n    <AppShellNesting.Provider value={true}>\n      <div\n        {...rest}\n        ref={rootRef}\n        data-app-shell=\"\"\n        className={cn(\n          \"relative flex flex-col\",\n          embedded\n            ? // `contain: layout` makes this box the containing block for the `fixed`\n              // bottom bar below, so it pins to the shell rather than to the window.\n              \"h-full min-h-0 overflow-hidden [contain:layout]\"\n            : \"min-h-screen md:h-dvh md:overflow-hidden\",\n          className,\n        )}\n      >\n        {topBar}\n        <div className=\"flex flex-1 min-h-0\">\n          <aside\n            className={cn(\n              // `border-e`: the sidebar sits at the START, which is the right in RTL.\n              \"hidden md:flex md:flex-col border-e border-[var(--border)] bg-[var(--bg-surface)] transition-[width] duration-200 ease-out overflow-hidden\",\n              // Embedded, the row it sits in is already the shell's height; the sticky\n              // offsets below are measured against the window's top bar.\n              embedded ? \"md:self-stretch\" : \"md:sticky md:top-12 md:self-start md:h-[calc(100vh-3rem)]\",\n              collapsed ? \"md:w-14\" : \"md:w-60\",\n            )}\n          >\n            {/* The `<nav>` is flex-1 so it fills the sidebar's height (with empty\n                space below the items); the data-tour marker goes on the INNER,\n                fit-content wrapper so the guided-tour spotlight hugs the actual nav\n                items instead of the whole tall column (feedback #322). The marker\n                also tags the mobile bottom bar below; the tour targets\n                `[data-tour=\"nav\"]` and resolves to whichever is visible (#313). */}\n            <nav className=\"flex-1 px-2 py-3 overflow-y-auto overflow-x-hidden\">\n              <div data-tour=\"nav\" className=\"space-y-1\">\n                {nav.map((item) => (\n                  <SidebarNavItem\n                    key={item.to}\n                    item={item}\n                    collapsed={collapsed}\n                    inline={subNav === \"inline\"}\n                    toggleGroupLabel={labels.toggleGroup}\n                    openGroup={openGroup}\n                    setOpenGroup={setOpenGroup}\n                  />\n                ))}\n              </div>\n            </nav>\n            {!!sidebarFooterItems?.length && (\n              <SidebarFooterItems items={sidebarFooterItems} collapsed={collapsed} renderLink={renderLink} />\n            )}\n            {sidebarFooter?.(collapsed)}\n            <div className=\"border-t border-[var(--border)] p-2\">\n              {collapsed ? (\n                <Tooltip label={labels.expand} side=\"end\" portal className=\"block\">\n                  <button\n                    type=\"button\"\n                    onClick={() => setCollapsed(false)}\n                    aria-label={labels.expand}\n                    className=\"flex w-full items-center justify-center min-h-9 rounded-md text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\"\n                  >\n                    <PanelLeftOpen className=\"size-4 shrink-0 rtl:-scale-x-100\" />\n                  </button>\n                </Tooltip>\n              ) : (\n                <button\n                  type=\"button\"\n                  onClick={() => setCollapsed(true)}\n                  aria-label={labels.collapse}\n                  className=\"flex w-full items-center gap-3 min-h-9 px-3 py-2 rounded-md text-sm text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\"\n                >\n                  <PanelLeftClose className=\"size-4 shrink-0 rtl:-scale-x-100\" />\n                  <span className=\"truncate\">{labels.collapse}</span>\n                </button>\n              )}\n            </div>\n          </aside>\n\n          {/* Content column beside the sidebar. main grows to fill so the footer\n              sits at the bottom — at the viewport edge when content is short,\n              beside the sidebar rather than under it. */}\n          <div className=\"flex flex-1 flex-col min-w-0 md:min-h-0\">\n            {/* `scrollbar-gutter: stable` reserves the scrollbar's track whether or\n                not it is currently needed. Without it this element — the app's only\n                scroll container from md up — narrows its own client box by the\n                scrollbar width the moment a page's content outgrows it, and widens\n                it again when the next page fits. Every centred `mx-auto` container\n                inside then jumps sideways by half a scrollbar, and any fluid-width\n                content changes width outright. Keksdose feedback #403 caught it as\n                \"slight width increase/decrease\" when switching to the notifications\n                settings section and back: that section is the only one tall enough\n                to scroll. Platform-dependent, which is why it is easy to miss —\n                overlay scrollbars (macOS, most Linux builds) take no layout space,\n                classic ones (Windows) take ~15px.\n\n                `both-edges`, not the bare `stable`: a one-sided reservation keeps the\n                width stable but moves the middle. On a page short enough not to\n                scroll, nothing is painted into the reserved track, so every centred\n                `mx-auto` container sits half a scrollbar left of the optical centre\n                and every full-bleed child stops ~15px short on the right. Keksdose\n                feedback #491 (/settings#data) and #498 (/budgets) both reported it as\n                \"the left boundary looks smaller / cut off compared to the right\" on\n                the one element per page whose frame is a saturated colour — the rose\n                destructive-action cards. Reserving the track on both edges keeps the\n                content centred whether or not the scrollbar is showing. */}\n            {/* `relative` makes <main> the containing block for everything absolutely\n                positioned inside it. Tailwind's `sr-only` is `position:absolute`; with no\n                positioned ancestor it resolves against the INITIAL containing block, is\n                laid out at its offset from the top of the DOCUMENT, and grows\n                `<html>`'s scroll height past the viewport — a second scrollbar beside this\n                one that scrolls into empty space. Guarding it per component (see\n                sr-only-containment.test) could never be complete: any page's own\n                `sr-only` span re-opened it. Here it is closed for every child at once. */}\n            <main\n              className={cn(\n                \"relative flex-1 max-w-full overflow-x-clip pb-[calc(var(--app-nav-h,4rem)+1.5rem)] md:pb-0 md:min-h-0 md:overflow-y-auto md:[scrollbar-gutter:stable_both-edges]\",\n                // Embedded there is no document scroll to lean on below `md` either.\n                embedded && \"min-h-0 overflow-y-auto\",\n              )}\n            >\n              {children}\n            </main>\n            {footer}\n          </div>\n        </div>\n\n        {/* The phone navigation: the group bar, and above it — when the current page\n            belongs to a group with pages of its own — the row of those pages. The pair\n            is the phone's version of the sidebar's two levels; without the upper row a\n            group's `items` were simply unreachable below `md`. ONE measured box, so\n            `--app-nav-h` covers both rows and whatever docks on the bar sits on the\n            whole of it. */}\n        <div\n          ref={navRef}\n          className=\"md:hidden fixed bottom-0 inset-x-0 z-30 border-t border-[var(--border)] bg-[var(--bg-surface)]\"\n        >\n          {mobileSubNav && <MobileSubNav nav={nav} />}\n          <nav\n            data-tour=\"nav\"\n            className=\"grid\"\n            style={{ gridTemplateColumns: `repeat(${nav.length}, minmax(0, 1fr))` }}\n          >\n            {nav.map((item) => (\n              <MobileNavItem key={item.to} item={item} />\n            ))}\n          </nav>\n        </div>\n      </div>\n    </AppShellNesting.Provider>\n  );\n}\n\nconst routerLink: KitLinkComponent = ({ href, ...p }) => <Link to={href} {...p} />;\nconst plainLink: KitLinkComponent = ({ children, ...p }) => <a {...p}>{children}</a>;\n\nconst FOOTER_ICON_LINK =\n  \"flex min-h-8 items-center justify-center rounded-md text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\";\n\n/** Calls the link renderer as a component, so a router link's hooks are its own. */\nfunction RenderedLink({ render, ...props }: KitLinkProps & { render: KitLinkComponent }) {\n  return render(props);\n}\n\n/** The sidebar's bottom area, from {@link AppShellSidebarFooterItem}s. */\nfunction SidebarFooterItems({\n  items,\n  collapsed,\n  renderLink,\n}: {\n  items: AppShellSidebarFooterItem[];\n  collapsed: boolean;\n  renderLink?: KitLinkComponent;\n}) {\n  const kitLink = useKitLink();\n  const linkTo = (to: string, external: boolean | undefined, { children, ...props }: Omit<KitLinkProps, \"href\">) => {\n    // The kit's one link rule (`pickLinkRenderer`): an external `to` or an in-page\n    // `#anchor` is a plain `<a>` even without `external`; only `external` opens a tab.\n    const InApp = pickLinkRenderer(renderLink, kitLink ?? routerLink, to) ?? plainLink;\n    return external ? (\n      <a href={to} target=\"_blank\" rel=\"noopener noreferrer\" {...props}>\n        {children}\n      </a>\n    ) : (\n      <RenderedLink render={InApp} href={to} {...props}>\n        {children}\n      </RenderedLink>\n    );\n  };\n\n  return (\n    <div data-slot=\"sidebar-footer-items\" className={cn(\"px-2 py-1\", collapsed ? \"space-y-1\" : \"space-y-1.5\")}>\n      {items.map((item) => {\n        if (collapsed) {\n          const to = item.kind === \"links\" ? (item.to ?? item.links[0]?.to) : item.to;\n          if (!to) return null;\n          const external = item.kind === \"links\" ? item.links.find((l) => l.to === to)?.external : item.external;\n          return (\n            <Tooltip key={item.key} label={item.label} side=\"end\" portal className=\"block\">\n              {linkTo(to, external, {\n                \"aria-label\": item.label,\n                className: FOOTER_ICON_LINK,\n                children: <item.icon className=\"size-4\" aria-hidden />,\n              })}\n            </Tooltip>\n          );\n        }\n        if (item.kind === \"links\") {\n          return (\n            <nav\n              key={item.key}\n              aria-label={item.label}\n              className=\"flex flex-wrap justify-center gap-x-3 gap-y-0.5 text-[11px] text-[var(--text-muted)]\"\n            >\n              {item.links.map((l) => (\n                <span key={l.to}>\n                  {linkTo(l.to, l.external, {\n                    className: \"rounded-sm hover:text-[var(--text-secondary)] hover:underline\",\n                    children: l.label,\n                  })}\n                </span>\n              ))}\n            </nav>\n          );\n        }\n        const link = linkTo(item.to, item.external, {\n          className: cn(FOOTER_ICON_LINK, \"gap-1.5 text-xs font-medium\"),\n          children: (\n            <>\n              <item.icon className=\"size-3.5 shrink-0\" aria-hidden />\n              <span className=\"min-w-0 truncate\">{item.text ?? item.label}</span>\n            </>\n          ),\n        });\n        return item.hint ? (\n          <Tooltip key={item.key} label={item.hint} side=\"top\" portal className=\"block\">\n            {link}\n          </Tooltip>\n        ) : (\n          <div key={item.key}>{link}</div>\n        );\n      })}\n    </div>\n  );\n}\n\n/** One cell of the phone's group bar. Marked while the group's own page OR any of its\n *  pages is current — NavLink alone only knows its own `to`, which left the bar with\n *  nothing marked on every sub-page (the same defect the sidebar had). */\nfunction MobileNavItem({ item }: { item: AppShellNavItem }) {\n  const subActive = useSubItemActive(item);\n  return (\n    <NavLink\n      to={item.to}\n      end={item.end ?? true}\n      data-tour={item.dataTour}\n      className={({ isActive }) =>\n        // The active page needs a clear marker, not just a subtle text\n        // shade (feedback #327): brand-accent icon + label, bolder weight,\n        // and a top accent bar spanning the cell so it reads at a glance.\n        cn(\n          \"relative flex flex-col items-center justify-center py-2 text-[11px] gap-0.5 transition-colors\",\n          \"before:absolute before:content-[''] before:inset-x-4 before:top-0 before:h-0.5 before:rounded-full before:transition-colors\",\n          isActive || subActive\n            ? \"font-semibold text-[var(--brand)] before:bg-[var(--brand)]\"\n            : \"text-[var(--text-muted)] before:bg-transparent\",\n        )\n      }\n    >\n      <span className=\"relative\">\n        <item.icon className=\"size-5\" />\n      </span>\n      {/* One line, always. `truncate` is the backstop for the case a\n          `shortLabel` was not supplied (or a translation is longer than its\n          author expected): an ellipsis in one cell is a far smaller problem\n          than a bar whose rows are different heights. */}\n      <span className=\"max-w-full truncate px-0.5\">{item.shortLabel ?? item.label}</span>\n    </NavLink>\n  );\n}\n\n/**\n * The upper row of the phone navigation: the pages of the group the reader is in, as\n * a sideways-scrolling row of pills. Rendered only while such a group is current —\n * on a page outside every group the bar stays one row, rather than showing an empty\n * shelf or guessing a group.\n *\n * It slides in over 200ms (fade only under reduced motion) and wraps onto more rows\n * rather than scrolling, so every page of the group is in view at once.\n */\nfunction MobileSubNav({ nav }: { nav: AppShellNavItem[] }) {\n  const { pathname } = useLocation();\n  const group = nav.find(\n    (item) =>\n      !!item.items?.length &&\n      (matchPath({ path: item.to, end: item.end ?? true }, pathname) ||\n        item.items.some((sub) => matchPath({ path: sub.to, end: sub.end ?? true }, pathname))),\n  );\n\n  if (!group) return null;\n  return (\n    <nav\n      aria-label={group.label}\n      // Keyed by group so switching groups replays the entrance.\n      key={group.to}\n      className=\"animate-subnav border-b border-[var(--border)]\"\n    >\n      <ul\n        // Wraps onto as many rows as the group needs rather than scrolling sideways: a\n        // sideways row hides pages past the edge, and every page of the group in view\n        // is the point of the row. The bar grows with it — `--app-nav-h` measures it.\n        className=\"flex flex-wrap gap-1.5 px-3 py-2\"\n      >\n        {group.items!.map((sub) => (\n          <li key={sub.to} className=\"shrink-0\">\n            <NavLink\n              to={sub.to}\n              end={sub.end ?? true}\n              className={({ isActive }) =>\n                cn(\n                  \"flex items-center gap-1.5 rounded-full border px-3 py-1 text-xs transition-colors\",\n                  isActive\n                    ? \"border-[var(--brand)] bg-[var(--brand)] font-medium text-[var(--brand-contrast)]\"\n                    : \"border-[var(--border)] text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\",\n                )\n              }\n            >\n              <sub.icon className=\"size-3.5 shrink-0\" aria-hidden />\n              {sub.label}\n            </NavLink>\n          </li>\n        ))}\n      </ul>\n    </nav>\n  );\n}\n\n/** `strong` is the current page; `trail` is the group that CONTAINS the current page\n *  while the page itself is shown elsewhere (the inline list below it). */\nconst navLinkClass = (collapsed: boolean, forceActive: boolean, trail = false) =>\n  ({ isActive }: { isActive: boolean }) =>\n    `flex items-center gap-3 min-h-9 ${collapsed ? \"justify-center px-2\" : \"px-3\"} py-2 rounded-md text-sm transition-colors duration-150 ${\n      isActive || (forceActive && !trail)\n        ? \"bg-[var(--bg-inverse)] text-[var(--text-inverse)]\"\n        : forceActive\n          ? \"font-medium text-[var(--text-primary)] hover:bg-[var(--bg-hover)]\"\n          : \"text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\"\n    }`;\n\n/** Whether any of an entry's sub-items is the current route. NavLink only knows about\n *  its OWN `to`, so without this a group whose pages live at sibling paths\n *  (`/fields`, `/numbers`, …) lost its highlight the moment the reader left the one\n *  page the group linked to — the sidebar then marked nothing at all, and the only\n *  \"you are here\" left was inside a flyout that is closed unless hovered. */\nfunction useSubItemActive(item: AppShellNavItem): boolean {\n  const { pathname } = useLocation();\n  return !!item.items?.some((sub) => matchPath({ path: sub.to, end: sub.end ?? true }, pathname));\n}\n\n/** A single desktop sidebar entry. Plain link (with a tooltip when collapsed) —\n *  unless it has sub-items, in which case hovering/focusing opens a flyout, or (with\n *  `inline`) a disclosure lists them underneath. */\nfunction SidebarNavItem({\n  item,\n  collapsed,\n  inline,\n  toggleGroupLabel,\n  openGroup,\n  setOpenGroup,\n}: {\n  item: AppShellNavItem;\n  collapsed: boolean;\n  inline: boolean;\n  toggleGroupLabel: (groupLabel: string) => string;\n  openGroup: string | null;\n  setOpenGroup: (to: string | null) => void;\n}) {\n  const hasSub = !!item.items?.length;\n  const subActive = useSubItemActive(item);\n\n  // In the EXPANDED sidebar a group is one component in both styles, so switching\n  // between them is a transition of the same element (the page list folding away or\n  // unfolding) rather than one tree replaced by another. The icon-only sidebar keeps\n  // the plain flyout below: an indented list has no room there.\n  if (hasSub && !collapsed) {\n    return (\n      <SidebarGroup\n        item={item}\n        subActive={subActive}\n        inline={inline}\n        toggleGroupLabel={toggleGroupLabel}\n        open={openGroup === item.to}\n        setOpenGroup={setOpenGroup}\n      />\n    );\n  }\n\n  const link = (\n    <NavLink\n      to={item.to}\n      end={item.end ?? true}\n      data-tour={item.dataTour}\n      className={navLinkClass(collapsed, subActive)}\n      aria-haspopup={hasSub ? \"menu\" : undefined}\n    >\n      <span className=\"relative shrink-0\">\n        <item.icon className=\"size-4\" />\n      </span>\n      {/* Wraps rather than truncates: in the sidebar a label cut to \"Checkbox, switch\n          & sl…\" hides the one word that tells two pages apart, and there is height\n          to spare. (The phone bar keeps `truncate` — its cells must stay one row.) */}\n      {!collapsed && <span className=\"min-w-0 flex-1 break-words leading-snug\">{item.label}</span>}\n      {!collapsed && hasSub && <ChevronRight className=\"size-3.5 shrink-0 opacity-60 rtl:-scale-x-100\" />}\n    </NavLink>\n  );\n\n  if (hasSub) return <SidebarFlyout item={item}>{link}</SidebarFlyout>;\n  return collapsed ? (\n    <Tooltip label={item.label} side=\"end\" portal className=\"block\">\n      {link}\n    </Tooltip>\n  ) : (\n    link\n  );\n}\n\n/**\n * An entry with sub-items in the expanded sidebar.\n *\n * - `inline`: the entry's own link (its overview page) plus a chevron button that\n *   shows or hides the sub-items indented beneath it. Two controls rather than one\n *   because they do two different things — a row that both navigated AND toggled\n *   would make \"open the overview\" and \"peek at the pages\" the same click.\n * - flyout: the link alone, with the sub-items in a panel beside the sidebar on\n *   hover/focus. The inline list is still rendered, folded shut, so that switching\n *   styles animates it rather than swapping it.\n *\n * THE FOLD is a `grid-template-rows` transition from `0fr` to `1fr` — the one way to\n * animate to a content-sized height without measuring it, so a translated label that\n * wraps to two lines unfolds exactly as far as it needs. `visibility` rides the same\n * transition so a shut list drops out of the accessibility tree only once it has\n * finished closing, and `inert` takes its links out of the tab order immediately.\n */\nfunction SidebarGroup({\n  item,\n  subActive,\n  inline,\n  toggleGroupLabel,\n  open,\n  setOpenGroup,\n}: {\n  item: AppShellNavItem;\n  subActive: boolean;\n  inline: boolean;\n  toggleGroupLabel: (groupLabel: string) => string;\n  /** Whether this is the sidebar's one open group (see AppShell's `openGroup`). */\n  open: boolean;\n  setOpenGroup: (to: string | null) => void;\n}) {\n  const listId = useId();\n  const { pathname } = useLocation();\n  const onOwnPage = !!matchPath({ path: item.to, end: item.end ?? true }, pathname);\n  // Opening follows the reader: arriving on this group's overview or one of its pages\n  // (by link, by the pager, by Back) opens it — and, the sidebar holding ONE open\n  // group, closes whichever was open before. Both folds run at once, so the eye sees\n  // one list hand over to the other. Run in an effect after mount, so the current\n  // group UNFOLDS into view on load rather than appearing already open.\n  const here = subActive || onOwnPage;\n  useEffect(() => {\n    if (here) setOpenGroup(item.to);\n  }, [here, item.to, setOpenGroup]);\n  const expanded = inline && open;\n\n  const link = (\n    <NavLink\n      to={item.to}\n      end={item.end ?? true}\n      data-tour={item.dataTour}\n      aria-haspopup={inline ? undefined : \"menu\"}\n      // `trail` (inline only): while a page of the group is current, the group row is\n      // the breadcrumb, not the destination — the page's own row below carries the\n      // strong marker, and two inverse rows would say \"you are here\" twice. In the\n      // flyout style the pages are out of sight, so the group row IS the marker.\n      className={(state) => cn(navLinkClass(false, subActive, inline)(state), \"min-w-0 flex-1\")}\n    >\n      <span className=\"relative shrink-0\">\n        <item.icon className=\"size-4\" />\n      </span>\n      <span className=\"min-w-0 flex-1 break-words leading-snug\">{item.label}</span>\n      {!inline && <ChevronRight className=\"size-3.5 shrink-0 opacity-60 rtl:-scale-x-100\" />}\n    </NavLink>\n  );\n\n  return (\n    <div>\n      {inline ? (\n        <div className=\"flex items-center gap-0.5\">\n          {link}\n          <button\n            type=\"button\"\n            aria-expanded={open}\n            aria-controls={listId}\n            aria-label={toggleGroupLabel(item.label)}\n            onClick={() => setOpenGroup(open ? null : item.to)}\n            className=\"flex size-9 shrink-0 items-center justify-center rounded-md text-[var(--text-muted)] hover:bg-[var(--bg-hover)] hover:text-[var(--text-secondary)]\"\n          >\n            <ChevronRight\n              aria-hidden\n              className={cn(\n                \"size-3.5 transition-transform duration-200 ease-out motion-reduce:transition-none rtl:-scale-x-100\",\n                // Under dir=\"rtl\" the chevron is MIRRORED first (scale applies before rotate), so\n                // it starts pointing left and a +90° turn would point it UP — hence −90° there.\n                open && \"rotate-90 rtl:-rotate-90\",\n              )}\n            />\n          </button>\n        </div>\n      ) : (\n        <SidebarFlyout item={item}>{link}</SidebarFlyout>\n      )}\n      <div\n        id={listId}\n        inert={!expanded}\n        className=\"grid transition-[grid-template-rows,visibility] duration-200 ease-out motion-reduce:transition-none\"\n        style={{\n          gridTemplateRows: expanded ? \"1fr\" : \"0fr\",\n          visibility: expanded ? \"visible\" : \"hidden\",\n        }}\n      >\n        <div\n          className={cn(\n            \"min-h-0 overflow-hidden transition-opacity duration-200 ease-out motion-reduce:transition-none\",\n            expanded ? \"opacity-100\" : \"opacity-0\",\n          )}\n        >\n          {/* The rule and indent live on the list INSIDE the clipping box: margin or\n              padding on the element whose row is collapsing to 0fr would hold it open\n              by that much. */}\n          <ul className=\"ms-[1.3rem] mt-0.5 space-y-0.5 border-s border-[var(--border)] ps-2\">\n            {item.items!.map((sub) => (\n              <li key={sub.to}>\n                <NavLink\n                  to={sub.to}\n                  end={sub.end ?? true}\n                  className={({ isActive }) =>\n                    cn(\n                      \"flex min-h-8 items-center gap-2.5 rounded-md px-2.5 py-1.5 text-sm transition-colors\",\n                      isActive\n                        ? \"bg-[var(--bg-inverse)] text-[var(--text-inverse)]\"\n                        : \"text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\",\n                    )\n                  }\n                >\n                  <sub.icon className=\"size-4 shrink-0 opacity-70\" aria-hidden />\n                  <span className=\"min-w-0 break-words leading-snug\">{sub.label}</span>\n                </NavLink>\n              </li>\n            ))}\n          </ul>\n        </div>\n      </div>\n    </div>\n  );\n}\n\n// Only ONE sidebar flyout should be on screen at a time. Each open flyout parks its\n// \"close now\" here so the next item to open can dismiss it immediately, instead of\n// leaving the previous panel up for the 140ms travel delay while the cursor moves\n// down the nav list — which showed two panels at once.\nlet activeFlyoutClose: (() => void) | null = null;\n\n/**\n * Wraps a nav item that has sub-items: on hover or keyboard focus it opens a\n * portalled flyout to the right of the sidebar (portalled so the sidebar's\n * `overflow-hidden` can't clip it) with the item's label as a header and each\n * sub-item as an icon + title link. A short close delay lets the cursor travel\n * from the item onto the panel; Escape / outside-move close it.\n */\nfunction SidebarFlyout({ item, children }: { item: AppShellNavItem; children: ReactNode }) {\n  const wrapperRef = useRef<HTMLDivElement>(null);\n  const closeTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const [open, setOpen] = useState(false);\n  // The flyout is portalled out of the subtree whose `dir` it inherited; read on open.\n  const [dir, setDir] = useState<Direction>(\"ltr\");\n\n  // Anchor the flyout to the item's END edge — its right, or its left in RTL, where\n  // the sidebar sits on the right of the window. The hook re-measures on\n  // scroll/resize (the nav list can scroll).\n  const rect = useAnchoredRect(wrapperRef, open);\n  const pos = rect\n    ? dir === \"rtl\"\n      ? { top: rect.top, right: window.innerWidth - rect.left }\n      : { top: rect.top, left: rect.right }\n    : null;\n\n  const cancelClose = useCallback(() => {\n    if (closeTimer.current) {\n      clearTimeout(closeTimer.current);\n      closeTimer.current = null;\n    }\n  }, []);\n  // Stable identity: the coordinator above holds this so a sibling item can close\n  // THIS flyout without waiting out its travel delay.\n  const closeNow = useCallback(() => {\n    cancelClose();\n    setOpen(false);\n  }, [cancelClose]);\n  const openMenu = useCallback(() => {\n    cancelClose();\n    if (activeFlyoutClose && activeFlyoutClose !== closeNow) activeFlyoutClose();\n    activeFlyoutClose = closeNow;\n    setDir(dirOf(wrapperRef.current));\n    setOpen(true);\n  }, [cancelClose, closeNow]);\n  const scheduleClose = useCallback(() => {\n    cancelClose();\n    closeTimer.current = setTimeout(() => {\n      setOpen(false);\n      if (activeFlyoutClose === closeNow) activeFlyoutClose = null;\n    }, 140);\n  }, [cancelClose, closeNow]);\n\n  // Close on Escape while open.\n  useEscapeKey(() => setOpen(false), open);\n\n  useEffect(\n    () => () => {\n      cancelClose();\n      if (activeFlyoutClose === closeNow) activeFlyoutClose = null;\n    },\n    [cancelClose, closeNow],\n  );\n\n  return (\n    // Not a control: hover and focus-within on the nav link inside. Focus (the\n    // keyboard path) opens it exactly as hover does, Escape closes it.\n    // eslint-disable-next-line jsx-a11y/no-static-element-interactions -- hover/focus-within wrapper around a real link\n    <div\n      ref={wrapperRef}\n      className=\"relative\"\n      onMouseEnter={openMenu}\n      onMouseLeave={scheduleClose}\n      onFocus={openMenu}\n      onBlur={scheduleClose}\n    >\n      {children}\n      {open &&\n        pos &&\n        createPortal(\n          // Keeps the flyout open while the pointer crosses into it; keyboard users\n          // reach it by focus, which the wrapper above already handles.\n          // eslint-disable-next-line jsx-a11y/no-static-element-interactions -- pointer-only hover bridge\n          <div\n            dir={dir}\n            style={{ position: \"fixed\", ...pos }}\n            className=\"z-40 ps-1\"\n            onMouseEnter={cancelClose}\n            onMouseLeave={scheduleClose}\n          >\n            <div\n              role=\"menu\"\n              aria-label={item.label}\n              className=\"animate-flyout min-w-52 overflow-hidden rounded-md border border-[var(--border)] bg-[var(--bg-surface)] shadow-lg\"\n            >\n              <div className=\"border-b border-[var(--border)] px-3 py-2 text-[11px] font-semibold uppercase tracking-wide text-[var(--text-muted)]\">\n                {item.label}\n              </div>\n              <ul className=\"py-1\">\n                {item.items!.map((sub) => (\n                  <li key={sub.to}>\n                    <NavLink\n                      to={sub.to}\n                      end={sub.end ?? true}\n                      role=\"menuitem\"\n                      onClick={() => setOpen(false)}\n                      className={({ isActive }) =>\n                        cn(\n                          \"flex items-center gap-2.5 px-3 py-2 text-sm\",\n                          isActive\n                            ? \"bg-[var(--bg-active)] font-medium text-[var(--text-primary)]\"\n                            : \"text-[var(--text-secondary)] hover:bg-[var(--bg-hover)]\",\n                        )\n                      }\n                    >\n                      <sub.icon className=\"size-4 shrink-0 text-[var(--text-placeholder)]\" />\n                      <span className=\"min-w-0 break-words leading-snug\">{sub.label}</span>\n                    </NavLink>\n                  </li>\n                ))}\n              </ul>\n            </div>\n          </div>,\n          document.body,\n        )}\n    </div>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/shell/auth-layout.d.ts

@@ -0,0 +1,74 @@
+import * as react from 'react';
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+
+/**
+ * `extends ComponentPropsWithoutRef<"div">` because this is the page's outermost element
+ * — the one that owns `min-h-dvh` and the safe-area padding — so there is nothing a
+ * consumer could wrap it in to add an id or a `data-*` hook without breaking that.
+ */
+interface AuthLayoutProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
+    /** The brand mark (an SVG), drawn in a brand-coloured tile above the title. */
+    logo?: ReactNode;
+    /** `false` draws `logo` as it is, without the tile — for a full-colour logo image. */
+    logoTile?: boolean;
+    /** The page's `<h1>` (see `headingAs`): the product name on sign-in, "Verify email",
+     *  "Imprint". */
+    title?: ReactNode;
+    /** The muted line under the title. */
+    description?: ReactNode;
+    /** The card's content — the form, the status, the legal text. */
+    children: ReactNode;
+    /**
+     * Above the header, outside the card — the legal pages' "← Back to sign in" link, or
+     * a notice banner. Start-aligned in both widths.
+     */
+    back?: ReactNode;
+    /** The top-end corner: a `LanguageMenu`. */
+    languageMenu?: ReactNode;
+    /** The top-end corner, before the language menu: a `ThemeToggle`. */
+    themeToggle?: ReactNode;
+    /** Below the card, centred — the legal links. */
+    footer?: ReactNode;
+    /** Wraps the footer in a `<nav>` with this name ("Legal"). Without it, a plain block. */
+    footerLabel?: string;
+    /**
+     * - `"narrow"` (default) — a `max-w-sm` card centred on the page, header centred:
+     *   sign-in, register, verify email, two-factor.
+     * - `"wide"` — a `max-w-3xl` column from the top of the page, header start-aligned:
+     *   running text (imprint, privacy, terms), which reads badly centred.
+     */
+    width?: "narrow" | "wide";
+    /** `false` lays the header and content on the page itself, without the card's
+     *  surface and border — the legal pages. Default true. */
+    card?: boolean;
+    /** Extra classes for the card (or, with `card={false}`, the content column). */
+    cardClassName?: string;
+    /**
+     * `false` draws the content column and the footer as plain `<div>`s instead of
+     * `<main>` and `<footer>` — for an AuthLayout embedded in a page that already has its
+     * landmarks (a preview, a docs page, a dialog), where a second `<main>` would nest
+     * one inside the other. Default `true`: on its own route it IS the page.
+     */
+    landmark?: boolean;
+    /** The title's element. Default `h1` — the page's heading; an embedded layout takes
+     *  the level of where it sits (`h2`, `h3`). */
+    headingAs?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+}
+/**
+ * The public page frame outside the app shell: sign-in, registration, email
+ * verification, two-factor — and, `width="wide"`, the legal pages.
+ *
+ * kastlan's login, register, verify-email and two-factor pages each repeat the same
+ * `min-h-screen` centring, the absolutely placed language switcher, the brand tile, the
+ * centred title + subtitle and an absolutely placed legal footer. Absolutely placed,
+ * the footer and the switcher sat ON the card on a short phone screen (a tall register
+ * form, or the software keyboard up); here they are rows of a column that grows with
+ * its content, so the page scrolls instead of overlapping.
+ *
+ * The corner controls, the `<main>` and the footer are in reading order: a screen
+ * reader meets the language switch first, which is where someone who cannot read the
+ * page's language needs it.
+ */
+declare function AuthLayout({ logo, logoTile, title, description, children, back, languageMenu, themeToggle, footer, footerLabel, width, card, cardClassName, landmark, headingAs: Heading, className, style, ...rest }: AuthLayoutProps): react.JSX.Element;
+
+export { AuthLayout, type AuthLayoutProps };

package/dist/shell/auth-layout.js

@@ -0,0 +1,97 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { cn } from "../lib/cn.js";
+import { Card } from "../components/ui.js";
+const SAFE_AREA = {
+  paddingTop: "max(1rem, env(safe-area-inset-top, 0px))",
+  paddingBottom: "max(1rem, env(safe-area-inset-bottom, 0px))",
+  paddingLeft: "max(1rem, env(safe-area-inset-left, 0px))",
+  paddingRight: "max(1rem, env(safe-area-inset-right, 0px))"
+};
+const FOOTER_CLASS = "flex flex-wrap justify-center gap-x-4 gap-y-1 text-xs text-[var(--text-muted)] [&_a:hover]:text-[var(--text-primary)] [&_a:hover]:underline [&_a]:rounded-sm [&_a:focus-visible]:outline-none [&_a:focus-visible]:ring-2 [&_a:focus-visible]:ring-[var(--brand)]";
+function AuthLayout({
+  logo,
+  logoTile = true,
+  title,
+  description,
+  children,
+  back,
+  languageMenu,
+  themeToggle,
+  footer,
+  footerLabel,
+  width = "narrow",
+  card = true,
+  cardClassName,
+  landmark = true,
+  headingAs: Heading = "h1",
+  className,
+  style,
+  ...rest
+}) {
+  const Main = landmark ? "main" : "div";
+  const Footer = landmark ? "footer" : "div";
+  const wide = width === "wide";
+  const hasCorner = languageMenu != null || themeToggle != null;
+  const hasHeader = logo != null || title != null || description != null;
+  const header = hasHeader && /* @__PURE__ */ jsxs(
+    "div",
+    {
+      "data-slot": "auth-layout-header",
+      className: cn("flex flex-col gap-1.5", wide ? "items-start text-start" : "items-center text-center"),
+      children: [
+        logo != null && (logoTile ? /* @__PURE__ */ jsx("div", { className: "mb-2 flex size-12 items-center justify-center rounded-lg bg-[var(--brand)] text-[var(--brand-contrast)] [&_svg]:size-6", children: logo }) : /* @__PURE__ */ jsx("div", { className: "mb-2", children: logo })),
+        title != null && /* @__PURE__ */ jsx(
+          Heading,
+          {
+            className: cn(
+              "font-semibold leading-tight text-[var(--text-primary)]",
+              wide ? "text-2xl md:text-3xl" : "text-2xl"
+            ),
+            children: title
+          }
+        ),
+        description != null && /* @__PURE__ */ jsx("p", { className: "text-sm text-[var(--text-muted)]", children: description })
+      ]
+    }
+  );
+  const body = /* @__PURE__ */ jsxs(Fragment, { children: [
+    header,
+    /* @__PURE__ */ jsx("div", { className: cn(hasHeader && (wide ? "mt-6" : "mt-5")), children })
+  ] });
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...rest,
+      "data-auth-layout": width,
+      style: { ...SAFE_AREA, ...style },
+      className: cn("flex min-h-dvh flex-col bg-[var(--bg-page)] text-[var(--text-primary)]", className),
+      children: [
+        hasCorner && /* @__PURE__ */ jsxs("div", { "data-slot": "auth-layout-corner", className: "flex items-center justify-end gap-1", children: [
+          themeToggle,
+          languageMenu
+        ] }),
+        /* @__PURE__ */ jsx(
+          Main,
+          {
+            "data-slot": "auth-layout-main",
+            className: cn(
+              // `relative` contains any `sr-only` child (see AppShell's <main>).
+              "relative flex w-full flex-1 flex-col",
+              wide ? "py-6 md:py-10" : "items-center justify-center py-8"
+            ),
+            children: /* @__PURE__ */ jsxs("div", { className: cn("mx-auto w-full", wide ? "max-w-3xl" : "max-w-sm"), children: [
+              back != null && /* @__PURE__ */ jsx("div", { className: "mb-4", children: back }),
+              card ? /* @__PURE__ */ jsx(Card, { className: cn(wide ? "p-6 md:p-8" : "p-6", cardClassName), children: body }) : /* @__PURE__ */ jsx("div", { className: cardClassName, children: body })
+            ] })
+          }
+        ),
+        footer != null && footer !== false && /* @__PURE__ */ jsx(Footer, { "data-slot": "auth-layout-footer", className: "pt-4", children: footerLabel ? /* @__PURE__ */ jsx("nav", { "aria-label": footerLabel, className: FOOTER_CLASS, children: footer }) : /* @__PURE__ */ jsx("div", { className: FOOTER_CLASS, children: footer }) })
+      ]
+    }
+  );
+}
+export {
+  AuthLayout
+};
+//# sourceMappingURL=auth-layout.js.map

package/dist/shell/auth-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/auth-layout.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, CSSProperties, ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { Card } from \"../components/ui\";\n\n/**\n * `extends ComponentPropsWithoutRef<\"div\">` because this is the page's outermost element\n * — the one that owns `min-h-dvh` and the safe-area padding — so there is nothing a\n * consumer could wrap it in to add an id or a `data-*` hook without breaking that.\n */\nexport interface AuthLayoutProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"title\"> {\n  /** The brand mark (an SVG), drawn in a brand-coloured tile above the title. */\n  logo?: ReactNode;\n  /** `false` draws `logo` as it is, without the tile — for a full-colour logo image. */\n  logoTile?: boolean;\n  /** The page's `<h1>` (see `headingAs`): the product name on sign-in, \"Verify email\",\n   *  \"Imprint\". */\n  title?: ReactNode;\n  /** The muted line under the title. */\n  description?: ReactNode;\n  /** The card's content — the form, the status, the legal text. */\n  children: ReactNode;\n  /**\n   * Above the header, outside the card — the legal pages' \"← Back to sign in\" link, or\n   * a notice banner. Start-aligned in both widths.\n   */\n  back?: ReactNode;\n  /** The top-end corner: a `LanguageMenu`. */\n  languageMenu?: ReactNode;\n  /** The top-end corner, before the language menu: a `ThemeToggle`. */\n  themeToggle?: ReactNode;\n  /** Below the card, centred — the legal links. */\n  footer?: ReactNode;\n  /** Wraps the footer in a `<nav>` with this name (\"Legal\"). Without it, a plain block. */\n  footerLabel?: string;\n  /**\n   * - `\"narrow\"` (default) — a `max-w-sm` card centred on the page, header centred:\n   *   sign-in, register, verify email, two-factor.\n   * - `\"wide\"` — a `max-w-3xl` column from the top of the page, header start-aligned:\n   *   running text (imprint, privacy, terms), which reads badly centred.\n   */\n  width?: \"narrow\" | \"wide\";\n  /** `false` lays the header and content on the page itself, without the card's\n   *  surface and border — the legal pages. Default true. */\n  card?: boolean;\n  /** Extra classes for the card (or, with `card={false}`, the content column). */\n  cardClassName?: string;\n  /**\n   * `false` draws the content column and the footer as plain `<div>`s instead of\n   * `<main>` and `<footer>` — for an AuthLayout embedded in a page that already has its\n   * landmarks (a preview, a docs page, a dialog), where a second `<main>` would nest\n   * one inside the other. Default `true`: on its own route it IS the page.\n   */\n  landmark?: boolean;\n  /** The title's element. Default `h1` — the page's heading; an embedded layout takes\n   *  the level of where it sits (`h2`, `h3`). */\n  headingAs?: \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\";\n}\n\n/** Keeps the page clear of a notch, the rounded corners and the home indicator on a\n *  phone in `viewport-fit=cover`; 1rem where the platform reports no inset. Physical\n *  left/right, because that is what `env()` reports. */\nconst SAFE_AREA: CSSProperties = {\n  paddingTop: \"max(1rem, env(safe-area-inset-top, 0px))\",\n  paddingBottom: \"max(1rem, env(safe-area-inset-bottom, 0px))\",\n  paddingLeft: \"max(1rem, env(safe-area-inset-left, 0px))\",\n  paddingRight: \"max(1rem, env(safe-area-inset-right, 0px))\",\n};\n\nconst FOOTER_CLASS =\n  \"flex flex-wrap justify-center gap-x-4 gap-y-1 text-xs text-[var(--text-muted)] [&_a:hover]:text-[var(--text-primary)] [&_a:hover]:underline [&_a]:rounded-sm [&_a:focus-visible]:outline-none [&_a:focus-visible]:ring-2 [&_a:focus-visible]:ring-[var(--brand)]\";\n\n/**\n * The public page frame outside the app shell: sign-in, registration, email\n * verification, two-factor — and, `width=\"wide\"`, the legal pages.\n *\n * kastlan's login, register, verify-email and two-factor pages each repeat the same\n * `min-h-screen` centring, the absolutely placed language switcher, the brand tile, the\n * centred title + subtitle and an absolutely placed legal footer. Absolutely placed,\n * the footer and the switcher sat ON the card on a short phone screen (a tall register\n * form, or the software keyboard up); here they are rows of a column that grows with\n * its content, so the page scrolls instead of overlapping.\n *\n * The corner controls, the `<main>` and the footer are in reading order: a screen\n * reader meets the language switch first, which is where someone who cannot read the\n * page's language needs it.\n */\nexport function AuthLayout({\n  logo,\n  logoTile = true,\n  title,\n  description,\n  children,\n  back,\n  languageMenu,\n  themeToggle,\n  footer,\n  footerLabel,\n  width = \"narrow\",\n  card = true,\n  cardClassName,\n  landmark = true,\n  headingAs: Heading = \"h1\",\n  className,\n  style,\n  ...rest\n}: AuthLayoutProps) {\n  const Main = landmark ? \"main\" : \"div\";\n  const Footer = landmark ? \"footer\" : \"div\";\n  const wide = width === \"wide\";\n  const hasCorner = languageMenu != null || themeToggle != null;\n  const hasHeader = logo != null || title != null || description != null;\n\n  const header = hasHeader && (\n    <div\n      data-slot=\"auth-layout-header\"\n      className={cn(\"flex flex-col gap-1.5\", wide ? \"items-start text-start\" : \"items-center text-center\")}\n    >\n      {logo != null &&\n        (logoTile ? (\n          <div className=\"mb-2 flex size-12 items-center justify-center rounded-lg bg-[var(--brand)] text-[var(--brand-contrast)] [&_svg]:size-6\">\n            {logo}\n          </div>\n        ) : (\n          <div className=\"mb-2\">{logo}</div>\n        ))}\n      {title != null && (\n        <Heading\n          className={cn(\n            \"font-semibold leading-tight text-[var(--text-primary)]\",\n            wide ? \"text-2xl md:text-3xl\" : \"text-2xl\",\n          )}\n        >\n          {title}\n        </Heading>\n      )}\n      {description != null && <p className=\"text-sm text-[var(--text-muted)]\">{description}</p>}\n    </div>\n  );\n\n  const body = (\n    <>\n      {header}\n      <div className={cn(hasHeader && (wide ? \"mt-6\" : \"mt-5\"))}>{children}</div>\n    </>\n  );\n\n  return (\n    <div\n      {...rest}\n      data-auth-layout={width}\n      style={{ ...SAFE_AREA, ...style }}\n      className={cn(\"flex min-h-dvh flex-col bg-[var(--bg-page)] text-[var(--text-primary)]\", className)}\n    >\n      {hasCorner && (\n        <div data-slot=\"auth-layout-corner\" className=\"flex items-center justify-end gap-1\">\n          {themeToggle}\n          {languageMenu}\n        </div>\n      )}\n      <Main\n        data-slot=\"auth-layout-main\"\n        className={cn(\n          // `relative` contains any `sr-only` child (see AppShell's <main>).\n          \"relative flex w-full flex-1 flex-col\",\n          wide ? \"py-6 md:py-10\" : \"items-center justify-center py-8\",\n        )}\n      >\n        <div className={cn(\"mx-auto w-full\", wide ? \"max-w-3xl\" : \"max-w-sm\")}>\n          {back != null && <div className=\"mb-4\">{back}</div>}\n          {card ? (\n            <Card className={cn(wide ? \"p-6 md:p-8\" : \"p-6\", cardClassName)}>{body}</Card>\n          ) : (\n            <div className={cardClassName}>{body}</div>\n          )}\n        </div>\n      </Main>\n      {footer != null && footer !== false && (\n        <Footer data-slot=\"auth-layout-footer\" className=\"pt-4\">\n          {footerLabel ? (\n            <nav aria-label={footerLabel} className={FOOTER_CLASS}>\n              {footer}\n            </nav>\n          ) : (\n            <div className={FOOTER_CLASS}>{footer}</div>\n          )}\n        </Footer>\n      )}\n    </div>\n  );\n}\n"],"mappings":";AAiHI,SA2BA,UArBM,KANN;AAhHJ,SAAS,UAAU;AACnB,SAAS,YAAY;AA2DrB,MAAM,YAA2B;AAAA,EAC/B,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,aAAa;AAAA,EACb,cAAc;AAChB;AAEA,MAAM,eACJ;AAiBK,SAAS,WAAW;AAAA,EACzB;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR,OAAO;AAAA,EACP;AAAA,EACA,WAAW;AAAA,EACX,WAAW,UAAU;AAAA,EACrB;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,OAAO,WAAW,SAAS;AACjC,QAAM,SAAS,WAAW,WAAW;AACrC,QAAM,OAAO,UAAU;AACvB,QAAM,YAAY,gBAAgB,QAAQ,eAAe;AACzD,QAAM,YAAY,QAAQ,QAAQ,SAAS,QAAQ,eAAe;AAElE,QAAM,SAAS,aACb;AAAA,IAAC;AAAA;AAAA,MACC,aAAU;AAAA,MACV,WAAW,GAAG,yBAAyB,OAAO,2BAA2B,0BAA0B;AAAA,MAElG;AAAA,gBAAQ,SACN,WACC,oBAAC,SAAI,WAAU,0HACZ,gBACH,IAEA,oBAAC,SAAI,WAAU,QAAQ,gBAAK;AAAA,QAE/B,SAAS,QACR;AAAA,UAAC;AAAA;AAAA,YACC,WAAW;AAAA,cACT;AAAA,cACA,OAAO,yBAAyB;AAAA,YAClC;AAAA,YAEC;AAAA;AAAA,QACH;AAAA,QAED,eAAe,QAAQ,oBAAC,OAAE,WAAU,oCAAoC,uBAAY;AAAA;AAAA;AAAA,EACvF;AAGF,QAAM,OACJ,iCACG;AAAA;AAAA,IACD,oBAAC,SAAI,WAAW,GAAG,cAAc,OAAO,SAAS,OAAO,GAAI,UAAS;AAAA,KACvE;AAGF,SACE;AAAA,IAAC;AAAA;AAAA,MACE,GAAG;AAAA,MACJ,oBAAkB;AAAA,MAClB,OAAO,EAAE,GAAG,WAAW,GAAG,MAAM;AAAA,MAChC,WAAW,GAAG,0EAA0E,SAAS;AAAA,MAEhG;AAAA,qBACC,qBAAC,SAAI,aAAU,sBAAqB,WAAU,uCAC3C;AAAA;AAAA,UACA;AAAA,WACH;AAAA,QAEF;AAAA,UAAC;AAAA;AAAA,YACC,aAAU;AAAA,YACV,WAAW;AAAA;AAAA,cAET;AAAA,cACA,OAAO,kBAAkB;AAAA,YAC3B;AAAA,YAEA,+BAAC,SAAI,WAAW,GAAG,kBAAkB,OAAO,cAAc,UAAU,GACjE;AAAA,sBAAQ,QAAQ,oBAAC,SAAI,WAAU,QAAQ,gBAAK;AAAA,cAC5C,OACC,oBAAC,QAAK,WAAW,GAAG,OAAO,eAAe,OAAO,aAAa,GAAI,gBAAK,IAEvE,oBAAC,SAAI,WAAW,eAAgB,gBAAK;AAAA,eAEzC;AAAA;AAAA,QACF;AAAA,QACC,UAAU,QAAQ,WAAW,SAC5B,oBAAC,UAAO,aAAU,sBAAqB,WAAU,QAC9C,wBACC,oBAAC,SAAI,cAAY,aAAa,WAAW,cACtC,kBACH,IAEA,oBAAC,SAAI,WAAW,cAAe,kBAAO,GAE1C;AAAA;AAAA;AAAA,EAEJ;AAEJ;","names":[]}

package/dist/shell/top-bar-brand.d.ts

@@ -0,0 +1,81 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { aA as KitLinkProps, az as KitLinkComponent } from '../kit-labels-Mz8zZHIF.js';
+import '../components/data-table-labels.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-sync.js';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/danger-confirm.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../feedback/feedback-attachment.js';
+import '../feedback/feedback-dialog.js';
+import '../feedback/feedback-thread.js';
+import '../feedback/feedback-inbox.js';
+import '../components/account-settings-labels.js';
+import '../components/confirm-dialog.js';
+import '../components/floating-panel.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../hooks/use-authed-src.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+
+interface TopBarBrandProps extends Omit<KitLinkProps, "href" | "children"> {
+    /** The brand mark — an SVG, sized by the caller or `h-6 w-auto` by default. */
+    logo: ReactNode;
+    /** The product name beside the logo, and the link's accessible name. */
+    name: ReactNode;
+    /** Where the brand links to. Default `/`. */
+    to?: string;
+    /** Hide the name below `sm` (default) or `md`; `false` always shows it. It is
+     *  visually hidden, not removed, so the link keeps its name on a phone. */
+    collapseBelow?: "sm" | "md" | false;
+    /** The app's router link for this one link. Default: the provider's
+     *  `linkComponent`, else react-router's `Link`. */
+    renderLink?: KitLinkComponent;
+}
+/**
+ * The top bar's home link: logo + product name, collapsing to the logo on a phone.
+ * Pass it as {@link TopBar}'s `brand`.
+ *
+ * kastlan's (top-bar.tsx:66) hid nothing and truncated the name instead — on a phone
+ * with five actions that left "Ka…" beside the logo — and needed an `aria-label`
+ * because the name could be cut. Here the name is `sr-only` below the breakpoint, so
+ * the logo is the whole visible link there and the name is still what it is called.
+ */
+declare function TopBarBrand({ logo, name, to, collapseBelow, renderLink, className, ...rest }: TopBarBrandProps): react.JSX.Element;
+
+export { TopBarBrand, type TopBarBrandProps };

package/dist/shell/top-bar-brand.js

@@ -0,0 +1,47 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Link as RouterLink } from "react-router";
+import { cn } from "../lib/cn.js";
+import { useKitLink } from "../i18n/kit-labels.js";
+import { pickLinkRenderer } from "../components/text-link.js";
+const routerLink = ({ href, ...p }) => /* @__PURE__ */ jsx(RouterLink, { to: href, ...p });
+const plainLink = ({ children, ...p }) => /* @__PURE__ */ jsx("a", { ...p, children });
+const COLLAPSE = {
+  sm: "sr-only sm:not-sr-only sm:truncate",
+  md: "sr-only md:not-sr-only md:truncate"
+};
+function TopBarBrand({
+  logo,
+  name,
+  to = "/",
+  collapseBelow = "sm",
+  renderLink,
+  className,
+  ...rest
+}) {
+  const kitLink = useKitLink();
+  return /* @__PURE__ */ jsxs(
+    RenderedLink,
+    {
+      render: pickLinkRenderer(renderLink, kitLink ?? routerLink, to) ?? plainLink,
+      ...rest,
+      href: to,
+      className: cn(
+        // `relative` contains the sr-only name.
+        "relative flex min-w-0 items-center gap-2 rounded-md font-semibold text-[var(--text-primary)] hover:opacity-80 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--brand)]",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx("span", { "aria-hidden": true, className: "flex shrink-0 items-center [&_svg]:h-6 [&_svg]:w-auto", children: logo }),
+        /* @__PURE__ */ jsx("span", { className: collapseBelow ? COLLAPSE[collapseBelow] : "truncate", children: name })
+      ]
+    }
+  );
+}
+function RenderedLink({ render, ...props }) {
+  return render(props);
+}
+export {
+  TopBarBrand
+};
+//# sourceMappingURL=top-bar-brand.js.map

package/dist/shell/top-bar-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shell/top-bar-brand.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { Link as RouterLink } from \"react-router\";\nimport { cn } from \"../lib/cn\";\nimport { useKitLink } from \"../i18n/kit-labels\";\nimport { pickLinkRenderer } from \"../components/text-link\";\nimport type { KitLinkComponent, KitLinkProps } from \"../i18n/kit-labels\";\n\nconst routerLink: KitLinkComponent = ({ href, ...p }) => <RouterLink to={href} {...p} />;\nconst plainLink: KitLinkComponent = ({ children, ...p }) => <a {...p}>{children}</a>;\n\n/** Below which width only the logo shows. The name stays in the link's accessible\n *  name at every width. */\nconst COLLAPSE = {\n  sm: \"sr-only sm:not-sr-only sm:truncate\",\n  md: \"sr-only md:not-sr-only md:truncate\",\n} as const;\n\nexport interface TopBarBrandProps extends Omit<KitLinkProps, \"href\" | \"children\"> {\n  /** The brand mark — an SVG, sized by the caller or `h-6 w-auto` by default. */\n  logo: ReactNode;\n  /** The product name beside the logo, and the link's accessible name. */\n  name: ReactNode;\n  /** Where the brand links to. Default `/`. */\n  to?: string;\n  /** Hide the name below `sm` (default) or `md`; `false` always shows it. It is\n   *  visually hidden, not removed, so the link keeps its name on a phone. */\n  collapseBelow?: \"sm\" | \"md\" | false;\n  /** The app's router link for this one link. Default: the provider's\n   *  `linkComponent`, else react-router's `Link`. */\n  renderLink?: KitLinkComponent;\n}\n\n/**\n * The top bar's home link: logo + product name, collapsing to the logo on a phone.\n * Pass it as {@link TopBar}'s `brand`.\n *\n * kastlan's (top-bar.tsx:66) hid nothing and truncated the name instead — on a phone\n * with five actions that left \"Ka…\" beside the logo — and needed an `aria-label`\n * because the name could be cut. Here the name is `sr-only` below the breakpoint, so\n * the logo is the whole visible link there and the name is still what it is called.\n */\nexport function TopBarBrand({\n  logo,\n  name,\n  to = \"/\",\n  collapseBelow = \"sm\",\n  renderLink,\n  className,\n  ...rest\n}: TopBarBrandProps) {\n  const kitLink = useKitLink();\n  return (\n    <RenderedLink\n      // The kit's one link rule (`pickLinkRenderer`): an external `to` or an in-page\n      // `#anchor` is a plain `<a>`, never the router's link.\n      render={pickLinkRenderer(renderLink, kitLink ?? routerLink, to) ?? plainLink}\n      {...rest}\n      href={to}\n      className={cn(\n        // `relative` contains the sr-only name.\n        \"relative flex min-w-0 items-center gap-2 rounded-md font-semibold text-[var(--text-primary)] hover:opacity-80 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--brand)]\",\n        className,\n      )}\n    >\n      <span aria-hidden className=\"flex shrink-0 items-center [&_svg]:h-6 [&_svg]:w-auto\">\n        {logo}\n      </span>\n      <span className={collapseBelow ? COLLAPSE[collapseBelow] : \"truncate\"}>{name}</span>\n    </RenderedLink>\n  );\n}\n\n/** Calls the link renderer as a component, so a router link's hooks are its own. */\nfunction RenderedLink({ render, ...props }: KitLinkProps & { render: KitLinkComponent }) {\n  return render(props);\n}\n"],"mappings":";AAOyD,cA6CrD,YA7CqD;AANzD,SAAS,QAAQ,kBAAkB;AACnC,SAAS,UAAU;AACnB,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AAGjC,MAAM,aAA+B,CAAC,EAAE,MAAM,GAAG,EAAE,MAAM,oBAAC,cAAW,IAAI,MAAO,GAAG,GAAG;AACtF,MAAM,YAA8B,CAAC,EAAE,UAAU,GAAG,EAAE,MAAM,oBAAC,OAAG,GAAG,GAAI,UAAS;AAIhF,MAAM,WAAW;AAAA,EACf,IAAI;AAAA,EACJ,IAAI;AACN;AA0BO,SAAS,YAAY;AAAA,EAC1B;AAAA,EACA;AAAA,EACA,KAAK;AAAA,EACL,gBAAgB;AAAA,EAChB;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAqB;AACnB,QAAM,UAAU,WAAW;AAC3B,SACE;AAAA,IAAC;AAAA;AAAA,MAGC,QAAQ,iBAAiB,YAAY,WAAW,YAAY,EAAE,KAAK;AAAA,MAClE,GAAG;AAAA,MACJ,MAAM;AAAA,MACN,WAAW;AAAA;AAAA,QAET;AAAA,QACA;AAAA,MACF;AAAA,MAEA;AAAA,4BAAC,UAAK,eAAW,MAAC,WAAU,yDACzB,gBACH;AAAA,QACA,oBAAC,UAAK,WAAW,gBAAgB,SAAS,aAAa,IAAI,YAAa,gBAAK;AAAA;AAAA;AAAA,EAC/E;AAEJ;AAGA,SAAS,aAAa,EAAE,QAAQ,GAAG,MAAM,GAAgD;AACvF,SAAO,OAAO,KAAK;AACrB;","names":[]}