@eifi1/ui-kit 0.34.0 → 0.35.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/feedback-thread.tsx"],"sourcesContent":["import { useEffect, useId, useImperativeHandle, useLayoutEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ReactNode, Ref, RefObject } from \"react\";\nimport { ImageIcon, ImageOff, Paperclip, Send } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { formatDate, formatRelativeTime } from \"../lib/format\";\nimport { hasContent } from \"../lib/presence\";\nimport { Button } from \"../components/button\";\nimport { EmptyState } from \"../components/empty-state\";\nimport { Spinner } from \"../components/spinner\";\nimport { Textarea } from \"../components/textarea\";\nimport type { CharacterCountLabels } from \"../components/field-base\";\nimport { Skeleton } from \"../components/skeleton\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { useWriteLock } from \"../components/write-lock\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useKitFileLabels, useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { FeedbackAttachmentField } from \"./feedback-attachment\";\nimport type { FeedbackAttachmentFieldSingleProps } from \"./feedback-attachment\";\nimport type { FeedbackNoteAttachment } from \"./feedback-inbox\";\nimport type { FeedbackAttachmentLabels } from \"./feedback-dialog\";\nimport {\n  DEFAULT_FEEDBACK_COMPOSER_LABELS,\n  DEFAULT_FEEDBACK_THREAD_LABELS,\n} from \"./feedback-thread-labels\";\n\n/**\n * The conversation under a report: who said what, when, with what attached — and the\n * box to answer in.\n *\n * Both apps had written it by hand. kastlan's feedback page grew a comment list of\n * bordered boxes with `slate-*` literals (feedback-page.tsx, \"keksdose left this\n * unbuilt\"), and keksdose built the same thing a second time for support\n * (support-thread.tsx) with sides, bubbles and a composer that clears only what it\n * sent. This is that second one, generalised: the kit owns the look and the\n * behaviour, the app owns the data, the upload and every word it does not share.\n *\n * **Own vs other** is the caller's per message (`own`), not a comparison the kit makes\n * against a user id: whose message sits at the END side depends on who is reading,\n * and only the app knows that (keksdose's support thread labelled a member's question\n * \"Du\" in the admin panel the first time round, by reading the wrong field).\n *\n * **Redaction.** A thread is somebody's words about their own data — exactly what a\n * host's demo / screen-share mode blurs. Bodies, authors and attachments carry\n * `data-private` (the attribute `Tooltip redact` and `StatTile sensitive` use) unless\n * `redact={false}`.\n *\n * **RTL.** Sides are logical — `justify-end` is the reading end, and the bubble's\n * tucked corner is `rounded-ee` / `rounded-es` — and each body is `dir=\"auto\"`, so a\n * Hebrew reply in an English thread (or the reverse) lays out as its own language.\n *\n * **A chat, too** (keksdose G4/G5). keksdose's support chat is the same conversation\n * read the chat way: status lines between the messages (\"Closed automatically\",\n * \"Reopened\"), a day line where the date changes, clock times under it, Enter to send\n * and several files uploaded ahead of the send. Each of those is an opt-in here\n * (`kind: \"event\"`, `daySeparators`, `timeFormat=\"clock\"`, `sendOn=\"enter\"`,\n * `attachmentSlot` + `canSend`), so the feedback thread's defaults stay as they were.\n */\n\n/* ── Labels ───────────────────────────────────────────────────────────────── */\n\n/** The `feedbackThread` namespace of `<UiKitProvider labels>`. */\nexport interface FeedbackThreadLabels {\n  /** Accessible name of the message list. */\n  thread: string;\n  empty: string;\n  loading: string;\n  /** Author line of an `own` message that has no `author` of its own. */\n  you: string;\n  /** The badge beside a `staff` author. */\n  staff: string;\n  /** Accessible name of a message's attachment list. */\n  attachments: string;\n}\n\n// Defined in ./feedback-thread-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_THREAD_LABELS };\n\n/** The `feedbackComposer` namespace of `<UiKitProvider labels>`. The attach buttons'\n *  words are `feedbackAttachment`'s, shared with the dialog and the note editor. */\nexport interface FeedbackComposerLabels {\n  /** Accessible name of the text box. */\n  field: string;\n  placeholder: string;\n  send: string;\n  /** The shortcut line, given the platform's modifier (\"Ctrl\" or \"⌘\"). */\n  sendHint: (modifier: string) => string;\n  /** The shortcut line under `sendOn=\"enter\"` (keksdose G5): Enter sends, so say how a\n   *  new line is made. */\n  sendHintEnter: string;\n}\n\n// Defined in ./feedback-thread-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_COMPOSER_LABELS };\n\n/* ── Thread ───────────────────────────────────────────────────────────────── */\n\nexport interface FeedbackThreadAttachment {\n  id?: string | number;\n  name: string;\n  /** Where to open it. Left out, the attachment is listed by name only. */\n  url?: string;\n  /** MIME type; an `image/*` with a `url` is shown as a thumbnail. */\n  type?: string;\n  /** Bytes, shown beside a non-image. */\n  size?: number;\n}\n\nexport interface FeedbackThreadMessage {\n  /** Leave out, or `\"message\"`. `\"event\"` is a {@link FeedbackThreadEvent}. */\n  kind?: \"message\";\n  id: string | number;\n  /** Who wrote it. Left out on an `own` message, it reads \"You\". */\n  author?: ReactNode;\n  /** A `Date`, an ISO string or epoch ms. */\n  createdAt: Date | string | number;\n  body: string;\n  attachments?: readonly FeedbackThreadAttachment[];\n  /** Written by whoever is reading: sits at the end side, in the brand tint. */\n  own?: boolean;\n  /** Written by the team rather than a user: gets the \"Staff\" badge. */\n  staff?: boolean;\n}\n\n/**\n * A line in the thread that nobody wrote — \"Closed automatically\", \"Marked as\n * resolved\", \"Reopened\" — drawn centred and muted with its time, no author, no side,\n * no bubble.\n *\n * keksdose G4: its support chat interleaves these with the messages, and as a message\n * they came out as a bubble from nobody at the start side, which reads as the member\n * having said \"resolved\". Word it for the READER, as with `own`: the app knows whether\n * \"you reopened it\" or \"Anna reopened it\" is true for the person looking.\n *\n * The text is the app's, not somebody's words about their data, so it is NOT tagged\n * `data-private`; one that names a person can wrap the name in its own\n * `<span data-private>` (`body` is a node for that reason).\n */\nexport interface FeedbackThreadEvent {\n  kind: \"event\";\n  id: string | number;\n  /** A `Date`, an ISO string or epoch ms. */\n  createdAt: Date | string | number;\n  body: ReactNode;\n}\n\n/** One row of a {@link FeedbackThread}: a message, or an event line between them. */\nexport type FeedbackThreadItem = FeedbackThreadMessage | FeedbackThreadEvent;\n\nexport interface FeedbackThreadProps {\n  /** Oldest first. Event lines ({@link FeedbackThreadEvent}) sit among the messages. */\n  messages: readonly FeedbackThreadItem[];\n  loading?: boolean;\n  /** Replaces the default \"No comments yet\". */\n  empty?: ReactNode;\n  /**\n   * Draw one attachment yourself — for files behind auth, which a plain `<img src>`\n   * cannot fetch (kastlan's `AuthedImage`), or a lightbox. The default is a thumbnail\n   * link for an image with a `url`, a file link otherwise.\n   */\n  renderAttachment?: (attachment: FeedbackThreadAttachment, message: FeedbackThreadMessage) => ReactNode;\n  /** Tag bodies, authors and attachments `data-private`. Default true. */\n  redact?: boolean;\n  /**\n   * How a row's time reads. `\"relative\"` (default): \"5 minutes ago\", a date past six\n   * days — right for a report's comments, read days apart. `\"clock\"`: the time of day\n   * in the locale (\"14:05\", \"2:05 PM\") — the chat look, keksdose G4; pair it with\n   * `daySeparators`, which say which day that clock time is on. Either way the full\n   * date and time is in the Tooltip.\n   */\n  timeFormat?: \"relative\" | \"clock\";\n  /**\n   * A centred day line before the first row and wherever the next row is on another\n   * calendar day (the device's zone): \"Today\", \"Yesterday\", else the date — keksdose\n   * G4. \"Today\" / \"Yesterday\" are `Intl.RelativeTimeFormat`'s own words in the kit\n   * locale, so there is no label to translate. Default false.\n   */\n  daySeparators?: boolean;\n  /** \"Now\" for the relative times and the day lines — pin it in tests and stories.\n   *  Default: the clock. */\n  now?: Date | number;\n  /** Overrides the provider's locale for the times. */\n  locale?: string;\n  labels?: LabelOverride<FeedbackThreadLabels>;\n  className?: string;\n}\n\nexport function FeedbackThread({\n  messages,\n  loading = false,\n  empty,\n  renderAttachment,\n  redact = true,\n  now,\n  locale: localeProp,\n  timeFormat = \"relative\",\n  daySeparators = false,\n  labels: labelsProp,\n  className,\n}: FeedbackThreadProps) {\n  const labels = useKitLabels(\"feedbackThread\", DEFAULT_FEEDBACK_THREAD_LABELS, labelsProp);\n  const locale = useKitLocale(localeProp);\n  const file = useKitFileLabels();\n  const priv = redact ? \"\" : undefined;\n  const clock = useMinuteClock(now === undefined);\n  const reference = now === undefined ? clock : +now;\n\n  if (loading && messages.length === 0) {\n    return <Skeleton lines={3} label={labels.loading} className={className} />;\n  }\n  if (messages.length === 0) {\n    return (\n      <EmptyState\n        variant=\"inline\"\n        size=\"sm\"\n        title={empty ?? labels.empty}\n        className={cn(\"justify-start\", className)}\n      />\n    );\n  }\n\n  // Per row, the calendar day of the last readable date up to it — what a day line\n  // compares against.\n  const days: (number | null)[] = [];\n  for (const message of messages) {\n    const date = toDate(message.createdAt);\n    days.push(date ? dayNumber(date) : (days.at(-1) ?? null));\n  }\n\n  return (\n    <ol aria-label={labels.thread} aria-busy={loading || undefined} className={cn(\"space-y-3\", className)}>\n      {messages.flatMap((message, index) => {\n        const date = toDate(message.createdAt);\n        const time = date && (\n          // The kit's Tooltip, not a native title: one tooltip look app-wide\n          // (keksdose F0 / dev#523).\n          <Tooltip label={new Intl.DateTimeFormat(locale, { dateStyle: \"full\", timeStyle: \"short\" }).format(date)}>\n            <time dateTime={date.toISOString()} className=\"tabular-nums\">\n              {timeFormat === \"clock\"\n                ? formatDate(date, \"time\", { locale })\n                : formatRelativeTime(date, {\n                    now: reference,\n                    locale,\n                    // Past the kit's day steps it is a date: \"2 weeks ago\" makes\n                    // the reader do arithmetic the date already did.\n                    absoluteAfterDays: 6.5,\n                  })}\n            </time>\n          </Tooltip>\n        );\n        const rows: ReactNode[] = [];\n        const day = date && dayNumber(date);\n        // Against the last row WITH a readable date: an unparseable one neither starts\n        // a day nor hides the next change.\n        if (daySeparators && date && day !== days[index - 1]) {\n          rows.push(<DaySeparator key={`day-${message.id}`} date={date} now={reference} locale={locale} />);\n        }\n        if (message.kind === \"event\") {\n          // A list item like the rest, so \"Reopened\" is read in its place, but not an\n          // article: an article is somebody's post, and this has no author.\n          rows.push(\n            <li\n              key={message.id}\n              data-event=\"\"\n              className=\"flex flex-wrap items-baseline justify-center gap-x-2 px-4 text-center text-xs text-muted\"\n            >\n              <span>{message.body}</span>\n              {time && <span className=\"text-caption\">{time}</span>}\n            </li>,\n          );\n          return rows;\n        }\n        const author = message.author ?? (message.own ? labels.you : null);\n        const attachments = message.attachments ?? [];\n        rows.push(\n          <li\n            key={message.id}\n            className={cn(\"flex\", message.own ? \"justify-end\" : \"justify-start\")}\n            data-own={message.own ? \"\" : undefined}\n          >\n            <article\n              className={cn(\n                \"max-w-[85%] min-w-0 rounded-lg px-3 py-2 text-sm\",\n                message.own\n                  ? \"rounded-ee-sm bg-brand-soft\"\n                  : \"rounded-es-sm bg-surface-2\",\n              )}\n            >\n              <header className=\"mb-0.5 flex flex-wrap items-center gap-x-2 gap-y-0.5 text-caption text-muted\">\n                {author != null && (\n                  <span data-private={priv} className=\"font-medium text-secondary\">\n                    {author}\n                  </span>\n                )}\n                {message.staff && (\n                  <span className=\"rounded border border-subtle bg-surface px-1 text-micro font-medium uppercase tracking-wide text-secondary\">\n                    {labels.staff}\n                  </span>\n                )}\n                {time}\n              </header>\n              {message.body && (\n                <p\n                  data-private={priv}\n                  dir=\"auto\"\n                  className=\"whitespace-pre-wrap break-words text-start text-primary\"\n                >\n                  {message.body}\n                </p>\n              )}\n              {attachments.length > 0 && (\n                <ul aria-label={labels.attachments} data-private={priv} className=\"mt-2 flex flex-wrap gap-2\">\n                  {attachments.map((attachment, index) => (\n                    <li key={attachment.id ?? `${index}-${attachment.name}`} className=\"min-w-0\">\n                      {renderAttachment ? (\n                        renderAttachment(attachment, message)\n                      ) : (\n                        <DefaultAttachment attachment={attachment} size={file.size} />\n                      )}\n                    </li>\n                  ))}\n                </ul>\n              )}\n            </article>\n          </li>,\n        );\n        return rows;\n      })}\n    </ol>\n  );\n}\n\nfunction DefaultAttachment({\n  attachment,\n  size,\n}: {\n  attachment: FeedbackThreadAttachment;\n  size: (bytes: number) => string;\n}) {\n  const { name, url, type } = attachment;\n  if (url && type?.startsWith(\"image/\")) return <ImageThumbnail url={url} name={name} />;\n  const content = (\n    <>\n      <Paperclip className=\"size-3.5 shrink-0\" aria-hidden />\n      {/* A file name wraps from Large up, as the attachments of the composer do (text\n          size §10.17; round 0.34 T1: the sweep read \"export-20…\"). */}\n      <span className=\"min-w-0 truncate-until-large\">{name}</span>\n      {attachment.size !== undefined && (\n        <span className=\"shrink-0 text-muted\">{size(attachment.size)}</span>\n      )}\n    </>\n  );\n  const chip =\n    \"inline-flex max-w-full items-center gap-1 rounded border border-subtle bg-surface px-2 py-1 text-xs text-secondary\";\n  return url ? (\n    <a href={url} target=\"_blank\" rel=\"noopener noreferrer\" className={cn(chip, \"hover:bg-hover\")}>\n      {content}\n    </a>\n  ) : (\n    <span className={chip}>{content}</span>\n  );\n}\n\n/** An image attachment's thumbnail. The box is drawn before the picture arrives —\n *  `loading=\"lazy\"` leaves it empty until it nears the viewport, and a URL that has\n *  expired never fills it — and an empty bordered square read as a broken layout, not\n *  as a picture. So the box carries an image glyph underneath until the picture\n *  covers it, and swaps it for a broken-image glyph when the load fails. */\nfunction ImageThumbnail({ url, name }: { url: string; name: string }) {\n  // Keyed on the URL, so a message whose attachment is replaced tries the new one.\n  const [failedUrl, setFailedUrl] = useState<string | null>(null);\n  const failed = failedUrl === url;\n  const Glyph = failed ? ImageOff : ImageIcon;\n  return (\n    <a\n      href={url}\n      target=\"_blank\"\n      rel=\"noopener noreferrer\"\n      className=\"relative block h-20 w-20 overflow-hidden rounded border border-subtle bg-surface-2\"\n    >\n      <Glyph aria-hidden className=\"absolute inset-0 m-auto size-6 text-muted\" />\n      {!failed && (\n        // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- load/error are resource events, not interactions\n        <img\n          src={url}\n          alt={name}\n          loading=\"lazy\"\n          onError={() => setFailedUrl(url)}\n          className=\"relative h-full w-full object-cover\"\n        />\n      )}\n      {/* The <img> and its alt are gone once it failed; the link still needs a name. */}\n      {failed && <span className=\"sr-only\">{name}</span>}\n    </a>\n  );\n}\n\n/** The time, refreshed once a minute while `active`, so \"2 minutes ago\" does not stay\n *  \"just now\" on a page left open. Read in state rather than in render, which must be\n *  pure. */\nfunction useMinuteClock(active: boolean): number {\n  const [time, setTime] = useState(() => Date.now());\n  useEffect(() => {\n    if (!active) return;\n    const id = setInterval(() => setTime(Date.now()), 60_000);\n    return () => clearInterval(id);\n  }, [active]);\n  return time;\n}\n\n/** The local calendar day as one number (20260926), for \"same day?\" and keys. */\nfunction dayNumber(date: Date): number {\n  return date.getFullYear() * 10_000 + (date.getMonth() + 1) * 100 + date.getDate();\n}\n\n/**\n * The day line of `daySeparators` (keksdose G4): \"Today\" / \"Yesterday\" from\n * `Intl.RelativeTimeFormat` (`numeric: \"auto\"`) — the locale's own words, capitalised\n * for a line that stands alone (\"heute\" → \"Heute\"; a script without case is left as\n * is) — else the weekday and date, with the year only when it is not this one.\n *\n * Counted in calendar days, not 24-hour spans: 23:50 yesterday is \"Yesterday\" at\n * 00:10 today.\n */\nfunction DaySeparator({ date, now, locale }: { date: Date; now: number; locale: string | undefined }) {\n  const today = new Date(now);\n  const days = Math.round(\n    (Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()) -\n      Date.UTC(today.getFullYear(), today.getMonth(), today.getDate())) /\n      86_400_000,\n  );\n  let label: string;\n  if (days === 0 || days === -1) {\n    const word = new Intl.RelativeTimeFormat(locale, { numeric: \"auto\" }).format(days + 0, \"day\");\n    label = word.charAt(0).toLocaleUpperCase(locale) + word.slice(1);\n  } else {\n    label = formatDate(\n      date,\n      {\n        weekday: \"long\",\n        day: \"numeric\",\n        month: \"long\",\n        ...(date.getFullYear() === today.getFullYear() ? null : { year: \"numeric\" }),\n      },\n      { locale },\n    );\n  }\n  const y = String(date.getFullYear()).padStart(4, \"0\");\n  const m = String(date.getMonth() + 1).padStart(2, \"0\");\n  const d = String(date.getDate()).padStart(2, \"0\");\n  return (\n    <li data-day-separator=\"\" className=\"flex items-center gap-3 py-1 text-xs text-muted\">\n      <span aria-hidden className=\"h-px flex-1 bg-[var(--border)]\" />\n      <time dateTime={`${y}-${m}-${d}`} className=\"font-medium\">\n        {label}\n      </time>\n      <span aria-hidden className=\"h-px flex-1 bg-[var(--border)]\" />\n    </li>\n  );\n}\n\nfunction toDate(value: Date | string | number): Date | null {\n  const date = value instanceof Date ? value : new Date(value);\n  return Number.isNaN(date.getTime()) ? null : date;\n}\n\n/* ── Composer ─────────────────────────────────────────────────────────────── */\n\n/** What the composer's attach control takes — {@link FeedbackNoteAttachment} with the\n *  labels optional, since the field reads `feedbackAttachment` from the provider, and\n *  `onError` the field's own (0.23.0): it is handed the refused file and the limit too\n *  (`FeedbackAttachmentErrorInfo`), and a `(kind) => …` handler still fits. Since\n *  0.24.0 also the field's `buttonVariant` / `buttonSize`, for a composer whose row\n *  wants smaller or quieter attach buttons than the bordered `md` default. */\nexport type FeedbackComposerAttachment = Omit<FeedbackNoteAttachment, \"labels\" | \"onError\"> & {\n  labels?: LabelOverride<FeedbackAttachmentLabels>;\n  onError?: FeedbackAttachmentFieldSingleProps[\"onError\"];\n} & Pick<FeedbackAttachmentFieldSingleProps, \"buttonVariant\" | \"buttonSize\">;\n\n/**\n * What a render-prop {@link FeedbackComposerProps.attachmentSlot} is handed (0.24.0,\n * keksdose).\n *\n * keksdose's support chat put `<FeedbackAttachmentField refs>` in the slot and a\n * screenshot pasted into the reply box never reached it: the box is the field's\n * sibling, so the paste bubbles to their common parent — the composer's root — and the\n * field hears it only through `pasteFrom`, which needs that root. The composer kept it\n * to itself, so keksdose wrapped the whole composer in a ref'd `<div>` of its own just\n * to have an element to hand over.\n */\nexport interface FeedbackComposerSlotContext {\n  /**\n   * The composer's root, round the text box and this slot — the field's `pasteFrom`,\n   * as it is: `pasteFrom={slot.root}`.\n   *\n   * A ref, not the element, because `pasteFrom` is one: the field reads `.current` in\n   * an effect, and the slot renders INSIDE this root, so the two are committed together\n   * and React attaches the root before any effect of the slot's runs — the first paste\n   * after the first paint already lands. The element itself would be `null` on the\n   * first render (it does not exist yet) and could only arrive by a second render\n   * through state; the ref is the same object every render, so the field's listener is\n   * added once and never re-added.\n   *\n   * With the built-in `attachment` on as well, it listens on this root too: hand the\n   * root to one field only, or an image pasted once is attached twice.\n   */\n  root: RefObject<HTMLElement | null>;\n  /** The composer's `pending` — a send is in flight. For the field's `disabled`\n   *  (keksdose G5b): the message carries the attachments as they were at the press. */\n  pending: boolean;\n}\n\nexport interface FeedbackComposerProps {\n  /**\n   * Send the comment. Return the promise: the box clears when it RESOLVES, and only of\n   * what was sent — text typed while it was in flight stays. A rejection keeps\n   * everything for a retry (surface the error yourself; the composer stays quiet).\n   *\n   * `attachment` is the built-in field's one picture. Files the host uploaded ahead\n   * (`attachmentSlot`) are the host's state, read by the host here — and `body` may be\n   * `\"\"` when `canSend` let an attachments-only message go.\n   */\n  onSend: (body: string, attachment: File | null) => void | Promise<unknown>;\n  /** The send is in flight: a spinner on the button and no second send. */\n  pending?: boolean;\n  /** Offer one picture with the comment (file, paste or `onCaptureScreenshot`).\n   *  `true` for the defaults. Left out, the composer is text only. */\n  attachment?: boolean | FeedbackComposerAttachment;\n  /**\n   * The host's own attach control, in the row with Send where the built-in field sits\n   * (after it, if both are on) — keksdose G5: its support chat uploads up to N files\n   * AHEAD of the send and sends their refs, which one `File` in `onSend` cannot carry.\n   * The slot is the host's picker plus the chips of what is uploaded; the upload, the\n   * refs and clearing them once `onSend` resolves stay with the host. Pair it with\n   * `canSend`.\n   *\n   * A node, or (0.24.0) a function of {@link FeedbackComposerSlotContext} that returns\n   * one — for a field that wants the composer's root as its `pasteFrom`, so a\n   * screenshot pasted into the box reaches it, and `pending` for its `disabled`:\n   *\n   * ```tsx\n   * attachmentSlot={({ root, pending }) => (\n   *   <FeedbackAttachmentField refs pasteFrom={root} disabled={pending} … />\n   * )}\n   * ```\n   *\n   * Called once per render of the composer, and not at all while `disabledReason`\n   * stands in for it.\n   */\n  attachmentSlot?: ReactNode | ((slot: FeedbackComposerSlotContext) => ReactNode);\n  /**\n   * Whether Send is enabled, over the composer's own rule (some text in the box) —\n   * for state the composer cannot see, i.e. `attachmentSlot`'s (keksdose G5): `true`\n   * with files ready makes an empty draft sendable (`onSend(\"\", null)`), `false` while\n   * an upload is still running holds even a written reply back. Left out, the text\n   * decides. `pending` blocks a send either way, as does a draft past `maxLength`.\n   */\n  canSend?: boolean;\n  /**\n   * Which key sends. `\"mod-enter\"` (default): Ctrl/⌘+Enter, the report dialog's and\n   * note editor's shortcut, with plain Enter a new line — feedback is written in\n   * paragraphs. `\"enter\"`: the chat way (keksdose G5) — Enter sends, Shift+Enter is a\n   * new line, Ctrl/⌘+Enter still sends; an Enter that confirms an IME composition\n   * (Japanese, Chinese input) is the IME's, never a send.\n   */\n  sendOn?: \"mod-enter\" | \"enter\";\n  /** Rendered INSTEAD of the composer — the thread is closed, or read-only for this\n   *  reader. */\n  disabledReason?: ReactNode;\n  /**\n   * Send COMMITS (0.33.1, kastlan's assistant): under a locked {@link WriteLockProvider}\n   * Send is disabled the `disabledReason` way — focusable, the lock's reason in its\n   * tooltip and description, as on {@link Button}'s `commit` — and neither Enter nor\n   * Ctrl/⌘+Enter sends. The box stays editable and the draft stays: nothing in it\n   * reaches the server until Send, and the lock may lift. No provider, or an unlocked\n   * one: no effect. A {@link CommitScope}: kastlan's assistant answers under the demo\n   * and not under a lapsed plan (its backend's 402), so it passes\n   * `commit={{ except: [\"demo\"] }}` where it read `useWriteLock` and fed `canSend` and a\n   * reason by hand. Not the prop above: that one replaces the box, this one keeps it.\n   */\n  commit?: CommitScope;\n  rows?: number;\n  /**\n   * The longest draft the box takes, in UTF-16 code units as the browser counts — the\n   * server's limit, so a reply too long for it is cut off while it is typed rather than\n   * refused by a 422 after the press (keksdose G6: its support replies are capped at\n   * 4,000 on the server, and its other text fields already count against that with\n   * Textarea's `maxLength` + `showCount` since 0.22; the reply box, a composer, could\n   * not). The box's own `maxLength`, so typing and pasting stop at it.\n   *\n   * {@link FeedbackComposerHandle.insertText} is not stopped by it — the browser limits\n   * typing, not a script — and a canned reply is not cut mid-sentence to fit. A draft\n   * past the limit therefore holds Send back (whatever `canSend` says, as `pending`\n   * does) until it is trimmed; with `showCount` the counter, red at the limit, says by\n   * how much.\n   */\n  maxLength?: number;\n  /**\n   * A live \"12/4000\" under the box, with `maxLength` — Textarea's `showCount`, the same\n   * counter (keksdose G6): the count is part of the box's description, read with it on\n   * focus, and a polite live region speaks only on entering the last stretch and at the\n   * limit, never per keystroke. Under `size=\"sm\"` the hidden send hint stays the box's\n   * description too, before the count. Ignored without `maxLength`.\n   */\n  showCount?: boolean;\n  /** The counter's words — the `characterCount` namespace, as on Textarea. */\n  countLabels?: Partial<CharacterCountLabels>;\n  /**\n   * The box's hint, over the `placeholder` label — keksdose F9: an admin answering a\n   * support ticket is asked something else (\"Reply to Anna…\") than a member adding to\n   * their own report, and one provider-wide label cannot say both.\n   */\n  placeholder?: string;\n  /**\n   * The draft, controlled — for a host that keeps it itself (saves it per ticket,\n   * prefills a template). Left out, the composer keeps its own. Either way a send\n   * that resolves clears only what was sent: controlled, that is an\n   * `onValueChange(\"\")` the host receives like any keystroke, and only if the draft\n   * is still the one that went out.\n   */\n  value?: string;\n  /** Every change to the draft — typing, {@link FeedbackComposerHandle.insertText}, the\n   *  clear after a send. Required to change a controlled `value`. */\n  onValueChange?: (value: string) => void;\n  /** {@link FeedbackComposerHandle}: put text into the draft from outside (canned-reply\n   *  chips) or focus the box. */\n  ref?: Ref<FeedbackComposerHandle>;\n  labels?: LabelOverride<FeedbackComposerLabels>;\n  className?: string;\n  /**\n   * `\"sm\"` for a narrow host — keksdose's assistant launcher, a small floating panel\n   * (0.22): a small Send button, and the send hint (\"Enter to send, Shift + Enter for a\n   * new line\") hidden from view but kept as the box's description, so a keyboard or\n   * screen-reader user still learns the shortcut. Default `\"md\"`.\n   */\n  size?: \"md\" | \"sm\";\n  /**\n   * On the composer's root — the box, or the `disabledReason` line in its place —\n   * with any `data-*` attribute beside it (keksdose K17). keksdose's assistant tour\n   * points at the chat box with `[data-tour=\"assistant-ask\"]`, and a composer that\n   * dropped every attribute it was not told about left the anchor nowhere: the\n   * assistant kept its hand-built box rather than lose the tour step.\n   */\n  id?: string;\n  /** `data-*` attributes for the root, as `id` — a tour anchor, a test id. */\n  [dataAttribute: `data-${string}`]: string | number | boolean | undefined;\n}\n\n/**\n * What a {@link FeedbackComposer} `ref` holds.\n *\n * keksdose F9: the support admin answers the same five questions all day and wants\n * chips above the box (\"Thanks, fixed in the next release\") that drop their text in\n * where the caret is. A controlled `value` alone cannot do that well — the host sees\n * the string, not the caret, so it could only append — so the composer, which owns\n * the textarea, does the splice.\n */\nexport interface FeedbackComposerHandle {\n  /**\n   * Insert `text` at the caret, replacing any selection (the caret the box last had:\n   * a click on a chip blurs it, and the selection survives the blur), then focus the\n   * box with the caret after the inserted text so the reply can go on. Nothing is\n   * added around it — put a space or a newline in `text` if the reply needs one. A\n   * no-op while `disabledReason` replaces the box.\n   */\n  insertText: (text: string) => void;\n  focus: () => void;\n}\n\nconst noSubscribe = () => () => {};\nconst isApple = () =>\n  typeof navigator !== \"undefined\" && /Mac|iPhone|iPad|iPod/i.test(navigator.platform || navigator.userAgent);\n\n/**\n * The answer box under a {@link FeedbackThread}: a textarea, an optional picture,\n * and Send — Ctrl/⌘+Enter sends, the shortcut the report dialog and the note editor\n * use, so the habit carries across the feature. Plain Enter is a new line: feedback is\n * written in paragraphs, unlike a chat — which `sendOn=\"enter\"` is for (keksdose G5).\n *\n * Named for what it is since 0.22 (keksdose K17): the component was never\n * feedback-specific — a textarea, an optional picture or a host's upload slot, Send,\n * `sendOn=\"enter\"` for the chat way — and keksdose's assistant and support chat are\n * chats, not reports. `FeedbackComposer` is its old name, deprecated in 0.34.\n */\nexport function ChatComposer({\n  onSend,\n  pending = false,\n  attachment,\n  attachmentSlot,\n  canSend: canSendProp,\n  sendOn = \"mod-enter\",\n  disabledReason,\n  commit,\n  rows = 3,\n  maxLength,\n  showCount,\n  countLabels,\n  placeholder,\n  value,\n  onValueChange,\n  ref,\n  labels: labelsProp,\n  className,\n  id,\n  size = \"md\",\n  ...rest\n}: FeedbackComposerProps) {\n  const labels = useKitLabels(\"feedbackComposer\", DEFAULT_FEEDBACK_COMPOSER_LABELS, labelsProp);\n  // The lock as Send sees it, with its scope (§12.36). Send's Button reads the same\n  // through its own `commit`; this holds the keyboard's send back with it.\n  const lock = useWriteLock(commit ?? false);\n  const rootAttributes = { id, ...dataAttributes(rest) };\n  const hintId = useId();\n  const [ownDraft, setOwnDraft] = useState(\"\");\n  const controlled = value !== undefined;\n  const draft = controlled ? value : ownDraft;\n  const [file, setFile] = useState<File | null>(null);\n  const root = useRef<HTMLDivElement>(null);\n  const box = useRef<HTMLTextAreaElement>(null);\n  // The draft as of the last commit. The send's `.then` and `insertText` run after\n  // renders their closure did not see — text typed while the send was in flight, a\n  // second chip clicked before the first one's render — and must not act on a stale\n  // string (for a controlled draft there is no updater function to lean on).\n  const latest = useRef(draft);\n  useLayoutEffect(() => {\n    latest.current = draft;\n  });\n  // Where the caret goes once an inserted text has rendered.\n  const caret = useRef<number | null>(null);\n  useLayoutEffect(() => {\n    const el = box.current;\n    if (caret.current === null || !el) return;\n    el.focus();\n    el.setSelectionRange(caret.current, caret.current);\n    caret.current = null;\n  });\n\n  const setDraft = (next: string) => {\n    latest.current = next;\n    if (!controlled) setOwnDraft(next);\n    onValueChange?.(next);\n  };\n\n  useImperativeHandle(ref, () => ({\n    insertText: (text) => {\n      const el = box.current;\n      if (!el) return;\n      const current = latest.current;\n      // A second insert before the first has rendered goes after the first, not at the\n      // textarea's not-yet-moved caret. Otherwise the textarea's selection, which may\n      // be past the end of a controlled value the host has just shortened: clamp it.\n      const pending = caret.current;\n      const start = Math.min(pending ?? el.selectionStart ?? current.length, current.length);\n      const end = pending ?? Math.max(start, Math.min(el.selectionEnd ?? start, current.length));\n      caret.current = start + text.length;\n      setDraft(current.slice(0, start) + text + current.slice(end));\n    },\n    focus: () => box.current?.focus(),\n  }));\n  // The server snapshot is \"Ctrl\"; the client corrects it after hydration.\n  const modifier = useSyncExternalStore(\n    noSubscribe,\n    () => (isApple() ? \"⌘\" : \"Ctrl\"),\n    () => \"Ctrl\",\n  );\n\n  // The kit's one presence rule (DUP-11): `\"\"` is no reason either, so it keeps the box.\n  if (hasContent(disabledReason)) {\n    return (\n      <p {...rootAttributes} className={cn(\"text-xs text-muted\", className)}>\n        {disabledReason}\n      </p>\n    );\n  }\n\n  // Longer than `maxLength` only through `insertText` or a controlled value (typing\n  // stops at it): the server would refuse it, so it does not go.\n  const tooLong = maxLength !== undefined && draft.length > maxLength;\n  const canSend = (canSendProp ?? draft.trim().length > 0) && !pending && !tooLong && !lock.locked;\n  const send = () => {\n    if (!canSend) return;\n    const sentDraft = draft;\n    const sentFile = file;\n    Promise.resolve(onSend(draft.trim(), file))\n      .then(() => {\n        if (latest.current === sentDraft) setDraft(\"\");\n        setFile((current) => (current === sentFile ? null : current));\n      })\n      .catch(() => {});\n  };\n\n  const config = attachment === true ? {} : attachment || null;\n  // The slot is handed the ref OBJECT, for a field's `pasteFrom`, which reads `.current`\n  // in an effect once the root is attached — nothing reads it during this render (see\n  // FeedbackComposerSlotContext.root).\n  const slot =\n    typeof attachmentSlot === \"function\"\n      ? // eslint-disable-next-line react-hooks/refs -- handed on for an effect, not read here\n        attachmentSlot({ root, pending })\n      : attachmentSlot;\n\n  return (\n    <div {...rootAttributes} ref={root} className={cn(\"space-y-2\", className)}>\n      <Textarea\n        rows={rows}\n        dir=\"auto\"\n        aria-label={labels.field}\n        // Textarea puts the counter's description after this one, so under \"sm\" the box\n        // reads \"Enter to send… 12 of 4000 characters\".\n        aria-describedby={size === \"sm\" ? hintId : undefined}\n        maxLength={maxLength}\n        // Passed only when given: Textarea keeps a wrapper for a `showCount` it was\n        // handed at all, and a composer without one keeps the DOM it had.\n        {...(showCount !== undefined ? { showCount } : null)}\n        countLabels={countLabels}\n        ref={box}\n        placeholder={placeholder ?? labels.placeholder}\n        value={draft}\n        onChange={(event) => setDraft(event.target.value)}\n        onKeyDown={(event) => {\n          if (event.key !== \"Enter\") return;\n          const mod = event.ctrlKey || event.metaKey;\n          // Under \"enter\": plain Enter sends, Shift+Enter falls through to the\n          // textarea's new line, and an Enter that ends an IME composition is the\n          // IME's (keyCode 229 is how Safari reports it after the composition ended).\n          const chat =\n            sendOn === \"enter\" &&\n            !event.shiftKey &&\n            !event.altKey &&\n            !event.nativeEvent.isComposing &&\n            event.keyCode !== 229;\n          if (mod || chat) {\n            event.preventDefault();\n            send();\n          }\n        }}\n      />\n      <div className=\"flex flex-wrap items-end justify-between gap-2\">\n        {config || slot != null ? (\n          <div className=\"flex min-w-0 flex-wrap items-end gap-2\">\n            {config && (\n              <FeedbackAttachmentField\n                value={file}\n                onChange={setFile}\n                labels={config.labels}\n                accept={config.accept}\n                maxBytes={config.maxBytes}\n                onError={config.onError}\n                onCaptureScreenshot={config.onCaptureScreenshot}\n                buttonVariant={config.buttonVariant}\n                buttonSize={config.buttonSize}\n                // The box is this field's sibling; a paste in it bubbles to `root`.\n                pasteFrom={root}\n              />\n            )}\n            {slot}\n          </div>\n        ) : (\n          <span />\n        )}\n        <div className=\"ms-auto flex items-center gap-2\">\n          <span\n            id={hintId}\n            className={size === \"sm\" ? \"sr-only\" : \"text-xs text-placeholder\"}\n          >\n            {sendOn === \"enter\" ? labels.sendHintEnter : labels.sendHint(modifier)}\n          </span>\n          <Button\n            onClick={send}\n            disabled={!canSend}\n            commit={commit}\n            aria-busy={pending || undefined}\n            size={size === \"sm\" ? \"sm\" : undefined}\n          >\n            {pending ? (\n              <Spinner label={null} className=\"size-4\" />\n            ) : (\n              <Send className=\"size-4 rtl:-scale-x-100\" aria-hidden />\n            )}\n            {labels.send}\n          </Button>\n        </div>\n      </div>\n    </div>\n  );\n}\n\n/** The `data-*` entries of a rest-props object, and nothing else: whatever a caller\n *  spread in that the composer does not know is not the root's to receive. */\nfunction dataAttributes(props: object): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(props)) if (key.startsWith(\"data-\")) out[key] = value;\n  return out;\n}\n\n/**\n * @deprecated 0.34 — `ChatComposer`, the same function under the name that is not about\n * feedback; removed in 0.35 (refactor audit 2026-10, API-6d). keksdose's support thread\n * is the one app site.\n */\nexport const FeedbackComposer = ChatComposer;\n/** {@link FeedbackComposerProps}, for {@link ChatComposer}. */\nexport type ChatComposerProps = FeedbackComposerProps;\n/** {@link FeedbackComposerHandle}, for {@link ChatComposer}. */\nexport type ChatComposerHandle = FeedbackComposerHandle;\n/** {@link FeedbackComposerLabels}, for {@link ChatComposer} — still the `feedbackComposer`\n *  namespace of the provider. */\nexport type ChatComposerLabels = FeedbackComposerLabels;\n/** {@link FeedbackComposerSlotContext}, for {@link ChatComposer}'s `attachmentSlot`. */\nexport type ChatComposerSlotContext = FeedbackComposerSlotContext;\n"],"mappings":"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","names":["index","pending"]}
+{"version":3,"sources":["../../src/feedback/feedback-thread.tsx"],"sourcesContent":["import { useEffect, useId, useImperativeHandle, useLayoutEffect, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ReactNode, Ref, RefObject } from \"react\";\nimport { ImageIcon, ImageOff, Paperclip, Send } from \"lucide-react\";\nimport { cn } from \"../lib/cn\";\nimport { formatDate, formatRelativeTime } from \"../lib/format\";\nimport { hasContent } from \"../lib/presence\";\nimport { Button } from \"../components/button\";\nimport { EmptyState } from \"../components/empty-state\";\nimport { Spinner } from \"../components/spinner\";\nimport { Textarea } from \"../components/textarea\";\nimport type { CharacterCountLabels } from \"../components/field-base\";\nimport { Skeleton } from \"../components/skeleton\";\nimport { Tooltip } from \"../components/tooltip\";\nimport { useWriteLock } from \"../components/write-lock\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useKitFileLabels, useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { FeedbackAttachmentField } from \"./feedback-attachment\";\nimport type { FeedbackAttachmentFieldSingleProps } from \"./feedback-attachment\";\nimport type { FeedbackNoteAttachment } from \"./feedback-inbox\";\nimport type { FeedbackAttachmentLabels } from \"./feedback-dialog\";\nimport {\n  DEFAULT_FEEDBACK_COMPOSER_LABELS,\n  DEFAULT_FEEDBACK_THREAD_LABELS,\n} from \"./feedback-thread-labels\";\n\n/**\n * The conversation under a report: who said what, when, with what attached — and the\n * box to answer in.\n *\n * Both apps had written it by hand. kastlan's feedback page grew a comment list of\n * bordered boxes with `slate-*` literals (feedback-page.tsx, \"keksdose left this\n * unbuilt\"), and keksdose built the same thing a second time for support\n * (support-thread.tsx) with sides, bubbles and a composer that clears only what it\n * sent. This is that second one, generalised: the kit owns the look and the\n * behaviour, the app owns the data, the upload and every word it does not share.\n *\n * **Own vs other** is the caller's per message (`own`), not a comparison the kit makes\n * against a user id: whose message sits at the END side depends on who is reading,\n * and only the app knows that (keksdose's support thread labelled a member's question\n * \"Du\" in the admin panel the first time round, by reading the wrong field).\n *\n * **Redaction.** A thread is somebody's words about their own data — exactly what a\n * host's demo / screen-share mode blurs. Bodies, authors and attachments carry\n * `data-private` (the attribute `Tooltip redact` and `StatTile sensitive` use) unless\n * `redact={false}`.\n *\n * **RTL.** Sides are logical — `justify-end` is the reading end, and the bubble's\n * tucked corner is `rounded-ee` / `rounded-es` — and each body is `dir=\"auto\"`, so a\n * Hebrew reply in an English thread (or the reverse) lays out as its own language.\n *\n * **A chat, too** (keksdose G4/G5). keksdose's support chat is the same conversation\n * read the chat way: status lines between the messages (\"Closed automatically\",\n * \"Reopened\"), a day line where the date changes, clock times under it, Enter to send\n * and several files uploaded ahead of the send. Each of those is an opt-in here\n * (`kind: \"event\"`, `daySeparators`, `timeFormat=\"clock\"`, `sendOn=\"enter\"`,\n * `attachmentSlot` + `canSend`), so the feedback thread's defaults stay as they were.\n */\n\n/* ── Labels ───────────────────────────────────────────────────────────────── */\n\n/** The `feedbackThread` namespace of `<UiKitProvider labels>`. */\nexport interface FeedbackThreadLabels {\n  /** Accessible name of the message list. */\n  thread: string;\n  empty: string;\n  loading: string;\n  /** Author line of an `own` message that has no `author` of its own. */\n  you: string;\n  /** The badge beside a `staff` author. */\n  staff: string;\n  /** Accessible name of a message's attachment list. */\n  attachments: string;\n}\n\n// Defined in ./feedback-thread-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_THREAD_LABELS };\n\n/** The `feedbackComposer` namespace of `<UiKitProvider labels>`. The attach buttons'\n *  words are `feedbackAttachment`'s, shared with the dialog and the note editor. */\nexport interface FeedbackComposerLabels {\n  /** Accessible name of the text box. */\n  field: string;\n  placeholder: string;\n  send: string;\n  /** The shortcut line, given the platform's modifier (\"Ctrl\" or \"⌘\"). */\n  sendHint: (modifier: string) => string;\n  /** The shortcut line under `sendOn=\"enter\"` (keksdose G5): Enter sends, so say how a\n   *  new line is made. */\n  sendHintEnter: string;\n}\n\n// Defined in ./feedback-thread-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_FEEDBACK_COMPOSER_LABELS };\n\n/* ── Thread ───────────────────────────────────────────────────────────────── */\n\nexport interface FeedbackThreadAttachment {\n  id?: string | number;\n  name: string;\n  /** Where to open it. Left out, the attachment is listed by name only. */\n  url?: string;\n  /** MIME type; an `image/*` with a `url` is shown as a thumbnail. */\n  type?: string;\n  /** Bytes, shown beside a non-image. */\n  size?: number;\n}\n\nexport interface FeedbackThreadMessage {\n  /** Leave out, or `\"message\"`. `\"event\"` is a {@link FeedbackThreadEvent}. */\n  kind?: \"message\";\n  id: string | number;\n  /** Who wrote it. Left out on an `own` message, it reads \"You\". */\n  author?: ReactNode;\n  /** A `Date`, an ISO string or epoch ms. */\n  createdAt: Date | string | number;\n  body: string;\n  attachments?: readonly FeedbackThreadAttachment[];\n  /** Written by whoever is reading: sits at the end side, in the brand tint. */\n  own?: boolean;\n  /** Written by the team rather than a user: gets the \"Staff\" badge. */\n  staff?: boolean;\n}\n\n/**\n * A line in the thread that nobody wrote — \"Closed automatically\", \"Marked as\n * resolved\", \"Reopened\" — drawn centred and muted with its time, no author, no side,\n * no bubble.\n *\n * keksdose G4: its support chat interleaves these with the messages, and as a message\n * they came out as a bubble from nobody at the start side, which reads as the member\n * having said \"resolved\". Word it for the READER, as with `own`: the app knows whether\n * \"you reopened it\" or \"Anna reopened it\" is true for the person looking.\n *\n * The text is the app's, not somebody's words about their data, so it is NOT tagged\n * `data-private`; one that names a person can wrap the name in its own\n * `<span data-private>` (`body` is a node for that reason).\n */\nexport interface FeedbackThreadEvent {\n  kind: \"event\";\n  id: string | number;\n  /** A `Date`, an ISO string or epoch ms. */\n  createdAt: Date | string | number;\n  body: ReactNode;\n}\n\n/** One row of a {@link FeedbackThread}: a message, or an event line between them. */\nexport type FeedbackThreadItem = FeedbackThreadMessage | FeedbackThreadEvent;\n\nexport interface FeedbackThreadProps {\n  /** Oldest first. Event lines ({@link FeedbackThreadEvent}) sit among the messages. */\n  messages: readonly FeedbackThreadItem[];\n  loading?: boolean;\n  /** Replaces the default \"No comments yet\". */\n  empty?: ReactNode;\n  /**\n   * Draw one attachment yourself — for files behind auth, which a plain `<img src>`\n   * cannot fetch (kastlan's `AuthedImage`), or a lightbox. The default is a thumbnail\n   * link for an image with a `url`, a file link otherwise.\n   */\n  renderAttachment?: (attachment: FeedbackThreadAttachment, message: FeedbackThreadMessage) => ReactNode;\n  /** Tag bodies, authors and attachments `data-private`. Default true. */\n  redact?: boolean;\n  /**\n   * How a row's time reads. `\"relative\"` (default): \"5 minutes ago\", a date past six\n   * days — right for a report's comments, read days apart. `\"clock\"`: the time of day\n   * in the locale (\"14:05\", \"2:05 PM\") — the chat look, keksdose G4; pair it with\n   * `daySeparators`, which say which day that clock time is on. Either way the full\n   * date and time is in the Tooltip.\n   */\n  timeFormat?: \"relative\" | \"clock\";\n  /**\n   * A centred day line before the first row and wherever the next row is on another\n   * calendar day (the device's zone): \"Today\", \"Yesterday\", else the date — keksdose\n   * G4. \"Today\" / \"Yesterday\" are `Intl.RelativeTimeFormat`'s own words in the kit\n   * locale, so there is no label to translate. Default false.\n   */\n  daySeparators?: boolean;\n  /** \"Now\" for the relative times and the day lines — pin it in tests and stories.\n   *  Default: the clock. */\n  now?: Date | number;\n  /** Overrides the provider's locale for the times. */\n  locale?: string;\n  labels?: LabelOverride<FeedbackThreadLabels>;\n  className?: string;\n}\n\nexport function FeedbackThread({\n  messages,\n  loading = false,\n  empty,\n  renderAttachment,\n  redact = true,\n  now,\n  locale: localeProp,\n  timeFormat = \"relative\",\n  daySeparators = false,\n  labels: labelsProp,\n  className,\n}: FeedbackThreadProps) {\n  const labels = useKitLabels(\"feedbackThread\", DEFAULT_FEEDBACK_THREAD_LABELS, labelsProp);\n  const locale = useKitLocale(localeProp);\n  const file = useKitFileLabels();\n  const priv = redact ? \"\" : undefined;\n  const clock = useMinuteClock(now === undefined);\n  const reference = now === undefined ? clock : +now;\n\n  if (loading && messages.length === 0) {\n    return <Skeleton lines={3} label={labels.loading} className={className} />;\n  }\n  if (messages.length === 0) {\n    return (\n      <EmptyState\n        variant=\"inline\"\n        size=\"sm\"\n        title={empty ?? labels.empty}\n        className={cn(\"justify-start\", className)}\n      />\n    );\n  }\n\n  // Per row, the calendar day of the last readable date up to it — what a day line\n  // compares against.\n  const days: (number | null)[] = [];\n  for (const message of messages) {\n    const date = toDate(message.createdAt);\n    days.push(date ? dayNumber(date) : (days.at(-1) ?? null));\n  }\n\n  return (\n    <ol aria-label={labels.thread} aria-busy={loading || undefined} className={cn(\"space-y-3\", className)}>\n      {messages.flatMap((message, index) => {\n        const date = toDate(message.createdAt);\n        const time = date && (\n          // The kit's Tooltip, not a native title: one tooltip look app-wide\n          // (keksdose F0 / dev#523).\n          <Tooltip label={new Intl.DateTimeFormat(locale, { dateStyle: \"full\", timeStyle: \"short\" }).format(date)}>\n            <time dateTime={date.toISOString()} className=\"tabular-nums\">\n              {timeFormat === \"clock\"\n                ? formatDate(date, \"time\", { locale })\n                : formatRelativeTime(date, {\n                    now: reference,\n                    locale,\n                    // Past the kit's day steps it is a date: \"2 weeks ago\" makes\n                    // the reader do arithmetic the date already did.\n                    absoluteAfterDays: 6.5,\n                  })}\n            </time>\n          </Tooltip>\n        );\n        const rows: ReactNode[] = [];\n        const day = date && dayNumber(date);\n        // Against the last row WITH a readable date: an unparseable one neither starts\n        // a day nor hides the next change.\n        if (daySeparators && date && day !== days[index - 1]) {\n          rows.push(<DaySeparator key={`day-${message.id}`} date={date} now={reference} locale={locale} />);\n        }\n        if (message.kind === \"event\") {\n          // A list item like the rest, so \"Reopened\" is read in its place, but not an\n          // article: an article is somebody's post, and this has no author.\n          rows.push(\n            <li\n              key={message.id}\n              data-event=\"\"\n              className=\"flex flex-wrap items-baseline justify-center gap-x-2 px-4 text-center text-xs text-muted\"\n            >\n              <span>{message.body}</span>\n              {time && <span className=\"text-caption\">{time}</span>}\n            </li>,\n          );\n          return rows;\n        }\n        const author = message.author ?? (message.own ? labels.you : null);\n        const attachments = message.attachments ?? [];\n        rows.push(\n          <li\n            key={message.id}\n            className={cn(\"flex\", message.own ? \"justify-end\" : \"justify-start\")}\n            data-own={message.own ? \"\" : undefined}\n          >\n            <article\n              className={cn(\n                \"max-w-[85%] min-w-0 rounded-lg px-3 py-2 text-sm\",\n                message.own\n                  ? \"rounded-ee-sm bg-brand-soft\"\n                  : \"rounded-es-sm bg-surface-2\",\n              )}\n            >\n              <header className=\"mb-0.5 flex flex-wrap items-center gap-x-2 gap-y-0.5 text-caption text-muted\">\n                {author != null && (\n                  <span data-private={priv} className=\"font-medium text-secondary\">\n                    {author}\n                  </span>\n                )}\n                {message.staff && (\n                  <span className=\"rounded border border-subtle bg-surface px-1 text-micro font-medium uppercase tracking-wide text-secondary\">\n                    {labels.staff}\n                  </span>\n                )}\n                {time}\n              </header>\n              {message.body && (\n                <p\n                  data-private={priv}\n                  dir=\"auto\"\n                  className=\"whitespace-pre-wrap break-words text-start text-primary\"\n                >\n                  {message.body}\n                </p>\n              )}\n              {attachments.length > 0 && (\n                <ul aria-label={labels.attachments} data-private={priv} className=\"mt-2 flex flex-wrap gap-2\">\n                  {attachments.map((attachment, index) => (\n                    <li key={attachment.id ?? `${index}-${attachment.name}`} className=\"min-w-0\">\n                      {renderAttachment ? (\n                        renderAttachment(attachment, message)\n                      ) : (\n                        <DefaultAttachment attachment={attachment} size={file.size} />\n                      )}\n                    </li>\n                  ))}\n                </ul>\n              )}\n            </article>\n          </li>,\n        );\n        return rows;\n      })}\n    </ol>\n  );\n}\n\nfunction DefaultAttachment({\n  attachment,\n  size,\n}: {\n  attachment: FeedbackThreadAttachment;\n  size: (bytes: number) => string;\n}) {\n  const { name, url, type } = attachment;\n  if (url && type?.startsWith(\"image/\")) return <ImageThumbnail url={url} name={name} />;\n  const content = (\n    <>\n      <Paperclip className=\"size-3.5 shrink-0\" aria-hidden />\n      {/* A file name wraps from Large up, as the attachments of the composer do (text\n          size §10.17; round 0.34 T1: the sweep read \"export-20…\"). */}\n      <span className=\"min-w-0 truncate-until-large\">{name}</span>\n      {attachment.size !== undefined && (\n        <span className=\"shrink-0 text-muted\">{size(attachment.size)}</span>\n      )}\n    </>\n  );\n  const chip =\n    \"inline-flex max-w-full items-center gap-1 rounded border border-subtle bg-surface px-2 py-1 text-xs text-secondary\";\n  return url ? (\n    <a href={url} target=\"_blank\" rel=\"noopener noreferrer\" className={cn(chip, \"hover:bg-hover\")}>\n      {content}\n    </a>\n  ) : (\n    <span className={chip}>{content}</span>\n  );\n}\n\n/** An image attachment's thumbnail. The box is drawn before the picture arrives —\n *  `loading=\"lazy\"` leaves it empty until it nears the viewport, and a URL that has\n *  expired never fills it — and an empty bordered square read as a broken layout, not\n *  as a picture. So the box carries an image glyph underneath until the picture\n *  covers it, and swaps it for a broken-image glyph when the load fails. */\nfunction ImageThumbnail({ url, name }: { url: string; name: string }) {\n  // Keyed on the URL, so a message whose attachment is replaced tries the new one.\n  const [failedUrl, setFailedUrl] = useState<string | null>(null);\n  const failed = failedUrl === url;\n  const Glyph = failed ? ImageOff : ImageIcon;\n  return (\n    <a\n      href={url}\n      target=\"_blank\"\n      rel=\"noopener noreferrer\"\n      className=\"relative block h-20 w-20 overflow-hidden rounded border border-subtle bg-surface-2\"\n    >\n      <Glyph aria-hidden className=\"absolute inset-0 m-auto size-6 text-muted\" />\n      {!failed && (\n        // eslint-disable-next-line jsx-a11y/no-noninteractive-element-interactions -- load/error are resource events, not interactions\n        <img\n          src={url}\n          alt={name}\n          loading=\"lazy\"\n          onError={() => setFailedUrl(url)}\n          className=\"relative h-full w-full object-cover\"\n        />\n      )}\n      {/* The <img> and its alt are gone once it failed; the link still needs a name. */}\n      {failed && <span className=\"sr-only\">{name}</span>}\n    </a>\n  );\n}\n\n/** The time, refreshed once a minute while `active`, so \"2 minutes ago\" does not stay\n *  \"just now\" on a page left open. Read in state rather than in render, which must be\n *  pure. */\nfunction useMinuteClock(active: boolean): number {\n  const [time, setTime] = useState(() => Date.now());\n  useEffect(() => {\n    if (!active) return;\n    const id = setInterval(() => setTime(Date.now()), 60_000);\n    return () => clearInterval(id);\n  }, [active]);\n  return time;\n}\n\n/** The local calendar day as one number (20260926), for \"same day?\" and keys. */\nfunction dayNumber(date: Date): number {\n  return date.getFullYear() * 10_000 + (date.getMonth() + 1) * 100 + date.getDate();\n}\n\n/**\n * The day line of `daySeparators` (keksdose G4): \"Today\" / \"Yesterday\" from\n * `Intl.RelativeTimeFormat` (`numeric: \"auto\"`) — the locale's own words, capitalised\n * for a line that stands alone (\"heute\" → \"Heute\"; a script without case is left as\n * is) — else the weekday and date, with the year only when it is not this one.\n *\n * Counted in calendar days, not 24-hour spans: 23:50 yesterday is \"Yesterday\" at\n * 00:10 today.\n */\nfunction DaySeparator({ date, now, locale }: { date: Date; now: number; locale: string | undefined }) {\n  const today = new Date(now);\n  const days = Math.round(\n    (Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()) -\n      Date.UTC(today.getFullYear(), today.getMonth(), today.getDate())) /\n      86_400_000,\n  );\n  let label: string;\n  if (days === 0 || days === -1) {\n    const word = new Intl.RelativeTimeFormat(locale, { numeric: \"auto\" }).format(days + 0, \"day\");\n    label = word.charAt(0).toLocaleUpperCase(locale) + word.slice(1);\n  } else {\n    label = formatDate(\n      date,\n      {\n        weekday: \"long\",\n        day: \"numeric\",\n        month: \"long\",\n        ...(date.getFullYear() === today.getFullYear() ? null : { year: \"numeric\" }),\n      },\n      { locale },\n    );\n  }\n  const y = String(date.getFullYear()).padStart(4, \"0\");\n  const m = String(date.getMonth() + 1).padStart(2, \"0\");\n  const d = String(date.getDate()).padStart(2, \"0\");\n  return (\n    <li data-day-separator=\"\" className=\"flex items-center gap-3 py-1 text-xs text-muted\">\n      <span aria-hidden className=\"h-px flex-1 bg-[var(--border)]\" />\n      <time dateTime={`${y}-${m}-${d}`} className=\"font-medium\">\n        {label}\n      </time>\n      <span aria-hidden className=\"h-px flex-1 bg-[var(--border)]\" />\n    </li>\n  );\n}\n\nfunction toDate(value: Date | string | number): Date | null {\n  const date = value instanceof Date ? value : new Date(value);\n  return Number.isNaN(date.getTime()) ? null : date;\n}\n\n/* ── Composer ─────────────────────────────────────────────────────────────── */\n\n/** What the composer's attach control takes — {@link FeedbackNoteAttachment} with the\n *  labels optional, since the field reads `feedbackAttachment` from the provider, and\n *  `onError` the field's own (0.23.0): it is handed the refused file and the limit too\n *  (`FeedbackAttachmentErrorInfo`), and a `(kind) => …` handler still fits. Since\n *  0.24.0 also the field's `buttonVariant` / `buttonSize`, for a composer whose row\n *  wants smaller or quieter attach buttons than the bordered `md` default. */\nexport type FeedbackComposerAttachment = Omit<FeedbackNoteAttachment, \"labels\" | \"onError\"> & {\n  labels?: LabelOverride<FeedbackAttachmentLabels>;\n  onError?: FeedbackAttachmentFieldSingleProps[\"onError\"];\n} & Pick<FeedbackAttachmentFieldSingleProps, \"buttonVariant\" | \"buttonSize\">;\n\n/**\n * What a render-prop {@link FeedbackComposerProps.attachmentSlot} is handed (0.24.0,\n * keksdose).\n *\n * keksdose's support chat put `<FeedbackAttachmentField refs>` in the slot and a\n * screenshot pasted into the reply box never reached it: the box is the field's\n * sibling, so the paste bubbles to their common parent — the composer's root — and the\n * field hears it only through `pasteFrom`, which needs that root. The composer kept it\n * to itself, so keksdose wrapped the whole composer in a ref'd `<div>` of its own just\n * to have an element to hand over.\n */\nexport interface FeedbackComposerSlotContext {\n  /**\n   * The composer's root, round the text box and this slot — the field's `pasteFrom`,\n   * as it is: `pasteFrom={slot.root}`.\n   *\n   * A ref, not the element, because `pasteFrom` is one: the field reads `.current` in\n   * an effect, and the slot renders INSIDE this root, so the two are committed together\n   * and React attaches the root before any effect of the slot's runs — the first paste\n   * after the first paint already lands. The element itself would be `null` on the\n   * first render (it does not exist yet) and could only arrive by a second render\n   * through state; the ref is the same object every render, so the field's listener is\n   * added once and never re-added.\n   *\n   * With the built-in `attachment` on as well, it listens on this root too: hand the\n   * root to one field only, or an image pasted once is attached twice.\n   */\n  root: RefObject<HTMLElement | null>;\n  /** The composer's `pending` — a send is in flight. For the field's `disabled`\n   *  (keksdose G5b): the message carries the attachments as they were at the press. */\n  pending: boolean;\n}\n\nexport interface FeedbackComposerProps {\n  /**\n   * Send the comment. Return the promise: the box clears when it RESOLVES, and only of\n   * what was sent — text typed while it was in flight stays. A rejection keeps\n   * everything for a retry (surface the error yourself; the composer stays quiet).\n   *\n   * `attachment` is the built-in field's one picture. Files the host uploaded ahead\n   * (`attachmentSlot`) are the host's state, read by the host here — and `body` may be\n   * `\"\"` when `canSend` let an attachments-only message go.\n   */\n  onSend: (body: string, attachment: File | null) => void | Promise<unknown>;\n  /** The send is in flight: a spinner on the button and no second send. */\n  pending?: boolean;\n  /** Offer one picture with the comment (file, paste or `onCaptureScreenshot`).\n   *  `true` for the defaults. Left out, the composer is text only. */\n  attachment?: boolean | FeedbackComposerAttachment;\n  /**\n   * The host's own attach control, in the row with Send where the built-in field sits\n   * (after it, if both are on) — keksdose G5: its support chat uploads up to N files\n   * AHEAD of the send and sends their refs, which one `File` in `onSend` cannot carry.\n   * The slot is the host's picker plus the chips of what is uploaded; the upload, the\n   * refs and clearing them once `onSend` resolves stay with the host. Pair it with\n   * `canSend`.\n   *\n   * A node, or (0.24.0) a function of {@link FeedbackComposerSlotContext} that returns\n   * one — for a field that wants the composer's root as its `pasteFrom`, so a\n   * screenshot pasted into the box reaches it, and `pending` for its `disabled`:\n   *\n   * ```tsx\n   * attachmentSlot={({ root, pending }) => (\n   *   <FeedbackAttachmentField refs pasteFrom={root} disabled={pending} … />\n   * )}\n   * ```\n   *\n   * Called once per render of the composer, and not at all while `disabledReason`\n   * stands in for it.\n   */\n  attachmentSlot?: ReactNode | ((slot: FeedbackComposerSlotContext) => ReactNode);\n  /**\n   * Whether Send is enabled, over the composer's own rule (some text in the box) —\n   * for state the composer cannot see, i.e. `attachmentSlot`'s (keksdose G5): `true`\n   * with files ready makes an empty draft sendable (`onSend(\"\", null)`), `false` while\n   * an upload is still running holds even a written reply back. Left out, the text\n   * decides. `pending` blocks a send either way, as does a draft past `maxLength`.\n   */\n  canSend?: boolean;\n  /**\n   * Which key sends. `\"mod-enter\"` (default): Ctrl/⌘+Enter, the report dialog's and\n   * note editor's shortcut, with plain Enter a new line — feedback is written in\n   * paragraphs. `\"enter\"`: the chat way (keksdose G5) — Enter sends, Shift+Enter is a\n   * new line, Ctrl/⌘+Enter still sends; an Enter that confirms an IME composition\n   * (Japanese, Chinese input) is the IME's, never a send.\n   */\n  sendOn?: \"mod-enter\" | \"enter\";\n  /** Rendered INSTEAD of the composer — the thread is closed, or read-only for this\n   *  reader. */\n  disabledReason?: ReactNode;\n  /**\n   * Send COMMITS (0.33.1, kastlan's assistant): under a locked {@link WriteLockProvider}\n   * Send is disabled the `disabledReason` way — focusable, the lock's reason in its\n   * tooltip and description, as on {@link Button}'s `commit` — and neither Enter nor\n   * Ctrl/⌘+Enter sends. The box stays editable and the draft stays: nothing in it\n   * reaches the server until Send, and the lock may lift. No provider, or an unlocked\n   * one: no effect. A {@link CommitScope}: kastlan's assistant answers under the demo\n   * and not under a lapsed plan (its backend's 402), so it passes\n   * `commit={{ except: [\"demo\"] }}` where it read `useWriteLock` and fed `canSend` and a\n   * reason by hand. Not the prop above: that one replaces the box, this one keeps it.\n   */\n  commit?: CommitScope;\n  rows?: number;\n  /**\n   * The longest draft the box takes, in UTF-16 code units as the browser counts — the\n   * server's limit, so a reply too long for it is cut off while it is typed rather than\n   * refused by a 422 after the press (keksdose G6: its support replies are capped at\n   * 4,000 on the server, and its other text fields already count against that with\n   * Textarea's `maxLength` + `showCount` since 0.22; the reply box, a composer, could\n   * not). The box's own `maxLength`, so typing and pasting stop at it.\n   *\n   * {@link FeedbackComposerHandle.insertText} is not stopped by it — the browser limits\n   * typing, not a script — and a canned reply is not cut mid-sentence to fit. A draft\n   * past the limit therefore holds Send back (whatever `canSend` says, as `pending`\n   * does) until it is trimmed; with `showCount` the counter, red at the limit, says by\n   * how much.\n   */\n  maxLength?: number;\n  /**\n   * A live \"12/4000\" under the box, with `maxLength` — Textarea's `showCount`, the same\n   * counter (keksdose G6): the count is part of the box's description, read with it on\n   * focus, and a polite live region speaks only on entering the last stretch and at the\n   * limit, never per keystroke. Under `size=\"sm\"` the hidden send hint stays the box's\n   * description too, before the count. Ignored without `maxLength`.\n   */\n  showCount?: boolean;\n  /** The counter's words — the `characterCount` namespace, as on Textarea. */\n  countLabels?: Partial<CharacterCountLabels>;\n  /**\n   * The box's hint, over the `placeholder` label — keksdose F9: an admin answering a\n   * support ticket is asked something else (\"Reply to Anna…\") than a member adding to\n   * their own report, and one provider-wide label cannot say both.\n   */\n  placeholder?: string;\n  /**\n   * The draft, controlled — for a host that keeps it itself (saves it per ticket,\n   * prefills a template). Left out, the composer keeps its own. Either way a send\n   * that resolves clears only what was sent: controlled, that is an\n   * `onValueChange(\"\")` the host receives like any keystroke, and only if the draft\n   * is still the one that went out.\n   */\n  value?: string;\n  /** Every change to the draft — typing, {@link FeedbackComposerHandle.insertText}, the\n   *  clear after a send. Required to change a controlled `value`. */\n  onValueChange?: (value: string) => void;\n  /** {@link FeedbackComposerHandle}: put text into the draft from outside (canned-reply\n   *  chips) or focus the box. */\n  ref?: Ref<FeedbackComposerHandle>;\n  labels?: LabelOverride<FeedbackComposerLabels>;\n  className?: string;\n  /**\n   * `\"sm\"` for a narrow host — keksdose's assistant launcher, a small floating panel\n   * (0.22): a small Send button, and the send hint (\"Enter to send, Shift + Enter for a\n   * new line\") hidden from view but kept as the box's description, so a keyboard or\n   * screen-reader user still learns the shortcut. Default `\"md\"`.\n   */\n  size?: \"md\" | \"sm\";\n  /**\n   * On the composer's root — the box, or the `disabledReason` line in its place —\n   * with any `data-*` attribute beside it (keksdose K17). keksdose's assistant tour\n   * points at the chat box with `[data-tour=\"assistant-ask\"]`, and a composer that\n   * dropped every attribute it was not told about left the anchor nowhere: the\n   * assistant kept its hand-built box rather than lose the tour step.\n   */\n  id?: string;\n  /** `data-*` attributes for the root, as `id` — a tour anchor, a test id. */\n  [dataAttribute: `data-${string}`]: string | number | boolean | undefined;\n}\n\n/**\n * What a {@link ChatComposer} `ref` holds.\n *\n * keksdose F9: the support admin answers the same five questions all day and wants\n * chips above the box (\"Thanks, fixed in the next release\") that drop their text in\n * where the caret is. A controlled `value` alone cannot do that well — the host sees\n * the string, not the caret, so it could only append — so the composer, which owns\n * the textarea, does the splice.\n */\nexport interface FeedbackComposerHandle {\n  /**\n   * Insert `text` at the caret, replacing any selection (the caret the box last had:\n   * a click on a chip blurs it, and the selection survives the blur), then focus the\n   * box with the caret after the inserted text so the reply can go on. Nothing is\n   * added around it — put a space or a newline in `text` if the reply needs one. A\n   * no-op while `disabledReason` replaces the box.\n   */\n  insertText: (text: string) => void;\n  focus: () => void;\n}\n\nconst noSubscribe = () => () => {};\nconst isApple = () =>\n  typeof navigator !== \"undefined\" && /Mac|iPhone|iPad|iPod/i.test(navigator.platform || navigator.userAgent);\n\n/**\n * The answer box under a {@link FeedbackThread}: a textarea, an optional picture,\n * and Send — Ctrl/⌘+Enter sends, the shortcut the report dialog and the note editor\n * use, so the habit carries across the feature. Plain Enter is a new line: feedback is\n * written in paragraphs, unlike a chat — which `sendOn=\"enter\"` is for (keksdose G5).\n *\n * Named for what it is since 0.22 (keksdose K17): the component was never\n * feedback-specific — a textarea, an optional picture or a host's upload slot, Send,\n * `sendOn=\"enter\"` for the chat way — and keksdose's assistant and support chat are\n * chats, not reports. `FeedbackComposer`, its old name, was removed in 0.35 (refactor\n * audit 2026-10, API-6d; deprecated in 0.34); its types keep theirs.\n */\nexport function ChatComposer({\n  onSend,\n  pending = false,\n  attachment,\n  attachmentSlot,\n  canSend: canSendProp,\n  sendOn = \"mod-enter\",\n  disabledReason,\n  commit,\n  rows = 3,\n  maxLength,\n  showCount,\n  countLabels,\n  placeholder,\n  value,\n  onValueChange,\n  ref,\n  labels: labelsProp,\n  className,\n  id,\n  size = \"md\",\n  ...rest\n}: FeedbackComposerProps) {\n  const labels = useKitLabels(\"feedbackComposer\", DEFAULT_FEEDBACK_COMPOSER_LABELS, labelsProp);\n  // The lock as Send sees it, with its scope (§12.36). Send's Button reads the same\n  // through its own `commit`; this holds the keyboard's send back with it.\n  const lock = useWriteLock(commit ?? false);\n  const rootAttributes = { id, ...dataAttributes(rest) };\n  const hintId = useId();\n  const [ownDraft, setOwnDraft] = useState(\"\");\n  const controlled = value !== undefined;\n  const draft = controlled ? value : ownDraft;\n  const [file, setFile] = useState<File | null>(null);\n  const root = useRef<HTMLDivElement>(null);\n  const box = useRef<HTMLTextAreaElement>(null);\n  // The draft as of the last commit. The send's `.then` and `insertText` run after\n  // renders their closure did not see — text typed while the send was in flight, a\n  // second chip clicked before the first one's render — and must not act on a stale\n  // string (for a controlled draft there is no updater function to lean on).\n  const latest = useRef(draft);\n  useLayoutEffect(() => {\n    latest.current = draft;\n  });\n  // Where the caret goes once an inserted text has rendered.\n  const caret = useRef<number | null>(null);\n  useLayoutEffect(() => {\n    const el = box.current;\n    if (caret.current === null || !el) return;\n    el.focus();\n    el.setSelectionRange(caret.current, caret.current);\n    caret.current = null;\n  });\n\n  const setDraft = (next: string) => {\n    latest.current = next;\n    if (!controlled) setOwnDraft(next);\n    onValueChange?.(next);\n  };\n\n  useImperativeHandle(ref, () => ({\n    insertText: (text) => {\n      const el = box.current;\n      if (!el) return;\n      const current = latest.current;\n      // A second insert before the first has rendered goes after the first, not at the\n      // textarea's not-yet-moved caret. Otherwise the textarea's selection, which may\n      // be past the end of a controlled value the host has just shortened: clamp it.\n      const pending = caret.current;\n      const start = Math.min(pending ?? el.selectionStart ?? current.length, current.length);\n      const end = pending ?? Math.max(start, Math.min(el.selectionEnd ?? start, current.length));\n      caret.current = start + text.length;\n      setDraft(current.slice(0, start) + text + current.slice(end));\n    },\n    focus: () => box.current?.focus(),\n  }));\n  // The server snapshot is \"Ctrl\"; the client corrects it after hydration.\n  const modifier = useSyncExternalStore(\n    noSubscribe,\n    () => (isApple() ? \"⌘\" : \"Ctrl\"),\n    () => \"Ctrl\",\n  );\n\n  // The kit's one presence rule (DUP-11): `\"\"` is no reason either, so it keeps the box.\n  if (hasContent(disabledReason)) {\n    return (\n      <p {...rootAttributes} className={cn(\"text-xs text-muted\", className)}>\n        {disabledReason}\n      </p>\n    );\n  }\n\n  // Longer than `maxLength` only through `insertText` or a controlled value (typing\n  // stops at it): the server would refuse it, so it does not go.\n  const tooLong = maxLength !== undefined && draft.length > maxLength;\n  const canSend = (canSendProp ?? draft.trim().length > 0) && !pending && !tooLong && !lock.locked;\n  const send = () => {\n    if (!canSend) return;\n    const sentDraft = draft;\n    const sentFile = file;\n    Promise.resolve(onSend(draft.trim(), file))\n      .then(() => {\n        if (latest.current === sentDraft) setDraft(\"\");\n        setFile((current) => (current === sentFile ? null : current));\n      })\n      .catch(() => {});\n  };\n\n  const config = attachment === true ? {} : attachment || null;\n  // The slot is handed the ref OBJECT, for a field's `pasteFrom`, which reads `.current`\n  // in an effect once the root is attached — nothing reads it during this render (see\n  // FeedbackComposerSlotContext.root).\n  const slot =\n    typeof attachmentSlot === \"function\"\n      ? // eslint-disable-next-line react-hooks/refs -- handed on for an effect, not read here\n        attachmentSlot({ root, pending })\n      : attachmentSlot;\n\n  return (\n    <div {...rootAttributes} ref={root} className={cn(\"space-y-2\", className)}>\n      <Textarea\n        rows={rows}\n        dir=\"auto\"\n        aria-label={labels.field}\n        // Textarea puts the counter's description after this one, so under \"sm\" the box\n        // reads \"Enter to send… 12 of 4000 characters\".\n        aria-describedby={size === \"sm\" ? hintId : undefined}\n        maxLength={maxLength}\n        // Passed only when given: Textarea keeps a wrapper for a `showCount` it was\n        // handed at all, and a composer without one keeps the DOM it had.\n        {...(showCount !== undefined ? { showCount } : null)}\n        countLabels={countLabels}\n        ref={box}\n        placeholder={placeholder ?? labels.placeholder}\n        value={draft}\n        onChange={(event) => setDraft(event.target.value)}\n        onKeyDown={(event) => {\n          if (event.key !== \"Enter\") return;\n          const mod = event.ctrlKey || event.metaKey;\n          // Under \"enter\": plain Enter sends, Shift+Enter falls through to the\n          // textarea's new line, and an Enter that ends an IME composition is the\n          // IME's (keyCode 229 is how Safari reports it after the composition ended).\n          const chat =\n            sendOn === \"enter\" &&\n            !event.shiftKey &&\n            !event.altKey &&\n            !event.nativeEvent.isComposing &&\n            event.keyCode !== 229;\n          if (mod || chat) {\n            event.preventDefault();\n            send();\n          }\n        }}\n      />\n      <div className=\"flex flex-wrap items-end justify-between gap-2\">\n        {config || slot != null ? (\n          <div className=\"flex min-w-0 flex-wrap items-end gap-2\">\n            {config && (\n              <FeedbackAttachmentField\n                value={file}\n                onChange={setFile}\n                labels={config.labels}\n                accept={config.accept}\n                maxBytes={config.maxBytes}\n                onError={config.onError}\n                onCaptureScreenshot={config.onCaptureScreenshot}\n                buttonVariant={config.buttonVariant}\n                buttonSize={config.buttonSize}\n                // The box is this field's sibling; a paste in it bubbles to `root`.\n                pasteFrom={root}\n              />\n            )}\n            {slot}\n          </div>\n        ) : (\n          <span />\n        )}\n        <div className=\"ms-auto flex items-center gap-2\">\n          <span\n            id={hintId}\n            className={size === \"sm\" ? \"sr-only\" : \"text-xs text-placeholder\"}\n          >\n            {sendOn === \"enter\" ? labels.sendHintEnter : labels.sendHint(modifier)}\n          </span>\n          <Button\n            onClick={send}\n            disabled={!canSend}\n            commit={commit}\n            aria-busy={pending || undefined}\n            size={size === \"sm\" ? \"sm\" : undefined}\n          >\n            {pending ? (\n              <Spinner label={null} className=\"size-4\" />\n            ) : (\n              <Send className=\"size-4 rtl:-scale-x-100\" aria-hidden />\n            )}\n            {labels.send}\n          </Button>\n        </div>\n      </div>\n    </div>\n  );\n}\n\n/** The `data-*` entries of a rest-props object, and nothing else: whatever a caller\n *  spread in that the composer does not know is not the root's to receive. */\nfunction dataAttributes(props: object): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(props)) if (key.startsWith(\"data-\")) out[key] = value;\n  return out;\n}\n\n/** {@link FeedbackComposerProps}, for {@link ChatComposer}. */\nexport type ChatComposerProps = FeedbackComposerProps;\n/** {@link FeedbackComposerHandle}, for {@link ChatComposer}. */\nexport type ChatComposerHandle = FeedbackComposerHandle;\n/** {@link FeedbackComposerLabels}, for {@link ChatComposer} — still the `feedbackComposer`\n *  namespace of the provider. */\nexport type ChatComposerLabels = FeedbackComposerLabels;\n/** {@link FeedbackComposerSlotContext}, for {@link ChatComposer}'s `attachmentSlot`. */\nexport type ChatComposerSlotContext = FeedbackComposerSlotContext;\n"],"mappings":"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","names":["index","pending"]}

package/dist/hooks/use-dismiss.d.ts

@@ -1,4 +1,11 @@
 import type { KeyboardEvent as ReactKeyboardEvent, RefObject } from "react";
+/** A layer's handler, read through a ref so the stack holds one stable entry per open. */
+interface Layer {
+    escape: (e: KeyboardEvent) => void;
+}
+/** What {@link useDismissLayer} hands back: its layer while open, for
+ *  {@link runOwnKeyDown} to tell whether that layer is the one on top. */
+export type DismissLayer = RefObject<Layer | null>;
 /**
  * An Escape layer on the stack while `open`: the topmost layer is handed the next
  * Escape and calls `onEscape`, every layer under it waits its turn. A list opened inside
@@ -7,9 +14,9 @@ import type { KeyboardEvent as ReactKeyboardEvent, RefObject } from "react";
  * Where focus can be INSIDE the layer, its element's `onKeyDown` calls
  * {@link takeEscape} too, so the key stops there — see the module note. `onEscape` is
  * read live, so it need not be memoised; the layer is pushed and popped only when
- * `open` flips.
+ * `open` flips. The layer it returns is for the owner's {@link runOwnKeyDown}.
  */
-export declare function useDismissLayer(open: boolean, onEscape: (e: KeyboardEvent) => void): void;
+export declare function useDismissLayer(open: boolean, onEscape: (e: KeyboardEvent) => void): DismissLayer;
 /**
  * For a layer's own element, in its `onKeyDown`: hands an Escape on its way up to the
  * topmost layer — this one, unless something opened over it without taking focus (a
@@ -27,8 +34,13 @@ export declare function claimEscape(e: KeyboardEvent | ReactKeyboardEvent): void
  * Runs a layer owner's own key handler — a dialog's `onKeyDown` prop — and turns a
  * `preventDefault()` it makes on Escape into a claim: the one way, beside
  * {@link claimEscape}, to keep a layer open.
+ *
+ * Given the owner's `layer` (what {@link useDismissLayer} returned), an Escape that went
+ * down while another layer was above that one skips the handler: the press is the
+ * layer's on top, and the owner hears the next (0.35, KS). Without it, or while the
+ * owner's layer is not open, the handler sees every key, as before.
  */
-export declare function runOwnKeyDown<E extends ReactKeyboardEvent>(e: E, handler: ((e: E) => void) | undefined): void;
+export declare function runOwnKeyDown<E extends ReactKeyboardEvent>(e: E, handler: ((e: E) => void) | undefined, layer?: DismissLayer): void;
 /**
  * Calls `handler` on an Escape while `enabled` — as an Escape layer. Since 0.34 this is
  * {@link useDismissLayer} with its arguments the other way round: it hears the key only
@@ -58,3 +70,4 @@ export declare function useEscapeKey(handler: () => void, enabled?: boolean): vo
  * them.
  */
 export declare function useOutsideClick(refs: RefObject<HTMLElement | null> | RefObject<HTMLElement | null>[], handler: () => void, enabled?: boolean): void;
+export {};

package/dist/hooks/use-dismiss.js

@@ -43,15 +43,21 @@ function pop(layer) {
 }
 function useDismissLayer(open, onEscape) {
   const handlerRef = useRef(onEscape);
+  const layerRef = useRef(null);
   useEffect(() => {
     handlerRef.current = onEscape;
   });
   useEffect(() => {
     if (!open || typeof document === "undefined") return;
     const layer = { escape: (e) => handlerRef.current(e) };
+    layerRef.current = layer;
     push(layer);
-    return () => pop(layer);
+    return () => {
+      pop(layer);
+      layerRef.current = null;
+    };
   }, [open]);
+  return layerRef;
 }
 function takeEscape(e) {
   return handOver(e, true);
@@ -60,12 +66,18 @@ function claimEscape(e) {
   claimed.add(nativeOf(e));
   e.preventDefault();
 }
-function runOwnKeyDown(e, handler) {
+function runOwnKeyDown(e, handler, layer) {
   if (!handler) return;
+  if (layer && aboveOwner(e, layer.current)) return;
   const before = e.defaultPrevented;
   handler(e);
   if (e.key === "Escape" && !before && e.defaultPrevented) claimed.add(nativeOf(e));
 }
+function aboveOwner(e, owner) {
+  const flight = inFlight;
+  if (e.key !== "Escape" || !owner || !flight || flight.event !== nativeOf(e)) return false;
+  return flight.layer !== owner && layers.includes(owner);
+}
 function useEscapeKey(handler, enabled = true) {
   useDismissLayer(enabled, handler);
 }

package/dist/hooks/use-dismiss.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/hooks/use-dismiss.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { KeyboardEvent as ReactKeyboardEvent, RefObject } from \"react\";\nimport { isComposing } from \"../lib/ime\";\n\n/*\n * # One Escape stack (round 0.34 Wave 2, DUP-1)\n *\n * Escape closes the TOPMOST thing on screen, and only that: a list open in a dialog\n * closes and the dialog stays; the next press closes the dialog.\n *\n * \"Who owns Escape\" used to be decided five ways. The anchored pickers listened on the\n * document; Modal, FullBleedDialog, PickerSheet and Popover closed in their own panel's\n * `onKeyDown` and stopped the key; CommandPalette closed without stopping it. A dialog's\n * handler sits earlier on the key's path than any document listener, so Escape in an\n * open list inside a Modal closed the MODAL and threw the form away (BUG-1, sev 4,\n * kastlan's lease dialog), and HoverMenu, the numpad and a tooltip could not be\n * dismissed inside a dialog at all. And Modal and FullBleedDialog disagreed on when a\n * child had \"claimed\" the key: a ChipInput clearing its draft kept a Modal open and\n * closed a FullBleedDialog.\n *\n * Now every overlay and picker pushes a layer while it is open ({@link useDismissLayer}),\n * last in, first out, the way `use-overlay-history` stacks the Back gesture. One\n * capture-phase listener on the document notes which layer is on top as each Escape\n * goes down — before any handler on the page runs, so a layer that closes on the way\n * cannot pass the key on to the one beneath it. That layer, and only that one, is\n * handed the key:\n *\n * - at the first layer element the key passes on its way back up ({@link takeEscape},\n *   which Modal's panel, a picker's search box and the rest call from their\n *   `onKeyDown`). The key is stopped there, so nothing around the layers — a\n *   FloatingPanel, an app's own panel — closes with it;\n * - or, when focus is in none of them (a hover menu, a tooltip, the numpad over its\n *   field, a press on the page), at the document once the key has been everywhere else.\n *\n * Layers stack in the order they OPEN, which is the order their effects run. Two that\n * open in the same commit stack child first — the one case that order gets wrong, and\n * one no overlay in the kit does: each opens on a press, after whatever it sits in.\n *\n * ## Claiming the key: one rule\n *\n * An Escape that means \"undo this step\" is not a dismissal: ChipInput clearing its\n * draft, InlineEditField cancelling its edit, the date picker's month grid going back to\n * the days. Those call {@link claimEscape}, and no layer is handed the key. The only\n * other claim is the layer owner's OWN handler — a dialog's `onKeyDown` prop calling\n * `preventDefault()` on Escape (a busy reauth dialog holding itself open, Kurvenschmiede's\n * gear wizard asking first), through {@link runOwnKeyDown}. A `preventDefault()`\n * anywhere else claims nothing: a search box keeping Chromium from clearing itself\n * must not hold a dialog open (FullBleedDialog's 0.8.0 fix, which Modal never had).\n *\n * A handler that STOPS the key before it reaches a layer element has taken it too —\n * that is the DOM, and it is what the kit's cell editors and confirm buttons do.\n */\n\n/** A layer's handler, read through a ref so the stack holds one stable entry per open. */\ninterface Layer {\n  escape: (e: KeyboardEvent) => void;\n}\n\n/** Open layers, oldest first. Module-level, because the order is ACROSS instances. */\nconst layers: Layer[] = [];\n\n/** Escapes a claimant has taken — see {@link claimEscape}. Weak: an event is garbage\n *  once its dispatch is over. */\nconst claimed = new WeakSet<Event>();\n\n/** The Escape on its way through the page: the layer that was topmost as it went down,\n *  and whether that layer has been handed it yet. */\nlet inFlight: { event: KeyboardEvent; layer: Layer; done: boolean } | null = null;\n\nfunction nativeOf(e: KeyboardEvent | ReactKeyboardEvent): KeyboardEvent {\n  return \"nativeEvent\" in e ? e.nativeEvent : e;\n}\n\nfunction onCapture(e: KeyboardEvent): void {\n  if (e.key !== \"Escape\") return;\n  // An Escape inside an IME composition cancels the composition and nothing else.\n  const top = isComposing(e) ? undefined : layers[layers.length - 1];\n  inFlight = top ? { event: e, layer: top, done: false } : null;\n}\n\n/** The fallback: no layer element was on the key's path, or none took it. */\nfunction onBubble(e: KeyboardEvent): void {\n  handOver(e, false);\n}\n\nfunction handOver(e: KeyboardEvent | ReactKeyboardEvent, stop: boolean): boolean {\n  const native = nativeOf(e);\n  const flight = inFlight;\n  if (native.key !== \"Escape\" || !flight || flight.event !== native || flight.done) return false;\n  if (claimed.has(native)) return false;\n  flight.done = true;\n  // Consumed: a type=\"search\" box does not clear itself as well, and a handler further\n  // out that checks `defaultPrevented` (FloatingPanel, an app's own panel) leaves it.\n  e.preventDefault();\n  if (stop) e.stopPropagation();\n  // A layer that closed on the way, by a handler of its own, has had its Escape.\n  if (layers.includes(flight.layer)) flight.layer.escape(native);\n  return true;\n}\n\nfunction push(layer: Layer): void {\n  if (layers.length === 0) {\n    document.addEventListener(\"keydown\", onCapture, true);\n    document.addEventListener(\"keydown\", onBubble);\n  }\n  layers.push(layer);\n}\n\nfunction pop(layer: Layer): void {\n  const at = layers.indexOf(layer);\n  if (at >= 0) layers.splice(at, 1);\n  if (layers.length > 0) return;\n  document.removeEventListener(\"keydown\", onCapture, true);\n  document.removeEventListener(\"keydown\", onBubble);\n  inFlight = null;\n}\n\n/**\n * An Escape layer on the stack while `open`: the topmost layer is handed the next\n * Escape and calls `onEscape`, every layer under it waits its turn. A list opened inside\n * a dialog is above the dialog; a popover opened from a list, above the list.\n *\n * Where focus can be INSIDE the layer, its element's `onKeyDown` calls\n * {@link takeEscape} too, so the key stops there — see the module note. `onEscape` is\n * read live, so it need not be memoised; the layer is pushed and popped only when\n * `open` flips.\n */\nexport function useDismissLayer(open: boolean, onEscape: (e: KeyboardEvent) => void): void {\n  const handlerRef = useRef(onEscape);\n  // Written in an effect, not during render, so it satisfies react-hooks/refs: a\n  // render that React starts and then discards — a transition, a Suspense retry —\n  // would otherwise leave this holding a handler from a tree that never committed,\n  // and the stack would go on to call it. Keydown events fire after the commit, so\n  // the ref is always current by the time one arrives.\n  useEffect(() => {\n    handlerRef.current = onEscape;\n  });\n  useEffect(() => {\n    if (!open || typeof document === \"undefined\") return;\n    const layer: Layer = { escape: (e) => handlerRef.current(e) };\n    push(layer);\n    return () => pop(layer);\n  }, [open]);\n}\n\n/**\n * For a layer's own element, in its `onKeyDown`: hands an Escape on its way up to the\n * topmost layer — this one, unless something opened over it without taking focus (a\n * tooltip, the numpad) — and stops it here. True when it did; false for any other key,\n * a claimed Escape, or one already handed over.\n */\nexport function takeEscape(e: KeyboardEvent | ReactKeyboardEvent): boolean {\n  return handOver(e, true);\n}\n\n/**\n * For an Escape that means \"undo this step\", not \"close\": the key is the caller's, and\n * no layer is handed it. `preventDefault()`s it as well, so a handler further out that\n * checks `defaultPrevented` leaves it alone, as before.\n */\nexport function claimEscape(e: KeyboardEvent | ReactKeyboardEvent): void {\n  claimed.add(nativeOf(e));\n  e.preventDefault();\n}\n\n/**\n * Runs a layer owner's own key handler — a dialog's `onKeyDown` prop — and turns a\n * `preventDefault()` it makes on Escape into a claim: the one way, beside\n * {@link claimEscape}, to keep a layer open.\n */\nexport function runOwnKeyDown<E extends ReactKeyboardEvent>(e: E, handler: ((e: E) => void) | undefined): void {\n  if (!handler) return;\n  const before = e.defaultPrevented;\n  handler(e);\n  if (e.key === \"Escape\" && !before && e.defaultPrevented) claimed.add(nativeOf(e));\n}\n\n/**\n * Calls `handler` on an Escape while `enabled` — as an Escape layer. Since 0.34 this is\n * {@link useDismissLayer} with its arguments the other way round: it hears the key only\n * while nothing opened above it, and inside a dialog it no longer loses the key to the\n * dialog (Wave 2, DUP-1). `handler` is read live, so it need not be memoised.\n */\nexport function useEscapeKey(handler: () => void, enabled = true): void {\n  useDismissLayer(enabled, handler);\n}\n\n/**\n * Calls `handler` on a press that lands outside every supplied element, while\n * `enabled` — the outside-click-to-close half of the same dismissal story. Pass one\n * ref or several (trigger + panel); a press inside any of them is ignored. Refs and\n * `handler` are read live, so an inline `[triggerRef, panelRef]` array is fine and\n * won't churn the listener.\n *\n * **`pointerdown`, not `mousedown`** — one event covering mouse, touch and pen.\n * This listened for `mousedown` alone, which on a touch platform is a SYNTHESISED\n * event: the browser emits it for most taps, which is why nothing obviously broke,\n * but the synthesis is not guaranteed. A tap that begins a scroll, or one that lands\n * on an element which preventDefaults the touch sequence, may never produce one — and\n * on a phone-first PWA whose pickers, menus and flyouts all dismiss through this hook,\n * inheriting that is worse than choosing it.\n *\n * The one behaviour this changes deliberately: a touch-drag that starts outside an\n * open panel now dismisses it at touch-down, where before it did not dismiss at all\n * (a drag synthesises no mousedown). That matches every other platform surface, and\n * the anchored panels re-measure on scroll precisely because the page moves under\n * them.\n */\nexport function useOutsideClick(\n  refs: RefObject<HTMLElement | null> | RefObject<HTMLElement | null>[],\n  handler: () => void,\n  enabled = true,\n): void {\n  const refsRef = useRef(refs);\n  const handlerRef = useRef(handler);\n  // In an effect rather than during render — see the note in useDismissLayer.\n  useEffect(() => {\n    refsRef.current = refs;\n    handlerRef.current = handler;\n  });\n  useEffect(() => {\n    if (!enabled) return;\n    const onPointerDown = (e: Event) => {\n      const target = e.target as Node;\n      const list = Array.isArray(refsRef.current) ? refsRef.current : [refsRef.current];\n      for (const r of list) {\n        if (r.current?.contains(target)) return;\n      }\n      handlerRef.current();\n    };\n    document.addEventListener(\"pointerdown\", onPointerDown);\n    return () => document.removeEventListener(\"pointerdown\", onPointerDown);\n  }, [enabled]);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/hooks/use-dismiss.ts"],"sourcesContent":["import { useEffect, useRef } from \"react\";\nimport type { KeyboardEvent as ReactKeyboardEvent, RefObject } from \"react\";\nimport { isComposing } from \"../lib/ime\";\n\n/*\n * # One Escape stack (round 0.34 Wave 2, DUP-1)\n *\n * Escape closes the TOPMOST thing on screen, and only that: a list open in a dialog\n * closes and the dialog stays; the next press closes the dialog.\n *\n * \"Who owns Escape\" used to be decided five ways. The anchored pickers listened on the\n * document; Modal, FullBleedDialog, PickerSheet and Popover closed in their own panel's\n * `onKeyDown` and stopped the key; CommandPalette closed without stopping it. A dialog's\n * handler sits earlier on the key's path than any document listener, so Escape in an\n * open list inside a Modal closed the MODAL and threw the form away (BUG-1, sev 4,\n * kastlan's lease dialog), and HoverMenu, the numpad and a tooltip could not be\n * dismissed inside a dialog at all. And Modal and FullBleedDialog disagreed on when a\n * child had \"claimed\" the key: a ChipInput clearing its draft kept a Modal open and\n * closed a FullBleedDialog.\n *\n * Now every overlay and picker pushes a layer while it is open ({@link useDismissLayer}),\n * last in, first out, the way `use-overlay-history` stacks the Back gesture. One\n * capture-phase listener on the document notes which layer is on top as each Escape\n * goes down — before any handler on the page runs, so a layer that closes on the way\n * cannot pass the key on to the one beneath it. That layer, and only that one, is\n * handed the key:\n *\n * - at the first layer element the key passes on its way back up ({@link takeEscape},\n *   which Modal's panel, a picker's search box and the rest call from their\n *   `onKeyDown`). The key is stopped there, so nothing around the layers — a\n *   FloatingPanel, an app's own panel — closes with it;\n * - or, when focus is in none of them (a hover menu, a tooltip, the numpad over its\n *   field, a press on the page), at the document once the key has been everywhere else.\n *\n * Layers stack in the order they OPEN, which is the order their effects run. Two that\n * open in the same commit stack child first — the one case that order gets wrong, and\n * one no overlay in the kit does: each opens on a press, after whatever it sits in.\n *\n * ## Claiming the key: one rule\n *\n * An Escape that means \"undo this step\" is not a dismissal: ChipInput clearing its\n * draft, InlineEditField cancelling its edit, the date picker's month grid going back to\n * the days. Those call {@link claimEscape}, and no layer is handed the key. The only\n * other claim is the layer owner's OWN handler — a dialog's `onKeyDown` prop calling\n * `preventDefault()` on Escape (a busy reauth dialog holding itself open, Kurvenschmiede's\n * gear wizard asking first), through {@link runOwnKeyDown}. A `preventDefault()`\n * anywhere else claims nothing: a search box keeping Chromium from clearing itself\n * must not hold a dialog open (FullBleedDialog's 0.8.0 fix, which Modal never had).\n *\n * The owner's handler hears Escape only while its own layer is on top (0.35, KS). It\n * runs before the stack is asked, so with a tooltip, a hover menu or a list open over\n * the dialog and focus on the panel, the gear wizard asked \"Discard this gear?\" and the\n * tooltip stayed. Now the layer above takes that press, and the next one is the\n * owner's. Every other key reaches the handler as before.\n *\n * A handler that STOPS the key before it reaches a layer element has taken it too —\n * that is the DOM, and it is what the kit's cell editors and confirm buttons do.\n */\n\n/** A layer's handler, read through a ref so the stack holds one stable entry per open. */\ninterface Layer {\n  escape: (e: KeyboardEvent) => void;\n}\n\n/** What {@link useDismissLayer} hands back: its layer while open, for\n *  {@link runOwnKeyDown} to tell whether that layer is the one on top. */\nexport type DismissLayer = RefObject<Layer | null>;\n\n/** Open layers, oldest first. Module-level, because the order is ACROSS instances. */\nconst layers: Layer[] = [];\n\n/** Escapes a claimant has taken — see {@link claimEscape}. Weak: an event is garbage\n *  once its dispatch is over. */\nconst claimed = new WeakSet<Event>();\n\n/** The Escape on its way through the page: the layer that was topmost as it went down,\n *  and whether that layer has been handed it yet. */\nlet inFlight: { event: KeyboardEvent; layer: Layer; done: boolean } | null = null;\n\nfunction nativeOf(e: KeyboardEvent | ReactKeyboardEvent): KeyboardEvent {\n  return \"nativeEvent\" in e ? e.nativeEvent : e;\n}\n\nfunction onCapture(e: KeyboardEvent): void {\n  if (e.key !== \"Escape\") return;\n  // An Escape inside an IME composition cancels the composition and nothing else.\n  const top = isComposing(e) ? undefined : layers[layers.length - 1];\n  inFlight = top ? { event: e, layer: top, done: false } : null;\n}\n\n/** The fallback: no layer element was on the key's path, or none took it. */\nfunction onBubble(e: KeyboardEvent): void {\n  handOver(e, false);\n}\n\nfunction handOver(e: KeyboardEvent | ReactKeyboardEvent, stop: boolean): boolean {\n  const native = nativeOf(e);\n  const flight = inFlight;\n  if (native.key !== \"Escape\" || !flight || flight.event !== native || flight.done) return false;\n  if (claimed.has(native)) return false;\n  flight.done = true;\n  // Consumed: a type=\"search\" box does not clear itself as well, and a handler further\n  // out that checks `defaultPrevented` (FloatingPanel, an app's own panel) leaves it.\n  e.preventDefault();\n  if (stop) e.stopPropagation();\n  // A layer that closed on the way, by a handler of its own, has had its Escape.\n  if (layers.includes(flight.layer)) flight.layer.escape(native);\n  return true;\n}\n\nfunction push(layer: Layer): void {\n  if (layers.length === 0) {\n    document.addEventListener(\"keydown\", onCapture, true);\n    document.addEventListener(\"keydown\", onBubble);\n  }\n  layers.push(layer);\n}\n\nfunction pop(layer: Layer): void {\n  const at = layers.indexOf(layer);\n  if (at >= 0) layers.splice(at, 1);\n  if (layers.length > 0) return;\n  document.removeEventListener(\"keydown\", onCapture, true);\n  document.removeEventListener(\"keydown\", onBubble);\n  inFlight = null;\n}\n\n/**\n * An Escape layer on the stack while `open`: the topmost layer is handed the next\n * Escape and calls `onEscape`, every layer under it waits its turn. A list opened inside\n * a dialog is above the dialog; a popover opened from a list, above the list.\n *\n * Where focus can be INSIDE the layer, its element's `onKeyDown` calls\n * {@link takeEscape} too, so the key stops there — see the module note. `onEscape` is\n * read live, so it need not be memoised; the layer is pushed and popped only when\n * `open` flips. The layer it returns is for the owner's {@link runOwnKeyDown}.\n */\nexport function useDismissLayer(open: boolean, onEscape: (e: KeyboardEvent) => void): DismissLayer {\n  const handlerRef = useRef(onEscape);\n  const layerRef = useRef<Layer | null>(null);\n  // Written in an effect, not during render, so it satisfies react-hooks/refs: a\n  // render that React starts and then discards — a transition, a Suspense retry —\n  // would otherwise leave this holding a handler from a tree that never committed,\n  // and the stack would go on to call it. Keydown events fire after the commit, so\n  // the ref is always current by the time one arrives.\n  useEffect(() => {\n    handlerRef.current = onEscape;\n  });\n  useEffect(() => {\n    if (!open || typeof document === \"undefined\") return;\n    const layer: Layer = { escape: (e) => handlerRef.current(e) };\n    layerRef.current = layer;\n    push(layer);\n    return () => {\n      pop(layer);\n      layerRef.current = null;\n    };\n  }, [open]);\n  return layerRef;\n}\n\n/**\n * For a layer's own element, in its `onKeyDown`: hands an Escape on its way up to the\n * topmost layer — this one, unless something opened over it without taking focus (a\n * tooltip, the numpad) — and stops it here. True when it did; false for any other key,\n * a claimed Escape, or one already handed over.\n */\nexport function takeEscape(e: KeyboardEvent | ReactKeyboardEvent): boolean {\n  return handOver(e, true);\n}\n\n/**\n * For an Escape that means \"undo this step\", not \"close\": the key is the caller's, and\n * no layer is handed it. `preventDefault()`s it as well, so a handler further out that\n * checks `defaultPrevented` leaves it alone, as before.\n */\nexport function claimEscape(e: KeyboardEvent | ReactKeyboardEvent): void {\n  claimed.add(nativeOf(e));\n  e.preventDefault();\n}\n\n/**\n * Runs a layer owner's own key handler — a dialog's `onKeyDown` prop — and turns a\n * `preventDefault()` it makes on Escape into a claim: the one way, beside\n * {@link claimEscape}, to keep a layer open.\n *\n * Given the owner's `layer` (what {@link useDismissLayer} returned), an Escape that went\n * down while another layer was above that one skips the handler: the press is the\n * layer's on top, and the owner hears the next (0.35, KS). Without it, or while the\n * owner's layer is not open, the handler sees every key, as before.\n */\nexport function runOwnKeyDown<E extends ReactKeyboardEvent>(\n  e: E,\n  handler: ((e: E) => void) | undefined,\n  layer?: DismissLayer,\n): void {\n  if (!handler) return;\n  if (layer && aboveOwner(e, layer.current)) return;\n  const before = e.defaultPrevented;\n  handler(e);\n  if (e.key === \"Escape\" && !before && e.defaultPrevented) claimed.add(nativeOf(e));\n}\n\n/** Whether this Escape went down with a layer above `owner` — the topmost one then was\n *  another, and `owner` is on the stack. An Escape the stack did not note (one inside an\n *  IME composition) is nobody else's. */\nfunction aboveOwner(e: ReactKeyboardEvent, owner: Layer | null): boolean {\n  const flight = inFlight;\n  if (e.key !== \"Escape\" || !owner || !flight || flight.event !== nativeOf(e)) return false;\n  return flight.layer !== owner && layers.includes(owner);\n}\n\n/**\n * Calls `handler` on an Escape while `enabled` — as an Escape layer. Since 0.34 this is\n * {@link useDismissLayer} with its arguments the other way round: it hears the key only\n * while nothing opened above it, and inside a dialog it no longer loses the key to the\n * dialog (Wave 2, DUP-1). `handler` is read live, so it need not be memoised.\n */\nexport function useEscapeKey(handler: () => void, enabled = true): void {\n  useDismissLayer(enabled, handler);\n}\n\n/**\n * Calls `handler` on a press that lands outside every supplied element, while\n * `enabled` — the outside-click-to-close half of the same dismissal story. Pass one\n * ref or several (trigger + panel); a press inside any of them is ignored. Refs and\n * `handler` are read live, so an inline `[triggerRef, panelRef]` array is fine and\n * won't churn the listener.\n *\n * **`pointerdown`, not `mousedown`** — one event covering mouse, touch and pen.\n * This listened for `mousedown` alone, which on a touch platform is a SYNTHESISED\n * event: the browser emits it for most taps, which is why nothing obviously broke,\n * but the synthesis is not guaranteed. A tap that begins a scroll, or one that lands\n * on an element which preventDefaults the touch sequence, may never produce one — and\n * on a phone-first PWA whose pickers, menus and flyouts all dismiss through this hook,\n * inheriting that is worse than choosing it.\n *\n * The one behaviour this changes deliberately: a touch-drag that starts outside an\n * open panel now dismisses it at touch-down, where before it did not dismiss at all\n * (a drag synthesises no mousedown). That matches every other platform surface, and\n * the anchored panels re-measure on scroll precisely because the page moves under\n * them.\n */\nexport function useOutsideClick(\n  refs: RefObject<HTMLElement | null> | RefObject<HTMLElement | null>[],\n  handler: () => void,\n  enabled = true,\n): void {\n  const refsRef = useRef(refs);\n  const handlerRef = useRef(handler);\n  // In an effect rather than during render — see the note in useDismissLayer.\n  useEffect(() => {\n    refsRef.current = refs;\n    handlerRef.current = handler;\n  });\n  useEffect(() => {\n    if (!enabled) return;\n    const onPointerDown = (e: Event) => {\n      const target = e.target as Node;\n      const list = Array.isArray(refsRef.current) ? refsRef.current : [refsRef.current];\n      for (const r of list) {\n        if (r.current?.contains(target)) return;\n      }\n      handlerRef.current();\n    };\n    document.addEventListener(\"pointerdown\", onPointerDown);\n    return () => document.removeEventListener(\"pointerdown\", onPointerDown);\n  }, [enabled]);\n}\n"],"mappings":"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","names":[]}

package/dist/i18n/kit-labels.d.ts

@@ -562,10 +562,20 @@ export interface UiKitProviderProps {
  * the language.
  */
 export declare function UiKitProvider({ labels, locale, weekStartsOn, linkComponent, chartTooltipPlacement, formatDate, tableStorageKeyPrefix, children, }: UiKitProviderProps): import("react").JSX.Element;
-/** What the nearest provider says about one namespace — `undefined` outside one.
- *  For a component whose own resolver does more than a merge (the data table
- *  derives `columnsCount` from `columns`): feed `{ ...overrides, ...props }` to it. */
-export declare function useKitLabelOverrides<K extends keyof UiKitLabels>(ns: K): Partial<UiKitLabels[K]> | undefined;
+/**
+ * What the nearest provider says about one namespace — `undefined` outside one. Nested
+ * providers' words come merged, at every depth; no English default is filled in.
+ *
+ * A {@link LabelOverride}, partial at every depth, like the components' `labels` props
+ * that take it: a provider that names one key of a section (`accountSettings.passkeys`)
+ * or one preset (`dataTable.presets`) hands over just that (round 0.35 R3 — until then
+ * it was typed partial at the top only, so a nested section read as complete).
+ *
+ * For a component whose own resolver does more than a merge (the data table derives
+ * `columnsCount` from `columns`): merge the component's prop over it — a record key by
+ * key — and feed the result to that resolver.
+ */
+export declare function useKitLabelOverrides<K extends keyof UiKitLabels>(ns: K): LabelOverride<UiKitLabels[K]> | undefined;
 /**
  * One namespace, resolved: `defaults`, then the provider, then the component's own
  * `prop`. Record-valued keys are merged key by key at each step — so `prop` is a