@eifi1/ui-kit 0.53.0 → 0.54.0

package/src/i18n/german.ts

@@ -158,6 +158,7 @@ export function germanLabels(numberLocale: string): UiKitLabels {
     feedbackContext: {
       user: "Nutzer",
       attachUrl: "Aktuelle Seiten-URL anhängen",
+      diagnostics: "Mitgesendete Diagnose",
     },
     feedbackPage: {
       title: "Feedback-Eingang",
@@ -190,6 +191,7 @@ export function germanLabels(numberLocale: string): UiKitLabels {
       cancel: "Abbrechen",
       url: "URL",
       copyUrl: "URL kopieren",
+      diagnostics: "Diagnose",
       attachment: "Anhang",
       download: (name) => `${name} herunterladen`,
       downloadFailed: "Der Anhang konnte nicht heruntergeladen werden.",

package/src/i18n/locales/es.ts

@@ -150,6 +150,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
     feedbackContext: {
       user: "Usuario",
       attachUrl: "Adjuntar la URL de la página actual",
+      diagnostics: "Diagnóstico enviado con el informe",
     },
     feedbackPage: {
       title: "Comentarios recibidos",
@@ -182,6 +183,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       cancel: "Cancelar",
       url: "URL",
       copyUrl: "Copiar URL",
+      diagnostics: "Diagnóstico",
       attachment: "Adjunto",
       download: (name) => `Descargar ${name}`,
       downloadFailed: "No se ha podido descargar el adjunto.",

package/src/i18n/locales/fr.ts

@@ -151,6 +151,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
     feedbackContext: {
       user: "Utilisateur",
       attachUrl: "Joindre l’URL de la page actuelle",
+      diagnostics: "Diagnostic envoyé avec le retour",
     },
     feedbackPage: {
       title: "Retours reçus",
@@ -183,6 +184,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       cancel: "Annuler",
       url: "URL",
       copyUrl: "Copier l’URL",
+      diagnostics: "Diagnostic",
       attachment: "Pièce jointe",
       download: (name) => `Télécharger ${name}`,
       downloadFailed: "La pièce jointe n’a pas pu être téléchargée.",

package/src/i18n/locales/hu.ts

@@ -148,6 +148,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
     feedbackContext: {
       user: "Felhasználó",
       attachUrl: "Az aktuális oldal URL-jének csatolása",
+      diagnostics: "A bejelentéssel küldött diagnosztika",
     },
     feedbackPage: {
       title: "Beérkezett visszajelzések",
@@ -180,6 +181,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       cancel: "Mégse",
       url: "URL",
       copyUrl: "URL másolása",
+      diagnostics: "Diagnosztika",
       attachment: "Melléklet",
       download: (name) => `${name} letöltése`,
       downloadFailed: "A mellékletet nem sikerült letölteni.",

package/src/i18n/locales/it.ts

@@ -150,6 +150,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
     feedbackContext: {
       user: "Utente",
       attachUrl: "Allega l’URL della pagina corrente",
+      diagnostics: "Diagnostica inviata con la segnalazione",
     },
     feedbackPage: {
       title: "Feedback ricevuti",
@@ -182,6 +183,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       cancel: "Annulla",
       url: "URL",
       copyUrl: "Copia URL",
+      diagnostics: "Diagnostica",
       attachment: "Allegato",
       download: (name) => `Scarica ${name}`,
       downloadFailed: "Non è stato possibile scaricare l’allegato.",

package/src/i18n/locales/zh.ts

@@ -141,6 +141,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
     feedbackContext: {
       user: "用户",
       attachUrl: "附加当前页面 URL",
+      diagnostics: "随反馈发送的诊断信息",
     },
     feedbackPage: {
       title: "反馈收件箱",
@@ -173,6 +174,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       cancel: "取消",
       url: "URL",
       copyUrl: "复制 URL",
+      diagnostics: "诊断信息",
       attachment: "附件",
       download: (name) => `下载 ${name}`,
       downloadFailed: "无法下载附件。",

package/src/index.ts

@@ -93,6 +93,10 @@ export {
   reviewWrite,
   mergeReviews,
   dropReviews,
+  // 0.54: a save or a reset of any size under server-kit's cap of 2000 (kastlan reuse
+  // audit 2026-11-02, proposal 5).
+  saveReviewsInChunks,
+  clearReviewsInChunks,
   translationCorrections,
   // 0.25: grouping and the approvals' Undo (keksdose live #377).
   groupTranslationRows,
@@ -761,7 +765,9 @@ export type { RegisterFormProps, RegisterLabels, RegisterValues } from "./auth/r
 export { CompleteNameDialog, DEFAULT_COMPLETE_NAME_LABELS } from "./auth/complete-name-dialog";
 export type { CompleteNameDialogProps, CompleteNameLabels, CompleteNameValues } from "./auth/complete-name-dialog";
 export { taggedEmail } from "./auth/email-tag";
-export { isAuthError, authErrorCode, isBillingError } from "./auth/auth-errors";
+// 0.54 (kastlan reuse audit 2026-11-02, proposal 4): `billingRefusalText`, a billing
+// refusal's words, which every app mapped from the code by hand.
+export { isAuthError, authErrorCode, isBillingError, billingRefusalText } from "./auth/auth-errors";
 export type { AuthErrorCode } from "./auth/auth-errors";
 export { ForgotPasswordForm, DEFAULT_FORGOT_PASSWORD_LABELS } from "./auth/forgot-password-form";
 export type { ForgotPasswordFormProps, ForgotPasswordLabels } from "./auth/forgot-password-form";
@@ -793,7 +799,13 @@ export type { AuthHeadingLevel } from "./auth/status-parts";
 // 0.30.0: a rate limit and its wait, and the codes the account, billing and demo calls
 // answer with.
 export { isRateLimited, retryAfterSeconds } from "./auth/auth-errors";
-export type { AccountErrorCode, BillingErrorCode, DemoErrorCode, KitErrorCode } from "./auth/auth-errors";
+export type {
+  AccountErrorCode,
+  BillingErrorCode,
+  BillingRefusalTextOptions,
+  DemoErrorCode,
+  KitErrorCode,
+} from "./auth/auth-errors";
 
 // ── account ──────────────────────────────────────────────────────────────────
 // In account/ since 0.34, beside the other account cards (MOD-8, refactor audit 2026-10):

package/src/lib/dates.ts

@@ -24,6 +24,9 @@
  * all, so sending it the user's local day is also what it wants.
  */
 
+// Imports nothing else: `@eifi1/ui-kit/dates` reaches no package (packaging-contract).
+import { dateFormatter } from "./intl-cache";
+
 /** Zero-pad a number to two digits ("3" -> "03"). */
 export function pad(n: number): string {
   return String(n).padStart(2, "0");
@@ -124,14 +127,33 @@ export function parseIsoDate(s: string): Date | null {
   return dt;
 }
 
+/** The fields that make an option set a DATE for `toLocaleDateString` (ECMA-402's
+ *  ToDateTimeOptions, required "date"): with none of them it adds year, month and day. */
+const DATE_FIELDS = ["weekday", "year", "month", "day", "dateStyle"] as const;
+const NUMERIC_DATE: Intl.DateTimeFormatOptions = { year: "numeric", month: "numeric", day: "numeric" };
+
+/** `options` as `toLocaleDateString` reads them: with a date in them, whatever else they
+ *  ask for. `{ hour: "numeric" }` alone is a date and an hour there, never the hour alone
+ *  that `Intl.DateTimeFormat` would print for it. */
+function asDateOptions(options: Intl.DateTimeFormatOptions | undefined): Intl.DateTimeFormatOptions {
+  if (!options) return NUMERIC_DATE;
+  return DATE_FIELDS.some((field) => options[field] !== undefined) ? options : { ...options, ...NUMERIC_DATE };
+}
+
 /** Format a "YYYY-MM-DD" string for display in `locale` (empty string when
  *  unparseable). Defaults to the locale's short numeric date; pass `options` to
  *  override (e.g. `{ dateStyle: "medium" }`). `locale` may be `undefined` since 0.34 —
  *  the runtime's default, as `Intl` reads it and as every other kit formatter takes it
- *  (DUP-11: DatePicker re-wrapped this function only to pass none). */
+ *  (DUP-11: DatePicker re-wrapped this function only to pass none).
+ *
+ *  Through the kit's formatter cache since 0.54 (keksdose audit follow-up, 2026-11-01):
+ *  `toLocaleDateString` builds a formatter per call, and this one runs for the date
+ *  pickers' trigger on every render and for an app's date column once per row. The output
+ *  is `toLocaleDateString`'s: the same options, with the date it adds when they name none
+ *  (`asDateOptions`). */
 export function formatIsoDate(iso: string, locale: string | undefined, options?: Intl.DateTimeFormatOptions): string {
   const d = parseIsoDate(iso);
-  return d ? d.toLocaleDateString(locale, options) : "";
+  return d ? dateFormatter(locale, asDateOptions(options)).format(d) : "";
 }
 
 /** A "YYYY-MM-DD" string shifted by `days` (negative shifts back), or the input

package/src/lib/format.ts

@@ -11,8 +11,8 @@ export type { MinusStyle } from "./minus";
 export { formatWithMinus } from "./minus";
 
 /**
- * Number, money, percentage, date and relative-time formatting — `Intl`, in one place,
- * for the figures an app prints OUTSIDE a kit component.
+ * Number, money, percentage, duration (0.54), date and relative-time formatting — `Intl`,
+ * in one place, for the figures an app prints OUTSIDE a kit component.
  *
  * Each app grew its own: kastlan's `utils/formatters.ts` (a Swiss-pinned
  * `formatNumber`/`formatCurrency`, a date-fns `formatDate`, and a `formatRelativeTime`
@@ -99,6 +99,19 @@ export interface FormatMoneyOptions extends FormatNumberBaseOptions {
   currencyDisplay?: Intl.NumberFormatOptions["currencyDisplay"];
 }
 
+export interface FormatDurationOptions extends BaseOptions {
+  /**
+   * How the units are written — `Intl.NumberFormat`'s `unitDisplay`, in `locale`:
+   *  - `"narrow"` (default): "3m 12s", "3 Min. 12 Sek." (de-CH), "3min 12s" (fr) —
+   *    keksdose's scan readout;
+   *  - `"short"`: "3 min 12 sec", "3 Min. 12 Sek.", "3 min 12 s";
+   *  - `"long"`: "3 minutes 12 seconds", "3 Minuten 12 Sekunden", "3 minutes 12 secondes".
+   */
+  unitDisplay?: "narrow" | "short" | "long";
+  /** The minus of a negative duration — {@link FormatNumberBaseOptions.minus}. */
+  minus?: MinusStyle;
+}
+
 export interface FormatPercentOptions extends FormatNumberBaseOptions {
   /**
    * `true` (default): `value` is a RATIO, as `Intl` and `StatTile`'s percent delta read
@@ -162,7 +175,7 @@ function devWarnings(): boolean {
 const warnedSites = new Set<string>();
 /** This module's own frames, skipped to find the caller ("Object.formatMoney" is a
  *  `useKitFormat` wrapper). */
-const OWN_FRAME = /\b(?:formatNumber|formatMoney|formatPercent|toFormattable|warnInvalid|callSite)\b/;
+const OWN_FRAME = /\b(?:formatNumber|formatMoney|formatPercent|formatDuration|toFormattable|warnInvalid|callSite)\b/;
 
 /** The first stack frame outside the formatters: where the bad value was passed. */
 function callSite(): string {
@@ -248,6 +261,53 @@ export function formatPercent(value: FormattableNumber, options: FormatPercentOp
   return formatWithMinus(formatter, ratio, options.minus);
 }
 
+/** The units a duration is written in, largest first, with their length in seconds. */
+const DURATION_UNITS = [
+  ["hour", 3600],
+  ["minute", 60],
+  ["second", 1],
+] as const;
+
+/**
+ * A number of SECONDS as an elapsed time in `locale`: "42s", "3m 12s", "1h 0m 5s" — and in
+ * German "3 Min. 12 Sek.", in French "3min 12s" (keksdose audit follow-up, 2026-11-01:
+ * keksdose's `formatElapsed`, the scan card's readout, moves here). Each unit is
+ * `Intl.NumberFormat`'s `style: "unit"`, so the digits and the unit's spelling follow
+ * `locale`; `unitDisplay` picks the form, narrow by default.
+ *
+ * - Seconds alone under a minute ("0s", "59s"); minutes and seconds under an hour ("1m 0s",
+ *   "59m 59s"); from an hour on, hours, minutes and seconds ("1h 0m 0s"). Hours are the
+ *   largest unit: a day and a bit is "27h 46m 40s". Every unit below the first is printed,
+ *   zero too, so a ticking readout keeps its shape from one second to the next.
+ * - Whole seconds, cut toward zero: a timer reads "59s" until the minute is full.
+ * - The parts are joined by a space, as the readout always was — not `Intl.ListFormat`'s
+ *   "3 Min. und 12 Sek.", which is a sentence rather than a figure.
+ * - Negative: the minus on the first unit, as `Intl.DurationFormat` writes one — "−3m 12s",
+ *   with the kit's minus (`minus`). An elapsed time from a server's clock can come out a
+ *   second below zero; clamp it before, as keksdose's card does, when that is not news.
+ * - `null` / `undefined` print `empty`; `NaN`, ±`Infinity` and a non-numeric string too,
+ *   with the formatters' development warning. A numeric string ("185") is a number.
+ */
+export function formatDuration(seconds: FormattableNumber, options: FormatDurationOptions = {}): string {
+  const n = toFormattable("formatDuration", seconds);
+  if (n === undefined) return options.empty ?? EMPTY_FORMATTED_VALUE;
+  const unitDisplay = options.unitDisplay ?? "narrow";
+  const negative = n < 0;
+  let rest = Math.trunc(Math.abs(n));
+  const parts: string[] = [];
+  for (const [unit, size] of DURATION_UNITS) {
+    const count = Math.floor(rest / size);
+    rest -= count * size;
+    // Units above the first that has a count are left out; seconds always print.
+    if (parts.length === 0 && count === 0 && unit !== "second") continue;
+    const formatter = numberFormatter(options.locale, { style: "unit", unit, unitDisplay });
+    // `count > 0`: under a second either way is "0s", with no sign on it.
+    const signed = negative && parts.length === 0 && count > 0 ? -count : count;
+    parts.push(formatWithMinus(formatter, signed, options.minus));
+  }
+  return parts.join(" ");
+}
+
 /* ── Dates ─────────────────────────────────────────────────────────────────── */
 
 /**
@@ -436,6 +496,8 @@ export interface KitFormat {
   formatNumber: (value: FormattableNumber, options?: WithoutLocale<FormatNumberOptions>) => string;
   formatMoney: (value: FormattableNumber, currency: string, options?: WithoutLocale<FormatMoneyOptions>) => string;
   formatPercent: (value: FormattableNumber, options?: WithoutLocale<FormatPercentOptions>) => string;
+  /** 0.54: {@link formatDuration}, a number of seconds as an elapsed time. */
+  formatDuration: (seconds: FormattableNumber, options?: WithoutLocale<FormatDurationOptions>) => string;
   formatDate: (
     value: DateInput,
     style?: FormatDateStyle | Intl.DateTimeFormatOptions,
@@ -462,6 +524,7 @@ export function useKitFormat(locale?: string): KitFormat {
       formatNumber: (value, options) => formatNumber(value, { locale: kitLocale, ...options }),
       formatMoney: (value, currency, options) => formatMoney(value, currency, { locale: kitLocale, ...options }),
       formatPercent: (value, options) => formatPercent(value, { locale: kitLocale, ...options }),
+      formatDuration: (seconds, options) => formatDuration(seconds, { locale: kitLocale, ...options }),
       formatDate: (value, style, options) => formatDate(value, style, { locale: kitLocale, timeZone, ...options }),
       formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, timeZone, ...options }),
     }),

package/src/lib/intl-cache.ts

@@ -4,10 +4,12 @@
  * Constructing the formatter is the expensive part: keksdose measured 392 ms per click on
  * a 270-row register when each cell built its own (dev#632), and kept its own renderer of
  * the date-format preference because the kit's built one per call (refactor audit
- * 2026-10-30, DUP-2). `lib/format` and `lib/date-format` both format through this one.
+ * 2026-10-30, DUP-2). `lib/format` and `lib/date-format` both format through this one, and
+ * since 0.54 `lib/dates`' `formatIsoDate` (keksdose audit follow-up, 2026-11-01).
  *
  * @internal Not part of the barrel — `lib/format` is re-exported whole, so the cache
- * lives apart from it.
+ * lives apart from it. It imports nothing, which `@eifi1/ui-kit/dates` (no package at
+ * all) relies on.
  */
 
 const dateFormatters = new Map<string, Intl.DateTimeFormat>();

package/src/lib/translation-review.ts

@@ -570,6 +570,58 @@ export function dropReviews<T extends TranslationReviewKey>(
   return prev.filter((r) => !gone.has(`${r.locale}|${r.key}`));
 }
 
+/**
+ * How many verdicts one request carries. server-kit refuses more than 2000 in one
+ * `PUT /translations/reviews` or `POST /translations/reviews/clear` (`BATCH_MAX`, its
+ * translation_review/schemas.py); half of it, as each of the three apps sent. A whole area
+ * is rarely more than a few hundred, so most saves are one request; "Approve the
+ * unreviewed" over an app's every string is not.
+ */
+const REVIEW_CHUNK = 1000;
+
+/**
+ * A save of any size under server-kit's cap: `writes` in chunks of 1000, one request
+ * after the other, in their order, and every verdict the server answered with, in that
+ * order — to patch the page's cached list with {@link mergeReviews} once. `save` is the
+ * app's own request (`PUT /translations/reviews`), answering with the verdicts it wrote,
+ * in either spelling. No writes, no request: the server refuses an empty batch.
+ *
+ * A chunk that fails rejects with its error, and the chunks after it are not sent. What
+ * the chunks before it wrote stays written — the server has it — but is not handed back,
+ * so the page leaves its cache as it was and the panel shows the error; a second try
+ * writes those verdicts again, which changes nothing but the time on them.
+ *
+ * All three apps wrote this loop, with a `chunks` helper and `SAVE_CHUNK = 1000` of
+ * their own (kastlan reuse audit 2026-11-02, proposal 5):
+ *
+ *     const written = await saveReviewsInChunks(writes.map(toApiWrite), (part) => translationsApi.save(part));
+ *     patchCache((reviews) => mergeReviews(reviews, written));
+ */
+export async function saveReviewsInChunks<W extends TranslationReviewKey, R extends TranslationReviewKey>(
+  writes: readonly W[],
+  save: (chunk: W[]) => Promise<readonly R[]>,
+): Promise<R[]> {
+  const written: R[] = [];
+  for (let at = 0; at < writes.length; at += REVIEW_CHUNK) {
+    written.push(...(await save(writes.slice(at, at + REVIEW_CHUNK))));
+  }
+  return written;
+}
+
+/**
+ * {@link saveReviewsInChunks} for a reset (`POST /translations/reviews/clear`): `keys` in
+ * chunks of 1000, one request after the other, and the keys themselves once every chunk
+ * is through — to drop from the cached list with {@link dropReviews} once. A failing
+ * chunk rejects as a save's does, and what the chunks before it cleared stays cleared.
+ */
+export async function clearReviewsInChunks<K extends TranslationReviewKey>(
+  keys: readonly K[],
+  clear: (chunk: K[]) => Promise<unknown>,
+): Promise<K[]> {
+  for (let at = 0; at < keys.length; at += REVIEW_CHUNK) await clear(keys.slice(at, at + REVIEW_CHUNK));
+  return [...keys];
+}
+
 // ── Swipe bindings ──────────────────────────────────────────────────────────────
 
 /**