@eifi1/ui-kit 0.33.0 → 0.34.0

package/dist/demo/demo-labels.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/demo/demo-labels.ts"],"sourcesContent":["import { useKitLabels } from \"../i18n/kit-labels\";\n\n/**\n * The demo's words (docs/landing-demo-harmonization.md §5) — the `demo` namespace of\n * `<UiKitProvider labels>`: `DemoStart`'s progress and refusals, `DemoBanner`'s\n * countdown and model line, `DemoEnded`, and the reason of the read-only lock.\n *\n * \"Demo\" means the demo session and the shared demo data it shows (§2.10) — never\n * keksdose's blur toggle, which is \"Presentation mode\" now. \"Request access\" and \"Sign\n * in\" are the `landing` namespace's, so they read the same on every public page.\n */\nexport interface DemoLabels {\n  /** `DemoStart` while the demo is being created. */\n  starting: string;\n  /** `demo_rate_limited`: too many demos from one network, given the wait in whole\n   *  minutes from `Retry-After` — or `undefined` without one. */\n  rateLimited: (minutes?: number) => string;\n  /** `demo_capacity`: the live cap is reached. */\n  capacity: string;\n  /** `demo_disabled` and `demo_not_ready`: the demo is off, or its data isn't there. */\n  unavailable: string;\n  /** Any other failure — the network, a 500. */\n  failed: string;\n  /** `DemoStart`'s way out after a refusal, to the landing. */\n  backToStart: string;\n  /** The banner's countdown with an hour or more left: \"Demo · 23 h 12 min left\". */\n  hoursLeft: (hours: number, minutes: number) => string;\n  /** …and in the last hour, minutes only: \"Demo · 50 min left\". */\n  minutesLeft: (minutes: number) => string;\n  /** The banner's word when the end is unknown (no readable `expiresAt`). */\n  badge: string;\n  /** The banner's line for model R, shared read-only data. */\n  readOnly: string;\n  /** The banner's line for model S, a sandbox of one's own. */\n  sandbox: string;\n  /** The name of the banner's show/hide toggle (`aria-expanded` says which). */\n  details: string;\n  /** The reason a locked commit shows in a read-only demo (model R) — for the app's\n   *  `<WriteLockProvider locked reason={…}>` (§5.4). */\n  writeLocked: string;\n  /** `DemoEnded`'s heading; also the banner's text at zero. */\n  endedTitle: string;\n  /** `DemoEnded`'s line for model R. */\n  endedReadOnly: string;\n  /** `DemoEnded`'s line for model S. */\n  endedSandbox: string;\n  /** `DemoEnded`'s first action, to `/demo`. */\n  restart: string;\n}\n\nexport const DEFAULT_DEMO_LABELS: DemoLabels = {\n  starting: \"Starting the demo…\",\n  rateLimited: (minutes) =>\n    minutes\n      ? `Too many demos from this network. Try again in ${minutes} min.`\n      : \"Too many demos from this network. Try again later.\",\n  capacity: \"The demo is full right now. Try again later.\",\n  unavailable: \"The demo isn’t available right now.\",\n  failed: \"The demo could not be started. Please try again.\",\n  backToStart: \"Back to the start page\",\n  hoursLeft: (hours, minutes) => `Demo · ${hours} h ${minutes} min left`,\n  minutesLeft: (minutes) => `Demo · ${minutes} min left`,\n  badge: \"Demo\",\n  readOnly: \"You’re looking at sample data. Changes aren’t possible.\",\n  sandbox: \"Your own work is deleted when the demo ends.\",\n  details: \"Demo details\",\n  writeLocked: \"Not possible in the demo.\",\n  endedTitle: \"The demo has ended\",\n  endedReadOnly: \"Sample data is reset regularly.\",\n  endedSandbox: \"Sample data is reset regularly; your own work from the demo is deleted.\",\n  restart: \"Start a new demo\",\n};\n\n/** The `demo` namespace, resolved: English, then the provider, then `labels`. The app\n *  reads `writeLocked` from here for its `WriteLockProvider`. */\nexport function useDemoLabels(labels?: Partial<DemoLabels>): DemoLabels {\n  return useKitLabels(\"demo\", DEFAULT_DEMO_LABELS, labels);\n}\n"],"mappings":";AAAA,SAAS,oBAAoB;AAkDtB,MAAM,sBAAkC;AAAA,EAC7C,UAAU;AAAA,EACV,aAAa,CAAC,YACZ,UACI,kDAAkD,OAAO,UACzD;AAAA,EACN,UAAU;AAAA,EACV,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,WAAW,CAAC,OAAO,YAAY,aAAU,KAAK,MAAM,OAAO;AAAA,EAC3D,aAAa,CAAC,YAAY,aAAU,OAAO;AAAA,EAC3C,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,cAAc;AAAA,EACd,SAAS;AACX;AAIO,SAAS,cAAc,QAA0C;AACtE,SAAO,aAAa,QAAQ,qBAAqB,MAAM;AACzD;","names":[]}
+{"version":3,"sources":["../../src/demo/demo-labels.ts"],"sourcesContent":["import { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\n\n/**\n * The demo's words (docs/landing-demo-harmonization.md §5) — the `demo` namespace of\n * `<UiKitProvider labels>`: `DemoStart`'s progress and refusals, `DemoBanner`'s\n * countdown and model line, `DemoEnded`, and the reason of the read-only lock.\n *\n * \"Demo\" means the demo session and the shared demo data it shows (§2.10) — never\n * keksdose's blur toggle, which is \"Presentation mode\" now. \"Request access\" and \"Sign\n * in\" are the `landing` namespace's, so they read the same on every public page.\n */\nexport interface DemoLabels {\n  /** `DemoStart` while the demo is being created. */\n  starting: string;\n  /** `demo_rate_limited`: too many demos from one network, given the wait in whole\n   *  minutes from `Retry-After` — or `undefined` without one. */\n  rateLimited: (minutes?: number) => string;\n  /** `demo_capacity`: the live cap is reached. */\n  capacity: string;\n  /** `demo_disabled` and `demo_not_ready`: the demo is off, or its data isn't there. */\n  unavailable: string;\n  /** Any other failure — the network, a 500. */\n  failed: string;\n  /** `DemoStart`'s way out after a refusal, to the landing. */\n  backToStart: string;\n  /** The banner's countdown with an hour or more left: \"Demo · 23 h 12 min left\". */\n  hoursLeft: (hours: number, minutes: number) => string;\n  /** …and in the last hour, minutes only: \"Demo · 50 min left\". */\n  minutesLeft: (minutes: number) => string;\n  /** The banner's word when the end is unknown (no readable `expiresAt`). */\n  badge: string;\n  /** The banner's line for model R, shared read-only data. */\n  readOnly: string;\n  /** The banner's line for model S, a sandbox of one's own. */\n  sandbox: string;\n  /** The name of the banner's show/hide toggle (`aria-expanded` says which). */\n  details: string;\n  /** The reason a locked commit shows in a read-only demo (model R) — for the app's\n   *  `<WriteLockProvider locked reason={…}>` (§5.4). */\n  writeLocked: string;\n  /** `DemoEnded`'s heading; also the banner's text at zero. */\n  endedTitle: string;\n  /** `DemoEnded`'s line for model R. */\n  endedReadOnly: string;\n  /** `DemoEnded`'s line for model S. */\n  endedSandbox: string;\n  /** `DemoEnded`'s first action, to `/demo`. */\n  restart: string;\n}\n\nexport const DEFAULT_DEMO_LABELS: DemoLabels = {\n  starting: \"Starting the demo…\",\n  rateLimited: (minutes) =>\n    minutes\n      ? `Too many demos from this network. Try again in ${minutes} min.`\n      : \"Too many demos from this network. Try again later.\",\n  capacity: \"The demo is full right now. Try again later.\",\n  unavailable: \"The demo isn’t available right now.\",\n  failed: \"The demo could not be started. Please try again.\",\n  backToStart: \"Back to the start page\",\n  hoursLeft: (hours, minutes) => `Demo · ${hours} h ${minutes} min left`,\n  minutesLeft: (minutes) => `Demo · ${minutes} min left`,\n  badge: \"Demo\",\n  readOnly: \"You’re looking at sample data. Changes aren’t possible.\",\n  sandbox: \"Your own work is deleted when the demo ends.\",\n  details: \"Demo details\",\n  writeLocked: \"Not possible in the demo.\",\n  endedTitle: \"The demo has ended\",\n  endedReadOnly: \"Sample data is reset regularly.\",\n  endedSandbox: \"Sample data is reset regularly; your own work from the demo is deleted.\",\n  restart: \"Start a new demo\",\n};\n\n/** The `demo` namespace, resolved: English, then the provider, then `labels`. The app\n *  reads `writeLocked` from here for its `WriteLockProvider`. */\nexport function useDemoLabels(labels?: LabelOverride<DemoLabels>): DemoLabels {\n  return useKitLabels(\"demo\", DEFAULT_DEMO_LABELS, labels);\n}\n"],"mappings":";AAAA,SAAS,oBAAwC;AAkD1C,MAAM,sBAAkC;AAAA,EAC7C,UAAU;AAAA,EACV,aAAa,CAAC,YACZ,UACI,kDAAkD,OAAO,UACzD;AAAA,EACN,UAAU;AAAA,EACV,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,aAAa;AAAA,EACb,WAAW,CAAC,OAAO,YAAY,aAAU,KAAK,MAAM,OAAO;AAAA,EAC3D,aAAa,CAAC,YAAY,aAAU,OAAO;AAAA,EAC3C,OAAO;AAAA,EACP,UAAU;AAAA,EACV,SAAS;AAAA,EACT,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,cAAc;AAAA,EACd,SAAS;AACX;AAIO,SAAS,cAAc,QAAgD;AAC5E,SAAO,aAAa,QAAQ,qBAAqB,MAAM;AACzD;","names":[]}

package/dist/demo/demo-session.d.ts

@@ -6,10 +6,10 @@
  * - `sandbox` (S) — Kurvenschmiede: the demo user reads system-owned worked examples and
  *   may create or copy work of its own, deleted with the demo account.
  */
-type DemoModel = "read-only" | "sandbox";
+export type DemoModel = "read-only" | "sandbox";
 /** The fields of an `/auth/me` answer {@link isDemoSession} reads — server-kit's
  *  `UserResponse.is_demo` (0.5: and `demo_expires_at`), or a client's camel-cased copy. */
-interface DemoSessionUser {
+export interface DemoSessionUser {
     is_demo?: boolean | null;
     isDemo?: boolean | null;
 }
@@ -25,6 +25,4 @@ interface DemoSessionUser {
  * createCrashReporter({ …, suppress: () => isDemoSession(useAuth.getState().user) });
  * ```
  */
-declare function isDemoSession(me: DemoSessionUser | null | undefined): boolean;
-
-export { type DemoModel, type DemoSessionUser, isDemoSession };
+export declare function isDemoSession(me: DemoSessionUser | null | undefined): boolean;

package/dist/demo/demo-start.d.ts

@@ -1,10 +1,9 @@
-import * as react from 'react';
-import { ComponentPropsWithoutRef } from 'react';
-import { AccessChoice } from '../landing/access.js';
-import { LandingLabels } from '../landing/landing-labels.js';
-import { DemoLabels } from './demo-labels.js';
-
-interface DemoStartProps<T> extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+import type { ComponentPropsWithRef } from "react";
+import type { AccessChoice } from "../landing/access.js";
+import type { LandingLabels } from "../landing/landing-labels.js";
+import type { DemoLabels } from "./demo-labels.js";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+export interface DemoStartProps<T> extends Omit<ComponentPropsWithRef<"div">, "children"> {
     /**
      * Create the demo: the app's `POST /auth/demo-session {locale}`. Resolve with what it
      * answered (the `TokenResponse`, `refresh_token: null`, `expires_at`); reject with the
@@ -21,7 +20,7 @@ interface DemoStartProps<T> extends Omit<ComponentPropsWithoutRef<"div">, "child
     /** `false` adds no `noindex` — for a preview. Default `true`: `/demo` is never indexed
      *  (§4.3). */
     noIndex?: boolean;
-    labels?: Partial<DemoLabels>;
+    labels?: LabelOverride<DemoLabels>;
     /** The access words (`landing` namespace) for this instance. */
     landingLabels?: Partial<LandingLabels>;
 }
@@ -49,6 +48,4 @@ interface DemoStartProps<T> extends Omit<ComponentPropsWithoutRef<"div">, "child
  * `ServerWakeNotice`'s, once the app's watcher counts this POST
  * (`watchReadsAnd(/\/auth\/demo-session\b/)`).
  */
-declare function DemoStart<T>({ start, onStarted, access, backHref, noIndex, labels: labelsProp, landingLabels, className, ...rest }: DemoStartProps<T>): react.JSX.Element;
-
-export { DemoStart, type DemoStartProps };
+export declare function DemoStart<T>({ start, onStarted, access, backHref, noIndex, labels: labelsProp, landingLabels, className, ...rest }: DemoStartProps<T>): import("react").JSX.Element;

package/dist/demo/demo-start.js

@@ -3,7 +3,8 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { cn } from "../lib/cn.js";
 import { AlertBanner } from "../components/alert-banner.js";
-import { Button, Spinner } from "../components/ui.js";
+import { Button } from "../components/button.js";
+import { Spinner } from "../components/spinner.js";
 import { useNoIndex } from "../hooks/use-noindex.js";
 import { authErrorCode, isRateLimited, retryAfterSeconds } from "../auth/auth-errors.js";
 import { useOncePerKey } from "../auth/status-parts.js";
@@ -52,7 +53,7 @@ function DemoStart({
     else setRefusal(refusalOf(result.error));
   });
   return /* @__PURE__ */ jsxs("div", { ...rest, className: cn("flex flex-col items-center gap-4 py-4 text-center", className), children: [
-    /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "polite", className: "w-full", children: refusal === null ? /* @__PURE__ */ jsxs("p", { className: "flex items-center justify-center gap-2 text-sm text-[var(--text-secondary)]", children: [
+    /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "polite", className: "w-full", children: refusal === null ? /* @__PURE__ */ jsxs("p", { className: "flex items-center justify-center gap-2 text-sm text-secondary", children: [
       /* @__PURE__ */ jsx(Spinner, { label: null, className: "size-5" }),
       labels.starting
     ] }) : /* @__PURE__ */ jsx(AlertBanner, { tone: refusal.reason === "failed" ? "danger" : "warning", className: "text-start", children: messageOf(refusal, labels) }) }),

package/dist/demo/demo-start.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/demo/demo-start.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ComponentPropsWithoutRef } from \"react\";\n\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button, Spinner } from \"../components/ui\";\nimport { useNoIndex } from \"../hooks/use-noindex\";\nimport { authErrorCode, isRateLimited, retryAfterSeconds } from \"../auth/auth-errors\";\nimport { useOncePerKey } from \"../auth/status-parts\";\nimport { useAccessAction } from \"../landing/access\";\nimport type { AccessChoice } from \"../landing/access\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport { useDemoLabels } from \"./demo-labels\";\nimport type { DemoLabels } from \"./demo-labels\";\n\n/** Why a start was refused, in the page's terms (§5.2). */\ntype Refusal =\n  | { reason: \"rateLimited\"; minutes?: number }\n  | { reason: \"capacity\" }\n  | { reason: \"unavailable\" }\n  | { reason: \"failed\" };\n\n/**\n * The server's answer to `POST /auth/demo-session`, read as a refusal (§5.1, §6.2):\n * `demo_rate_limited` (429, with `Retry-After`), `demo_capacity` (429, without),\n * `demo_disabled` (404) and `demo_not_ready` (503) by their codes; a bare 429 as the\n * per-IP window too; anything else is a plain failure.\n */\nfunction refusalOf(error: unknown): Refusal {\n  const code = authErrorCode(error);\n  if (code === \"demo_capacity\") return { reason: \"capacity\" };\n  if (code === \"demo_disabled\" || code === \"demo_not_ready\") return { reason: \"unavailable\" };\n  if (code === \"demo_rate_limited\" || (code === undefined && isRateLimited(error))) {\n    const seconds = retryAfterSeconds(error);\n    return { reason: \"rateLimited\", minutes: seconds ? Math.ceil(seconds / 60) : undefined };\n  }\n  return { reason: \"failed\" };\n}\n\nfunction messageOf(refusal: Refusal, labels: DemoLabels): string {\n  switch (refusal.reason) {\n    case \"rateLimited\":\n      return labels.rateLimited(refusal.minutes);\n    case \"capacity\":\n      return labels.capacity;\n    case \"unavailable\":\n      return labels.unavailable;\n    case \"failed\":\n      return labels.failed;\n  }\n}\n\n/** The one start a mount makes. */\nconst ONCE = \"demo\";\n\nexport interface DemoStartProps<T> extends Omit<ComponentPropsWithoutRef<\"div\">, \"children\"> {\n  /**\n   * Create the demo: the app's `POST /auth/demo-session {locale}`. Resolve with what it\n   * answered (the `TokenResponse`, `refresh_token: null`, `expires_at`); reject with the\n   * client's error — the codes are read out of it. Called once per mount.\n   */\n  start: () => Promise<T>;\n  /** The demo exists: store the session (and, for kastlan, `kastlan.demoSession`) and\n   *  replace to the app's home. The page keeps saying \"Starting the demo…\" meanwhile. */\n  onStarted: (session: T) => void;\n  /** \"Request access\" beside a refusal. */\n  access: AccessChoice;\n  /** \"Back to the start page\". Default `/`. */\n  backHref?: string;\n  /** `false` adds no `noindex` — for a preview. Default `true`: `/demo` is never indexed\n   *  (§4.3). */\n  noIndex?: boolean;\n  labels?: Partial<DemoLabels>;\n  /** The access words (`landing` namespace) for this instance. */\n  landingLabels?: Partial<LandingLabels>;\n}\n\n/**\n * The `/demo` page's content (docs/landing-demo-harmonization.md §5.2): it starts the\n * demo ONCE — StrictMode's double mount included, keksdose's ref guard — and says\n * \"Starting the demo…\" until the app has the session and has moved on.\n *\n * A refusal says why, in the visitor's words, and offers \"Request access\" and \"Back to\n * the start page\":\n *\n * | code | says |\n * |---|---|\n * | `demo_rate_limited` (429) | \"Too many demos from this network. Try again in N min.\" — N from `Retry-After` |\n * | `demo_capacity` (429) | \"The demo is full right now. Try again later.\" |\n * | `demo_disabled` (404), `demo_not_ready` (503) | \"The demo isn't available right now.\" |\n * | anything else | \"The demo could not be started. Please try again.\" |\n *\n * keksdose fell back to `/register` with a toast; registration is invitation-only now,\n * so the way on is the access mail.\n *\n * Put it in the app's `AuthLayout`. A live demo session never reaches it: the `/demo`\n * route sits in `RedirectIfAuthed` WITHOUT `allowDemo`, which continues the live demo at\n * its resume target instead of starting a second one. A cold start is the kit's\n * `ServerWakeNotice`'s, once the app's watcher counts this POST\n * (`watchReadsAnd(/\\/auth\\/demo-session\\b/)`).\n */\nexport function DemoStart<T>({\n  start,\n  onStarted,\n  access,\n  backHref = \"/\",\n  noIndex = true,\n  labels: labelsProp,\n  landingLabels,\n  className,\n  ...rest\n}: DemoStartProps<T>) {\n  const labels = useDemoLabels(labelsProp);\n  const accessLink = useAccessAction(access, landingLabels);\n  const [refusal, setRefusal] = useState<Refusal | null>(null);\n  useNoIndex(noIndex);\n  useOncePerKey<T>(ONCE, () => start(), (_key, result) => {\n    if (result.ok) onStarted(result.value);\n    else setRefusal(refusalOf(result.error));\n  });\n\n  return (\n    <div {...rest} className={cn(\"flex flex-col items-center gap-4 py-4 text-center\", className)}>\n      {/* One live region, there from the start, so the refusal that replaces the\n          progress line is announced (a region inserted with its text often is not). */}\n      <div role=\"status\" aria-live=\"polite\" className=\"w-full\">\n        {refusal === null ? (\n          <p className=\"flex items-center justify-center gap-2 text-sm text-[var(--text-secondary)]\">\n            <Spinner label={null} className=\"size-5\" />\n            {labels.starting}\n          </p>\n        ) : (\n          <AlertBanner tone={refusal.reason === \"failed\" ? \"danger\" : \"warning\"} className=\"text-start\">\n            {messageOf(refusal, labels)}\n          </AlertBanner>\n        )}\n      </div>\n      {refusal !== null && (\n        <div className=\"flex flex-wrap justify-center gap-3\">\n          <Button href={accessLink.href} variant=\"brand\">\n            {accessLink.label}\n          </Button>\n          <Button href={backHref} variant=\"secondary\">\n            {labels.backToStart}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";AA+HU,SACE,KADF;AA/HV,SAAS,gBAAgB;AAGzB,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,QAAQ,eAAe;AAChC,SAAS,kBAAkB;AAC3B,SAAS,eAAe,eAAe,yBAAyB;AAChE,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAGhC,SAAS,qBAAqB;AAgB9B,SAAS,UAAU,OAAyB;AAC1C,QAAM,OAAO,cAAc,KAAK;AAChC,MAAI,SAAS,gBAAiB,QAAO,EAAE,QAAQ,WAAW;AAC1D,MAAI,SAAS,mBAAmB,SAAS,iBAAkB,QAAO,EAAE,QAAQ,cAAc;AAC1F,MAAI,SAAS,uBAAwB,SAAS,UAAa,cAAc,KAAK,GAAI;AAChF,UAAM,UAAU,kBAAkB,KAAK;AACvC,WAAO,EAAE,QAAQ,eAAe,SAAS,UAAU,KAAK,KAAK,UAAU,EAAE,IAAI,OAAU;AAAA,EACzF;AACA,SAAO,EAAE,QAAQ,SAAS;AAC5B;AAEA,SAAS,UAAU,SAAkB,QAA4B;AAC/D,UAAQ,QAAQ,QAAQ;AAAA,IACtB,KAAK;AACH,aAAO,OAAO,YAAY,QAAQ,OAAO;AAAA,IAC3C,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,EAClB;AACF;AAGA,MAAM,OAAO;AAgDN,SAAS,UAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,QAAM,SAAS,cAAc,UAAU;AACvC,QAAM,aAAa,gBAAgB,QAAQ,aAAa;AACxD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAyB,IAAI;AAC3D,aAAW,OAAO;AAClB,gBAAiB,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,WAAW;AACtD,QAAI,OAAO,GAAI,WAAU,OAAO,KAAK;AAAA,QAChC,YAAW,UAAU,OAAO,KAAK,CAAC;AAAA,EACzC,CAAC;AAED,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,qDAAqD,SAAS,GAGzF;AAAA,wBAAC,SAAI,MAAK,UAAS,aAAU,UAAS,WAAU,UAC7C,sBAAY,OACX,qBAAC,OAAE,WAAU,+EACX;AAAA,0BAAC,WAAQ,OAAO,MAAM,WAAU,UAAS;AAAA,MACxC,OAAO;AAAA,OACV,IAEA,oBAAC,eAAY,MAAM,QAAQ,WAAW,WAAW,WAAW,WAAW,WAAU,cAC9E,oBAAU,SAAS,MAAM,GAC5B,GAEJ;AAAA,IACC,YAAY,QACX,qBAAC,SAAI,WAAU,uCACb;AAAA,0BAAC,UAAO,MAAM,WAAW,MAAM,SAAQ,SACpC,qBAAW,OACd;AAAA,MACA,oBAAC,UAAO,MAAM,UAAU,SAAQ,aAC7B,iBAAO,aACV;AAAA,OACF;AAAA,KAEJ;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/demo/demo-start.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ComponentPropsWithRef } from \"react\";\n\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Spinner } from \"../components/spinner\";\nimport { useNoIndex } from \"../hooks/use-noindex\";\nimport { authErrorCode, isRateLimited, retryAfterSeconds } from \"../auth/auth-errors\";\nimport { useOncePerKey } from \"../auth/status-parts\";\nimport { useAccessAction } from \"../landing/access\";\nimport type { AccessChoice } from \"../landing/access\";\nimport type { LandingLabels } from \"../landing/landing-labels\";\nimport { useDemoLabels } from \"./demo-labels\";\nimport type { DemoLabels } from \"./demo-labels\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\n\n/** Why a start was refused, in the page's terms (§5.2). */\ntype Refusal =\n  | { reason: \"rateLimited\"; minutes?: number }\n  | { reason: \"capacity\" }\n  | { reason: \"unavailable\" }\n  | { reason: \"failed\" };\n\n/**\n * The server's answer to `POST /auth/demo-session`, read as a refusal (§5.1, §6.2):\n * `demo_rate_limited` (429, with `Retry-After`), `demo_capacity` (429, without),\n * `demo_disabled` (404) and `demo_not_ready` (503) by their codes; a bare 429 as the\n * per-IP window too; anything else is a plain failure.\n */\nfunction refusalOf(error: unknown): Refusal {\n  const code = authErrorCode(error);\n  if (code === \"demo_capacity\") return { reason: \"capacity\" };\n  if (code === \"demo_disabled\" || code === \"demo_not_ready\") return { reason: \"unavailable\" };\n  if (code === \"demo_rate_limited\" || (code === undefined && isRateLimited(error))) {\n    const seconds = retryAfterSeconds(error);\n    return { reason: \"rateLimited\", minutes: seconds ? Math.ceil(seconds / 60) : undefined };\n  }\n  return { reason: \"failed\" };\n}\n\nfunction messageOf(refusal: Refusal, labels: DemoLabels): string {\n  switch (refusal.reason) {\n    case \"rateLimited\":\n      return labels.rateLimited(refusal.minutes);\n    case \"capacity\":\n      return labels.capacity;\n    case \"unavailable\":\n      return labels.unavailable;\n    case \"failed\":\n      return labels.failed;\n  }\n}\n\n/** The one start a mount makes. */\nconst ONCE = \"demo\";\n\nexport interface DemoStartProps<T> extends Omit<ComponentPropsWithRef<\"div\">, \"children\"> {\n  /**\n   * Create the demo: the app's `POST /auth/demo-session {locale}`. Resolve with what it\n   * answered (the `TokenResponse`, `refresh_token: null`, `expires_at`); reject with the\n   * client's error — the codes are read out of it. Called once per mount.\n   */\n  start: () => Promise<T>;\n  /** The demo exists: store the session (and, for kastlan, `kastlan.demoSession`) and\n   *  replace to the app's home. The page keeps saying \"Starting the demo…\" meanwhile. */\n  onStarted: (session: T) => void;\n  /** \"Request access\" beside a refusal. */\n  access: AccessChoice;\n  /** \"Back to the start page\". Default `/`. */\n  backHref?: string;\n  /** `false` adds no `noindex` — for a preview. Default `true`: `/demo` is never indexed\n   *  (§4.3). */\n  noIndex?: boolean;\n  labels?: LabelOverride<DemoLabels>;\n  /** The access words (`landing` namespace) for this instance. */\n  landingLabels?: Partial<LandingLabels>;\n}\n\n/**\n * The `/demo` page's content (docs/landing-demo-harmonization.md §5.2): it starts the\n * demo ONCE — StrictMode's double mount included, keksdose's ref guard — and says\n * \"Starting the demo…\" until the app has the session and has moved on.\n *\n * A refusal says why, in the visitor's words, and offers \"Request access\" and \"Back to\n * the start page\":\n *\n * | code | says |\n * |---|---|\n * | `demo_rate_limited` (429) | \"Too many demos from this network. Try again in N min.\" — N from `Retry-After` |\n * | `demo_capacity` (429) | \"The demo is full right now. Try again later.\" |\n * | `demo_disabled` (404), `demo_not_ready` (503) | \"The demo isn't available right now.\" |\n * | anything else | \"The demo could not be started. Please try again.\" |\n *\n * keksdose fell back to `/register` with a toast; registration is invitation-only now,\n * so the way on is the access mail.\n *\n * Put it in the app's `AuthLayout`. A live demo session never reaches it: the `/demo`\n * route sits in `RedirectIfAuthed` WITHOUT `allowDemo`, which continues the live demo at\n * its resume target instead of starting a second one. A cold start is the kit's\n * `ServerWakeNotice`'s, once the app's watcher counts this POST\n * (`watchReadsAnd(/\\/auth\\/demo-session\\b/)`).\n */\nexport function DemoStart<T>({\n  start,\n  onStarted,\n  access,\n  backHref = \"/\",\n  noIndex = true,\n  labels: labelsProp,\n  landingLabels,\n  className,\n  ...rest\n}: DemoStartProps<T>) {\n  const labels = useDemoLabels(labelsProp);\n  const accessLink = useAccessAction(access, landingLabels);\n  const [refusal, setRefusal] = useState<Refusal | null>(null);\n  useNoIndex(noIndex);\n  useOncePerKey<T>(ONCE, () => start(), (_key, result) => {\n    if (result.ok) onStarted(result.value);\n    else setRefusal(refusalOf(result.error));\n  });\n\n  return (\n    <div {...rest} className={cn(\"flex flex-col items-center gap-4 py-4 text-center\", className)}>\n      {/* One live region, there from the start, so the refusal that replaces the\n          progress line is announced (a region inserted with its text often is not). */}\n      <div role=\"status\" aria-live=\"polite\" className=\"w-full\">\n        {refusal === null ? (\n          <p className=\"flex items-center justify-center gap-2 text-sm text-secondary\">\n            <Spinner label={null} className=\"size-5\" />\n            {labels.starting}\n          </p>\n        ) : (\n          <AlertBanner tone={refusal.reason === \"failed\" ? \"danger\" : \"warning\"} className=\"text-start\">\n            {messageOf(refusal, labels)}\n          </AlertBanner>\n        )}\n      </div>\n      {refusal !== null && (\n        <div className=\"flex flex-wrap justify-center gap-3\">\n          <Button href={accessLink.href} variant=\"brand\">\n            {accessLink.label}\n          </Button>\n          <Button href={backHref} variant=\"secondary\">\n            {labels.backToStart}\n          </Button>\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";AAiIU,SACE,KADF;AAjIV,SAAS,gBAAgB;AAGzB,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAC3B,SAAS,eAAe,eAAe,yBAAyB;AAChE,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAGhC,SAAS,qBAAqB;AAiB9B,SAAS,UAAU,OAAyB;AAC1C,QAAM,OAAO,cAAc,KAAK;AAChC,MAAI,SAAS,gBAAiB,QAAO,EAAE,QAAQ,WAAW;AAC1D,MAAI,SAAS,mBAAmB,SAAS,iBAAkB,QAAO,EAAE,QAAQ,cAAc;AAC1F,MAAI,SAAS,uBAAwB,SAAS,UAAa,cAAc,KAAK,GAAI;AAChF,UAAM,UAAU,kBAAkB,KAAK;AACvC,WAAO,EAAE,QAAQ,eAAe,SAAS,UAAU,KAAK,KAAK,UAAU,EAAE,IAAI,OAAU;AAAA,EACzF;AACA,SAAO,EAAE,QAAQ,SAAS;AAC5B;AAEA,SAAS,UAAU,SAAkB,QAA4B;AAC/D,UAAQ,QAAQ,QAAQ;AAAA,IACtB,KAAK;AACH,aAAO,OAAO,YAAY,QAAQ,OAAO;AAAA,IAC3C,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,EAClB;AACF;AAGA,MAAM,OAAO;AAgDN,SAAS,UAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA,WAAW;AAAA,EACX,UAAU;AAAA,EACV,QAAQ;AAAA,EACR;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAsB;AACpB,QAAM,SAAS,cAAc,UAAU;AACvC,QAAM,aAAa,gBAAgB,QAAQ,aAAa;AACxD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAyB,IAAI;AAC3D,aAAW,OAAO;AAClB,gBAAiB,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,WAAW;AACtD,QAAI,OAAO,GAAI,WAAU,OAAO,KAAK;AAAA,QAChC,YAAW,UAAU,OAAO,KAAK,CAAC;AAAA,EACzC,CAAC;AAED,SACE,qBAAC,SAAK,GAAG,MAAM,WAAW,GAAG,qDAAqD,SAAS,GAGzF;AAAA,wBAAC,SAAI,MAAK,UAAS,aAAU,UAAS,WAAU,UAC7C,sBAAY,OACX,qBAAC,OAAE,WAAU,iEACX;AAAA,0BAAC,WAAQ,OAAO,MAAM,WAAU,UAAS;AAAA,MACxC,OAAO;AAAA,OACV,IAEA,oBAAC,eAAY,MAAM,QAAQ,WAAW,WAAW,WAAW,WAAW,WAAU,cAC9E,oBAAU,SAAS,MAAM,GAC5B,GAEJ;AAAA,IACC,YAAY,QACX,qBAAC,SAAI,WAAU,uCACb;AAAA,0BAAC,UAAO,MAAM,WAAW,MAAM,SAAQ,SACpC,qBAAW,OACd;AAAA,MACA,oBAAC,UAAO,MAAM,UAAU,SAAQ,aAC7B,iBAAO,aACV;AAAA,OACF;AAAA,KAEJ;AAEJ;","names":[]}

package/dist/feedback/feedback-attachment-labels.d.ts

@@ -0,0 +1,16 @@
+import type { FeedbackAttachmentFieldLabels } from "./feedback-attachment.js";
+/**
+ * English, in the feedback contract's wording since 0.27.0 (docs/feedback-harmonization.md
+ * §4.2: keksdose's `feedback.*` keys are the canon, and the kit owns them now). Three
+ * strings moved with it:
+ *
+ * - `attachmentAdd` "Attach image" → **"Add attachment"**: the field takes a PDF or a text
+ *   log as well wherever the app passes `FEEDBACK_ATTACHMENT_ACCEPT` (keksdose feedback
+ *   #87), and a button that says "image" over a picker that offers a PDF is wrong in one
+ *   of the two places.
+ * - `attachmentPaste` → keksdose's longer line, which says WHY one would paste — a region
+ *   snip shows one corner rather than the whole page (Steering Design feedback #39).
+ * - `attachmentLimit` for one: "remove **it**", as keksdose's `attachments_full_one`;
+ *   "remove one" of a single file read oddly.
+ */
+export declare const DEFAULT_FEEDBACK_ATTACHMENT_LABELS: FeedbackAttachmentFieldLabels;

package/dist/feedback/feedback-attachment-labels.js

@@ -0,0 +1,17 @@
+"use client";
+const DEFAULT_FEEDBACK_ATTACHMENT_LABELS = {
+  attachmentAdd: "Add attachment",
+  attachmentCapture: "Capture screenshot",
+  attachmentPaste: "\u2026or paste a screenshot straight from the clipboard, so you can show one corner rather than the whole page.",
+  attachmentRemove: "Remove attachment",
+  attachmentList: "Attachments",
+  attachmentScreenshot: "Screenshot",
+  attachmentRemoveFile: (name) => `Remove ${name}`,
+  attachmentLimit: (max) => max === 1 ? "Up to 1 attachment \u2014 remove it to add another." : `Up to ${max} attachments \u2014 remove one to add another.`,
+  attachmentUploading: "Uploading\u2026",
+  attachmentUploadFailed: (name) => `\u201C${name}\u201D could not be uploaded`
+};
+export {
+  DEFAULT_FEEDBACK_ATTACHMENT_LABELS
+};
+//# sourceMappingURL=feedback-attachment-labels.js.map

package/dist/feedback/feedback-attachment-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-attachment-labels.ts"],"sourcesContent":["// The English words of ./feedback-attachment, in a module with no component code: the\n// English catalogue (src/i18n/defaults.ts) imports them without the component, so `en`\n// loads as one chunk like the other languages (0.34, KS U8). ./feedback-attachment\n// re-exports them.\n\nimport type { FeedbackAttachmentFieldLabels } from \"./feedback-attachment\";\n\n/**\n * English, in the feedback contract's wording since 0.27.0 (docs/feedback-harmonization.md\n * §4.2: keksdose's `feedback.*` keys are the canon, and the kit owns them now). Three\n * strings moved with it:\n *\n * - `attachmentAdd` \"Attach image\" → **\"Add attachment\"**: the field takes a PDF or a text\n *   log as well wherever the app passes `FEEDBACK_ATTACHMENT_ACCEPT` (keksdose feedback\n *   #87), and a button that says \"image\" over a picker that offers a PDF is wrong in one\n *   of the two places.\n * - `attachmentPaste` → keksdose's longer line, which says WHY one would paste — a region\n *   snip shows one corner rather than the whole page (Steering Design feedback #39).\n * - `attachmentLimit` for one: \"remove **it**\", as keksdose's `attachments_full_one`;\n *   \"remove one\" of a single file read oddly.\n */\nexport const DEFAULT_FEEDBACK_ATTACHMENT_LABELS: FeedbackAttachmentFieldLabels = {\n  attachmentAdd: \"Add attachment\",\n  attachmentCapture: \"Capture screenshot\",\n  attachmentPaste: \"…or paste a screenshot straight from the clipboard, so you can show one corner rather than the whole page.\",\n  attachmentRemove: \"Remove attachment\",\n  attachmentList: \"Attachments\",\n  attachmentScreenshot: \"Screenshot\",\n  attachmentRemoveFile: (name) => `Remove ${name}`,\n  attachmentLimit: (max) =>\n    max === 1\n      ? \"Up to 1 attachment — remove it to add another.\"\n      : `Up to ${max} attachments — remove one to add another.`,\n  attachmentUploading: \"Uploading…\",\n  attachmentUploadFailed: (name) => `“${name}” could not be uploaded`,\n};\n"],"mappings":";AAqBO,MAAM,qCAAoE;AAAA,EAC/E,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,sBAAsB;AAAA,EACtB,sBAAsB,CAAC,SAAS,UAAU,IAAI;AAAA,EAC9C,iBAAiB,CAAC,QAChB,QAAQ,IACJ,wDACA,SAAS,GAAG;AAAA,EAClB,qBAAqB;AAAA,EACrB,wBAAwB,CAAC,SAAS,SAAI,IAAI;AAC5C;","names":[]}

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

@@ -1,100 +1,312 @@
-import 'react';
-export { D as DEFAULT_ATTACHMENT_ACCEPT, e as DEFAULT_FEEDBACK_ATTACHMENT_LABELS, p as DEFAULT_MAX_ATTACHMENTS, q as DEFAULT_MAX_ATTACHMENT_BYTES, A as FeedbackAttachmentError, B as FeedbackAttachmentErrorInfo, E as FeedbackAttachmentField, G as FeedbackAttachmentFieldLabels, H as FeedbackAttachmentFieldMultipleProps, I as FeedbackAttachmentFieldProps, J as FeedbackAttachmentFieldRefsProps, K as FeedbackAttachmentFieldSingleProps, M as FeedbackAttachmentRef, N as FeedbackAttachmentRefsError, be as pastedName } from '../delete-account-setting-DiPX4Vue.js';
-import '../components/write-lock.js';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.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/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 '../lib/person-name.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 '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.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/focus-ring.js';
+import { type ReactNode, type RefObject } from "react";
+import type { ButtonSize, ButtonVariant } from "../components/button-look.js";
+import { type CommitScope } from "../components/write-lock.js";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import type { FeedbackAttachmentLabels } from "./feedback-dialog.js";
+import { DEFAULT_FEEDBACK_ATTACHMENT_LABELS } from "./feedback-attachment-labels.js";
+import { DEFAULT_ATTACHMENT_ACCEPT, DEFAULT_MAX_ATTACHMENT_BYTES, DEFAULT_MAX_ATTACHMENTS } from "./feedback-record.js";
+export { DEFAULT_ATTACHMENT_ACCEPT, DEFAULT_MAX_ATTACHMENT_BYTES, DEFAULT_MAX_ATTACHMENTS };
+/**
+ * The field's own strings — the `feedbackAttachment` namespace of `<UiKitProvider
+ * labels>`. The keys are {@link FeedbackAttachmentLabels}' own, so the `labels` prop
+ * (and a whole `FeedbackDialogLabels` handed down by the dialog) merges over them
+ * one to one. The optional heading, `attachment`, stays a prop: a note editor puts
+ * the buttons straight under its textarea and wants none.
+ *
+ * Before 0.7.0 the two optional keys fell back to hard-coded English, so a German app
+ * that relied on its provider got "Capture screenshot" under a German form.
+ *
+ * The three keys added in 0.15.5 for `multiple` mode are optional, so a complete
+ * `UiKitLabels` typed before it still compiles; they fall back to English. So is
+ * `attachmentScreenshot` (0.16.0).
+ */
+export interface FeedbackAttachmentFieldLabels {
+    attachmentAdd: string;
+    attachmentCapture: string;
+    attachmentPaste: string;
+    attachmentRemove: string;
+    /** `multiple` mode: the accessible name of the list of chosen files — and, since
+     *  0.16.0, the heading `<FeedbackDialog attachments="multiple">` puts over it. */
+    attachmentList?: string;
+    /** `multiple` mode (0.16.0): what the screenshot slot's chip is called — "Screenshot"
+     *  rather than the capture's file name ("screenshot.webp"), which says nothing a
+     *  reporter chose. The file name stays as the chip's second line. */
+    attachmentScreenshot?: string;
+    /** `multiple` mode: one chip's remove button — "Remove photo.jpg". Named per file,
+     *  because five buttons all called "Remove attachment" say nothing about which. */
+    attachmentRemoveFile?: (name: string) => string;
+    /** `multiple` mode: the line shown in place of the add buttons once `max` is reached. */
+    attachmentLimit?: (max: number) => string;
+    /** `refs` mode (0.22.0, keksdose K16): the second line of a chip whose upload is still
+     *  running, where an uploaded one shows its size — "Uploading…". Optional, like the
+     *  keys above, so a `UiKitLabels` typed before it still compiles. */
+    attachmentUploading?: string;
+    /** `refs` mode (0.23.0, keksdose G5a): {@link FeedbackAttachmentErrorInfo.message} for
+     *  an `"upload"` refusal — "“huge.png” could not be uploaded". The other refusals'
+     *  sentences are the `filePicker` namespace's, shared with FileButton. Optional, like
+     *  the keys above. */
+    attachmentUploadFailed?: (name: string) => string;
+}
+export { DEFAULT_FEEDBACK_ATTACHMENT_LABELS };
+/** Why a file was turned away. `"count"` only ever comes from `multiple` (and `refs`)
+ *  mode: more files arrived at once than `max` left room for, and the surplus was
+ *  dropped. */
+export type FeedbackAttachmentError = "type" | "size" | "count";
+/** `refs` mode's reasons: {@link FeedbackAttachmentError}, or `"upload"` — `onUpload`
+ *  rejected, and what it rejected with is `onError`'s second argument. A type of its
+ *  own so a host's exhaustive switch over the File modes' reasons stays exhaustive. */
+export type FeedbackAttachmentRefsError = FeedbackAttachmentError | "upload";
+/**
+ * What `onError` knows about a refusal beyond its kind (0.23.0, keksdose G5a): the file
+ * it was about, the limit that refused it, and a sentence that says both.
+ *
+ * keksdose's support chat toasted "File too large" with no name — the field's `onError`
+ * carried a kind and nothing else, so a refusal could not say WHICH of three pasted
+ * screenshots went, nor what the ceiling was, and its own `AttachmentPicker` (a
+ * FileButton, whose `onReject` hands over `{ file, message }`) said more than the kit's
+ * field would have. This is that, for every mode.
+ *
+ * It arrives as an EXTRA argument, after the ones `onError` already had, so a handler
+ * written for 0.22 — `(kind) => …`, or `refs` mode's `(kind, error) => …` — compiles
+ * and behaves as before:
+ *
+ * - single and `multiple`: `onError(kind, info)`;
+ * - `refs`: `onError(kind, error, info)` — the second place is `onUpload`'s rejection
+ *   since 0.22 (`undefined` for the other kinds, as it always was), so the info comes
+ *   third rather than changing what a 0.22 handler reads there. It also carries that
+ *   `error`, so one helper `(kind, info) => …` serves all three modes.
+ *
+ * An object rather than more positional arguments because what a host reaches for
+ * differs by kind — the bytes for `"size"`, `max` for `"count"`, the server's answer for
+ * `"upload"` — and a field added later must not shift anyone's arguments.
+ */
+export interface FeedbackAttachmentErrorInfo {
+    /** The file refused — under the name the field would have given it (a pasted image
+     *  is already "pasted.png"). For `"count"`, the first of the surplus; for
+     *  `"upload"`, the file whose upload failed. */
+    file: File;
+    /** `"count"`: every file of the surplus (several can arrive in one pick). Otherwise
+     *  `[file]`. */
+    files: File[];
+    /**
+     * One translated sentence naming the file and the limit — the ones FileButton's
+     * `onReject` hands over, from the same `filePicker` namespace: "“huge.png” is larger
+     * than 10 MB", "Only image/png, image/jpeg files", "“c.png” was not added: at most 5
+     * files" (several at once: "3 files were not added"). `"upload"`: the field's own
+     * `attachmentUploadFailed`, "“huge.png” could not be uploaded" — a host with a better
+     * sentence from the server's answer uses `error`. Ready for a toast as it is.
+     */
+    message: string;
+    /** The field's `maxBytes` — the ceiling a `"size"` refusal went over, in bytes. */
+    maxBytes: number;
+    /** The field's `accept` — the types a `"type"` refusal was not among. */
+    accept: string[];
+    /** The field's `max` — the ceiling a `"count"` refusal hit. Absent in single mode,
+     *  which holds one file by definition. */
+    max?: number;
+    /** `"upload"` only: what `onUpload` rejected with — `onError`'s second argument. */
+    error?: unknown;
+}
+/**
+ * One uploaded attachment in `refs` mode: what the host's upload answered with. `key`
+ * identifies it (a storage key, an upload id) and is what a remove goes by; `name` is
+ * what the chip says. `size` (bytes) and `type` (mime) are optional — given, the chip
+ * shows the size and an image icon or a file icon accordingly.
+ */
+export interface FeedbackAttachmentRef {
+    key: string;
+    name: string;
+    size?: number;
+    type?: string;
+}
+interface FeedbackAttachmentFieldBaseProps {
+    /** Prop > `<UiKitProvider labels={{ feedbackAttachment }}>` > English. Optional
+     *  since 0.7.0; `attachment` (the heading) is only ever read from here. */
+    labels?: LabelOverride<FeedbackAttachmentLabels> & Pick<Partial<FeedbackAttachmentFieldLabels>, "attachmentUploading" | "attachmentUploadFailed">;
+    accept?: string[];
+    maxBytes?: number;
+    /**
+     * Take no files for now (0.23.0, keksdose G5b): the add and capture buttons, the
+     * hidden file input and every chip's remove button are natively disabled, and a paste
+     * is let through untouched. The chips stay as they are — what is about to be sent
+     * stays readable.
+     *
+     * For the moment a send is in flight. keksdose's support picker is `disabled` while
+     * the message goes out, because the message carries the attachments AS THEY WERE at
+     * the press: a chip removed mid-send has gone with it all the same, and one added
+     * mid-send looks as if it had. The field has no drop target; the paste is its drop.
+     *
+     * This is a pause, not a lock that explains itself — for that, `refs` mode (the mode
+     * that commits) takes `commit` and `disabledReason`.
+     */
+    disabled?: boolean;
+    /** Snapshot the app view behind this and return it as a File. A "Capture
+     *  screenshot" button appears only when it is given. */
+    onCaptureScreenshot?: () => Promise<File | null>;
+    /** Listen for the paste on `document` rather than on this field's own
+     *  subtree. For a modal, which owns the whole page while it is up. */
+    documentPaste?: boolean;
+    /** Listen for the paste within this element's subtree rather than this
+     *  field's own — for a field standing *beside* the text box a paste is made
+     *  in, whose common parent is where the event bubbles to. Ignored when
+     *  `documentPaste` is set. */
+    pasteFrom?: RefObject<HTMLElement | null>;
+    /**
+     * The add and capture buttons' look (0.24.0, keksdose) — Button's own `variant`.
+     * Default `"secondary"`, the look they always had.
+     *
+     * keksdose's support chat puts this field in ChatComposer's `attachmentSlot`, in the
+     * row with Send, where its own picker had been a `ghost` / `sm` FileButton: two
+     * bordered full-size buttons under a chat box read as a second form, and the field
+     * gave no way to say otherwise. Every mode, wherever the buttons appear; the chips'
+     * remove buttons keep their size.
+     */
+    buttonVariant?: ButtonVariant;
+    /** The add and capture buttons' size — Button's own `size`, with `buttonVariant`.
+     *  Default `"md"`. `"sm"` draws their icons at 14px, as a small button's are. */
+    buttonSize?: ButtonSize;
+    className?: string;
+}
+/** One file: choosing a second means removing the first. The field's only mode until 0.15.5. */
+export interface FeedbackAttachmentFieldSingleProps extends FeedbackAttachmentFieldBaseProps {
+    multiple?: false;
+    refs?: false;
+    value: File | null;
+    onChange: (file: File | null) => void;
+    /** A file was refused. `info` (0.23.0) names it and the limit — see
+     *  {@link FeedbackAttachmentErrorInfo}. */
+    onError?: (kind: "type" | "size", info: FeedbackAttachmentErrorInfo) => void;
+    max?: never;
+    screenshot?: never;
+    onScreenshotChange?: never;
+    commit?: never;
+    disabledReason?: never;
+}
+/**
+ * Several files (0.15.5, keksdose dev#578: "pasted two photos, the second overwrote
+ * the first"). Every way in ADDS — a pick of several files, a paste, a capture — up to
+ * `max`, and each file is a removable chip.
+ */
+export interface FeedbackAttachmentFieldMultipleProps extends FeedbackAttachmentFieldBaseProps {
+    multiple: true;
+    refs?: false;
+    value: File[];
+    onChange: (files: File[]) => void;
+    /** How many files `value` may hold. Default {@link DEFAULT_MAX_ATTACHMENTS} (5). The
+     *  add buttons and the paste hint are offered only while there is room. */
+    max?: number;
+    /** Per file: a rejected one is reported and the others are still added. `"count"` is
+     *  once per pick, with the whole surplus in `info.files`. `info` (0.23.0): see
+     *  {@link FeedbackAttachmentErrorInfo}. */
+    onError?: (kind: FeedbackAttachmentError, info: FeedbackAttachmentErrorInfo) => void;
+    /**
+     * A separate slot for THE screenshot, outside `value` and `max`. Given
+     * `onScreenshotChange`, what `onCaptureScreenshot` returns lands here instead of in
+     * `value`, shown as the first chip, and the capture button is offered only while the
+     * slot is empty — a second snapshot of the same view is not more evidence. This is
+     * how `<FeedbackDialog attachments="multiple">` keeps the screenshot apart from the
+     * photos; a form built from the parts can do the same.
+     */
+    screenshot?: File | null;
+    onScreenshotChange?: (file: File | null) => void;
+    commit?: never;
+    disabledReason?: never;
+}
+/**
+ * Uploaded on pick (0.22.0, keksdose K16). keksdose's support chat uploads each file
+ * the moment it is chosen and sends the message with the REFS the uploads answered —
+ * a 10 MB screenshot is refused while the reporter is still typing, not when they
+ * press Send — so its `AttachmentPicker` could not use this field, whose value is
+ * `File`s held until the form is submitted. Here the value is
+ * {@link FeedbackAttachmentRef}s: every way in (pick, paste, capture) validates the
+ * file as the other modes do, then hands it to `onUpload` and shows a chip with a
+ * spinner until it answers; the ref it resolves to joins `value` through `onChange`.
+ * A rejection drops the chip and reports `onError("upload", error)`. A chip is removed
+ * BY KEY: `onChange` gets the list without it, and `onRemove` the key, for a host that
+ * deletes the upload on the server too.
+ *
+ * Uploads still running count against `max`, so five picks in quick succession cannot
+ * overshoot it; they are not in `value` until they land, so a send that reads `value`
+ * sends only what has arrived — hold Send back while {@link onUploadingChange} says
+ * an upload is running. Several files upload side by side and join in the order they
+ * finish. The File modes are unchanged.
+ */
+export interface FeedbackAttachmentFieldRefsProps extends FeedbackAttachmentFieldBaseProps {
+    refs: true;
+    multiple?: never;
+    value: FeedbackAttachmentRef[];
+    onChange: (refs: FeedbackAttachmentRef[]) => void;
+    /** Upload one file; resolve to its ref, or reject to refuse it. Called once per
+     *  accepted file, the moment it is chosen. */
+    onUpload: (file: File) => Promise<FeedbackAttachmentRef>;
+    /** A chip was removed — after `onChange` — with its ref's key. */
+    onRemove?: (key: string) => void;
+    /** Whether any upload is running: `true` when the first starts, `false` when the
+     *  last settles — for the host's Send, which should wait. */
+    onUploadingChange?: (uploading: boolean) => void;
+    /** How many refs `value` may hold, uploads in flight included. Default
+     *  {@link DEFAULT_MAX_ATTACHMENTS} (5). */
+    max?: number;
+    /** Per file. `"upload"` carries what `onUpload` rejected with as `error` (`undefined`
+     *  for the other kinds). `info` (0.23.0) comes third so a 0.22 handler's `error` is
+     *  still the second argument — see {@link FeedbackAttachmentErrorInfo}. */
+    onError?: (kind: FeedbackAttachmentRefsError, error: unknown, info: FeedbackAttachmentErrorInfo) => void;
+    /**
+     * This field COMMITS (0.23.0): each file is uploaded the moment it is chosen, and a
+     * remove may delete the upload (`onRemove`) — a save, unlike the File modes, which
+     * only stage a file for a form sent later (and so stay open under a lock, like every
+     * field). Under a locked {@link WriteLockProvider} it takes the `disabledReason` path
+     * with the lock's reason, which wins over one of its own. No provider, or an unlocked
+     * one: no effect.
+     */
+    commit?: CommitScope;
+    /**
+     * Why no file can be added or removed — the write lock's sentence, a quota, a thread
+     * closed to replies. Unlike `disabled`, it SAYS so, the kit's commit-control way: the
+     * buttons (add, capture, every chip's remove) stay focusable, `aria-disabled`, with
+     * the reason in the kit Tooltip and their description; no pick, paste or remove gets
+     * through; and the reason stands where the paste hint was, for a phone that never
+     * hovers. The chips stay readable.
+     */
+    disabledReason?: ReactNode;
+    screenshot?: never;
+    onScreenshotChange?: never;
+}
+export type FeedbackAttachmentFieldProps = FeedbackAttachmentFieldSingleProps | FeedbackAttachmentFieldMultipleProps | FeedbackAttachmentFieldRefsProps;
+/**
+ * Picking one picture: the file dialog, a capture of the app view, or a paste.
+ * With `multiple`, picking several (see {@link FeedbackAttachmentFieldMultipleProps}).
+ *
+ * Lifted out of {@link FeedbackDialog} so the *reply* half of the feature can
+ * have it too (Steering Design feedback #128). A report is a conversation — it
+ * is filed, it is answered, and the reporter sends it back saying that is not
+ * what they meant — and the screenshot showing what they mean is taken at
+ * whichever of those points they looked. Only the first of them had a way to
+ * attach one, so everything after it had to be described in words.
+ *
+ * **Three ways in, and they are three because no one of them covers the others.**
+ * The file dialog needs a file on disk; `onCaptureScreenshot` snapshots the
+ * *whole* app view; and the clipboard is where a region snip already is on every
+ * platform (Steering Design feedback #39). Somebody who wanted to show one panel
+ * had to save a crop and then find it again.
+ *
+ * `documentPaste` and `pasteFrom` decide where the paste is listened for, and
+ * it is a real choice rather than a flag with a default. A modal traps focus,
+ * so while it is up every paste in the page is meant for it — including one
+ * made with nothing in particular focused, which never reaches a React
+ * `onPaste` on a child: that is `documentPaste`. An editor **inline on a
+ * page** is not that: the page around it has its own fields, so it listens
+ * within its own subtree and a paste elsewhere stays where it was aimed. But
+ * "its own subtree" has to include the text box the paste is actually made in,
+ * and that box is this field's *sibling*, not its child — a paste in it bubbles
+ * to their common parent and never through here. `pasteFrom` is that parent
+ * (Steering Design feedback #140): the element whose subtree is listened to,
+ * handed in by whoever renders both the box and this field side by side.
+ */
+export declare function FeedbackAttachmentField(props: FeedbackAttachmentFieldProps): import("react").JSX.Element;
+/** What a pasted image is called once it is an attachment.
+ *
+ *  The extension is read off the mime type rather than assumed to be `.png`:
+ *  Safari puts TIFF on the clipboard and a file called `pasted.png` that is not
+ *  a PNG is one the receiving end opens wrong. */
+export declare function pastedName(type: string): string;