@eifi1/ui-kit 0.26.0 → 0.27.1

package/dist/feedback/feedback-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-capture.ts"],"sourcesContent":["/**\n * `captureAppScreenshot` — the picture of the app a feedback report attaches (0.27.0,\n * docs/feedback-harmonization.md §5).\n *\n * Lifted from keksdose `frontend/src/features/feedback/capture-screenshot.ts` (live #271),\n * which is the canon: Kurvenschmiede carried a second copy (`capture-page.ts`) with none of\n * its speed-ups, and kastlan had no capture at all. Each app wrote the same three awkward\n * decisions — which element, which library, what to do when it throws — and they drifted\n * the moment there were two copies (Kurvenschmiede feedback #128 says exactly that).\n *\n * WHY IT IS FAST (keksdose live #271: *\"Capture screenshot — That takes ages in my mobile\n * phone\"*). `modern-screenshot` deep-clones the subtree and inlines every node's computed\n * style onto the clone, because the final image is an SVG `foreignObject` that carries no\n * stylesheets. By default it walks the WHOLE computed style (~340 longhands in Chrome) per\n * element; keksdose's /transactions has ~4,800 elements under `#root` at phone width, so\n * that was ~1.6 million `getPropertyValue` calls before a pixel was drawn — 21–52 s on a\n * desktop CPU, 153–160 s with the CPU throttled 4×. Two levers fixed it, both kept here:\n *\n *   1. {@link CAPTURE_STYLE_PROPERTIES} — copy the ~140 longhands a Tailwind v4 app built\n *      on this kit actually uses. Alone: 21 s → 1.8 s.\n *   2. {@link inViewport} drops `display: none` subtrees — on a phone most of the\n *      document, since `DataTable` renders both layouts and hides one — and anything\n *      wholly outside the viewport. Together: 27–52 s → 0.4–1.1 s, the picture\n *      0.05% of pixels different (antialiasing).\n *\n * Plus WebP at 0.9 (222 KB → 46 KB, an upload a phone makes on a mobile connection) with\n * the file named from what the canvas ACTUALLY produced — a browser without WebP encodes\n * PNG, and a \"screenshot.webp\" that is a PNG is refused by the server on its type — and\n * `font: false`, since the app's faces are same-origin and already in the page.\n *\n * WHY THE PEER IS LOADED DYNAMICALLY. `modern-screenshot` is an OPTIONAL peer\n * (`peerDependenciesMeta.optional`, like `sonner`), and this module is re-exported by the\n * barrel: a static import would make every app that imports a Button install it. It is\n * imported inside the function, so an app pays nothing until somebody presses \"Capture\n * screenshot\", and an app without it gets a REJECTED promise — which the submit dialog\n * turns into the \"Could not capture a screenshot\" toast (`feedbackToast.captureFailed`).\n *\n * WHAT IS NOT HERE: Kurvenschmiede's `features: { restoreScrollPosition: true }` (its\n * feedback #153: a capture of a scrolled `<main>` came out as the TOP of the page). The\n * viewport filter already answers that case — what is scrolled out of view is dropped, so\n * what remains is what was on screen, give or take the part of the first row that was\n * scrolled past (checked in Chromium, 0.27.0: an inner `<main>` scrolled to row 20 captures\n * rows 20–26). Both together are worse than either: the clone is translated by the scroll\n * offset AFTER the rows above were dropped, and the picture came out blank below the\n * header (same check).\n */\n\n/**\n * The computed properties copied onto the clone (keksdose `capture-screenshot.ts:94`).\n *\n * LONGHANDS only: `getPropertyValue()` resolves a shorthand to `\"\"` whenever its longhands\n * disagree, so `\"border\"` would silently drop every one-sided border. Chosen by what\n * Tailwind v4 emits rather than by what looks complete: `font-variant-numeric` because\n * money is `tabular-nums`, the SVG paint properties because every icon is a lucide `<svg>`\n * inheriting `stroke: currentColor`.\n */\nconst CAPTURE_STYLE_PROPERTIES: readonly string[] = [\n  // box\n  \"display\",\n  \"position\",\n  \"top\",\n  \"right\",\n  \"bottom\",\n  \"left\",\n  \"width\",\n  \"height\",\n  \"min-width\",\n  \"min-height\",\n  \"max-width\",\n  \"max-height\",\n  \"box-sizing\",\n  \"margin-top\",\n  \"margin-right\",\n  \"margin-bottom\",\n  \"margin-left\",\n  \"padding-top\",\n  \"padding-right\",\n  \"padding-bottom\",\n  \"padding-left\",\n  \"overflow-x\",\n  \"overflow-y\",\n  \"z-index\",\n  \"float\",\n  \"clear\",\n  \"aspect-ratio\",\n  \"inset-inline-start\",\n  \"inset-inline-end\",\n  // flex + grid\n  \"flex-direction\",\n  \"flex-wrap\",\n  \"flex-grow\",\n  \"flex-shrink\",\n  \"flex-basis\",\n  \"align-items\",\n  \"align-self\",\n  \"align-content\",\n  \"justify-content\",\n  \"justify-items\",\n  \"justify-self\",\n  \"row-gap\",\n  \"column-gap\",\n  \"order\",\n  \"grid-template-columns\",\n  \"grid-template-rows\",\n  \"grid-column-start\",\n  \"grid-column-end\",\n  \"grid-row-start\",\n  \"grid-row-end\",\n  \"grid-auto-flow\",\n  \"grid-auto-rows\",\n  \"grid-auto-columns\",\n  // type\n  \"color\",\n  \"font-family\",\n  \"font-size\",\n  \"font-weight\",\n  \"font-style\",\n  \"font-variant-numeric\",\n  \"font-feature-settings\",\n  \"line-height\",\n  \"letter-spacing\",\n  \"word-spacing\",\n  \"text-align\",\n  \"text-indent\",\n  \"text-transform\",\n  \"text-overflow\",\n  \"text-decoration-line\",\n  \"text-decoration-color\",\n  \"text-decoration-style\",\n  \"text-decoration-thickness\",\n  \"text-underline-offset\",\n  \"white-space\",\n  \"word-break\",\n  \"overflow-wrap\",\n  \"vertical-align\",\n  \"direction\",\n  \"list-style-type\",\n  \"list-style-position\",\n  \"-webkit-line-clamp\",\n  \"-webkit-box-orient\",\n  \"-webkit-text-fill-color\",\n  // paint\n  \"background-color\",\n  \"background-image\",\n  \"background-position\",\n  \"background-repeat\",\n  \"background-size\",\n  \"background-clip\",\n  \"background-origin\",\n  \"opacity\",\n  \"visibility\",\n  \"box-shadow\",\n  \"filter\",\n  \"backdrop-filter\",\n  \"mix-blend-mode\",\n  \"clip-path\",\n  // borders + outline\n  \"border-top-width\",\n  \"border-right-width\",\n  \"border-bottom-width\",\n  \"border-left-width\",\n  \"border-top-style\",\n  \"border-right-style\",\n  \"border-bottom-style\",\n  \"border-left-style\",\n  \"border-top-color\",\n  \"border-right-color\",\n  \"border-bottom-color\",\n  \"border-left-color\",\n  \"border-top-left-radius\",\n  \"border-top-right-radius\",\n  \"border-bottom-right-radius\",\n  \"border-bottom-left-radius\",\n  \"outline-width\",\n  \"outline-style\",\n  \"outline-color\",\n  \"outline-offset\",\n  // transform\n  \"transform\",\n  \"transform-origin\",\n  \"rotate\",\n  \"scale\",\n  \"translate\",\n  // tables\n  \"border-collapse\",\n  \"border-spacing\",\n  \"table-layout\",\n  \"caption-side\",\n  // replaced content + svg\n  \"object-fit\",\n  \"object-position\",\n  \"fill\",\n  \"fill-opacity\",\n  \"fill-rule\",\n  \"stroke\",\n  \"stroke-opacity\",\n  \"stroke-width\",\n  \"stroke-linecap\",\n  \"stroke-linejoin\",\n  \"stroke-dasharray\",\n  \"stroke-dashoffset\",\n  \"shape-rendering\",\n  \"paint-order\",\n];\n\n/** The extension that belongs to what the canvas actually produced (keksdose\n *  `capture-screenshot.ts:247`). */\nconst EXTENSIONS: Record<string, string> = {\n  \"image/webp\": \"webp\",\n  \"image/jpeg\": \"jpg\",\n  \"image/png\": \"png\",\n};\n\n/**\n * Keep a node only if it can paint inside the viewport (keksdose `capture-screenshot.ts:267`).\n *\n * - `display: none` goes, with its subtree — it paints nothing and no descendant can.\n *   `<style>` and `<link>` are computed `display: none` too but are NOT decoration: a\n *   stylesheet inside the captured subtree still applies inside the `foreignObject`.\n *   `visibility: hidden` is deliberately not checked: a descendant may set it back.\n * - A box wholly outside the viewport goes: the root is viewport-sized (the app scrolls an\n *   inner `<main>`), so it would have been clipped away unseen.\n * - A ZERO box is kept: `display: contents` reports 0×0 while its children paint, and the\n *   library's filter drops a rejected node's children too.\n */\nfunction inViewport(node: Node): boolean {\n  if (node.nodeType !== Node.ELEMENT_NODE) return true;\n  const el = node as Element;\n  const tag = el.tagName;\n  if (tag !== \"STYLE\" && tag !== \"LINK\") {\n    const display = el.ownerDocument?.defaultView?.getComputedStyle(el).display;\n    if (display === \"none\") return false;\n  }\n  const rect = el.getBoundingClientRect?.();\n  if (!rect) return true;\n  if (rect.width === 0 && rect.height === 0) return true;\n  return !(rect.bottom <= 0 || rect.right <= 0 || rect.top >= window.innerHeight || rect.left >= window.innerWidth);\n}\n\n/** What `captureAppScreenshot` takes. */\nexport interface CaptureAppScreenshotOptions {\n  /**\n   * The id of the element to capture. Default `\"root\"` — the app's mount point, which is\n   * right on purpose: the kit's `Modal` portals to `document.body` as a SIBLING of `#root`,\n   * so capturing `#root` leaves the feedback dialog and its backdrop out of the picture\n   * without a single filter rule.\n   */\n  rootId?: string;\n}\n\n/**\n * Snapshot the app view behind the feedback dialog, as a `File` ready for the upload —\n * `screenshot.webp`, or `screenshot.png` where the browser cannot encode WebP.\n *\n * - Resolves `null` when there is no element with `rootId` — nothing to capture.\n * - **Rejects** when the optional peer `modern-screenshot` is not installed (the error\n *   says so), or when the capture itself fails. It never swallows: what to say about a\n *   failure is the caller's — `useFeedbackSubmit` toasts `feedbackToast.captureFailed`.\n *\n * Call it from the \"Capture screenshot\" button's own click and nowhere else (keksdose\n * checked: running it at dialog OPEN was suspected and was never the cause of the wait).\n */\nexport async function captureAppScreenshot({ rootId = \"root\" }: CaptureAppScreenshotOptions = {}): Promise<File | null> {\n  let domToBlob: (typeof import(\"modern-screenshot\"))[\"domToBlob\"];\n  try {\n    ({ domToBlob } = await import(\"modern-screenshot\"));\n  } catch (cause) {\n    throw new Error(\n      \"@eifi1/ui-kit: captureAppScreenshot needs the optional peer `modern-screenshot` — install it (npm i modern-screenshot).\",\n      { cause },\n    );\n  }\n  const el = document.getElementById(rootId);\n  if (!el) return null;\n  const blob = await domToBlob(el, {\n    // Falls back to PNG where WebP cannot be encoded; the File is named from the blob.\n    type: \"image/webp\",\n    quality: 0.9,\n    font: false,\n    includeStyleProperties: [...CAPTURE_STYLE_PROPERTIES],\n    filter: inViewport,\n  });\n  const type = blob.type || \"image/png\";\n  return new File([blob], `screenshot.${EXTENSIONS[type] ?? \"png\"}`, { type });\n}\n"],"mappings":";AAwDA,MAAM,2BAA8C;AAAA;AAAA,EAElD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIA,MAAM,aAAqC;AAAA,EACzC,cAAc;AAAA,EACd,cAAc;AAAA,EACd,aAAa;AACf;AAcA,SAAS,WAAW,MAAqB;AACvC,MAAI,KAAK,aAAa,KAAK,aAAc,QAAO;AAChD,QAAM,KAAK;AACX,QAAM,MAAM,GAAG;AACf,MAAI,QAAQ,WAAW,QAAQ,QAAQ;AACrC,UAAM,UAAU,GAAG,eAAe,aAAa,iBAAiB,EAAE,EAAE;AACpE,QAAI,YAAY,OAAQ,QAAO;AAAA,EACjC;AACA,QAAM,OAAO,GAAG,wBAAwB;AACxC,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,KAAK,UAAU,KAAK,KAAK,WAAW,EAAG,QAAO;AAClD,SAAO,EAAE,KAAK,UAAU,KAAK,KAAK,SAAS,KAAK,KAAK,OAAO,OAAO,eAAe,KAAK,QAAQ,OAAO;AACxG;AAyBA,eAAsB,qBAAqB,EAAE,SAAS,OAAO,IAAiC,CAAC,GAAyB;AACtH,MAAI;AACJ,MAAI;AACF,KAAC,EAAE,UAAU,IAAI,MAAM,OAAO,mBAAmB;AAAA,EACnD,SAAS,OAAO;AACd,UAAM,IAAI;AAAA,MACR;AAAA,MACA,EAAE,MAAM;AAAA,IACV;AAAA,EACF;AACA,QAAM,KAAK,SAAS,eAAe,MAAM;AACzC,MAAI,CAAC,GAAI,QAAO;AAChB,QAAM,OAAO,MAAM,UAAU,IAAI;AAAA;AAAA,IAE/B,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MAAM;AAAA,IACN,wBAAwB,CAAC,GAAG,wBAAwB;AAAA,IACpD,QAAQ;AAAA,EACV,CAAC;AACD,QAAM,OAAO,KAAK,QAAQ;AAC1B,SAAO,IAAI,KAAK,CAAC,IAAI,GAAG,cAAc,WAAW,IAAI,KAAK,KAAK,IAAI,EAAE,KAAK,CAAC;AAC7E;","names":[]}

package/dist/feedback/feedback-context.d.ts

@@ -0,0 +1,71 @@
+import 'react';
+export { h as DEFAULT_FEEDBACK_CONTEXT_LABELS, a0 as FeedbackContextBox, a1 as FeedbackContextBoxProps, a2 as FeedbackContextInput, a3 as FeedbackContextLabels, aM as FeedbackSubmitter, b2 as feedbackContext } from '../kit-labels-DQg82eHB.js';
+import '../data-table-labels-DUELeXpa.js';
+import '../components/data-table-sort.js';
+import '../components/swipeable-row.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-sync.js';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/error-boundary.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../components/write-lock.js';
+import '../components/legal.js';
+import '../components/account-chips.js';
+import '../lib/format.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/field-parts.js';

package/dist/feedback/feedback-context.js

@@ -0,0 +1,96 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Checkbox } from "../components/checkbox.js";
+import { DEFAULT_COMMON_LABELS, useKitLabels } from "../i18n/kit-labels.js";
+import { cn } from "../lib/cn.js";
+function submitterLine(user) {
+  const name = user?.display_name?.trim();
+  const email = user?.email?.trim();
+  if (name && email) return `${name} (${email})`;
+  return name || email || "\u2014";
+}
+function pathOf(url, base) {
+  if (!url) return "";
+  try {
+    return new URL(url, base || "http://localhost").pathname;
+  } catch {
+    return "";
+  }
+}
+function feedbackContext(input) {
+  const { user, attachUrl, url } = input;
+  const win = typeof window === "undefined" ? void 0 : window;
+  const origin = input.origin ?? win?.location.origin ?? "";
+  const context = {
+    url: attachUrl ? url : "",
+    route: attachUrl ? input.route ?? pathOf(url, origin || win?.location.href) : "",
+    origin
+  };
+  if (input.environment !== void 0) context.environment = input.environment;
+  context.user_id = user?.id ?? null;
+  context.user_email = user?.email ?? null;
+  context.user_display_name = user?.display_name ?? null;
+  context.viewport = input.viewport ?? (win ? `${win.innerWidth}x${win.innerHeight}` : "");
+  context.ua = input.ua ?? (typeof navigator === "undefined" ? "" : navigator.userAgent);
+  if (input.version !== void 0) context.version = input.version;
+  return context;
+}
+const DEFAULT_FEEDBACK_CONTEXT_LABELS = {
+  user: "User",
+  attachUrl: "Attach current page URL"
+};
+function FeedbackContextBox({
+  user,
+  url,
+  attachUrl,
+  onAttachUrlChange,
+  labels: labelsProp,
+  className
+}) {
+  const labels = useKitLabels("feedbackContext", DEFAULT_FEEDBACK_CONTEXT_LABELS, labelsProp);
+  const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
+  const submitter = submitterLine(user);
+  const line = common.fieldValue(labels.user, submitter);
+  const lead = line.endsWith(submitter) ? line.slice(0, line.length - submitter.length) : null;
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: cn(
+        "space-y-1 rounded-md border border-[var(--border)] bg-[var(--bg-surface-2)] px-3 py-2 text-xs text-[var(--text-muted)]",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "[overflow-wrap:anywhere]", children: lead === null ? line : /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx("span", { className: "font-medium text-[var(--text-secondary)]", children: lead }),
+          submitter
+        ] }) }),
+        /* @__PURE__ */ jsx(
+          Checkbox,
+          {
+            checked: attachUrl,
+            onCheckedChange: onAttachUrlChange,
+            label: /* @__PURE__ */ jsx("span", { className: "text-xs font-medium text-[var(--text-secondary)]", children: labels.attachUrl }),
+            description: url ? (
+              // `break-all`: a URL is one unbreakable word, and at 390px a long query string
+              // would otherwise push the dialog sideways.
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  "data-withheld": attachUrl ? void 0 : "",
+                  className: cn("break-all text-xs", !attachUrl && "line-through opacity-60"),
+                  children: url
+                }
+              )
+            ) : void 0
+          }
+        )
+      ]
+    }
+  );
+}
+export {
+  DEFAULT_FEEDBACK_CONTEXT_LABELS,
+  FeedbackContextBox,
+  feedbackContext
+};
+//# sourceMappingURL=feedback-context.js.map

package/dist/feedback/feedback-context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-context.tsx"],"sourcesContent":["import { Checkbox } from \"../components/checkbox\";\nimport { DEFAULT_COMMON_LABELS, useKitLabels } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport type { FeedbackContext, FeedbackEnvironment } from \"./feedback-record\";\n\n/**\n * The reporter context of a feedback report: the box the submit dialog shows, and the\n * `context` object `POST /feedback` sends (0.27.0, docs/feedback-harmonization.md §3.2,\n * §4.2). One file for both, so what the box SAYS will be sent and what IS sent cannot\n * drift apart.\n *\n * Each app had written both halves itself (keksdose `use-feedback-dialog.tsx:105` and\n * `:222`, kastlan `feedback-button.tsx:80`, Kurvenschmiede `use-feedback-dialog.tsx:124`),\n * and they had drifted: kastlan sent six keys with `user_email: null` and no version,\n * Kurvenschmiede a `page_path` column and a sentence where keksdose had a labelled box,\n * and only keksdose showed the full URL it was about to send.\n */\n\n/* ── Who is filing ───────────────────────────────────────────────────────── */\n\n/**\n * The person filing, as the app knows them. Snake case on purpose: keksdose's and\n * Kurvenschmiede's user objects already have this shape (`id`, `email`, `display_name`),\n * so they pass their `user` as it is; kastlan maps its token's `sub` and name parts.\n *\n * A SNAPSHOT for the report and the box. The server should overwrite the three `user_*`\n * keys from the session (§3.2; Kurvenschmiede does), so nobody can file in someone else's\n * name — this is what the reporter is SHOWN, not proof of who they are.\n */\nexport interface FeedbackSubmitter {\n  id?: number | null;\n  email?: string | null;\n  display_name?: string | null;\n}\n\n/** \"Ada Example (ada@example.com)\", the name alone, the email alone, or \"—\" when the app\n *  knows neither (keksdose `use-feedback-dialog.tsx:228`). */\nfunction submitterLine(user: FeedbackSubmitter | null | undefined): string {\n  const name = user?.display_name?.trim();\n  const email = user?.email?.trim();\n  if (name && email) return `${name} (${email})`;\n  return name || email || \"—\";\n}\n\n/* ── The object (§3.2) ───────────────────────────────────────────────────── */\n\n/** What {@link feedbackContext} is built from. */\nexport interface FeedbackContextInput {\n  /** The submitter, or `null` when signed out / unknown — the three `user_*` keys are then\n   *  `null`, as keksdose sends them. */\n  user?: FeedbackSubmitter | null;\n  /** The box's \"Attach current page URL\" checkbox. `false` withholds `url` and `route`\n   *  (both `\"\"`); nothing else is withheld — `origin` says which copy of the app, which is\n   *  not personal, and triage needs it first (keksdose `use-feedback-dialog.tsx:110`). */\n  attachUrl: boolean;\n  /** `location.href` when the dialog OPENED — the page the report is about, not the one\n   *  the reporter may have navigated to while typing. */\n  url: string;\n  /** Its pathname. Default: read off `url` (a path-only `url` works too). */\n  route?: string;\n  /** Default `location.origin`. */\n  origin?: string;\n  /** `\"prod\"` / `\"dev\"` / `\"local\"` — the app's own reading (keksdose\n   *  `app/deploy-environment.ts`). Left out of the object when not given. */\n  environment?: FeedbackEnvironment | (string & {});\n  /** The app build (`__APP_VERSION__`). Left out of the object when not given. */\n  version?: string;\n  /** Default `${innerWidth}x${innerHeight}` at the time of the call — \"406x816\". */\n  viewport?: string;\n  /** Default `navigator.userAgent`. */\n  ua?: string;\n}\n\n/** The pathname of a full or path-only URL; `\"\"` for something that is neither. */\nfunction pathOf(url: string, base: string | undefined): string {\n  if (!url) return \"\";\n  try {\n    return new URL(url, base || \"http://localhost\").pathname;\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * The `context` object of `POST /feedback` (§3.2), keys in keksdose's order: `url`, `route`,\n * `origin`, `environment`, `user_id`, `user_email`, `user_display_name`, `viewport`, `ua`,\n * `version`.\n *\n * With `attachUrl: false`, `url` and `route` are `\"\"` — present and empty, as keksdose\n * sends them, so a reader can tell \"withheld\" from \"an old row without the key\".\n * `environment` and `version` are omitted when the app passes none (kastlan had no\n * version), rather than sent as `undefined`.\n *\n * Reads `window` / `navigator` only for the defaults it was not given, so it is a pure\n * function in a test that passes everything.\n */\nexport function feedbackContext(input: FeedbackContextInput): FeedbackContext {\n  const { user, attachUrl, url } = input;\n  const win = typeof window === \"undefined\" ? undefined : window;\n  const origin = input.origin ?? win?.location.origin ?? \"\";\n  const context: FeedbackContext = {\n    url: attachUrl ? url : \"\",\n    route: attachUrl ? (input.route ?? pathOf(url, origin || win?.location.href)) : \"\",\n    origin,\n  };\n  if (input.environment !== undefined) context.environment = input.environment;\n  context.user_id = user?.id ?? null;\n  context.user_email = user?.email ?? null;\n  context.user_display_name = user?.display_name ?? null;\n  context.viewport = input.viewport ?? (win ? `${win.innerWidth}x${win.innerHeight}` : \"\");\n  context.ua = input.ua ?? (typeof navigator === \"undefined\" ? \"\" : navigator.userAgent);\n  if (input.version !== undefined) context.version = input.version;\n  return context;\n}\n\n/* ── The box (§4.2) ──────────────────────────────────────────────────────── */\n\n/**\n * `feedbackContext` — the context box's words. de-CH canon (keksdose `de-CH.json`):\n * `user` \"Nutzer\", `attachUrl` \"Aktuelle Seiten-URL anhängen\".\n */\nexport interface FeedbackContextLabels {\n  /** The submitter line's label — the box draws \"**User:** Ada Example (ada@example.com)\".\n   *  The label alone: the colon between it and the person is the language's\n   *  `common.fieldValue` (fr \"Utilisateur : …\", zh \"用户：…\"). */\n  user: string;\n  /** The checkbox. The URL it is about is the line beneath it. */\n  attachUrl: string;\n}\n\nexport const DEFAULT_FEEDBACK_CONTEXT_LABELS: FeedbackContextLabels = {\n  user: \"User\",\n  attachUrl: \"Attach current page URL\",\n};\n\nexport interface FeedbackContextBoxProps {\n  /** Who is filing — the same value handed to {@link feedbackContext}. */\n  user?: FeedbackSubmitter | null;\n  /** The URL that goes with the report — the same `url` handed to {@link feedbackContext}. */\n  url: string;\n  /** The checkbox, on by default in the dialog (§4.2) — the same `attachUrl`. */\n  attachUrl: boolean;\n  onAttachUrlChange: (next: boolean) => void;\n  /** Prop > `<UiKitProvider labels={{ feedbackContext }}>` > English. */\n  labels?: Partial<FeedbackContextLabels>;\n  className?: string;\n}\n\n/**\n * The submit dialog's context box — the dialog's `contextSlot` (keksdose\n * `use-feedback-dialog.tsx:222`, §4.2): who is filing, and the page URL with a checkbox to\n * leave it out, ON by default.\n *\n * The URL stays visible when the box is off, struck through: the reporter sees what they\n * withheld rather than a line that vanished, and ticking it back on is the same glance.\n * Kurvenschmiede's argument for the checkbox is why it exists at all (its feedback #101):\n * the route is right for a bug and wrong for an idea about a screen one is not on — filed\n * against whatever screen happened to be open, the queue reads as if it were about that\n * screen.\n *\n * Nothing in here is the app's: hand it the values handed to {@link feedbackContext}, and\n * what the box shows is what is sent.\n */\nexport function FeedbackContextBox({\n  user,\n  url,\n  attachUrl,\n  onAttachUrlChange,\n  labels: labelsProp,\n  className,\n}: FeedbackContextBoxProps) {\n  const labels = useKitLabels(\"feedbackContext\", DEFAULT_FEEDBACK_CONTEXT_LABELS, labelsProp);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n  const submitter = submitterLine(user);\n  // \"User: Ada …\" through `common.fieldValue`, so French gets its space before the colon\n  // and Chinese its full-width one; the label and its punctuation are drawn bold, as\n  // keksdose's box does. A `fieldValue` that does not end in the value (an app's own\n  // order) is shown whole, unbolded, rather than cut in the wrong place.\n  const line = common.fieldValue(labels.user, submitter);\n  const lead = line.endsWith(submitter) ? line.slice(0, line.length - submitter.length) : null;\n  return (\n    <div\n      className={cn(\n        \"space-y-1 rounded-md border border-[var(--border)] bg-[var(--bg-surface-2)] px-3 py-2 text-xs text-[var(--text-muted)]\",\n        className,\n      )}\n    >\n      <div className=\"[overflow-wrap:anywhere]\">\n        {lead === null ? (\n          line\n        ) : (\n          <>\n            <span className=\"font-medium text-[var(--text-secondary)]\">{lead}</span>\n            {submitter}\n          </>\n        )}\n      </div>\n      <Checkbox\n        checked={attachUrl}\n        onCheckedChange={onAttachUrlChange}\n        label={<span className=\"text-xs font-medium text-[var(--text-secondary)]\">{labels.attachUrl}</span>}\n        description={\n          url ? (\n            // `break-all`: a URL is one unbreakable word, and at 390px a long query string\n            // would otherwise push the dialog sideways.\n            <span\n              data-withheld={attachUrl ? undefined : \"\"}\n              className={cn(\"break-all text-xs\", !attachUrl && \"line-through opacity-60\")}\n            >\n              {url}\n            </span>\n          ) : undefined\n        }\n      />\n    </div>\n  );\n}\n"],"mappings":";AA+LU,mBACE,KADF;AA/LV,SAAS,gBAAgB;AACzB,SAAS,uBAAuB,oBAAoB;AACpD,SAAS,UAAU;AAmCnB,SAAS,cAAc,MAAoD;AACzE,QAAM,OAAO,MAAM,cAAc,KAAK;AACtC,QAAM,QAAQ,MAAM,OAAO,KAAK;AAChC,MAAI,QAAQ,MAAO,QAAO,GAAG,IAAI,KAAK,KAAK;AAC3C,SAAO,QAAQ,SAAS;AAC1B;AAgCA,SAAS,OAAO,KAAa,MAAkC;AAC7D,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI;AACF,WAAO,IAAI,IAAI,KAAK,QAAQ,kBAAkB,EAAE;AAAA,EAClD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeO,SAAS,gBAAgB,OAA8C;AAC5E,QAAM,EAAE,MAAM,WAAW,IAAI,IAAI;AACjC,QAAM,MAAM,OAAO,WAAW,cAAc,SAAY;AACxD,QAAM,SAAS,MAAM,UAAU,KAAK,SAAS,UAAU;AACvD,QAAM,UAA2B;AAAA,IAC/B,KAAK,YAAY,MAAM;AAAA,IACvB,OAAO,YAAa,MAAM,SAAS,OAAO,KAAK,UAAU,KAAK,SAAS,IAAI,IAAK;AAAA,IAChF;AAAA,EACF;AACA,MAAI,MAAM,gBAAgB,OAAW,SAAQ,cAAc,MAAM;AACjE,UAAQ,UAAU,MAAM,MAAM;AAC9B,UAAQ,aAAa,MAAM,SAAS;AACpC,UAAQ,oBAAoB,MAAM,gBAAgB;AAClD,UAAQ,WAAW,MAAM,aAAa,MAAM,GAAG,IAAI,UAAU,IAAI,IAAI,WAAW,KAAK;AACrF,UAAQ,KAAK,MAAM,OAAO,OAAO,cAAc,cAAc,KAAK,UAAU;AAC5E,MAAI,MAAM,YAAY,OAAW,SAAQ,UAAU,MAAM;AACzD,SAAO;AACT;AAiBO,MAAM,kCAAyD;AAAA,EACpE,MAAM;AAAA,EACN,WAAW;AACb;AA8BO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AAAA,EACR;AACF,GAA4B;AAC1B,QAAM,SAAS,aAAa,mBAAmB,iCAAiC,UAAU;AAC1F,QAAM,SAAS,aAAa,UAAU,qBAAqB;AAC3D,QAAM,YAAY,cAAc,IAAI;AAKpC,QAAM,OAAO,OAAO,WAAW,OAAO,MAAM,SAAS;AACrD,QAAM,OAAO,KAAK,SAAS,SAAS,IAAI,KAAK,MAAM,GAAG,KAAK,SAAS,UAAU,MAAM,IAAI;AACxF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,WAAW;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,MAEA;AAAA,4BAAC,SAAI,WAAU,4BACZ,mBAAS,OACR,OAEA,iCACE;AAAA,8BAAC,UAAK,WAAU,4CAA4C,gBAAK;AAAA,UAChE;AAAA,WACH,GAEJ;AAAA,QACA;AAAA,UAAC;AAAA;AAAA,YACC,SAAS;AAAA,YACT,iBAAiB;AAAA,YACjB,OAAO,oBAAC,UAAK,WAAU,oDAAoD,iBAAO,WAAU;AAAA,YAC5F,aACE;AAAA;AAAA;AAAA,cAGE;AAAA,gBAAC;AAAA;AAAA,kBACC,iBAAe,YAAY,SAAY;AAAA,kBACvC,WAAW,GAAG,qBAAqB,CAAC,aAAa,yBAAyB;AAAA,kBAEzE;AAAA;AAAA,cACH;AAAA,gBACE;AAAA;AAAA,QAER;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/feedback/feedback-crash.d.ts

@@ -0,0 +1,276 @@
+import { CrashReport } from '../components/error-boundary.js';
+import { ah as FeedbackEnvironment } from '../kit-labels-DQg82eHB.js';
+import 'react';
+import '../data-table-labels-DUELeXpa.js';
+import '../components/data-table-sort.js';
+import '../components/swipeable-row.js';
+import '../components/mini-calendar.js';
+import '../components/calendar-heatmap.js';
+import '../components/popover.js';
+import '../components/chip.js';
+import 'lucide-react';
+import '../components/field-sync.js';
+import '../components/tooltip.js';
+import '../hooks/use-anchored-rect.js';
+import '../lib/clipping.js';
+import '../wizard/types.js';
+import '../tour/tour.js';
+import '../search/command-palette.js';
+import '../search/global-search.js';
+import '../search/search-index.js';
+import '../components/month-picker.js';
+import '../components/page-contents.js';
+import '../components/series-chart-labels.js';
+import '../components/pie-chart-labels.js';
+import '../components/sparkline.js';
+import '../components/stat-tile.js';
+import '../components/signature-pad.js';
+import '../components/password-strength.js';
+import '../components/swatch-picker.js';
+import '../components/tile-radio.js';
+import '../components/icon-picker.js';
+import '../components/dialog-frame.js';
+import '../components/modal.js';
+import '../hooks/use-search-param-state.js';
+import '../components/measured-grid.js';
+import '../components/user-avatar.js';
+import '../components/status-dot.js';
+import '../components/progress-bar.js';
+import '../components/signed-amount.js';
+import '../shell/topbar-action-menu.js';
+import '../components/menu-item.js';
+import '../components/floating-panel.js';
+import '../hooks/use-authed-src.js';
+import '../components/account-settings-labels.js';
+import '../components/bulk-action-bar.js';
+import '../components/list.js';
+import '../components/breadcrumbs.js';
+import '../components/toast.js';
+import '../components/description-list.js';
+import '../components/line-items.js';
+import '../components/authed-image.js';
+import '../components/image-grid.js';
+import '../components/lightbox.js';
+import '../components/write-lock.js';
+import '../components/legal.js';
+import '../components/account-chips.js';
+import '../lib/format.js';
+import '../components/reauth-dialog.js';
+import '../components/server-wake.js';
+import '../lib/server-wake.js';
+import '../components/translation-review-labels.js';
+import '../lib/translation-review.js';
+import '../components/country-select.js';
+import '../components/inline-edit-field.js';
+import '../lib/iban.js';
+import '../lib/phone.js';
+import '../components/sign-chip.js';
+import '../components/column-mapper.js';
+import '../lib/column-mapping.js';
+import '../lib/table-text.js';
+import '../components/field-parts.js';
+
+/**
+ * `POST /feedback/crash`'s body — `CrashReportCreate`, §3.6 (kk `schemas/feedback.py`),
+ * including the optional `origin` and `environment` the server copies into the row's
+ * `context`, so a dev crash no longer reads as prod and the admin list shows its env
+ * chip (§3.2).
+ *
+ * Every string is clamped to the server's column width before it is sent: one character
+ * over a `max_length` used to come back 422 and the report was lost (kk
+ * `crash-report.ts:104-106`) — the diagnostics are worth more truncated than not
+ * delivered. Empty strings are sent as `null`.
+ */
+interface CrashReportCreate {
+    /** The thrown value's `name`, ≤ 200. */
+    name: string | null;
+    /** 1–2000; `"(no message)"` when the error had none. */
+    message: string;
+    /** ≤ 8000 each. */
+    stack: string | null;
+    component_stack: string | null;
+    /** The boundary's `placement`: `"app"` stays `"app"`, anything else is `"page"`. */
+    boundary: "app" | "page";
+    /** `origin` + the redacted page, ≤ 2000. */
+    url: string | null;
+    /** The redacted page's pathname, ≤ 500. */
+    route: string | null;
+    /** ≤ 50 each. */
+    version: string | null;
+    viewport: string | null;
+    /** ≤ 500. */
+    ua: string | null;
+    online: boolean | null;
+    /** ISO 8601, UTC — when it crashed, not when a buffered copy was finally sent. */
+    occurred_at: string;
+    /** `location.origin` — which copy of the app (§3.2). ≤ 200. */
+    origin: string | null;
+    /** `"prod"` / `"dev"` / `"local"` (§3.2) — the app's `environment` option. ≤ 20. */
+    environment: string | null;
+}
+/** `POST /feedback/crash`'s answer — always a 202 (§3.6). Only `stored` decides. */
+interface CrashReportResponse {
+    /** `false` when the server dropped it on purpose: the limiter, a demo user. */
+    stored: boolean;
+    /** `true` when it was counted onto an open row with the same fingerprint. */
+    duplicate?: boolean;
+    feedback_id?: number | null;
+    /** The fingerprint's first 8 characters, for the user to quote. */
+    reference?: string | null;
+}
+/**
+ * What {@link CrashReporter.onReport} resolves with — the kit `ErrorBoundary`'s
+ * `CrashReportResult`, narrowed to the three answers the fallback tells apart:
+ *
+ * - **filed with a reference** — `{ reference: "3fae6774" }`: the server stored it
+ *   (`stored === true`) and named it; the screen says "Reported as 3fae6774" and drops
+ *   the copy button;
+ * - **filed** — `{}`: stored, but the server gave no reference; the screen says "This
+ *   error has been reported automatically.";
+ * - **not filed** — `{ filed: false }`: suppressed by the app (`suppress`, a hot
+ *   update, a chunk-load error), refused by the server (`stored: false`, a 4xx), or
+ *   buffered for later (offline, signed out, 401, 5xx, no network). The screen claims
+ *   nothing and keeps the copy button.
+ *
+ * Code that reads it outside a boundary: filed is `result.filed !== false`.
+ */
+type CrashFiling = {
+    reference?: string;
+} | {
+    filed: false;
+};
+interface CrashReporterOptions {
+    /** The app's crash route, e.g. `${API_BASE}/feedback/crash` (§3.3). */
+    endpoint: string;
+    /**
+     * The bearer token, read at the moment of filing — **never assumed to exist**. Nothing
+     * (`null`, `undefined`, `""`) means signed out, or not yet signed in again (kastlan
+     * keeps its access token in memory, so it is `null` at start-up until the refresh
+     * lands): the report is buffered and {@link CrashReporter.flushPending} sends it once
+     * a token appears.
+     *
+     * Must not touch React — no hooks, no context: it runs from a component that is
+     * mid-crash. Read storage or a store's `getState()` (kk `crash-report.ts:175-181`).
+     * A throw reads as "no token".
+     */
+    getToken: () => string | null | undefined;
+    /**
+     * The query params a report may keep — the app's ALLOW-list (§4.6). Everything else
+     * is dropped, so a param added later stays out until somebody decides otherwise.
+     * keksdose's: `p ps sort tab g granularity month preset from to tstate future
+     * archived uncleared` (kk `crash-report.ts:136-151`) — what locates a render crash
+     * (paging, sort, range, grouping), never `q` (free text), `f.*` (filters holding
+     * payee names) or ids (`row`, `action`). Copied when the reporter is made.
+     */
+    allowParams: Iterable<string>;
+    /** The `localStorage` key undeliverable reports wait under — one per app, e.g.
+     *  keksdose's `"keksdose.pendingCrashReports"` (kk `crash-report.ts:35`). */
+    storageKey: string;
+    /**
+     * The app's own opt-out: `true` files nothing and buffers nothing — keksdose's demo
+     * sessions (kk `crash-report.ts:183-193`; its server answers `stored: false` for them
+     * anyway). Asked at filing time and again before a flush, which keeps the buffer
+     * while it says `true`. Must not touch React; a throw reads as `false`. Optional:
+     * kastlan has no demo users.
+     */
+    suppress?: () => boolean;
+    /** The deploy environment, copied into every report (§3.2; kk
+     *  `app/deploy-environment.ts`). */
+    environment: FeedbackEnvironment | (string & {});
+    /** Which copy of the app — default `location.origin` at filing time. */
+    origin?: string;
+    /** The app build — default the boundary's `appVersion` prop, as the report carries it. */
+    version?: string;
+    /** The `fetch` to post with — default the global one, looked up at each call. For
+     *  tests (no network) and for an app whose `fetch` is wrapped. */
+    fetchImpl?: typeof fetch;
+}
+/** What {@link createCrashReporter} returns. Every member is a free function (no
+ *  `this`), safe to pass as a prop or a listener as it stands. */
+interface CrashReporter {
+    /**
+     * The boundary's `onReport`: file one crash and say how it went ({@link CrashFiling}).
+     * Never throws, never rejects.
+     *
+     * The report arrives already `redact`ed when this reporter's `redact` is the
+     * boundary's too; the page is reduced again here anyway, because the allow-list is
+     * the one thing this channel must never get wrong (kk `crash-report.ts:273-276`).
+     */
+    onReport: (report: CrashReport) => Promise<CrashFiling>;
+    /**
+     * The boundary's `redact`: the report with its page reduced to the pathname and the
+     * allowed query params (no hash). The screen's details and the copy button — whose
+     * text ends up pasted into a feedback message — then show the same reduced page as the
+     * POST (kk `crash-report.ts:114-135`). `extras` are the app's own and pass unchanged.
+     */
+    redact: (report: CrashReport) => CrashReport;
+    /**
+     * Send the buffered reports. Call it at start-up and whenever a token appears (kk
+     * `main.tsx:59-61`). One flush at a time — a second call while one runs joins it.
+     * Keeps the buffer while there is no token, the app suppresses, or the browser is
+     * offline; stops at the first 401/5xx/network failure and keeps the rest. Never
+     * rejects.
+     */
+    flushPending: () => Promise<void>;
+    /**
+     * Note that Vite has just applied a hot update: a crash within 10 s of one is HMR
+     * fallout (a module re-executed under a live React tree), not the app's bug, and is
+     * not filed (kk `crash-report.ts:56-102`; eight rows across five keksdose feedback
+     * runs were exactly this). Dev only by construction — a production build has no
+     * `import.meta.hot` to call it from. The kit cannot listen itself (a pre-bundled
+     * dependency sees no `import.meta.hot`), so the app wires both events:
+     *
+     * ```ts
+     * if (import.meta.hot) {
+     *   import.meta.hot.on("vite:beforeUpdate", () => crashReporter.noteHotUpdate());
+     *   import.meta.hot.on("vite:afterUpdate", () => crashReporter.noteHotUpdate());
+     * }
+     * ```
+     */
+    noteHotUpdate: (at?: number) => void;
+}
+/**
+ * Make the crash filer for one app — §4.6, the kit's half of keksdose's
+ * `shared/lib/crash-report.ts`. Hand the result to both boundaries (`placement="app"`
+ * at the root, `"page"` in the layout):
+ *
+ * ```tsx
+ * export const crashReporter = createCrashReporter({
+ *   endpoint: `${API_BASE}/feedback/crash`,
+ *   getToken: () => localStorage.getItem("auth_token"),
+ *   allowParams: ["p", "ps", "sort", "tab"],
+ *   storageKey: "myapp.pendingCrashReports",
+ *   suppress: () => useAuth.getState().user?.is_demo === true,
+ *   environment: deployEnvironment(),
+ * });
+ *
+ * <ErrorBoundary placement="page" appVersion={APP_VERSION}
+ *   redact={crashReporter.redact} onReport={crashReporter.onReport}>
+ *
+ * // start-up, and whenever a token appears (kk main.tsx:59-61)
+ * void crashReporter.flushPending();
+ * useAuth.subscribe((s, prev) => { if (s.token && !prev.token) void crashReporter.flushPending(); });
+ * ```
+ *
+ * What it sends: §3.6's `CrashReportCreate` ({@link CrashReportCreate}) with `origin`
+ * and `environment`, clamped to the server's caps. How: a bare `fetch` with `keepalive`
+ * and the bearer token — **not the app's axios client**, whose 401 handler would log the
+ * user out of a page that has just crashed (kk `crash-report.ts:222-235`), and
+ * `keepalive` so the request survives the Reload the user is about to press.
+ *
+ * When it files nothing (resolving `{ filed: false }`):
+ * - a chunk-load error (the boundary already withholds those) — a deploy or a dropped
+ *   connection, not a defect;
+ * - `suppress()` says so (demo sessions), or a hot update landed under 10 s ago;
+ * - the server answered `stored: false` (limiter, demo) or a 4xx other than 401 —
+ *   dropped, never retried: the server will never take that payload.
+ *
+ * When it buffers (also `{ filed: false }` — not filed *yet*): offline, no token,
+ * 401, 5xx, or no network. Up to 3 reports wait under `storageKey`, the newest kept,
+ * identical crashes kept once (see `bufferKey`); {@link CrashReporter.flushPending}
+ * sends them. A signed-out visitor's crash waits for a sign-in — there is no
+ * unauthenticated crash endpoint (Kurvenschmiede's public pages; accepted, §4.6).
+ */
+declare function createCrashReporter(options: CrashReporterOptions): CrashReporter;
+
+export { type CrashFiling, type CrashReportCreate, type CrashReportResponse, type CrashReporter, type CrashReporterOptions, createCrashReporter };