@eifi1/ui-kit 0.13.1 → 0.14.0

package/README.md

@@ -377,20 +377,20 @@ columns, strings and permissions (see the note at the top of `src/feedback/feedb
 
 <!-- BEGIN GENERATED: exports — node scripts/gen-export-inventory.mjs -->
 
-**1002 names from 159 modules** — 474 values and 528 types. _Italic_ is a type-only export.
+**1005 names from 159 modules** — 474 values and 531 types. _Italic_ is a type-only export.
 
 Generated from `dist/index.d.ts` by `node scripts/gen-export-inventory.mjs`; the count
 is pinned by `src/__tests__/public-surface.test.ts`. Do not edit between the markers.
 
 | Entry point | Names |
 |---|---|
-| `@eifi1/ui-kit` | 1002 |
+| `@eifi1/ui-kit` | 1005 |
 | `@eifi1/ui-kit/chart` | 100 |
 | `@eifi1/ui-kit/shell` | 24 |
 | `@eifi1/ui-kit/data-table` | 49 |
 | `@eifi1/ui-kit/wizard` | 25 |
 | `@eifi1/ui-kit/tour` | 7 |
-| `@eifi1/ui-kit/feedback` | 43 |
+| `@eifi1/ui-kit/feedback` | 45 |
 | `@eifi1/ui-kit/search` | 22 |
 | `@eifi1/ui-kit/dates` | 22 |
 | `@eifi1/ui-kit/table-text` | 8 |
@@ -544,7 +544,7 @@ re-slicing of it, never a second API.
 | `components/menu-item` | `MenuItem`, _`MenuItemLinkProps`_, _`MenuItemProps`_, _`MenuItemTone`_ |
 | `components/text` | `Caption`, `CAPTION_CLASS`, `SECTION_LABEL_CLASS`, `SectionLabel`, _`CaptionProps`_, _`SectionLabelProps`_, _`SectionLabelSize`_, _`SectionLabelVariant`_ |
 | `components/status-dot` | `StatusDot`, _`StatusDotProps`_, _`StatusDotSize`_, _`StatusDotTone`_ |
-| `components/page-header` | `PageHeader`, _`PageHeaderMobileLayout`_, _`PageHeaderProps`_, _`PageHeaderSize`_ |
+| `components/page-header` | `PageHeader`, _`PageHeaderActionsAlign`_, _`PageHeaderMobileLayout`_, _`PageHeaderProps`_, _`PageHeaderSize`_ |
 | `components/breadcrumbs` | `Breadcrumbs`, `DEFAULT_BREADCRUMBS_LABELS`, _`BreadcrumbItem`_, _`BreadcrumbLinkProps`_, _`BreadcrumbsLabels`_, _`BreadcrumbsProps`_ |
 | `components/text-link` | `TextLink`, _`TextLinkCurrent`_, _`TextLinkProps`_, _`TextLinkRenderProps`_, _`TextLinkTone`_, _`TextLinkUnderline`_ |
 | `components/toast` | `DEFAULT_TOAST_LABELS`, `toast`, `TOAST_ACTION_DURATION`, `Toaster`, _`ToastAction`_, _`ToasterOffset`_, _`ToasterProps`_, _`ToastId`_, _`ToastLabels`_, _`ToastOptions`_, _`ToastPosition`_, _`ToastPromiseOptions`_, _`ToastRedoOptions`_, _`ToastSwipeDirection`_, _`ToastUndoOptions`_ |
@@ -580,7 +580,7 @@ re-slicing of it, never a second API.
 | `feedback/feedback-attachment` | `DEFAULT_ATTACHMENT_ACCEPT`, `DEFAULT_FEEDBACK_ATTACHMENT_LABELS`, `DEFAULT_MAX_ATTACHMENT_BYTES`, `FeedbackAttachmentField`, `pastedName`, _`FeedbackAttachmentFieldLabels`_ |
 | `feedback/feedback-dialog` | `DEFAULT_FEEDBACK_DIALOG_LABELS`, `FeedbackDialog`, _`FeedbackAttachmentLabels`_, _`FeedbackCategoryOption`_, _`FeedbackDialogLabels`_, _`FeedbackDialogTextLabels`_, _`FeedbackSubmission`_ |
 | `feedback/feedback-inbox` | `FEEDBACK_CATEGORY_META`, `FEEDBACK_CATEGORY_ORDER`, `FEEDBACK_STATUS_META`, `FEEDBACK_STATUS_ORDER`, `FeedbackCategoryBadge`, `feedbackCategoryRank`, `FeedbackDetail`, `FeedbackDetailSection`, `FeedbackNoteEditor`, `FeedbackProse`, `FeedbackStatusBadge`, `FeedbackStatusTransitions`, `nextFeedbackStatus`, `selectableFeedbackStatuses`, `visibleFeedbackStatuses`, _`FeedbackCategory`_, _`FeedbackNoteAttachment`_, _`FeedbackStatus`_ |
-| `feedback/feedback-thread` | `DEFAULT_FEEDBACK_COMPOSER_LABELS`, `DEFAULT_FEEDBACK_THREAD_LABELS`, `FeedbackComposer`, `FeedbackThread`, _`FeedbackComposerAttachment`_, _`FeedbackComposerHandle`_, _`FeedbackComposerLabels`_, _`FeedbackComposerProps`_, _`FeedbackThreadAttachment`_, _`FeedbackThreadLabels`_, _`FeedbackThreadMessage`_, _`FeedbackThreadProps`_ |
+| `feedback/feedback-thread` | `DEFAULT_FEEDBACK_COMPOSER_LABELS`, `DEFAULT_FEEDBACK_THREAD_LABELS`, `FeedbackComposer`, `FeedbackThread`, _`FeedbackComposerAttachment`_, _`FeedbackComposerHandle`_, _`FeedbackComposerLabels`_, _`FeedbackComposerProps`_, _`FeedbackThreadAttachment`_, _`FeedbackThreadEvent`_, _`FeedbackThreadItem`_, _`FeedbackThreadLabels`_, _`FeedbackThreadMessage`_, _`FeedbackThreadProps`_ |
 
 ### wizard
 

package/dist/components/error-boundary.d.ts

@@ -86,6 +86,9 @@ interface CrashReport {
     userAgent: string;
     /** The boundary's `appVersion` prop. */
     appVersion?: string;
+    /** The boundary's `placement` prop ("app", "page", "widget"): which boundary caught
+     *  it, so triage can tell a whole-app crash from one page's (keksdose G3b). */
+    placement?: string;
     /** `navigator.onLine` at the moment of the crash; left out where there is none. */
     online?: boolean;
     /** {@link isChunkLoadError} of the thrown value. Such a crash is never handed to
@@ -114,7 +117,7 @@ declare function formatCrashReport(report: CrashReport): string;
  * times a second. The page and the time are left out on purpose: the same bug on two
  * routes is still one bug.
  */
-declare function crashFingerprint(report: Pick<CrashReport, "name" | "message" | "stack">): string;
+declare function crashFingerprint(report: Pick<CrashReport, "name" | "message" | "stack"> & Pick<Partial<CrashReport>, "placement">): string;
 /**
  * What `onReport` may resolve with. `{ reference }` is shown ("Reported as …");
  * nothing (or `{}`) means filed without one. `{ filed: false }` says the app decided NOT
@@ -172,6 +175,10 @@ interface ErrorBoundaryProps {
     copyReport?: boolean;
     /** The app's version, printed in the report — the first question on every crash. */
     appVersion?: string;
+    /** Which boundary this is — "app" at the root, "page" in the layout — carried into
+     *  the report (`placement`) and its fingerprint, so `onReport` needs no closure to say
+     *  where the crash was caught (keksdose G3b). */
+    placement?: string;
     /** More `key: value` lines for the report, read when the boundary catches (a tenant
      *  id, the feature flags). A throw from it is swallowed and the lines are left out. */
     reportExtras?: () => Record<string, string>;

package/dist/components/error-boundary.js

@@ -68,6 +68,7 @@ function formatCrashReport(report) {
     `User agent: ${report.userAgent}`
   ];
   if (report.appVersion) lines.push(`App version: ${report.appVersion}`);
+  if (report.placement) lines.push(`Placement: ${report.placement}`);
   if (report.online === false) lines.push("Online: no");
   for (const [key, value] of Object.entries(report.extras)) lines.push(`${key}: ${value}`);
   if (report.stack) lines.push("", "Stack:", report.stack.trim());
@@ -76,7 +77,8 @@ function formatCrashReport(report) {
 }
 function crashFingerprint(report) {
   const frames = (report.stack ?? "").split("\n").slice(0, 4).join("|");
-  return `${report.name}::${report.message}::${frames}`;
+  const where = report.placement ? `${report.placement}::` : "";
+  return `${where}${report.name}::${report.message}::${frames}`;
 }
 const NOT_FILED = { filed: false };
 const MAX_REPORTS_PER_PAGE_LOAD = 5;
@@ -166,6 +168,7 @@ function buildReport(details, componentStack, props) {
     time: (/* @__PURE__ */ new Date()).toISOString(),
     userAgent,
     appVersion: props.appVersion,
+    placement: props.placement,
     online,
     chunkLoad: isChunkLoadError(details),
     extras

package/dist/components/error-boundary.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/error-boundary.tsx"],"sourcesContent":["import { Component } from \"react\";\nimport type { ErrorInfo, ReactNode } from \"react\";\nimport { AlertTriangle, RefreshCw, WifiOff } from \"lucide-react\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { Button, EmptyState } from \"./ui\";\nimport { CopyButton } from \"./copy-button\";\nimport { Disclosure } from \"./disclosure\";\n\n/** The words of the default fallback. */\nexport interface ErrorBoundaryLabels {\n  /** The fallback's heading. */\n  title: string;\n  /** The line under it. */\n  message: string;\n  /** The button that clears the error and renders the children again. */\n  retry: string;\n  /** The disclosure that opens the full error report (`showDetails`). */\n  details: string;\n  /** The button that reloads the whole page (0.13). */\n  reload: string;\n  /** Heading when a lazy chunk failed to load while online — a deploy replaced the\n   *  files this page was built from (0.13). */\n  updateTitle: string;\n  updateMessage: string;\n  /** Heading when the browser says it is offline (0.13). */\n  offlineTitle: string;\n  offlineMessage: string;\n  /** The copy button's words: what it copies is the plain-text report (0.13). */\n  copyReport: string;\n  /** Shown once `onReport` has filed the crash and returned no reference (0.13). */\n  reported: string;\n  /** Shown once `onReport` has filed the crash under a reference — rendered as the\n   *  app returned it, so return `\"#123\"` if the hash belongs to it (0.13). */\n  reportedAs: (reference: string) => string;\n}\n\nexport const DEFAULT_ERROR_BOUNDARY_LABELS: ErrorBoundaryLabels = {\n  title: \"Something went wrong\",\n  message: \"This part of the page could not be shown. Try again, or reload the page.\",\n  retry: \"Try again\",\n  details: \"Error details\",\n  reload: \"Reload\",\n  updateTitle: \"A new version is available\",\n  updateMessage: \"Part of the app has changed since this page was loaded. Reload to get the new version.\",\n  offlineTitle: \"You’re offline\",\n  offlineMessage: \"This page could not be loaded without a connection. Reconnect, then reload the page.\",\n  copyReport: \"Copy error report\",\n  reported: \"This error has been reported automatically.\",\n  reportedAs: (reference) => `Reported as ${reference}`,\n};\n\n/**\n * What was thrown, as flat strings, read ONCE when it arrives.\n *\n * React stores whatever was thrown, hostile or not — `throw { get message() { throw … } }`,\n * `throw { name: Symbol() }`, `throw undefined` — and reading one of those during the\n * fallback's own render would throw INSIDE the boundary, escalating to the next one up\n * (keksdose's error-boundary.tsx learned this as feedback #160: at the app level there is\n * none, and the result is the white screen the boundary exists to prevent).\n */\nexport interface ErrorBoundaryDetails {\n  name: string;\n  message: string;\n  stack?: string;\n}\n\nfunction read(get: () => unknown): string | undefined {\n  try {\n    const v = get();\n    return typeof v === \"string\" ? v : v === undefined || v === null ? undefined : String(v);\n  } catch {\n    return undefined;\n  }\n}\n\n/** `JSON.stringify` that never throws (a cycle, a BigInt, a hostile getter) and never\n *  returns more than 500 characters. \"\" when there is nothing to say. */\nfunction safeJson(value: unknown): string {\n  try {\n    const json = JSON.stringify(value);\n    if (!json || json === \"{}\") return \"\";\n    return json.length > 500 ? `${json.slice(0, 499)}…` : json;\n  } catch {\n    return \"\";\n  }\n}\n\n/** {@link ErrorBoundaryDetails} of any thrown value, without ever throwing. */\nexport function describeThrown(error: unknown): ErrorBoundaryDetails {\n  if (typeof error === \"object\" && error !== null) {\n    const e = error as { name?: unknown; message?: unknown; stack?: unknown };\n    const message = read(() => e.message) ?? \"\";\n    return {\n      name: read(() => e.name) ?? \"Error\",\n      // `throw { code: 500 }` has no message, and an empty line leaves crash triage with\n      // nothing (keksdose G3a; its old reporter filed `{\"code\":500}`). Such a value is\n      // quoted as JSON instead, capped, and never at the cost of a throw.\n      message: message || (error instanceof Error ? \"\" : safeJson(error)),\n      stack: read(() => e.stack),\n    };\n  }\n  return { name: \"Error\", message: read(() => error) ?? \"\" };\n}\n\n/**\n * Is this a failed lazy import — a route chunk that did not arrive?\n *\n * Two causes, and neither is a bug in the page: the device is offline and the chunk was\n * never cached, or a deploy replaced the hashed files the running page still points at.\n * Both are cured by a reload and by nothing else — `React.lazy` caches the rejected\n * import, so Try again re-throws the same error without fetching. The patterns are\n * keksdose's (crash-report.ts), which covers Vite (\"dynamically imported module\",\n * \"module script failed\"), webpack (\"ChunkLoadError\", \"Loading chunk\") and the bare\n * `fetch` failure a service worker hands back.\n *\n * Never throws: it runs inside the fallback's own render, where a throw is a white\n * screen. An error it cannot read is not a chunk failure.\n */\nexport function isChunkLoadError(\n  error: { name?: string | null; message?: string | null } | null | undefined,\n): boolean {\n  try {\n    const s = `${error?.name ?? \"\"} ${error?.message ?? \"\"}`;\n    return /ChunkLoadError|dynamically imported module|module script failed|Loading chunk|Failed to fetch/i.test(s);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Everything a crash report carries, read once when the boundary catches.\n *\n * Plain strings only, so it survives `JSON.stringify` into an app's crash endpoint as is\n * and {@link formatCrashReport} can print it without a single guard. The wording of the\n * printed report is English on purpose: it is read by whoever fixes the bug, not by the\n * user who copies it, and a report in nine languages cannot be searched.\n */\nexport interface CrashReport {\n  /** The thrown value's `name` (\"TypeError\"), \"Error\" for a non-object. */\n  name: string;\n  message: string;\n  stack?: string;\n  /** React's component stack from `componentDidCatch` — the part that names the\n   *  component, which a minified JS stack no longer does. */\n  componentStack?: string;\n  /** `pathname + search` at the moment of the crash. The search may carry what the\n   *  user typed — see `redact`. */\n  page: string;\n  /** ISO 8601, UTC. */\n  time: string;\n  userAgent: string;\n  /** The boundary's `appVersion` prop. */\n  appVersion?: string;\n  /** `navigator.onLine` at the moment of the crash; left out where there is none. */\n  online?: boolean;\n  /** {@link isChunkLoadError} of the thrown value. Such a crash is never handed to\n   *  `onReport` — it is a deploy or a dropped connection, not a defect — but it is\n   *  still in the copied report. */\n  chunkLoad: boolean;\n  /** The boundary's `reportExtras()`, stringified. */\n  extras: Record<string, string>;\n}\n\n/**\n * The report as one plain-text block — what the copy button puts on the clipboard and\n * the details disclosure shows.\n *\n * lenkbank's layout, because that is the one that was already being pasted into\n * feedback messages: the error line first (it is what a search for the bug matches),\n * then where / when / what, then the two stacks.\n */\nexport function formatCrashReport(report: CrashReport): string {\n  const lines = [\n    report.message ? `${report.name}: ${report.message}` : report.name,\n    `Page: ${report.page}`,\n    `Time: ${report.time}`,\n    `User agent: ${report.userAgent}`,\n  ];\n  if (report.appVersion) lines.push(`App version: ${report.appVersion}`);\n  if (report.online === false) lines.push(\"Online: no\");\n  for (const [key, value] of Object.entries(report.extras)) lines.push(`${key}: ${value}`);\n  if (report.stack) lines.push(\"\", \"Stack:\", report.stack.trim());\n  if (report.componentStack) lines.push(\"\", \"Component stack:\", report.componentStack.trim());\n  return lines.join(\"\\n\");\n}\n\n/**\n * A key for \"the same crash again\": the error's name and message and the first frames\n * of its stack.\n *\n * Page-load local, not a server-side grouping key (keksdose's crash-report.ts draws the\n * same line): its only job is to stop one page load filing one bug twice — React's dev\n * StrictMode, a Try again that crashes again, a render loop that trips the boundary many\n * times a second. The page and the time are left out on purpose: the same bug on two\n * routes is still one bug.\n */\nexport function crashFingerprint(report: Pick<CrashReport, \"name\" | \"message\" | \"stack\">): string {\n  const frames = (report.stack ?? \"\").split(\"\\n\").slice(0, 4).join(\"|\");\n  return `${report.name}::${report.message}::${frames}`;\n}\n\n/**\n * What `onReport` may resolve with. `{ reference }` is shown (\"Reported as …\");\n * nothing (or `{}`) means filed without one. `{ filed: false }` says the app decided NOT\n * to file (a demo session, a hot-reload artefact, a report buffered for later): the\n * screen then claims nothing and keeps the copy button — claiming a report that was\n * never sent is the same false statement as hiding one that was.\n */\nexport type CrashReportResult = { reference?: string; filed?: boolean } | void;\n\ninterface Filing {\n  filed: boolean;\n  reference?: string;\n}\n\nconst NOT_FILED: Filing = { filed: false };\n\n/** A render loop can trip a boundary dozens of times a second with a different message\n *  each time (a counter in it); without a ceiling the first bad deploy files hundreds of\n *  rows. keksdose's number. */\nconst MAX_REPORTS_PER_PAGE_LOAD = 5;\n\n/** Fingerprint → the one filing for it in this page load. Module scope IS the page\n *  load: a reload starts it empty. A duplicate gets the first filing's promise, so the\n *  second screen shows the same reference instead of claiming nothing. */\nconst filings = new Map<string, Promise<Filing>>();\n\nfunction settle(out: unknown): Filing {\n  try {\n    if (out && typeof out === \"object\") {\n      const o = out as { filed?: unknown; reference?: unknown };\n      if (o.filed === false) return NOT_FILED;\n      const reference = typeof o.reference === \"string\" && o.reference ? o.reference : undefined;\n      return { filed: true, reference };\n    }\n    return { filed: true };\n  } catch {\n    return NOT_FILED;\n  }\n}\n\n/** Hand the report to the app, once per fingerprint per page load, and never throw —\n *  not for a synchronous throw, a rejection, or a hostile thenable. */\nfunction fileOnce(report: CrashReport, onReport: (report: CrashReport) => unknown): Promise<Filing> {\n  const key = crashFingerprint(report);\n  const known = filings.get(key);\n  if (known) return known;\n  if (filings.size >= MAX_REPORTS_PER_PAGE_LOAD) return Promise.resolve(NOT_FILED);\n  let filing: Promise<Filing>;\n  try {\n    filing = Promise.resolve(onReport(report)).then(settle, () => NOT_FILED);\n  } catch {\n    filing = Promise.resolve(NOT_FILED);\n  }\n  // Claimed before the first await: two catches in the same tick (StrictMode) must not\n  // both get past the lookup above.\n  filings.set(key, filing);\n  return filing;\n}\n\nfunction isOffline(): boolean {\n  try {\n    return typeof navigator !== \"undefined\" && navigator.onLine === false;\n  } catch {\n    return false;\n  }\n}\n\nfunction reloadPage(): void {\n  try {\n    window.location.reload();\n  } catch {\n    /* nothing left to do from here */\n  }\n}\n\n/** What a render-prop `fallback` is handed. */\nexport interface ErrorBoundaryFallbackProps {\n  /** The thrown value, as it was thrown. Read it with care — see {@link describeThrown}. */\n  error: unknown;\n  details: ErrorBoundaryDetails;\n  /** Clear the error and render the children again. */\n  reset: () => void;\n  /** The crash report, once `componentDidCatch` has built it (null on the very first\n   *  render of the fallback, which happens before it). Already `redact`ed. */\n  report: CrashReport | null;\n}\n\nexport interface ErrorBoundaryProps {\n  children?: ReactNode;\n  /** Replaces the default fallback: a node, or a render function handed the error and\n   *  a `reset`. The same rule applies to it as to the default: see the component docs. */\n  fallback?: ReactNode | ((props: ErrorBoundaryFallbackProps) => ReactNode);\n  /** Called once per caught error with the raw value — log it. A throw from it is\n   *  swallowed: the boundary is the last thing standing. For filing a report, prefer\n   *  `onReport`, which gets the finished report, dedupe and the reference on screen. */\n  onError?: (error: unknown, info: ErrorInfo) => void;\n  /** Called when the error is cleared, by Try again, `reset` or a `resetKeys` change —\n   *  drop a cache, refetch. */\n  onReset?: () => void;\n  /**\n   * When any of these changes (compared with `Object.is`) AFTER an error was caught, the\n   * error is cleared and the children render again — a change in the same update that\n   * threw does not count (it is what the error was shown under) — pass the route path so leaving a broken page does not\n   * carry its fallback to the next one (keksdose's `resetKey`).\n   */\n  resetKeys?: ReadonlyArray<unknown>;\n  /** Quote the error's `name: message` in a monospace box under the hint. Default on\n   *  (0.13): three sentences true of every crash identify none of them, and the one\n   *  line that does is what a user can read out or screenshot (lenkbank P7). Not shown\n   *  for a chunk-load / offline screen, where the message is a URL that explains\n   *  nothing the title does not. */\n  showMessage?: boolean;\n  /** A collapsed disclosure holding the full plain-text report. Default on since 0.13\n   *  (it was an opt-in showing name, message and stack): closed, it costs one line, and\n   *  it is where a support conversation asks the user to look. */\n  showDetails?: boolean;\n  /** The copy button for the plain-text report (the kit's CopyButton, which says when\n   *  the clipboard refused). Default on. Hidden once `onReport` has filed the crash —\n   *  there is nothing left to paste anywhere — and shown again whenever it did not. */\n  copyReport?: boolean;\n  /** The app's version, printed in the report — the first question on every crash. */\n  appVersion?: string;\n  /** More `key: value` lines for the report, read when the boundary catches (a tenant\n   *  id, the feature flags). A throw from it is swallowed and the lines are left out. */\n  reportExtras?: () => Record<string, string>;\n  /**\n   * Rewrite the report before anything sees it: the screen, the clipboard and\n   * `onReport` all get the returned one.\n   *\n   * THE REPORT IS STRUCTURE, NEVER CONTENT — and only the app knows which of its query\n   * params hold content. keksdose's register put the free-text search in `?q=` and payee\n   * names in the `f.*` filters, and its crash channel sent them in the clear to a column\n   * every admin reads (crash-report.ts `safeUrl`). The cure there is an ALLOW-list, so a\n   * param added later is dropped until somebody decides otherwise — rebuild `page`\n   * from `new URL(r.page, location.origin)`, keeping only the listed `searchParams`.\n   * `extras` are the app's own and need no second pass. A throw from `redact` falls\n   * back to the pathname alone and no extras — failing closed.\n   *\n   * The same holds inside `onReport`, which is the other place to do it: clamp fields\n   * to what the endpoint accepts, drop what it must not store. The kit cannot know.\n   */\n  redact?: (report: CrashReport) => CrashReport;\n  /**\n   * File the report automatically. Called from `componentDidCatch`, at most once per\n   * {@link crashFingerprint} per page load (and at most five times in all), never for a\n   * chunk-load error. It can NOT throw into the boundary: a synchronous throw and a\n   * rejection both read as \"not filed\", and the copy button stays.\n   *\n   * Resolve with `{ reference }` and the screen says \"Reported as …\" instead of the copy\n   * button; see {@link CrashReportResult} for \"filed without a reference\" and \"decided not\n   * to file\". Whatever the app's reporter does, it must do without the router, the query\n   * client or the auth store's hooks — a bare `fetch` with `keepalive`, so it survives\n   * the reload the user is about to press (keksdose crash-report.ts `post`).\n   */\n  onReport?: (report: CrashReport) => Promise<CrashReportResult> | CrashReportResult;\n  /** The app's own escape hatches, beside Reload / Try again — keksdose's \"Clear local\n   *  data\" for a poisoned persisted cache that no in-app action could otherwise break.\n   *  A full-width hint under it: wrap it in `<div className=\"basis-full\">`. */\n  actions?: ReactNode;\n  /** The default fallback's heading level. Default `h2`: the fallback often IS the page. */\n  headingAs?: \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\";\n  /** Classes for the default fallback's box (`m-8 min-h-[400px]`, kastlan). */\n  className?: string;\n  labels?: Partial<ErrorBoundaryLabels>;\n}\n\ntype FilingState = \"none\" | \"pending\" | \"filed\" | \"failed\";\n\ninterface ErrorBoundaryState {\n  /** A flag of its own, so `throw undefined` is still an error shown. */\n  failed: boolean;\n  error: unknown;\n  details: ErrorBoundaryDetails | null;\n  report: CrashReport | null;\n  filing: FilingState;\n  reference: string | undefined;\n}\n\nconst CLEAR: ErrorBoundaryState = {\n  failed: false,\n  error: null,\n  details: null,\n  report: null,\n  filing: \"none\",\n  reference: undefined,\n};\n\nfunction keysChanged(a: ReadonlyArray<unknown> | undefined, b: ReadonlyArray<unknown> | undefined): boolean {\n  if (a === b) return false;\n  if (!a || !b || a.length !== b.length) return true;\n  return a.some((v, i) => !Object.is(v, b[i]));\n}\n\nfunction currentPage(): { page: string; path: string } {\n  try {\n    const { pathname, search } = window.location;\n    return { page: `${pathname}${search}`, path: pathname };\n  } catch {\n    return { page: \"\", path: \"\" };\n  }\n}\n\nfunction buildReport(details: ErrorBoundaryDetails, componentStack: string | undefined, props: ErrorBoundaryProps): CrashReport {\n  const { page, path } = currentPage();\n  const extras: Record<string, string> = {};\n  try {\n    const more = props.reportExtras?.();\n    if (more) for (const [k, v] of Object.entries(more)) extras[k] = String(v);\n  } catch {\n    /* documented: the lines are left out */\n  }\n  let userAgent = \"\";\n  let online: boolean | undefined;\n  try {\n    userAgent = navigator.userAgent;\n    online = typeof navigator.onLine === \"boolean\" ? navigator.onLine : undefined;\n  } catch {\n    /* no navigator (SSR, a worker test) */\n  }\n  const report: CrashReport = {\n    name: details.name,\n    message: details.message,\n    stack: details.stack,\n    componentStack: componentStack ?? undefined,\n    page,\n    time: new Date().toISOString(),\n    userAgent,\n    appVersion: props.appVersion,\n    online,\n    chunkLoad: isChunkLoadError(details),\n    extras,\n  };\n  if (!props.redact) return report;\n  try {\n    return props.redact(report);\n  } catch {\n    // Fail closed: an app that asked for redaction must not get the unredacted page.\n    return { ...report, page: path, extras: {} };\n  }\n}\n\n/**\n * Catch a render error below it and show ONE crash screen instead of an empty page.\n *\n * The three apps each built one. kastlan's and keksdose's sat on `EmptyState\n * tone=\"danger\"`; lenkbank's quoted the error and offered a plain-text report to copy;\n * keksdose's filed the crash itself, told a lazy-chunk failure apart as \"offline\", and\n * offered \"clear local data\" when a poisoned cache made Retry useless (feedback #160).\n * This is all of that, so the apps reduce to\n * `<ErrorBoundary resetKeys={[pathname]} appVersion={__VERSION__} />` plus, for an app\n * with a crash endpoint, `onReport` and `actions`:\n *\n * - the error's `name: message`, quoted (`showMessage`);\n * - Try again (reset the boundary) AND Reload (the page) — Try again alone re-renders\n *   the same subtree from the same state, which a deterministic crash survives;\n * - a chunk-load error or an offline browser gets its own title and Reload first\n *   (\"A new version is available\" / \"You're offline\");\n * - the copy button and the report in a disclosure; `onReport` for filing it, deduped\n *   per page load, with its reference on screen.\n *\n * THE RULE for this fallback — and for a `fallback` or `actions` an app passes in: it\n * must not depend on the router, the query client or the auth store. A crash is exactly\n * when those may be what broke, and a fallback that throws escalates to the next\n * boundary up — at the app level there is none, and the user gets the white screen this\n * exists to prevent. So no `useNavigate`, no `useQuery`, no `useAuth()` in it; reload\n * with `window.location`, not the router. The kit's own label hooks are the one context\n * it does read (`errorBoundary.*` from `UiKitProvider`), and they degrade to the English\n * defaults when there is no provider above — which is why the app-level boundary may\n * sit OUTSIDE the provider and still render.\n *\n * The fallback is `role=\"alert\"`: a page replaced by an error is news, and a reader\n * that was on it is told.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  state: ErrorBoundaryState = CLEAR;\n\n  /** Bumped by every catch and reset, so a filing that settles after the screen moved\n   *  on (Try again, a route change, a second crash) does not write into it. */\n  private generation = 0;\n\n  /**\n   * Forget which crashes this page load has filed, and the count towards the cap.\n   *\n   * For tests: the dedupe lives in module scope because a page load is what it spans,\n   * and a test file is one page load — so without this, the sixth test that files a\n   * report finds the cap reached and `onReport` never called. Call it in `beforeEach`.\n   * Never needed in an app: a reload is the reset.\n   */\n  static forgetReports(): void {\n    filings.clear();\n  }\n\n  static getDerivedStateFromError(error: unknown): Partial<ErrorBoundaryState> {\n    return { failed: true, error, details: describeThrown(error), report: null, filing: \"none\", reference: undefined };\n  }\n\n  componentDidCatch(error: unknown, info: ErrorInfo): void {\n    try {\n      this.props.onError?.(error, info);\n    } catch {\n      /* documented: a logger must not take the fallback down */\n    }\n    const details = this.state.details ?? describeThrown(error);\n    const report = buildReport(details, info.componentStack ?? undefined, this.props);\n    const { onReport } = this.props;\n    const willFile = onReport !== undefined && !report.chunkLoad;\n    const generation = ++this.generation;\n    this.setState({ report, filing: willFile ? \"pending\" : \"none\", reference: undefined });\n    if (!willFile) return;\n    void fileOnce(report, onReport).then((filing) => {\n      if (generation !== this.generation) return;\n      this.setState(\n        filing.filed ? { filing: \"filed\", reference: filing.reference } : { filing: \"failed\", reference: undefined },\n      );\n    });\n  }\n\n  componentDidUpdate(prev: ErrorBoundaryProps, prevState: ErrorBoundaryState): void {\n    // Only a change AFTER the error was caught clears it (react-error-boundary's rule).\n    // `prevState.failed` is false in the update that caught it: that update may well be\n    // the one that changed the keys too — a navigation to a page that throws, with\n    // `resetKeys={[pathname]}` — and resetting then would fire `onReset` for nothing and\n    // render the failing child a second time. From then on `prev.resetKeys` are the\n    // keys the error was shown under, so any change clears it.\n    if (this.state.failed && prevState.failed && keysChanged(prev.resetKeys, this.props.resetKeys)) {\n      this.reset();\n    }\n  }\n\n  reset = (): void => {\n    this.generation++;\n    this.props.onReset?.();\n    this.setState(CLEAR);\n  };\n\n  render(): ReactNode {\n    const { failed, error, details, report, filing, reference } = this.state;\n    if (!failed || !details) return this.props.children;\n    const { fallback } = this.props;\n    if (typeof fallback === \"function\") return fallback({ error, details, reset: this.reset, report });\n    if (fallback !== undefined) return fallback;\n    return (\n      <ErrorFallback\n        details={details}\n        report={report}\n        filing={filing}\n        reference={reference}\n        reset={this.reset}\n        showMessage={this.props.showMessage ?? true}\n        showDetails={this.props.showDetails ?? true}\n        copyReport={this.props.copyReport ?? true}\n        actions={this.props.actions}\n        headingAs={this.props.headingAs ?? \"h2\"}\n        className={this.props.className}\n        labels={this.props.labels}\n      />\n    );\n  }\n}\n\nfunction ErrorFallback({\n  details,\n  report,\n  filing,\n  reference,\n  reset,\n  showMessage,\n  showDetails,\n  copyReport,\n  actions,\n  headingAs,\n  className,\n  labels,\n}: {\n  details: ErrorBoundaryDetails;\n  report: CrashReport | null;\n  filing: FilingState;\n  reference: string | undefined;\n  reset: () => void;\n  showMessage: boolean;\n  showDetails: boolean;\n  copyReport: boolean;\n  actions?: ReactNode;\n  headingAs: NonNullable<ErrorBoundaryProps[\"headingAs\"]>;\n  className?: string;\n  labels?: Partial<ErrorBoundaryLabels>;\n}) {\n  const text = useKitLabels(\"errorBoundary\", DEFAULT_ERROR_BOUNDARY_LABELS, labels);\n  const chunk = isChunkLoadError(details);\n  // Offline first, as keksdose has it: offline, a chunk failure is the connection, and\n  // any other crash most likely a request that could not be made — either way \"reload\n  // once you are back\" is the advice, and \"a new version\" would be a false one.\n  const mode = isOffline() ? \"offline\" : chunk ? \"update\" : \"error\";\n  const title = mode === \"offline\" ? text.offlineTitle : mode === \"update\" ? text.updateTitle : text.title;\n  const hint = mode === \"offline\" ? text.offlineMessage : mode === \"update\" ? text.updateMessage : text.message;\n  const Icon = mode === \"offline\" ? WifiOff : mode === \"update\" ? RefreshCw : AlertTriangle;\n  const reportText = report ? formatCrashReport(report) : null;\n  const errorLine = details.message ? `${details.name}: ${details.message}` : details.name;\n\n  const reloadButton = (\n    <Button key=\"reload\" variant={mode === \"error\" ? \"secondary\" : \"primary\"} onClick={reloadPage}>\n      {text.reload}\n    </Button>\n  );\n  // Not after a chunk failure: `React.lazy` keeps the rejected import, so Try again\n  // could only throw the same error again.\n  const retryButton = chunk ? null : (\n    <Button key=\"retry\" variant={mode === \"error\" ? \"primary\" : \"secondary\"} onClick={reset}>\n      {text.retry}\n    </Button>\n  );\n\n  return (\n    <EmptyState\n      role=\"alert\"\n      tone={mode === \"error\" ? \"danger\" : undefined}\n      headingAs={headingAs}\n      className={className}\n      icon={<Icon />}\n      title={title}\n      hint={hint}\n      action={\n        <>\n          {showMessage && mode === \"error\" && (\n            // A quotation, not prose: left-aligned and monospaced, so it reads as the\n            // program's words and can be read out or screenshotted verbatim.\n            <p\n              data-error-message=\"\"\n              className=\"-mt-1 mb-1 basis-full whitespace-pre-wrap break-words rounded-md border border-[var(--danger-border)] bg-[var(--danger-bg)] px-3 py-2 text-start font-mono text-xs text-[var(--text-primary)]\"\n            >\n              {errorLine}\n            </p>\n          )}\n          {filing === \"filed\" && (\n            <p className=\"-mt-1 mb-1 basis-full text-xs\">\n              {reference ? text.reportedAs(reference) : text.reported}\n            </p>\n          )}\n          {mode === \"error\" ? [retryButton, reloadButton] : [reloadButton, retryButton]}\n          {copyReport && reportText !== null && filing !== \"filed\" && (\n            <CopyButton variant=\"label\" buttonVariant=\"ghost\" label={text.copyReport} text={reportText} />\n          )}\n          {actions}\n          {showDetails && reportText !== null && (\n            <Disclosure variant=\"bare\" title={text.details} className=\"basis-full text-start\">\n              <pre className=\"max-h-60 overflow-auto whitespace-pre-wrap break-words text-xs text-[var(--text-secondary)]\">\n                {reportText}\n              </pre>\n            </Disclosure>\n          )}\n        </>\n      }\n    />\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/components/error-boundary.tsx"],"sourcesContent":["import { Component } from \"react\";\nimport type { ErrorInfo, ReactNode } from \"react\";\nimport { AlertTriangle, RefreshCw, WifiOff } from \"lucide-react\";\nimport { useKitLabels } from \"../i18n/kit-labels\";\nimport { Button, EmptyState } from \"./ui\";\nimport { CopyButton } from \"./copy-button\";\nimport { Disclosure } from \"./disclosure\";\n\n/** The words of the default fallback. */\nexport interface ErrorBoundaryLabels {\n  /** The fallback's heading. */\n  title: string;\n  /** The line under it. */\n  message: string;\n  /** The button that clears the error and renders the children again. */\n  retry: string;\n  /** The disclosure that opens the full error report (`showDetails`). */\n  details: string;\n  /** The button that reloads the whole page (0.13). */\n  reload: string;\n  /** Heading when a lazy chunk failed to load while online — a deploy replaced the\n   *  files this page was built from (0.13). */\n  updateTitle: string;\n  updateMessage: string;\n  /** Heading when the browser says it is offline (0.13). */\n  offlineTitle: string;\n  offlineMessage: string;\n  /** The copy button's words: what it copies is the plain-text report (0.13). */\n  copyReport: string;\n  /** Shown once `onReport` has filed the crash and returned no reference (0.13). */\n  reported: string;\n  /** Shown once `onReport` has filed the crash under a reference — rendered as the\n   *  app returned it, so return `\"#123\"` if the hash belongs to it (0.13). */\n  reportedAs: (reference: string) => string;\n}\n\nexport const DEFAULT_ERROR_BOUNDARY_LABELS: ErrorBoundaryLabels = {\n  title: \"Something went wrong\",\n  message: \"This part of the page could not be shown. Try again, or reload the page.\",\n  retry: \"Try again\",\n  details: \"Error details\",\n  reload: \"Reload\",\n  updateTitle: \"A new version is available\",\n  updateMessage: \"Part of the app has changed since this page was loaded. Reload to get the new version.\",\n  offlineTitle: \"You’re offline\",\n  offlineMessage: \"This page could not be loaded without a connection. Reconnect, then reload the page.\",\n  copyReport: \"Copy error report\",\n  reported: \"This error has been reported automatically.\",\n  reportedAs: (reference) => `Reported as ${reference}`,\n};\n\n/**\n * What was thrown, as flat strings, read ONCE when it arrives.\n *\n * React stores whatever was thrown, hostile or not — `throw { get message() { throw … } }`,\n * `throw { name: Symbol() }`, `throw undefined` — and reading one of those during the\n * fallback's own render would throw INSIDE the boundary, escalating to the next one up\n * (keksdose's error-boundary.tsx learned this as feedback #160: at the app level there is\n * none, and the result is the white screen the boundary exists to prevent).\n */\nexport interface ErrorBoundaryDetails {\n  name: string;\n  message: string;\n  stack?: string;\n}\n\nfunction read(get: () => unknown): string | undefined {\n  try {\n    const v = get();\n    return typeof v === \"string\" ? v : v === undefined || v === null ? undefined : String(v);\n  } catch {\n    return undefined;\n  }\n}\n\n/** `JSON.stringify` that never throws (a cycle, a BigInt, a hostile getter) and never\n *  returns more than 500 characters. \"\" when there is nothing to say. */\nfunction safeJson(value: unknown): string {\n  try {\n    const json = JSON.stringify(value);\n    if (!json || json === \"{}\") return \"\";\n    return json.length > 500 ? `${json.slice(0, 499)}…` : json;\n  } catch {\n    return \"\";\n  }\n}\n\n/** {@link ErrorBoundaryDetails} of any thrown value, without ever throwing. */\nexport function describeThrown(error: unknown): ErrorBoundaryDetails {\n  if (typeof error === \"object\" && error !== null) {\n    const e = error as { name?: unknown; message?: unknown; stack?: unknown };\n    const message = read(() => e.message) ?? \"\";\n    return {\n      name: read(() => e.name) ?? \"Error\",\n      // `throw { code: 500 }` has no message, and an empty line leaves crash triage with\n      // nothing (keksdose G3a; its old reporter filed `{\"code\":500}`). Such a value is\n      // quoted as JSON instead, capped, and never at the cost of a throw.\n      message: message || (error instanceof Error ? \"\" : safeJson(error)),\n      stack: read(() => e.stack),\n    };\n  }\n  return { name: \"Error\", message: read(() => error) ?? \"\" };\n}\n\n/**\n * Is this a failed lazy import — a route chunk that did not arrive?\n *\n * Two causes, and neither is a bug in the page: the device is offline and the chunk was\n * never cached, or a deploy replaced the hashed files the running page still points at.\n * Both are cured by a reload and by nothing else — `React.lazy` caches the rejected\n * import, so Try again re-throws the same error without fetching. The patterns are\n * keksdose's (crash-report.ts), which covers Vite (\"dynamically imported module\",\n * \"module script failed\"), webpack (\"ChunkLoadError\", \"Loading chunk\") and the bare\n * `fetch` failure a service worker hands back.\n *\n * Never throws: it runs inside the fallback's own render, where a throw is a white\n * screen. An error it cannot read is not a chunk failure.\n */\nexport function isChunkLoadError(\n  error: { name?: string | null; message?: string | null } | null | undefined,\n): boolean {\n  try {\n    const s = `${error?.name ?? \"\"} ${error?.message ?? \"\"}`;\n    return /ChunkLoadError|dynamically imported module|module script failed|Loading chunk|Failed to fetch/i.test(s);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Everything a crash report carries, read once when the boundary catches.\n *\n * Plain strings only, so it survives `JSON.stringify` into an app's crash endpoint as is\n * and {@link formatCrashReport} can print it without a single guard. The wording of the\n * printed report is English on purpose: it is read by whoever fixes the bug, not by the\n * user who copies it, and a report in nine languages cannot be searched.\n */\nexport interface CrashReport {\n  /** The thrown value's `name` (\"TypeError\"), \"Error\" for a non-object. */\n  name: string;\n  message: string;\n  stack?: string;\n  /** React's component stack from `componentDidCatch` — the part that names the\n   *  component, which a minified JS stack no longer does. */\n  componentStack?: string;\n  /** `pathname + search` at the moment of the crash. The search may carry what the\n   *  user typed — see `redact`. */\n  page: string;\n  /** ISO 8601, UTC. */\n  time: string;\n  userAgent: string;\n  /** The boundary's `appVersion` prop. */\n  appVersion?: string;\n  /** The boundary's `placement` prop (\"app\", \"page\", \"widget\"): which boundary caught\n   *  it, so triage can tell a whole-app crash from one page's (keksdose G3b). */\n  placement?: string;\n  /** `navigator.onLine` at the moment of the crash; left out where there is none. */\n  online?: boolean;\n  /** {@link isChunkLoadError} of the thrown value. Such a crash is never handed to\n   *  `onReport` — it is a deploy or a dropped connection, not a defect — but it is\n   *  still in the copied report. */\n  chunkLoad: boolean;\n  /** The boundary's `reportExtras()`, stringified. */\n  extras: Record<string, string>;\n}\n\n/**\n * The report as one plain-text block — what the copy button puts on the clipboard and\n * the details disclosure shows.\n *\n * lenkbank's layout, because that is the one that was already being pasted into\n * feedback messages: the error line first (it is what a search for the bug matches),\n * then where / when / what, then the two stacks.\n */\nexport function formatCrashReport(report: CrashReport): string {\n  const lines = [\n    report.message ? `${report.name}: ${report.message}` : report.name,\n    `Page: ${report.page}`,\n    `Time: ${report.time}`,\n    `User agent: ${report.userAgent}`,\n  ];\n  if (report.appVersion) lines.push(`App version: ${report.appVersion}`);\n  if (report.placement) lines.push(`Placement: ${report.placement}`);\n  if (report.online === false) lines.push(\"Online: no\");\n  for (const [key, value] of Object.entries(report.extras)) lines.push(`${key}: ${value}`);\n  if (report.stack) lines.push(\"\", \"Stack:\", report.stack.trim());\n  if (report.componentStack) lines.push(\"\", \"Component stack:\", report.componentStack.trim());\n  return lines.join(\"\\n\");\n}\n\n/**\n * A key for \"the same crash again\": the error's name and message and the first frames\n * of its stack.\n *\n * Page-load local, not a server-side grouping key (keksdose's crash-report.ts draws the\n * same line): its only job is to stop one page load filing one bug twice — React's dev\n * StrictMode, a Try again that crashes again, a render loop that trips the boundary many\n * times a second. The page and the time are left out on purpose: the same bug on two\n * routes is still one bug.\n */\nexport function crashFingerprint(\n  report: Pick<CrashReport, \"name\" | \"message\" | \"stack\"> & Pick<Partial<CrashReport>, \"placement\">,\n): string {\n  const frames = (report.stack ?? \"\").split(\"\\n\").slice(0, 4).join(\"|\");\n  // The placement is part of it (keksdose G3b): the same error caught by the page\n  // boundary and, after Try again fails, by the app boundary is two facts for triage.\n  const where = report.placement ? `${report.placement}::` : \"\";\n  return `${where}${report.name}::${report.message}::${frames}`;\n}\n\n/**\n * What `onReport` may resolve with. `{ reference }` is shown (\"Reported as …\");\n * nothing (or `{}`) means filed without one. `{ filed: false }` says the app decided NOT\n * to file (a demo session, a hot-reload artefact, a report buffered for later): the\n * screen then claims nothing and keeps the copy button — claiming a report that was\n * never sent is the same false statement as hiding one that was.\n */\nexport type CrashReportResult = { reference?: string; filed?: boolean } | void;\n\ninterface Filing {\n  filed: boolean;\n  reference?: string;\n}\n\nconst NOT_FILED: Filing = { filed: false };\n\n/** A render loop can trip a boundary dozens of times a second with a different message\n *  each time (a counter in it); without a ceiling the first bad deploy files hundreds of\n *  rows. keksdose's number. */\nconst MAX_REPORTS_PER_PAGE_LOAD = 5;\n\n/** Fingerprint → the one filing for it in this page load. Module scope IS the page\n *  load: a reload starts it empty. A duplicate gets the first filing's promise, so the\n *  second screen shows the same reference instead of claiming nothing. */\nconst filings = new Map<string, Promise<Filing>>();\n\nfunction settle(out: unknown): Filing {\n  try {\n    if (out && typeof out === \"object\") {\n      const o = out as { filed?: unknown; reference?: unknown };\n      if (o.filed === false) return NOT_FILED;\n      const reference = typeof o.reference === \"string\" && o.reference ? o.reference : undefined;\n      return { filed: true, reference };\n    }\n    return { filed: true };\n  } catch {\n    return NOT_FILED;\n  }\n}\n\n/** Hand the report to the app, once per fingerprint per page load, and never throw —\n *  not for a synchronous throw, a rejection, or a hostile thenable. */\nfunction fileOnce(report: CrashReport, onReport: (report: CrashReport) => unknown): Promise<Filing> {\n  const key = crashFingerprint(report);\n  const known = filings.get(key);\n  if (known) return known;\n  if (filings.size >= MAX_REPORTS_PER_PAGE_LOAD) return Promise.resolve(NOT_FILED);\n  let filing: Promise<Filing>;\n  try {\n    filing = Promise.resolve(onReport(report)).then(settle, () => NOT_FILED);\n  } catch {\n    filing = Promise.resolve(NOT_FILED);\n  }\n  // Claimed before the first await: two catches in the same tick (StrictMode) must not\n  // both get past the lookup above.\n  filings.set(key, filing);\n  return filing;\n}\n\nfunction isOffline(): boolean {\n  try {\n    return typeof navigator !== \"undefined\" && navigator.onLine === false;\n  } catch {\n    return false;\n  }\n}\n\nfunction reloadPage(): void {\n  try {\n    window.location.reload();\n  } catch {\n    /* nothing left to do from here */\n  }\n}\n\n/** What a render-prop `fallback` is handed. */\nexport interface ErrorBoundaryFallbackProps {\n  /** The thrown value, as it was thrown. Read it with care — see {@link describeThrown}. */\n  error: unknown;\n  details: ErrorBoundaryDetails;\n  /** Clear the error and render the children again. */\n  reset: () => void;\n  /** The crash report, once `componentDidCatch` has built it (null on the very first\n   *  render of the fallback, which happens before it). Already `redact`ed. */\n  report: CrashReport | null;\n}\n\nexport interface ErrorBoundaryProps {\n  children?: ReactNode;\n  /** Replaces the default fallback: a node, or a render function handed the error and\n   *  a `reset`. The same rule applies to it as to the default: see the component docs. */\n  fallback?: ReactNode | ((props: ErrorBoundaryFallbackProps) => ReactNode);\n  /** Called once per caught error with the raw value — log it. A throw from it is\n   *  swallowed: the boundary is the last thing standing. For filing a report, prefer\n   *  `onReport`, which gets the finished report, dedupe and the reference on screen. */\n  onError?: (error: unknown, info: ErrorInfo) => void;\n  /** Called when the error is cleared, by Try again, `reset` or a `resetKeys` change —\n   *  drop a cache, refetch. */\n  onReset?: () => void;\n  /**\n   * When any of these changes (compared with `Object.is`) AFTER an error was caught, the\n   * error is cleared and the children render again — a change in the same update that\n   * threw does not count (it is what the error was shown under) — pass the route path so leaving a broken page does not\n   * carry its fallback to the next one (keksdose's `resetKey`).\n   */\n  resetKeys?: ReadonlyArray<unknown>;\n  /** Quote the error's `name: message` in a monospace box under the hint. Default on\n   *  (0.13): three sentences true of every crash identify none of them, and the one\n   *  line that does is what a user can read out or screenshot (lenkbank P7). Not shown\n   *  for a chunk-load / offline screen, where the message is a URL that explains\n   *  nothing the title does not. */\n  showMessage?: boolean;\n  /** A collapsed disclosure holding the full plain-text report. Default on since 0.13\n   *  (it was an opt-in showing name, message and stack): closed, it costs one line, and\n   *  it is where a support conversation asks the user to look. */\n  showDetails?: boolean;\n  /** The copy button for the plain-text report (the kit's CopyButton, which says when\n   *  the clipboard refused). Default on. Hidden once `onReport` has filed the crash —\n   *  there is nothing left to paste anywhere — and shown again whenever it did not. */\n  copyReport?: boolean;\n  /** The app's version, printed in the report — the first question on every crash. */\n  appVersion?: string;\n  /** Which boundary this is — \"app\" at the root, \"page\" in the layout — carried into\n   *  the report (`placement`) and its fingerprint, so `onReport` needs no closure to say\n   *  where the crash was caught (keksdose G3b). */\n  placement?: string;\n  /** More `key: value` lines for the report, read when the boundary catches (a tenant\n   *  id, the feature flags). A throw from it is swallowed and the lines are left out. */\n  reportExtras?: () => Record<string, string>;\n  /**\n   * Rewrite the report before anything sees it: the screen, the clipboard and\n   * `onReport` all get the returned one.\n   *\n   * THE REPORT IS STRUCTURE, NEVER CONTENT — and only the app knows which of its query\n   * params hold content. keksdose's register put the free-text search in `?q=` and payee\n   * names in the `f.*` filters, and its crash channel sent them in the clear to a column\n   * every admin reads (crash-report.ts `safeUrl`). The cure there is an ALLOW-list, so a\n   * param added later is dropped until somebody decides otherwise — rebuild `page`\n   * from `new URL(r.page, location.origin)`, keeping only the listed `searchParams`.\n   * `extras` are the app's own and need no second pass. A throw from `redact` falls\n   * back to the pathname alone and no extras — failing closed.\n   *\n   * The same holds inside `onReport`, which is the other place to do it: clamp fields\n   * to what the endpoint accepts, drop what it must not store. The kit cannot know.\n   */\n  redact?: (report: CrashReport) => CrashReport;\n  /**\n   * File the report automatically. Called from `componentDidCatch`, at most once per\n   * {@link crashFingerprint} per page load (and at most five times in all), never for a\n   * chunk-load error. It can NOT throw into the boundary: a synchronous throw and a\n   * rejection both read as \"not filed\", and the copy button stays.\n   *\n   * Resolve with `{ reference }` and the screen says \"Reported as …\" instead of the copy\n   * button; see {@link CrashReportResult} for \"filed without a reference\" and \"decided not\n   * to file\". Whatever the app's reporter does, it must do without the router, the query\n   * client or the auth store's hooks — a bare `fetch` with `keepalive`, so it survives\n   * the reload the user is about to press (keksdose crash-report.ts `post`).\n   */\n  onReport?: (report: CrashReport) => Promise<CrashReportResult> | CrashReportResult;\n  /** The app's own escape hatches, beside Reload / Try again — keksdose's \"Clear local\n   *  data\" for a poisoned persisted cache that no in-app action could otherwise break.\n   *  A full-width hint under it: wrap it in `<div className=\"basis-full\">`. */\n  actions?: ReactNode;\n  /** The default fallback's heading level. Default `h2`: the fallback often IS the page. */\n  headingAs?: \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\";\n  /** Classes for the default fallback's box (`m-8 min-h-[400px]`, kastlan). */\n  className?: string;\n  labels?: Partial<ErrorBoundaryLabels>;\n}\n\ntype FilingState = \"none\" | \"pending\" | \"filed\" | \"failed\";\n\ninterface ErrorBoundaryState {\n  /** A flag of its own, so `throw undefined` is still an error shown. */\n  failed: boolean;\n  error: unknown;\n  details: ErrorBoundaryDetails | null;\n  report: CrashReport | null;\n  filing: FilingState;\n  reference: string | undefined;\n}\n\nconst CLEAR: ErrorBoundaryState = {\n  failed: false,\n  error: null,\n  details: null,\n  report: null,\n  filing: \"none\",\n  reference: undefined,\n};\n\nfunction keysChanged(a: ReadonlyArray<unknown> | undefined, b: ReadonlyArray<unknown> | undefined): boolean {\n  if (a === b) return false;\n  if (!a || !b || a.length !== b.length) return true;\n  return a.some((v, i) => !Object.is(v, b[i]));\n}\n\nfunction currentPage(): { page: string; path: string } {\n  try {\n    const { pathname, search } = window.location;\n    return { page: `${pathname}${search}`, path: pathname };\n  } catch {\n    return { page: \"\", path: \"\" };\n  }\n}\n\nfunction buildReport(details: ErrorBoundaryDetails, componentStack: string | undefined, props: ErrorBoundaryProps): CrashReport {\n  const { page, path } = currentPage();\n  const extras: Record<string, string> = {};\n  try {\n    const more = props.reportExtras?.();\n    if (more) for (const [k, v] of Object.entries(more)) extras[k] = String(v);\n  } catch {\n    /* documented: the lines are left out */\n  }\n  let userAgent = \"\";\n  let online: boolean | undefined;\n  try {\n    userAgent = navigator.userAgent;\n    online = typeof navigator.onLine === \"boolean\" ? navigator.onLine : undefined;\n  } catch {\n    /* no navigator (SSR, a worker test) */\n  }\n  const report: CrashReport = {\n    name: details.name,\n    message: details.message,\n    stack: details.stack,\n    componentStack: componentStack ?? undefined,\n    page,\n    time: new Date().toISOString(),\n    userAgent,\n    appVersion: props.appVersion,\n    placement: props.placement,\n    online,\n    chunkLoad: isChunkLoadError(details),\n    extras,\n  };\n  if (!props.redact) return report;\n  try {\n    return props.redact(report);\n  } catch {\n    // Fail closed: an app that asked for redaction must not get the unredacted page.\n    return { ...report, page: path, extras: {} };\n  }\n}\n\n/**\n * Catch a render error below it and show ONE crash screen instead of an empty page.\n *\n * The three apps each built one. kastlan's and keksdose's sat on `EmptyState\n * tone=\"danger\"`; lenkbank's quoted the error and offered a plain-text report to copy;\n * keksdose's filed the crash itself, told a lazy-chunk failure apart as \"offline\", and\n * offered \"clear local data\" when a poisoned cache made Retry useless (feedback #160).\n * This is all of that, so the apps reduce to\n * `<ErrorBoundary resetKeys={[pathname]} appVersion={__VERSION__} />` plus, for an app\n * with a crash endpoint, `onReport` and `actions`:\n *\n * - the error's `name: message`, quoted (`showMessage`);\n * - Try again (reset the boundary) AND Reload (the page) — Try again alone re-renders\n *   the same subtree from the same state, which a deterministic crash survives;\n * - a chunk-load error or an offline browser gets its own title and Reload first\n *   (\"A new version is available\" / \"You're offline\");\n * - the copy button and the report in a disclosure; `onReport` for filing it, deduped\n *   per page load, with its reference on screen.\n *\n * THE RULE for this fallback — and for a `fallback` or `actions` an app passes in: it\n * must not depend on the router, the query client or the auth store. A crash is exactly\n * when those may be what broke, and a fallback that throws escalates to the next\n * boundary up — at the app level there is none, and the user gets the white screen this\n * exists to prevent. So no `useNavigate`, no `useQuery`, no `useAuth()` in it; reload\n * with `window.location`, not the router. The kit's own label hooks are the one context\n * it does read (`errorBoundary.*` from `UiKitProvider`), and they degrade to the English\n * defaults when there is no provider above — which is why the app-level boundary may\n * sit OUTSIDE the provider and still render.\n *\n * The fallback is `role=\"alert\"`: a page replaced by an error is news, and a reader\n * that was on it is told.\n */\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\n  state: ErrorBoundaryState = CLEAR;\n\n  /** Bumped by every catch and reset, so a filing that settles after the screen moved\n   *  on (Try again, a route change, a second crash) does not write into it. */\n  private generation = 0;\n\n  /**\n   * Forget which crashes this page load has filed, and the count towards the cap.\n   *\n   * For tests: the dedupe lives in module scope because a page load is what it spans,\n   * and a test file is one page load — so without this, the sixth test that files a\n   * report finds the cap reached and `onReport` never called. Call it in `beforeEach`.\n   * Never needed in an app: a reload is the reset.\n   */\n  static forgetReports(): void {\n    filings.clear();\n  }\n\n  static getDerivedStateFromError(error: unknown): Partial<ErrorBoundaryState> {\n    return { failed: true, error, details: describeThrown(error), report: null, filing: \"none\", reference: undefined };\n  }\n\n  componentDidCatch(error: unknown, info: ErrorInfo): void {\n    try {\n      this.props.onError?.(error, info);\n    } catch {\n      /* documented: a logger must not take the fallback down */\n    }\n    const details = this.state.details ?? describeThrown(error);\n    const report = buildReport(details, info.componentStack ?? undefined, this.props);\n    const { onReport } = this.props;\n    const willFile = onReport !== undefined && !report.chunkLoad;\n    const generation = ++this.generation;\n    this.setState({ report, filing: willFile ? \"pending\" : \"none\", reference: undefined });\n    if (!willFile) return;\n    void fileOnce(report, onReport).then((filing) => {\n      if (generation !== this.generation) return;\n      this.setState(\n        filing.filed ? { filing: \"filed\", reference: filing.reference } : { filing: \"failed\", reference: undefined },\n      );\n    });\n  }\n\n  componentDidUpdate(prev: ErrorBoundaryProps, prevState: ErrorBoundaryState): void {\n    // Only a change AFTER the error was caught clears it (react-error-boundary's rule).\n    // `prevState.failed` is false in the update that caught it: that update may well be\n    // the one that changed the keys too — a navigation to a page that throws, with\n    // `resetKeys={[pathname]}` — and resetting then would fire `onReset` for nothing and\n    // render the failing child a second time. From then on `prev.resetKeys` are the\n    // keys the error was shown under, so any change clears it.\n    if (this.state.failed && prevState.failed && keysChanged(prev.resetKeys, this.props.resetKeys)) {\n      this.reset();\n    }\n  }\n\n  reset = (): void => {\n    this.generation++;\n    this.props.onReset?.();\n    this.setState(CLEAR);\n  };\n\n  render(): ReactNode {\n    const { failed, error, details, report, filing, reference } = this.state;\n    if (!failed || !details) return this.props.children;\n    const { fallback } = this.props;\n    if (typeof fallback === \"function\") return fallback({ error, details, reset: this.reset, report });\n    if (fallback !== undefined) return fallback;\n    return (\n      <ErrorFallback\n        details={details}\n        report={report}\n        filing={filing}\n        reference={reference}\n        reset={this.reset}\n        showMessage={this.props.showMessage ?? true}\n        showDetails={this.props.showDetails ?? true}\n        copyReport={this.props.copyReport ?? true}\n        actions={this.props.actions}\n        headingAs={this.props.headingAs ?? \"h2\"}\n        className={this.props.className}\n        labels={this.props.labels}\n      />\n    );\n  }\n}\n\nfunction ErrorFallback({\n  details,\n  report,\n  filing,\n  reference,\n  reset,\n  showMessage,\n  showDetails,\n  copyReport,\n  actions,\n  headingAs,\n  className,\n  labels,\n}: {\n  details: ErrorBoundaryDetails;\n  report: CrashReport | null;\n  filing: FilingState;\n  reference: string | undefined;\n  reset: () => void;\n  showMessage: boolean;\n  showDetails: boolean;\n  copyReport: boolean;\n  actions?: ReactNode;\n  headingAs: NonNullable<ErrorBoundaryProps[\"headingAs\"]>;\n  className?: string;\n  labels?: Partial<ErrorBoundaryLabels>;\n}) {\n  const text = useKitLabels(\"errorBoundary\", DEFAULT_ERROR_BOUNDARY_LABELS, labels);\n  const chunk = isChunkLoadError(details);\n  // Offline first, as keksdose has it: offline, a chunk failure is the connection, and\n  // any other crash most likely a request that could not be made — either way \"reload\n  // once you are back\" is the advice, and \"a new version\" would be a false one.\n  const mode = isOffline() ? \"offline\" : chunk ? \"update\" : \"error\";\n  const title = mode === \"offline\" ? text.offlineTitle : mode === \"update\" ? text.updateTitle : text.title;\n  const hint = mode === \"offline\" ? text.offlineMessage : mode === \"update\" ? text.updateMessage : text.message;\n  const Icon = mode === \"offline\" ? WifiOff : mode === \"update\" ? RefreshCw : AlertTriangle;\n  const reportText = report ? formatCrashReport(report) : null;\n  const errorLine = details.message ? `${details.name}: ${details.message}` : details.name;\n\n  const reloadButton = (\n    <Button key=\"reload\" variant={mode === \"error\" ? \"secondary\" : \"primary\"} onClick={reloadPage}>\n      {text.reload}\n    </Button>\n  );\n  // Not after a chunk failure: `React.lazy` keeps the rejected import, so Try again\n  // could only throw the same error again.\n  const retryButton = chunk ? null : (\n    <Button key=\"retry\" variant={mode === \"error\" ? \"primary\" : \"secondary\"} onClick={reset}>\n      {text.retry}\n    </Button>\n  );\n\n  return (\n    <EmptyState\n      role=\"alert\"\n      tone={mode === \"error\" ? \"danger\" : undefined}\n      headingAs={headingAs}\n      className={className}\n      icon={<Icon />}\n      title={title}\n      hint={hint}\n      action={\n        <>\n          {showMessage && mode === \"error\" && (\n            // A quotation, not prose: left-aligned and monospaced, so it reads as the\n            // program's words and can be read out or screenshotted verbatim.\n            <p\n              data-error-message=\"\"\n              className=\"-mt-1 mb-1 basis-full whitespace-pre-wrap break-words rounded-md border border-[var(--danger-border)] bg-[var(--danger-bg)] px-3 py-2 text-start font-mono text-xs text-[var(--text-primary)]\"\n            >\n              {errorLine}\n            </p>\n          )}\n          {filing === \"filed\" && (\n            <p className=\"-mt-1 mb-1 basis-full text-xs\">\n              {reference ? text.reportedAs(reference) : text.reported}\n            </p>\n          )}\n          {mode === \"error\" ? [retryButton, reloadButton] : [reloadButton, retryButton]}\n          {copyReport && reportText !== null && filing !== \"filed\" && (\n            <CopyButton variant=\"label\" buttonVariant=\"ghost\" label={text.copyReport} text={reportText} />\n          )}\n          {actions}\n          {showDetails && reportText !== null && (\n            <Disclosure variant=\"bare\" title={text.details} className=\"basis-full text-start\">\n              <pre className=\"max-h-60 overflow-auto whitespace-pre-wrap break-words text-xs text-[var(--text-secondary)]\">\n                {reportText}\n              </pre>\n            </Disclosure>\n          )}\n        </>\n      }\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/page-header.d.ts

@@ -20,6 +20,13 @@ type PageHeaderSize = "sm" | "compact" | "md";
  * layouts are one row: title block at the start, actions at the end.
  */
 type PageHeaderMobileLayout = "stacked" | "inline";
+/**
+ * Where the actions sit on the title block's height, in the one row the header is from
+ * `sm` up (and on a phone too when {@link PageHeaderMobileLayout} is `inline`, the only
+ * layout that has a row there). Unset keeps each layout's own: `start` for `stacked`,
+ * `center` for `inline`.
+ */
+type PageHeaderActionsAlign = "start" | "center" | "end";
 interface PageHeaderProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
     title: ReactNode;
     /** A sentence under the title. */
@@ -49,6 +56,52 @@ interface PageHeaderProps extends Omit<ComponentPropsWithoutRef<"div">, "title">
      * button, a month picker); a long title wraps to make room for them instead.
      */
     mobileLayout?: PageHeaderMobileLayout;
+    /**
+     * A second group of actions that gets its OWN full-width row under the header on a
+     * phone, and joins the actions' row from `sm` up, between the title and
+     * {@link actions}.
+     *
+     * keksdose's budget page (budget-page.tsx, feedback #60) is the case: title and month
+     * navigation on row 1, the fold/unfold toggles on row 2 on a phone — "two tidy rows
+     * instead of the old ragged justify-between overflow" — and one row, title | toggles |
+     * month nav, on a wider screen. It builds that by hand with a wrapping flex row and
+     * swapped order utilities; adopting `PageHeader` (keksdose G6b) must not lose it.
+     * There: `actions` is the month navigation, this is the toggles.
+     *
+     * The DOM order is title, `actions`, `secondaryActions` — the phone's visual order,
+     * and the one a screen reader and the Tab key follow at every width. From `sm` up the
+     * two groups swap places visually only, which keeps the page's primary control (the
+     * month) at the row's end, where keksdose had it, and first in reading order. The
+     * breakpoint is `sm`, the one {@link mobileLayout} switches at, not keksdose's `md`:
+     * one header, one breakpoint.
+     */
+    secondaryActions?: ReactNode;
+    /**
+     * The actions' vertical alignment against the title block — see
+     * {@link PageHeaderActionsAlign}. Unset keeps the layout's own.
+     *
+     * keksdose's reports page (reports-page.tsx, keksdose G8) carries a LABELLED
+     * `CurrencySelect` as its action: a field with its label on top is taller than the
+     * title, and `stacked`'s default top alignment hangs it from the title's cap height
+     * with its control well below the title's line. `center` sets it on the title's
+     * middle, as that page's hand-written `items-center` row did.
+     */
+    actionsAlign?: PageHeaderActionsAlign;
+    /**
+     * One line, cut with an ellipsis, instead of the default breaking of a long word onto
+     * as many lines as it needs.
+     *
+     * keksdose's payees page (payees-page.tsx, live #263, keksdose G6a) wraps its title in
+     * its own truncating span so a long name gives way to the `inline` header's actions
+     * instead of pushing them. This is that span's behaviour on the heading itself; the
+     * title block is already allowed to shrink below its content, which is what lets the
+     * cut happen inside a flex row.
+     *
+     * The full title stays in the DOM as the heading's text, so a screen reader and the
+     * document outline read all of it. There is deliberately no native `title` tooltip:
+     * the kit does not use them (not on touch, not on keyboard focus, not styled).
+     */
+    truncateTitle?: boolean;
 }
 /**
  * A page's head: optional breadcrumbs, an eyebrow, the title, a description, and the
@@ -61,6 +114,6 @@ interface PageHeaderProps extends Omit<ComponentPropsWithoutRef<"div">, "title">
  * than fit a phone's width, instead of running off it. No outer margin: the page's
  * own rhythm (`space-y-*`, a grid gap) places it.
  */
-declare function PageHeader({ title, description, actions, breadcrumbs, eyebrow, as, size, mobileLayout, className, ...rest }: PageHeaderProps): react.JSX.Element;
+declare function PageHeader({ title, description, actions, breadcrumbs, eyebrow, as, size, mobileLayout, secondaryActions, actionsAlign, truncateTitle, className, ...rest }: PageHeaderProps): react.JSX.Element;
 
-export { PageHeader, type PageHeaderMobileLayout, type PageHeaderProps, type PageHeaderSize };
+export { PageHeader, type PageHeaderActionsAlign, type PageHeaderMobileLayout, type PageHeaderProps, type PageHeaderSize };

package/dist/components/page-header.js

@@ -11,6 +11,10 @@ const ROW = {
   stacked: "flex-col gap-3 sm:flex-row sm:items-start sm:justify-between sm:gap-4",
   inline: "flex-row items-center justify-between gap-2 sm:gap-4"
 };
+const ACTIONS_ALIGN = {
+  stacked: { start: "sm:self-start", center: "sm:self-center", end: "sm:self-end" },
+  inline: { start: "self-start", center: "self-center", end: "self-end" }
+};
 function PageHeader({
   title,
   description,
@@ -20,19 +24,46 @@ function PageHeader({
   as = "h1",
   size = "md",
   mobileLayout = "stacked",
+  secondaryActions,
+  actionsAlign,
+  truncateTitle = false,
   className,
   ...rest
 }) {
   const Heading = as;
+  const hasSecondary = secondaryActions != null;
+  const wrapsSecondary = hasSecondary && mobileLayout === "inline";
+  const align = actionsAlign != null ? ACTIONS_ALIGN[mobileLayout][actionsAlign] : void 0;
   return /* @__PURE__ */ jsxs("div", { ...rest, className: cn("flex min-w-0 flex-col gap-2", className), children: [
     breadcrumbs,
-    /* @__PURE__ */ jsxs("div", { className: cn("flex min-w-0", ROW[mobileLayout]), children: [
+    /* @__PURE__ */ jsxs("div", { className: cn("flex min-w-0", ROW[mobileLayout], wrapsSecondary && "flex-wrap sm:flex-nowrap"), children: [
       /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
         eyebrow != null && /* @__PURE__ */ jsx("p", { className: cn(SECTION_LABEL_CLASS.xs, "mb-1"), children: eyebrow }),
-        /* @__PURE__ */ jsx(Heading, { className: cn("break-words text-[var(--text-primary)]", TITLE[size]), children: title }),
+        /* @__PURE__ */ jsx(
+          Heading,
+          {
+            className: cn(
+              truncateTitle ? "truncate" : "break-words",
+              "text-[var(--text-primary)]",
+              TITLE[size]
+            ),
+            children: title
+          }
+        ),
         description != null && /* @__PURE__ */ jsx("p", { className: "mt-1 text-sm text-[var(--text-muted)]", children: description })
       ] }),
-      actions != null && /* @__PURE__ */ jsx("div", { className: "flex shrink-0 flex-wrap items-center gap-2", children: actions })
+      actions != null && /* @__PURE__ */ jsx("div", { className: cn("flex shrink-0 flex-wrap items-center gap-2", hasSecondary && "sm:order-2", align), children: actions }),
+      hasSecondary && /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: cn(
+            "flex flex-wrap items-center gap-2 sm:order-1 sm:shrink-0",
+            wrapsSecondary && "basis-full sm:basis-auto",
+            align
+          ),
+          children: secondaryActions
+        }
+      )
     ] })
   ] });
 }

package/dist/components/page-header.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/components/page-header.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ElementType, ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { SECTION_LABEL_CLASS } from \"./text\";\n\n/**\n * `md` (default) is kastlan's `text-2xl` page title from `sm` up, a step smaller on a\n * phone; `sm` is lenkbank's `text-lg` title on a dense tool page (projects-page.tsx).\n *\n * `compact` (0.13) is keksdose's page title (keksdose F4): `text-xl font-semibold` at\n * EVERY width — budgets, rules, accounts, transactions and budget pages all write\n * exactly that `<h1>` by hand. It is `md`'s phone size without `md`'s step up to\n * `text-2xl` on a wider screen, and without its `tracking-tight`, which keksdose's\n * titles never had. A word and not a letter for the reason `ProgressBar`'s `slim` is\n * one: the letters are taken in order, and there is none between `sm` and `md` — an\n * `lg` or `xl` at `text-xl` would read as LARGER than `md`, which from `sm` up it is\n * not.\n */\nexport type PageHeaderSize = \"sm\" | \"compact\" | \"md\";\n\nconst TITLE: Record<PageHeaderSize, string> = {\n  sm: \"text-lg font-semibold\",\n  compact: \"text-xl font-semibold\",\n  md: \"text-xl font-semibold tracking-tight sm:text-2xl\",\n};\n\n/**\n * How the title block and the actions sit below the `sm` breakpoint. From `sm` up both\n * layouts are one row: title block at the start, actions at the end.\n */\nexport type PageHeaderMobileLayout = \"stacked\" | \"inline\";\n\nconst ROW: Record<PageHeaderMobileLayout, string> = {\n  stacked: \"flex-col gap-3 sm:flex-row sm:items-start sm:justify-between sm:gap-4\",\n  inline: \"flex-row items-center justify-between gap-2 sm:gap-4\",\n};\n\nexport interface PageHeaderProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"title\"> {\n  title: ReactNode;\n  /** A sentence under the title. */\n  description?: ReactNode;\n  /** Buttons for the page — \"New\", \"Export\". At the title's end from `sm` up; under it,\n   *  wrapping, on a phone — unless {@link mobileLayout} is `inline`. */\n  actions?: ReactNode;\n  /** A `Breadcrumbs` trail, drawn above everything else. */\n  breadcrumbs?: ReactNode;\n  /** A small uppercase line above the title — the section or the kind of record\n   *  (\"Building\", \"Settings\"). The section-label type. */\n  eyebrow?: ReactNode;\n  /** The title's element. Default `h1`: a page has one, and this is it. `h2` for a\n   *  header inside a page that already has its `h1` (a tab's own header). */\n  as?: \"h1\" | \"h2\" | \"h3\";\n  size?: PageHeaderSize;\n  /**\n   * `stacked` (default): on a phone the actions drop under the title and wrap, so a\n   * row of three buttons never pushes the title off the screen.\n   *\n   * `inline`: the actions stay beside the title on a phone too, vertically centred on\n   * it — keksdose's headers (transactions-page.tsx:515, `flex items-center\n   * justify-between gap-2`), which carry one or two icon-sized controls and were tuned\n   * for the phone in live #263. Adopting `PageHeader` must not undo that tuning, so the\n   * row stays a row (keksdose F4). The actions do NOT wrap or shrink here: `inline` is\n   * for a header whose actions are known to fit beside a phone-width title (an icon\n   * button, a month picker); a long title wraps to make room for them instead.\n   */\n  mobileLayout?: PageHeaderMobileLayout;\n}\n\n/**\n * A page's head: optional breadcrumbs, an eyebrow, the title, a description, and the\n * page's actions.\n *\n * kastlan's (shared/components/display/page-header.tsx) is the model — title and\n * description on one side, actions on the other, stacked on a phone — and this adds\n * what its pages kept writing around it: a trail above, an eyebrow, a `ReactNode`\n * title (a status chip beside the name), and actions that WRAP when there are more\n * than fit a phone's width, instead of running off it. No outer margin: the page's\n * own rhythm (`space-y-*`, a grid gap) places it.\n */\nexport function PageHeader({\n  title,\n  description,\n  actions,\n  breadcrumbs,\n  eyebrow,\n  as = \"h1\",\n  size = \"md\",\n  mobileLayout = \"stacked\",\n  className,\n  ...rest\n}: PageHeaderProps) {\n  const Heading = as as ElementType;\n  return (\n    <div {...rest} className={cn(\"flex min-w-0 flex-col gap-2\", className)}>\n      {breadcrumbs}\n      <div className={cn(\"flex min-w-0\", ROW[mobileLayout])}>\n        <div className=\"min-w-0 flex-1\">\n          {eyebrow != null && <p className={cn(SECTION_LABEL_CLASS.xs, \"mb-1\")}>{eyebrow}</p>}\n          <Heading className={cn(\"break-words text-[var(--text-primary)]\", TITLE[size])}>{title}</Heading>\n          {description != null && <p className=\"mt-1 text-sm text-[var(--text-muted)]\">{description}</p>}\n        </div>\n        {actions != null && <div className=\"flex shrink-0 flex-wrap items-center gap-2\">{actions}</div>}\n      </div>\n    </div>\n  );\n}\n"],"mappings":";AA+FQ,SACsB,KADtB;AA9FR,SAAS,UAAU;AACnB,SAAS,2BAA2B;AAiBpC,MAAM,QAAwC;AAAA,EAC5C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,IAAI;AACN;AAQA,MAAM,MAA8C;AAAA,EAClD,SAAS;AAAA,EACT,QAAQ;AACV;AA4CO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,KAAK;AAAA,EACL,OAAO;AAAA,EACP,eAAe;AAAA,EACf;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,UAAU;AAChB,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,+BAA+B,SAAS,GAClE;AAAA;AAAA,IACD,qBAAC,SAAI,WAAW,GAAG,gBAAgB,IAAI,YAAY,CAAC,GAClD;AAAA,2BAAC,SAAI,WAAU,kBACZ;AAAA,mBAAW,QAAQ,oBAAC,OAAE,WAAW,GAAG,oBAAoB,IAAI,MAAM,GAAI,mBAAQ;AAAA,QAC/E,oBAAC,WAAQ,WAAW,GAAG,0CAA0C,MAAM,IAAI,CAAC,GAAI,iBAAM;AAAA,QACrF,eAAe,QAAQ,oBAAC,OAAE,WAAU,yCAAyC,uBAAY;AAAA,SAC5F;AAAA,MACC,WAAW,QAAQ,oBAAC,SAAI,WAAU,8CAA8C,mBAAQ;AAAA,OAC3F;AAAA,KACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/components/page-header.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ElementType, ReactNode } from \"react\";\nimport { cn } from \"../lib/cn\";\nimport { SECTION_LABEL_CLASS } from \"./text\";\n\n/**\n * `md` (default) is kastlan's `text-2xl` page title from `sm` up, a step smaller on a\n * phone; `sm` is lenkbank's `text-lg` title on a dense tool page (projects-page.tsx).\n *\n * `compact` (0.13) is keksdose's page title (keksdose F4): `text-xl font-semibold` at\n * EVERY width — budgets, rules, accounts, transactions and budget pages all write\n * exactly that `<h1>` by hand. It is `md`'s phone size without `md`'s step up to\n * `text-2xl` on a wider screen, and without its `tracking-tight`, which keksdose's\n * titles never had. A word and not a letter for the reason `ProgressBar`'s `slim` is\n * one: the letters are taken in order, and there is none between `sm` and `md` — an\n * `lg` or `xl` at `text-xl` would read as LARGER than `md`, which from `sm` up it is\n * not.\n */\nexport type PageHeaderSize = \"sm\" | \"compact\" | \"md\";\n\nconst TITLE: Record<PageHeaderSize, string> = {\n  sm: \"text-lg font-semibold\",\n  compact: \"text-xl font-semibold\",\n  md: \"text-xl font-semibold tracking-tight sm:text-2xl\",\n};\n\n/**\n * How the title block and the actions sit below the `sm` breakpoint. From `sm` up both\n * layouts are one row: title block at the start, actions at the end.\n */\nexport type PageHeaderMobileLayout = \"stacked\" | \"inline\";\n\nconst ROW: Record<PageHeaderMobileLayout, string> = {\n  stacked: \"flex-col gap-3 sm:flex-row sm:items-start sm:justify-between sm:gap-4\",\n  inline: \"flex-row items-center justify-between gap-2 sm:gap-4\",\n};\n\n/**\n * Where the actions sit on the title block's height, in the one row the header is from\n * `sm` up (and on a phone too when {@link PageHeaderMobileLayout} is `inline`, the only\n * layout that has a row there). Unset keeps each layout's own: `start` for `stacked`,\n * `center` for `inline`.\n */\nexport type PageHeaderActionsAlign = \"start\" | \"center\" | \"end\";\n\n/** Per layout, because `stacked` is a column on a phone — a `self-center` there would\n *  centre the actions HORIZONTALLY — so it only aligns from `sm` up. */\nconst ACTIONS_ALIGN: Record<PageHeaderMobileLayout, Record<PageHeaderActionsAlign, string>> = {\n  stacked: { start: \"sm:self-start\", center: \"sm:self-center\", end: \"sm:self-end\" },\n  inline: { start: \"self-start\", center: \"self-center\", end: \"self-end\" },\n};\n\nexport interface PageHeaderProps extends Omit<ComponentPropsWithoutRef<\"div\">, \"title\"> {\n  title: ReactNode;\n  /** A sentence under the title. */\n  description?: ReactNode;\n  /** Buttons for the page — \"New\", \"Export\". At the title's end from `sm` up; under it,\n   *  wrapping, on a phone — unless {@link mobileLayout} is `inline`. */\n  actions?: ReactNode;\n  /** A `Breadcrumbs` trail, drawn above everything else. */\n  breadcrumbs?: ReactNode;\n  /** A small uppercase line above the title — the section or the kind of record\n   *  (\"Building\", \"Settings\"). The section-label type. */\n  eyebrow?: ReactNode;\n  /** The title's element. Default `h1`: a page has one, and this is it. `h2` for a\n   *  header inside a page that already has its `h1` (a tab's own header). */\n  as?: \"h1\" | \"h2\" | \"h3\";\n  size?: PageHeaderSize;\n  /**\n   * `stacked` (default): on a phone the actions drop under the title and wrap, so a\n   * row of three buttons never pushes the title off the screen.\n   *\n   * `inline`: the actions stay beside the title on a phone too, vertically centred on\n   * it — keksdose's headers (transactions-page.tsx:515, `flex items-center\n   * justify-between gap-2`), which carry one or two icon-sized controls and were tuned\n   * for the phone in live #263. Adopting `PageHeader` must not undo that tuning, so the\n   * row stays a row (keksdose F4). The actions do NOT wrap or shrink here: `inline` is\n   * for a header whose actions are known to fit beside a phone-width title (an icon\n   * button, a month picker); a long title wraps to make room for them instead.\n   */\n  mobileLayout?: PageHeaderMobileLayout;\n  /**\n   * A second group of actions that gets its OWN full-width row under the header on a\n   * phone, and joins the actions' row from `sm` up, between the title and\n   * {@link actions}.\n   *\n   * keksdose's budget page (budget-page.tsx, feedback #60) is the case: title and month\n   * navigation on row 1, the fold/unfold toggles on row 2 on a phone — \"two tidy rows\n   * instead of the old ragged justify-between overflow\" — and one row, title | toggles |\n   * month nav, on a wider screen. It builds that by hand with a wrapping flex row and\n   * swapped order utilities; adopting `PageHeader` (keksdose G6b) must not lose it.\n   * There: `actions` is the month navigation, this is the toggles.\n   *\n   * The DOM order is title, `actions`, `secondaryActions` — the phone's visual order,\n   * and the one a screen reader and the Tab key follow at every width. From `sm` up the\n   * two groups swap places visually only, which keeps the page's primary control (the\n   * month) at the row's end, where keksdose had it, and first in reading order. The\n   * breakpoint is `sm`, the one {@link mobileLayout} switches at, not keksdose's `md`:\n   * one header, one breakpoint.\n   */\n  secondaryActions?: ReactNode;\n  /**\n   * The actions' vertical alignment against the title block — see\n   * {@link PageHeaderActionsAlign}. Unset keeps the layout's own.\n   *\n   * keksdose's reports page (reports-page.tsx, keksdose G8) carries a LABELLED\n   * `CurrencySelect` as its action: a field with its label on top is taller than the\n   * title, and `stacked`'s default top alignment hangs it from the title's cap height\n   * with its control well below the title's line. `center` sets it on the title's\n   * middle, as that page's hand-written `items-center` row did.\n   */\n  actionsAlign?: PageHeaderActionsAlign;\n  /**\n   * One line, cut with an ellipsis, instead of the default breaking of a long word onto\n   * as many lines as it needs.\n   *\n   * keksdose's payees page (payees-page.tsx, live #263, keksdose G6a) wraps its title in\n   * its own truncating span so a long name gives way to the `inline` header's actions\n   * instead of pushing them. This is that span's behaviour on the heading itself; the\n   * title block is already allowed to shrink below its content, which is what lets the\n   * cut happen inside a flex row.\n   *\n   * The full title stays in the DOM as the heading's text, so a screen reader and the\n   * document outline read all of it. There is deliberately no native `title` tooltip:\n   * the kit does not use them (not on touch, not on keyboard focus, not styled).\n   */\n  truncateTitle?: boolean;\n}\n\n/**\n * A page's head: optional breadcrumbs, an eyebrow, the title, a description, and the\n * page's actions.\n *\n * kastlan's (shared/components/display/page-header.tsx) is the model — title and\n * description on one side, actions on the other, stacked on a phone — and this adds\n * what its pages kept writing around it: a trail above, an eyebrow, a `ReactNode`\n * title (a status chip beside the name), and actions that WRAP when there are more\n * than fit a phone's width, instead of running off it. No outer margin: the page's\n * own rhythm (`space-y-*`, a grid gap) places it.\n */\nexport function PageHeader({\n  title,\n  description,\n  actions,\n  breadcrumbs,\n  eyebrow,\n  as = \"h1\",\n  size = \"md\",\n  mobileLayout = \"stacked\",\n  secondaryActions,\n  actionsAlign,\n  truncateTitle = false,\n  className,\n  ...rest\n}: PageHeaderProps) {\n  const Heading = as as ElementType;\n  const hasSecondary = secondaryActions != null;\n  const wrapsSecondary = hasSecondary && mobileLayout === \"inline\";\n  const align = actionsAlign != null ? ACTIONS_ALIGN[mobileLayout][actionsAlign] : undefined;\n  return (\n    <div {...rest} className={cn(\"flex min-w-0 flex-col gap-2\", className)}>\n      {breadcrumbs}\n      {/* With a second group, `inline` wraps so that group's full-width basis puts it\n          on a row of its own on a phone (`stacked` is a column there already, and a\n          basis would size a column item's HEIGHT); from `sm` up the row stops wrapping\n          and the order utilities seat it between the title and the actions. Without\n          one, nothing changes. */}\n      <div className={cn(\"flex min-w-0\", ROW[mobileLayout], wrapsSecondary && \"flex-wrap sm:flex-nowrap\")}>\n        <div className=\"min-w-0 flex-1\">\n          {eyebrow != null && <p className={cn(SECTION_LABEL_CLASS.xs, \"mb-1\")}>{eyebrow}</p>}\n          <Heading\n            className={cn(\n              truncateTitle ? \"truncate\" : \"break-words\",\n              \"text-[var(--text-primary)]\",\n              TITLE[size],\n            )}\n          >\n            {title}\n          </Heading>\n          {description != null && <p className=\"mt-1 text-sm text-[var(--text-muted)]\">{description}</p>}\n        </div>\n        {actions != null && (\n          <div className={cn(\"flex shrink-0 flex-wrap items-center gap-2\", hasSecondary && \"sm:order-2\", align)}>\n            {actions}\n          </div>\n        )}\n        {hasSecondary && (\n          <div\n            className={cn(\n              \"flex flex-wrap items-center gap-2 sm:order-1 sm:shrink-0\",\n              wrapsSecondary && \"basis-full sm:basis-auto\",\n              align,\n            )}\n          >\n            {secondaryActions}\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":";AAuKQ,SACsB,KADtB;AAtKR,SAAS,UAAU;AACnB,SAAS,2BAA2B;AAiBpC,MAAM,QAAwC;AAAA,EAC5C,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,IAAI;AACN;AAQA,MAAM,MAA8C;AAAA,EAClD,SAAS;AAAA,EACT,QAAQ;AACV;AAYA,MAAM,gBAAwF;AAAA,EAC5F,SAAS,EAAE,OAAO,iBAAiB,QAAQ,kBAAkB,KAAK,cAAc;AAAA,EAChF,QAAQ,EAAE,OAAO,cAAc,QAAQ,eAAe,KAAK,WAAW;AACxE;AA0FO,SAAS,WAAW;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,KAAK;AAAA,EACL,OAAO;AAAA,EACP,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA,gBAAgB;AAAA,EAChB;AAAA,EACA,GAAG;AACL,GAAoB;AAClB,QAAM,UAAU;AAChB,QAAM,eAAe,oBAAoB;AACzC,QAAM,iBAAiB,gBAAgB,iBAAiB;AACxD,QAAM,QAAQ,gBAAgB,OAAO,cAAc,YAAY,EAAE,YAAY,IAAI;AACjF,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,+BAA+B,SAAS,GAClE;AAAA;AAAA,IAMD,qBAAC,SAAI,WAAW,GAAG,gBAAgB,IAAI,YAAY,GAAG,kBAAkB,0BAA0B,GAChG;AAAA,2BAAC,SAAI,WAAU,kBACZ;AAAA,mBAAW,QAAQ,oBAAC,OAAE,WAAW,GAAG,oBAAoB,IAAI,MAAM,GAAI,mBAAQ;AAAA,QAC/E;AAAA,UAAC;AAAA;AAAA,YACC,WAAW;AAAA,cACT,gBAAgB,aAAa;AAAA,cAC7B;AAAA,cACA,MAAM,IAAI;AAAA,YACZ;AAAA,YAEC;AAAA;AAAA,QACH;AAAA,QACC,eAAe,QAAQ,oBAAC,OAAE,WAAU,yCAAyC,uBAAY;AAAA,SAC5F;AAAA,MACC,WAAW,QACV,oBAAC,SAAI,WAAW,GAAG,8CAA8C,gBAAgB,cAAc,KAAK,GACjG,mBACH;AAAA,MAED,gBACC;AAAA,QAAC;AAAA;AAAA,UACC,WAAW;AAAA,YACT;AAAA,YACA,kBAAkB;AAAA,YAClB;AAAA,UACF;AAAA,UAEC;AAAA;AAAA,MACH;AAAA,OAEJ;AAAA,KACF;AAEJ;","names":[]}

package/dist/components/tooltip.d.ts

@@ -159,6 +159,37 @@ interface TooltipProps extends ComponentPropsWithoutRef<"span"> {
  * existing app tests find without a hover (see above): flipping it would turn every
  * `getByRole("tooltip")` written against 0.12 into a failure in all three apps at once.
  * Reach for `lazy` wherever a `portal` was pinned only to keep a test's DOM clean.
+ *
+ * ⚠️ **The in-place bubble is clamped to the viewport when it opens (keksdose G7).** The
+ * portalled bubble has always measured itself and been pushed back onto the glass
+ * ({@link placeTooltip}); the in-place one never learnt its own size, so `side` was the
+ * whole of its placement and a `top` / `bottom` bubble sat centred on its trigger
+ * whatever that cost. The cost shows on a phone: long labels live at a row's START edge
+ * — a gcloud command in keksdose's jobs panel, a canned reply in a support thread — and
+ * a 20rem bubble centred on a trigger 16px from the edge hangs half its text off the
+ * screen. keksdose pinned `portal` on those sites for that alone, which gave up `lazy`'s
+ * point (the cheap, in-place bubble) to buy a placement.
+ *
+ * So now, when an in-place bubble goes up (default or `lazy`), a layout effect measures
+ * it and, if it crosses the viewport edge minus the same margin the portalled bubble
+ * keeps, slides it back along its CROSS axis only — sideways for `top` / `bottom`, up or
+ * down for the four side placements — with an inline `transform`, which composes with the
+ * placement classes' own `translate`. The main axis is left alone on purpose: sliding a
+ * `start` bubble along the main axis would slide it over its own trigger, and turning it
+ * round is a measured-placement decision this CSS-placed bubble does not make (pass
+ * `portal` for that). The width is already capped to the viewport (see
+ * `TOOLTIP_SURFACE`), so a bubble can always fit once slid, and a long label wraps
+ * instead of growing past the glass.
+ *
+ * Why on by default, with no prop? Because it is a no-op for every bubble that already
+ * fits — the shift is zero unless the bubble would overflow — so the only placements it
+ * changes are ones that were broken. The maths is in physical viewport pixels, so it
+ * needs no `dir`: an RTL row puts its long label at the RIGHT edge and gets slid left by
+ * the same code. Under jsdom there is no layout — every rect is zero-sized — and a
+ * zero-sized bubble is taken to be unmeasured, so tests see no transform at all. It is
+ * measured on open (and when the label or side changes while open), not on every scroll:
+ * an in-place bubble follows its trigger for free, and a page that scrolls sideways under
+ * an open tooltip is not a case worth a listener per tooltip.
  */
 declare function Tooltip({ label, side, className, portal, lazy, redact, children, ...rest }: TooltipProps): react.JSX.Element;
 interface TooltipSize {

package/dist/components/tooltip.js

@@ -88,6 +88,8 @@ function InPlaceTooltip({
   const [dir, setDir] = useState("ltr");
   const open = (hovered || focused) && !dismissed;
   useEscapeKey(() => setDismissed(true), open);
+  const bubbleRef = useRef(null);
+  const shift = useViewportClamp(bubbleRef, open && !clipped, side, label);
   useLayoutEffect(() => {
     if (detect) setClipped(hasClippingAncestor(triggerRef.current));
   }, [detect]);
@@ -128,9 +130,11 @@ function InPlaceTooltip({
             open && /* @__PURE__ */ jsx(
               "span",
               {
+                ref: bubbleRef,
                 id,
                 role: "tooltip",
                 "data-private": redact ? "" : void 0,
+                style: shiftStyle(shift),
                 className: cn(TOOLTIP_SURFACE, "pointer-events-none absolute z-50 opacity-100", sidePositionClass[side]),
                 children: label
               }
@@ -138,8 +142,10 @@ function InPlaceTooltip({
           ) : /* @__PURE__ */ jsx(
             "span",
             {
+              ref: bubbleRef,
               id,
               role: "tooltip",
+              style: shiftStyle(shift),
               hidden: dismissed || void 0,
               "data-private": redact ? "" : void 0,
               className: cn(
@@ -167,6 +173,33 @@ function isEmptyLabel(label) {
 }
 const TOOLTIP_GAP = 4;
 const TOOLTIP_MARGIN = 4;
+const NO_SHIFT = { x: 0, y: 0 };
+function slideInto(low, high, extent) {
+  if (low < TOOLTIP_MARGIN) return TOOLTIP_MARGIN - low;
+  if (high > extent - TOOLTIP_MARGIN) return Math.max(extent - TOOLTIP_MARGIN - high, TOOLTIP_MARGIN - low);
+  return 0;
+}
+function useViewportClamp(bubbleRef, active, side, label) {
+  const [shift, setShift] = useState(NO_SHIFT);
+  useLayoutEffect(() => {
+    const el = bubbleRef.current;
+    if (!active || !el) {
+      setShift(NO_SHIFT);
+      return;
+    }
+    const r = el.getBoundingClientRect();
+    if (r.width === 0 && r.height === 0) return;
+    const horizontal = side === "top" || side === "bottom";
+    setShift((previous) => {
+      const next = horizontal ? { x: slideInto(r.left - previous.x, r.right - previous.x, window.innerWidth), y: 0 } : { x: 0, y: slideInto(r.top - previous.y, r.bottom - previous.y, window.innerHeight) };
+      return next.x === previous.x && next.y === previous.y ? previous : next;
+    });
+  }, [bubbleRef, active, side, label]);
+  return shift;
+}
+function shiftStyle(shift) {
+  return shift.x === 0 && shift.y === 0 ? void 0 : { transform: `translate(${shift.x}px, ${shift.y}px)` };
+}
 const portalTransformBySide = {
   right: "translate(0, -50%)",
   left: "translate(-100%, -50%)",