@eifi1/ui-kit 0.51.7 → 0.53.0

package/dist/lib/translation-review.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/translation-review.ts"],"sourcesContent":["/**\n * The pure half of an app's translation review (H1 in docs/i18n-harmonization.md): from\n * the strings the app ships and the verdicts its server stores to one row per (locale,\n * key) with a status — keksdose's `features/translations/translation-catalogue.ts` and\n * kastlan's copy of it, which had grown apart by a fifth status and a second kind of key.\n *\n * WHY THE STRINGS ARE THE CATALOGUE. Nothing on the server lists which strings exist: a\n * verdict only says what somebody thought of one. So the rows are built from what the app\n * ships — its locale bundles, kastlan's document texts, the kit's own words\n * (`kitLabelStrings`) — and the review can never offer a string users do not see. A\n * verdict is stored WITH the wording it was given on, and a string that changed since is\n * noticed by comparing the two: `changed`, read it again, whatever the verdict was.\n *\n * WHAT STAYS IN THE APP. Which locale is read against which (keksdose: everything against\n * English, English against de-CH; kastlan: against German, German against English), where\n * the strings come from, who may review what (the locales and areas its server answers\n * with), and every request. The kit takes those as input and never derives them.\n *\n * camelCase, like the rest of the kit. The contract's wire shape is snake_case\n * (`reference_text`, `reviewer_name`, `reviewed_at`); {@link fromApiReview} and\n * {@link toApiWrite} are the two lines each app would otherwise write — both apps speak\n * the same contract, so the mapping is written once, here.\n */\n\nimport { foldForSearch } from \"./text-match\";\n\n// ── Shapes ──────────────────────────────────────────────────────────────────────\n\nexport type TranslationVerdict = \"APPROVED\" | \"NEEDS_CHANGE\";\n\n/** One stored verdict: what a reviewer said about one string in one locale. */\nexport interface TranslationReview {\n  locale: string;\n  key: string;\n  /** The wording that was judged — compared with today's to notice a change. Empty for\n   *  a string the locale lacked (a suggested translation for a `missing` row). */\n  text: string;\n  /** The reference wording at the time. `null` from a server that did not store it. */\n  referenceText: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  /** The reviewer's wording — or, for a missing string, the translation to add. */\n  suggestion: string | null;\n  /** `null` once the reviewer's account has been erased. */\n  reviewerName: string | null;\n  /** ISO timestamp. */\n  reviewedAt: string;\n}\n\n/** What a save sends: the verdict plus the wording it is given on. */\nexport interface TranslationReviewWrite {\n  locale: string;\n  key: string;\n  text: string;\n  referenceText: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  suggestion: string | null;\n}\n\n/** What a reset sends: back to \"unreviewed\". */\nexport interface TranslationReviewKey {\n  locale: string;\n  key: string;\n}\n\n/**\n * Where a string stands, in the order a reviewer works through them: what is not there\n * at all, what nobody has read, what changed after it was read, what was sent back, and\n * what is done. `missing` never occurs for an app whose locales have every key\n * (keksdose); kastlan's French lacks 172 screen texts.\n */\nexport type ReviewStatus = \"missing\" | \"unreviewed\" | \"changed\" | \"needs_change\" | \"approved\";\n\nexport const REVIEW_STATUSES: readonly ReviewStatus[] = [\n  \"missing\",\n  \"unreviewed\",\n  \"changed\",\n  \"needs_change\",\n  \"approved\",\n];\n\nexport interface TranslationRow {\n  /** `${locale}|${key}` — unique across every locale on a page. A bar, not a colon:\n   *  kastlan's keys contain colons (`common:actions.save`). */\n  id: string;\n  key: string;\n  /** The key's group: `budget` for `budget.rta`, `common` for `common:actions.save`,\n   *  `kit` for the kit's own words. See {@link keyNamespace}. */\n  namespace: string;\n  /** Where the string comes from, in the app's own words — kastlan's `screen` and\n   *  `documents`, keksdose's one source. `\"\"` when the app does not say. */\n  source: string;\n  locale: string;\n  /** The wording users see today; empty when the locale lacks the string. */\n  text: string;\n  /** The same key in the reference locale. */\n  reference: string;\n  status: ReviewStatus;\n  review: TranslationReview | null;\n  /** The interpolations and tags differ from the reference's — `{{count}}` dropped, a\n   *  `<1>` link lost, a `{date}` renamed. A machine can check that much, so it does,\n   *  before a person reads. Never set on a missing string: it has nothing to lose. */\n  placeholderMismatch: boolean;\n}\n\n// ── The wire contract ───────────────────────────────────────────────────────────\n\n/** A verdict as `GET /translations/reviews` returns it (H1's shared contract). Typed\n *  structurally, so an app's generated OpenAPI type fits without a cast. */\nexport interface ApiTranslationReview {\n  locale: string;\n  key: string;\n  text: string;\n  reference_text: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  suggestion: string | null;\n  reviewer_name: string | null;\n  /** server-kit 0.10: the name's two parts (`reviewer_name` is them in the reader's order). */\n  reviewer_first_name?: string | null;\n  reviewer_last_name?: string | null;\n  reviewed_at: string;\n}\n\n/** `GET /translations/reviews` (server-kit `TranslationReviewsResponse`): the locales and\n *  areas the caller may review (`areas` null: every area; `[\"kit\"]` for a review token)\n *  and every stored verdict in them. Typed structurally, as {@link ApiTranslationReview}. */\nexport interface ApiTranslationReviewsResponse {\n  locales: string[];\n  areas?: string[] | null;\n  reviews: ApiTranslationReview[];\n}\n\n/** One item of `PUT /translations/reviews`. */\nexport interface ApiTranslationReviewWrite {\n  locale: string;\n  key: string;\n  text: string;\n  reference_text: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  suggestion: string | null;\n}\n\n/** A verdict from the server, in the kit's spelling. */\nexport function fromApiReview(review: ApiTranslationReview): TranslationReview {\n  return {\n    locale: review.locale,\n    key: review.key,\n    text: review.text,\n    referenceText: review.reference_text,\n    verdict: review.verdict,\n    note: review.note,\n    suggestion: review.suggestion,\n    reviewerName: review.reviewer_name,\n    reviewedAt: review.reviewed_at,\n  };\n}\n\n/** A save, in the server's spelling. `TranslationReviewKey` needs no mapping — it is\n *  `{ locale, key }` on both sides. */\nexport function toApiWrite(write: TranslationReviewWrite): ApiTranslationReviewWrite {\n  return {\n    locale: write.locale,\n    key: write.key,\n    text: write.text,\n    reference_text: write.referenceText,\n    verdict: write.verdict,\n    note: write.note,\n    suggestion: write.suggestion,\n  };\n}\n\n// ── Strings ─────────────────────────────────────────────────────────────────────\n\n/**\n * A nested bundle as `key → string`, in the bundle's own order. Non-string leaves are\n * skipped rather than stringified into something nobody wrote.\n *\n * `prefix` is put in front of every key AS IS, so it names the separator too:\n * `flattenStrings(bundle)` is keksdose's `budget.rta`, `flattenStrings(tree, \"common:\")`\n * kastlan's `common:actions.save`, and `flattenStrings(kitLabelStrings(labels), \"kit.\")`\n * the kit's own words as `kit.combobox.resultCount(3)` — already flat, so only the prefix\n * is added.\n */\nexport function flattenStrings(tree: Readonly<Record<string, unknown>>, prefix = \"\"): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [key, value] of Object.entries(tree)) {\n    const path = `${prefix}${key}`;\n    if (typeof value === \"string\") out[path] = value;\n    else if (value && typeof value === \"object\" && !Array.isArray(value)) {\n      Object.assign(out, flattenStrings(value as Record<string, unknown>, `${path}.`));\n    }\n  }\n  return out;\n}\n\n/**\n * The key's group, for the namespace filter: the part before a colon when there is one\n * (kastlan's `common:actions.save` → `common`, `doc_text.invoice:due` →\n * `doc_text.invoice`), else the first dotted segment (keksdose's `budget.rta` →\n * `budget`, the kit's `kit.combobox.resultCount(3)` → `kit`). Only the part before a\n * sample's `(` is looked at, so a colon inside one cannot move the split.\n */\nexport function keyNamespace(key: string): string {\n  const head = key.split(\"(\", 1)[0];\n  const colon = head.indexOf(\":\");\n  return colon >= 0 ? head.slice(0, colon) : head.split(\".\", 1)[0];\n}\n\n// i18next `{{x}}` (formatting options ignored: `{{x, number}}` is `{{x}}`); a Python\n// format field `{x}` / `{0}` / `{amount:.2f}` (kastlan's document texts), but not a\n// LaTeX argument (`\\textbf{x}` — a letter or backslash right before the brace); a\n// numbered or named tag (`<1>`, `<strong>`), not prose in angle brackets (\"<deleted\n// user>\"); and a nested `$t(key)`. `{{x}}` is tried first at its position and consumed\n// whole, so it is never counted a second time as `{x}`.\nconst PLACEHOLDER_RE =\n  /\\{\\{\\s*([^}\\s,]+)[^}]*\\}\\}|(?<![\\\\A-Za-z])\\{([a-z_][a-z0-9_]*|\\d+)(?:[!:][^{}]*)?\\}|<\\/?(\\d+|[a-z][a-z0-9]*)\\s*\\/?>|\\$t\\(([^)]+)\\)/g;\n\n/** The placeholders in a string, as a sorted multiset: `{{count}}`, `{date}`, `<1>`,\n *  `$t(common.save)`. */\nexport function placeholderTokens(text: string): string[] {\n  const found: string[] = [];\n  for (const m of text.matchAll(PLACEHOLDER_RE)) {\n    if (m[1]) found.push(`{{${m[1]}}}`);\n    // `{ref:retention}` (ui-kit 0.28's legal cross-reference) keeps its target: a\n    // translation that points at another section changed what the sentence says. Every\n    // other `{x:spec}` is a format spec, which a translation may change.\n    else if (m[2]) found.push(m[2] === \"ref\" ? m[0] : `{${m[2]}}`);\n    else if (m[3]) found.push(`<${m[3]}>`);\n    else if (m[4]) found.push(`$t(${m[4]})`);\n  }\n  return found.sort();\n}\n\n/** Whether `text` has other placeholders than `reference` — dropped, renamed or added.\n *  Moving one is fine: a translation reorders a sentence. */\nexport function placeholderMismatch(text: string, reference: string): boolean {\n  const a = placeholderTokens(text);\n  const b = placeholderTokens(reference);\n  return a.length !== b.length || a.some((p, i) => p !== b[i]);\n}\n\n// ── Status ──────────────────────────────────────────────────────────────────────\n\n/**\n * A verdict counts only for the wording it was given on. If the string or its reference\n * changed since, it is `changed` — read it again — whatever the verdict was. A string the\n * locale lacks is `missing` until somebody suggests its translation (stored as\n * NEEDS_CHANGE on the empty text, so it reads `needs_change`, and `changed` once a\n * developer adds the string).\n */\nexport function reviewStatus(\n  review: TranslationReview | null | undefined,\n  text: string,\n  reference: string,\n): ReviewStatus {\n  if (!review) return text === \"\" && reference !== \"\" ? \"missing\" : \"unreviewed\";\n  if (review.text !== text) return \"changed\";\n  if (review.referenceText != null && review.referenceText !== reference) return \"changed\";\n  return review.verdict === \"APPROVED\" ? \"approved\" : \"needs_change\";\n}\n\n/**\n * Whether `key` lies in `area`: the key IS the area, or sits under it — `legal.terms`\n * and kastlan's `legal:terms` are in `legal`, `legalese.title` is not.\n *\n * 0.28: the kit's own words of that area too — `kit.legal.sections.terms.law.body(…)`\n * is in `legal`. All three apps list the kit's labels under `kit.`\n * (`flattenStrings(kitLabelStrings(labels), \"kit.\")`), and since 0.28 the kit writes\n * the shared legal sections, so a lawyer with a `[\"legal\"]` grant who was not shown\n * `kit.legal.*` would not see half of the Privacy Policy — and the server would refuse\n * the verdicts (docs/legal-harmonization.md §7.5). server-kit's `in_areas` and the apps'\n * copies of it apply the same rule.\n */\nexport function keyInArea(key: string, area: string): boolean {\n  return key === area || key.startsWith(`${area}.`) || key.startsWith(`${area}:`) || key.startsWith(`kit.${area}.`);\n}\n\n/**\n * The area of `areas` that `key` lies in ({@link keyInArea}), or `undefined` — the\n * translation page's grouping by the same rule the filter and the server use, so\n * `kit.legal.sections.privacy.rights.lead` is grouped under `legal` with the app's own\n * legal texts instead of under `kit.legal`:\n *\n *     const namespaceOf = (key: string) => reviewAreaOf(key, [\"legal\"]) ?? ownNamespaceOf(key);\n *\n * Where two areas both hold the key (`legal` and `legal.privacy`), the longer — the more\n * specific — wins, whatever their order. `inArea` is the app's own rule, as for\n * {@link keyInAreas}.\n */\nexport function reviewAreaOf(\n  key: string,\n  areas: readonly string[],\n  inArea: (key: string, area: string) => boolean = keyInArea,\n): string | undefined {\n  let found: string | undefined;\n  for (const area of areas) {\n    if (inArea(key, area) && (found === undefined || area.length > found.length)) found = area;\n  }\n  return found;\n}\n\n/**\n * Whether `key` lies in one of `areas` — the scope a reviewer may be limited to\n * (keksdose: `[\"legal\"]`, a lawyer who judges the Imprint, the Privacy Policy and the\n * Terms and sees nothing else). `null`/`undefined` is every area. The server applies the\n * same rule and refuses verdicts outside; this decides only what is listed.\n */\nexport function keyInAreas(\n  key: string,\n  areas: readonly string[] | null | undefined,\n  inArea: (key: string, area: string) => boolean = keyInArea,\n): boolean {\n  return !areas || areas.some((area) => inArea(key, area));\n}\n\nexport interface TranslationRowsInput {\n  locale: string;\n  /** The locale's strings, `key → text` ({@link flattenStrings}). */\n  strings: Readonly<Record<string, string>>;\n  /** The reference locale's strings — whichever locale THIS app reads `locale` against. */\n  reference: Readonly<Record<string, string>>;\n  /** The verdicts: this locale's by key, or the whole list as the server sent it (other\n   *  locales' verdicts are skipped). */\n  reviews?: ReadonlyMap<string, TranslationReview> | readonly TranslationReview[];\n  /** Default {@link keyNamespace}. */\n  namespaceOf?: (key: string) => string;\n  /** The row's source, an app-defined word (kastlan: `doc_text.` keys are `documents`,\n   *  the rest `screen`). Default: none (`\"\"`). */\n  sourceOf?: (key: string) => string;\n  /** Keep only keys inside these areas ({@link keyInAreas}); `null` keeps every key. */\n  areas?: readonly string[] | null;\n  /** Default {@link keyInArea}. */\n  inArea?: (key: string, area: string) => boolean;\n}\n\n/**\n * Every key of one locale, with its status: the reference's keys first, in its order, so\n * rows read the way the app's authors wrote them; a key only this locale has is appended\n * rather than dropped (a parity test should forbid it, but the page should not lie if one\n * slips through).\n */\nexport function translationRows({\n  locale,\n  strings,\n  reference,\n  reviews,\n  namespaceOf: groupOf = keyNamespace,\n  sourceOf,\n  areas,\n  inArea,\n}: TranslationRowsInput): TranslationRow[] {\n  const byKey = new Map<string, TranslationReview>();\n  if (reviews instanceof Map) {\n    for (const [key, review] of reviews) byKey.set(key, review);\n  } else if (reviews) {\n    for (const review of reviews as readonly TranslationReview[]) {\n      if (review.locale === locale) byKey.set(review.key, review);\n    }\n  }\n  const keys = Object.keys(reference);\n  for (const key of Object.keys(strings)) if (!(key in reference)) keys.push(key);\n  return keys\n    .filter((key) => keyInAreas(key, areas, inArea))\n    .map((key) => {\n      const text = strings[key] ?? \"\";\n      const ref = reference[key] ?? \"\";\n      const review = byKey.get(key) ?? null;\n      return {\n        id: `${locale}|${key}`,\n        key,\n        namespace: groupOf(key),\n        source: sourceOf?.(key) ?? \"\",\n        locale,\n        text,\n        reference: ref,\n        status: reviewStatus(review, text, ref),\n        review,\n        placeholderMismatch: text !== \"\" && placeholderMismatch(text, ref),\n      };\n    });\n}\n\n/** How many rows stand where, and how many there are. */\nexport type TranslationSummary = Record<ReviewStatus, number> & { total: number };\n\nexport function summariseRows(rows: readonly TranslationRow[]): TranslationSummary {\n  const summary: TranslationSummary = {\n    missing: 0,\n    unreviewed: 0,\n    changed: 0,\n    needs_change: 0,\n    approved: 0,\n    total: rows.length,\n  };\n  for (const row of rows) summary[row.status] += 1;\n  return summary;\n}\n\n// ── Filtering ───────────────────────────────────────────────────────────────────\n\n/** The panel's filters. `\"all\"` switches one off. */\nexport interface TranslationReviewFilter {\n  status: ReviewStatus | \"all\";\n  source: string;\n  namespace: string;\n  /** Searched in the key, the text and the reference, folded as every kit list's search\n   *  is (`foldForSearch`): no case, no accents — \"uberweisung\" finds \"Überweisung\". */\n  query: string;\n  placeholdersOnly: boolean;\n}\n\nexport const DEFAULT_TRANSLATION_REVIEW_FILTER: TranslationReviewFilter = {\n  status: \"all\",\n  source: \"all\",\n  namespace: \"all\",\n  query: \"\",\n  placeholdersOnly: false,\n};\n\nexport function filterTranslationRows(\n  rows: readonly TranslationRow[],\n  filter: Partial<TranslationReviewFilter>,\n): TranslationRow[] {\n  const f = { ...DEFAULT_TRANSLATION_REVIEW_FILTER, ...filter };\n  // Folded as every kit list's search is (DUP-5, refactor audit 2026-10).\n  const q = foldForSearch(f.query.trim());\n  return rows.filter(\n    (row) =>\n      (f.status === \"all\" || row.status === f.status) &&\n      (f.source === \"all\" || row.source === f.source) &&\n      (f.namespace === \"all\" || row.namespace === f.namespace) &&\n      (!f.placeholdersOnly || row.placeholderMismatch) &&\n      (!q || [row.key, row.text, row.reference].some((s) => foldForSearch(s).includes(q))),\n  );\n}\n\n// ── Grouping ────────────────────────────────────────────────────────────────────\n\n/** One group of rows — an area, a source — and how they stand. */\nexport interface TranslationRowGroup {\n  key: string;\n  rows: TranslationRow[];\n  summary: TranslationSummary;\n}\n\n/**\n * Rows in groups, each group where its first row is — the reference's order, so the areas\n * read the way the app's authors wrote the bundle — and each group's rows in their own\n * order. keksdose live #377: a reviewer on a phone works area by area (\"the budget\n * strings, then the legal ones\"), and a flat list of 3859 rows is not a way to see\n * where an area stands.\n *\n * `groupOf` names a row's group: `(row) => row.namespace` for the areas,\n * `(row) => row.source` for kastlan's screen texts and documents.\n */\nexport function groupTranslationRows(\n  rows: readonly TranslationRow[],\n  groupOf: (row: TranslationRow) => string,\n): TranslationRowGroup[] {\n  const byKey = new Map<string, TranslationRow[]>();\n  for (const row of rows) {\n    const key = groupOf(row);\n    const list = byKey.get(key);\n    if (list) list.push(row);\n    else byKey.set(key, [row]);\n  }\n  return [...byKey].map(([key, list]) => ({ key, rows: list, summary: summariseRows(list) }));\n}\n\n/**\n * The rows a group's \"Approve the unreviewed\" takes: the ones nobody has given a verdict\n * and that have a text. Not `changed` — a string that moved since it was judged asks to\n * be READ again, which a bulk action is the opposite of — and not `missing`, which has\n * nothing to approve.\n */\nexport function unreviewedRows(rows: readonly TranslationRow[]): TranslationRow[] {\n  return rows.filter((row) => row.status === \"unreviewed\" && row.text !== \"\");\n}\n\n// ── Writing ─────────────────────────────────────────────────────────────────────\n\n/** What gets stored for a verdict: the wording it was given on, so a later change of the\n *  string (or of its reference) shows up as `changed`. */\nexport function reviewWrite(\n  row: TranslationRow,\n  verdict: TranslationVerdict,\n  note: string | null = null,\n  suggestion: string | null = null,\n): TranslationReviewWrite {\n  return {\n    locale: row.locale,\n    key: row.key,\n    text: row.text,\n    referenceText: row.reference,\n    verdict,\n    note,\n    suggestion,\n  };\n}\n\n/** What takes a set of verdicts back: see {@link reviewUndo}. */\nexport interface TranslationReviewUndo {\n  /** The verdicts the rows had before, to store again — each on the wording it was\n   *  given on, so a row that was `changed` reads `changed` again. */\n  writes: TranslationReviewWrite[];\n  /** The rows that had no verdict before: back to unreviewed. */\n  clears: TranslationReviewKey[];\n}\n\n/**\n * How to take back what was just said about `rows` — the rows AS THEY WERE before the\n * write, with the verdicts they carried then. The panel's Undo toast (0.25, keksdose live\n * #377) runs it: a swipe on a phone approves in one movement, and a movement can be a\n * mistake.\n *\n * A row that had a verdict gets it stored again (its note, its suggestion, the wording it\n * was judged on); one that had none is cleared. The server stamps the restored verdict\n * with the person undoing and the time, as it stamps every write — the contract has no\n * way to write a verdict in somebody else's name, and should not.\n */\nexport function reviewUndo(rows: readonly TranslationRow[]): TranslationReviewUndo {\n  const writes: TranslationReviewWrite[] = [];\n  const clears: TranslationReviewKey[] = [];\n  for (const row of rows) {\n    const before = row.review;\n    if (!before) {\n      clears.push({ locale: row.locale, key: row.key });\n      continue;\n    }\n    writes.push({\n      locale: row.locale,\n      key: row.key,\n      text: before.text,\n      referenceText: before.referenceText,\n      verdict: before.verdict,\n      note: before.note,\n      suggestion: before.suggestion,\n    });\n  }\n  return { writes, clears };\n}\n\n/** The app's cached verdict list with `written` in place of what was said before — a\n *  save answers with the rows it wrote, so a page patches its copy instead of\n *  downloading every verdict again after each click. Any spelling with `locale` and\n *  `key` (the API's or the kit's). */\nexport function mergeReviews<T extends TranslationReviewKey>(prev: readonly T[], written: readonly T[]): T[] {\n  const id = (r: TranslationReviewKey) => `${r.locale}|${r.key}`;\n  const replaced = new Set(written.map(id));\n  return [...prev.filter((r) => !replaced.has(id(r))), ...written];\n}\n\n/** The cached list without the verdicts on `cleared`. */\nexport function dropReviews<T extends TranslationReviewKey>(\n  prev: readonly T[],\n  cleared: readonly TranslationReviewKey[],\n): T[] {\n  const gone = new Set(cleared.map((r) => `${r.locale}|${r.key}`));\n  return prev.filter((r) => !gone.has(`${r.locale}|${r.key}`));\n}\n\n// ── Swipe bindings ──────────────────────────────────────────────────────────────\n\n/**\n * What a phone card's swipe can be bound to in `TranslationReviewPanel`'s `swipe`\n * (keksdose — Marcel's live #377 rework, 2026-10-03: *\"Add the swipe options to be shown\n * also to the settings /settings#interaction area where the other swipe options are\n * defined\"*). keksdose lets the user bind every list's swipes there — per side, a primary\n * action at the first threshold and a secondary one at a longer drag — and lists each\n * surface's ids in its `SWIPE_ACTIONS`; this is the translation list's, in the order a\n * settings page offers them.\n *\n * - `approve` — the string is right as it stands. With the panel's Undo toast.\n * - `edit` — open the editor with the cursor in the wording: \"Needs a change\" (or\n *   \"Suggest translation\" on a missing string). Writes nothing; the editor does.\n * - `clear` — take the verdict back: unreviewed again. With the Undo toast, which stores\n *   the verdict again.\n *\n * THERE IS NO SEPARATE \"needs a change\". The editor has no verdict to preselect: Approve\n * and \"Needs a change\" stand side by side in it, and \"Needs a change\" takes a note or a\n * different wording — a verdict without either tells whoever fixes the string nothing, so\n * a swipe never sends one blind (0.25). The one honest thing a \"needs a change\" swipe can\n * do is therefore open the editor with the cursor in the wording — which is `edit`, and\n * `edit` already says \"Needs a change\" on the card. A second id doing the same would arm\n * a second threshold that does what the first already did: the duplicate keksdose's\n * `resolveSwipePlan` drops for exactly that reason.\n */\nexport const TRANSLATION_REVIEW_SWIPE_ACTIONS = [\"approve\", \"edit\", \"clear\"] as const;\n\n/** One of {@link TRANSLATION_REVIEW_SWIPE_ACTIONS}. */\nexport type TranslationReviewSwipeAction = (typeof TRANSLATION_REVIEW_SWIPE_ACTIONS)[number];\n\n/**\n * Which swipe does what on a phone card — `TranslationReviewPanel`'s `swipe`. Each side is\n * an ordered ladder, exactly as `SwipeableRow` and DataTable's `mobileSwipeActions` model\n * one: index 0 commits at the first threshold, index 1 at the longer drag (and so on — the\n * thresholds spread evenly over the card's width). A side left out, or empty, does not\n * swipe.\n *\n * LOGICAL SIDES: `end` is a drag toward the reading end of the line — right in a\n * left-to-right page, left in a right-to-left one — and `start` the other way, so one\n * binding holds in both directions. An app whose settings store physical sides (keksdose's\n * `right`/`left`) hands `right` as `end` for a left-to-right page.\n */\nexport interface TranslationReviewSwipeBinding {\n  /** A drag toward the reading START, nearest threshold first. */\n  start?: readonly TranslationReviewSwipeAction[];\n  /** A drag toward the reading END, nearest threshold first. */\n  end?: readonly TranslationReviewSwipeAction[];\n}\n\n/** What `swipe={true}` means — 0.25's fixed mapping: approve toward the end, open the\n *  editor (\"Needs a change\") toward the start. A settings page's \"reset\" goes back here. */\nexport const DEFAULT_TRANSLATION_REVIEW_SWIPE: TranslationReviewSwipeBinding = Object.freeze({\n  start: Object.freeze([\"edit\"] as const),\n  end: Object.freeze([\"approve\"] as const),\n});\n\n/** The ladders one row actually offers, from a {@link TranslationReviewSwipeBinding}. */\nexport interface TranslationReviewSwipePlan {\n  start: TranslationReviewSwipeAction[];\n  end: TranslationReviewSwipeAction[];\n}\n\n/**\n * The binding resolved against one row — keksdose's `resolveSwipePlan`, for this list.\n * An id the row cannot offer DROPS OUT and the ladder closes up behind it, so the second\n * stage becomes the first rather than the side going dead behind an unreachable first\n * stage (or arming a threshold that does nothing):\n *\n * - `approve`: not on a missing string (nothing to approve) or an approved one (it would\n *   say it again) — the rows that have no approve button either;\n * - `clear`: not without `canClear` (the app passed no `onClear`), and not on a row with\n *   no verdict to take back (unreviewed; missing with no suggestion);\n * - `edit`: on every row;\n * - an id named twice on one side: the second time (a longer drag to the same effect);\n * - an id this version does not know (a binding stored by another version, an app's own\n *   \"none\" slot): dropped like one that does not apply.\n *\n * Only what the ROW decides. Whether the panel may write at all — `readOnly`, no\n * `onSave`, a write lock, the row's own write still out — is the panel's, and then no\n * side swipes.\n */\nexport function translationReviewSwipePlan(\n  binding: TranslationReviewSwipeBinding,\n  row: TranslationRow,\n  { canClear = false }: { canClear?: boolean } = {},\n): TranslationReviewSwipePlan {\n  const offers = (id: TranslationReviewSwipeAction): boolean => {\n    switch (id) {\n      case \"approve\":\n        return row.text !== \"\" && row.status !== \"approved\";\n      case \"edit\":\n        return true;\n      case \"clear\":\n        return canClear && row.review !== null;\n      default:\n        return false;\n    }\n  };\n  const side = (ids: readonly TranslationReviewSwipeAction[] | undefined): TranslationReviewSwipeAction[] => {\n    const out: TranslationReviewSwipeAction[] = [];\n    for (const id of ids ?? []) {\n      if (!out.includes(id) && offers(id)) out.push(id);\n    }\n    return out;\n  };\n  return { start: side(binding.start), end: side(binding.end) };\n}\n\n// ── Export ──────────────────────────────────────────────────────────────────────\n\n/**\n * One entry of the \"Export corrections\" file — enough for a developer to apply the change\n * to the bundle without opening the page. snake_case `reviewed_at` on purpose: this is a\n * FILE, the one keksdose and kastlan already write, beside an API spelled that way.\n */\nexport interface TranslationCorrection {\n  locale: string;\n  key: string;\n  status: ReviewStatus;\n  current: string;\n  reference: string;\n  suggestion: string | null;\n  note: string | null;\n  reviewer: string | null;\n  reviewed_at: string | null;\n}\n\n/** The rows sent back (verdict NEEDS_CHANGE — a suggested translation for a missing\n *  string included), as the export file lists them. */\nexport function translationCorrections(rows: readonly TranslationRow[]): TranslationCorrection[] {\n  return rows\n    .filter((row) => row.review?.verdict === \"NEEDS_CHANGE\")\n    .map((row) => ({\n      locale: row.locale,\n      key: row.key,\n      status: row.status,\n      current: row.text,\n      reference: row.reference,\n      suggestion: row.review?.suggestion ?? null,\n      note: row.review?.note ?? null,\n      reviewer: row.review?.reviewerName ?? null,\n      reviewed_at: row.review?.reviewedAt ?? null,\n    }));\n}\n"],"mappings":";AAwBA,SAAS,qBAAqB;AAkDvB,MAAM,kBAA2C;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAkEO,SAAS,cAAc,QAAiD;AAC7E,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf,KAAK,OAAO;AAAA,IACZ,MAAM,OAAO;AAAA,IACb,eAAe,OAAO;AAAA,IACtB,SAAS,OAAO;AAAA,IAChB,MAAM,OAAO;AAAA,IACb,YAAY,OAAO;AAAA,IACnB,cAAc,OAAO;AAAA,IACrB,YAAY,OAAO;AAAA,EACrB;AACF;AAIO,SAAS,WAAW,OAA0D;AACnF,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,KAAK,MAAM;AAAA,IACX,MAAM,MAAM;AAAA,IACZ,gBAAgB,MAAM;AAAA,IACtB,SAAS,MAAM;AAAA,IACf,MAAM,MAAM;AAAA,IACZ,YAAY,MAAM;AAAA,EACpB;AACF;AAcO,SAAS,eAAe,MAAyC,SAAS,IAA4B;AAC3G,QAAM,MAA8B,CAAC;AACrC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,UAAM,OAAO,GAAG,MAAM,GAAG,GAAG;AAC5B,QAAI,OAAO,UAAU,SAAU,KAAI,IAAI,IAAI;AAAA,aAClC,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACpE,aAAO,OAAO,KAAK,eAAe,OAAkC,GAAG,IAAI,GAAG,CAAC;AAAA,IACjF;AAAA,EACF;AACA,SAAO;AACT;AASO,SAAS,aAAa,KAAqB;AAChD,QAAM,OAAO,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;AAChC,QAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,SAAO,SAAS,IAAI,KAAK,MAAM,GAAG,KAAK,IAAI,KAAK,MAAM,KAAK,CAAC,EAAE,CAAC;AACjE;AAQA,MAAM,iBACJ;AAIK,SAAS,kBAAkB,MAAwB;AACxD,QAAM,QAAkB,CAAC;AACzB,aAAW,KAAK,KAAK,SAAS,cAAc,GAAG;AAC7C,QAAI,EAAE,CAAC,EAAG,OAAM,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI;AAAA,aAIzB,EAAE,CAAC,EAAG,OAAM,KAAK,EAAE,CAAC,MAAM,QAAQ,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG;AAAA,aACpD,EAAE,CAAC,EAAG,OAAM,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG;AAAA,aAC5B,EAAE,CAAC,EAAG,OAAM,KAAK,MAAM,EAAE,CAAC,CAAC,GAAG;AAAA,EACzC;AACA,SAAO,MAAM,KAAK;AACpB;AAIO,SAAS,oBAAoB,MAAc,WAA4B;AAC5E,QAAM,IAAI,kBAAkB,IAAI;AAChC,QAAM,IAAI,kBAAkB,SAAS;AACrC,SAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,MAAM,EAAE,CAAC,CAAC;AAC7D;AAWO,SAAS,aACd,QACA,MACA,WACc;AACd,MAAI,CAAC,OAAQ,QAAO,SAAS,MAAM,cAAc,KAAK,YAAY;AAClE,MAAI,OAAO,SAAS,KAAM,QAAO;AACjC,MAAI,OAAO,iBAAiB,QAAQ,OAAO,kBAAkB,UAAW,QAAO;AAC/E,SAAO,OAAO,YAAY,aAAa,aAAa;AACtD;AAcO,SAAS,UAAU,KAAa,MAAuB;AAC5D,SAAO,QAAQ,QAAQ,IAAI,WAAW,GAAG,IAAI,GAAG,KAAK,IAAI,WAAW,GAAG,IAAI,GAAG,KAAK,IAAI,WAAW,OAAO,IAAI,GAAG;AAClH;AAcO,SAAS,aACd,KACA,OACA,SAAiD,WAC7B;AACpB,MAAI;AACJ,aAAW,QAAQ,OAAO;AACxB,QAAI,OAAO,KAAK,IAAI,MAAM,UAAU,UAAa,KAAK,SAAS,MAAM,QAAS,SAAQ;AAAA,EACxF;AACA,SAAO;AACT;AAQO,SAAS,WACd,KACA,OACA,SAAiD,WACxC;AACT,SAAO,CAAC,SAAS,MAAM,KAAK,CAAC,SAAS,OAAO,KAAK,IAAI,CAAC;AACzD;AA4BO,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,aAAa,UAAU;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AACF,GAA2C;AACzC,QAAM,QAAQ,oBAAI,IAA+B;AACjD,MAAI,mBAAmB,KAAK;AAC1B,eAAW,CAAC,KAAK,MAAM,KAAK,QAAS,OAAM,IAAI,KAAK,MAAM;AAAA,EAC5D,WAAW,SAAS;AAClB,eAAW,UAAU,SAAyC;AAC5D,UAAI,OAAO,WAAW,OAAQ,OAAM,IAAI,OAAO,KAAK,MAAM;AAAA,IAC5D;AAAA,EACF;AACA,QAAM,OAAO,OAAO,KAAK,SAAS;AAClC,aAAW,OAAO,OAAO,KAAK,OAAO,EAAG,KAAI,EAAE,OAAO,WAAY,MAAK,KAAK,GAAG;AAC9E,SAAO,KACJ,OAAO,CAAC,QAAQ,WAAW,KAAK,OAAO,MAAM,CAAC,EAC9C,IAAI,CAAC,QAAQ;AACZ,UAAM,OAAO,QAAQ,GAAG,KAAK;AAC7B,UAAM,MAAM,UAAU,GAAG,KAAK;AAC9B,UAAM,SAAS,MAAM,IAAI,GAAG,KAAK;AACjC,WAAO;AAAA,MACL,IAAI,GAAG,MAAM,IAAI,GAAG;AAAA,MACpB;AAAA,MACA,WAAW,QAAQ,GAAG;AAAA,MACtB,QAAQ,WAAW,GAAG,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,QAAQ,aAAa,QAAQ,MAAM,GAAG;AAAA,MACtC;AAAA,MACA,qBAAqB,SAAS,MAAM,oBAAoB,MAAM,GAAG;AAAA,IACnE;AAAA,EACF,CAAC;AACL;AAKO,SAAS,cAAc,MAAqD;AACjF,QAAM,UAA8B;AAAA,IAClC,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,cAAc;AAAA,IACd,UAAU;AAAA,IACV,OAAO,KAAK;AAAA,EACd;AACA,aAAW,OAAO,KAAM,SAAQ,IAAI,MAAM,KAAK;AAC/C,SAAO;AACT;AAeO,MAAM,oCAA6D;AAAA,EACxE,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,OAAO;AAAA,EACP,kBAAkB;AACpB;AAEO,SAAS,sBACd,MACA,QACkB;AAClB,QAAM,IAAI,EAAE,GAAG,mCAAmC,GAAG,OAAO;AAE5D,QAAM,IAAI,cAAc,EAAE,MAAM,KAAK,CAAC;AACtC,SAAO,KAAK;AAAA,IACV,CAAC,SACE,EAAE,WAAW,SAAS,IAAI,WAAW,EAAE,YACvC,EAAE,WAAW,SAAS,IAAI,WAAW,EAAE,YACvC,EAAE,cAAc,SAAS,IAAI,cAAc,EAAE,eAC7C,CAAC,EAAE,oBAAoB,IAAI,yBAC3B,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,MAAM,IAAI,SAAS,EAAE,KAAK,CAAC,MAAM,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;AAAA,EACtF;AACF;AAqBO,SAAS,qBACd,MACA,SACuB;AACvB,QAAM,QAAQ,oBAAI,IAA8B;AAChD,aAAW,OAAO,MAAM;AACtB,UAAM,MAAM,QAAQ,GAAG;AACvB,UAAM,OAAO,MAAM,IAAI,GAAG;AAC1B,QAAI,KAAM,MAAK,KAAK,GAAG;AAAA,QAClB,OAAM,IAAI,KAAK,CAAC,GAAG,CAAC;AAAA,EAC3B;AACA,SAAO,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,EAAE,KAAK,MAAM,MAAM,SAAS,cAAc,IAAI,EAAE,EAAE;AAC5F;AAQO,SAAS,eAAe,MAAmD;AAChF,SAAO,KAAK,OAAO,CAAC,QAAQ,IAAI,WAAW,gBAAgB,IAAI,SAAS,EAAE;AAC5E;AAMO,SAAS,YACd,KACA,SACA,OAAsB,MACtB,aAA4B,MACJ;AACxB,SAAO;AAAA,IACL,QAAQ,IAAI;AAAA,IACZ,KAAK,IAAI;AAAA,IACT,MAAM,IAAI;AAAA,IACV,eAAe,IAAI;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAsBO,SAAS,WAAW,MAAwD;AACjF,QAAM,SAAmC,CAAC;AAC1C,QAAM,SAAiC,CAAC;AACxC,aAAW,OAAO,MAAM;AACtB,UAAM,SAAS,IAAI;AACnB,QAAI,CAAC,QAAQ;AACX,aAAO,KAAK,EAAE,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC;AAChD;AAAA,IACF;AACA,WAAO,KAAK;AAAA,MACV,QAAQ,IAAI;AAAA,MACZ,KAAK,IAAI;AAAA,MACT,MAAM,OAAO;AAAA,MACb,eAAe,OAAO;AAAA,MACtB,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO;AAAA,MACb,YAAY,OAAO;AAAA,IACrB,CAAC;AAAA,EACH;AACA,SAAO,EAAE,QAAQ,OAAO;AAC1B;AAMO,SAAS,aAA6C,MAAoB,SAA4B;AAC3G,QAAM,KAAK,CAAC,MAA4B,GAAG,EAAE,MAAM,IAAI,EAAE,GAAG;AAC5D,QAAM,WAAW,IAAI,IAAI,QAAQ,IAAI,EAAE,CAAC;AACxC,SAAO,CAAC,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO;AACjE;AAGO,SAAS,YACd,MACA,SACK;AACL,QAAM,OAAO,IAAI,IAAI,QAAQ,IAAI,CAAC,MAAM,GAAG,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC;AAC/D,SAAO,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,EAAE,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC;AAC7D;AA4BO,MAAM,mCAAmC,CAAC,WAAW,QAAQ,OAAO;AA0BpE,MAAM,mCAAkE,OAAO,OAAO;AAAA,EAC3F,OAAO,OAAO,OAAO,CAAC,MAAM,CAAU;AAAA,EACtC,KAAK,OAAO,OAAO,CAAC,SAAS,CAAU;AACzC,CAAC;AA2BM,SAAS,2BACd,SACA,KACA,EAAE,WAAW,MAAM,IAA4B,CAAC,GACpB;AAC5B,QAAM,SAAS,CAAC,OAA8C;AAC5D,YAAQ,IAAI;AAAA,MACV,KAAK;AACH,eAAO,IAAI,SAAS,MAAM,IAAI,WAAW;AAAA,MAC3C,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO,YAAY,IAAI,WAAW;AAAA,MACpC;AACE,eAAO;AAAA,IACX;AAAA,EACF;AACA,QAAM,OAAO,CAAC,QAA6F;AACzG,UAAM,MAAsC,CAAC;AAC7C,eAAW,MAAM,OAAO,CAAC,GAAG;AAC1B,UAAI,CAAC,IAAI,SAAS,EAAE,KAAK,OAAO,EAAE,EAAG,KAAI,KAAK,EAAE;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AACA,SAAO,EAAE,OAAO,KAAK,QAAQ,KAAK,GAAG,KAAK,KAAK,QAAQ,GAAG,EAAE;AAC9D;AAuBO,SAAS,uBAAuB,MAA0D;AAC/F,SAAO,KACJ,OAAO,CAAC,QAAQ,IAAI,QAAQ,YAAY,cAAc,EACtD,IAAI,CAAC,SAAS;AAAA,IACb,QAAQ,IAAI;AAAA,IACZ,KAAK,IAAI;AAAA,IACT,QAAQ,IAAI;AAAA,IACZ,SAAS,IAAI;AAAA,IACb,WAAW,IAAI;AAAA,IACf,YAAY,IAAI,QAAQ,cAAc;AAAA,IACtC,MAAM,IAAI,QAAQ,QAAQ;AAAA,IAC1B,UAAU,IAAI,QAAQ,gBAAgB;AAAA,IACtC,aAAa,IAAI,QAAQ,cAAc;AAAA,EACzC,EAAE;AACN;","names":[]}
+{"version":3,"sources":["../../src/lib/translation-review.ts"],"sourcesContent":["/**\n * The pure half of an app's translation review (H1 in docs/i18n-harmonization.md): from\n * the strings the app ships and the verdicts its server stores to one row per (locale,\n * key) with a status — keksdose's `features/translations/translation-catalogue.ts` and\n * kastlan's copy of it, which had grown apart by a fifth status and a second kind of key.\n *\n * WHY THE STRINGS ARE THE CATALOGUE. Nothing on the server lists which strings exist: a\n * verdict only says what somebody thought of one. So the rows are built from what the app\n * ships — its locale bundles, kastlan's document texts, the kit's own words\n * (`kitLabelStrings`) — and the review can never offer a string users do not see. A\n * verdict is stored WITH the wording it was given on, and a string that changed since is\n * noticed by comparing the two: `changed`, read it again, whatever the verdict was.\n *\n * WHAT STAYS IN THE APP. Which locale is read against which (keksdose: everything against\n * English, English against de-CH; kastlan: against German, German against English), where\n * the strings come from, who may review what (the locales and areas its server answers\n * with), and every request. The kit takes those as input and never derives them.\n *\n * camelCase, like the rest of the kit. The contract's wire shape is snake_case\n * (`reference_text`, `reviewer_name`, `reviewed_at`); {@link fromApiReview} and\n * {@link toApiWrite} are the two lines each app would otherwise write — both apps speak\n * the same contract, so the mapping is written once, here.\n */\n\nimport { matchesSearch, searchWords } from \"./text-match\";\n\n// ── Shapes ──────────────────────────────────────────────────────────────────────\n\nexport type TranslationVerdict = \"APPROVED\" | \"NEEDS_CHANGE\";\n\n/** One stored verdict: what a reviewer said about one string in one locale. */\nexport interface TranslationReview {\n  locale: string;\n  key: string;\n  /** The wording that was judged — compared with today's to notice a change. Empty for\n   *  a string the locale lacked (a suggested translation for a `missing` row). */\n  text: string;\n  /** The reference wording at the time. `null` from a server that did not store it. */\n  referenceText: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  /** The reviewer's wording — or, for a missing string, the translation to add. */\n  suggestion: string | null;\n  /** `null` once the reviewer's account has been erased. */\n  reviewerName: string | null;\n  /** ISO timestamp. */\n  reviewedAt: string;\n}\n\n/** What a save sends: the verdict plus the wording it is given on. */\nexport interface TranslationReviewWrite {\n  locale: string;\n  key: string;\n  text: string;\n  referenceText: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  suggestion: string | null;\n}\n\n/** What a reset sends: back to \"unreviewed\". */\nexport interface TranslationReviewKey {\n  locale: string;\n  key: string;\n}\n\n/**\n * Where a string stands, in the order a reviewer works through them: what is not there\n * at all, what nobody has read, what changed after it was read, what was sent back, and\n * what is done. `missing` never occurs for an app whose locales have every key\n * (keksdose); kastlan's French lacks 172 screen texts.\n */\nexport type ReviewStatus = \"missing\" | \"unreviewed\" | \"changed\" | \"needs_change\" | \"approved\";\n\nexport const REVIEW_STATUSES: readonly ReviewStatus[] = [\n  \"missing\",\n  \"unreviewed\",\n  \"changed\",\n  \"needs_change\",\n  \"approved\",\n];\n\nexport interface TranslationRow {\n  /** `${locale}|${key}` — unique across every locale on a page. A bar, not a colon:\n   *  kastlan's keys contain colons (`common:actions.save`). */\n  id: string;\n  key: string;\n  /** The key's group: `budget` for `budget.rta`, `common` for `common:actions.save`,\n   *  `kit` for the kit's own words. See {@link keyNamespace}. */\n  namespace: string;\n  /** Where the string comes from, in the app's own words — kastlan's `screen` and\n   *  `documents`, keksdose's one source. `\"\"` when the app does not say. */\n  source: string;\n  locale: string;\n  /** The wording users see today; empty when the locale lacks the string. */\n  text: string;\n  /** The same key in the reference locale. */\n  reference: string;\n  status: ReviewStatus;\n  review: TranslationReview | null;\n  /** The interpolations and tags differ from the reference's — `{{count}}` dropped, a\n   *  `<1>` link lost, a `{date}` renamed. A machine can check that much, so it does,\n   *  before a person reads. Never set on a missing string: it has nothing to lose. */\n  placeholderMismatch: boolean;\n}\n\n// ── The wire contract ───────────────────────────────────────────────────────────\n\n/** A verdict as `GET /translations/reviews` returns it (H1's shared contract). Typed\n *  structurally, so an app's generated OpenAPI type fits without a cast. */\nexport interface ApiTranslationReview {\n  locale: string;\n  key: string;\n  text: string;\n  reference_text: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  suggestion: string | null;\n  reviewer_name: string | null;\n  /** server-kit 0.10: the name's two parts (`reviewer_name` is them in the reader's order). */\n  reviewer_first_name?: string | null;\n  reviewer_last_name?: string | null;\n  reviewed_at: string;\n}\n\n/** `GET /translations/reviews` (server-kit `TranslationReviewsResponse`): the locales and\n *  areas the caller may review (`areas` null: every area; `[\"kit\"]` for a review token)\n *  and every stored verdict in them. Typed structurally, as {@link ApiTranslationReview}. */\nexport interface ApiTranslationReviewsResponse {\n  locales: string[];\n  areas?: string[] | null;\n  reviews: ApiTranslationReview[];\n}\n\n/** One item of `PUT /translations/reviews`. */\nexport interface ApiTranslationReviewWrite {\n  locale: string;\n  key: string;\n  text: string;\n  reference_text: string | null;\n  verdict: TranslationVerdict;\n  note: string | null;\n  suggestion: string | null;\n}\n\n/** A verdict from the server, in the kit's spelling. */\nexport function fromApiReview(review: ApiTranslationReview): TranslationReview {\n  return {\n    locale: review.locale,\n    key: review.key,\n    text: review.text,\n    referenceText: review.reference_text,\n    verdict: review.verdict,\n    note: review.note,\n    suggestion: review.suggestion,\n    reviewerName: review.reviewer_name,\n    reviewedAt: review.reviewed_at,\n  };\n}\n\n/** A save, in the server's spelling. `TranslationReviewKey` needs no mapping — it is\n *  `{ locale, key }` on both sides. */\nexport function toApiWrite(write: TranslationReviewWrite): ApiTranslationReviewWrite {\n  return {\n    locale: write.locale,\n    key: write.key,\n    text: write.text,\n    reference_text: write.referenceText,\n    verdict: write.verdict,\n    note: write.note,\n    suggestion: write.suggestion,\n  };\n}\n\n// ── Strings ─────────────────────────────────────────────────────────────────────\n\n/**\n * A nested bundle as `key → string`, in the bundle's own order. Non-string leaves are\n * skipped rather than stringified into something nobody wrote.\n *\n * `prefix` is put in front of every key AS IS, so it names the separator too:\n * `flattenStrings(bundle)` is keksdose's `budget.rta`, `flattenStrings(tree, \"common:\")`\n * kastlan's `common:actions.save`, and `flattenStrings(kitLabelStrings(labels), \"kit.\")`\n * the kit's own words as `kit.combobox.resultCount(3)` — already flat, so only the prefix\n * is added.\n */\nexport function flattenStrings(tree: Readonly<Record<string, unknown>>, prefix = \"\"): Record<string, string> {\n  const out: Record<string, string> = {};\n  for (const [key, value] of Object.entries(tree)) {\n    const path = `${prefix}${key}`;\n    if (typeof value === \"string\") out[path] = value;\n    else if (value && typeof value === \"object\" && !Array.isArray(value)) {\n      Object.assign(out, flattenStrings(value as Record<string, unknown>, `${path}.`));\n    }\n  }\n  return out;\n}\n\n/**\n * The key's group, for the namespace filter: the part before a colon when there is one\n * (kastlan's `common:actions.save` → `common`, `doc_text.invoice:due` →\n * `doc_text.invoice`), else the first dotted segment (keksdose's `budget.rta` →\n * `budget`, the kit's `kit.combobox.resultCount(3)` → `kit`). Only the part before a\n * sample's `(` is looked at, so a colon inside one cannot move the split.\n */\nexport function keyNamespace(key: string): string {\n  const head = key.split(\"(\", 1)[0];\n  const colon = head.indexOf(\":\");\n  return colon >= 0 ? head.slice(0, colon) : head.split(\".\", 1)[0];\n}\n\n// i18next `{{x}}` (formatting options ignored: `{{x, number}}` is `{{x}}`); a Python\n// format field `{x}` / `{0}` / `{amount:.2f}` (kastlan's document texts), but not a\n// LaTeX argument (`\\textbf{x}` — a letter or backslash right before the brace); a\n// numbered or named tag (`<1>`, `<strong>`), not prose in angle brackets (\"<deleted\n// user>\"); and a nested `$t(key)`. `{{x}}` is tried first at its position and consumed\n// whole, so it is never counted a second time as `{x}`.\nconst PLACEHOLDER_RE =\n  /\\{\\{\\s*([^}\\s,]+)[^}]*\\}\\}|(?<![\\\\A-Za-z])\\{([a-z_][a-z0-9_]*|\\d+)(?:[!:][^{}]*)?\\}|<\\/?(\\d+|[a-z][a-z0-9]*)\\s*\\/?>|\\$t\\(([^)]+)\\)/g;\n\n/** The placeholders in a string, as a sorted multiset: `{{count}}`, `{date}`, `<1>`,\n *  `$t(common.save)`. */\nexport function placeholderTokens(text: string): string[] {\n  const found: string[] = [];\n  for (const m of text.matchAll(PLACEHOLDER_RE)) {\n    if (m[1]) found.push(`{{${m[1]}}}`);\n    // `{ref:retention}` (ui-kit 0.28's legal cross-reference) keeps its target: a\n    // translation that points at another section changed what the sentence says. Every\n    // other `{x:spec}` is a format spec, which a translation may change.\n    else if (m[2]) found.push(m[2] === \"ref\" ? m[0] : `{${m[2]}}`);\n    else if (m[3]) found.push(`<${m[3]}>`);\n    else if (m[4]) found.push(`$t(${m[4]})`);\n  }\n  return found.sort();\n}\n\n/** Whether `text` has other placeholders than `reference` — dropped, renamed or added.\n *  Moving one is fine: a translation reorders a sentence. */\nexport function placeholderMismatch(text: string, reference: string): boolean {\n  const a = placeholderTokens(text);\n  const b = placeholderTokens(reference);\n  return a.length !== b.length || a.some((p, i) => p !== b[i]);\n}\n\n// ── Status ──────────────────────────────────────────────────────────────────────\n\n/**\n * A verdict counts only for the wording it was given on. If the string or its reference\n * changed since, it is `changed` — read it again — whatever the verdict was. A string the\n * locale lacks is `missing` until somebody suggests its translation (stored as\n * NEEDS_CHANGE on the empty text, so it reads `needs_change`, and `changed` once a\n * developer adds the string).\n */\nexport function reviewStatus(\n  review: TranslationReview | null | undefined,\n  text: string,\n  reference: string,\n): ReviewStatus {\n  if (!review) return text === \"\" && reference !== \"\" ? \"missing\" : \"unreviewed\";\n  if (review.text !== text) return \"changed\";\n  if (review.referenceText != null && review.referenceText !== reference) return \"changed\";\n  return review.verdict === \"APPROVED\" ? \"approved\" : \"needs_change\";\n}\n\n/**\n * Whether `key` lies in `area`: the key IS the area, or sits under it — `legal.terms`\n * and kastlan's `legal:terms` are in `legal`, `legalese.title` is not.\n *\n * 0.28: the kit's own words of that area too — `kit.legal.sections.terms.law.body(…)`\n * is in `legal`. All three apps list the kit's labels under `kit.`\n * (`flattenStrings(kitLabelStrings(labels), \"kit.\")`), and since 0.28 the kit writes\n * the shared legal sections, so a lawyer with a `[\"legal\"]` grant who was not shown\n * `kit.legal.*` would not see half of the Privacy Policy — and the server would refuse\n * the verdicts (docs/legal-harmonization.md §7.5). server-kit's `in_areas` and the apps'\n * copies of it apply the same rule.\n */\nexport function keyInArea(key: string, area: string): boolean {\n  return key === area || key.startsWith(`${area}.`) || key.startsWith(`${area}:`) || key.startsWith(`kit.${area}.`);\n}\n\n/**\n * The area of `areas` that `key` lies in ({@link keyInArea}), or `undefined` — the\n * translation page's grouping by the same rule the filter and the server use, so\n * `kit.legal.sections.privacy.rights.lead` is grouped under `legal` with the app's own\n * legal texts instead of under `kit.legal`:\n *\n *     const namespaceOf = (key: string) => reviewAreaOf(key, [\"legal\"]) ?? ownNamespaceOf(key);\n *\n * Where two areas both hold the key (`legal` and `legal.privacy`), the longer — the more\n * specific — wins, whatever their order. `inArea` is the app's own rule, as for\n * {@link keyInAreas}.\n */\nexport function reviewAreaOf(\n  key: string,\n  areas: readonly string[],\n  inArea: (key: string, area: string) => boolean = keyInArea,\n): string | undefined {\n  let found: string | undefined;\n  for (const area of areas) {\n    if (inArea(key, area) && (found === undefined || area.length > found.length)) found = area;\n  }\n  return found;\n}\n\n/**\n * Whether `key` lies in one of `areas` — the scope a reviewer may be limited to\n * (keksdose: `[\"legal\"]`, a lawyer who judges the Imprint, the Privacy Policy and the\n * Terms and sees nothing else). `null`/`undefined` is every area. The server applies the\n * same rule and refuses verdicts outside; this decides only what is listed.\n */\nexport function keyInAreas(\n  key: string,\n  areas: readonly string[] | null | undefined,\n  inArea: (key: string, area: string) => boolean = keyInArea,\n): boolean {\n  return !areas || areas.some((area) => inArea(key, area));\n}\n\nexport interface TranslationRowsInput {\n  locale: string;\n  /** The locale's strings, `key → text` ({@link flattenStrings}). */\n  strings: Readonly<Record<string, string>>;\n  /** The reference locale's strings — whichever locale THIS app reads `locale` against. */\n  reference: Readonly<Record<string, string>>;\n  /** The verdicts: this locale's by key, or the whole list as the server sent it (other\n   *  locales' verdicts are skipped). */\n  reviews?: ReadonlyMap<string, TranslationReview> | readonly TranslationReview[];\n  /** Default {@link keyNamespace}. */\n  namespaceOf?: (key: string) => string;\n  /** The row's source, an app-defined word (kastlan: `doc_text.` keys are `documents`,\n   *  the rest `screen`). Default: none (`\"\"`). */\n  sourceOf?: (key: string) => string;\n  /** Keep only keys inside these areas ({@link keyInAreas}); `null` keeps every key. */\n  areas?: readonly string[] | null;\n  /** Default {@link keyInArea}. */\n  inArea?: (key: string, area: string) => boolean;\n}\n\n/**\n * Every key of one locale, with its status: the reference's keys first, in its order, so\n * rows read the way the app's authors wrote them; a key only this locale has is appended\n * rather than dropped (a parity test should forbid it, but the page should not lie if one\n * slips through).\n */\nexport function translationRows({\n  locale,\n  strings,\n  reference,\n  reviews,\n  namespaceOf: groupOf = keyNamespace,\n  sourceOf,\n  areas,\n  inArea,\n}: TranslationRowsInput): TranslationRow[] {\n  const byKey = new Map<string, TranslationReview>();\n  if (reviews instanceof Map) {\n    for (const [key, review] of reviews) byKey.set(key, review);\n  } else if (reviews) {\n    for (const review of reviews as readonly TranslationReview[]) {\n      if (review.locale === locale) byKey.set(review.key, review);\n    }\n  }\n  const keys = Object.keys(reference);\n  for (const key of Object.keys(strings)) if (!(key in reference)) keys.push(key);\n  return keys\n    .filter((key) => keyInAreas(key, areas, inArea))\n    .map((key) => {\n      const text = strings[key] ?? \"\";\n      const ref = reference[key] ?? \"\";\n      const review = byKey.get(key) ?? null;\n      return {\n        id: `${locale}|${key}`,\n        key,\n        namespace: groupOf(key),\n        source: sourceOf?.(key) ?? \"\",\n        locale,\n        text,\n        reference: ref,\n        status: reviewStatus(review, text, ref),\n        review,\n        placeholderMismatch: text !== \"\" && placeholderMismatch(text, ref),\n      };\n    });\n}\n\n/** How many rows stand where, and how many there are. */\nexport type TranslationSummary = Record<ReviewStatus, number> & { total: number };\n\nexport function summariseRows(rows: readonly TranslationRow[]): TranslationSummary {\n  const summary: TranslationSummary = {\n    missing: 0,\n    unreviewed: 0,\n    changed: 0,\n    needs_change: 0,\n    approved: 0,\n    total: rows.length,\n  };\n  for (const row of rows) summary[row.status] += 1;\n  return summary;\n}\n\n// ── Filtering ───────────────────────────────────────────────────────────────────\n\n/** The panel's filters. `\"all\"` switches one off. */\nexport interface TranslationReviewFilter {\n  status: ReviewStatus | \"all\";\n  source: string;\n  namespace: string;\n  /** Searched in the key, the text and the reference, folded as every kit list's search\n   *  is (`foldForSearch`): no case, no accents — \"uberweisung\" finds \"Überweisung\". Every\n   *  word on its own (0.52): \"budget assign\" finds `budget.rta`, \"Ready to Assign\". */\n  query: string;\n  placeholdersOnly: boolean;\n}\n\nexport const DEFAULT_TRANSLATION_REVIEW_FILTER: TranslationReviewFilter = {\n  status: \"all\",\n  source: \"all\",\n  namespace: \"all\",\n  query: \"\",\n  placeholdersOnly: false,\n};\n\n/**\n * The rows the filters leave. `locale` (0.52) folds the query and the texts as the kit's\n * other lists do — the panel passes the provider's; left out, the runtime's default.\n */\nexport function filterTranslationRows(\n  rows: readonly TranslationRow[],\n  filter: Partial<TranslationReviewFilter>,\n  locale?: string,\n): TranslationRow[] {\n  const f = { ...DEFAULT_TRANSLATION_REVIEW_FILTER, ...filter };\n  // Folded as every kit list's search is (DUP-5, refactor audit 2026-10), and since 0.52\n  // word by word, each anywhere in the key, the text or the reference (0.51.4's rule;\n  // refactor audit 2026-10-30, DUP-4: the whole query had to be one substring of one).\n  const words = searchWords(f.query, locale);\n  return rows.filter(\n    (row) =>\n      (f.status === \"all\" || row.status === f.status) &&\n      (f.source === \"all\" || row.source === f.source) &&\n      (f.namespace === \"all\" || row.namespace === f.namespace) &&\n      (!f.placeholdersOnly || row.placeholderMismatch) &&\n      matchesSearch(words, [row.key, row.text, row.reference], locale),\n  );\n}\n\n// ── Grouping ────────────────────────────────────────────────────────────────────\n\n/** One group of rows — an area, a source — and how they stand. */\nexport interface TranslationRowGroup {\n  key: string;\n  rows: TranslationRow[];\n  summary: TranslationSummary;\n}\n\n/**\n * Rows in groups, each group where its first row is — the reference's order, so the areas\n * read the way the app's authors wrote the bundle — and each group's rows in their own\n * order. keksdose live #377: a reviewer on a phone works area by area (\"the budget\n * strings, then the legal ones\"), and a flat list of 3859 rows is not a way to see\n * where an area stands.\n *\n * `groupOf` names a row's group: `(row) => row.namespace` for the areas,\n * `(row) => row.source` for kastlan's screen texts and documents.\n */\nexport function groupTranslationRows(\n  rows: readonly TranslationRow[],\n  groupOf: (row: TranslationRow) => string,\n): TranslationRowGroup[] {\n  const byKey = new Map<string, TranslationRow[]>();\n  for (const row of rows) {\n    const key = groupOf(row);\n    const list = byKey.get(key);\n    if (list) list.push(row);\n    else byKey.set(key, [row]);\n  }\n  return [...byKey].map(([key, list]) => ({ key, rows: list, summary: summariseRows(list) }));\n}\n\n/**\n * The rows a group's \"Approve the unreviewed\" takes: the ones nobody has given a verdict\n * and that have a text. Not `changed` — a string that moved since it was judged asks to\n * be READ again, which a bulk action is the opposite of — and not `missing`, which has\n * nothing to approve.\n */\nexport function unreviewedRows(rows: readonly TranslationRow[]): TranslationRow[] {\n  return rows.filter((row) => row.status === \"unreviewed\" && row.text !== \"\");\n}\n\n// ── Writing ─────────────────────────────────────────────────────────────────────\n\n/** What gets stored for a verdict: the wording it was given on, so a later change of the\n *  string (or of its reference) shows up as `changed`. */\nexport function reviewWrite(\n  row: TranslationRow,\n  verdict: TranslationVerdict,\n  note: string | null = null,\n  suggestion: string | null = null,\n): TranslationReviewWrite {\n  return {\n    locale: row.locale,\n    key: row.key,\n    text: row.text,\n    referenceText: row.reference,\n    verdict,\n    note,\n    suggestion,\n  };\n}\n\n/** What takes a set of verdicts back: see {@link reviewUndo}. */\nexport interface TranslationReviewUndo {\n  /** The verdicts the rows had before, to store again — each on the wording it was\n   *  given on, so a row that was `changed` reads `changed` again. */\n  writes: TranslationReviewWrite[];\n  /** The rows that had no verdict before: back to unreviewed. */\n  clears: TranslationReviewKey[];\n}\n\n/**\n * How to take back what was just said about `rows` — the rows AS THEY WERE before the\n * write, with the verdicts they carried then. The panel's Undo toast (0.25, keksdose live\n * #377) runs it: a swipe on a phone approves in one movement, and a movement can be a\n * mistake.\n *\n * A row that had a verdict gets it stored again (its note, its suggestion, the wording it\n * was judged on); one that had none is cleared. The server stamps the restored verdict\n * with the person undoing and the time, as it stamps every write — the contract has no\n * way to write a verdict in somebody else's name, and should not.\n */\nexport function reviewUndo(rows: readonly TranslationRow[]): TranslationReviewUndo {\n  const writes: TranslationReviewWrite[] = [];\n  const clears: TranslationReviewKey[] = [];\n  for (const row of rows) {\n    const before = row.review;\n    if (!before) {\n      clears.push({ locale: row.locale, key: row.key });\n      continue;\n    }\n    writes.push({\n      locale: row.locale,\n      key: row.key,\n      text: before.text,\n      referenceText: before.referenceText,\n      verdict: before.verdict,\n      note: before.note,\n      suggestion: before.suggestion,\n    });\n  }\n  return { writes, clears };\n}\n\n/** The app's cached verdict list with `written` in place of what was said before — a\n *  save answers with the rows it wrote, so a page patches its copy instead of\n *  downloading every verdict again after each click. Any spelling with `locale` and\n *  `key` (the API's or the kit's). */\nexport function mergeReviews<T extends TranslationReviewKey>(prev: readonly T[], written: readonly T[]): T[] {\n  const id = (r: TranslationReviewKey) => `${r.locale}|${r.key}`;\n  const replaced = new Set(written.map(id));\n  return [...prev.filter((r) => !replaced.has(id(r))), ...written];\n}\n\n/** The cached list without the verdicts on `cleared`. */\nexport function dropReviews<T extends TranslationReviewKey>(\n  prev: readonly T[],\n  cleared: readonly TranslationReviewKey[],\n): T[] {\n  const gone = new Set(cleared.map((r) => `${r.locale}|${r.key}`));\n  return prev.filter((r) => !gone.has(`${r.locale}|${r.key}`));\n}\n\n// ── Swipe bindings ──────────────────────────────────────────────────────────────\n\n/**\n * What a phone card's swipe can be bound to in `TranslationReviewPanel`'s `swipe`\n * (keksdose — Marcel's live #377 rework, 2026-10-03: *\"Add the swipe options to be shown\n * also to the settings /settings#interaction area where the other swipe options are\n * defined\"*). keksdose lets the user bind every list's swipes there — per side, a primary\n * action at the first threshold and a secondary one at a longer drag — and lists each\n * surface's ids in its `SWIPE_ACTIONS`; this is the translation list's, in the order a\n * settings page offers them.\n *\n * - `approve` — the string is right as it stands. With the panel's Undo toast.\n * - `edit` — open the editor with the cursor in the wording: \"Needs a change\" (or\n *   \"Suggest translation\" on a missing string). Writes nothing; the editor does.\n * - `clear` — take the verdict back: unreviewed again. With the Undo toast, which stores\n *   the verdict again.\n *\n * THERE IS NO SEPARATE \"needs a change\". The editor has no verdict to preselect: Approve\n * and \"Needs a change\" stand side by side in it, and \"Needs a change\" takes a note or a\n * different wording — a verdict without either tells whoever fixes the string nothing, so\n * a swipe never sends one blind (0.25). The one honest thing a \"needs a change\" swipe can\n * do is therefore open the editor with the cursor in the wording — which is `edit`, and\n * `edit` already says \"Needs a change\" on the card. A second id doing the same would arm\n * a second threshold that does what the first already did: the duplicate keksdose's\n * `resolveSwipePlan` drops for exactly that reason.\n */\nexport const TRANSLATION_REVIEW_SWIPE_ACTIONS = [\"approve\", \"edit\", \"clear\"] as const;\n\n/** One of {@link TRANSLATION_REVIEW_SWIPE_ACTIONS}. */\nexport type TranslationReviewSwipeAction = (typeof TRANSLATION_REVIEW_SWIPE_ACTIONS)[number];\n\n/**\n * Which swipe does what on a phone card — `TranslationReviewPanel`'s `swipe`. Each side is\n * an ordered ladder, exactly as `SwipeableRow` and DataTable's `mobileSwipeActions` model\n * one: index 0 commits at the first threshold, index 1 at the longer drag (and so on — the\n * thresholds spread evenly over the card's width). A side left out, or empty, does not\n * swipe.\n *\n * LOGICAL SIDES: `end` is a drag toward the reading end of the line — right in a\n * left-to-right page, left in a right-to-left one — and `start` the other way, so one\n * binding holds in both directions. An app whose settings store physical sides (keksdose's\n * `right`/`left`) hands `right` as `end` for a left-to-right page.\n */\nexport interface TranslationReviewSwipeBinding {\n  /** A drag toward the reading START, nearest threshold first. */\n  start?: readonly TranslationReviewSwipeAction[];\n  /** A drag toward the reading END, nearest threshold first. */\n  end?: readonly TranslationReviewSwipeAction[];\n}\n\n/** What `swipe={true}` means — 0.25's fixed mapping: approve toward the end, open the\n *  editor (\"Needs a change\") toward the start. A settings page's \"reset\" goes back here. */\nexport const DEFAULT_TRANSLATION_REVIEW_SWIPE: TranslationReviewSwipeBinding = Object.freeze({\n  start: Object.freeze([\"edit\"] as const),\n  end: Object.freeze([\"approve\"] as const),\n});\n\n/** The ladders one row actually offers, from a {@link TranslationReviewSwipeBinding}. */\nexport interface TranslationReviewSwipePlan {\n  start: TranslationReviewSwipeAction[];\n  end: TranslationReviewSwipeAction[];\n}\n\n/**\n * The binding resolved against one row — keksdose's `resolveSwipePlan`, for this list.\n * An id the row cannot offer DROPS OUT and the ladder closes up behind it, so the second\n * stage becomes the first rather than the side going dead behind an unreachable first\n * stage (or arming a threshold that does nothing):\n *\n * - `approve`: not on a missing string (nothing to approve) or an approved one (it would\n *   say it again) — the rows that have no approve button either;\n * - `clear`: not without `canClear` (the app passed no `onClear`), and not on a row with\n *   no verdict to take back (unreviewed; missing with no suggestion);\n * - `edit`: on every row;\n * - an id named twice on one side: the second time (a longer drag to the same effect);\n * - an id this version does not know (a binding stored by another version, an app's own\n *   \"none\" slot): dropped like one that does not apply.\n *\n * Only what the ROW decides. Whether the panel may write at all — `readOnly`, no\n * `onSave`, a write lock, the row's own write still out — is the panel's, and then no\n * side swipes.\n */\nexport function translationReviewSwipePlan(\n  binding: TranslationReviewSwipeBinding,\n  row: TranslationRow,\n  { canClear = false }: { canClear?: boolean } = {},\n): TranslationReviewSwipePlan {\n  const offers = (id: TranslationReviewSwipeAction): boolean => {\n    switch (id) {\n      case \"approve\":\n        return row.text !== \"\" && row.status !== \"approved\";\n      case \"edit\":\n        return true;\n      case \"clear\":\n        return canClear && row.review !== null;\n      default:\n        return false;\n    }\n  };\n  const side = (ids: readonly TranslationReviewSwipeAction[] | undefined): TranslationReviewSwipeAction[] => {\n    const out: TranslationReviewSwipeAction[] = [];\n    for (const id of ids ?? []) {\n      if (!out.includes(id) && offers(id)) out.push(id);\n    }\n    return out;\n  };\n  return { start: side(binding.start), end: side(binding.end) };\n}\n\n// ── Export ──────────────────────────────────────────────────────────────────────\n\n/**\n * One entry of the \"Export corrections\" file — enough for a developer to apply the change\n * to the bundle without opening the page. snake_case `reviewed_at` on purpose: this is a\n * FILE, the one keksdose and kastlan already write, beside an API spelled that way.\n */\nexport interface TranslationCorrection {\n  locale: string;\n  key: string;\n  status: ReviewStatus;\n  current: string;\n  reference: string;\n  suggestion: string | null;\n  note: string | null;\n  reviewer: string | null;\n  reviewed_at: string | null;\n}\n\n/** The rows sent back (verdict NEEDS_CHANGE — a suggested translation for a missing\n *  string included), as the export file lists them. */\nexport function translationCorrections(rows: readonly TranslationRow[]): TranslationCorrection[] {\n  return rows\n    .filter((row) => row.review?.verdict === \"NEEDS_CHANGE\")\n    .map((row) => ({\n      locale: row.locale,\n      key: row.key,\n      status: row.status,\n      current: row.text,\n      reference: row.reference,\n      suggestion: row.review?.suggestion ?? null,\n      note: row.review?.note ?? null,\n      reviewer: row.review?.reviewerName ?? null,\n      reviewed_at: row.review?.reviewedAt ?? null,\n    }));\n}\n"],"mappings":"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","names":[]}

package/dist/notifications/device-zone-report.js

@@ -1,6 +1,6 @@
 "use client";
 import { useEffect } from "react";
-import { settle } from "../account/account-parts.js";
+import { settle } from "../hooks/use-mounted.js";
 function deviceTimeZone() {
   try {
     return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";

package/dist/notifications/device-zone-report.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/device-zone-report.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nimport { settle } from \"../account/account-parts\";\n\nexport interface DeviceZoneReportOptions {\n  /** The account's `device_timezone` from `/auth/me`; `undefined` while it loads (no\n   *  report until it is known). */\n  stored: string | null | undefined;\n  /** `PATCH /auth/me {device_timezone}` with this device's zone. */\n  report: (deviceTimezone: string) => Promise<unknown> | void;\n  /** A demo account: never reported (the server ignores it too, §10.3 Settled). */\n  isDemo?: boolean;\n  /** The signed-in account (its user id): the once-per-start guard is per account, so a\n   *  second person signed in on a shared PC in the same start is reported too. Without it\n   *  the guard is cleared when `stored` goes `undefined` (signed out). */\n  account?: string | number | null;\n}\n\n/**\n * This device's IANA zone (\"Europe/Zurich\"), or `\"UTC\"` where the runtime names none —\n * the zone `useDeviceZoneReport` reports, which becomes the account's (§10.3, automatic\n * only), and the one sign-up sends (`RegisterRequest.device_timezone`). Here since 0.46.1\n * (keksdose N6).\n */\nexport function deviceTimeZone(): string {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n  } catch {\n    return \"UTC\";\n  }\n}\n\n/** The (account, stored, device) triples already reported in this start of the app. */\nconst reportedThisStart = new Set<string>();\n\n/**\n * Report this device's zone to the account (0.46, §10.3): the account's zone follows the\n * device last used, else `Europe/Zurich`; screens keep showing device time. Once per start\n * of the app, and only when it differs from the stored `device_timezone` — a bench PC in Zurich never\n * PATCHes on a sign-in — and never for a demo. Per account: a sign-out (`stored` back to\n * `undefined`) clears the guard, and `account` keys it. The report IS the account's zone: it is\n * automatic only (§10.3, amended 2026-10-20), so nothing is ever picked. A failed report\n * is not retried in the same start; the next start tries again. Sign-up sends the zone\n * itself (`RegisterRequest.device_timezone`).\n *\n *     useDeviceZoneReport({ stored: me?.device_timezone, isDemo: me?.is_demo, account: me?.id,\n *       report: async (zone) => setUser((await api.patch(\"/auth/me\", { device_timezone: zone })).data) });\n */\nexport function useDeviceZoneReport({ stored, report, isDemo = false, account = null }: DeviceZoneReportOptions): void {\n  useEffect(() => {\n    if (stored === undefined) {\n      // Signed out (or still loading): the next account in this start is reported afresh.\n      reportedThisStart.clear();\n      return;\n    }\n    if (isDemo) return;\n    const device = deviceTimeZone();\n    if (device === stored) return;\n    const key = `${account ?? \"\"}|${stored ?? \"\"}→${device}`;\n    if (reportedThisStart.has(key)) return;\n    reportedThisStart.add(key);\n    void settle(() => report(device)).catch(() => undefined);\n    // `report` is the app's request function: a new closure each render must not report\n    // again, so only the values decide.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [stored, isDemo, account]);\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAE1B,SAAS,cAAc;AAsBhB,SAAS,iBAAyB;AACvC,MAAI;AACF,WAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE,YAAY;AAAA,EAC7D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,MAAM,oBAAoB,oBAAI,IAAY;AAenC,SAAS,oBAAoB,EAAE,QAAQ,QAAQ,SAAS,OAAO,UAAU,KAAK,GAAkC;AACrH,YAAU,MAAM;AACd,QAAI,WAAW,QAAW;AAExB,wBAAkB,MAAM;AACxB;AAAA,IACF;AACA,QAAI,OAAQ;AACZ,UAAM,SAAS,eAAe;AAC9B,QAAI,WAAW,OAAQ;AACvB,UAAM,MAAM,GAAG,WAAW,EAAE,IAAI,UAAU,EAAE,SAAI,MAAM;AACtD,QAAI,kBAAkB,IAAI,GAAG,EAAG;AAChC,sBAAkB,IAAI,GAAG;AACzB,SAAK,OAAO,MAAM,OAAO,MAAM,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,EAIzD,GAAG,CAAC,QAAQ,QAAQ,OAAO,CAAC;AAC9B;","names":[]}
+{"version":3,"sources":["../../src/notifications/device-zone-report.ts"],"sourcesContent":["import { useEffect } from \"react\";\n\nimport { settle } from \"../hooks/use-mounted\";\n\nexport interface DeviceZoneReportOptions {\n  /** The account's `device_timezone` from `/auth/me`; `undefined` while it loads (no\n   *  report until it is known). */\n  stored: string | null | undefined;\n  /** `PATCH /auth/me {device_timezone}` with this device's zone. */\n  report: (deviceTimezone: string) => Promise<unknown> | void;\n  /** A demo account: never reported (the server ignores it too, §10.3 Settled). */\n  isDemo?: boolean;\n  /** The signed-in account (its user id): the once-per-start guard is per account, so a\n   *  second person signed in on a shared PC in the same start is reported too. Without it\n   *  the guard is cleared when `stored` goes `undefined` (signed out). */\n  account?: string | number | null;\n}\n\n/**\n * This device's IANA zone (\"Europe/Zurich\"), or `\"UTC\"` where the runtime names none —\n * the zone `useDeviceZoneReport` reports, which becomes the account's (§10.3, automatic\n * only), and the one sign-up sends (`RegisterRequest.device_timezone`). Here since 0.46.1\n * (keksdose N6).\n */\nexport function deviceTimeZone(): string {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n  } catch {\n    return \"UTC\";\n  }\n}\n\n/** The (account, stored, device) triples already reported in this start of the app. */\nconst reportedThisStart = new Set<string>();\n\n/**\n * Report this device's zone to the account (0.46, §10.3): the account's zone follows the\n * device last used, else `Europe/Zurich`; screens keep showing device time. Once per start\n * of the app, and only when it differs from the stored `device_timezone` — a bench PC in Zurich never\n * PATCHes on a sign-in — and never for a demo. Per account: a sign-out (`stored` back to\n * `undefined`) clears the guard, and `account` keys it. The report IS the account's zone: it is\n * automatic only (§10.3, amended 2026-10-20), so nothing is ever picked. A failed report\n * is not retried in the same start; the next start tries again. Sign-up sends the zone\n * itself (`RegisterRequest.device_timezone`).\n *\n *     useDeviceZoneReport({ stored: me?.device_timezone, isDemo: me?.is_demo, account: me?.id,\n *       report: async (zone) => setUser((await api.patch(\"/auth/me\", { device_timezone: zone })).data) });\n */\nexport function useDeviceZoneReport({ stored, report, isDemo = false, account = null }: DeviceZoneReportOptions): void {\n  useEffect(() => {\n    if (stored === undefined) {\n      // Signed out (or still loading): the next account in this start is reported afresh.\n      reportedThisStart.clear();\n      return;\n    }\n    if (isDemo) return;\n    const device = deviceTimeZone();\n    if (device === stored) return;\n    const key = `${account ?? \"\"}|${stored ?? \"\"}→${device}`;\n    if (reportedThisStart.has(key)) return;\n    reportedThisStart.add(key);\n    void settle(() => report(device)).catch(() => undefined);\n    // `report` is the app's request function: a new closure each render must not report\n    // again, so only the values decide.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [stored, isDemo, account]);\n}\n"],"mappings":";AAAA,SAAS,iBAAiB;AAE1B,SAAS,cAAc;AAsBhB,SAAS,iBAAyB;AACvC,MAAI;AACF,WAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE,YAAY;AAAA,EAC7D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,MAAM,oBAAoB,oBAAI,IAAY;AAenC,SAAS,oBAAoB,EAAE,QAAQ,QAAQ,SAAS,OAAO,UAAU,KAAK,GAAkC;AACrH,YAAU,MAAM;AACd,QAAI,WAAW,QAAW;AAExB,wBAAkB,MAAM;AACxB;AAAA,IACF;AACA,QAAI,OAAQ;AACZ,UAAM,SAAS,eAAe;AAC9B,QAAI,WAAW,OAAQ;AACvB,UAAM,MAAM,GAAG,WAAW,EAAE,IAAI,UAAU,EAAE,SAAI,MAAM;AACtD,QAAI,kBAAkB,IAAI,GAAG,EAAG;AAChC,sBAAkB,IAAI,GAAG;AACzB,SAAK,OAAO,MAAM,OAAO,MAAM,CAAC,EAAE,MAAM,MAAM,MAAS;AAAA,EAIzD,GAAG,CAAC,QAAQ,QAAQ,OAAO,CAAC;AAC9B;","names":[]}

package/dist/notifications/notification-bell.d.ts

@@ -14,7 +14,8 @@ export interface NotificationBellProps<Id extends string | number = string | num
     href: string;
     /** The row's glyph for a type, as {@link NotificationInbox}'s; `Bell` by default. */
     icon?: (type: string) => LucideIcon | undefined;
-    /** A row's time. Default: the provider's locale and `timeZone`, date and time. */
+    /** A row's time. Default: the provider's `formatDate` (the app's date preference) with
+     *  the language's clock, else date and time in the provider's locale and `timeZone`. */
     formatDate?: (iso: string) => string;
     labels?: LabelOverride<NotificationsLabels>;
 }

package/dist/notifications/notification-bell.js

@@ -2,7 +2,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Bell } from "lucide-react";
 import { useKitLabels } from "../i18n/kit-labels.js";
-import { useKitFormat } from "../lib/format.js";
+import { useDayFormatter } from "../lib/day-format.js";
 import { DEFAULT_LIST_LABELS } from "../components/list-labels.js";
 import { StatusDot } from "../components/status-dot.js";
 import { TopBarActionMenu } from "../shell/topbar-action-menu.js";
@@ -20,8 +20,8 @@ function NotificationBell({
 }) {
   const labels = useNotificationsLabels(labelsProp);
   const list = useKitLabels("list", DEFAULT_LIST_LABELS);
-  const { formatDate } = useKitFormat();
-  const timeOf = (iso) => formatDateProp ? formatDateProp(iso) : formatDate(iso, "dateTime");
+  const day = useDayFormatter(formatDateProp);
+  const timeOf = (iso) => day(iso, { time: true });
   const unread = unreadCount > 0;
   const shown = (items ?? []).slice(0, BELL_ROWS);
   const entries = shown.map((item) => {

package/dist/notifications/notification-bell.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/notification-bell.tsx"],"sourcesContent":["import { Bell } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { useKitFormat } from \"../lib/format\";\nimport { DEFAULT_LIST_LABELS } from \"../components/list-labels\";\nimport { StatusDot } from \"../components/status-dot\";\nimport { TopBarActionMenu } from \"../shell/topbar-action-menu\";\nimport type { TopBarMenuEntry } from \"../shell/topbar-action-menu\";\nimport { useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { NotificationInboxItem } from \"./notification-inbox\";\n\n/** How many rows the bell's panel shows: the newest 20 (§10.1). */\nconst BELL_ROWS = 20;\n\nexport interface NotificationBellProps<Id extends string | number = string | number> {\n  /** The inbox, newest first (the bell shows the first 20); `undefined` while it loads. */\n  items: readonly NotificationInboxItem<Id>[] | undefined;\n  /** Every unread row of the account (`unread_count`): the badge. */\n  unreadCount: number;\n  /** Open a row: the app marks it read and routes to `item.url` (kastlan switches the\n   *  acting company first, to `item.company_id`). The panel closes. */\n  onOpen: (item: NotificationInboxItem<Id>) => void;\n  /** The app's inbox page or card, for \"All notifications\". */\n  href: string;\n  /** The row's glyph for a type, as {@link NotificationInbox}'s; `Bell` by default. */\n  icon?: (type: string) => LucideIcon | undefined;\n  /** A row's time. Default: the provider's locale and `timeZone`, date and time. */\n  formatDate?: (iso: string) => string;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/** The badge's text: \"99+\" past 99. */\nconst badgeText = (count: number) => (count > 99 ? \"99+\" : String(Math.floor(count)));\n\n/**\n * The top bar's bell (0.46, docs/notifications-harmonization.md §10.1), for\n * `TopBarActions`' `notifications` slot, right before the account menu: an icon button\n * with the unread count as a badge (\"99+\" past 99), opening the newest 20 rows in the\n * kit's top-bar panel (`TopBarActionMenu`) with \"All notifications\" under them.\n *\n * **Optional per app.** \"One badge per signal\": an app shows the bell or an unread dot on\n * the avatar, never both — keksdose keeps its avatar dot and no bell; kastlan's inbox\n * lives in the bell. Shown to every signed-in account in an app that keeps an inbox, the\n * demo included. Props only, as the inbox list: poll the count every\n * {@link INBOX_BADGE_INTERVAL}.\n */\nexport function NotificationBell<Id extends string | number = string | number>({\n  items,\n  unreadCount,\n  onOpen,\n  href,\n  icon,\n  formatDate: formatDateProp,\n  labels: labelsProp,\n}: NotificationBellProps<Id>) {\n  const labels = useNotificationsLabels(labelsProp);\n  const list = useKitLabels(\"list\", DEFAULT_LIST_LABELS);\n  const { formatDate } = useKitFormat();\n  const timeOf = (iso: string) => (formatDateProp ? formatDateProp(iso) : formatDate(iso, \"dateTime\"));\n  const unread = unreadCount > 0;\n  const shown = (items ?? []).slice(0, BELL_ROWS);\n\n  const entries: TopBarMenuEntry[] = shown.map((item) => {\n    const Icon = icon?.(item.notification_type) ?? Bell;\n    const isUnread = item.read_at === null;\n    return {\n      key: `item-${String(item.id)}`,\n      icon: <Icon aria-hidden className=\"size-4\" />,\n      label: (\n        <span className=\"block min-w-0\" data-bell-item={String(item.id)}>\n          {item.company && <span className=\"block truncate text-caption text-muted\">{item.company}</span>}\n          <span className={isUnread ? \"block font-semibold\" : \"block\"}>{item.title}</span>\n          <span className=\"block line-clamp-2 text-xs text-secondary\">{item.body}</span>\n          <span className=\"block text-caption text-muted\">{timeOf(item.created_at)}</span>\n        </span>\n      ),\n      trailing: isUnread ? <StatusDot tone=\"brand\" aria-label={list.unread} /> : undefined,\n      onSelect: () => onOpen(item),\n    };\n  });\n  if (entries.length > 0) entries.push({ kind: \"divider\", key: \"divider\" });\n  entries.push({ kind: \"link\", key: \"all\", to: href, label: labels.allNotifications });\n\n  return (\n    <TopBarActionMenu\n      aria-label={labels.bellLabel}\n      triggerAttributes={{ \"data-notification-bell\": \"\" }}\n      trigger={() => (\n        <span className=\"relative inline-flex\" data-unread={unread ? unreadCount : undefined}>\n          <Bell aria-hidden className=\"size-5\" />\n          {unread && (\n            <>\n              <span\n                aria-hidden\n                data-badge=\"\"\n                className=\"pointer-events-none absolute -end-2 -top-1.5 h-4 min-w-4 rounded-full bg-danger px-1 text-center text-micro font-semibold leading-4 text-danger-contrast\"\n              >\n                {badgeText(unreadCount)}\n              </span>\n              <span className=\"sr-only\">{labels.bellUnread(unreadCount)}</span>\n            </>\n          )}\n        </span>\n      )}\n      header={\n        shown.length === 0\n          ? { title: labels.inboxTitle, subtitle: items === undefined ? labels.inboxLoading : labels.inboxEmpty }\n          : undefined\n      }\n      entries={entries}\n      panelClassName=\"w-80 max-w-[calc(100vw-2rem)]\"\n    />\n  );\n}\n"],"mappings":";AAqEY,SAwBA,UAxBA,KAEJ,YAFI;AArEZ,SAAS,YAAY;AAGrB,SAAS,oBAAwC;AACjD,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AACpC,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB;AAEjC,SAAS,8BAA8B;AAKvC,MAAM,YAAY;AAoBlB,MAAM,YAAY,CAAC,UAAmB,QAAQ,KAAK,QAAQ,OAAO,KAAK,MAAM,KAAK,CAAC;AAc5E,SAAS,iBAA+D;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ,QAAQ;AACV,GAA8B;AAC5B,QAAM,SAAS,uBAAuB,UAAU;AAChD,QAAM,OAAO,aAAa,QAAQ,mBAAmB;AACrD,QAAM,EAAE,WAAW,IAAI,aAAa;AACpC,QAAM,SAAS,CAAC,QAAiB,iBAAiB,eAAe,GAAG,IAAI,WAAW,KAAK,UAAU;AAClG,QAAM,SAAS,cAAc;AAC7B,QAAM,SAAS,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS;AAE9C,QAAM,UAA6B,MAAM,IAAI,CAAC,SAAS;AACrD,UAAM,OAAO,OAAO,KAAK,iBAAiB,KAAK;AAC/C,UAAM,WAAW,KAAK,YAAY;AAClC,WAAO;AAAA,MACL,KAAK,QAAQ,OAAO,KAAK,EAAE,CAAC;AAAA,MAC5B,MAAM,oBAAC,QAAK,eAAW,MAAC,WAAU,UAAS;AAAA,MAC3C,OACE,qBAAC,UAAK,WAAU,iBAAgB,kBAAgB,OAAO,KAAK,EAAE,GAC3D;AAAA,aAAK,WAAW,oBAAC,UAAK,WAAU,0CAA0C,eAAK,SAAQ;AAAA,QACxF,oBAAC,UAAK,WAAW,WAAW,wBAAwB,SAAU,eAAK,OAAM;AAAA,QACzE,oBAAC,UAAK,WAAU,6CAA6C,eAAK,MAAK;AAAA,QACvE,oBAAC,UAAK,WAAU,iCAAiC,iBAAO,KAAK,UAAU,GAAE;AAAA,SAC3E;AAAA,MAEF,UAAU,WAAW,oBAAC,aAAU,MAAK,SAAQ,cAAY,KAAK,QAAQ,IAAK;AAAA,MAC3E,UAAU,MAAM,OAAO,IAAI;AAAA,IAC7B;AAAA,EACF,CAAC;AACD,MAAI,QAAQ,SAAS,EAAG,SAAQ,KAAK,EAAE,MAAM,WAAW,KAAK,UAAU,CAAC;AACxE,UAAQ,KAAK,EAAE,MAAM,QAAQ,KAAK,OAAO,IAAI,MAAM,OAAO,OAAO,iBAAiB,CAAC;AAEnF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,OAAO;AAAA,MACnB,mBAAmB,EAAE,0BAA0B,GAAG;AAAA,MAClD,SAAS,MACP,qBAAC,UAAK,WAAU,wBAAuB,eAAa,SAAS,cAAc,QACzE;AAAA,4BAAC,QAAK,eAAW,MAAC,WAAU,UAAS;AAAA,QACpC,UACC,iCACE;AAAA;AAAA,YAAC;AAAA;AAAA,cACC,eAAW;AAAA,cACX,cAAW;AAAA,cACX,WAAU;AAAA,cAET,oBAAU,WAAW;AAAA;AAAA,UACxB;AAAA,UACA,oBAAC,UAAK,WAAU,WAAW,iBAAO,WAAW,WAAW,GAAE;AAAA,WAC5D;AAAA,SAEJ;AAAA,MAEF,QACE,MAAM,WAAW,IACb,EAAE,OAAO,OAAO,YAAY,UAAU,UAAU,SAAY,OAAO,eAAe,OAAO,WAAW,IACpG;AAAA,MAEN;AAAA,MACA,gBAAe;AAAA;AAAA,EACjB;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/notifications/notification-bell.tsx"],"sourcesContent":["import { Bell } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { useDayFormatter } from \"../lib/day-format\";\nimport { DEFAULT_LIST_LABELS } from \"../components/list-labels\";\nimport { StatusDot } from \"../components/status-dot\";\nimport { TopBarActionMenu } from \"../shell/topbar-action-menu\";\nimport type { TopBarMenuEntry } from \"../shell/topbar-action-menu\";\nimport { useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { NotificationInboxItem } from \"./notification-inbox\";\n\n/** How many rows the bell's panel shows: the newest 20 (§10.1). */\nconst BELL_ROWS = 20;\n\nexport interface NotificationBellProps<Id extends string | number = string | number> {\n  /** The inbox, newest first (the bell shows the first 20); `undefined` while it loads. */\n  items: readonly NotificationInboxItem<Id>[] | undefined;\n  /** Every unread row of the account (`unread_count`): the badge. */\n  unreadCount: number;\n  /** Open a row: the app marks it read and routes to `item.url` (kastlan switches the\n   *  acting company first, to `item.company_id`). The panel closes. */\n  onOpen: (item: NotificationInboxItem<Id>) => void;\n  /** The app's inbox page or card, for \"All notifications\". */\n  href: string;\n  /** The row's glyph for a type, as {@link NotificationInbox}'s; `Bell` by default. */\n  icon?: (type: string) => LucideIcon | undefined;\n  /** A row's time. Default: the provider's `formatDate` (the app's date preference) with\n   *  the language's clock, else date and time in the provider's locale and `timeZone`. */\n  formatDate?: (iso: string) => string;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/** The badge's text: \"99+\" past 99. */\nconst badgeText = (count: number) => (count > 99 ? \"99+\" : String(Math.floor(count)));\n\n/**\n * The top bar's bell (0.46, docs/notifications-harmonization.md §10.1), for\n * `TopBarActions`' `notifications` slot, right before the account menu: an icon button\n * with the unread count as a badge (\"99+\" past 99), opening the newest 20 rows in the\n * kit's top-bar panel (`TopBarActionMenu`) with \"All notifications\" under them.\n *\n * **Optional per app.** \"One badge per signal\": an app shows the bell or an unread dot on\n * the avatar, never both — keksdose keeps its avatar dot and no bell; kastlan's inbox\n * lives in the bell. Shown to every signed-in account in an app that keeps an inbox, the\n * demo included. Props only, as the inbox list: poll the count every\n * {@link INBOX_BADGE_INTERVAL}.\n */\nexport function NotificationBell<Id extends string | number = string | number>({\n  items,\n  unreadCount,\n  onOpen,\n  href,\n  icon,\n  formatDate: formatDateProp,\n  labels: labelsProp,\n}: NotificationBellProps<Id>) {\n  const labels = useNotificationsLabels(labelsProp);\n  const list = useKitLabels(\"list\", DEFAULT_LIST_LABELS);\n  // As the inbox's rows: the prop, else the provider's `formatDate` with the language's\n  // clock, else the kit's in the provider's locale and `timeZone` (refactor audit 2026-10-30, DUP-2).\n  const day = useDayFormatter(formatDateProp);\n  const timeOf = (iso: string) => day(iso, { time: true });\n  const unread = unreadCount > 0;\n  const shown = (items ?? []).slice(0, BELL_ROWS);\n\n  const entries: TopBarMenuEntry[] = shown.map((item) => {\n    const Icon = icon?.(item.notification_type) ?? Bell;\n    const isUnread = item.read_at === null;\n    return {\n      key: `item-${String(item.id)}`,\n      icon: <Icon aria-hidden className=\"size-4\" />,\n      label: (\n        <span className=\"block min-w-0\" data-bell-item={String(item.id)}>\n          {item.company && <span className=\"block truncate text-caption text-muted\">{item.company}</span>}\n          <span className={isUnread ? \"block font-semibold\" : \"block\"}>{item.title}</span>\n          <span className=\"block line-clamp-2 text-xs text-secondary\">{item.body}</span>\n          <span className=\"block text-caption text-muted\">{timeOf(item.created_at)}</span>\n        </span>\n      ),\n      trailing: isUnread ? <StatusDot tone=\"brand\" aria-label={list.unread} /> : undefined,\n      onSelect: () => onOpen(item),\n    };\n  });\n  if (entries.length > 0) entries.push({ kind: \"divider\", key: \"divider\" });\n  entries.push({ kind: \"link\", key: \"all\", to: href, label: labels.allNotifications });\n\n  return (\n    <TopBarActionMenu\n      aria-label={labels.bellLabel}\n      triggerAttributes={{ \"data-notification-bell\": \"\" }}\n      trigger={() => (\n        <span className=\"relative inline-flex\" data-unread={unread ? unreadCount : undefined}>\n          <Bell aria-hidden className=\"size-5\" />\n          {unread && (\n            <>\n              <span\n                aria-hidden\n                data-badge=\"\"\n                className=\"pointer-events-none absolute -end-2 -top-1.5 h-4 min-w-4 rounded-full bg-danger px-1 text-center text-micro font-semibold leading-4 text-danger-contrast\"\n              >\n                {badgeText(unreadCount)}\n              </span>\n              <span className=\"sr-only\">{labels.bellUnread(unreadCount)}</span>\n            </>\n          )}\n        </span>\n      )}\n      header={\n        shown.length === 0\n          ? { title: labels.inboxTitle, subtitle: items === undefined ? labels.inboxLoading : labels.inboxEmpty }\n          : undefined\n      }\n      entries={entries}\n      panelClassName=\"w-80 max-w-[calc(100vw-2rem)]\"\n    />\n  );\n}\n"],"mappings":";AAwEY,SAwBA,UAxBA,KAEJ,YAFI;AAxEZ,SAAS,YAAY;AAGrB,SAAS,oBAAwC;AACjD,SAAS,uBAAuB;AAChC,SAAS,2BAA2B;AACpC,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB;AAEjC,SAAS,8BAA8B;AAKvC,MAAM,YAAY;AAqBlB,MAAM,YAAY,CAAC,UAAmB,QAAQ,KAAK,QAAQ,OAAO,KAAK,MAAM,KAAK,CAAC;AAc5E,SAAS,iBAA+D;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ,QAAQ;AACV,GAA8B;AAC5B,QAAM,SAAS,uBAAuB,UAAU;AAChD,QAAM,OAAO,aAAa,QAAQ,mBAAmB;AAGrD,QAAM,MAAM,gBAAgB,cAAc;AAC1C,QAAM,SAAS,CAAC,QAAgB,IAAI,KAAK,EAAE,MAAM,KAAK,CAAC;AACvD,QAAM,SAAS,cAAc;AAC7B,QAAM,SAAS,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS;AAE9C,QAAM,UAA6B,MAAM,IAAI,CAAC,SAAS;AACrD,UAAM,OAAO,OAAO,KAAK,iBAAiB,KAAK;AAC/C,UAAM,WAAW,KAAK,YAAY;AAClC,WAAO;AAAA,MACL,KAAK,QAAQ,OAAO,KAAK,EAAE,CAAC;AAAA,MAC5B,MAAM,oBAAC,QAAK,eAAW,MAAC,WAAU,UAAS;AAAA,MAC3C,OACE,qBAAC,UAAK,WAAU,iBAAgB,kBAAgB,OAAO,KAAK,EAAE,GAC3D;AAAA,aAAK,WAAW,oBAAC,UAAK,WAAU,0CAA0C,eAAK,SAAQ;AAAA,QACxF,oBAAC,UAAK,WAAW,WAAW,wBAAwB,SAAU,eAAK,OAAM;AAAA,QACzE,oBAAC,UAAK,WAAU,6CAA6C,eAAK,MAAK;AAAA,QACvE,oBAAC,UAAK,WAAU,iCAAiC,iBAAO,KAAK,UAAU,GAAE;AAAA,SAC3E;AAAA,MAEF,UAAU,WAAW,oBAAC,aAAU,MAAK,SAAQ,cAAY,KAAK,QAAQ,IAAK;AAAA,MAC3E,UAAU,MAAM,OAAO,IAAI;AAAA,IAC7B;AAAA,EACF,CAAC;AACD,MAAI,QAAQ,SAAS,EAAG,SAAQ,KAAK,EAAE,MAAM,WAAW,KAAK,UAAU,CAAC;AACxE,UAAQ,KAAK,EAAE,MAAM,QAAQ,KAAK,OAAO,IAAI,MAAM,OAAO,OAAO,iBAAiB,CAAC;AAEnF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,OAAO;AAAA,MACnB,mBAAmB,EAAE,0BAA0B,GAAG;AAAA,MAClD,SAAS,MACP,qBAAC,UAAK,WAAU,wBAAuB,eAAa,SAAS,cAAc,QACzE;AAAA,4BAAC,QAAK,eAAW,MAAC,WAAU,UAAS;AAAA,QACpC,UACC,iCACE;AAAA;AAAA,YAAC;AAAA;AAAA,cACC,eAAW;AAAA,cACX,cAAW;AAAA,cACX,WAAU;AAAA,cAET,oBAAU,WAAW;AAAA;AAAA,UACxB;AAAA,UACA,oBAAC,UAAK,WAAU,WAAW,iBAAO,WAAW,WAAW,GAAE;AAAA,WAC5D;AAAA,SAEJ;AAAA,MAEF,QACE,MAAM,WAAW,IACb,EAAE,OAAO,OAAO,YAAY,UAAU,UAAU,SAAY,OAAO,eAAe,OAAO,WAAW,IACpG;AAAA,MAEN;AAAA,MACA,gBAAe;AAAA;AAAA,EACjB;AAEJ;","names":[]}

package/dist/notifications/notification-inbox.d.ts

@@ -12,7 +12,8 @@ export interface NotificationInboxItem<Id extends string | number = string | num
     notification_type: string;
     title: string;
     body: string;
-    /** A path in the app, an absolute URL, or `null` (nothing to open). */
+    /** A path in the app, or `null` (nothing to open). Never `//` or a scheme (§3.7): a url
+     *  that does not resolve to this origin is drawn as a row with nothing to open. */
     url: string | null;
     /** ISO date-time. */
     created_at: string;
@@ -40,10 +41,12 @@ export interface NotificationInboxProps<Id extends string | number = string | nu
     onClear: () => Promise<unknown> | void;
     /**
      * Open a row: the kit marks it read first, then calls this, and the app routes to
-     * `item.url` (kastlan switches the acting company, `item.company_id`, first). Every row is a button then.
-     * Left out, a row with a `url` is a real link — an in-app path through the provider's
-     * router link, an absolute URL in a new tab — that marks itself read on a click or a
-     * middle click (keksdose #451), and a row without one marks itself read.
+     * `item.url` (kastlan switches the acting company, `item.company_id`, first) — through
+     * `safeNextPath`, as the kit does. Every row is a button then.
+     * Left out, a row with a `url` is a real link through the provider's router link — the
+     * url as a same-origin path (`safeNextPath`) — that marks itself read on a click or a
+     * middle click (keksdose #451). A row without one, or with one that leaves the origin
+     * (`//host`, a scheme), marks itself read and opens nothing.
      */
     onOpen?: (item: NotificationInboxItem<Id>) => void;
     /** The row's glyph for a type — the app's map (keksdose's `TYPE_ICONS`). `undefined`,
@@ -55,7 +58,8 @@ export interface NotificationInboxProps<Id extends string | number = string | nu
     onLoadMore?: () => void;
     /** The next page is loading. */
     loadingMore?: boolean;
-    /** A row's time. Default: the provider's locale and `timeZone`, date and time. */
+    /** A row's time. Default: the provider's `formatDate` (the app's date preference) with
+     *  the language's clock, else date and time in the provider's locale and `timeZone`. */
     formatDate?: (iso: string) => string;
     /** The heading. Default `labels.inboxTitle` ("Inbox"). */
     title?: ReactNode;

package/dist/notifications/notification-inbox.js

@@ -1,20 +1,22 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useId, useRef, useState } from "react";
+import { useId, useRef, useState } from "react";
 import { Bell, CheckCheck, Trash2 } from "lucide-react";
 import { useKitLabels } from "../i18n/kit-labels.js";
 import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels.js";
 import { cn } from "../lib/cn.js";
-import { useKitFormat } from "../lib/format.js";
+import { useDayFormatter } from "../lib/day-format.js";
 import { Button } from "../components/button.js";
 import { Card } from "../components/card.js";
 import { EmptyState } from "../components/empty-state.js";
 import { IconButton } from "../components/icon-button.js";
+import { InlineConfirm } from "../components/inline-confirm.js";
 import { List, ListItem } from "../components/list.js";
 import { Skeleton } from "../components/skeleton.js";
 import { COMMIT_EXCEPT_BILLING } from "../components/write-lock.js";
 import { SettingsCardTitle } from "../settings/settings-heading.js";
-import { settle, useMounted } from "../account/account-parts.js";
+import { safeNextPath } from "../landing/routing.js";
+import { settle, useMounted } from "../hooks/use-mounted.js";
 import { describeFailure, FailureLine, useNotificationsLabels } from "./notification-parts.js";
 function NotificationInbox({
   items,
@@ -36,20 +38,14 @@ function NotificationInbox({
 }) {
   const labels = useNotificationsLabels(labelsProp);
   const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
-  const { formatDate } = useKitFormat();
+  const day = useDayFormatter(formatDateProp);
   const [asking, setAsking] = useState(false);
   const [busy, setBusy] = useState(null);
   const [failure, setFailure] = useState(null);
   const mounted = useMounted();
   const headingId = useId();
-  const cancelRef = useRef(null);
   const clearRef = useRef(null);
-  const [returning, setReturning] = useState(false);
-  useEffect(() => {
-    if (asking) cancelRef.current?.focus();
-    else if (returning) clearRef.current?.focus();
-  }, [asking, returning]);
-  const timeOf = (iso) => formatDateProp ? formatDateProp(iso) : formatDate(iso, "dateTime");
+  const timeOf = (iso) => day(iso, { time: true });
   const iconOf = (type) => icon?.(type) ?? Bell;
   const run = (which, call, after) => {
     setBusy(which);
@@ -73,37 +69,22 @@ function NotificationInbox({
       if (mounted.current) setFailure(describeFailure(describeError?.(error, "read"), labels.failed));
     });
   };
-  const leave = () => {
-    setReturning(true);
-    setAsking(false);
-  };
-  const escapeLeaves = (event) => {
-    if (event.key === "Escape") {
-      event.preventDefault();
-      event.stopPropagation();
-      leave();
-    }
-  };
   const count = items?.length ?? 0;
-  const header = asking ? /* @__PURE__ */ jsxs("div", { className: "space-y-2 border-b border-subtle px-3 py-2", "data-inbox-confirm": "", children: [
-    /* @__PURE__ */ jsx("p", { role: "alert", className: "text-sm", children: labels.clearPrompt }),
-    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-2", children: [
-      /* @__PURE__ */ jsx(
-        Button,
-        {
-          type: "button",
-          size: "sm",
-          variant: "danger",
-          commit: COMMIT_EXCEPT_BILLING,
-          pending: busy === "clear",
-          onClick: () => run("clear", onClear, () => setAsking(false)),
-          onKeyDown: escapeLeaves,
-          children: labels.clearAll
-        }
-      ),
-      /* @__PURE__ */ jsx(Button, { ref: cancelRef, type: "button", size: "sm", variant: "ghost", onClick: leave, onKeyDown: escapeLeaves, children: common.cancel })
-    ] })
-  ] }) : /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2 border-b border-subtle px-3 py-2", children: [
+  const header = asking ? /* @__PURE__ */ jsx(
+    InlineConfirm,
+    {
+      className: "border-b border-subtle px-3 py-2",
+      "data-inbox-confirm": "",
+      prompt: labels.clearPrompt,
+      confirmLabel: labels.clearAll,
+      cancelLabel: common.cancel,
+      onConfirm: () => run("clear", onClear, () => setAsking(false)),
+      onLeave: () => setAsking(false),
+      busy: busy === "clear",
+      commit: COMMIT_EXCEPT_BILLING,
+      returnFocusRef: clearRef
+    }
+  ) : /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-2 border-b border-subtle px-3 py-2", children: [
     /* @__PURE__ */ jsx(SettingsCardTitle, { id: headingId, children: title ?? labels.inboxTitle }),
     /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-0.5", children: [
       /* @__PURE__ */ jsx(
@@ -127,10 +108,7 @@ function NotificationInbox({
           size: "xs",
           tone: "danger",
           commit: COMMIT_EXCEPT_BILLING,
-          onClick: () => {
-            setReturning(false);
-            setAsking(true);
-          },
+          onClick: () => setAsking(true),
           disabled: count === 0 || busy !== null,
           label: labels.clearAll,
           children: /* @__PURE__ */ jsx(Trash2, {})
@@ -177,7 +155,8 @@ function NotificationInbox({
                 item.id
               );
             }
-            if (!item.url) {
+            const path = safeNextPath(item.url);
+            if (!path) {
               return /* @__PURE__ */ jsx(ListItem, { ...row, "data-inbox-item": String(item.id), onClick: () => markOne(item) }, item.id);
             }
             return /* @__PURE__ */ jsx(
@@ -185,8 +164,7 @@ function NotificationInbox({
               {
                 ...row,
                 "data-inbox-item": String(item.id),
-                href: item.url,
-                external: !item.url.startsWith("/"),
+                href: path,
                 onClick: () => markOne(item),
                 onAuxClick: (event) => {
                   if (event.button === 1) markOne(item);

package/dist/notifications/notification-inbox.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/notification-inbox.tsx"],"sourcesContent":["import { useEffect, useId, useRef, useState } from \"react\";\nimport type { ComponentPropsWithRef, KeyboardEvent, ReactNode } from \"react\";\nimport { Bell, CheckCheck, Trash2 } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_COMMON_LABELS } from \"../i18n/shared-labels\";\nimport { cn } from \"../lib/cn\";\nimport { useKitFormat } from \"../lib/format\";\nimport { Button } from \"../components/button\";\nimport { Card } from \"../components/card\";\nimport { EmptyState } from \"../components/empty-state\";\nimport { IconButton } from \"../components/icon-button\";\nimport { List, ListItem } from \"../components/list\";\nimport { Skeleton } from \"../components/skeleton\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { settle, useMounted } from \"../account/account-parts\";\nimport { describeFailure, FailureLine, useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * One inbox row as `GET /notifications/inbox` answers it (server-kit `InboxItem`, §3.7):\n * the title and body already in the recipient's language.\n */\nexport interface NotificationInboxItem<Id extends string | number = string | number> {\n  id: Id;\n  /** The type id, for the row's icon. */\n  notification_type: string;\n  title: string;\n  body: string;\n  /** A path in the app, an absolute URL, or `null` (nothing to open). */\n  url: string | null;\n  /** ISO date-time. */\n  created_at: string;\n  /** ISO date-time, or `null` while unread. */\n  read_at: string | null;\n  /** 0.46 (server-kit 0.16 `InboxItem.company`): the company the row is about, named on\n   *  the row — kastlan's inbox holds every company's rows. */\n  company?: string | null;\n  /** 0.46.1 (server-kit 0.16.1 `InboxItem.company_id`): the same company by its id, so\n   *  `onOpen` switches to it exactly (two companies may share a name). */\n  company_id?: number | string | null;\n}\n\n/** The inbox request that failed, as `describeError` gets it (0.46.1): one row marked read,\n *  \"Mark all as read\", or \"Clear all\". */\nexport type NotificationInboxAction = \"read\" | \"readAll\" | \"clear\";\n\nexport interface NotificationInboxProps<Id extends string | number = string | number> extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"children\" | \"title\"\n> {\n  /** The rows, newest first; `undefined` while the first page loads. */\n  items: readonly NotificationInboxItem<Id>[] | undefined;\n  /** Every unread row of the account (`unread_count`), not only this page's. */\n  unreadCount: number;\n  loading?: boolean;\n  /** `POST /notifications/inbox/read {ids}` — these rows, or `null` for all. */\n  onMarkRead: (ids: Id[] | null) => Promise<unknown> | void;\n  /** `DELETE /notifications/inbox`. Asked first, in the header. */\n  onClear: () => Promise<unknown> | void;\n  /**\n   * Open a row: the kit marks it read first, then calls this, and the app routes to\n   * `item.url` (kastlan switches the acting company, `item.company_id`, first). Every row is a button then.\n   * Left out, a row with a `url` is a real link — an in-app path through the provider's\n   * router link, an absolute URL in a new tab — that marks itself read on a click or a\n   * middle click (keksdose #451), and a row without one marks itself read.\n   */\n  onOpen?: (item: NotificationInboxItem<Id>) => void;\n  /** The row's glyph for a type — the app's map (keksdose's `TYPE_ICONS`). `undefined`,\n   *  or a type it does not know (a retired one), is the `Bell`. */\n  icon?: (type: string) => LucideIcon | undefined;\n  /** More rows than shown: a \"Show more\" row calls `onLoadMore` (the API pages by\n   *  `offset`). */\n  hasMore?: boolean;\n  onLoadMore?: () => void;\n  /** The next page is loading. */\n  loadingMore?: boolean;\n  /** A row's time. Default: the provider's locale and `timeZone`, date and time. */\n  formatDate?: (iso: string) => string;\n  /** The heading. Default `labels.inboxTitle` (\"Inbox\"). */\n  title?: ReactNode;\n  /** The app's own words for a failed request, or `undefined` for the kit's `failed`.\n   *  `action` (0.46.1) says which request failed: `\"read\"` (one row), `\"readAll\"` (\"Mark\n   *  all as read\") or `\"clear\"` (\"Clear all\") — so a failed mark-read is not worded as a\n   *  failed clear. */\n  describeError?: (error: unknown, action: NotificationInboxAction) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/**\n * The in-app inbox (0.46, docs/notifications-harmonization.md §10.1), keksdose's list\n * lifted: newest first, an icon per type (`Bell` for one the app does not map), the\n * title and two lines of body, the time, and — kastlan — the company the row is about.\n * Unread rows are bold with a dot. Props only: the app keeps the data (poll the badge\n * every {@link INBOX_BADGE_INTERVAL}, invalidate on its worker's push message).\n *\n * - **Opening a row marks it read** (see `onOpen`).\n * - **\"Mark all as read\"** while anything is unread; **\"Clear all\"** asks first, in the\n *   header — no `ConfirmProvider` needed — with focus on Cancel.\n * - **\"Show more\"** with `hasMore`; the list scrolls inside a box of at most\n *   `min(24rem, 70vh)`, so it never pushes the settings below it off the page.\n *\n * Under a write lock the header's actions are `commit` controls exempt from billing.\n */\nexport function NotificationInbox<Id extends string | number = string | number>({\n  items,\n  unreadCount,\n  loading,\n  onMarkRead,\n  onClear,\n  onOpen,\n  icon,\n  hasMore = false,\n  onLoadMore,\n  loadingMore = false,\n  formatDate: formatDateProp,\n  title,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: NotificationInboxProps<Id>) {\n  const labels = useNotificationsLabels(labelsProp);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n  const { formatDate } = useKitFormat();\n  const [asking, setAsking] = useState(false);\n  const [busy, setBusy] = useState<\"read\" | \"clear\" | null>(null);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const headingId = useId();\n  const cancelRef = useRef<HTMLButtonElement>(null);\n  const clearRef = useRef<HTMLButtonElement>(null);\n  const [returning, setReturning] = useState(false);\n  useEffect(() => {\n    if (asking) cancelRef.current?.focus();\n    else if (returning) clearRef.current?.focus();\n  }, [asking, returning]);\n\n  const timeOf = (iso: string) => (formatDateProp ? formatDateProp(iso) : formatDate(iso, \"dateTime\"));\n  const iconOf = (type: string): LucideIcon => icon?.(type) ?? Bell;\n\n  const run = (which: \"read\" | \"clear\", call: () => unknown, after?: () => void) => {\n    setBusy(which);\n    setFailure(null);\n    settle(call).then(\n      () => {\n        if (!mounted.current) return;\n        setBusy(null);\n        after?.();\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        setBusy(null);\n        setFailure(describeFailure(describeError?.(error, which === \"read\" ? \"readAll\" : \"clear\"), labels.failed));\n      },\n    );\n  };\n\n  /** Mark one row read; a failure is said under the list, the row stays as it is. */\n  const markOne = (item: NotificationInboxItem<Id>) => {\n    if (item.read_at !== null) return;\n    settle(() => onMarkRead([item.id])).catch((error: unknown) => {\n      if (mounted.current) setFailure(describeFailure(describeError?.(error, \"read\"), labels.failed));\n    });\n  };\n\n  const leave = () => {\n    setReturning(true);\n    setAsking(false);\n  };\n  const escapeLeaves = (event: KeyboardEvent<HTMLButtonElement>) => {\n    if (event.key === \"Escape\") {\n      event.preventDefault();\n      event.stopPropagation();\n      leave();\n    }\n  };\n\n  const count = items?.length ?? 0;\n\n  const header = asking ? (\n    <div className=\"space-y-2 border-b border-subtle px-3 py-2\" data-inbox-confirm=\"\">\n      <p role=\"alert\" className=\"text-sm\">\n        {labels.clearPrompt}\n      </p>\n      <div className=\"flex flex-wrap gap-2\">\n        <Button\n          type=\"button\"\n          size=\"sm\"\n          variant=\"danger\"\n          commit={COMMIT_EXCEPT_BILLING}\n          pending={busy === \"clear\"}\n          onClick={() => run(\"clear\", onClear, () => setAsking(false))}\n          onKeyDown={escapeLeaves}\n        >\n          {labels.clearAll}\n        </Button>\n        <Button ref={cancelRef} type=\"button\" size=\"sm\" variant=\"ghost\" onClick={leave} onKeyDown={escapeLeaves}>\n          {common.cancel}\n        </Button>\n      </div>\n    </div>\n  ) : (\n    <div className=\"flex items-center justify-between gap-2 border-b border-subtle px-3 py-2\">\n      <SettingsCardTitle id={headingId}>{title ?? labels.inboxTitle}</SettingsCardTitle>\n      <div className=\"flex items-center gap-0.5\">\n        <IconButton\n          type=\"button\"\n          size=\"xs\"\n          tone=\"muted\"\n          commit={COMMIT_EXCEPT_BILLING}\n          onClick={() => run(\"read\", () => onMarkRead(null))}\n          disabled={unreadCount === 0 || busy !== null}\n          label={labels.markAllRead}\n        >\n          <CheckCheck />\n        </IconButton>\n        <IconButton\n          ref={clearRef}\n          type=\"button\"\n          size=\"xs\"\n          tone=\"danger\"\n          commit={COMMIT_EXCEPT_BILLING}\n          onClick={() => {\n            setReturning(false);\n            setAsking(true);\n          }}\n          disabled={count === 0 || busy !== null}\n          label={labels.clearAll}\n        >\n          <Trash2 />\n        </IconButton>\n      </div>\n    </div>\n  );\n\n  let body: ReactNode;\n  if (loading || items === undefined) {\n    body = <Skeleton lines={3} label={labels.inboxLoading} className=\"p-3\" />;\n  } else if (items.length === 0) {\n    body = <EmptyState variant=\"inline\" title={labels.inboxEmpty} className=\"px-3 py-2\" />;\n  } else {\n    body = (\n      // Named by the heading — except while \"Clear all\" asks, when the heading is away.\n      <List\n        className=\"p-1\"\n        aria-labelledby={asking ? undefined : headingId}\n        aria-label={asking ? labels.inboxTitle : undefined}\n      >\n        {items.map((item) => {\n          const row = {\n            title: item.title,\n            subtitle: item.body,\n            subtitleLines: 2 as const,\n            overline: item.company ?? undefined,\n            meta: timeOf(item.created_at),\n            icon: iconOf(item.notification_type),\n            unread: item.read_at === null,\n            align: \"start\" as const,\n          };\n          if (onOpen) {\n            return (\n              <ListItem\n                key={item.id}\n                {...row}\n                data-inbox-item={String(item.id)}\n                onClick={() => {\n                  markOne(item);\n                  onOpen(item);\n                }}\n              />\n            );\n          }\n          if (!item.url) {\n            return <ListItem key={item.id} {...row} data-inbox-item={String(item.id)} onClick={() => markOne(item)} />;\n          }\n          // A real link, so a middle click opens a background tab; a middle click fires no\n          // `click`, hence `onAuxClick` (keksdose #451).\n          return (\n            <ListItem\n              key={item.id}\n              {...row}\n              data-inbox-item={String(item.id)}\n              href={item.url}\n              external={!item.url.startsWith(\"/\")}\n              onClick={() => markOne(item)}\n              onAuxClick={(event) => {\n                if (event.button === 1) markOne(item);\n              }}\n            />\n          );\n        })}\n        {hasMore && onLoadMore && (\n          <li className=\"px-2 py-1\">\n            <Button\n              type=\"button\"\n              size=\"sm\"\n              variant=\"ghost\"\n              pending={loadingMore}\n              onClick={onLoadMore}\n              className=\"w-full\"\n            >\n              {labels.showMore}\n            </Button>\n          </li>\n        )}\n      </List>\n    );\n  }\n\n  return (\n    <Card {...rest} className={cn(\"overflow-hidden p-0\", className)}>\n      {header}\n      <div className=\"max-h-[min(24rem,70vh)] overflow-y-auto overscroll-contain\">{body}</div>\n      {failure !== null && (\n        <div className=\"px-3 pb-3\">\n          <FailureLine>{failure}</FailureLine>\n        </div>\n      )}\n    </Card>\n  );\n}\n\n/** How often an app polls the unread count for the badge (keksdose's 60 s, `limit:1`). */\nexport const INBOX_BADGE_INTERVAL = 60_000;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/notifications/notification-inbox.tsx"],"sourcesContent":["import { useId, useRef, useState } from \"react\";\nimport type { ComponentPropsWithRef, ReactNode } from \"react\";\nimport { Bell, CheckCheck, Trash2 } from \"lucide-react\";\nimport type { LucideIcon } from \"lucide-react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_COMMON_LABELS } from \"../i18n/shared-labels\";\nimport { cn } from \"../lib/cn\";\nimport { useDayFormatter } from \"../lib/day-format\";\nimport { Button } from \"../components/button\";\nimport { Card } from \"../components/card\";\nimport { EmptyState } from \"../components/empty-state\";\nimport { IconButton } from \"../components/icon-button\";\nimport { InlineConfirm } from \"../components/inline-confirm\";\nimport { List, ListItem } from \"../components/list\";\nimport { Skeleton } from \"../components/skeleton\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { safeNextPath } from \"../landing/routing\";\nimport { settle, useMounted } from \"../hooks/use-mounted\";\nimport { describeFailure, FailureLine, useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * One inbox row as `GET /notifications/inbox` answers it (server-kit `InboxItem`, §3.7):\n * the title and body already in the recipient's language.\n */\nexport interface NotificationInboxItem<Id extends string | number = string | number> {\n  id: Id;\n  /** The type id, for the row's icon. */\n  notification_type: string;\n  title: string;\n  body: string;\n  /** A path in the app, or `null` (nothing to open). Never `//` or a scheme (§3.7): a url\n   *  that does not resolve to this origin is drawn as a row with nothing to open. */\n  url: string | null;\n  /** ISO date-time. */\n  created_at: string;\n  /** ISO date-time, or `null` while unread. */\n  read_at: string | null;\n  /** 0.46 (server-kit 0.16 `InboxItem.company`): the company the row is about, named on\n   *  the row — kastlan's inbox holds every company's rows. */\n  company?: string | null;\n  /** 0.46.1 (server-kit 0.16.1 `InboxItem.company_id`): the same company by its id, so\n   *  `onOpen` switches to it exactly (two companies may share a name). */\n  company_id?: number | string | null;\n}\n\n/** The inbox request that failed, as `describeError` gets it (0.46.1): one row marked read,\n *  \"Mark all as read\", or \"Clear all\". */\nexport type NotificationInboxAction = \"read\" | \"readAll\" | \"clear\";\n\nexport interface NotificationInboxProps<Id extends string | number = string | number> extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"children\" | \"title\"\n> {\n  /** The rows, newest first; `undefined` while the first page loads. */\n  items: readonly NotificationInboxItem<Id>[] | undefined;\n  /** Every unread row of the account (`unread_count`), not only this page's. */\n  unreadCount: number;\n  loading?: boolean;\n  /** `POST /notifications/inbox/read {ids}` — these rows, or `null` for all. */\n  onMarkRead: (ids: Id[] | null) => Promise<unknown> | void;\n  /** `DELETE /notifications/inbox`. Asked first, in the header. */\n  onClear: () => Promise<unknown> | void;\n  /**\n   * Open a row: the kit marks it read first, then calls this, and the app routes to\n   * `item.url` (kastlan switches the acting company, `item.company_id`, first) — through\n   * `safeNextPath`, as the kit does. Every row is a button then.\n   * Left out, a row with a `url` is a real link through the provider's router link — the\n   * url as a same-origin path (`safeNextPath`) — that marks itself read on a click or a\n   * middle click (keksdose #451). A row without one, or with one that leaves the origin\n   * (`//host`, a scheme), marks itself read and opens nothing.\n   */\n  onOpen?: (item: NotificationInboxItem<Id>) => void;\n  /** The row's glyph for a type — the app's map (keksdose's `TYPE_ICONS`). `undefined`,\n   *  or a type it does not know (a retired one), is the `Bell`. */\n  icon?: (type: string) => LucideIcon | undefined;\n  /** More rows than shown: a \"Show more\" row calls `onLoadMore` (the API pages by\n   *  `offset`). */\n  hasMore?: boolean;\n  onLoadMore?: () => void;\n  /** The next page is loading. */\n  loadingMore?: boolean;\n  /** A row's time. Default: the provider's `formatDate` (the app's date preference) with\n   *  the language's clock, else date and time in the provider's locale and `timeZone`. */\n  formatDate?: (iso: string) => string;\n  /** The heading. Default `labels.inboxTitle` (\"Inbox\"). */\n  title?: ReactNode;\n  /** The app's own words for a failed request, or `undefined` for the kit's `failed`.\n   *  `action` (0.46.1) says which request failed: `\"read\"` (one row), `\"readAll\"` (\"Mark\n   *  all as read\") or `\"clear\"` (\"Clear all\") — so a failed mark-read is not worded as a\n   *  failed clear. */\n  describeError?: (error: unknown, action: NotificationInboxAction) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/**\n * The in-app inbox (0.46, docs/notifications-harmonization.md §10.1), keksdose's list\n * lifted: newest first, an icon per type (`Bell` for one the app does not map), the\n * title and two lines of body, the time, and — kastlan — the company the row is about.\n * Unread rows are bold with a dot. Props only: the app keeps the data (poll the badge\n * every {@link INBOX_BADGE_INTERVAL}, invalidate on its worker's push message).\n *\n * - **Opening a row marks it read** (see `onOpen`).\n * - **\"Mark all as read\"** while anything is unread; **\"Clear all\"** asks first, in the\n *   header — no `ConfirmProvider` needed — with focus on Cancel.\n * - **\"Show more\"** with `hasMore`; the list scrolls inside a box of at most\n *   `min(24rem, 70vh)`, so it never pushes the settings below it off the page.\n *\n * Under a write lock the header's actions are `commit` controls exempt from billing.\n */\nexport function NotificationInbox<Id extends string | number = string | number>({\n  items,\n  unreadCount,\n  loading,\n  onMarkRead,\n  onClear,\n  onOpen,\n  icon,\n  hasMore = false,\n  onLoadMore,\n  loadingMore = false,\n  formatDate: formatDateProp,\n  title,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: NotificationInboxProps<Id>) {\n  const labels = useNotificationsLabels(labelsProp);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n  // The prop, else the provider's `formatDate` with the language's clock, else the kit's\n  // date and time in the provider's locale and `timeZone` (refactor audit 2026-10-30, DUP-2).\n  const day = useDayFormatter(formatDateProp);\n  const [asking, setAsking] = useState(false);\n  const [busy, setBusy] = useState<\"read\" | \"clear\" | null>(null);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const headingId = useId();\n  // Back to \"Clear all\" when the confirm leaves, so focus does not fall to <body>.\n  const clearRef = useRef<HTMLButtonElement>(null);\n\n  const timeOf = (iso: string) => day(iso, { time: true });\n  const iconOf = (type: string): LucideIcon => icon?.(type) ?? Bell;\n\n  const run = (which: \"read\" | \"clear\", call: () => unknown, after?: () => void) => {\n    setBusy(which);\n    setFailure(null);\n    settle(call).then(\n      () => {\n        if (!mounted.current) return;\n        setBusy(null);\n        after?.();\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        setBusy(null);\n        setFailure(describeFailure(describeError?.(error, which === \"read\" ? \"readAll\" : \"clear\"), labels.failed));\n      },\n    );\n  };\n\n  /** Mark one row read; a failure is said under the list, the row stays as it is. */\n  const markOne = (item: NotificationInboxItem<Id>) => {\n    if (item.read_at !== null) return;\n    settle(() => onMarkRead([item.id])).catch((error: unknown) => {\n      if (mounted.current) setFailure(describeFailure(describeError?.(error, \"read\"), labels.failed));\n    });\n  };\n\n  const count = items?.length ?? 0;\n\n  const header = asking ? (\n    <InlineConfirm\n      className=\"border-b border-subtle px-3 py-2\"\n      data-inbox-confirm=\"\"\n      prompt={labels.clearPrompt}\n      confirmLabel={labels.clearAll}\n      cancelLabel={common.cancel}\n      onConfirm={() => run(\"clear\", onClear, () => setAsking(false))}\n      onLeave={() => setAsking(false)}\n      busy={busy === \"clear\"}\n      commit={COMMIT_EXCEPT_BILLING}\n      returnFocusRef={clearRef}\n    />\n  ) : (\n    <div className=\"flex items-center justify-between gap-2 border-b border-subtle px-3 py-2\">\n      <SettingsCardTitle id={headingId}>{title ?? labels.inboxTitle}</SettingsCardTitle>\n      <div className=\"flex items-center gap-0.5\">\n        <IconButton\n          type=\"button\"\n          size=\"xs\"\n          tone=\"muted\"\n          commit={COMMIT_EXCEPT_BILLING}\n          onClick={() => run(\"read\", () => onMarkRead(null))}\n          disabled={unreadCount === 0 || busy !== null}\n          label={labels.markAllRead}\n        >\n          <CheckCheck />\n        </IconButton>\n        <IconButton\n          ref={clearRef}\n          type=\"button\"\n          size=\"xs\"\n          tone=\"danger\"\n          commit={COMMIT_EXCEPT_BILLING}\n          onClick={() => setAsking(true)}\n          disabled={count === 0 || busy !== null}\n          label={labels.clearAll}\n        >\n          <Trash2 />\n        </IconButton>\n      </div>\n    </div>\n  );\n\n  let body: ReactNode;\n  if (loading || items === undefined) {\n    body = <Skeleton lines={3} label={labels.inboxLoading} className=\"p-3\" />;\n  } else if (items.length === 0) {\n    body = <EmptyState variant=\"inline\" title={labels.inboxEmpty} className=\"px-3 py-2\" />;\n  } else {\n    body = (\n      // Named by the heading — except while \"Clear all\" asks, when the heading is away.\n      <List\n        className=\"p-1\"\n        aria-labelledby={asking ? undefined : headingId}\n        aria-label={asking ? labels.inboxTitle : undefined}\n      >\n        {items.map((item) => {\n          const row = {\n            title: item.title,\n            subtitle: item.body,\n            subtitleLines: 2 as const,\n            overline: item.company ?? undefined,\n            meta: timeOf(item.created_at),\n            icon: iconOf(item.notification_type),\n            unread: item.read_at === null,\n            align: \"start\" as const,\n          };\n          if (onOpen) {\n            return (\n              <ListItem\n                key={item.id}\n                {...row}\n                data-inbox-item={String(item.id)}\n                onClick={() => {\n                  markOne(item);\n                  onOpen(item);\n                }}\n              />\n            );\n          }\n          // A same-origin path or nothing (refactor audit 2026-10-30, FLW-8): `//host` starts\n          // with \"/\" and went through the router link off the origin, and any scheme opened\n          // as an external link. The urls are server-written; this is defence in depth.\n          const path = safeNextPath(item.url);\n          if (!path) {\n            return <ListItem key={item.id} {...row} data-inbox-item={String(item.id)} onClick={() => markOne(item)} />;\n          }\n          // A real link, so a middle click opens a background tab; a middle click fires no\n          // `click`, hence `onAuxClick` (keksdose #451).\n          return (\n            <ListItem\n              key={item.id}\n              {...row}\n              data-inbox-item={String(item.id)}\n              href={path}\n              onClick={() => markOne(item)}\n              onAuxClick={(event) => {\n                if (event.button === 1) markOne(item);\n              }}\n            />\n          );\n        })}\n        {hasMore && onLoadMore && (\n          <li className=\"px-2 py-1\">\n            <Button\n              type=\"button\"\n              size=\"sm\"\n              variant=\"ghost\"\n              pending={loadingMore}\n              onClick={onLoadMore}\n              className=\"w-full\"\n            >\n              {labels.showMore}\n            </Button>\n          </li>\n        )}\n      </List>\n    );\n  }\n\n  return (\n    <Card {...rest} className={cn(\"overflow-hidden p-0\", className)}>\n      {header}\n      <div className=\"max-h-[min(24rem,70vh)] overflow-y-auto overscroll-contain\">{body}</div>\n      {failure !== null && (\n        <div className=\"px-3 pb-3\">\n          <FailureLine>{failure}</FailureLine>\n        </div>\n      )}\n    </Card>\n  );\n}\n\n/** How often an app polls the unread count for the badge (keksdose's 60 s, `limit:1`). */\nexport const INBOX_BADGE_INTERVAL = 60_000;\n"],"mappings":"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","names":[]}

package/dist/notifications/notification-parts.d.ts

@@ -9,8 +9,9 @@ import type { NotificationsLabels } from "./notifications-labels.js";
  */
 /** The `notifications` namespace: English, then the provider, then the card's prop. */
 export declare function useNotificationsLabels(prop?: LabelOverride<NotificationsLabels>): NotificationsLabels;
-/** The app's words for a failure, else `fallback`. */
-export declare function describeFailure(own: ReactNode | undefined, fallback: ReactNode): ReactNode;
+/** The app's words for a failure, else `fallback` — in lib/ since 0.52, for the auth forms
+ *  too (refactor audit 2026-10-30, DUP-14). */
+export { describeFailure } from "../lib/describe-failure.js";
 /** A failure, said under the card's controls — nothing toasts (§4.2). */
 export declare function FailureLine({ children }: {
     children: ReactNode;

package/dist/notifications/notification-parts.js

@@ -8,9 +8,7 @@ import { DEFAULT_NOTIFICATIONS_LABELS } from "./notifications-labels.js";
 function useNotificationsLabels(prop) {
   return useKitLabels("notifications", DEFAULT_NOTIFICATIONS_LABELS, prop);
 }
-function describeFailure(own, fallback) {
-  return hasContent(own) ? own : fallback;
-}
+import { describeFailure } from "../lib/describe-failure.js";
 function FailureLine({ children }) {
   if (!hasContent(children)) return null;
   return /* @__PURE__ */ jsx(AlertBanner, { tone: "danger", size: "sm", role: "alert", children });