@eifi1/ui-kit 0.48.2 → 0.49.0

package/dist/components/error-boundary.js

@@ -264,8 +264,8 @@ function ErrorFallback({
   const Icon = mode === "offline" ? WifiOff : mode === "update" ? RefreshCw : AlertTriangle;
   const reportText = report ? formatCrashReport(report) : null;
   const errorLine = details.message ? `${details.name}: ${details.message}` : details.name;
-  const reloadButton = /* @__PURE__ */ jsx(Button, { variant: mode === "error" ? "secondary" : "primary", onClick: reloadPage, children: text.reload }, "reload");
-  const retryButton = chunk ? null : /* @__PURE__ */ jsx(Button, { variant: mode === "error" ? "primary" : "secondary", onClick: reset, children: text.retry }, "retry");
+  const reloadButton = /* @__PURE__ */ jsx(Button, { variant: mode === "error" ? "secondary" : "default", onClick: reloadPage, children: text.reload }, "reload");
+  const retryButton = chunk ? null : /* @__PURE__ */ jsx(Button, { variant: mode === "error" ? "default" : "secondary", onClick: reset, children: text.retry }, "retry");
   return /* @__PURE__ */ jsx(
     EmptyState,
     {

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, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Button } from \"./button\";\nimport { EmptyState } from \"./empty-state\";\nimport { CopyButton } from \"./copy-button\";\nimport { Disclosure } from \"./disclosure\";\nimport { documentNavigation } from \"../lib/document-navigation\";\nimport { DEFAULT_ERROR_BOUNDARY_LABELS } from \"./error-boundary-labels\";\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\n// Defined in ./error-boundary-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_ERROR_BOUNDARY_LABELS };\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    documentNavigation.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?: LabelOverride<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?: LabelOverride<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-danger-strong bg-danger-soft px-3 py-2 text-start font-mono text-xs 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-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, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Button } from \"./button\";\nimport { EmptyState } from \"./empty-state\";\nimport { CopyButton } from \"./copy-button\";\nimport { Disclosure } from \"./disclosure\";\nimport { documentNavigation } from \"../lib/document-navigation\";\nimport { DEFAULT_ERROR_BOUNDARY_LABELS } from \"./error-boundary-labels\";\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\n// Defined in ./error-boundary-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_ERROR_BOUNDARY_LABELS };\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    documentNavigation.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?: LabelOverride<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?: LabelOverride<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\" : \"default\"} 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\" ? \"default\" : \"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-danger-strong bg-danger-soft px-3 py-2 text-start font-mono text-xs 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-secondary\">\n                {reportText}\n              </pre>\n            </Disclosure>\n          )}\n        </>\n      }\n    />\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/floating-panel.d.ts

@@ -72,13 +72,16 @@ export interface FloatingActionButtonProps extends Omit<ButtonHTMLAttributes<HTM
      */
     live?: boolean;
     /**
-     * `primary` (default): the solid brand disc of a page's main action. `surface`: the
-     * page's surface with a hairline border — for a FAB that is a status rather than a
-     * call to action, as kastlan's offline pill is (a brand pill would shout "press me"
-     * at a user who is merely offline). Ignored while `pressed` is set; a toggle has its
-     * own two looks.
+     * `accent` (default): the solid brand disc of a page's main action, as Button's
+     * `accent`. `surface`: the page's surface with a hairline border — for a FAB that is a
+     * status rather than a call to action, as kastlan's offline pill is (a brand pill would
+     * shout "press me" at a user who is merely offline). Ignored while `pressed` is set; a
+     * toggle has its own two looks. `primary` is a deprecated alias of `accent` (0.49; a
+     * development build warns once), removed in 0.51.
      */
-    variant?: "primary" | "surface";
+    variant?: "accent" | "surface"
+    /** @deprecated 0.49 — use `accent` (same look); removed in 0.51. */
+     | "primary";
     /**
      * Hover and focus label in the kit {@link Tooltip}, instead of the native `title` —
      * keksdose has ONE tooltip (dev#523) and wrapped its assistant launcher by hand,
@@ -93,6 +96,12 @@ export interface FloatingActionButtonProps extends Omit<ButtonHTMLAttributes<HTM
     /** Where the {@link tooltip} opens. Default `top`; the bubble is portalled and kept on
      *  screen, so a corner button's label is not pushed off the edge. */
     tooltipSide?: TooltipSide;
+    /**
+     * 0.49 KIT-11: step aside (as `hidden` does: off screen, the room kept) while a dialog,
+     * a sheet, a popover, a hover menu or a list is open, instead of floating over it or
+     * beside it. Default `true`; `false` keeps it on screen. A tooltip does not count.
+     */
+    hideWhenOverlay?: boolean;
     ref?: Ref<HTMLButtonElement>;
 }
 /**
@@ -120,7 +129,7 @@ export interface FloatingActionButtonProps extends Omit<ButtonHTMLAttributes<HTM
  * largest of several wins), and `AppShell` pads its `<main>` past it on a phone, so the
  * page's last row no longer ends under the button (keksdose dev#612).
  */
-export declare function FloatingActionButton({ label, icon, corner, offset, nativeTitle, pressed, extended, live, variant, tooltip, tooltipSide, className, style, type, title, ref, ...rest }: FloatingActionButtonProps): import("react").JSX.Element;
+export declare function FloatingActionButton({ label, icon, corner, offset, nativeTitle, pressed, extended, live, variant: givenVariant, tooltip, tooltipSide, hideWhenOverlay, className, style, type, title, hidden: hiddenProp, ref, ...rest }: FloatingActionButtonProps): import("react").JSX.Element;
 export interface FloatingPanelProps {
     /** The panel's heading, and its accessible name. */
     title: ReactNode;
@@ -165,6 +174,13 @@ export interface FloatingPanelProps {
      * back and shorten the page under the reader's thumb.
      */
     hidden?: boolean;
+    /**
+     * 0.49 KIT-11: the FAB steps aside while a dialog, a sheet, a popover, a hover menu or
+     * a list is open elsewhere (see {@link FloatingActionButtonProps.hideWhenOverlay}).
+     * Default `true`. An OPEN panel stays: what opens from inside it (a select, a date
+     * picker) is its own content.
+     */
+    hideWhenOverlay?: boolean;
     children: ReactNode;
 }
 /**
@@ -199,7 +215,7 @@ export interface FloatingPanelProps {
  * panel unmounts when closed; an app that must keep a draft across a close keeps it in
  * its own state, where it also survives a reload.
  */
-export declare function FloatingPanel({ title, fabLabel, fabIcon, open: openProp, defaultOpen, onOpenChange, corner, offset, fabNativeTitle, fabTooltip, closeLabel, initialFocus, className, bodyClassName, hidden, children, }: FloatingPanelProps): import("react").JSX.Element;
+export declare function FloatingPanel({ title, fabLabel, fabIcon, open: openProp, defaultOpen, onOpenChange, corner, offset, fabNativeTitle, fabTooltip, closeLabel, initialFocus, className, bodyClassName, hidden: hiddenProp, hideWhenOverlay, children, }: FloatingPanelProps): import("react").JSX.Element;
 export interface FloatingActionGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "role"> {
     /** Name the group ("Register actions"); a reader then introduces the members as one
      *  set. A group with no name is one more unlabelled wrapper. */
@@ -210,6 +226,9 @@ export interface FloatingActionGroupProps extends Omit<HTMLAttributes<HTMLDivEle
     offset?: string;
     /** {@link FloatingAction}s, in reading order. */
     children: ReactNode;
+    /** 0.49 KIT-11: step aside while a dialog, a sheet, a popover, a hover menu or a list
+     *  is open — see {@link FloatingActionButtonProps.hideWhenOverlay}. Default `true`. */
+    hideWhenOverlay?: boolean;
     ref?: Ref<HTMLDivElement>;
 }
 /**
@@ -229,7 +248,7 @@ export interface FloatingActionGroupProps extends Omit<HTMLAttributes<HTMLDivEle
  * hand-built ones did, and there is no arrow-key roving to learn. Hide it where it
  * does not belong with a class (`md:hidden`, as both keksdose pages do).
  */
-export declare function FloatingActionGroup({ corner, offset, className, style, children, ...rest }: FloatingActionGroupProps): import("react").JSX.Element;
+export declare function FloatingActionGroup({ corner, offset, hideWhenOverlay, hidden, className, style, children, ...rest }: FloatingActionGroupProps): import("react").JSX.Element;
 /** What {@link FloatingActionProps.renderLink} is handed. Spread it onto your router's
  *  link, mapping `href` — `renderLink={({ href, ...p }) => <Link to={href} {...p} />}`. */
 export interface FloatingActionLinkProps {
@@ -260,10 +279,14 @@ export interface FloatingActionProps extends Omit<ButtonHTMLAttributes<HTMLButto
      */
     pressedStyle?: "tint" | "plain";
     /**
-     * `primary`: the brand-filled member, for the group's main action (the /transactions
-     * "+"). Default: the quiet one.
+     * `accent`: the brand-filled member, for the group's main action (the /transactions
+     * "+"), as Button's `accent`. `default` (default): the quiet one. `primary` is a
+     * deprecated alias of `accent` (0.49; a development build warns once), removed no
+     * earlier than 0.51.
      */
-    variant?: "default" | "primary";
+    variant?: "default" | "accent"
+    /** @deprecated 0.49 — use `accent` (same look); removed in 0.51. */
+     | "primary";
     /**
      * A count in a dot at the member's top end corner — the /transactions invoices link's
      * pending count. Nothing is drawn for `0` or less; above 99 it reads `99+`. The count
@@ -295,4 +318,4 @@ export interface FloatingActionProps extends Omit<ButtonHTMLAttributes<HTMLButto
  * keeps the brand member's fill inside the pill's corners), and the focus ring is inset
  * for the same reason.
  */
-export declare function FloatingAction({ label, icon, pressed, pressedStyle, variant, badge, badgeLabel, badgeTone, tooltip, tooltipSide, href, renderLink, className, type, onClick, ref, ...rest }: FloatingActionProps): import("react").JSX.Element;
+export declare function FloatingAction({ label, icon, pressed, pressedStyle, variant: givenVariant, badge, badgeLabel, badgeTone, tooltip, tooltipSide, href, renderLink, className, type, onClick, ref, ...rest }: FloatingActionProps): import("react").JSX.Element;

package/dist/components/floating-panel.js

@@ -5,11 +5,12 @@ import { createPortal } from "react-dom";
 import { X } from "lucide-react";
 import { cn } from "../lib/cn.js";
 import { FOCUS_RING } from "./focus-ring.js";
+import { warnDeprecatedVariant } from "./button-look.js";
 import { dirOf } from "../lib/direction.js";
 import { registerFloating } from "../lib/floating-stack.js";
 import { useFloatClearance } from "../lib/float-clearance.js";
 import { isComposing } from "../lib/ime.js";
-import { takeEscape } from "../hooks/use-dismiss.js";
+import { takeEscape, useOverlayOpen } from "../hooks/use-dismiss.js";
 import { useKitLabels, useKitLink } from "../i18n/kit-labels.js";
 import { assignRef } from "./field-parts.js";
 import { pickLinkRenderer } from "./text-link.js";
@@ -33,6 +34,10 @@ function usePortalDir() {
   }, []);
   return [marker, dir];
 }
+function deprecatedPrimary(component) {
+  warnDeprecatedVariant(component, "primary", "accent");
+  return "accent";
+}
 function FloatingActionButton({
   label,
   icon,
@@ -42,17 +47,22 @@ function FloatingActionButton({
   pressed,
   extended = false,
   live = false,
-  variant = "primary",
+  variant: givenVariant = "accent",
   tooltip,
   tooltipSide = "top",
+  hideWhenOverlay = true,
   className,
   style,
   type = "button",
   title,
+  hidden: hiddenProp,
   ref,
   ...rest
 }) {
+  const overlay = useOverlayOpen(hideWhenOverlay);
+  const hidden = hiddenProp || overlay || void 0;
   const [marker, dir] = usePortalDir();
+  const variant = givenVariant === "primary" ? deprecatedPrimary("FloatingActionButton variant") : givenVariant;
   const toggle = pressed !== void 0;
   const tip = tooltip === true ? label : tooltip === false || tooltip === "" ? void 0 : tooltip;
   const wrapped = tip !== void 0 && tip !== null;
@@ -71,6 +81,7 @@ function FloatingActionButton({
     "button",
     {
       ...rest,
+      hidden: wrapped ? void 0 : hidden,
       ref: buttonRef,
       type,
       dir,
@@ -84,7 +95,7 @@ function FloatingActionButton({
         "inline-flex items-center justify-center rounded-full",
         extended ? "h-12 gap-2 px-4 text-sm font-medium [&_svg]:size-5" : "size-12 [&_svg]:size-6",
         "shadow-lg transition-colors disabled:cursor-default",
-        !toggle && variant === "primary" && "bg-brand text-brand-contrast hover:bg-brand-hover",
+        !toggle && variant === "accent" && "bg-brand text-brand-contrast hover:bg-brand-hover",
         !toggle && variant === "surface" && "border border-subtle bg-surface text-primary hover:bg-hover disabled:hover:bg-surface",
         // A toggle sits on the page's surface — a solid brand disc would read as
         // "on" in both states — and says "on" in the brand family.
@@ -110,7 +121,7 @@ function FloatingActionButton({
           {
             ref: setFixed,
             dir,
-            hidden: rest.hidden,
+            hidden,
             style: cornerStyle(corner, offset),
             className: "fixed z-40 inline-flex",
             children: /* @__PURE__ */ jsx(Tooltip, { label: tip, side: tooltipSide, portal: true, children: tip === label ? /* @__PURE__ */ jsx(Fragment, { children: button }) : button })
@@ -137,7 +148,8 @@ function FloatingPanel({
   initialFocus,
   className,
   bodyClassName,
-  hidden = false,
+  hidden: hiddenProp = false,
+  hideWhenOverlay = true,
   children
 }) {
   const labels = useKitLabels(
@@ -147,6 +159,8 @@ function FloatingPanel({
   );
   const [ownOpen, setOwnOpen] = useState(defaultOpen);
   const open = openProp ?? ownOpen;
+  const overlay = useOverlayOpen(hideWhenOverlay && !open);
+  const hidden = hiddenProp || overlay;
   const setOpen = (next) => {
     if (openProp === void 0) setOwnOpen(next);
     onOpenChange?.(next);
@@ -197,6 +211,7 @@ function FloatingPanel({
         nativeTitle: fabNativeTitle,
         tooltip: fabTooltip,
         hidden: hidden || void 0,
+        hideWhenOverlay: false,
         "aria-expanded": open,
         "aria-controls": open && !hidden ? panelId : void 0,
         onClick: () => {
@@ -269,12 +284,15 @@ function FloatingPanel({
 function FloatingActionGroup({
   corner = "bottom-end",
   offset = "1rem",
+  hideWhenOverlay = true,
+  hidden,
   className,
   style,
   children,
   ...rest
 }) {
   const [marker, dir] = usePortalDir();
+  const overlay = useOverlayOpen(hideWhenOverlay);
   useFloatClearance(offset, "2px");
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx("span", { ref: marker, hidden: true }),
@@ -283,6 +301,7 @@ function FloatingActionGroup({
         "div",
         {
           ...rest,
+          hidden: hidden || overlay || void 0,
           role: "group",
           dir,
           "data-corner": corner,
@@ -313,7 +332,7 @@ function FloatingAction({
   icon,
   pressed,
   pressedStyle = "tint",
-  variant = "default",
+  variant: givenVariant = "default",
   badge,
   badgeLabel,
   badgeTone = "warning",
@@ -332,12 +351,13 @@ function FloatingAction({
   const counted = badge !== void 0 && badge > 0;
   const name = counted ? `${label}, ${badgeLabel ?? labels.badge(badge)}` : label;
   const isLink = href !== void 0;
+  const variant = givenVariant === "primary" ? deprecatedPrimary("FloatingAction variant") : givenVariant;
   const look = cn(
     "relative flex size-12 items-center justify-center transition-colors",
     "outline-none focus-visible:ring-inset",
     FOCUS_RING,
     "disabled:cursor-not-allowed disabled:opacity-50 [&_svg]:size-5",
-    variant === "primary" ? "bg-brand text-brand-contrast hover:bg-brand-hover" : pressed && !isLink && pressedStyle === "tint" ? "bg-brand-soft text-brand hover:bg-brand-soft-hover hover:text-brand-muted" : "text-secondary hover:bg-hover hover:text-primary",
+    variant === "accent" ? "bg-brand text-brand-contrast hover:bg-brand-hover" : pressed && !isLink && pressedStyle === "tint" ? "bg-brand-soft text-brand hover:bg-brand-soft-hover hover:text-brand-muted" : "text-secondary hover:bg-hover hover:text-primary",
     className
   );
   const body = /* @__PURE__ */ jsxs(Fragment, { children: [