@eifi1/ui-kit 0.43.0 → 0.45.0

package/src/i18n/locales/it.ts

@@ -626,7 +626,7 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       stateDone: (count) => `Completati (${n(count)})`,
       showing: (shown, total) => `${n(shown)} di ${n(total)} tour`,
       noMatches: "Nessun tour corrisponde",
-      noMatchesHint: "Provi un’altra parola o cancelli i filtri.",
+      noMatchesHint: "Provi un’altra parola o cancelli il filtro.",
       clearFilters: "Cancella filtri",
       badgeNew: "Nuovo",
       badgeUpdated: "Aggiornato",
@@ -1385,11 +1385,14 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
       // ("Azienda creata"; Kurvenschmiede's "il team" is masculine, never "squadra"), a
       // member's with "account", as `actions` do. `budget` is keksdose's; `company` keeps
       // `actions.membership_remove`'s string.
+      renamedFromTo: (from, to) => `da ${from} a ${to}`,
       groupActions: {
         group: {
           group_create: "Gruppo creato",
           group_rename: "Gruppo rinominato",
           group_delete: "Gruppo eliminato",
+          group_deactivate: "Gruppo disattivato",
+          group_reactivate: "Gruppo riattivato",
           membership_add: "Aggiunto al gruppo",
           membership_role: "Ruolo nel gruppo cambiato",
           membership_remove: "Rimosso dal gruppo",
@@ -1399,6 +1402,8 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
           group_create: "Team creato",
           group_rename: "Team rinominato",
           group_delete: "Team eliminato",
+          group_deactivate: "Team disattivato",
+          group_reactivate: "Team riattivato",
           membership_add: "Aggiunto al team",
           membership_role: "Ruolo nel team cambiato",
           membership_remove: "Rimosso dal team",
@@ -1408,6 +1413,8 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
           group_create: "Azienda creata",
           group_rename: "Azienda rinominata",
           group_delete: "Azienda eliminata",
+          group_deactivate: "Azienda disattivata",
+          group_reactivate: "Azienda riattivata",
           membership_add: "Aggiunto all’azienda",
           membership_role: "Ruolo nell’azienda cambiato",
           membership_remove: "Rimosso dall’azienda",
@@ -1417,6 +1424,8 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
           group_create: "Budget creato",
           group_rename: "Budget rinominato",
           group_delete: "Budget eliminato",
+          group_deactivate: "Budget disattivato",
+          group_reactivate: "Budget riattivato",
           membership_add: "Aggiunto al budget",
           membership_role: "Ruolo nel budget cambiato",
           membership_remove: "Rimosso dal budget",
@@ -1850,9 +1859,21 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
     },
     // 0.42.0 — docs/admin-harmonization.md §3.1: the admin area's shared words. "Lei", as
     // the rest of the catalogue.
+    mailTestCard: {
+      title: "Email di prova",
+      description: "Invia un’email al Suo indirizzo, tramite il trasporto con cui questa installazione invia tutte le sue email.",
+      transport: (backend) => `Trasporto: ${backend}`,
+      action: "Inviami un’email di prova",
+      sent: (address) => `Inviata a ${address}. Controlli la posta in arrivo.`,
+      console: "Il trasporto console registra solo le email; non è stato inviato nulla.",
+      failed: "Invio non riuscito. Il log del server contiene la risposta del provider.",
+      rateLimited,
+      keywords: "email prova test posta trasporto smtp resend console inviare consegna",
+    },
     adminArea: {
       title: "Amministrazione",
       waiting: (count) => `${n(count)} in attesa`,
+      waitingLabel: (label, count) => `${label}, ${n(count)} in attesa`,
       forbiddenTitle: "Solo per gli amministratori",
       forbiddenBody: (appName) =>
         `Qui gli amministratori gestiscono ${appName}. Il Suo account non può aprire questa pagina.`,
@@ -1921,6 +1942,31 @@ export function uiKitLabelsIt(numberLocale = "it-IT"): UiKitLabels {
         billingOff: "La fatturazione è disattivata in locale: i piani non cambiano nulla",
       },
     },
+    // 0.45.0 — docs/local-first-harmonization.md §1.6 (`@eifi1/ui-kit/offline`): keksdose's
+    // reviewed words (nav.logout_queued_*, pwa.*) where it has the language.
+    signOutPending: {
+      title: "Alcune modifiche non sono ancora state salvate sul server",
+      lost: (count) =>
+        count === 1
+          ? `${n(count)} modifica è ancora in attesa di sincronizzazione. Uscendo, la copia su questo dispositivo viene cancellata, ed è l’unica.`
+          : `${n(count)} modifiche sono ancora in attesa di sincronizzazione. Uscendo, la copia su questo dispositivo viene cancellata, ed è l’unica.`,
+      kept: (count) =>
+        count === 1
+          ? `${n(count)} modifica è ancora in attesa di sincronizzazione. Resta per Lei su questo dispositivo e verrà sincronizzata al Suo prossimo accesso qui.`
+          : `${n(count)} modifiche sono ancora in attesa di sincronizzazione. Restano per Lei su questo dispositivo e verranno sincronizzate al Suo prossimo accesso qui.`,
+      syncNow: "Sincronizza ora",
+      signOutAnyway: "Esci comunque",
+      discardWaiting: "Scarta le modifiche in attesa",
+      cancel: "Annulla",
+    },
+    pwaUpdate: {
+      updateAvailable: "È disponibile una nuova versione.",
+      reload: "Ricarica",
+    },
+    sharedComputer: {
+      label: "Questo è un computer condiviso",
+      hint: "Su questo dispositivo non resta alcuna copia dei Suoi dati. Le pagine si aprono quindi solo con una connessione.",
+    },
   };
 }
 

package/src/i18n/locales/zh.ts

@@ -1321,11 +1321,14 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       },
       // 0.34 (§11.5): whole phrases per noun. `team` is Kurvenschmiede's "团队"; `company`
       // keeps `actions.membership_remove`'s string.
+      renamedFromTo: (from, to) => `从 ${from} 改为 ${to}`,
       groupActions: {
         group: {
           group_create: "群组已创建",
           group_rename: "群组已重命名",
           group_delete: "群组已删除",
+          group_deactivate: "群组已停用",
+          group_reactivate: "群组已重新激活",
           membership_add: "已添加到群组",
           membership_role: "群组中的角色已更改",
           membership_remove: "已从群组移除",
@@ -1335,6 +1338,8 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
           group_create: "团队已创建",
           group_rename: "团队已重命名",
           group_delete: "团队已删除",
+          group_deactivate: "团队已停用",
+          group_reactivate: "团队已重新激活",
           membership_add: "已添加到团队",
           membership_role: "团队中的角色已更改",
           membership_remove: "已从团队移除",
@@ -1344,6 +1349,8 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
           group_create: "公司已创建",
           group_rename: "公司已重命名",
           group_delete: "公司已删除",
+          group_deactivate: "公司已停用",
+          group_reactivate: "公司已重新激活",
           membership_add: "已添加到公司",
           membership_role: "公司中的角色已更改",
           membership_remove: "已从公司移除",
@@ -1353,6 +1360,8 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
           group_create: "预算已创建",
           group_rename: "预算已重命名",
           group_delete: "预算已删除",
+          group_deactivate: "预算已停用",
+          group_reactivate: "预算已重新激活",
           membership_add: "已添加到预算",
           membership_role: "预算中的角色已更改",
           membership_remove: "已从预算移除",
@@ -1754,9 +1763,21 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       moreTitle: "更多页面",
     },
     // 0.42.0 — docs/admin-harmonization.md §3.1: the admin area's shared words.
+    mailTestCard: {
+      title: "测试邮件",
+      description: "通过本安装发送所有邮件所用的传输方式，向您自己的地址发送一封邮件。",
+      transport: (backend) => `传输方式：${backend}`,
+      action: "给我发送测试邮件",
+      sent: (address) => `已发送至 ${address}。请查看收件箱。`,
+      console: "控制台传输只记录邮件，未发送任何邮件。",
+      failed: "无法发送。服务器日志中有服务商的回复。",
+      rateLimited,
+      keywords: "测试邮件 邮件 电子邮件 传输 smtp resend 控制台 发送 投递",
+    },
     adminArea: {
       title: "管理",
       waiting: (count) => `${n(count)} 项待处理`,
+      waitingLabel: (label, count) => `${label}，${n(count)} 项待处理`,
       forbiddenTitle: "仅限管理员",
       forbiddenBody: (appName) => `管理员在这里管理 ${appName}。您的账户无法打开此页面。`,
       forbiddenHome: "前往首页",
@@ -1822,6 +1843,25 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
         billingOff: "本地已关闭计费：切换套餐不会改变任何内容",
       },
     },
+    // 0.45.0 — docs/local-first-harmonization.md §1.6 (`@eifi1/ui-kit/offline`): keksdose's
+    // reviewed words (nav.logout_queued_*, pwa.*) where it has the language.
+    signOutPending: {
+      title: "部分修改尚未保存到服务器",
+      lost: (count) => `${n(count)} 项修改仍在等待同步。退出登录会清除此设备上的副本，而这是唯一的副本。`,
+      kept: (count) => `${n(count)} 项修改仍在等待同步。它们会为您保留在此设备上，并在您下次在此登录时同步。`,
+      syncNow: "立即同步",
+      signOutAnyway: "仍然退出登录",
+      discardWaiting: "放弃等待中的修改",
+      cancel: "取消",
+    },
+    pwaUpdate: {
+      updateAvailable: "有新版本可用。",
+      reload: "重新加载",
+    },
+    sharedComputer: {
+      label: "这是一台共用电脑",
+      hint: "此设备上不会保留您的数据副本。页面将只能在联网时打开。",
+    },
   };
 }
 

package/src/i18n/review.ts

@@ -353,6 +353,8 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "adminActionLog.by": [["{{actor}}"]],
   "adminActionLog.filteredTo": [["{{target}}"]],
   "adminActionLog.filterBy": [["{{target}}"]],
+  // 0.45.0 (admin §9.4): a company rename that logged both names.
+  "adminActionLog.renamedFromTo": [["{{from}}", "{{to}}"]],
   "transferOwnership.title": [["{{name}}"]],
   "transferOwnership.unavailable": [["{{account}}", "{{reason}}"]],
   "invitations.sent": [["{{date}}"]],
@@ -406,6 +408,12 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   // 0.42.0 (docs/admin-harmonization.md §3.1): the menu row's count, the 403 page's app,
   // the users tile's new accounts.
   "adminArea.waiting": one,
+  // 0.45.0 (admin §9.3.4): an IconButton's name with its waiting count.
+  "adminArea.waitingLabel": [["{{label}}", 1], ["{{label}}", 3]],
+  // 0.45.0 (admin §9.2.4): the test mail's transport, masked address and limiter.
+  "mailTestCard.transport": [["{{backend}}"]],
+  "mailTestCard.sent": [["{{address}}"]],
+  "mailTestCard.rateLimited": [[], [30], [300]],
   "adminArea.forbiddenBody": [["{{app}}"]],
   "adminArea.tiles.usersNew": one,
   // 0.42.0 (docs/top-bar-harmonization.md §3.1): the sync indicator's counts, its time, the
@@ -431,4 +439,8 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "tourCatalogue.steps": one,
   "tourCatalogue.duration": one,
   "tourCatalogue.completedOn": [["{{date}}"]],
+  // 0.45.0 (docs/local-first-harmonization.md §1.6): the sign-out question's count, in
+  // both word sets.
+  "signOutPending.lost": one,
+  "signOutPending.kept": one,
 };

package/src/index.ts

@@ -811,6 +811,9 @@ export type {
 } from "./admin/admin-overview";
 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, maskMailAddress } 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 {
   planColumn,

package/src/lib/format.ts

@@ -182,10 +182,14 @@ const DATE_STYLES: Record<FormatDateStyle, Intl.DateTimeFormatOptions> = {
 };
 
 export interface FormatDateOptions extends BaseOptions {
-  /** An IANA zone ("Europe/Zurich") for a timestamp. Left out: the device's. */
+  /** An IANA zone ("Europe/Zurich") for a timestamp. Left out: the device's. A bare
+   *  "YYYY-MM-DD" ignores it: a calendar day is the day it names in every zone. */
   timeZone?: string;
 }
 
+/** A bare ISO calendar day, `"YYYY-MM-DD"`. */
+const BARE_ISO_DAY = /^\d{4}-\d{2}-\d{2}$/;
+
 /** What {@link formatDate} and {@link formatRelativeTime} accept. */
 export type DateInput = string | number | Date | null | undefined;
 
@@ -197,7 +201,7 @@ export type DateInput = string | number | Date | null | undefined;
  */
 export function toDate(value: DateInput): Date | null {
   if (value === null || value === undefined || value === "") return null;
-  if (typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value)) return parseIsoDate(value);
+  if (typeof value === "string" && BARE_ISO_DAY.test(value)) return parseIsoDate(value);
   const d = value instanceof Date ? value : new Date(value);
   return Number.isNaN(d.getTime()) ? null : d;
 }
@@ -229,6 +233,13 @@ export function formatDate(
   const d = toDate(value);
   if (!d) return options.empty ?? EMPTY_FORMATTED_VALUE;
   const base = typeof style === "string" ? DATE_STYLES[style] : style;
+  // A bare "YYYY-MM-DD" is a calendar day, which has no zone: it is the day it names
+  // wherever it is read, so a `timeZone` (in `options` or the style) never moves it — the
+  // device's local midnight shown in a zone west of it was the day before (round 0.45, N9).
+  if (typeof value === "string" && BARE_ISO_DAY.test(value)) {
+    const day = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
+    return dateFormatter(options.locale, { ...base, timeZone: "UTC" }).format(day);
+  }
   return dateFormatter(options.locale, options.timeZone ? { ...base, timeZone: options.timeZone } : base).format(d);
 }
 

package/src/offline/pwa-update-prompt-labels.ts

@@ -0,0 +1,9 @@
+// The English words of ./pwa-update-prompt, in a module with no component code (0.34, KS U8).
+// keksdose's reviewed words (pwa.updateAvailable, pwa.reload) are the canon.
+
+import type { PwaUpdatePromptLabels } from "./pwa-update-prompt";
+
+export const DEFAULT_PWA_UPDATE_PROMPT_LABELS: PwaUpdatePromptLabels = {
+  updateAvailable: "A new version is available.",
+  reload: "Reload",
+};

package/src/offline/pwa-update-prompt.tsx

@@ -0,0 +1,72 @@
+import { useEffect, useRef } from "react";
+import { useKitLabels, type LabelOverride } from "../i18n/kit-labels";
+import { toast } from "../components/toast";
+import { DEFAULT_PWA_UPDATE_PROMPT_LABELS } from "./pwa-update-prompt-labels";
+
+/**
+ * "A new version is available. — Reload": keksdose's service-worker toast
+ * (app/pwa-update-prompt.tsx) as a kit component (docs/local-first-harmonization.md §1.5
+ * D8). The app keeps `useRegisterSW` (vite-plugin-pwa, `registerType: "prompt"`) and hands
+ * its state in: `needRefresh` from it, `onReload` = `updateServiceWorker(true)`,
+ * `onDismiss` = `setNeedRefresh(false)`.
+ *
+ * `hold` defers the prompt while a reload would hurt — a handover being signed, a tour
+ * running. Nothing shows while it holds; the toast appears once it drops. A hold that
+ * starts while the toast is up takes it down again until it drops.
+ *
+ * Renders nothing itself: the toast needs a mounted `<Toaster>`.
+ */
+export interface PwaUpdatePromptLabels {
+  updateAvailable: string;
+  reload: string;
+}
+
+// Defined in ./pwa-update-prompt-labels, which holds no component code (0.34, KS U8).
+export { DEFAULT_PWA_UPDATE_PROMPT_LABELS };
+
+export interface PwaUpdatePromptProps {
+  /** A new service worker is waiting. */
+  needRefresh: boolean;
+  /** Activates it and reloads — `updateServiceWorker(true)`. */
+  onReload: () => void;
+  /** The toast was closed without reloading. */
+  onDismiss?: () => void;
+  /** Wait: a handover is open, a tour runs. */
+  hold?: boolean;
+  labels?: LabelOverride<PwaUpdatePromptLabels>;
+}
+
+/** The toast's id: one prompt at a time, replaced in place. */
+const PWA_UPDATE_TOAST_ID = "pwa-update";
+
+export function PwaUpdatePrompt({ needRefresh, onReload, onDismiss, hold = false, labels: labelsProp }: PwaUpdatePromptProps) {
+  const labels = useKitLabels("pwaUpdate", DEFAULT_PWA_UPDATE_PROMPT_LABELS, labelsProp);
+  // The callbacks are read at click time, so a new function each render does not
+  // re-raise the toast.
+  const handlers = useRef({ onReload, onDismiss });
+  useEffect(() => {
+    handlers.current = { onReload, onDismiss };
+  });
+
+  const show = needRefresh && !hold;
+  useEffect(() => {
+    if (!show) return;
+    // sonner calls `onDismiss` for a programmatic dismiss too: the one this effect makes
+    // when a hold starts must not tell the app the person waved the update away.
+    let ours = false;
+    toast(labels.updateAvailable, {
+      id: PWA_UPDATE_TOAST_ID,
+      duration: Infinity,
+      action: { label: labels.reload, onClick: () => handlers.current.onReload() },
+      onDismiss: () => {
+        if (!ours) handlers.current.onDismiss?.();
+      },
+    });
+    return () => {
+      ours = true;
+      toast.dismiss(PWA_UPDATE_TOAST_ID);
+    };
+  }, [show, labels.updateAvailable, labels.reload]);
+
+  return null;
+}