@eifi1/ui-kit 0.44.0 → 0.46.0

package/src/i18n/locales/zh.ts

@@ -134,6 +134,9 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       answeredDescription: "当您提交或评论过的反馈收到回复时。",
       comment: "您关注的反馈中的评论",
       commentDescription: "当有人评论您提交或评论过的反馈时。",
+      received: "新反馈和返工",
+      receivedDescription: "当有人提交反馈或退回反馈时。",
+      adminGroup: "管理员",
     },
     feedbackContext: {
       user: "用户",
@@ -590,6 +593,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       skip: "跳过",
       done: "完成",
       awaitClickHint: "点击高亮的元素以继续",
+      awaitInputHint: "在高亮的字段中输入一个值以继续", // 0.46: TourStep.awaitInput (keksdose live #436).
       step: (current, total) => `${n(current)} / ${n(total)}`,
     },
     // 0.43.0 — docs/tours-harmonization.md §3, §8: the tours page.
@@ -797,6 +801,7 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
     },
     writeLock: {
       reason: "仅可查看，无法修改。",
+      offline: "需要网络连接。",
     },
     accountState: {
       active: "已启用",
@@ -1125,6 +1130,9 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       typesTitle: "通知我以下内容",
       typesDescription: "选择要接收哪些通知，以及接收方式。",
       byEmail: "通过电子邮件",
+      channelApp: "应用内",
+      channelPush: "推送",
+      channelEmail: "电子邮件",
       emailUnverified: "请先确认您的邮箱地址，才能收到这些邮件。",
       digestCadence: "频率",
       digestWeekly: "每周",
@@ -1132,8 +1140,15 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       typesLoading: "正在加载通知设置…",
       typesEmpty: "此账户没有可用的通知。",
       quietTitle: "免打扰时段",
-      quietDescription: (inbox) =>
-        inbox ? "此时段内不发送推送通知。通知仍会进入您的收件箱。" : "此时段内不发送推送通知。",
+      quietDescription: (inbox, held) =>
+        held
+          ? inbox
+            ? "此时段内推送通知会等待，并在时段结束时送达。通知会立即进入您的收件箱。"
+            : "此时段内推送通知会等待，并在时段结束时送达。"
+          : inbox
+            ? "此时段内不发送推送通知。通知仍会进入您的收件箱。"
+            : "此时段内不发送推送通知。",
+      quietZone: (zone) => `按您的时区（${zone}），随您最近使用的设备而定。`,
       quietFrom: "从",
       quietUntil: "到",
       quietIncomplete: "请同时设置开始和结束时间。两者都设置后，免打扰时段才会生效。",
@@ -1188,6 +1203,19 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       // Starts with `remove`, the button's visible text, for voice control.
       removeItem: (device) => `移除：${device}`,
       removePrompt: "停止向此设备发送通知？",
+      deviceTypes: "此设备上的类型",
+      deviceTypesDescription: "关闭某个类型，即可仅在此设备上将其静音。",
+      deviceTypesEmpty: "没有开启推送通知的类型。",
+      inboxTitle: "收件箱",
+      inboxLoading: "正在加载通知…",
+      inboxEmpty: "没有新通知。",
+      markAllRead: "全部标为已读",
+      clearAll: "全部清除",
+      clearPrompt: "删除收件箱中的所有通知？",
+      showMore: "显示更多",
+      bellLabel: "通知",
+      bellUnread: (count) => `${n(count)} 条未读`,
+      allNotifications: "所有通知",
       unsubscribeTitle: "电子邮件通知",
       unsubscribeAbout: (type) => `您会收到有关以下内容的邮件：${type}。`,
       unsubscribeGeneric: "您会收到通知邮件。",
@@ -1321,11 +1349,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 +1366,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 +1377,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 +1388,8 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
           group_create: "预算已创建",
           group_rename: "预算已重命名",
           group_delete: "预算已删除",
+          group_deactivate: "预算已停用",
+          group_reactivate: "预算已重新激活",
           membership_add: "已添加到预算",
           membership_role: "预算中的角色已更改",
           membership_remove: "已从预算移除",
@@ -1487,6 +1524,8 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       approve: "通过",
       flag: "需要修改",
       suggest: "建议译文",
+      flagRow: "标记为需修改…",
+      suggestRow: "添加译文…",
       reset: "标记为未审校",
       cancel: "取消",
       approveSelected: "通过所选项",
@@ -1731,6 +1770,14 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
       contrastHelp: "增强对比度会加深浅色文字和线条，并加粗焦点框。“跟随系统”沿用此设备的设置。",
       contrastModes: { system: "跟随系统", standard: "标准", more: "增强" },
       saveFailed: "无法保存到您的账户。此设备上仍然生效。",
+      // 0.46: DateFormatSetting (keksdose's words where it has them).
+      dateFormat: "日期格式",
+      dateFormatHelp:
+        "整个应用中日期的书写方式。与界面语言无关，因此您可以用英文阅读应用，同时仍看到德式日期。",
+      dateFormatAuto: "跟随语言",
+      // 0.46: AccountMenuTextSize (keksdose live #426).
+      textSmaller: "缩小文字",
+      textLarger: "放大文字",
     },
     // 0.36.0 — docs/settings-harmonization.md §11.3: resetting this device's settings, the
     // last card of "外观".
@@ -1754,9 +1801,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: "前往首页",
@@ -1774,6 +1833,10 @@ export function uiKitLabelsZh(numberLocale = "zh-CN"): UiKitLabels {
         invitationsPending: "待接受的邀请",
         users: "用户",
         usersNew: (count) => `近 7 天新增 ${n(count)} 人`,
+        awaitingVerdict: "待确认",
+        awaitingVerdictHint: "已答复，等待您或报告人确认已解决",
+        releasedForWork: "待处理",
+        releasedForWorkHint: "已就绪、已要求返工或进行中",
       },
       overviewError: "无法加载概览。",
       retry: "重试",
@@ -1822,6 +1885,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

@@ -330,7 +330,9 @@ export const KIT_LABEL_SAMPLES: Readonly<Record<string, readonly (readonly unkno
   "sessions.lastActive": [["{{when}}"]],
   "sessions.ip": [["{{address}}"]],
   "sessions.revokeItem": [["{{device}}"]],
-  "notifications.quietDescription": [[false], [true]],
+  "notifications.quietDescription": [[false], [true], [false, true], [true, true]],
+  "notifications.quietZone": [["{{zone}}"]],
+  "notifications.bellUnread": one,
   "notifications.deviceZone": [["{{zone}}"]],
   "notifications.iosInstall": [["{{app}}"]],
   "notifications.testSent": one,
@@ -353,6 +355,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 +410,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 +441,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

@@ -408,6 +408,8 @@ export * from "./components/form-actions";
 // (docs/billing-harmonization.md §12.36): the kinds, the holds, `CommitScope`,
 // `COMMIT_EXCEPT_BILLING` and the pure `writeLockFor`.
 export { WriteLockProvider, useWriteLock, writeLockFor, 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 { OFFLINE_LOCK, COMMIT_EXCEPT_OFFLINE, useOfflineWriteLock } from "./components/write-lock";
 export type { WriteLock, WriteLockLabels, WriteLockProviderProps, WriteLockKind, WriteLockHold, CommitScope } from "./components/write-lock";
 // 0.18: the parts both apps' admin rosters repeat (Kurvenschmiede 6).
 export { RoleChip, AccountStateChip, DateMark, dateColumn, DEFAULT_ACCOUNT_STATE_LABELS, ACCOUNT_STATE_TONES } from "./components/account-chips";
@@ -552,6 +554,19 @@ export type {
 // actions, one of the behaviours at Large (§4, §10.7–10.9).
 export { DEFAULT_APPEARANCE_LABELS, useAppearanceLabels } from "./components/appearance-labels";
 export type { AppearanceLabels } from "./components/appearance-labels";
+// 0.46 (keksdose's date format, lifted): the preference, its resolver and renderer, the
+// provider's formatter for it, and the settings field.
+export {
+  DATE_FORMAT_PREFERENCES,
+  isDateFormatPreference,
+  resolveDateFormat,
+  formatDateWithPreference,
+  dateFormatSample,
+  dateFormatterFor,
+} from "./lib/date-format";
+export type { DateFormatPreference, DateFormatOptions, ResolvedDateFormat } from "./lib/date-format";
+export { DateFormatSetting } from "./components/date-format-setting";
+export type { DateFormatSettingProps } from "./components/date-format-setting";
 export { RowActions, rowActionsColumn, DEFAULT_ROW_ACTIONS_LABELS } from "./components/row-actions";
 export type {
   RowAction,
@@ -808,9 +823,16 @@ export type {
   AdminExtraTile,
   AdminOverviewProps,
   AttentionTileProps,
+  // 0.46 (Kurvenschmiede 1): the feedback tiles with the kit's words.
+  AdminFeedbackTile,
+  AdminFeedbackTileKey,
+  AdminOwnTile,
 } 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,
@@ -943,6 +965,7 @@ export type {
   NotificationTypeGroup,
   NotificationSettingsPatch,
   PushDeviceItem,
+  NotificationChannel,
 } from "./notifications/notification-types";
 export { NotificationTypesSetting } from "./notifications/notification-types-setting";
 export type { NotificationTypesSettingProps } from "./notifications/notification-types-setting";
@@ -950,6 +973,14 @@ export { QuietHoursSetting } from "./notifications/quiet-hours-setting";
 export type { QuietHoursSettingProps } from "./notifications/quiet-hours-setting";
 export { TimeZoneSelect, timeZoneOptions, deviceTimeZone } from "./notifications/time-zone-select";
 export type { TimeZoneSelectProps } from "./notifications/time-zone-select";
+// 0.46 (docs/notifications-harmonization.md §10.1, §10.3): the inbox list, the bell and
+// the device-zone report (the account's zone is automatic only, amended 2026-10-20).
+export { NotificationInbox, INBOX_BADGE_INTERVAL } from "./notifications/notification-inbox";
+export type { NotificationInboxItem, NotificationInboxProps } from "./notifications/notification-inbox";
+export { NotificationBell } from "./notifications/notification-bell";
+export type { NotificationBellProps } from "./notifications/notification-bell";
+export { useDeviceZoneReport } from "./notifications/device-zone-report";
+export type { DeviceZoneReportOptions } from "./notifications/device-zone-report";
 export {
   usePushDevice,
   PUSH_SUBSCRIPTION_CHANGED,
@@ -964,6 +995,20 @@ export type {
   PushPermission,
   PushDeviceErrorCode,
 } from "./notifications/use-push-device";
+// 0.46 (NT:1028): the service worker re-registers a rotated subscription. A worker imports
+// them from `@eifi1/ui-kit/push-worker` (§10.6 rule 5); the barrel keeps them too.
+export {
+  handlePushSubscriptionChange,
+  resubscribeAfterChange,
+  pushSubscriptionInput,
+} from "./notifications/push-worker";
+export type {
+  PushReplaceInput,
+  PushSubscriptionChangeOptions,
+  PushSubscriptionChangeEventLike,
+  PushResubscribeOutcome,
+  PushWorkerScope,
+} from "./notifications/push-worker";
 export { PushDeviceSetting } from "./notifications/push-device-setting";
 export type { PushDeviceSettingProps, PushDeviceAction } from "./notifications/push-device-setting";
 export { PushDevicesSetting, describeUserAgent } from "./notifications/push-devices-setting";

package/src/lib/date-format.ts

@@ -0,0 +1,151 @@
+import { formatLocaleOf } from "../i18n/languages";
+import type { KitDateFormatter } from "../i18n/kit-labels";
+
+/**
+ * The date-format preference (0.46, lifted from keksdose's `date-format-store.ts`,
+ * feedback #180): how a DAY is written — the order of day, month and year and the
+ * separator between them — as a choice of its own, apart from the interface language.
+ * "Read the app in English and still see German dates", or ISO everywhere.
+ *
+ * keksdose's rules, which the kit keeps:
+ *
+ * 1. **A label that identifies a day follows the preference** — anything that prints
+ *    day, month and year goes through {@link formatDateWithPreference} (or the
+ *    provider's `formatDate`, {@link dateFormatterFor}, for the kit's own date fields).
+ * 2. **A label without a day follows the language**: "August 2026", a month or weekday
+ *    NAME has no order to arrange. {@link dateFormatterFor} answers `""` for a month or a
+ *    year, so the kit keeps its own rendering in the language.
+ * 3. **A clock time follows the language**: `sv-SE` is a statement about digit order in
+ *    a date, not about a 12- or 24-hour clock.
+ * 4. **A weekday's NAME follows the language** (dev#546): `sv-SE` means "year first,
+ *    with dashes", not "the reader speaks Swedish" — so with `weekday` the day's name is
+ *    the language's, joined to the date the preference renders.
+ *
+ * The preference is the APP's to keep — keksdose holds it per device (a persisted store,
+ * not an account column: nothing server-written formats a date for the reader). The kit
+ * owns the vocabulary, the resolver, the renderer and the settings field
+ * ({@link DateFormatSetting}).
+ */
+
+/** `"auto"` follows the interface language (the default — nobody's dates move until
+ *  they ask); the rest are BCP 47 tags chosen for the SHAPE they produce: German
+ *  01.08.2026, British 01/08/2026, US 08/01/2026, ISO 2026-08-01. */
+export type DateFormatPreference = "auto" | "de-DE" | "en-GB" | "en-US" | "sv-SE";
+
+/** The options in the order the setting lists them: `auto` first (the default), then
+ *  German → UK → US → ISO. */
+export const DATE_FORMAT_PREFERENCES: readonly DateFormatPreference[] = ["auto", "de-DE", "en-GB", "en-US", "sv-SE"];
+
+/** Whether `value` is one of {@link DATE_FORMAT_PREFERENCES} — for a value read back from
+ *  storage, where anything else falls back to `"auto"`. */
+export function isDateFormatPreference(value: unknown): value is DateFormatPreference {
+  return typeof value === "string" && (DATE_FORMAT_PREFERENCES as readonly string[]).includes(value);
+}
+
+/** A resolved preference: the locale and `Intl` options the date itself is rendered
+ *  with, and — only when asked for — the locale the weekday's NAME comes from. */
+export interface ResolvedDateFormat {
+  locale: string | undefined;
+  options: Intl.DateTimeFormatOptions;
+  /** The language's format locale, present when `weekday` was asked for. */
+  weekday?: { locale: string | undefined };
+}
+
+/** What {@link resolveDateFormat} and the renderers take beyond the preference. */
+export interface DateFormatOptions {
+  /** Name the day of the week too, in the interface language ("Mo., 01.08.2026"). A date
+   *  in a COLUMN carries it; a date in a SENTENCE does not (keksdose dev#546). */
+  weekday?: boolean;
+}
+
+/**
+ * What a date is rendered with, given the preference and the interface language
+ * (`language`: a code or tag — `"de"`, `"en"`, i18next's `resolvedLanguage`; it is read
+ * through `formatLocaleOf`, so English is British and an unshipped tag stays itself).
+ *
+ * `"auto"` keeps the short-month shape ("01 Aug 2026", "01. Aug. 2026"); every explicit
+ * choice is all-numeric, the only way it produces the shape its option promises —
+ * `month: "short"` under `sv-SE` would print "2026 aug. 01", not ISO.
+ */
+export function resolveDateFormat(
+  preference: DateFormatPreference,
+  language: string | undefined,
+  options: DateFormatOptions = {},
+): ResolvedDateFormat {
+  const languageLocale = language ? formatLocaleOf(language) : undefined;
+  const weekday = options.weekday ? { weekday: { locale: languageLocale } } : {};
+  if (preference === "auto") {
+    return { locale: languageLocale, options: { year: "numeric", month: "short", day: "2-digit" }, ...weekday };
+  }
+  return { locale: preference, options: { year: "numeric", month: "2-digit", day: "2-digit" }, ...weekday };
+}
+
+/** A bare calendar day: no time, no zone. */
+const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+
+/**
+ * `dateText`, already rendered under the preference, with the day's NAME around it in
+ * `locale` (the language's). Not "weekday alone + comma": German says "So" alone and
+ * "So., 06.09.2026" in company. The full date is formatted in the language and split
+ * into parts; what that language puts before the first and after the last day/month/
+ * year part (the weekday, its comma) frames the preference's digits — so where the two
+ * locales coincide the output is the native string, character for character.
+ */
+function withWeekday(date: Date, dateText: string, locale: string | undefined, options: Intl.DateTimeFormatOptions) {
+  const isDatePart = (p: Intl.DateTimeFormatPart) => p.type === "day" || p.type === "month" || p.type === "year";
+  const parts = new Intl.DateTimeFormat(locale, { weekday: "short", ...options }).formatToParts(date);
+  const first = parts.findIndex(isDatePart);
+  if (first === -1) return dateText;
+  let last = first;
+  parts.forEach((p, i) => {
+    if (isDatePart(p)) last = i;
+  });
+  const join = (ps: Intl.DateTimeFormatPart[]) => ps.map((p) => p.value).join("");
+  return join(parts.slice(0, first)) + dateText + join(parts.slice(last + 1));
+}
+
+/**
+ * A date under the preference: `""` for no value, the input itself when it does not
+ * parse. A bare "YYYY-MM-DD" is the calendar day it names in every zone (formatted in
+ * UTC, undoing `new Date`'s UTC-midnight parse — west of Greenwich it read a day early);
+ * a timestamp is an instant and stays in the reader's zone. The weekday, when asked for,
+ * is rendered in the same zone, so a Sunday is never captioned Saturday.
+ */
+export function formatDateWithPreference(
+  value: string | Date | null | undefined,
+  preference: DateFormatPreference,
+  language: string | undefined,
+  options: DateFormatOptions = {},
+): string {
+  if (!value) return "";
+  const resolved = resolveDateFormat(preference, language, options);
+  const dateOnly = typeof value === "string" && DATE_ONLY.test(value);
+  const date = typeof value === "string" ? new Date(value) : value;
+  if (Number.isNaN(date.getTime())) return String(value);
+  const intl: Intl.DateTimeFormatOptions = dateOnly ? { ...resolved.options, timeZone: "UTC" } : resolved.options;
+  try {
+    const text = date.toLocaleDateString(resolved.locale, intl);
+    return resolved.weekday ? withWeekday(date, text, resolved.weekday.locale, intl) : text;
+  } catch {
+    // A language tag `Intl` refuses: the ISO day rather than nothing (keksdose's fallback).
+    return date.toISOString().slice(0, 10);
+  }
+}
+
+/** The sample an option is labelled with — 1 August 2026 in its shape, the shape being
+ *  the whole choice (a country name would say nothing about the digit order). */
+export function dateFormatSample(preference: DateFormatPreference, language: string | undefined): string {
+  return formatDateWithPreference("2026-08-01", preference, language);
+}
+
+/**
+ * The `<UiKitProvider formatDate>` for a preference — so the kit's own date fields
+ * (DatePicker, DateRangePicker, DateMark) write a day as the app's dates do. A day
+ * follows the preference, with the weekday where the kit suggests it; a month or a year
+ * answers `""` and keeps the kit's rendering in the language (rule 2). Rebuild it when
+ * the preference or the language changes (a `useMemo` on both).
+ */
+export function dateFormatterFor(preference: DateFormatPreference, language: string | undefined): KitDateFormatter {
+  return (iso, { unit, weekday, locale }) =>
+    unit === "day" ? formatDateWithPreference(iso, preference, locale ?? language, { weekday }) : "";
+}

package/src/lib/format.ts

@@ -1,5 +1,5 @@
 import { useMemo } from "react";
-import { useKitLocale } from "../i18n/kit-labels";
+import { useKitLocale, useKitTimeZone } from "../i18n/kit-labels";
 import { parseIsoDate } from "./dates";
 import { roundHalfAway } from "./round";
 
@@ -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,10 +233,20 @@ 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);
 }
 
 export interface FormatRelativeTimeOptions extends BaseOptions {
+  /** The zone of the date printed past `absoluteAfterDays` (0.46). Left out: the
+   *  device's. */
+  timeZone?: string;
   /** The moment it is measured from. Default: now. */
   now?: DateInput;
   /** `"auto"` (default): "yesterday", "now", "next week". `"always"`: "1 day ago". */
@@ -337,16 +351,19 @@ export interface KitFormat {
  */
 export function useKitFormat(locale?: string): KitFormat {
   const kitLocale = useKitLocale(locale);
+  // 0.46 (§10.3): the provider's `timeZone` for timestamps; a call's own wins, and a bare
+  // "YYYY-MM-DD" ignores it (formatDate).
+  const timeZone = useKitTimeZone();
   return useMemo<KitFormat>(
     () => ({
       locale: kitLocale,
       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 }),
-      formatDate: (value, style, options) => formatDate(value, style, { locale: kitLocale, ...options }),
-      formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, ...options }),
+      formatDate: (value, style, options) => formatDate(value, style, { locale: kitLocale, timeZone, ...options }),
+      formatRelativeTime: (value, options) => formatRelativeTime(value, { locale: kitLocale, timeZone, ...options }),
     }),
-    [kitLocale],
+    [kitLocale, timeZone],
   );
 }
 

package/src/notifications/device-zone-report.ts

@@ -0,0 +1,54 @@
+import { useEffect } from "react";
+
+import { settle } from "../account/account-parts";
+import { deviceTimeZone } from "./time-zone-select";
+
+export interface DeviceZoneReportOptions {
+  /** The account's `device_timezone` from `/auth/me`; `undefined` while it loads (no
+   *  report until it is known). */
+  stored: string | null | undefined;
+  /** `PATCH /auth/me {device_timezone}` with this device's zone. */
+  report: (deviceTimezone: string) => Promise<unknown> | void;
+  /** A demo account: never reported (the server ignores it too, §10.3 Settled). */
+  isDemo?: boolean;
+  /** The signed-in account (its user id): the once-per-start guard is per account, so a
+   *  second person signed in on a shared PC in the same start is reported too. Without it
+   *  the guard is cleared when `stored` goes `undefined` (signed out). */
+  account?: string | number | null;
+}
+
+/** The (account, stored, device) triples already reported in this start of the app. */
+const reportedThisStart = new Set<string>();
+
+/**
+ * Report this device's zone to the account (0.46, §10.3): the account's zone follows the
+ * device last used, else `Europe/Zurich`; screens keep showing device time. Once per start
+ * of the app, and only when it differs from the stored `device_timezone` — a bench PC in Zurich never
+ * PATCHes on a sign-in — and never for a demo. Per account: a sign-out (`stored` back to
+ * `undefined`) clears the guard, and `account` keys it. The report IS the account's zone: it is
+ * automatic only (§10.3, amended 2026-10-20), so nothing is ever picked. A failed report
+ * is not retried in the same start; the next start tries again. Sign-up sends the zone
+ * itself (`RegisterRequest.device_timezone`).
+ *
+ *     useDeviceZoneReport({ stored: me?.device_timezone, isDemo: me?.is_demo, account: me?.id,
+ *       report: async (zone) => setUser((await api.patch("/auth/me", { device_timezone: zone })).data) });
+ */
+export function useDeviceZoneReport({ stored, report, isDemo = false, account = null }: DeviceZoneReportOptions): void {
+  useEffect(() => {
+    if (stored === undefined) {
+      // Signed out (or still loading): the next account in this start is reported afresh.
+      reportedThisStart.clear();
+      return;
+    }
+    if (isDemo) return;
+    const device = deviceTimeZone();
+    if (device === stored) return;
+    const key = `${account ?? ""}|${stored ?? ""}→${device}`;
+    if (reportedThisStart.has(key)) return;
+    reportedThisStart.add(key);
+    void settle(() => report(device)).catch(() => undefined);
+    // `report` is the app's request function: a new closure each render must not report
+    // again, so only the values decide.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [stored, isDemo, account]);
+}

package/src/notifications/feedback-notification-types-labels.ts

@@ -2,7 +2,7 @@
 // component code, as every `*-labels.ts`: the English catalogue imports them alone.
 
 /**
- * `feedbackNotificationTypes` — the setting words of the two feedback notification types
+ * `feedbackNotificationTypes` — the setting words of the feedback notification types
  * (docs/feedback-harmonization.md §9.11). In the kit, not in each app, because two apps
  * declare them (keksdose, Kurvenschmiede; kastlan `feedback_answered` alone). The mail and
  * push texts stay the app's.
@@ -14,6 +14,12 @@ export interface FeedbackNotificationTypesLabels {
   /** `feedback_comment`: a visible comment on such a report. */
   comment: string;
   commentDescription: string;
+  /** 0.46 (feedback §11): `feedback_received`, an admin's alert for a new report, a
+   *  rework and a new crash. */
+  received: string;
+  receivedDescription: string;
+  /** A heading the apps may put over the admin's types ("Admin"). */
+  adminGroup: string;
 }
 
 export const DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS: FeedbackNotificationTypesLabels = {
@@ -21,4 +27,7 @@ export const DEFAULT_FEEDBACK_NOTIFICATION_TYPES_LABELS: FeedbackNotificationTyp
   answeredDescription: "When a report you wrote or commented on gets an answer.",
   comment: "Comments on reports you follow",
   commentDescription: "When someone comments on a report you wrote or commented on.",
+  received: "New feedback and reworks",
+  receivedDescription: "When someone files a report or sends one back.",
+  adminGroup: "Admin",
 };