@eifi1/ui-kit 0.52.0 → 0.54.0

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,
@@ -122,13 +126,11 @@ export type {
   TranslationReviewSwipeAction,
   TranslationReviewSwipeBinding,
 } from "./lib/translation-review";
-// 0.22.0, the inputs round: the country list and the IBAN, ISIN and phone helpers that
+// 0.22.0, the inputs round: the country list and the IBAN and phone helpers that
 // CountrySelect, IbanInput and PhoneInput are built on.
 export { COUNTRY_CODES, countryName } from "./lib/countries";
 export { IBAN_LENGTHS, compactIban, formatIban, ibanCheckDigits, ibanProblem, isValidIban, isQrIban } from "./lib/iban";
 export type { IbanKind, IbanProblem } from "./lib/iban";
-// 0.52: deprecated, removed in 0.53 (MOD-5; tagged in lib/isin).
-export { formatIsin, isinCheckDigit, isValidIsin } from "./lib/isin";
 export { PHONE_DIAL_CODES, PHONE_COUNTRIES, parsePhone, formatNationalPhone, formatPhone, isE164 } from "./lib/phone";
 export type { PhoneCountryCode, PhoneCountry, ParsedPhone } from "./lib/phone";
 // 0.23.0: ColumnMapper's pure half (Kurvenschmiede's columns input, keksdose's import map).
@@ -177,14 +179,9 @@ export type { LongPressOptions, LongPressResult } from "./hooks/use-long-press";
 export { useNoIndex } from "./hooks/use-noindex";
 // 0.49 KIT-9: the window's title from page, section and app, in the provider's format.
 export { useDocumentTitle } from "./hooks/use-document-title";
-// 0.49 KIT-1b: U+2212 before a number as "-", the copy handler's rule, for an app's text.
-// 0.52: deprecated with the other 54 names no app, test or showcase page reads (refactor
-// audit 2026-10-30, API-4, decision 4). Each is tagged on its specifier here, not on its
-// declaration: the module keeps it for the kit's own use, only the barrel lets it go.
-export {
-  /** @deprecated 0.52 — a formatter's `minus: "ascii"`, where the figure is made (API-4); removed in 0.53 */
-  asciiMinusInNumbers,
-} from "./lib/clipboard-minus";
+// 0.53: the 55 names no app reads left the entry points (deprecated in 0.52, refactor audit
+// 2026-10-30, API-4, decision 4) — here 0.49 KIT-1b's `asciiMinusInNumbers`, the copy
+// handler's rule, among them. Their modules keep the ones the kit itself uses.
 export { DEFAULT_DOCUMENT_TITLE_FORMAT, formatDocumentTitle } from "./lib/document-title";
 export type { DocumentTitleParts } from "./lib/document-title";
 export type { SwipeStage, RowSwipeOptions, RowSwipeReturn } from "./hooks/use-row-swipe";
@@ -344,11 +341,6 @@ export * from "./components/multi-select";
 export * from "./components/tooltip";
 export * from "./components/user-avatar";
 export * from "./components/settings-fields";
-// Sync state for a database-backed field: the engine (`useFieldSync`) and the
-// affordance (`FieldSyncIndicator`), kept separate because the state is useful
-// without the dot — a form can gate its submit on any field being `pending`.
-// 0.52: deprecated as a whole, removed in 0.53 (MOD-5; tagged in the module).
-export * from "./components/field-sync";
 export * from "./components/month-picker";
 export * from "./components/checkbox";
 export * from "./components/switch";
@@ -422,9 +414,6 @@ export * from "./components/alert-banner";
 export * from "./components/toggle-group";
 // A wrapping set of links/buttons marked `aria-current` — Tabs-like looks, not tabs.
 export * from "./components/nav-pills";
-// 0.49.0 (KIT-6): a section's pages on the phone, one scrolling row of pills. 0.52:
-// deprecated, removed in 0.53 (MOD-5; tagged in the module).
-export * from "./components/section-nav";
 // A pill carrying one VALUE — inert, a link, or a toggle, depending on which prop it is
 // given — and the list field built from it. Distinct from Button on purpose: a row of
 // buttons reads as "choose an action", a row of chips as "here are the things".
@@ -441,10 +430,15 @@ export * from "./components/full-bleed-dialog";
 export * from "./components/grouped-picker";
 export * from "./components/file-dropzone";
 export * from "./components/mini-calendar";
-export * from "./components/calendar-heatmap";
+// Named, not `*`: `heatmapLevel` is CalendarHeatmap's own since 0.53 (API-4).
 export {
-  /** @deprecated 0.52 — `CalendarHeatmap`, which steps its cells with it (API-4); removed in 0.53 */
-  heatmapLevel,
+  CalendarHeatmap,
+  DEFAULT_CALENDAR_HEATMAP_LABELS,
+  heatmapWindowEnd,
+  type CalendarHeatmapLabels,
+  type CalendarHeatmapDatum,
+  type CalendarHeatmapDay,
+  type CalendarHeatmapProps,
 } from "./components/calendar-heatmap";
 export * from "./components/date-picker";
 export * from "./components/tree-view";
@@ -465,13 +459,9 @@ export {
   COMMIT_EXCEPT_BILLING,
   DEFAULT_WRITE_LOCK_LABELS,
 } from "./components/write-lock";
-// 0.46 (kastlan K4): the offline lock kind, its scope and its source.
-export {
-  /** @deprecated 0.52 — the kind itself, `"offline"`, which `useOfflineWriteLock` holds (API-4); removed in 0.53 */
-  OFFLINE_LOCK,
-  COMMIT_EXCEPT_OFFLINE,
-  useOfflineWriteLock,
-} from "./components/write-lock";
+// 0.46 (kastlan K4): the offline lock's scope and its source (the kind, `OFFLINE_LOCK`, left
+// the surface in 0.53: it is the string "offline").
+export { COMMIT_EXCEPT_OFFLINE, useOfflineWriteLock } from "./components/write-lock";
 export type {
   WriteLock,
   WriteLockLabels,
@@ -535,10 +525,12 @@ export * from "./components/error-boundary";
 export * from "./components/copy-button";
 export { AuthedImage, DEFAULT_AUTHED_IMAGE_LABELS } from "./components/authed-image";
 export type { AuthedImageProps, AuthedImageLabels } from "./components/authed-image";
-export * from "./components/image-grid";
+// Named, not `*`: `splitFileName` is ImageGrid's own since 0.53 (API-4).
 export {
-  /** @deprecated 0.52 — `ImageGrid`, which shortens its file names with it (API-4); removed in 0.53 */
-  splitFileName,
+  ImageGrid,
+  DEFAULT_IMAGE_GRID_LABELS,
+  type ImageGridLabels,
+  type ImageGridProps,
 } from "./components/image-grid";
 export * from "./components/lightbox";
 export * from "./components/button-group";
@@ -567,17 +559,7 @@ export type {
 // The toast layer over sonner (an OPTIONAL peer, loaded lazily): `toast` mirrors sonner's
 // API so apps migrate by swapping the import; `<Toaster>` carries the placement, theme,
 // tones and z-index both apps had wired by hand.
-export {
-  toast,
-  Toaster,
-  DEFAULT_TOAST_LABELS,
-  /** @deprecated 0.52 — `toast()`, which times a toast with an action by it (API-4); removed in 0.53 */
-  TOAST_ACTION_DURATION,
-  /** @deprecated 0.52 — `<Toaster>`, whose default `offset` it is (API-4); removed in 0.53 */
-  TOASTER_OFFSET_TOP,
-  /** @deprecated 0.52 — `<Toaster>`, whose default `offset` it is (API-4); removed in 0.53 */
-  TOASTER_OFFSET_BOTTOM,
-} from "./components/toast";
+export { toast, Toaster, DEFAULT_TOAST_LABELS } from "./components/toast";
 export type {
   ToastId,
   ToastAction,
@@ -682,8 +664,6 @@ export {
   // 0.47.0 (keksdose N17): a hand-built table's actions heading and cell.
   RowActionsHead,
   ROW_ACTIONS_CELL_CLASS,
-  /** @deprecated 0.52 — `RowActionsHead`, which draws it (API-4); removed in 0.53 */
-  ROW_ACTIONS_HEAD_CLASS,
 } from "./components/row-actions";
 export type {
   RowAction,
@@ -704,8 +684,6 @@ export * from "./components/one-time-code-input";
 export * from "./components/language-select";
 export * from "./components/tile-radio";
 export * from "./components/inline-edit-field";
-// 0.52: deprecated, removed in 0.53 (MOD-5; tagged in the module).
-export * from "./components/sign-chip";
 export * from "./components/country-select";
 export * from "./components/iban-input";
 export * from "./components/phone-input";
@@ -787,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";
@@ -819,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):
@@ -859,13 +845,9 @@ export type { DataExportSettingProps, DataExportLabels, DataExportFile } from ".
 // 0.30.0 (docs/user-admin-harmonization.md): the admin user list and its actions, and the
 // invitations panel. Callbacks only; the confirmation level is the server's.
 export {
-  /** @deprecated 0.52 — `useUserRosterColumns`, the same columns in the provider's words (API-4); removed in 0.53 */
-  userRosterColumns,
   useUserRosterColumns,
   UserIdentityCell,
   UserRowActions,
-  /** @deprecated 0.52 — `useUserRosterColumns`, whose state cell reads it (API-4); removed in 0.53 */
-  adminUserStates,
   userRosterSort,
   USER_ROSTER_SORT_KEYS,
   DEFAULT_USER_ROSTER_LABELS,
@@ -945,13 +927,7 @@ export { adminSectionOrder } from "./admin/admin-sections";
 export type { AdminSectionPlace, AdminSectionOrderOptions, AdminKeptSection } from "./admin/admin-sections";
 export { AdminForbidden } from "./admin/admin-forbidden";
 export type { AdminForbiddenProps } from "./admin/admin-forbidden";
-export {
-  AdminOverview,
-  AttentionTile,
-  adminWaitingCount,
-  /** @deprecated 0.52 — `AdminOverview`, which links its tiles there unless told otherwise (API-4); removed in 0.53 */
-  DEFAULT_ADMIN_ATTENTION_HREFS,
-} from "./admin/admin-overview";
+export { AdminOverview, AttentionTile, adminWaitingCount } from "./admin/admin-overview";
 export type {
   AdminAttention,
   AdminAttentionTile,
@@ -966,23 +942,10 @@ export type {
 export { AdminToolLinks } from "./admin/admin-tool-links";
 export type { AdminToolLink, AdminToolLinksProps } from "./admin/admin-tool-links";
 // 0.45.0 (docs/admin-harmonization.md §9.2.4): "Send a test mail to me".
-export {
-  MailTestCard,
-  DEFAULT_MAIL_TEST_CARD_LABELS,
-  MAIL_TEST_ANCHOR,
-  /** @deprecated 0.52 — `MailTestCard`, which masks the address itself (API-4); removed in 0.53 */
-  maskMailAddress,
-} from "./admin/mail-test-card";
+export { MailTestCard, DEFAULT_MAIL_TEST_CARD_LABELS, MAIL_TEST_ANCHOR } from "./admin/mail-test-card";
 export type { MailTestCardProps, MailTestCardLabels, MailTestAnswer } from "./admin/mail-test-card";
 // 0.33.0: the operator's plan parts (docs/billing-harmonization.md §14.12).
-export {
-  /** @deprecated 0.52 — `usePlanColumn`, the same column in the provider's words (API-4); removed in 0.53 */
-  planColumn,
-  usePlanColumn,
-  PlanChangeConfirm,
-  usePlanChangeResult,
-  DEFAULT_PLAN_CHANGE_LABELS,
-} from "./admin/plan-change";
+export { usePlanColumn, PlanChangeConfirm, usePlanChangeResult, DEFAULT_PLAN_CHANGE_LABELS } from "./admin/plan-change";
 export type {
   PlanChangeLabels,
   PlanColumnOptions,
@@ -1007,13 +970,7 @@ export type {
   PlanPrices,
   PlanPriceAnswer,
 } from "./billing/plan-price";
-export {
-  PlanCard,
-  PlanPicker,
-  GrantWarningConfirm,
-  /** @deprecated 0.52 — `PlanPicker`, which marks each card's relation itself (API-4); removed in 0.53 */
-  planRelation,
-} from "./billing/plan-card";
+export { PlanCard, PlanPicker, GrantWarningConfirm } from "./billing/plan-card";
 export type {
   BillingPlan,
   PlanRelation,
@@ -1047,21 +1004,10 @@ export {
   withoutCheckoutReturn,
   checkoutReturnUrl,
 } from "./billing/checkout-return";
-export {
-  checkoutFingerprint,
-  /** @deprecated 0.52 — `useCheckoutProcessing`, which asks it (API-4); removed in 0.53 */
-  checkoutLanded,
-  noteCheckoutStarted,
-  useCheckoutProcessing,
-} from "./billing/checkout-processing";
+export { checkoutFingerprint, noteCheckoutStarted, useCheckoutProcessing } from "./billing/checkout-processing";
 export type { CheckoutOverview, CheckoutProcessingOptions } from "./billing/checkout-processing";
 // The link to the pay page and Paddle's locale (§14.4); the page itself ships as dist/pay/.
-export {
-  /** @deprecated 0.52 — `payPageUrl`, which writes it (API-4); removed in 0.53 */
-  PAY_PAGE_LANG_PARAM,
-  paddleLocale,
-  payPageUrl,
-} from "./billing/pay-page";
+export { paddleLocale, payPageUrl } from "./billing/pay-page";
 export type { PaddleEnvironment } from "./billing/pay-page";
 // 0.39 (§15.2.6): the apps every pay page serves, by their `billing_app` tag.
 export { PAY_PAGE_APPS } from "./billing/pay-page";
@@ -1111,11 +1057,7 @@ export type {
   ResolveAccountLanguageInput,
   ResolvedAccountLanguage,
 } from "./settings/use-account-language";
-export {
-  useAccountAppearance,
-  /** @deprecated 0.52 — `useAccountAppearance`, which resolves the same three values (API-4); removed in 0.53 */
-  resolveAccountAppearance,
-} from "./settings/use-account-appearance";
+export { useAccountAppearance } from "./settings/use-account-appearance";
 export type {
   AppearanceSource,
   AccountAppearanceFields,
@@ -1192,11 +1134,7 @@ export type {
 } from "./notifications/push-worker";
 export { PushDeviceSetting } from "./notifications/push-device-setting";
 export type { PushDeviceSettingProps, PushDeviceAction } from "./notifications/push-device-setting";
-export {
-  PushDevicesSetting,
-  /** @deprecated 0.52 — `PushDevicesSetting`, which names each device with it (API-4); removed in 0.53 */
-  describeUserAgent,
-} from "./notifications/push-devices-setting";
+export { PushDevicesSetting } from "./notifications/push-devices-setting";
 export type { PushDevicesSettingProps } from "./notifications/push-devices-setting";
 export { UnsubscribePanel, unsubscribeTokenType } from "./notifications/unsubscribe-panel";
 export type { UnsubscribePanelProps } from "./notifications/unsubscribe-panel";
@@ -1243,15 +1181,7 @@ export { DEFAULT_DEMO_LABELS, useDemoLabels } from "./demo/demo-labels";
 export type { DemoLabels } from "./demo/demo-labels";
 export { isDemoSession } from "./demo/demo-session";
 export type { DemoModel, DemoSessionUser } from "./demo/demo-session";
-export {
-  useDemoCountdown,
-  /** @deprecated 0.52 — `useDemoCountdown`, the same countdown; its `now` option for a test (API-4); removed in 0.53 */
-  demoCountdown,
-  /** @deprecated 0.52 — `useDemoCountdown`, whose `warning` turns on then (API-4); removed in 0.53 */
-  DEMO_WARNING_MINUTES,
-  /** @deprecated 0.52 — `useDemoCountdown`, whose `lastHour` turns on then (API-4); removed in 0.53 */
-  DEMO_MINUTES_ONLY,
-} from "./demo/demo-countdown";
+export { useDemoCountdown } from "./demo/demo-countdown";
 export type { DemoCountdown, DemoCountdownOptions, DemoExpiry } from "./demo/demo-countdown";
 export { DemoStart } from "./demo/demo-start";
 export type { DemoStartProps } from "./demo/demo-start";

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 ──────────────────────────────────────────────────────────────
 
 /**

package/src/rhf/fields.tsx

@@ -899,8 +899,8 @@ export type RhfDateRangePickerProps<
  *
  * Without `apply` (the picker's default) the first calendar click is reported on its
  * own, so the form holds `(from, emptyValue)` until the second; with `apply` nothing
- * reaches the form until Apply. `apply` was `commit="apply"` until 0.52 (deprecated, gone
- * in 0.53): `commit` is now the write lock's, as on every other binding — with
+ * reaches the form until Apply. `apply` was `commit="apply"` until 0.52 (gone in 0.53):
+ * `commit` is now the write lock's, as on every other binding — with
  * `disabledReason`, the picker's own (refactor audit 2026-10-30, API-3).
  *
  * The common props (`label`, `hint`, `required`, `disabled`, `excludeWhenDisabled`,

package/src/search/search-index.ts

@@ -281,18 +281,3 @@ function capByGroup<E extends SearchEntry>(hits: SearchHit<E>[], groupLimit: num
   }
   return out;
 }
-
-/**
- * One-shot form of {@link createSearchIndex}: the matching entries, best first. For a
- * list that changes on every call (a server response, a store selector); build an index
- * once when the entries are stable.
- */
-export function matchEntries<E extends SearchEntry>(
-  entries: readonly E[],
-  query: string,
-  options?: SearchIndexOptions,
-): E[] {
-  return createSearchIndex(entries, options)
-    .search(query)
-    .map((hit) => hit.entry);
-}

package/src/search.ts

@@ -1,14 +1,14 @@
 // `@eifi1/ui-kit/search` — the command palette / global search.
 // A re-slicing of the main barrel, not a new API.
 export * from "./search/command-palette";
-export * from "./search/search-index";
-// 0.52: the slice's share of the 55 names no app reads (refactor audit 2026-10-30, API-4).
+// Named, not `*`: 0.53 took `SEARCH_TIER_POINTS` and `normalizeSearchText` off the surface
+// (deprecated in 0.52, refactor audit 2026-10-30, API-4); the index keeps them.
 export {
-  /** @deprecated 0.52 — `createSearchIndex`, whose ranking tiers it spaces (API-4); removed in 0.53 */
-  SEARCH_TIER_POINTS,
-  /** @deprecated 0.52 — `createSearchIndex(entries).search(query)`, the same match (API-4); removed in 0.53 */
-  matchEntries,
-  /** @deprecated 0.52 — `foldForSearch`, the list fold it builds on (API-4); removed in 0.53 */
-  normalizeSearchText,
+  createSearchIndex,
+  type SearchEntry,
+  type SearchMatchField,
+  type SearchHit,
+  type SearchIndexOptions,
+  type SearchIndex,
 } from "./search/search-index";
 export * from "./search/global-search";