@eifi1/ui-kit 0.51.6 → 0.52.0

package/dist/lib/text-match.js

@@ -8,6 +8,9 @@ function foldForSearch(text, locale) {
   }
   return lower.normalize("NFD").replace(/\p{M}+/gu, "").replace(/ß/g, "ss");
 }
+function sameName(a, b, locale) {
+  return foldForSearch(a.trim(), locale) === foldForSearch(b.trim(), locale);
+}
 function searchWords(query, locale) {
   return foldForSearch(query, locale).split(/\s+/).filter((word) => word !== "");
 }
@@ -19,15 +22,34 @@ function matchesSearch(words, texts, locale) {
 function rankMatch(label, query, { code, locale } = {}) {
   const q = foldForSearch(query.trim(), locale);
   if (!q) return 0;
-  const text = foldForSearch(label, locale);
-  if (text === q || code !== void 0 && foldForSearch(code, locale) === q) return 0;
+  return rankFolded(foldForSearch(label, locale), q, code === void 0 ? void 0 : foldForSearch(code, locale));
+}
+function rankFolded(text, q, code) {
+  if (text === q || code === q) return 0;
   if (text.startsWith(q)) return 1;
   return text.includes(q) ? 2 : -1;
 }
+function searchRanked(rows, query, texts, { code, locale } = {}) {
+  const q = foldForSearch(query.trim(), locale);
+  const words = q.split(/\s+/).filter((word) => word !== "");
+  if (words.length === 0) return rows.map((row) => ({ row, rank: 0 }));
+  const hits = [];
+  for (const row of rows) {
+    const folded = texts(row).filter((t) => t !== void 0).map((t) => foldForSearch(t, locale));
+    const key = code === void 0 ? void 0 : foldForSearch(code(row), locale);
+    const hay = folded.join("\n");
+    if (!words.every((word) => word === key || hay.includes(word))) continue;
+    const rank = rankFolded(folded[0] ?? "", q, key);
+    hits.push({ row, rank: rank === -1 ? 3 : rank });
+  }
+  return hits;
+}
 export {
   foldForSearch,
   matchesSearch,
   rankMatch,
+  sameName,
+  searchRanked,
   searchWords
 };
 //# sourceMappingURL=text-match.js.map

package/dist/lib/text-match.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/text-match.ts"],"sourcesContent":["/**\n * How typing into a kit list matches its rows — one rule for every list (DUP-5, refactor\n * audit 2026-10).\n *\n * There were six. \"zurich\" found Zürich in CountrySelect and the command palette and in no\n * EntityCombobox, Combobox, MultiSelect or DataTable text filter, where keksdose's\n * Swiss-German payees and categories and kastlan's eighteen entity pickers live; \"İ\"\n * folded by the locale in GroupedPicker and nowhere in the combobox family. The folding\n * only ever widens a match, so moving every list onto it took nothing away.\n */\n\n/**\n * A text as search compares it: the locale's lower case, accents off, ß spelt \"ss\" —\n * \"Zürich\" and \"ZURICH\" both read \"zurich\", \"Straße\" reads \"strasse\". Punctuation and\n * symbols stay: a currency is found by its \"€\", and \"c++\" is not the empty query.\n *\n * Lower-cased by the locale FIRST, then decomposed: the Turkish \"İ\" lower-cases to \"i\"\n * and the dotted capital's mark is then dropped like any other, so \"istanbul\" finds\n * \"İSTANBUL\" in every locale, while \"I\" folds to the dotless \"ı\" in Turkish alone.\n * `locale` left out is the runtime's default; a malformed tag folds as if left out.\n */\nexport function foldForSearch(text: string, locale?: string): string {\n  let lower: string;\n  try {\n    lower = text.toLocaleLowerCase(locale);\n  } catch {\n    lower = text.toLocaleLowerCase();\n  }\n  return lower\n    .normalize(\"NFD\")\n    .replace(/\\p{M}+/gu, \"\")\n    .replace(/ß/g, \"ss\");\n}\n\n/**\n * A picker's query as its words, each folded (0.51.4, keksdose's /prices shop picker):\n * \"Migros  Zürich\" → `[\"migros\", \"zurich\"]`. An empty or blank query has no words.\n */\nexport function searchWords(query: string, locale?: string): string[] {\n  return foldForSearch(query, locale)\n    .split(/\\s+/)\n    .filter((word) => word !== \"\");\n}\n\n/**\n * Whether a row matches a picker's query: EVERY word appears in at least one of the row's\n * texts — \"migros 8004\" finds a row named \"Migros · 8004 Zürich\", and a row whose chain is\n * its group and whose place is its label (pass both). Until 0.51.4 the whole query had to\n * be ONE substring of one text, so two words found nothing unless they stood side by side\n * in that order. One word matches exactly as before, and so does the old query when it\n * was a substring. No words match everything.\n *\n * `words` from {@link searchWords}; `texts` as they are (folded here), `undefined` skipped.\n *\n * Exported since 0.51.5 for an app's own async source: a picker shows `loadOptions`'\n * rows as they come, so a source that narrows on the client filters with this, the same\n * rule the kit applies to `options` (keksdose's shop picker past its first hundred shops).\n */\nexport function matchesSearch(\n  words: readonly string[],\n  texts: readonly (string | undefined)[],\n  locale?: string,\n): boolean {\n  if (words.length === 0) return true;\n  // One haystack per row; a word holds no whitespace, so it cannot match across the\n  // newline between two texts.\n  const hay = texts\n    .filter((t): t is string => t !== undefined)\n    .map((t) => foldForSearch(t, locale))\n    .join(\"\\n\");\n  return words.every((word) => hay.includes(word));\n}\n\n/** {@link rankMatch}'s answer: lower is better, `-1` is no match. */\nexport type MatchRank = -1 | 0 | 1 | 2;\n\n/**\n * How well `label` answers `query` — CountrySelect's ranking, for every list that orders\n * its hits:\n *\n * - `0`: the query IS the row — its `code` (\"ch\" means Switzerland before it means Chad)\n *   or the whole label;\n * - `1`: the label starts with it;\n * - `2`: the label contains it;\n * - `-1`: no match.\n *\n * Both sides are folded here ({@link foldForSearch}, by `locale`), so pass them as typed\n * and as shown. An empty query matches every row alike (`0`). Sort by the rank with a\n * stable sort, and rows of one rank keep the order they came in.\n */\nexport function rankMatch(\n  label: string,\n  query: string,\n  { code, locale }: { code?: string; locale?: string } = {},\n): MatchRank {\n  const q = foldForSearch(query.trim(), locale);\n  if (!q) return 0;\n  const text = foldForSearch(label, locale);\n  if (text === q || (code !== undefined && foldForSearch(code, locale) === q)) return 0;\n  if (text.startsWith(q)) return 1;\n  return text.includes(q) ? 2 : -1;\n}\n"],"mappings":";AAqBO,SAAS,cAAc,MAAc,QAAyB;AACnE,MAAI;AACJ,MAAI;AACF,YAAQ,KAAK,kBAAkB,MAAM;AAAA,EACvC,QAAQ;AACN,YAAQ,KAAK,kBAAkB;AAAA,EACjC;AACA,SAAO,MACJ,UAAU,KAAK,EACf,QAAQ,YAAY,EAAE,EACtB,QAAQ,MAAM,IAAI;AACvB;AAMO,SAAS,YAAY,OAAe,QAA2B;AACpE,SAAO,cAAc,OAAO,MAAM,EAC/B,MAAM,KAAK,EACX,OAAO,CAAC,SAAS,SAAS,EAAE;AACjC;AAgBO,SAAS,cACd,OACA,OACA,QACS;AACT,MAAI,MAAM,WAAW,EAAG,QAAO;AAG/B,QAAM,MAAM,MACT,OAAO,CAAC,MAAmB,MAAM,MAAS,EAC1C,IAAI,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EACnC,KAAK,IAAI;AACZ,SAAO,MAAM,MAAM,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC;AACjD;AAmBO,SAAS,UACd,OACA,OACA,EAAE,MAAM,OAAO,IAAwC,CAAC,GAC7C;AACX,QAAM,IAAI,cAAc,MAAM,KAAK,GAAG,MAAM;AAC5C,MAAI,CAAC,EAAG,QAAO;AACf,QAAM,OAAO,cAAc,OAAO,MAAM;AACxC,MAAI,SAAS,KAAM,SAAS,UAAa,cAAc,MAAM,MAAM,MAAM,EAAI,QAAO;AACpF,MAAI,KAAK,WAAW,CAAC,EAAG,QAAO;AAC/B,SAAO,KAAK,SAAS,CAAC,IAAI,IAAI;AAChC;","names":[]}
+{"version":3,"sources":["../../src/lib/text-match.ts"],"sourcesContent":["/**\n * How typing into a kit list matches its rows — one rule for every list (DUP-5, refactor\n * audit 2026-10).\n *\n * There were six. \"zurich\" found Zürich in CountrySelect and the command palette and in no\n * EntityCombobox, Combobox, MultiSelect or DataTable text filter, where keksdose's\n * Swiss-German payees and categories and kastlan's eighteen entity pickers live; \"İ\"\n * folded by the locale in GroupedPicker and nowhere in the combobox family. The folding\n * only ever widens a match, so moving every list onto it took nothing away.\n */\n\n/**\n * A text as search compares it: the locale's lower case, accents off, ß spelt \"ss\" —\n * \"Zürich\" and \"ZURICH\" both read \"zurich\", \"Straße\" reads \"strasse\". Punctuation and\n * symbols stay: a currency is found by its \"€\", and \"c++\" is not the empty query.\n *\n * Lower-cased by the locale FIRST, then decomposed: the Turkish \"İ\" lower-cases to \"i\"\n * and the dotted capital's mark is then dropped like any other, so \"istanbul\" finds\n * \"İSTANBUL\" in every locale, while \"I\" folds to the dotless \"ı\" in Turkish alone.\n * `locale` left out is the runtime's default; a malformed tag folds as if left out.\n */\nexport function foldForSearch(text: string, locale?: string): string {\n  let lower: string;\n  try {\n    lower = text.toLocaleLowerCase(locale);\n  } catch {\n    lower = text.toLocaleLowerCase();\n  }\n  return lower\n    .normalize(\"NFD\")\n    .replace(/\\p{M}+/gu, \"\")\n    .replace(/ß/g, \"ss\");\n}\n\n/**\n * Whether two names are one name as a picker's search reads them: folded\n * ({@link foldForSearch}) and trimmed — \"cafe\" is Café, \" MIGROS \" is Migros. For \"does\n * the typed text name a record that exists\" (a create row, InlineEntityCombobox's blur\n * commit), which compared with plain `toLowerCase` while the list beside it folded, so\n * \"cafe\" listed Café as a hit and offered \"Create “cafe”\" too — a duplicate payee or shop\n * chain one Enter away (refactor audit 2026-10-30, DUP-5). Internal: not in the barrel.\n */\nexport function sameName(a: string, b: string, locale?: string): boolean {\n  return foldForSearch(a.trim(), locale) === foldForSearch(b.trim(), locale);\n}\n\n/**\n * A picker's query as its words, each folded (0.51.4, keksdose's /prices shop picker):\n * \"Migros  Zürich\" → `[\"migros\", \"zurich\"]`. An empty or blank query has no words.\n */\nexport function searchWords(query: string, locale?: string): string[] {\n  return foldForSearch(query, locale)\n    .split(/\\s+/)\n    .filter((word) => word !== \"\");\n}\n\n/**\n * Whether a row matches a picker's query: EVERY word appears in at least one of the row's\n * texts — \"migros 8004\" finds a row named \"Migros · 8004 Zürich\", and a row whose chain is\n * its group and whose place is its label (pass both). Until 0.51.4 the whole query had to\n * be ONE substring of one text, so two words found nothing unless they stood side by side\n * in that order. One word matches exactly as before, and so does the old query when it\n * was a substring. No words match everything.\n *\n * `words` from {@link searchWords}; `texts` as they are (folded here), `undefined` skipped.\n *\n * Exported since 0.51.5 for an app's own async source: a picker shows `loadOptions`'\n * rows as they come, so a source that narrows on the client filters with this, the same\n * rule the kit applies to `options` (keksdose's shop picker past its first hundred shops).\n */\nexport function matchesSearch(\n  words: readonly string[],\n  texts: readonly (string | undefined)[],\n  locale?: string,\n): boolean {\n  if (words.length === 0) return true;\n  // One haystack per row; a word holds no whitespace, so it cannot match across the\n  // newline between two texts.\n  const hay = texts\n    .filter((t): t is string => t !== undefined)\n    .map((t) => foldForSearch(t, locale))\n    .join(\"\\n\");\n  return words.every((word) => hay.includes(word));\n}\n\n/** {@link rankMatch}'s answer: lower is better, `-1` is no match. */\nexport type MatchRank = -1 | 0 | 1 | 2;\n\n/**\n * How well `label` answers `query` — CountrySelect's ranking, for every list that orders\n * its hits:\n *\n * - `0`: the query IS the row — its `code` (\"ch\" means Switzerland before it means Chad)\n *   or the whole label;\n * - `1`: the label starts with it;\n * - `2`: the label contains it;\n * - `-1`: no match.\n *\n * Both sides are folded here ({@link foldForSearch}, by `locale`), so pass them as typed\n * and as shown. An empty query matches every row alike (`0`). Sort by the rank with a\n * stable sort, and rows of one rank keep the order they came in.\n */\nexport function rankMatch(\n  label: string,\n  query: string,\n  { code, locale }: { code?: string; locale?: string } = {},\n): MatchRank {\n  const q = foldForSearch(query.trim(), locale);\n  if (!q) return 0;\n  return rankFolded(foldForSearch(label, locale), q, code === undefined ? undefined : foldForSearch(code, locale));\n}\n\n/** {@link rankMatch} on a text, a non-empty query and a code all folded already. */\nfunction rankFolded(text: string, q: string, code: string | undefined): MatchRank {\n  if (text === q || code === q) return 0;\n  if (text.startsWith(q)) return 1;\n  return text.includes(q) ? 2 : -1;\n}\n\n/** A row {@link searchRanked} kept, and how well it answers the WHOLE query:\n *  {@link rankMatch}'s rank, or `3` for a row that holds the query's words apart\n *  (\"Zürich Migros\" for \"migros zürich\"). */\nexport interface RankedHit<T> {\n  row: T;\n  rank: Exclude<MatchRank, -1> | 3;\n}\n\n/**\n * The rows that hold every word of `query`, each ranked for the WHOLE query — for the\n * lists that FILTER by words ({@link matchesSearch}) and RANK by the whole query\n * ({@link rankMatch}): Combobox, CountrySelect and InlineEntityCombobox (refactor audit\n * 2026-10-30, DUP-4). In the order given; sort by `rank` with a stable sort, and the rows\n * of one rank keep it. No words keep every row, at `0`.\n *\n * Each row's texts are folded ONCE, and the query once. The lists asked `matchesSearch`\n * and then `rankMatch` of each row they kept, which folded the row three times and the\n * query once per row, per keystroke — InlineEntityCombobox asked `rankMatch` twice of\n * most rows (0.52 code review, combobox.tsx).\n *\n * `texts(row)`: where a word may stand; the FIRST is the label the rank is for.\n * `code(row)`: a key that answers only WHOLE — a word that IS the code matches the row,\n * and the code as the whole query ranks `0` (\"ch\" is Switzerland before it is Chad) —\n * never a letter of it (\"w\" is not Aruba, AW: 0.52 code review, country-select.tsx).\n * Internal: not in the barrel.\n */\nexport function searchRanked<T>(\n  rows: readonly T[],\n  query: string,\n  texts: (row: T) => readonly (string | undefined)[],\n  { code, locale }: { code?: (row: T) => string; locale?: string } = {},\n): RankedHit<T>[] {\n  const q = foldForSearch(query.trim(), locale);\n  const words = q.split(/\\s+/).filter((word) => word !== \"\");\n  if (words.length === 0) return rows.map((row) => ({ row, rank: 0 }));\n  const hits: RankedHit<T>[] = [];\n  for (const row of rows) {\n    const folded = texts(row)\n      .filter((t): t is string => t !== undefined)\n      .map((t) => foldForSearch(t, locale));\n    const key = code === undefined ? undefined : foldForSearch(code(row), locale);\n    // One haystack, as `matchesSearch` has it: a word holds no whitespace, so it cannot\n    // match across the newline between two texts.\n    const hay = folded.join(\"\\n\");\n    if (!words.every((word) => word === key || hay.includes(word))) continue;\n    const rank = rankFolded(folded[0] ?? \"\", q, key);\n    hits.push({ row, rank: rank === -1 ? 3 : rank });\n  }\n  return hits;\n}\n"],"mappings":";AAqBO,SAAS,cAAc,MAAc,QAAyB;AACnE,MAAI;AACJ,MAAI;AACF,YAAQ,KAAK,kBAAkB,MAAM;AAAA,EACvC,QAAQ;AACN,YAAQ,KAAK,kBAAkB;AAAA,EACjC;AACA,SAAO,MACJ,UAAU,KAAK,EACf,QAAQ,YAAY,EAAE,EACtB,QAAQ,MAAM,IAAI;AACvB;AAUO,SAAS,SAAS,GAAW,GAAW,QAA0B;AACvE,SAAO,cAAc,EAAE,KAAK,GAAG,MAAM,MAAM,cAAc,EAAE,KAAK,GAAG,MAAM;AAC3E;AAMO,SAAS,YAAY,OAAe,QAA2B;AACpE,SAAO,cAAc,OAAO,MAAM,EAC/B,MAAM,KAAK,EACX,OAAO,CAAC,SAAS,SAAS,EAAE;AACjC;AAgBO,SAAS,cACd,OACA,OACA,QACS;AACT,MAAI,MAAM,WAAW,EAAG,QAAO;AAG/B,QAAM,MAAM,MACT,OAAO,CAAC,MAAmB,MAAM,MAAS,EAC1C,IAAI,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EACnC,KAAK,IAAI;AACZ,SAAO,MAAM,MAAM,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC;AACjD;AAmBO,SAAS,UACd,OACA,OACA,EAAE,MAAM,OAAO,IAAwC,CAAC,GAC7C;AACX,QAAM,IAAI,cAAc,MAAM,KAAK,GAAG,MAAM;AAC5C,MAAI,CAAC,EAAG,QAAO;AACf,SAAO,WAAW,cAAc,OAAO,MAAM,GAAG,GAAG,SAAS,SAAY,SAAY,cAAc,MAAM,MAAM,CAAC;AACjH;AAGA,SAAS,WAAW,MAAc,GAAW,MAAqC;AAChF,MAAI,SAAS,KAAK,SAAS,EAAG,QAAO;AACrC,MAAI,KAAK,WAAW,CAAC,EAAG,QAAO;AAC/B,SAAO,KAAK,SAAS,CAAC,IAAI,IAAI;AAChC;AA4BO,SAAS,aACd,MACA,OACA,OACA,EAAE,MAAM,OAAO,IAAoD,CAAC,GACpD;AAChB,QAAM,IAAI,cAAc,MAAM,KAAK,GAAG,MAAM;AAC5C,QAAM,QAAQ,EAAE,MAAM,KAAK,EAAE,OAAO,CAAC,SAAS,SAAS,EAAE;AACzD,MAAI,MAAM,WAAW,EAAG,QAAO,KAAK,IAAI,CAAC,SAAS,EAAE,KAAK,MAAM,EAAE,EAAE;AACnE,QAAM,OAAuB,CAAC;AAC9B,aAAW,OAAO,MAAM;AACtB,UAAM,SAAS,MAAM,GAAG,EACrB,OAAO,CAAC,MAAmB,MAAM,MAAS,EAC1C,IAAI,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACtC,UAAM,MAAM,SAAS,SAAY,SAAY,cAAc,KAAK,GAAG,GAAG,MAAM;AAG5E,UAAM,MAAM,OAAO,KAAK,IAAI;AAC5B,QAAI,CAAC,MAAM,MAAM,CAAC,SAAS,SAAS,OAAO,IAAI,SAAS,IAAI,CAAC,EAAG;AAChE,UAAM,OAAO,WAAW,OAAO,CAAC,KAAK,IAAI,GAAG,GAAG;AAC/C,SAAK,KAAK,EAAE,KAAK,MAAM,SAAS,KAAK,IAAI,KAAK,CAAC;AAAA,EACjD;AACA,SAAO;AACT;","names":[]}

package/dist/lib/thenable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Whether a callback's answer is a promise to wait for — an object or a function with a
+ * `then` (Promises/A+ "thenable"). A callback that answers nothing is done when it
+ * returns.
+ *
+ * The auth forms (`auth/status-parts`), the admin confirm and the feedback mutation each
+ * wrote their own, three spellings of one check — and the admin's turned a thenable
+ * FUNCTION away (0.52 code review, feedback/feedback-mutation.ts; the refactor audit's
+ * DUP findings).
+ *
+ * @internal Package-private — not re-exported from the barrel.
+ */
+export declare function isThenable(value: unknown): value is PromiseLike<unknown>;

package/dist/lib/thenable.js

@@ -0,0 +1,8 @@
+"use client";
+function isThenable(value) {
+  return (typeof value === "object" || typeof value === "function") && value !== null && typeof value.then === "function";
+}
+export {
+  isThenable
+};
+//# sourceMappingURL=thenable.js.map

package/dist/lib/thenable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/thenable.ts"],"sourcesContent":["/**\n * Whether a callback's answer is a promise to wait for — an object or a function with a\n * `then` (Promises/A+ \"thenable\"). A callback that answers nothing is done when it\n * returns.\n *\n * The auth forms (`auth/status-parts`), the admin confirm and the feedback mutation each\n * wrote their own, three spellings of one check — and the admin's turned a thenable\n * FUNCTION away (0.52 code review, feedback/feedback-mutation.ts; the refactor audit's\n * DUP findings).\n *\n * @internal Package-private — not re-exported from the barrel.\n */\nexport function isThenable(value: unknown): value is PromiseLike<unknown> {\n  return (\n    (typeof value === \"object\" || typeof value === \"function\") &&\n    value !== null &&\n    typeof (value as { then?: unknown }).then === \"function\"\n  );\n}\n"],"mappings":";AAYO,SAAS,WAAW,OAA+C;AACxE,UACG,OAAO,UAAU,YAAY,OAAO,UAAU,eAC/C,UAAU,QACV,OAAQ,MAA6B,SAAS;AAElD;","names":[]}

package/dist/lib/translation-review.d.ts

@@ -228,12 +228,17 @@ export interface TranslationReviewFilter {
     source: string;
     namespace: string;
     /** Searched in the key, the text and the reference, folded as every kit list's search
-     *  is (`foldForSearch`): no case, no accents — "uberweisung" finds "Überweisung". */
+     *  is (`foldForSearch`): no case, no accents — "uberweisung" finds "Überweisung". Every
+     *  word on its own (0.52): "budget assign" finds `budget.rta`, "Ready to Assign". */
     query: string;
     placeholdersOnly: boolean;
 }
 export declare const DEFAULT_TRANSLATION_REVIEW_FILTER: TranslationReviewFilter;
-export declare function filterTranslationRows(rows: readonly TranslationRow[], filter: Partial<TranslationReviewFilter>): TranslationRow[];
+/**
+ * The rows the filters leave. `locale` (0.52) folds the query and the texts as the kit's
+ * other lists do — the panel passes the provider's; left out, the runtime's default.
+ */
+export declare function filterTranslationRows(rows: readonly TranslationRow[], filter: Partial<TranslationReviewFilter>, locale?: string): TranslationRow[];
 /** One group of rows — an area, a source — and how they stand. */
 export interface TranslationRowGroup {
     key: string;

package/dist/lib/translation-review.js

@@ -1,5 +1,5 @@
 "use client";
-import { foldForSearch } from "./text-match.js";
+import { matchesSearch, searchWords } from "./text-match.js";
 const REVIEW_STATUSES = [
   "missing",
   "unreviewed",
@@ -139,11 +139,11 @@ const DEFAULT_TRANSLATION_REVIEW_FILTER = {
   query: "",
   placeholdersOnly: false
 };
-function filterTranslationRows(rows, filter) {
+function filterTranslationRows(rows, filter, locale) {
   const f = { ...DEFAULT_TRANSLATION_REVIEW_FILTER, ...filter };
-  const q = foldForSearch(f.query.trim());
+  const words = searchWords(f.query, locale);
   return rows.filter(
-    (row) => (f.status === "all" || row.status === f.status) && (f.source === "all" || row.source === f.source) && (f.namespace === "all" || row.namespace === f.namespace) && (!f.placeholdersOnly || row.placeholderMismatch) && (!q || [row.key, row.text, row.reference].some((s) => foldForSearch(s).includes(q)))
+    (row) => (f.status === "all" || row.status === f.status) && (f.source === "all" || row.source === f.source) && (f.namespace === "all" || row.namespace === f.namespace) && (!f.placeholdersOnly || row.placeholderMismatch) && matchesSearch(words, [row.key, row.text, row.reference], locale)
   );
 }
 function groupTranslationRows(rows, groupOf) {

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":"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","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;