@eifi1/ui-kit 0.33.1 → 0.34.0

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/feedback/feedback-record.ts"],"sourcesContent":["import { DEFAULT_ATTACHMENT_ACCEPT } from \"./feedback-attachment\";\nimport { FEEDBACK_CATEGORY_ORDER } from \"./feedback-inbox\";\nimport type { FeedbackCategory, FeedbackStatus } from \"./feedback-inbox\";\n\n/**\n * One feedback report as the three apps send it, and the facts the kit reads off it.\n *\n * Until 0.27 the inbox parts took no report at all (\"no `Feedback` type in this file\",\n * feedback-inbox.tsx): keksdose kept its reporter context in a JSON column, kastlan a\n * thinner copy of it, Kurvenschmiede a `page_path` and the bytes in the row. Marcel's\n * feedback round (2026-10-04, docs/feedback-harmonization.md) settled one API contract\n * for all three — keksdose's, read off its code — so the apps now share one shape and the\n * kit can take a row instead of a dozen loose values. This file is that shape (§3.1,\n * §3.2), the contract's constants (§3.4, §3.5, §4.3) and the readers and writers of the\n * one field whose format is itself contract: the body, which carries the rework rounds\n * (§3.4) — lifted from keksdose `frontend/src/features/feedback/body-attachments.ts`.\n *\n * Plain functions and data, no components: everything here is as usable from a loop\n * script's helper or a test as from a page.\n */\n\n/* ── The resource (§3.1, §3.2) ────────────────────────────────────────────── */\n\n/** Which copy of an app a report came from — keksdose `app/deploy-environment.ts`.\n *  Any other string is read as \"not prod\" (the admin list shows it upper-cased as a\n *  chip, §4.3), so an app with a `staging` loses nothing. */\nexport type FeedbackEnvironment = \"prod\" | \"dev\" | \"local\";\n\n/**\n * The reporter's context, written by the submit dialog (keksdose\n * `use-feedback-dialog.tsx:105`) — §3.2 of the contract.\n *\n * **Every key is optional on read**, and a reader treats a missing one as \"unknown\":\n * kastlan's client sends six of them (no email, no version), Kurvenschmiede's old rows are\n * backfilled from two columns with a path-only `url`, crash rows add their own (and\n * `origin` / `environment` from the crash payload, §3.6 — older crash rows have neither),\n * and an erased account's row keeps only an allow-list (§3.2: `environment` stays,\n * `origin` goes). Extra keys are allowed — a server may add its own — hence the index\n * signature.\n */\nexport interface FeedbackContext {\n  /** The full `location.href` at open time; `\"\"` when \"Attach current page URL\" was off.\n   *  Readers also accept a path-only value (Kurvenschmiede's backfilled rows). */\n  url?: string;\n  /** Its pathname; `\"\"` when the URL was withheld. */\n  route?: string;\n  /** `location.origin` — which copy of the app, not personal; never withheld. */\n  origin?: string;\n  /** {@link FeedbackEnvironment}, or whatever the app calls its other copies. */\n  environment?: FeedbackEnvironment | (string & {});\n  /** The submitter, as a snapshot. The server should overwrite the three `user_*` keys\n   *  from the session (Kurvenschmiede does), so nobody files in someone else's name. */\n  user_id?: number | null;\n  user_email?: string | null;\n  user_display_name?: string | null;\n  /** `\"406x816\"`. */\n  viewport?: string;\n  /** `navigator.userAgent`. */\n  ua?: string;\n  /** The app build (`__APP_VERSION__`). */\n  version?: string;\n  // Crash rows (server-written, keksdose `feedback_service.py:346`).\n  fingerprint?: string;\n  /** Which error boundary caught it. */\n  boundary?: \"app\" | \"page\" | (string & {});\n  online?: boolean;\n  occurrences?: number;\n  first_seen_at?: string;\n  last_seen_at?: string;\n  auto_reported?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * One report — `FeedbackResponse`, keksdose `schemas/feedback.py:117`, §3.1 of the\n * contract. What `GET /feedback`, `GET /feedback/my`, `POST /feedback` and\n * `PATCH /feedback/{id}` answer in all three apps.\n *\n * Extra fields are allowed and ignored (kastlan's `company_id`, `user_name`): an app's\n * own row type with more fields is assignable to this one as it stands.\n *\n * There is **no rework counter field** — {@link reworkCount} reads it off the body, so\n * nothing can forget to set it.\n */\nexport interface FeedbackRecord {\n  id: number;\n  /** `null`: the author's account was erased (keksdose live #275). */\n  user_id: number | null;\n  /** The admin list only (joined); `null` — or absent — on `/my`, create and update. */\n  user_email?: string | null;\n  /** 1–255 characters, never blank. */\n  title: string;\n  /** `\"\"` when none. Rework rounds are appended here (§3.4) — read it with\n   *  {@link splitDescription} / {@link splitBodyAttachments}, write it with\n   *  {@link appendRework} / {@link replaceDescription}. */\n  body: string;\n  category: FeedbackCategory;\n  status: FeedbackStatus;\n  /** §3.2; `null` on rows that have none. */\n  context: FeedbackContext | null;\n  /** The ONE captured screenshot's attachment URL, or `null`. */\n  screenshot_url: string | null;\n  /** Up to 5 other files; `null` = none. Optional because a server older than the\n   *  column sends no key at all (keksdose dev #578 met exactly that). */\n  attachment_urls?: string[] | null;\n  /** The team's answer; `null` = none written. */\n  outcome: string | null;\n  /** Set on ENTERING `DONE` / `WONT_DO`, cleared on leaving them. ISO 8601. */\n  resolved_at: string | null;\n  /** ISO 8601. */\n  created_at: string;\n  /** ISO 8601. */\n  updated_at: string;\n}\n\n/* ── Constants (§3.4, §3.5, §4.3) ─────────────────────────────────────────── */\n\n/**\n * What a report may carry (§3.5, keksdose `upload_guards.py:197` and its\n * `attachment-options.ts`): the kit's four image types plus a PDF and a plain-text log\n * (keksdose feedback #87). SVG and HTML stay out — both are script-carrying documents in\n * an image's clothing. For `FeedbackAttachmentField` / `FeedbackDialog`'s `accept`, with\n * `DEFAULT_MAX_ATTACHMENTS` (5) and `DEFAULT_MAX_ATTACHMENT_BYTES` (10 MB) from\n * feedback-attachment.tsx, which already are the contract's limits.\n *\n * A plain array (not frozen) because `accept` takes `string[]`, as\n * `DEFAULT_ATTACHMENT_ACCEPT` does — copy it before changing it.\n */\nexport const FEEDBACK_ATTACHMENT_ACCEPT: string[] = [\n  ...DEFAULT_ATTACHMENT_ACCEPT,\n  \"application/pdf\",\n  \"text/plain\",\n];\n\n/**\n * The categories a person can pick — every one but `CRASH`, in triage order (Bug, Idea,\n * Question, Other: the feedback menu's rows, §4.1). `CRASH` is filed by an error boundary\n * and the server refuses it by hand with a 422 (keksdose `_reject_manual_crash`), so no\n * picker may offer it.\n */\nexport const FEEDBACK_PICKABLE_CATEGORIES: readonly FeedbackCategory[] = Object.freeze(\n  FEEDBACK_CATEGORY_ORDER.filter((category) => category !== \"CRASH\"),\n);\n\n/**\n * The statuses a report can be sent back for **rework** from (§3.4): everything the team\n * has answered — `IN_EVALUATION`, `NEEDS_LIVE_TEST`, `POSTPONED`, `DONE`, `WONT_DO`. On\n * these the server reopens the row when the body grows by a rework block; on `OPEN` /\n * `IN_PROGRESS` there is nothing to send back yet.\n */\nexport const FEEDBACK_REWORKABLE_STATUSES: readonly FeedbackStatus[] = Object.freeze([\n  \"IN_EVALUATION\",\n  \"NEEDS_LIVE_TEST\",\n  \"POSTPONED\",\n  \"DONE\",\n  \"WONT_DO\",\n] as const);\n\n/**\n * The statuses in which the AUTHOR may still edit title, body and category (§3.4,\n * keksdose `canAuthorEdit`, `feedback-page.tsx:398`): `OPEN`, `READY` and `IN_PROGRESS`.\n * Once the team has answered, the description is what they answered and stays as it\n * was; a correction goes in as a rework.\n */\nexport const FEEDBACK_AUTHOR_EDITABLE_STATUSES: readonly FeedbackStatus[] = Object.freeze([\n  \"OPEN\",\n  \"READY\",\n  \"IN_PROGRESS\",\n] as const);\n\n/**\n * The statuses that wait on the person triaging: filed and not yet triaged (`OPEN`,\n * since READY took over \"released for implementation\" in 0.31, feedback contract §8.2),\n * answered and handed back for a verdict, or answered and only checkable on a deployed\n * build (keksdose `AWAITING_VERDICT`, live #330). The phone's \"Only what is waiting for\n * you\" toggle narrows the inbox to exactly these (§4.3).\n */\nexport const FEEDBACK_AWAITING_STATUSES: readonly FeedbackStatus[] = Object.freeze([\n  \"OPEN\",\n  \"IN_EVALUATION\",\n  \"NEEDS_LIVE_TEST\",\n] as const);\n\n/* ── The body (§3.4) ──────────────────────────────────────────────────────── */\n\n/**\n * The path every app serves attachments under (§3.3), and a key after it. Keys are\n * OPAQUE (§3.5): keksdose and Kurvenschmiede content-address (`<sha12>.<ext>`), kastlan's\n * storage keys are `<uuid32>_<sha12>.<ext>` — so `[\\w.-]+`, never a fixed hex shape.\n */\nconst ATTACHMENT_URL = /^\\/api\\/v1\\/feedback\\/attachments\\/[\\w.-]+$/;\n\n/**\n * One file line in a body. The marker is deliberately narrow — this path and nothing\n * else, alone on its line — so no sentence a user writes can be mistaken for one\n * (keksdose live #291). It says `[screenshot]` for a PDF or a text log too: the name is\n * history, the format is contract.\n */\nconst ATTACHMENT_LINE = /^\\[screenshot\\]\\s+(\\/api\\/v1\\/feedback\\/attachments\\/[\\w.-]+)\\s*$/;\n\n/**\n * The `--- REWORK <stamp> ---` rule a rework opens with. Anchored and whole-line for the\n * same reason as the file marker: \"I did a REWORK --- honestly\" is a sentence, not a\n * round. kastlan's folded `--- COMMENT <stamp> · <name> ---` blocks (§7.7) never match.\n */\nconst REWORK_RULE = /^---\\s*REWORK\\b.*---$/;\n\n/** Any appended block's opening rule: a rework round, or a kastlan comment folded into\n *  the body by its one-time migration (§7.7). */\nconst BLOCK_RULE = /^---\\s*(?:REWORK|COMMENT)\\b.*---$/;\n\n/** The body line for one uploaded attachment — what {@link appendRework} writes under\n *  the note. */\nexport function feedbackAttachmentLine(url: string): string {\n  return `[screenshot] ${url}`;\n}\n\n/**\n * A rework round appended to a body — the exact text `PATCH /feedback/{id}` takes as the\n * new `body` (§3.4; keksdose `submitRework`, `feedback-page.tsx:350`):\n *\n * ```text\n * <old body>\\n\\n--- REWORK 2026-10-04 09:12 ---\\n<note>\\n[screenshot] /api/v1/feedback/attachments/<key>\n * ```\n *\n * - The stamp is UTC, `YYYY-MM-DD HH:MM` (`toISOString().slice(0, 16)`), from `now`.\n * - The old body is kept byte for byte, so the result STRICTLY EXTENDS it — which is\n *   how the server recognises an append and reopens an answered row (keksdose\n *   `_is_rework_append`, live #331). `\\n\\n` is left out when the old body is `\"\"`.\n * - ONE file per round (`url`), uploaded first by the caller: a body appended without\n *   it would be a rework whose evidence never arrived.\n *\n * **Returns `null` when the trimmed note is empty** — a file alone cannot be sent\n * (keksdose `:577`). Null rather than a throw because an empty note is something a\n * person does, not a bug, and the type then makes every caller decide what an empty\n * box means before anything can reach the PATCH.\n *\n * **Throws a `TypeError` when `url` is not an attachment URL** of the contract's shape\n * (`/api/v1/feedback/attachments/<key>`): that one IS a bug — the upload handed back\n * something foreign — and written anyway it would sit in the body as prose that no\n * reader recognises as a file.\n */\nexport function appendRework(\n  body: string,\n  note: string,\n  url?: string | null,\n  now: Date = new Date(),\n): string | null {\n  const text = note.trim();\n  if (!text) return null;\n  if (url && !ATTACHMENT_URL.test(url)) {\n    throw new TypeError(`appendRework: not a feedback attachment URL: ${url}`);\n  }\n  const stamp = now.toISOString().slice(0, 16).replace(\"T\", \" \");\n  const block = `--- REWORK ${stamp} ---\\n${url ? `${text}\\n${feedbackAttachmentLine(url)}` : text}`;\n  return body ? `${body}\\n\\n${block}` : block;\n}\n\n/**\n * How many times a report has been sent back — the count of `--- REWORK … ---` rule\n * lines in its body (keksdose live #331: the \"category for items in rework\", derived\n * rather than stored, so nothing can forget to set it or leave it set). Folded kastlan\n * comments do not count.\n */\nexport function reworkCount(body: string): number {\n  let n = 0;\n  for (const line of body.split(\"\\n\")) if (REWORK_RULE.test(line.trim())) n += 1;\n  return n;\n}\n\n/**\n * A body split into the prose to render and the files to show beside it, in body order.\n *\n * The file lines are stripped from the text: they are a location, not something anybody\n * wrote, and left in they would put a raw URL in the middle of a sentence. Trailing blank\n * lines go (what a stripped marker leaves at the end of a note); every blank line between\n * paragraphs stays.\n */\nexport function splitBodyAttachments(body: string): { text: string; urls: string[] } {\n  const urls: string[] = [];\n  const kept: string[] = [];\n  for (const line of body.split(\"\\n\")) {\n    const match = ATTACHMENT_LINE.exec(line.trim());\n    if (match) urls.push(match[1]);\n    else kept.push(line);\n  }\n  return { text: kept.join(\"\\n\").replace(/\\n+$/, \"\"), urls };\n}\n\n/** A body cut where its first appended block begins. */\nfunction cutAtFirstBlock(body: string): { head: string; appended: string } {\n  const lines = body.split(\"\\n\");\n  const at = lines.findIndex((line) => BLOCK_RULE.test(line.trim()));\n  if (at === -1) return { head: body, appended: \"\" };\n  return { head: lines.slice(0, at).join(\"\\n\"), appended: lines.slice(at).join(\"\\n\") };\n}\n\n/**\n * The ORIGINAL description, apart from everything appended to it since (§4.4.1).\n *\n * - `description` — what the author wrote when filing, without its file lines and\n *   trailing blank lines: the text the \"Edit description\" editor holds.\n * - `appended` — every `--- REWORK … ---` round and folded `--- COMMENT … ---` block,\n *   from the first one's rule line to the end, verbatim (`\"\"` when there are none).\n *\n * keksdose's editor edits the raw body (`initial={fb.body}`, `feedback-page.tsx:420`), so\n * an author tidying a typo could delete the rework history and the file lines with it.\n * The kit's editor holds `description` only and saves through\n * {@link replaceDescription}, which puts the rest back unchanged.\n */\nexport function splitDescription(body: string): { description: string; appended: string } {\n  const { head, appended } = cutAtFirstBlock(body);\n  return { description: splitBodyAttachments(head).text, appended };\n}\n\n/**\n * The body with its original description replaced and everything else kept — the file\n * lines of the original part (after the new text, in their order) and the appended\n * blocks (verbatim, after a blank line). The new text is trimmed; clearing it saves the\n * rest alone (`\"\"` when there is no rest).\n *\n * `replaceDescription(body, splitDescription(body).description)` gives back a canonical\n * body unchanged — a trimmed description, then each block after one blank line, as the\n * dialog and {@link appendRework} write them.\n */\nexport function replaceDescription(body: string, description: string): string {\n  const { head, appended } = cutAtFirstBlock(body);\n  const files = splitBodyAttachments(head).urls.map(feedbackAttachmentLine);\n  const text = description.trim();\n  const top = [...(text ? [text] : []), ...files].join(\"\\n\");\n  if (!appended) return top;\n  return top ? `${top}\\n\\n${appended}` : appended;\n}\n\n/**\n * Whether an attachment URL is a picture (keksdose dev #578). The upload route takes\n * PDFs and text logs too and serves them as downloads, never inline, so an `<img>` on\n * one shows a broken icon. The key's extension is the server's own statement of the\n * type (minted from the sniffed content), so it is the thing to read.\n */\nexport function isImageAttachment(url: string): boolean {\n  return /\\.(png|jpe?g|webp|gif)$/i.test(url);\n}\n\n/** The file name an attachment downloads as — its key, the last segment of the URL. */\nexport function attachmentName(url: string): string {\n  return url.slice(url.lastIndexOf(\"/\") + 1);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/feedback/feedback-record.ts"],"sourcesContent":["import { FEEDBACK_CATEGORY_ORDER } from \"./feedback-vocabulary\";\nimport type { FeedbackCategory, FeedbackStatus } from \"./feedback-vocabulary\";\n\n/**\n * One feedback report as the three apps send it, and the facts the kit reads off it.\n *\n * Until 0.27 the inbox parts took no report at all (\"no `Feedback` type in this file\",\n * feedback-inbox.tsx): keksdose kept its reporter context in a JSON column, kastlan a\n * thinner copy of it, Kurvenschmiede a `page_path` and the bytes in the row. Marcel's\n * feedback round (2026-10-04, docs/feedback-harmonization.md) settled one API contract\n * for all three — keksdose's, read off its code — so the apps now share one shape and the\n * kit can take a row instead of a dozen loose values. This file is that shape (§3.1,\n * §3.2), the contract's constants (§3.4, §3.5, §4.3) and the readers and writers of the\n * one field whose format is itself contract: the body, which carries the rework rounds\n * (§3.4) — lifted from keksdose `frontend/src/features/feedback/body-attachments.ts`.\n *\n * Plain functions and data, no components: everything here is as usable from a loop\n * script's helper or a test as from a page.\n */\n\n/* ── The resource (§3.1, §3.2) ────────────────────────────────────────────── */\n\n/** Which copy of an app a report came from — keksdose `app/deploy-environment.ts`.\n *  Any other string is read as \"not prod\" (the admin list shows it upper-cased as a\n *  chip, §4.3), so an app with a `staging` loses nothing. */\nexport type FeedbackEnvironment = \"prod\" | \"dev\" | \"local\";\n\n/**\n * The reporter's context, written by the submit dialog (keksdose\n * `use-feedback-dialog.tsx:105`) — §3.2 of the contract.\n *\n * **Every key is optional on read**, and a reader treats a missing one as \"unknown\":\n * kastlan's client sends six of them (no email, no version), Kurvenschmiede's old rows are\n * backfilled from two columns with a path-only `url`, crash rows add their own (and\n * `origin` / `environment` from the crash payload, §3.6 — older crash rows have neither),\n * and an erased account's row keeps only an allow-list (§3.2: `environment` stays,\n * `origin` goes). Extra keys are allowed — a server may add its own — hence the index\n * signature.\n */\nexport interface FeedbackContext {\n  /** The full `location.href` at open time; `\"\"` when \"Attach current page URL\" was off.\n   *  Readers also accept a path-only value (Kurvenschmiede's backfilled rows). */\n  url?: string;\n  /** Its pathname; `\"\"` when the URL was withheld. */\n  route?: string;\n  /** `location.origin` — which copy of the app, not personal; never withheld. */\n  origin?: string;\n  /** {@link FeedbackEnvironment}, or whatever the app calls its other copies. */\n  environment?: FeedbackEnvironment | (string & {});\n  /** The submitter, as a snapshot. The server should overwrite the three `user_*` keys\n   *  from the session (Kurvenschmiede does), so nobody files in someone else's name. */\n  user_id?: number | null;\n  user_email?: string | null;\n  user_display_name?: string | null;\n  /** `\"406x816\"`. */\n  viewport?: string;\n  /** `navigator.userAgent`. */\n  ua?: string;\n  /** The app build (`__APP_VERSION__`). */\n  version?: string;\n  // Crash rows (server-written, keksdose `feedback_service.py:346`).\n  fingerprint?: string;\n  /** Which error boundary caught it. */\n  boundary?: \"app\" | \"page\" | (string & {});\n  online?: boolean;\n  occurrences?: number;\n  first_seen_at?: string;\n  last_seen_at?: string;\n  auto_reported?: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * One report — `FeedbackResponse`, keksdose `schemas/feedback.py:117`, §3.1 of the\n * contract. What `GET /feedback`, `GET /feedback/my`, `POST /feedback` and\n * `PATCH /feedback/{id}` answer in all three apps.\n *\n * Extra fields are allowed and ignored (kastlan's `company_id`, `user_name`): an app's\n * own row type with more fields is assignable to this one as it stands.\n *\n * There is **no rework counter field** — {@link reworkCount} reads it off the body, so\n * nothing can forget to set it.\n */\nexport interface FeedbackRecord {\n  id: number;\n  /** `null`: the author's account was erased (keksdose live #275). */\n  user_id: number | null;\n  /** The admin list only (joined); `null` — or absent — on `/my`, create and update. */\n  user_email?: string | null;\n  /** 1–255 characters, never blank. */\n  title: string;\n  /** `\"\"` when none. Rework rounds are appended here (§3.4) — read it with\n   *  {@link splitDescription} / {@link splitBodyAttachments}, write it with\n   *  {@link appendRework} / {@link replaceDescription}. */\n  body: string;\n  category: FeedbackCategory;\n  status: FeedbackStatus;\n  /** §3.2; `null` on rows that have none. */\n  context: FeedbackContext | null;\n  /** The ONE captured screenshot's attachment URL, or `null`. */\n  screenshot_url: string | null;\n  /** Up to 5 other files; `null` = none. Optional because a server older than the\n   *  column sends no key at all (keksdose dev #578 met exactly that). */\n  attachment_urls?: string[] | null;\n  /** The team's answer; `null` = none written. */\n  outcome: string | null;\n  /** Set on ENTERING `DONE` / `WONT_DO`, cleared on leaving them. ISO 8601. */\n  resolved_at: string | null;\n  /** ISO 8601. */\n  created_at: string;\n  /** ISO 8601. */\n  updated_at: string;\n}\n\n/* ── Constants (§3.4, §3.5, §4.3) ─────────────────────────────────────────── */\n\n// The attachment field's three defaults live here, not in feedback-attachment.tsx\n// (which re-exports them), since 0.34 (MOD-1, refactor audit 2026-10). This module is in\n// every app's top bar (the menu's categories), and FEEDBACK_ATTACHMENT_ACCEPT below is\n// built on DEFAULT_ATTACHMENT_ACCEPT: imported from the field's module, it tied the top\n// bar to the field, the lazily loaded dialog's heaviest part, for three values.\n\n/** The image types `FeedbackAttachmentField` takes when `accept` is not given. */\nexport const DEFAULT_ATTACHMENT_ACCEPT = [\"image/png\", \"image/jpeg\", \"image/webp\", \"image/gif\"];\n/** 10 MB, the contract's size limit for one file (§3.5). */\nexport const DEFAULT_MAX_ATTACHMENT_BYTES = 10 * 1024 * 1024;\n/** How many files `<FeedbackAttachmentField multiple>` takes when `max` is not given\n *  (0.15.5). Five photos of one problem is already a lot to look through; a report\n *  that needs more is a conversation, which the thread is for. */\nexport const DEFAULT_MAX_ATTACHMENTS = 5;\n\n/**\n * What a report may carry (§3.5, keksdose `upload_guards.py:197` and its\n * `attachment-options.ts`): the kit's four image types plus a PDF and a plain-text log\n * (keksdose feedback #87). SVG and HTML stay out — both are script-carrying documents in\n * an image's clothing. For `FeedbackAttachmentField` / `FeedbackDialog`'s `accept`, with\n * `DEFAULT_MAX_ATTACHMENTS` (5) and `DEFAULT_MAX_ATTACHMENT_BYTES` (10 MB) above, which\n * already are the contract's limits.\n *\n * A plain array (not frozen) because `accept` takes `string[]`, as\n * `DEFAULT_ATTACHMENT_ACCEPT` does — copy it before changing it.\n */\nexport const FEEDBACK_ATTACHMENT_ACCEPT: string[] = [\n  ...DEFAULT_ATTACHMENT_ACCEPT,\n  \"application/pdf\",\n  \"text/plain\",\n];\n\n/**\n * The categories a person can pick — every one but `CRASH`, in triage order (Bug, Idea,\n * Question, Other: the feedback menu's rows, §4.1). `CRASH` is filed by an error boundary\n * and the server refuses it by hand with a 422 (keksdose `_reject_manual_crash`), so no\n * picker may offer it.\n */\nexport const FEEDBACK_PICKABLE_CATEGORIES: readonly FeedbackCategory[] = Object.freeze(\n  FEEDBACK_CATEGORY_ORDER.filter((category) => category !== \"CRASH\"),\n);\n\n/**\n * The statuses a report can be sent back for **rework** from (§3.4): everything the team\n * has answered — `IN_EVALUATION`, `NEEDS_LIVE_TEST`, `POSTPONED`, `DONE`, `WONT_DO`. On\n * these the server reopens the row when the body grows by a rework block; on `OPEN`,\n * `READY` and `IN_PROGRESS` there is nothing to send back yet.\n */\nexport const FEEDBACK_REWORKABLE_STATUSES: readonly FeedbackStatus[] = Object.freeze([\n  \"IN_EVALUATION\",\n  \"NEEDS_LIVE_TEST\",\n  \"POSTPONED\",\n  \"DONE\",\n  \"WONT_DO\",\n] as const);\n\n/**\n * The statuses in which the AUTHOR may still edit title, body and category (§3.4,\n * keksdose `canAuthorEdit`, `feedback-page.tsx:398`): `OPEN`, `READY` and `IN_PROGRESS`.\n * Once the team has answered, the description is what they answered and stays as it\n * was; a correction goes in as a rework.\n */\nexport const FEEDBACK_AUTHOR_EDITABLE_STATUSES: readonly FeedbackStatus[] = Object.freeze([\n  \"OPEN\",\n  \"READY\",\n  \"IN_PROGRESS\",\n] as const);\n\n/**\n * The statuses that wait on the person triaging: filed and not yet triaged (`OPEN`,\n * since READY took over \"released for implementation\" in 0.31, feedback contract §8.2),\n * answered and handed back for a verdict, or answered and only checkable on a deployed\n * build (keksdose `AWAITING_VERDICT`, live #330). The phone's \"Only what is waiting for\n * you\" toggle narrows the inbox to exactly these (§4.3).\n */\nexport const FEEDBACK_AWAITING_STATUSES: readonly FeedbackStatus[] = Object.freeze([\n  \"OPEN\",\n  \"IN_EVALUATION\",\n  \"NEEDS_LIVE_TEST\",\n] as const);\n\n/* ── The body (§3.4) ──────────────────────────────────────────────────────── */\n\n/**\n * The path every app serves attachments under (§3.3), and a key after it. Keys are\n * OPAQUE (§3.5): keksdose and Kurvenschmiede content-address (`<sha12>.<ext>`), kastlan's\n * storage keys are `<uuid32>_<sha12>.<ext>` — so `[\\w.-]+`, never a fixed hex shape.\n */\nconst ATTACHMENT_URL = /^\\/api\\/v1\\/feedback\\/attachments\\/[\\w.-]+$/;\n\n/**\n * One file line in a body. The marker is deliberately narrow — this path and nothing\n * else, alone on its line — so no sentence a user writes can be mistaken for one\n * (keksdose live #291). It says `[screenshot]` for a PDF or a text log too: the name is\n * history, the format is contract.\n */\nconst ATTACHMENT_LINE = /^\\[screenshot\\]\\s+(\\/api\\/v1\\/feedback\\/attachments\\/[\\w.-]+)\\s*$/;\n\n/**\n * The `--- REWORK <stamp> ---` rule a rework opens with. Anchored and whole-line for the\n * same reason as the file marker: \"I did a REWORK --- honestly\" is a sentence, not a\n * round. kastlan's folded `--- COMMENT <stamp> · <name> ---` blocks (§7.7) never match.\n */\nconst REWORK_RULE = /^---\\s*REWORK\\b.*---$/;\n\n/** Any appended block's opening rule: a rework round, or a kastlan comment folded into\n *  the body by its one-time migration (§7.7). */\nconst BLOCK_RULE = /^---\\s*(?:REWORK|COMMENT)\\b.*---$/;\n\n/** The body line for one uploaded attachment — what {@link appendRework} writes under\n *  the note. */\nexport function feedbackAttachmentLine(url: string): string {\n  return `[screenshot] ${url}`;\n}\n\n/**\n * A rework round appended to a body — the exact text `PATCH /feedback/{id}` takes as the\n * new `body` (§3.4; keksdose `submitRework`, `feedback-page.tsx:350`):\n *\n * ```text\n * <old body>\\n\\n--- REWORK 2026-10-04 09:12 ---\\n<note>\\n[screenshot] /api/v1/feedback/attachments/<key>\n * ```\n *\n * - The stamp is UTC, `YYYY-MM-DD HH:MM` (`toISOString().slice(0, 16)`), from `now`.\n * - The old body is kept byte for byte, so the result STRICTLY EXTENDS it — which is\n *   how the server recognises an append and reopens an answered row (keksdose\n *   `_is_rework_append`, live #331). `\\n\\n` is left out when the old body is `\"\"`.\n * - ONE file per round (`url`), uploaded first by the caller: a body appended without\n *   it would be a rework whose evidence never arrived.\n *\n * **Returns `null` when the trimmed note is empty** — a file alone cannot be sent\n * (keksdose `:577`). Null rather than a throw because an empty note is something a\n * person does, not a bug, and the type then makes every caller decide what an empty\n * box means before anything can reach the PATCH.\n *\n * **Throws a `TypeError` when `url` is not an attachment URL** of the contract's shape\n * (`/api/v1/feedback/attachments/<key>`): that one IS a bug — the upload handed back\n * something foreign — and written anyway it would sit in the body as prose that no\n * reader recognises as a file.\n */\nexport function appendRework(\n  body: string,\n  note: string,\n  url?: string | null,\n  now: Date = new Date(),\n): string | null {\n  const text = note.trim();\n  if (!text) return null;\n  if (url && !ATTACHMENT_URL.test(url)) {\n    throw new TypeError(`appendRework: not a feedback attachment URL: ${url}`);\n  }\n  const stamp = now.toISOString().slice(0, 16).replace(\"T\", \" \");\n  const block = `--- REWORK ${stamp} ---\\n${url ? `${text}\\n${feedbackAttachmentLine(url)}` : text}`;\n  return body ? `${body}\\n\\n${block}` : block;\n}\n\n/**\n * How many times a report has been sent back — the count of `--- REWORK … ---` rule\n * lines in its body (keksdose live #331: the \"category for items in rework\", derived\n * rather than stored, so nothing can forget to set it or leave it set). Folded kastlan\n * comments do not count.\n */\nexport function reworkCount(body: string): number {\n  let n = 0;\n  for (const line of body.split(\"\\n\")) if (REWORK_RULE.test(line.trim())) n += 1;\n  return n;\n}\n\n/**\n * A body split into the prose to render and the files to show beside it, in body order.\n *\n * The file lines are stripped from the text: they are a location, not something anybody\n * wrote, and left in they would put a raw URL in the middle of a sentence. Trailing blank\n * lines go (what a stripped marker leaves at the end of a note); every blank line between\n * paragraphs stays.\n */\nexport function splitBodyAttachments(body: string): { text: string; urls: string[] } {\n  const urls: string[] = [];\n  const kept: string[] = [];\n  for (const line of body.split(\"\\n\")) {\n    const match = ATTACHMENT_LINE.exec(line.trim());\n    if (match) urls.push(match[1]);\n    else kept.push(line);\n  }\n  return { text: kept.join(\"\\n\").replace(/\\n+$/, \"\"), urls };\n}\n\n/** A body cut where its first appended block begins. */\nfunction cutAtFirstBlock(body: string): { head: string; appended: string } {\n  const lines = body.split(\"\\n\");\n  const at = lines.findIndex((line) => BLOCK_RULE.test(line.trim()));\n  if (at === -1) return { head: body, appended: \"\" };\n  return { head: lines.slice(0, at).join(\"\\n\"), appended: lines.slice(at).join(\"\\n\") };\n}\n\n/**\n * The ORIGINAL description, apart from everything appended to it since (§4.4.1).\n *\n * - `description` — what the author wrote when filing, without its file lines and\n *   trailing blank lines: the text the \"Edit description\" editor holds.\n * - `appended` — every `--- REWORK … ---` round and folded `--- COMMENT … ---` block,\n *   from the first one's rule line to the end, verbatim (`\"\"` when there are none).\n *\n * keksdose's editor edits the raw body (`initial={fb.body}`, `feedback-page.tsx:420`), so\n * an author tidying a typo could delete the rework history and the file lines with it.\n * The kit's editor holds `description` only and saves through\n * {@link replaceDescription}, which puts the rest back unchanged.\n */\nexport function splitDescription(body: string): { description: string; appended: string } {\n  const { head, appended } = cutAtFirstBlock(body);\n  return { description: splitBodyAttachments(head).text, appended };\n}\n\n/**\n * The body with its original description replaced and everything else kept — the file\n * lines of the original part (after the new text, in their order) and the appended\n * blocks (verbatim, after a blank line). The new text is trimmed; clearing it saves the\n * rest alone (`\"\"` when there is no rest).\n *\n * `replaceDescription(body, splitDescription(body).description)` gives back a canonical\n * body unchanged — a trimmed description, then each block after one blank line, as the\n * dialog and {@link appendRework} write them.\n */\nexport function replaceDescription(body: string, description: string): string {\n  const { head, appended } = cutAtFirstBlock(body);\n  const files = splitBodyAttachments(head).urls.map(feedbackAttachmentLine);\n  const text = description.trim();\n  const top = [...(text ? [text] : []), ...files].join(\"\\n\");\n  if (!appended) return top;\n  return top ? `${top}\\n\\n${appended}` : appended;\n}\n\n/**\n * Whether an attachment URL is a picture (keksdose dev #578). The upload route takes\n * PDFs and text logs too and serves them as downloads, never inline, so an `<img>` on\n * one shows a broken icon. The key's extension is the server's own statement of the\n * type (minted from the sniffed content), so it is the thing to read.\n */\nexport function isImageAttachment(url: string): boolean {\n  return /\\.(png|jpe?g|webp|gif)$/i.test(url);\n}\n\n/** The file name an attachment downloads as — its key, the last segment of the URL. */\nexport function attachmentName(url: string): string {\n  return url.slice(url.lastIndexOf(\"/\") + 1);\n}\n"],"mappings":"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","names":[]}

package/dist/feedback/feedback-row-detail-labels.d.ts

@@ -0,0 +1,2 @@
+import type { FeedbackDetailLabels } from "./feedback-row-detail.js";
+export declare const DEFAULT_FEEDBACK_DETAIL_LABELS: FeedbackDetailLabels;

package/dist/feedback/feedback-row-detail-labels.js

@@ -0,0 +1,31 @@
+"use client";
+const DEFAULT_FEEDBACK_DETAIL_LABELS = {
+  subject: "Subject",
+  body: "Description",
+  edit: "Edit",
+  editDescription: "Edit description",
+  save: "Save",
+  cancel: "Cancel",
+  url: "URL",
+  copyUrl: "Copy URL",
+  attachment: "Attachment",
+  download: (name) => `Download ${name}`,
+  downloadFailed: "The attachment could not be downloaded.",
+  outcome: "Outcome",
+  resolvedAt: (date) => `Resolved: ${date}`,
+  outcomeAdd: "Add outcome",
+  outcomeUpdate: "Update",
+  outcomePlaceholder: "What was done, decided, or why this won't be addressed.",
+  rework: "Rework",
+  openPage: "Open page",
+  reworkTitle: "Send for rework",
+  reworkSend: "Send rework",
+  reworkPlaceholder: "What still needs refinement? Any new constraints or change of direction.",
+  reworkUploadFailed: "The file could not be uploaded. The rework was not sent.",
+  status: "Status",
+  note: "Note"
+};
+export {
+  DEFAULT_FEEDBACK_DETAIL_LABELS
+};
+//# sourceMappingURL=feedback-row-detail-labels.js.map

package/dist/feedback/feedback-row-detail-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/feedback/feedback-row-detail-labels.ts"],"sourcesContent":["// The English words of ./feedback-row-detail, in a module with no component code: the\n// English catalogue (src/i18n/defaults.ts) imports them without the component, so `en`\n// loads as one chunk like the other languages (0.34, KS U8). ./feedback-row-detail\n// re-exports them.\n\nimport type { FeedbackDetailLabels } from \"./feedback-row-detail\";\n\nexport const DEFAULT_FEEDBACK_DETAIL_LABELS: FeedbackDetailLabels = {\n  subject: \"Subject\",\n  body: \"Description\",\n  edit: \"Edit\",\n  editDescription: \"Edit description\",\n  save: \"Save\",\n  cancel: \"Cancel\",\n  url: \"URL\",\n  copyUrl: \"Copy URL\",\n  attachment: \"Attachment\",\n  download: (name) => `Download ${name}`,\n  downloadFailed: \"The attachment could not be downloaded.\",\n  outcome: \"Outcome\",\n  resolvedAt: (date) => `Resolved: ${date}`,\n  outcomeAdd: \"Add outcome\",\n  outcomeUpdate: \"Update\",\n  outcomePlaceholder: \"What was done, decided, or why this won't be addressed.\",\n  rework: \"Rework\",\n  openPage: \"Open page\",\n  reworkTitle: \"Send for rework\",\n  reworkSend: \"Send rework\",\n  reworkPlaceholder: \"What still needs refinement? Any new constraints or change of direction.\",\n  reworkUploadFailed: \"The file could not be uploaded. The rework was not sent.\",\n  status: \"Status\",\n  note: \"Note\",\n};\n"],"mappings":";AAOO,MAAM,iCAAuD;AAAA,EAClE,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AAAA,EACN,iBAAiB;AAAA,EACjB,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,KAAK;AAAA,EACL,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,UAAU,CAAC,SAAS,YAAY,IAAI;AAAA,EACpC,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,YAAY,CAAC,SAAS,aAAa,IAAI;AAAA,EACvC,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,oBAAoB;AAAA,EACpB,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,mBAAmB;AAAA,EACnB,oBAAoB;AAAA,EACpB,QAAQ;AAAA,EACR,MAAM;AACR;","names":[]}

package/dist/feedback/feedback-row-detail.d.ts

@@ -1,101 +1,315 @@
-import 'react';
-import '../hooks/use-authed-src.js';
-export { i as DEFAULT_FEEDBACK_DETAIL_LABELS, a5 as FeedbackDetailLabels, a6 as FeedbackDetailPatch, a8 as FeedbackDetailUpdate, au as FeedbackReworkSection, av as FeedbackReworkSectionProps, aw as FeedbackRowAccess, ax as FeedbackRowDetail, ay as FeedbackRowDetailProps, aW as FeedbackUpload, a$ as feedbackAttachmentUrls, b5 as feedbackPageHref, b6 as feedbackPagePath, b7 as feedbackPageUrl, b8 as feedbackRowAccess, bm as useFeedbackDetailLabels } from '../delete-account-setting-DAgGBrbn.js';
-import '../components/write-lock.js';
-import '../components/tooltip.js';
-import '../hooks/use-anchored-rect.js';
-import '../lib/clipping.js';
-import '../data-table-labels-BJ5JE_X2.js';
-import '../components/data-table-sort.js';
-import '../components/swipeable-row.js';
-import '../components/status-dot.js';
-import '../components/progress-bar.js';
-import '../components/signed-amount.js';
-import '../components/stat-tile.js';
-import '../components/chip.js';
-import 'lucide-react';
-import '../components/field-parts.js';
-import '../components/mini-calendar.js';
-import '../components/calendar-heatmap.js';
-import '../components/popover.js';
-import '../hooks/use-breakpoint.js';
-import '../components/field-sync.js';
-import '../wizard/types.js';
-import '../tour/tour.js';
-import '../search/command-palette.js';
-import '../search/global-search.js';
-import '../search/search-index.js';
-import '../components/month-picker.js';
-import '../components/page-contents.js';
-import '../components/series-chart-labels.js';
-import '../components/pie-chart-labels.js';
-import '../components/sparkline.js';
-import '../components/signature-pad.js';
-import '../components/password-strength.js';
-import '../components/swatch-picker.js';
-import '../components/tile-radio.js';
-import '../components/icon-picker.js';
-import '../components/dialog-frame.js';
-import '../components/modal.js';
-import '../hooks/use-search-param-state.js';
-import '../components/measured-grid.js';
-import '../components/user-avatar.js';
-import '../lib/person-name.js';
-import '../shell/topbar-action-menu.js';
-import '../components/menu-item.js';
-import '../components/floating-panel.js';
-import '../components/account-settings-labels.js';
-import '../components/bulk-action-bar.js';
-import '../components/list.js';
-import '../components/breadcrumbs.js';
-import '../components/toast.js';
-import '../components/description-list.js';
-import '../components/line-items.js';
-import '../components/error-boundary.js';
-import '../components/authed-image.js';
-import '../components/image-grid.js';
-import '../components/lightbox.js';
-import '../auth/sign-in-form.js';
-import '../landing/access.js';
-import '../landing/landing-labels.js';
-import '../shell/topbar-controls.js';
-import '../theme/palette-presets.js';
-import '../theme/chart-palette.js';
-import '../theme/theme-store.js';
-import 'zustand/middleware';
-import 'zustand';
-import '../auth/complete-name-dialog.js';
-import '../auth/forgot-password-form.js';
-import '../auth/status-parts.js';
-import '../auth/reset-password-form.js';
-import '../auth/verify-email.js';
-import '../auth/not-found-page.js';
-import '../auth/accept-invitation.js';
-import '../shell/company-switcher.js';
-import '../account/email-change-setting.js';
-import '../account/sessions-setting.js';
-import '../lib/format.js';
-import '../account/data-export-setting.js';
-import '../components/account-chips.js';
-import '../admin/admin-parts.js';
-import '../admin/admin-action-log.js';
-import '../settings/settings-labels.js';
-import '../demo/demo-labels.js';
-import '../i18n/plurals.js';
-import '../components/appearance-labels.js';
-import '../theme/contrast.js';
-import '../theme/text-size.js';
-import '../components/reauth-dialog.js';
-import '../components/server-wake.js';
-import '../lib/server-wake.js';
-import '../components/translation-review-labels.js';
-import '../lib/translation-review.js';
-import '../components/country-select.js';
-import '../components/inline-edit-field.js';
-import '../lib/iban.js';
-import '../lib/phone.js';
-import '../components/sign-chip.js';
-import '../components/column-mapper.js';
-import '../lib/column-mapping.js';
-import '../lib/table-text.js';
-import '../components/focus-ring.js';
+import type { AuthedFetcher } from "../hooks/use-authed-src.js";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import type { FeedbackNoteAttachment, FeedbackStatus } from "./feedback-inbox.js";
+import type { FeedbackContext, FeedbackRecord } from "./feedback-record.js";
+import type { FeedbackStatusChange } from "./feedback-status-undo.js";
+import type { CommitScope } from "../components/write-lock.js";
+import { DEFAULT_FEEDBACK_DETAIL_LABELS } from "./feedback-row-detail-labels.js";
+/**
+ * One report, opened — the panel a feedback table unfolds under its row (§4.4 of
+ * docs/feedback-harmonization.md), lifted from keksdose's `FeedbackRow`
+ * (`frontend/src/features/feedback/feedback-page.tsx:329-612`) with the contract's
+ * changes applied.
+ *
+ * Until 0.27 each app wrote this panel itself out of the kit's shell
+ * (`FeedbackDetail` / `FeedbackDetailSection` / `FeedbackNoteEditor`), and the three
+ * copies had drifted in exactly the places a user notices:
+ *
+ * - **the description editor held the raw body** — keksdose `initial={fb.body}`
+ *   (`:420`), kastlan the same (`pages/feedback-page.tsx:226`) — so an author fixing a
+ *   typo could delete the `--- REWORK … ---` rounds and the `[screenshot]` file lines
+ *   with it, and the history was gone. Here the editor holds the ORIGINAL description
+ *   only ({@link splitDescription}) and saves through {@link replaceDescription}, which
+ *   puts every appended block and file line back unchanged;
+ * - **kastlan's rework sent `status: "OPEN"`** from the client (`:189-195`) and offered it
+ *   on three statuses; keksdose sends the body alone and lets the server reopen the row
+ *   on five (live #331). The contract is keksdose's (§3.4) — {@link appendRework}, one
+ *   file, the server reopens;
+ * - **kastlan showed only `screenshot_url`** (`:265-276`) and no downloads; keksdose the
+ *   screenshot, the other files and the rework pictures, a PDF as a download (dev #578);
+ * - **the URL fell away on Kurvenschmiede's rows**, whose backfilled `context.url` is a
+ *   path (`/accounts?p=2`): keksdose's `new URL(…)` throws on one and the section
+ *   vanished. kastlan already fell back to `context.route` (`feedbackRaw`, `:97`).
+ *
+ * The sections, in the contract's order: **Subject** (the category and the title, §8.1;
+ * `showSubject={false}` leaves it out), **Description** (the body; the author's
+ * Edit while OPEN / READY / IN_PROGRESS), **URL**, **Attachment**, **Outcome** (the admin's
+ * outcome editor, Rework, Open page), **Send for rework** (only while reworking) and
+ * **Status**. No comment thread (§2.2: kastlan's comments fold into the body, §7.7).
+ *
+ * The app keeps its data and its API: the row it renders, the PATCH (`onUpdate`), the
+ * upload (`onUpload`), the authenticated GET (`fetcher`) and who is looking (`canEdit`,
+ * `viewerId`). Every word is the kit's `feedbackDetail` namespace.
+ */
+/**
+ * `feedbackDetail` — the row detail's words (§4.4). English: keksdose's `en.json`
+ * (`feedback.*`, `common.*`, `more.copy_url`) with the contract's changes; the de-CH
+ * canon (keksdose `de-CH.json`, ss never ß, "Nacharbeit" throughout — §7.14) on each key.
+ */
+export interface FeedbackDetailLabels {
+    /** The first section's heading: what the report is called (feedback contract §8.1,
+     *  keksdose live #395 — with the row expanded and the table scrolled, nothing said
+     *  which entry was being answered). de-CH: "Betreff" */
+    subject: string;
+    /** The description section's heading — keksdose's `feedback.body` (§7.3). The dialog's field asks
+     *  "What happened? (optional)"; the description, once filed, is headed as what it is
+     *  — and as the author's "Edit description" calls it. de-CH: "Beschreibung" */
+    body: string;
+    /** The author's button on that heading. de-CH: "Bearbeiten" */
+    edit: string;
+    /** Its accessible name — says WHAT is edited; contains the visible word.
+     *  de-CH: "Beschreibung bearbeiten" */
+    editDescription: string;
+    /** The editors' save button (description, outcome). de-CH: "Speichern" */
+    save: string;
+    /** Every editor's cancel button. de-CH: "Abbrechen" */
+    cancel: string;
+    /** Section 2's heading. de-CH: "URL" */
+    url: string;
+    /** The copy button beside the link — copies the FULL `context.url`.
+     *  de-CH: "URL kopieren" */
+    copyUrl: string;
+    /** Section 3's heading, and each picture's alt text. de-CH: "Anhang" */
+    attachment: string;
+    /** A PDF's / text file's download button, given the file's name.
+     *  de-CH: "{{name}} herunterladen" */
+    download: (name: string) => string;
+    /** The toast when that download failed. de-CH: "Der Anhang konnte nicht
+     *  heruntergeladen werden." */
+    downloadFailed: string;
+    /** Section 4's heading. de-CH: "Ergebnis" */
+    outcome: string;
+    /** On section 4's heading line once the row is settled, given the formatted
+     *  `resolved_at` date. de-CH: "Erledigt am: {{date}}" */
+    resolvedAt: (date: string) => string;
+    /** The admin's button while there is no outcome. de-CH: "Ergebnis hinzufügen" */
+    outcomeAdd: string;
+    /** The same button once there is one. de-CH: "Aktualisieren" */
+    outcomeUpdate: string;
+    /** The line above the outcome editor. de-CH: "Was wurde umgesetzt, entschieden oder
+     *  warum nicht." */
+    outcomePlaceholder: string;
+    /** The button that opens section 5 on an answered row. de-CH: "Nacharbeit" */
+    rework: string;
+    /** The link to the page the report was filed on. de-CH: "Seite öffnen" */
+    openPage: string;
+    /** Section 5's heading. de-CH: "Zur Nacharbeit senden" */
+    reworkTitle: string;
+    /** Section 5's send button. de-CH: "Nacharbeit senden" */
+    reworkSend: string;
+    /** The line above the rework note. de-CH: "Was muss noch angepasst werden? Neue
+     *  Anforderungen oder Richtungswechsel." */
+    reworkPlaceholder: string;
+    /** The toast when the rework's file did not upload — and so nothing was sent. Names
+     *  no screenshot: it fires for a PDF or a log too (§7.14; keksdose's said
+     *  "screenshot"). de-CH: "Die Datei konnte nicht hochgeladen werden. Die Nacharbeit
+     *  wurde nicht gesendet." */
+    reworkUploadFailed: string;
+    /** Section 6's heading. de-CH: "Status" */
+    status: string;
+    /** A `FeedbackNoteEditor`'s box, named when no `placeholder` line names it and the
+     *  caller gives no `label` — without it the box was read out as just "edit text"
+     *  (round 0.34, the showcase's axe check). de-CH: "Notiz" */
+    note: string;
+}
+export { DEFAULT_FEEDBACK_DETAIL_LABELS };
+/** `feedbackDetail` resolved: English, then `<UiKitProvider labels>`, then `labels`. */
+export declare function useFeedbackDetailLabels(labels?: LabelOverride<FeedbackDetailLabels>): FeedbackDetailLabels;
+/**
+ * The in-app link to the page a report was filed on — path + query + hash (keksdose
+ * `localHref`: the query and hash carry the state worth restoring, `?tab=import`, a
+ * drill-down). Read from `context.url`, else `context.route`; a path-only `url` works.
+ * Always a path on THIS app, never another origin's address, so it is safe as an
+ * `href` whatever the row says. `null` when there is nothing to link.
+ */
+export declare function feedbackPageHref(context: FeedbackContext | null | undefined): string | null;
+/** The page's path alone — the compact text a URL column shows (§4.3). */
+export declare function feedbackPagePath(context: FeedbackContext | null | undefined): string | null;
+/**
+ * What "Copy URL" copies: the FULL `context.url` as the reporter's browser had it —
+ * origin included, which is the one part that says which copy of the app it was
+ * (feedback #278) — else `context.route`. `null` when there is no page.
+ */
+export declare function feedbackPageUrl(context: FeedbackContext | null | undefined): string | null;
+/**
+ * Every file a report carries, in the order the detail shows them (§4.4.3): the
+ * screenshot it was filed with, then its other files, then whatever the rework rounds
+ * brought, in body order (keksdose dev #578, live #291). One list rather than three —
+ * a reader looking for "the picture" should not have to know at which point in the
+ * conversation it was taken.
+ *
+ * Each URL once: keksdose and Kurvenschmiede content-address their keys, so the same
+ * screenshot pasted twice is one URL — shown twice it is the same picture twice (and,
+ * keyed by URL, a React key clash keksdose had).
+ */
+export declare function feedbackAttachmentUrls(row: Pick<FeedbackRecord, "screenshot_url" | "attachment_urls" | "body">): string[];
+/** What the person looking at a row may do with it — {@link feedbackRowAccess}. */
+export interface FeedbackRowAccess {
+    /** The viewer filed it (`viewerId === row.user_id`; never for an erased author). */
+    isAuthor: boolean;
+    /** "Edit description": the author, while the row is OPEN, READY or IN_PROGRESS — on either
+     *  page (keksdose `canAuthorEdit`, `feedback-page.tsx:398`, is not gated on `mine`). */
+    canEditDescription: boolean;
+    /** The outcome editor: the admin on the inbox (`canEdit`). */
+    canEditOutcome: boolean;
+    /** "Rework": the admin or the author, on an answered row
+     *  ({@link FEEDBACK_REWORKABLE_STATUSES}) — §3.4, anyone else gets the server's 403. */
+    canRework: boolean;
+    /** The status pills: the admin on the inbox; everyone else sees them read-only. */
+    canChangeStatus: boolean;
+}
+/**
+ * The detail's permission rules in one place — the same answers the server gives
+ * (§3.4), so the panel never offers what the PATCH would refuse.
+ *
+ * `canEdit` is the app's "admin on `/feedback`": an admin on `/my-feedback` edits no
+ * status and no outcome there (§4.3), but as the author still edits the description
+ * and sends for rework. `viewerId` is the signed-in user's id.
+ */
+export declare function feedbackRowAccess(row: Pick<FeedbackRecord, "user_id" | "status">, { canEdit, viewerId }: {
+    canEdit: boolean;
+    viewerId?: number | null;
+}): FeedbackRowAccess;
+/** What the detail sends as `PATCH /feedback/{id}` (§3.4): the body (a description
+ *  edit, a rework append) or the outcome — and, through {@link useFeedbackStatusUndo}
+ *  when no `statusChange` is given, the status. Never two at once: a rework PATCH must
+ *  carry the body ALONE for the server to read it as an append (keksdose live #331). */
+export interface FeedbackDetailPatch {
+    id: number;
+    body?: string;
+    /** `null` clears it — a real edit. */
+    outcome?: string | null;
+    status?: FeedbackStatus;
+}
+/**
+ * The page's update mutation. **TanStack Query's `mutate` fits as it stands** — pass
+ * `update.mutate` (and `pending={update.isPending}`), the same function
+ * `useFeedbackStatusUndo` takes. A hand-written one sends the PATCH and calls
+ * `onSuccess` once it has landed, and only then: that is when an editor closes. A
+ * failure is the mutation's own to toast — the server's `detail`, else
+ * `feedbackToast.updateFailed` (§4.4) — and leaves the editor open with its draft.
+ */
+export type FeedbackDetailUpdate = (patch: FeedbackDetailPatch, callbacks: {
+    onSuccess: () => void;
+}) => void;
+/** `POST /feedback/attachments` (§3.3): one file up, its URL
+ *  (`/api/v1/feedback/attachments/<key>`) back. Reject on failure. */
+export type FeedbackUpload = (file: File) => Promise<string>;
+export interface FeedbackReworkSectionProps {
+    /** The row being sent back: its id, and the body the round is appended to. */
+    row: Pick<FeedbackRecord, "id" | "body">;
+    /** The PATCH — see {@link FeedbackDetailUpdate}. Called with `{ id, body }` only. */
+    onUpdate: FeedbackDetailUpdate;
+    /** The PATCH is in flight (`update.isPending`). The upload adds its own. */
+    pending?: boolean;
+    /** The upload. Left out, the note goes without a file field. */
+    onUpload?: FeedbackUpload;
+    /** Snapshot the app view as a File — the kit's `captureAppScreenshot`, or the app's
+     *  own. A "Capture screenshot" button appears only with it; a rejection (no
+     *  `modern-screenshot`, a canvas that would not draw) toasts
+     *  `feedbackToast.captureFailed` and adds nothing. */
+    onCaptureScreenshot?: () => Promise<File | null>;
+    /** The round landed — the server has the note and, on an answered row, reopened it. */
+    onSent?: () => void;
+    onCancel: () => void;
+    /** Over the field's defaults: the contract's types and 10 MB (§3.5), the
+     *  `feedbackToast` refusals, the `feedbackAttachment` words. */
+    attachment?: Partial<FeedbackNoteAttachment>;
+    /** The send COMMITS — see `FeedbackNoteEditor`'s `commit`. */
+    commit?: CommitScope;
+    labels?: LabelOverride<FeedbackDetailLabels>;
+}
+/**
+ * The rework editor (§4.4.5): the submitter — or the admin — sends an answered report
+ * back with a note and at most one file, and the server reopens it (§3.4, keksdose
+ * `submitRework`, `feedback-page.tsx:350`).
+ *
+ * - **The note is required** and trimmed: Send stays disabled on a blank box (a file
+ *   alone cannot be sent; keksdose `:577` dropped that click silently).
+ * - **One file**, added, captured or pasted — the dialog's types and 10 MB. It is
+ *   uploaded FIRST and awaited: a body naming a file that never arrived would be a
+ *   rework whose evidence is missing, and the upload is the half that fails on its
+ *   own. If it fails nothing is sent and the toast says so; the note stays in the box.
+ * - **The body alone goes in the PATCH** — {@link appendRework}'s strict extension of
+ *   the current body, which is how the server recognises the append and reopens the
+ *   row. Never a `status` (kastlan's client sent `OPEN`; an author may not write one,
+ *   so the server refused the whole PATCH, note and all — keksdose live #331).
+ *
+ * Exported on its own for an app that offers rework somewhere other than the row
+ * detail. Kurvenschmiede's author verdict ("That is it, done") is NOT here: an answered
+ * item stays answered unless its author sends it back (§7.2).
+ */
+export declare function FeedbackReworkSection({ row, onUpdate, pending, onUpload, onCaptureScreenshot, onSent, onCancel, attachment, commit, labels: labelsProp, }: FeedbackReworkSectionProps): import("react").JSX.Element;
+export interface FeedbackRowDetailProps {
+    /** The report — the list's own row, as `GET /feedback` / `GET /feedback/my` sent it. */
+    row: FeedbackRecord;
+    /** The admin on the inbox (`/feedback`): status pills and the outcome editor. `false`
+     *  on `/my-feedback`, for an admin too (§4.3). */
+    canEdit: boolean;
+    /** The signed-in user's id — who the AUTHOR is: the description editor and rework. */
+    viewerId?: number | null;
+    /** The page's PATCH — `update.mutate` (see {@link FeedbackDetailUpdate}). */
+    onUpdate: FeedbackDetailUpdate;
+    /** `update.isPending`: the editors' save buttons wait for it. */
+    pending?: boolean;
+    /** `POST /feedback/attachments` for the rework's one file. Left out, a rework is a
+     *  note alone. */
+    onUpload?: FeedbackUpload;
+    /** The app's authenticated GET (`AuthedImage`'s) — the pictures and the downloads go
+     *  through it, since the attachment route wants the bearer token (§3.5). Left out,
+     *  the browser's own fetch with same-origin cookies. */
+    fetcher?: AuthedFetcher | null;
+    /**
+     * The undoable status change — what `useFeedbackStatusUndo(update.mutate)` returns,
+     * the SAME one the table's status cell and the swipes use (§4.5). Left out, the
+     * detail builds one from `onUpdate`, which is equivalent as long as `onUpdate` is the
+     * page's mutation (its observer outlives the row a status filter removes).
+     */
+    statusChange?: FeedbackStatusChange;
+    /** For the rework's "Capture screenshot" — see {@link FeedbackReworkSectionProps}. */
+    onCaptureScreenshot?: () => Promise<File | null>;
+    /** The rework's file field, over the contract's defaults. */
+    reworkAttachment?: Partial<FeedbackNoteAttachment>;
+    /** How the `resolved_at` date reads — the app's date cell, as a string. Default: the
+     *  kit's `formatDate` in the provider's locale, `medium` style. */
+    renderDate?: (iso: string) => string;
+    /**
+     * The detail's saves COMMIT (description, outcome, rework, status): under a locked
+     * `WriteLockProvider` each is `aria-disabled` with the lock's reason, and nothing
+     * reaches `onUpdate`. Off by default — keksdose's shell lock is a read-only demo
+     * BUDGET, and a person viewing one still owns their own reports.
+     */
+    commit?: CommitScope;
+    /**
+     * Open with the subject: the category badge and the title (feedback contract §8.1,
+     * keksdose live #395). On by default; `false` for a page that already shows the title
+     * beside the detail.
+     */
+    showSubject?: boolean;
+    labels?: LabelOverride<FeedbackDetailLabels>;
+    className?: string;
+}
+/**
+ * The expanded row of a feedback table (§4.4): what was reported, where, with which
+ * files, what the answer was, and where it stands — with the edits each viewer may
+ * make. Hand it to `DataTable`'s `expandedRow`:
+ *
+ * ```tsx
+ * const update = useMutation({ mutationFn: ({ id, ...patch }) => api.updateFeedback(id, patch),
+ *   onSuccess: invalidate, onError: (e) => toast.error(detailOf(e) ?? toastLabels.updateFailed) });
+ * const changeStatus = useFeedbackStatusUndo(update.mutate);
+ * <DataTable
+ *   isExpanded={(row) => expandedId === row.id}
+ *   expandedRow={(row) => (
+ *     <FeedbackRowDetail row={row} canEdit={isAdmin && !mine} viewerId={user?.id}
+ *       onUpdate={update.mutate} pending={update.isPending} statusChange={changeStatus}
+ *       onUpload={api.uploadFeedbackAttachment} fetcher={authedImageFetcher}
+ *       onCaptureScreenshot={captureAppScreenshot} />
+ *   )} … />
+ * ```
+ *
+ * Mounted only while its row is expanded, so which editor is open lives here, and
+ * collapsing the row closes it. Each editor is keyed by the row's id, so a draft is
+ * never thrown away by a list refresh under it.
+ */
+export declare function FeedbackRowDetail({ row, canEdit, viewerId, onUpdate, pending, onUpload, fetcher, statusChange, onCaptureScreenshot, reworkAttachment, renderDate, commit, showSubject, labels: labelsProp, className, }: FeedbackRowDetailProps): import("react").JSX.Element;