@eifi1/ui-kit 0.51.7 → 0.52.0

package/src/hooks/use-mounted.ts

@@ -0,0 +1,39 @@
+import { useEffect, useRef } from "react";
+
+/**
+ * A mounted guard and a callback-to-promise bridge, for a card that awaits an app's
+ * callback and must not set state after the page moved on.
+ *
+ * Written for the account settings parts (0.34) and then imported by seven notifications
+ * modules out of `account/account-parts.ts`: a generic helper living in a feature folder
+ * that the folder beside it reached into sideways (refactor audit 2026-10-30, MOD-6).
+ * `account-parts.ts` re-exports both, so nothing that imported them there moved, and
+ * `admin/admin-parts.ts` re-exports `settle` in place of its own copy (0.52 code review).
+ *
+ * @internal Not part of the barrel.
+ */
+
+/** Whether the component is still mounted — a late answer after the app navigated away
+ *  (the deletion signs out) must not set state. */
+export function useMounted(): { readonly current: boolean } {
+  const mounted = useRef(true);
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+    };
+  }, []);
+  return mounted;
+}
+
+/** Call `call` and hand back a promise, a throw included — a callback may return
+ *  nothing (done at once), a promise, or throw before it returns one. Typed by what it
+ *  answers, so the admin parts' copy, which kept the type, could go (0.52 code review,
+ *  admin/admin-parts.ts). */
+export function settle<R>(call: () => R): Promise<Awaited<R>> {
+  try {
+    return Promise.resolve(call());
+  } catch (error) {
+    return Promise.reject(error);
+  }
+}

package/src/hooks/use-overlay-history.ts

@@ -161,6 +161,9 @@ const consumed = new Set<string>();
  *  `history.go(-n)` traversal fires exactly ONE popstate however far it travels. */
 let pendingProgrammatic = 0;
 let listening = false;
+/** Whether the gesture listeners ({@link noteAddress}, {@link noteSeen}) are on — see
+ *  {@link syncGestureListeners}. */
+let noting = false;
 let nextId = 0;
 
 /**
@@ -518,6 +521,7 @@ function closeOnPop() {
     return;
   }
   stack.pop();
+  syncGestureListeners();
   // The browser consumed this entry, so the overlay's own cleanup has nothing left
   // to unwind and nothing to record as owed.
   consumed.add(top.id);
@@ -551,15 +555,38 @@ function putBack(id: string): void {
   if (record) record.href = record.seen = currentHref();
 }
 
+/** `popstate` stays from the first overlay on: a traversal of ours (an unwind, a buried
+ *  run to skip) lands after the overlay that caused it has gone. */
 function ensureListening() {
   if (listening || typeof window === "undefined") return;
   window.addEventListener("popstate", handlePop);
-  window.addEventListener("pointerdown", noteAddress, true);
-  window.addEventListener("keydown", noteAddress, true);
-  for (const type of ["click", "keyup", "change", "input"]) window.addEventListener(type, noteSeenNowAndLater);
   listening = true;
 }
 
+const SEEN_EVENTS = ["click", "keyup", "change", "input"] as const;
+
+/**
+ * The gesture listeners, on while an overlay is open and off when the last one closes.
+ * Both notes return at once with no overlay up, but the four bubbling ones scheduled a
+ * timer for their second look even then — for every click and every keystroke in every
+ * field, for the life of the page after its first dialog (refactor audit 2026-10-30,
+ * INP-14). Called after each change to `stack`.
+ */
+function syncGestureListeners(): void {
+  const want = stack.length > 0;
+  if (want === noting || typeof window === "undefined") return;
+  noting = want;
+  if (want) {
+    window.addEventListener("pointerdown", noteAddress, true);
+    window.addEventListener("keydown", noteAddress, true);
+    for (const type of SEEN_EVENTS) window.addEventListener(type, noteSeenNowAndLater);
+  } else {
+    window.removeEventListener("pointerdown", noteAddress, true);
+    window.removeEventListener("keydown", noteAddress, true);
+    for (const type of SEEN_EVENTS) window.removeEventListener(type, noteSeenNowAndLater);
+  }
+}
+
 /**
  * Make the platform Back gesture dismiss an overlay.
  *
@@ -587,6 +614,7 @@ export function useOverlayHistory(open: boolean, onClose: () => void, { held = f
     const id = `overlay-${(nextId += 1)}`;
     const entry: OverlayEntry = { id, close: () => closeRef.current(), held: () => heldRef.current };
     stack.push(entry);
+    syncGestureListeners();
     const prev = window.history.state;
     const marked = { ...(prev && typeof prev === "object" ? prev : {}), [SENTINEL_KEY]: id };
     // An entry that is on its way out and that we are still standing on is ours
@@ -634,6 +662,7 @@ export function useOverlayHistory(open: boolean, onClose: () => void, { held = f
     return () => {
       const at = stack.indexOf(entry);
       if (at >= 0) stack.splice(at, 1);
+      syncGestureListeners();
 
       // A Back press already took this entry; there is nothing to unwind or to owe.
       if (consumed.delete(id)) return;

package/src/i18n/defaults.ts

@@ -6,11 +6,8 @@ import { DEFAULT_PAGE_CONTENTS_LABELS } from "../components/page-contents-labels
 import { DEFAULT_POPOVER_LABELS } from "../components/popover-labels";
 import { DEFAULT_CHIP_INPUT_LABELS } from "../components/chip-labels";
 import { DEFAULT_FIELD_SYNC_LABELS } from "../components/field-sync-labels";
-import {
-  DEFAULT_CHARACTER_COUNT_LABELS,
-  DEFAULT_PASSWORD_REVEAL_LABELS,
-  DEFAULT_TABS_LABELS,
-} from "../components/ui-labels";
+import { DEFAULT_CHARACTER_COUNT_LABELS, DEFAULT_PASSWORD_REVEAL_LABELS } from "../components/field-base-labels";
+import { DEFAULT_TABS_LABELS } from "../components/tabs-labels";
 import { DEFAULT_WIZARD_LABELS } from "../wizard/wizard-labels";
 import { DEFAULT_TOUR_LABELS } from "../tour/tour-labels";
 import { DEFAULT_TOUR_CATALOGUE_LABELS } from "../tour/tour-catalogue-labels";
@@ -19,6 +16,7 @@ import { DEFAULT_COMMAND_PALETTE_LABELS } from "../search/command-palette-labels
 import { DEFAULT_GLOBAL_SEARCH_LABELS } from "../search/global-search-labels";
 import { DEFAULT_SERIES_CHART_LABELS } from "../components/series-chart-labels";
 import { DEFAULT_PIE_CHART_LABELS } from "../components/pie-chart-labels";
+import { DEFAULT_TREEMAP_LABELS } from "../components/treemap-labels";
 import { DEFAULT_SPARKLINE_LABELS } from "../components/sparkline-labels";
 import { DEFAULT_STAT_TILE_LABELS } from "../components/stat-tile-labels";
 import { DEFAULT_SIGNATURE_PAD_LABELS } from "../components/signature-pad-labels";
@@ -176,6 +174,7 @@ export const DEFAULT_UI_KIT_LABELS: UiKitLabels = {
   globalSearch: DEFAULT_GLOBAL_SEARCH_LABELS,
   seriesChart: DEFAULT_SERIES_CHART_LABELS,
   pieChart: DEFAULT_PIE_CHART_LABELS,
+  treemap: DEFAULT_TREEMAP_LABELS,
   sparkline: DEFAULT_SPARKLINE_LABELS,
   statTile: DEFAULT_STAT_TILE_LABELS,
   signaturePad: DEFAULT_SIGNATURE_PAD_LABELS,

package/src/i18n/german.ts

@@ -18,7 +18,7 @@ export function germanLabels(numberLocale: string): UiKitLabels {
   const num = new Intl.NumberFormat(numberLocale);
   const n = (value: number) => num.format(value);
   // 0.30.0 — a throttled request (HTTP 429), as `englishRateLimited` in
-  // src/auth/auth-errors.ts: no wait → "einen Moment", under a minute → seconds, else
+  // src/auth/auth-errors-labels.ts: no wait → "einen Moment", under a minute → seconds, else
   // minutes rounded up. kastlan's reviewed "auth.throttled" is the sentence without one.
   const wait = (seconds: number) => (seconds < 60 ? `${n(Math.ceil(seconds))} s` : `${n(Math.ceil(seconds / 60))} min`);
   const rateLimited = (seconds?: number) =>
@@ -749,10 +749,16 @@ export function germanLabels(numberLocale: string): UiKitLabels {
     pieChart: {
       slices: "Diagrammsegmente",
       slice: (label, value, percent) => `${label}: ${value} (${percent})`,
+      sliceShare: (label, percent) => `${label}: ${percent}`,
       total: "Gesamt",
       empty: "Keine Daten",
       legend: "Kategorien",
     },
+    treemap: {
+      tile: (name, value, share) => `${name}: ${value} (${share})`,
+      group: (name, value, share) => `${name}, Gruppe: ${value} (${share})`,
+      inGroup: (name, group) => `${name}, in ${group}`,
+    },
     confirmDialog: {
       confirm: "Bestätigen",
       cancel: "Abbrechen",
@@ -1303,6 +1309,7 @@ export function germanLabels(numberLocale: string): UiKitLabels {
       stoppedAll: (app) => `Erledigt. Sie erhalten keine Benachrichtigungs-E-Mails von ${app} mehr.`,
       accountMail: "E-Mails zu Ihrem Konto erhalten Sie weiterhin.",
       turnBackOn: "Sie können sie jederzeit in den Einstellungen wieder einschalten.",
+      stoppedHint: (accountMail, turnBackOn) => `${accountMail} ${turnBackOn}`,
       openSettings: "Einstellungen öffnen",
       invalidLink:
         "Dieser Link funktioniert nicht mehr. Sie können E-Mails stattdessen in den Einstellungen abbestellen.",
@@ -2032,7 +2039,6 @@ export function germanLabels(numberLocale: string): UiKitLabels {
         menu: "Dev-Werkzeuge",
         overridesOn: "Überschreibungen aktiv",
         roleHeading: "Dev · Rolle",
-        switchPlan: "Tarif wechseln",
         plan: (value) => `Tarif: ${value}`,
         planHeading: "Dev · Tarif",
         backTo: (role) => `Zurück zu ${role}`,

package/src/i18n/kit-labels.tsx

@@ -33,6 +33,7 @@ import type { MonthPickerLabels } from "../components/month-picker";
 import type { PageContentsLabels } from "../components/page-contents";
 import type { SeriesChartLabels } from "../components/series-chart-labels";
 import type { PieChartLabels } from "../components/pie-chart-labels";
+import type { TreemapLabels } from "../components/treemap-labels";
 import type { SparklineLabels } from "../components/sparkline";
 import type { StatTileLabels } from "../components/stat-tile";
 import type { SignaturePadLabels } from "../components/signature-pad";
@@ -203,7 +204,7 @@ export interface DatePickerLabels {
   previousDay: string;
   nextDay: string;
   today: string;
-  /** `DateRangePicker commit="apply"`: the button that commits the drafted range. */
+  /** `DateRangePicker apply`: the button that commits the drafted range. */
   apply: string;
   /** …and the one that discards it. */
   cancel: string;
@@ -283,6 +284,8 @@ export interface TopBarLabels {
   /** 0.49 KIT-10: the language menu's trigger, given the current language's name —
    *  "Choose language, current: Deutsch". */
   languageCurrent: (name: string) => string;
+  /** RoleSwitcher's name, and nothing else reads it (DevMenu's flask is `topBarParts.dev`).
+   *  @deprecated 0.52 — none: it goes with RoleSwitcher (MOD-5); removed in 0.53. */
   switchRole: string;
   /** The role switcher's tooltip, given the active role's name. */
   role: (value: string) => string;
@@ -319,6 +322,7 @@ export interface UiKitLabels {
   calculator: CalculatorLabels;
   currency: CurrencyLabels;
   chipInput: ChipInputLabels;
+  /** @deprecated 0.52 — none: it goes with the FieldSync family (MOD-5); removed in 0.53. */
   fieldSync: FieldSyncLabels;
   passwordReveal: PasswordRevealLabels;
   tabs: TabsLabels;
@@ -338,6 +342,8 @@ export interface UiKitLabels {
   globalSearch: GlobalSearchLabels;
   seriesChart: SeriesChartLabels;
   pieChart: PieChartLabels;
+  /** 0.52: a tile's accessible name (refactor audit 2026-10-30, DSP-5). */
+  treemap: TreemapLabels;
   sparkline: SparklineLabels;
   statTile: StatTileLabels;
   signaturePad: SignaturePadLabels;
@@ -481,7 +487,8 @@ export interface UiKitLabels {
   ibanInput: IbanInputLabels;
   /** 0.22.0: `PhoneInput`'s country-code select. */
   phoneInput: PhoneInputLabels;
-  /** 0.22.0: `SignChip` — the outflow / inflow toggle beside an amount. */
+  /** 0.22.0: `SignChip` — the outflow / inflow toggle beside an amount.
+   *  @deprecated 0.52 — none: it goes with SignChip (MOD-5); removed in 0.53. */
   signChip: SignChipLabels;
   /** 0.23.0: `ColumnMapper` / `ColumnRoleTable` — a pasted or dropped table, a role per
    *  column. */

package/src/i18n/locales/es.ts

@@ -15,7 +15,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
   const n = (value: number) => num.format(value);
   const plural = (count: number, one: string, many: string) => (count === 1 ? one : many);
   // 0.30.0 — a throttled request (HTTP 429), as `englishRateLimited` in
-  // src/auth/auth-errors.ts: no wait → "un momento", under a minute → seconds, else
+  // src/auth/auth-errors-labels.ts: no wait → "un momento", under a minute → seconds, else
   // minutes rounded up.
   const wait = (seconds: number) => (seconds < 60 ? `${n(Math.ceil(seconds))} s` : `${n(Math.ceil(seconds / 60))} min`);
   const rateLimited = (seconds?: number) =>
@@ -737,10 +737,16 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
     pieChart: {
       slices: "Sectores del gráfico",
       slice: (label, value, percent) => `${label}: ${value} (${percent})`,
+      sliceShare: (label, percent) => `${label}: ${percent}`,
       total: "Total",
       empty: "Sin datos",
       legend: "Categorías",
     },
+    treemap: {
+      tile: (name, value, share) => `${name}: ${value} (${share})`,
+      group: (name, value, share) => `${name}, grupo: ${value} (${share})`,
+      inGroup: (name, group) => `${name}, en ${group}`,
+    },
     confirmDialog: {
       confirm: "Confirmar",
       cancel: "Cancelar",
@@ -1276,6 +1282,7 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
       stoppedAll: (app) => `Hecho. Ya no recibirá correos de notificación de ${app}.`,
       accountMail: "Los correos sobre su cuenta seguirán llegando.",
       turnBackOn: "Puede volver a activarlos en cualquier momento en los ajustes.",
+      stoppedHint: (accountMail, turnBackOn) => `${accountMail} ${turnBackOn}`,
       openSettings: "Abrir los ajustes",
       invalidLink: "Este enlace ya no funciona. Puede desactivar los correos en los ajustes.",
       failed: "No ha funcionado. Inténtelo de nuevo.",
@@ -1970,7 +1977,6 @@ export function uiKitLabelsEs(numberLocale = "es-ES"): UiKitLabels {
         menu: "Herramientas de desarrollo",
         overridesOn: "Anulaciones activas",
         roleHeading: "Dev · rol",
-        switchPlan: "Cambiar de plan",
         plan: (value) => `Plan: ${value}`,
         planHeading: "Dev · plan",
         backTo: (role) => `Volver a ${role}`,

package/src/i18n/locales/fr.ts

@@ -15,7 +15,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
   const n = (value: number) => num.format(value);
   const plural = (count: number, one: string, many: string) => (count < 2 ? one : many);
   // 0.30.0 — a throttled request (HTTP 429), as `englishRateLimited` in
-  // src/auth/auth-errors.ts: no wait → "un instant", under a minute → seconds, else
+  // src/auth/auth-errors-labels.ts: no wait → "un instant", under a minute → seconds, else
   // minutes rounded up. kastlan's reviewed "auth.throttled" is the sentence without one.
   const wait = (seconds: number) =>
     seconds < 60 ? `${n(Math.ceil(seconds))}\u00a0s` : `${n(Math.ceil(seconds / 60))}\u00a0min`;
@@ -39,9 +39,11 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       attachmentScreenshot: "Capture d’écran",
       attachmentRemoveFile: (name) => `Retirer ${name}`,
       attachmentLimit: (max) =>
-        max === 1
-          ? `${n(max)} pièce jointe au maximum — retirez-la pour en ajouter une autre.`
-          : `${n(max)} pièces jointes au maximum — retirez-en une pour en ajouter une autre.`,
+        plural(
+          max,
+          `${n(max)} pièce jointe au maximum — retirez-la pour en ajouter une autre.`,
+          `${n(max)} pièces jointes au maximum — retirez-en une pour en ajouter une autre.`,
+        ),
       attachmentUploading: "Envoi en cours…",
       attachmentUploadFailed: (name) => `«\u202f${name}\u202f» n’a pas pu être envoyé`,
     },
@@ -123,9 +125,9 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       sortUpdated: "Mis à jour récemment",
       search: "Rechercher dans les titres",
       columnVotes: "Votes",
-      total: (count) => (count === 1 ? "1 retour" : `${n(count)} retours`),
-      comments: (count) => (count === 1 ? "1 commentaire" : `${n(count)} commentaires`),
-      votes: (count) => (count === 1 ? "1 vote" : `${n(count)} votes`),
+      total: (count) => `${n(count)} ${plural(count, "retour", "retours")}`,
+      comments: (count) => `${n(count)} ${plural(count, "commentaire", "commentaires")}`,
+      votes: (count) => `${n(count)} ${plural(count, "vote", "votes")}`,
       anonymous: "Une personne",
       filedBy: (name) => `De ${name}`,
       body: "Description",
@@ -168,7 +170,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       // An id, not a count: printed as it is, like the "#" column.
       userFallback: (id) => `utilisateur #${id}`,
       environment: (environment) => String(environment ?? "").toUpperCase(),
-      reworkChip: (count) => (count === 1 ? "Reprise" : `Reprise ×${n(count)}`),
+      reworkChip: (count) => plural(count, "Reprise", `Reprise ×${n(count)}`),
       awaitingFilter: "Seulement ce qui vous attend",
       phoneActions: "Actions sur les retours",
     },
@@ -420,7 +422,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       less: "Moins",
       more: "Plus",
       truncated: (count) =>
-        `Affichage des jours les plus récents ; ${n(count)} ${count === 1 ? "jour antérieur n’est pas affiché" : "jours antérieurs ne sont pas affichés"}.`,
+        `Affichage des jours les plus récents ; ${n(count)} ${plural(count, "jour antérieur n’est pas affiché", "jours antérieurs ne sont pas affichés")}.`,
     },
     datePicker: {
       apply: "Appliquer",
@@ -556,7 +558,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       close: "Fermer",
     },
     bulkActionBar: {
-      selected: (count) => `${n(count)} ${count === 1 ? "sélectionné" : "sélectionnés"}`,
+      selected: (count) => `${n(count)} ${plural(count, "sélectionné", "sélectionnés")}`,
       clear: "Effacer la sélection",
       cleared: "Sélection effacée",
     },
@@ -654,7 +656,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       badgeUpdated: "Mise à jour",
       resetOn: (date, reason) => (reason ? `Réinitialisée le ${date}\u202f: ${reason}` : `Réinitialisée le ${date}`),
       points: (count) => `+${n(count)} pts`,
-      steps: (count) => (count === 1 ? `${n(count)} étape` : `${n(count)} étapes`),
+      steps: (count) => `${n(count)} ${plural(count, "étape", "étapes")}`,
       duration: (minutes) => `Environ ${n(minutes)} min`,
       completedOn: (date) => `Terminée le ${date}`,
       completed: "Terminée",
@@ -746,10 +748,16 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
     pieChart: {
       slices: "Secteurs du graphique",
       slice: (label, value, percent) => `${label}\u00a0: ${value} (${percent})`,
+      sliceShare: (label, percent) => `${label}\u00a0: ${percent}`,
       total: "Total",
       empty: "Aucune donnée",
       legend: "Catégories",
     },
+    treemap: {
+      tile: (name, value, share) => `${name}\u00a0: ${value} (${share})`,
+      group: (name, value, share) => `${name}, groupe\u00a0: ${value} (${share})`,
+      inGroup: (name, group) => `${name}, dans ${group}`,
+    },
     confirmDialog: {
       confirm: "Confirmer",
       cancel: "Annuler",
@@ -1286,7 +1294,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       clearPrompt: "Supprimer toutes les notifications de votre boîte de réception\u202f?",
       showMore: "Afficher plus",
       bellLabel: "Notifications",
-      bellUnread: (count) => (count === 1 ? `${n(count)} non lue` : `${n(count)} non lues`),
+      bellUnread: (count) => `${n(count)} ${plural(count, "non lue", "non lues")}`,
       allNotifications: "Toutes les notifications",
       unsubscribeTitle: "Notifications par e-mail",
       unsubscribeAbout: (type) => `Vous recevez des e-mails concernant\u00a0: ${type}.`,
@@ -1297,6 +1305,7 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
       stoppedAll: (app) => `C’est fait. Vous ne recevrez plus d’e-mails de notification de ${app}.`,
       accountMail: "Les e-mails concernant votre compte continuent d’arriver.",
       turnBackOn: "Vous pouvez les réactiver à tout moment dans les paramètres.",
+      stoppedHint: (accountMail, turnBackOn) => `${accountMail} ${turnBackOn}`,
       openSettings: "Ouvrir les paramètres",
       invalidLink: "Ce lien ne fonctionne plus. Vous pouvez désactiver les e-mails dans les paramètres.",
       failed: "Cela n’a pas fonctionné. Veuillez réessayer.",
@@ -2006,7 +2015,6 @@ export function uiKitLabelsFr(numberLocale = "fr-FR"): UiKitLabels {
         menu: "Outils de dev",
         overridesOn: "Forçages actifs",
         roleHeading: "Dev · rôle",
-        switchPlan: "Changer de formule",
         plan: (value) => `Formule\u00a0: ${value}`,
         planHeading: "Dev · formule",
         backTo: (role) => `Revenir à ${role}`,

package/src/i18n/locales/hu.ts

@@ -14,7 +14,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
   const num = new Intl.NumberFormat(numberLocale);
   const n = (value: number) => num.format(value);
   // 0.30.0 — a throttled request (HTTP 429), as `englishRateLimited` in
-  // src/auth/auth-errors.ts: no wait → "egy kicsit", under a minute → seconds, else
+  // src/auth/auth-errors-labels.ts: no wait → "egy kicsit", under a minute → seconds, else
   // minutes rounded up. The numeral stays bare before its unit ("30 mp múlva").
   const wait = (seconds: number) =>
     seconds < 60 ? `${n(Math.ceil(seconds))} mp` : `${n(Math.ceil(seconds / 60))} perc`;
@@ -736,10 +736,18 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
     pieChart: {
       slices: "Diagramszeletek",
       slice: (label, value, percent) => `${label}: ${value} (${percent})`,
+      sliceShare: (label, percent) => `${label}: ${percent}`,
       total: "Összesen",
       empty: "Nincs adat",
       legend: "Kategóriák",
     },
+    treemap: {
+      tile: (name, value, share) => `${name}: ${value} (${share})`,
+      // Appositive, not a case ending: "-ban/-ben" and the article follow the name's own
+      // sounds, which a template cannot know.
+      group: (name, value, share) => `${name} csoport: ${value} (${share})`,
+      inGroup: (name, group) => `${name}, ${group} csoport`,
+    },
     confirmDialog: {
       confirm: "Megerősítés",
       cancel: "Mégse",
@@ -1281,6 +1289,7 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
       stoppedAll: (app) => `Kész. A(z) ${app} értesítő e-mailjeit többé nem kapja meg.`,
       accountMail: "A fiókjával kapcsolatos e-maileket továbbra is megkapja.",
       turnBackOn: "A beállításokban bármikor újra bekapcsolhatja őket.",
+      stoppedHint: (accountMail, turnBackOn) => `${accountMail} ${turnBackOn}`,
       openSettings: "Beállítások megnyitása",
       invalidLink: "Ez a link már nem működik. Az e-maileket a beállításokban is kikapcsolhatja.",
       failed: "Ez nem sikerült. Kérjük, próbálja újra.",
@@ -1977,7 +1986,6 @@ export function uiKitLabelsHu(numberLocale = "hu-HU"): UiKitLabels {
         menu: "Fejlesztői eszközök",
         overridesOn: "Felülbírálások bekapcsolva",
         roleHeading: "Dev · szerepkör",
-        switchPlan: "Csomag váltása",
         plan: (value) => `Csomag: ${value}`,
         planHeading: "Dev · csomag",
         backTo: (role) => `Vissza: ${role}`,

package/src/i18n/locales/it.ts

@@ -15,7 +15,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
   const n = (value: number) => num.format(value);
   const plural = (count: number, one: string, many: string) => (count === 1 ? one : many);
   // 0.30.0 — a throttled request (HTTP 429), as `englishRateLimited` in
-  // src/auth/auth-errors.ts: no wait → "un momento", under a minute → seconds, else
+  // src/auth/auth-errors-labels.ts: no wait → "un momento", under a minute → seconds, else
   // minutes rounded up. kastlan's reviewed "auth.throttled" is the sentence without one.
   const wait = (seconds: number) => (seconds < 60 ? `${n(Math.ceil(seconds))} s` : `${n(Math.ceil(seconds / 60))} min`);
   const rateLimited = (seconds?: number) =>
@@ -739,10 +739,16 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
     pieChart: {
       slices: "Settori del grafico",
       slice: (label, value, percent) => `${label}: ${value} (${percent})`,
+      sliceShare: (label, percent) => `${label}: ${percent}`,
       total: "Totale",
       empty: "Nessun dato",
       legend: "Categorie",
     },
+    treemap: {
+      tile: (name, value, share) => `${name}: ${value} (${share})`,
+      group: (name, value, share) => `${name}, gruppo: ${value} (${share})`,
+      inGroup: (name, group) => `${name}, in ${group}`,
+    },
     confirmDialog: {
       confirm: "Conferma",
       cancel: "Annulla",
@@ -1284,6 +1290,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       stoppedAll: (app) => `Fatto. Non riceverà più e-mail di notifica da ${app}.`,
       accountMail: "Le e-mail sul Suo account continuano ad arrivare.",
       turnBackOn: "Può riattivarle in qualsiasi momento nelle impostazioni.",
+      stoppedHint: (accountMail, turnBackOn) => `${accountMail} ${turnBackOn}`,
       openSettings: "Apri le impostazioni",
       invalidLink: "Questo link non funziona più. Può disattivare le e-mail nelle impostazioni.",
       failed: "Non ha funzionato. Riprovi.",
@@ -1986,7 +1993,6 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
         menu: "Strumenti di sviluppo",
         overridesOn: "Override attivi",
         roleHeading: "Dev · ruolo",
-        switchPlan: "Cambia piano",
         plan: (value) => `Piano: ${value}`,
         planHeading: "Dev · piano",
         backTo: (role) => `Torna a ${role}`,

package/src/i18n/locales/zh.ts

@@ -14,7 +14,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
   const num = new Intl.NumberFormat(numberLocale);
   const n = (value: number) => num.format(value);
   // 0.30.0 — a throttled request (HTTP 429), as `englishRateLimited` in
-  // src/auth/auth-errors.ts: no wait → "稍候", under a minute → seconds, else minutes
+  // src/auth/auth-errors-labels.ts: no wait → "稍候", under a minute → seconds, else minutes
   // rounded up. The numeral has a space either side, as everywhere in this catalogue.
   const wait = (seconds: number) =>
     seconds < 60 ? `${n(Math.ceil(seconds))} 秒` : `${n(Math.ceil(seconds / 60))} 分钟`;
@@ -720,10 +720,16 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
     pieChart: {
       slices: "图表扇区",
       slice: (label, value, percent) => `${label}：${value}（${percent}）`,
+      sliceShare: (label, percent) => `${label}：${percent}`,
       total: "合计",
       empty: "无数据",
       legend: "类别",
     },
+    treemap: {
+      tile: (name, value, share) => `${name}：${value}（${share}）`,
+      group: (name, value, share) => `${name}（组）：${value}（${share}）`,
+      inGroup: (name, group) => `${name}，属于${group}`,
+    },
     confirmDialog: {
       confirm: "确认",
       cancel: "取消",
@@ -1244,6 +1250,8 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       stoppedAll: (app) => `已完成。您将不再收到来自 ${app} 的通知邮件。`,
       accountMail: "有关您账户的邮件仍会照常发送。",
       turnBackOn: "您可以随时在“设置”中重新开启。",
+      // Chinese puts no space between sentences (refactor audit 2026-10-30, DOC-11).
+      stoppedHint: (accountMail, turnBackOn) => `${accountMail}${turnBackOn}`,
       openSettings: "打开设置",
       invalidLink: "此链接已失效。您可以改为在“设置”中关闭这些邮件。",
       failed: "操作未成功，请重试。",
@@ -1888,7 +1896,6 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
         menu: "开发工具",
         overridesOn: "覆盖已开启",
         roleHeading: "开发 · 角色",
-        switchPlan: "切换套餐",
         plan: (value) => `套餐：${value}`,
         planHeading: "开发 · 套餐",
         backTo: (role) => `返回 ${role}`,

package/src/i18n/review.ts

@@ -162,6 +162,10 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "tour.backToStep": [["{{title}}"]],
   "globalSearch.shortcut": [["{{keys}}"]],
   "pieChart.slice": [["{{label}}", "{{value}}", "{{percent}}"]],
+  "pieChart.sliceShare": [["{{label}}", "{{percent}}"]],
+  "treemap.tile": [["{{name}}", "{{value}}", "{{share}}"]],
+  "treemap.group": [["{{name}}", "{{value}}", "{{share}}"]],
+  "treemap.inGroup": [["{{name}}", "{{group}}"]],
   "sparkline.rising": [["{{first}}", "{{last}}"]],
   "sparkline.falling": [["{{first}}", "{{last}}"]],
   "sparkline.flat": [["{{value}}"]],
@@ -352,6 +356,7 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "notifications.unsubscribeAbout": [["{{type}}"]],
   "notifications.stopAll": [["{{app}}"]],
   "notifications.stoppedAll": [["{{app}}"]],
+  "notifications.stoppedHint": [["{{accountMail}}", "{{turnBackOn}}"]],
   "deleteAccount.afterDays": [[1], [30]],
   "deleteAccount.handOver": [[1], [3]],
   "deleteAccount.lastAdminOf": [["{{companies}}"]],