@eifi1/ui-kit 0.45.0 → 0.46.1

package/dist/notifications/push-worker.d.ts

@@ -0,0 +1,108 @@
+/**
+ * The service worker's half of Web Push that the kit can own (0.46,
+ * docs/notifications-harmonization.md NT:1028): re-registering a subscription the
+ * browser ROTATED. A push service may replace a subscription (expiry, a key rotation, a
+ * browser update) and fires `pushsubscriptionchange` in the worker; until 0.46 the
+ * server kept sending to the old endpoint, got 410, deleted the device, and the person
+ * had to turn push on again without knowing why.
+ *
+ * {@link handlePushSubscriptionChange} listens for the event in the app's worker and
+ * calls the app's `replace` — `POST /notifications/devices/replace` (server-kit
+ * `PushReplaceIn`): the OLD endpoint and the old subscription's `auth` secret, which only
+ * this browser and the server hold, prove the device without a session (a worker has no
+ * `Authorization` header to send), and the server moves that row to the new endpoint in
+ * place — same account, same device. Open pages are told with a
+ * {@link PUSH_SUBSCRIPTION_CHANGED} message, and every mounted `usePushDevice` re-reads.
+ *
+ * Dependency-free (no React), so an app's worker bundle takes only this file — through
+ * the worker-safe subpath `@eifi1/ui-kit/push-worker` (0.46, §10.6 rule 5), not the main
+ * barrel, which reaches React and the components:
+ *
+ *     // sw.ts
+ *     import { handlePushSubscriptionChange } from "@eifi1/ui-kit/push-worker";
+ *     handlePushSubscriptionChange(self, {
+ *       pushKey: () => fetch("/api/notifications/push-key").then((r) => r.json()).then((b) => b.key),
+ *       replace: (body) => fetch("/api/notifications/devices/replace", {
+ *         method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body),
+ *       }).then((r) => { if (!r.ok) throw new Error(String(r.status)); }),
+ *     });
+ */
+/** What `register` sends: `POST /notifications/devices` (§3.5). */
+export interface PushSubscriptionInput {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+    user_agent: string | null;
+}
+/** What `replace` sends: `POST /notifications/devices/replace` (server-kit
+ *  `PushReplaceIn`). The endpoint never goes in a URL. */
+export interface PushReplaceInput {
+    /** The rotated-away subscription's endpoint. */
+    old_endpoint: string;
+    /** Its `keys.auth` as registered — the proof that this browser held it. */
+    old_auth: string;
+    /** The browser's new subscription. */
+    subscription: PushSubscriptionInput;
+}
+/** The message a worker posts to its pages after a rotation, and the window event the
+ *  hooks re-read on — the same name. */
+export declare const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
+/** A VAPID public key (base64url) as the bytes `PushManager.subscribe` wants. */
+export declare function keyBytes(key: string): Uint8Array<ArrayBuffer>;
+/** A subscription's register body, or `null` when the browser handed back an incomplete
+ *  one. */
+export declare function pushSubscriptionInput(subscription: PushSubscription): PushSubscriptionInput | null;
+/** The `pushsubscriptionchange` event as the worker receives it (not in TypeScript's
+ *  DOM lib). Either subscription may be missing: Chrome often hands neither. */
+export interface PushSubscriptionChangeEventLike {
+    readonly oldSubscription?: PushSubscription | null;
+    readonly newSubscription?: PushSubscription | null;
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+export interface PushSubscriptionChangeOptions {
+    /** `GET /notifications/push-key` → its `key` — asked only when the browser handed no
+     *  new subscription and the old one does not carry its key. `""`: push is off. */
+    pushKey: () => Promise<string>;
+    /** `POST /notifications/devices/replace`. A rejection is the outcome `"failed"`. */
+    replace: (input: PushReplaceInput) => Promise<unknown>;
+}
+/**
+ * What a rotation came to: `"replaced"` — the server moved the device; `"no_previous"` —
+ * the browser named no old subscription (or one without its keys), so there is nothing
+ * to prove the device with and the page shows push as off; `"push_off"` — the server has
+ * no key; `"incomplete"` — the new subscription has no keys; `"failed"` — `replace` (or
+ * the browser's subscribe) threw.
+ */
+export type PushResubscribeOutcome = "replaced" | "no_previous" | "push_off" | "incomplete" | "failed";
+/**
+ * Re-register after `pushsubscriptionchange`: the browser's new subscription — or, when
+ * it handed none, the one it holds now, or a fresh one under the old subscription's key
+ * (else `pushKey()`) — sent to `replace` with the old endpoint and its `auth`.
+ */
+export declare function resubscribeAfterChange(event: PushSubscriptionChangeEventLike, pushManager: PushManager, options: PushSubscriptionChangeOptions): Promise<PushResubscribeOutcome>;
+/** The parts of a `ServiceWorkerGlobalScope` this needs. */
+export interface PushWorkerScope {
+    addEventListener: (type: "pushsubscriptionchange", listener: (event: PushSubscriptionChangeEventLike) => void) => void;
+    registration: {
+        pushManager: PushManager;
+    };
+    clients?: {
+        matchAll: (options?: {
+            type?: "window";
+            includeUncontrolled?: boolean;
+        }) => Promise<readonly {
+            postMessage: (message: unknown) => void;
+        }[]>;
+    };
+}
+/**
+ * Listen for `pushsubscriptionchange` in the app's service worker (`self`) and
+ * re-register through {@link resubscribeAfterChange}, holding the worker alive until it
+ * is done (`waitUntil`). Then every open page gets `{ type: PUSH_SUBSCRIPTION_CHANGED,
+ * outcome }`; `usePushDevice` re-reads on it. `onOutcome` is for the app's own logging.
+ */
+export declare function handlePushSubscriptionChange(scope: PushWorkerScope, options: PushSubscriptionChangeOptions & {
+    onOutcome?: (outcome: PushResubscribeOutcome) => void;
+}): void;

package/dist/notifications/push-worker.js

@@ -0,0 +1,62 @@
+"use client";
+const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
+function keyBytes(key) {
+  const base64 = key.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - key.length % 4) % 4);
+  const raw = atob(base64);
+  const bytes = new Uint8Array(new ArrayBuffer(raw.length));
+  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
+  return bytes;
+}
+function pushSubscriptionInput(subscription) {
+  const json = subscription.toJSON();
+  const p256dh = json.keys?.p256dh;
+  const auth = json.keys?.auth;
+  if (!json.endpoint || !p256dh || !auth) return null;
+  return {
+    endpoint: json.endpoint,
+    keys: { p256dh, auth },
+    user_agent: typeof navigator !== "undefined" && navigator.userAgent || null
+  };
+}
+async function resubscribeAfterChange(event, pushManager, options) {
+  const old = event.oldSubscription;
+  const oldAuth = old?.toJSON().keys?.auth;
+  if (!old?.endpoint || !oldAuth) return "no_previous";
+  try {
+    let next = event.newSubscription ?? await pushManager.getSubscription();
+    if (!next || next.endpoint === old.endpoint) {
+      const kept = old.options?.applicationServerKey;
+      const key = kept ? null : await options.pushKey();
+      if (key === "") return "push_off";
+      next = await pushManager.subscribe({
+        userVisibleOnly: true,
+        applicationServerKey: kept ?? keyBytes(key ?? "")
+      });
+    }
+    const subscription = pushSubscriptionInput(next);
+    if (!subscription) return "incomplete";
+    await options.replace({ old_endpoint: old.endpoint, old_auth: oldAuth, subscription });
+    return "replaced";
+  } catch {
+    return "failed";
+  }
+}
+function handlePushSubscriptionChange(scope, options) {
+  scope.addEventListener("pushsubscriptionchange", (event) => {
+    const done = resubscribeAfterChange(event, scope.registration.pushManager, options).then(async (outcome) => {
+      options.onOutcome?.(outcome);
+      const pages = await scope.clients?.matchAll({ type: "window", includeUncontrolled: true }) ?? [];
+      for (const page of pages) page.postMessage({ type: PUSH_SUBSCRIPTION_CHANGED, outcome });
+      return outcome;
+    });
+    event.waitUntil?.(done);
+  });
+}
+export {
+  PUSH_SUBSCRIPTION_CHANGED,
+  handlePushSubscriptionChange,
+  keyBytes,
+  pushSubscriptionInput,
+  resubscribeAfterChange
+};
+//# sourceMappingURL=push-worker.js.map

package/dist/notifications/push-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/push-worker.ts"],"sourcesContent":["/**\n * The service worker's half of Web Push that the kit can own (0.46,\n * docs/notifications-harmonization.md NT:1028): re-registering a subscription the\n * browser ROTATED. A push service may replace a subscription (expiry, a key rotation, a\n * browser update) and fires `pushsubscriptionchange` in the worker; until 0.46 the\n * server kept sending to the old endpoint, got 410, deleted the device, and the person\n * had to turn push on again without knowing why.\n *\n * {@link handlePushSubscriptionChange} listens for the event in the app's worker and\n * calls the app's `replace` — `POST /notifications/devices/replace` (server-kit\n * `PushReplaceIn`): the OLD endpoint and the old subscription's `auth` secret, which only\n * this browser and the server hold, prove the device without a session (a worker has no\n * `Authorization` header to send), and the server moves that row to the new endpoint in\n * place — same account, same device. Open pages are told with a\n * {@link PUSH_SUBSCRIPTION_CHANGED} message, and every mounted `usePushDevice` re-reads.\n *\n * Dependency-free (no React), so an app's worker bundle takes only this file — through\n * the worker-safe subpath `@eifi1/ui-kit/push-worker` (0.46, §10.6 rule 5), not the main\n * barrel, which reaches React and the components:\n *\n *     // sw.ts\n *     import { handlePushSubscriptionChange } from \"@eifi1/ui-kit/push-worker\";\n *     handlePushSubscriptionChange(self, {\n *       pushKey: () => fetch(\"/api/notifications/push-key\").then((r) => r.json()).then((b) => b.key),\n *       replace: (body) => fetch(\"/api/notifications/devices/replace\", {\n *         method: \"POST\", headers: { \"Content-Type\": \"application/json\" }, body: JSON.stringify(body),\n *       }).then((r) => { if (!r.ok) throw new Error(String(r.status)); }),\n *     });\n */\n\n/** What `register` sends: `POST /notifications/devices` (§3.5). */\nexport interface PushSubscriptionInput {\n  endpoint: string;\n  keys: { p256dh: string; auth: string };\n  user_agent: string | null;\n}\n\n/** What `replace` sends: `POST /notifications/devices/replace` (server-kit\n *  `PushReplaceIn`). The endpoint never goes in a URL. */\nexport interface PushReplaceInput {\n  /** The rotated-away subscription's endpoint. */\n  old_endpoint: string;\n  /** Its `keys.auth` as registered — the proof that this browser held it. */\n  old_auth: string;\n  /** The browser's new subscription. */\n  subscription: PushSubscriptionInput;\n}\n\n/** The message a worker posts to its pages after a rotation, and the window event the\n *  hooks re-read on — the same name. */\nexport const PUSH_SUBSCRIPTION_CHANGED = \"eifi1:push-subscription-changed\";\n\n/** A VAPID public key (base64url) as the bytes `PushManager.subscribe` wants. */\nexport function keyBytes(key: string): Uint8Array<ArrayBuffer> {\n  const base64 = key.replace(/-/g, \"+\").replace(/_/g, \"/\") + \"=\".repeat((4 - (key.length % 4)) % 4);\n  const raw = atob(base64);\n  const bytes = new Uint8Array(new ArrayBuffer(raw.length));\n  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);\n  return bytes;\n}\n\n/** A subscription's register body, or `null` when the browser handed back an incomplete\n *  one. */\nexport function pushSubscriptionInput(subscription: PushSubscription): PushSubscriptionInput | null {\n  const json = subscription.toJSON();\n  const p256dh = json.keys?.p256dh;\n  const auth = json.keys?.auth;\n  if (!json.endpoint || !p256dh || !auth) return null;\n  return {\n    endpoint: json.endpoint,\n    keys: { p256dh, auth },\n    user_agent: (typeof navigator !== \"undefined\" && navigator.userAgent) || null,\n  };\n}\n\n/** The `pushsubscriptionchange` event as the worker receives it (not in TypeScript's\n *  DOM lib). Either subscription may be missing: Chrome often hands neither. */\nexport interface PushSubscriptionChangeEventLike {\n  readonly oldSubscription?: PushSubscription | null;\n  readonly newSubscription?: PushSubscription | null;\n  waitUntil?: (promise: Promise<unknown>) => void;\n}\n\nexport interface PushSubscriptionChangeOptions {\n  /** `GET /notifications/push-key` → its `key` — asked only when the browser handed no\n   *  new subscription and the old one does not carry its key. `\"\"`: push is off. */\n  pushKey: () => Promise<string>;\n  /** `POST /notifications/devices/replace`. A rejection is the outcome `\"failed\"`. */\n  replace: (input: PushReplaceInput) => Promise<unknown>;\n}\n\n/**\n * What a rotation came to: `\"replaced\"` — the server moved the device; `\"no_previous\"` —\n * the browser named no old subscription (or one without its keys), so there is nothing\n * to prove the device with and the page shows push as off; `\"push_off\"` — the server has\n * no key; `\"incomplete\"` — the new subscription has no keys; `\"failed\"` — `replace` (or\n * the browser's subscribe) threw.\n */\nexport type PushResubscribeOutcome = \"replaced\" | \"no_previous\" | \"push_off\" | \"incomplete\" | \"failed\";\n\n/**\n * Re-register after `pushsubscriptionchange`: the browser's new subscription — or, when\n * it handed none, the one it holds now, or a fresh one under the old subscription's key\n * (else `pushKey()`) — sent to `replace` with the old endpoint and its `auth`.\n */\nexport async function resubscribeAfterChange(\n  event: PushSubscriptionChangeEventLike,\n  pushManager: PushManager,\n  options: PushSubscriptionChangeOptions,\n): Promise<PushResubscribeOutcome> {\n  const old = event.oldSubscription;\n  const oldAuth = old?.toJSON().keys?.auth;\n  if (!old?.endpoint || !oldAuth) return \"no_previous\";\n  try {\n    let next = event.newSubscription ?? (await pushManager.getSubscription());\n    if (!next || next.endpoint === old.endpoint) {\n      const kept = old.options?.applicationServerKey;\n      const key = kept ? null : await options.pushKey();\n      if (key === \"\") return \"push_off\";\n      next = await pushManager.subscribe({\n        userVisibleOnly: true,\n        applicationServerKey: kept ?? keyBytes(key ?? \"\"),\n      });\n    }\n    const subscription = pushSubscriptionInput(next);\n    if (!subscription) return \"incomplete\";\n    await options.replace({ old_endpoint: old.endpoint, old_auth: oldAuth, subscription });\n    return \"replaced\";\n  } catch {\n    return \"failed\";\n  }\n}\n\n/** The parts of a `ServiceWorkerGlobalScope` this needs. */\nexport interface PushWorkerScope {\n  addEventListener: (type: \"pushsubscriptionchange\", listener: (event: PushSubscriptionChangeEventLike) => void) => void;\n  registration: { pushManager: PushManager };\n  clients?: { matchAll: (options?: { type?: \"window\"; includeUncontrolled?: boolean }) => Promise<readonly { postMessage: (message: unknown) => void }[]> };\n}\n\n/**\n * Listen for `pushsubscriptionchange` in the app's service worker (`self`) and\n * re-register through {@link resubscribeAfterChange}, holding the worker alive until it\n * is done (`waitUntil`). Then every open page gets `{ type: PUSH_SUBSCRIPTION_CHANGED,\n * outcome }`; `usePushDevice` re-reads on it. `onOutcome` is for the app's own logging.\n */\nexport function handlePushSubscriptionChange(\n  scope: PushWorkerScope,\n  options: PushSubscriptionChangeOptions & { onOutcome?: (outcome: PushResubscribeOutcome) => void },\n): void {\n  scope.addEventListener(\"pushsubscriptionchange\", (event) => {\n    const done = resubscribeAfterChange(event, scope.registration.pushManager, options).then(async (outcome) => {\n      options.onOutcome?.(outcome);\n      const pages = (await scope.clients?.matchAll({ type: \"window\", includeUncontrolled: true })) ?? [];\n      for (const page of pages) page.postMessage({ type: PUSH_SUBSCRIPTION_CHANGED, outcome });\n      return outcome;\n    });\n    event.waitUntil?.(done);\n  });\n}\n"],"mappings":";AAkDO,MAAM,4BAA4B;AAGlC,SAAS,SAAS,KAAsC;AAC7D,QAAM,SAAS,IAAI,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG,IAAI,IAAI,QAAQ,IAAK,IAAI,SAAS,KAAM,CAAC;AAChG,QAAM,MAAM,KAAK,MAAM;AACvB,QAAM,QAAQ,IAAI,WAAW,IAAI,YAAY,IAAI,MAAM,CAAC;AACxD,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,OAAM,CAAC,IAAI,IAAI,WAAW,CAAC;AAChE,SAAO;AACT;AAIO,SAAS,sBAAsB,cAA8D;AAClG,QAAM,OAAO,aAAa,OAAO;AACjC,QAAM,SAAS,KAAK,MAAM;AAC1B,QAAM,OAAO,KAAK,MAAM;AACxB,MAAI,CAAC,KAAK,YAAY,CAAC,UAAU,CAAC,KAAM,QAAO;AAC/C,SAAO;AAAA,IACL,UAAU,KAAK;AAAA,IACf,MAAM,EAAE,QAAQ,KAAK;AAAA,IACrB,YAAa,OAAO,cAAc,eAAe,UAAU,aAAc;AAAA,EAC3E;AACF;AAgCA,eAAsB,uBACpB,OACA,aACA,SACiC;AACjC,QAAM,MAAM,MAAM;AAClB,QAAM,UAAU,KAAK,OAAO,EAAE,MAAM;AACpC,MAAI,CAAC,KAAK,YAAY,CAAC,QAAS,QAAO;AACvC,MAAI;AACF,QAAI,OAAO,MAAM,mBAAoB,MAAM,YAAY,gBAAgB;AACvE,QAAI,CAAC,QAAQ,KAAK,aAAa,IAAI,UAAU;AAC3C,YAAM,OAAO,IAAI,SAAS;AAC1B,YAAM,MAAM,OAAO,OAAO,MAAM,QAAQ,QAAQ;AAChD,UAAI,QAAQ,GAAI,QAAO;AACvB,aAAO,MAAM,YAAY,UAAU;AAAA,QACjC,iBAAiB;AAAA,QACjB,sBAAsB,QAAQ,SAAS,OAAO,EAAE;AAAA,MAClD,CAAC;AAAA,IACH;AACA,UAAM,eAAe,sBAAsB,IAAI;AAC/C,QAAI,CAAC,aAAc,QAAO;AAC1B,UAAM,QAAQ,QAAQ,EAAE,cAAc,IAAI,UAAU,UAAU,SAAS,aAAa,CAAC;AACrF,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAeO,SAAS,6BACd,OACA,SACM;AACN,QAAM,iBAAiB,0BAA0B,CAAC,UAAU;AAC1D,UAAM,OAAO,uBAAuB,OAAO,MAAM,aAAa,aAAa,OAAO,EAAE,KAAK,OAAO,YAAY;AAC1G,cAAQ,YAAY,OAAO;AAC3B,YAAM,QAAS,MAAM,MAAM,SAAS,SAAS,EAAE,MAAM,UAAU,qBAAqB,KAAK,CAAC,KAAM,CAAC;AACjG,iBAAW,QAAQ,MAAO,MAAK,YAAY,EAAE,MAAM,2BAA2B,QAAQ,CAAC;AACvF,aAAO;AAAA,IACT,CAAC;AACD,UAAM,YAAY,IAAI;AAAA,EACxB,CAAC;AACH;","names":[]}

package/dist/notifications/quiet-hours-setting.d.ts

@@ -7,17 +7,29 @@ export interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<"div"
     start: string | null;
     /** The `GET`'s `quiet_hours_end`. */
     end: string | null;
-    /** The `GET`'s `timezone`, an IANA name, or `null` (the app's zone applies). */
-    timezone: string | null;
+    /** The zone the 0.36 card showed, an IANA name, or `null`.
+     *  @deprecated 0.46 — pass `zone` (§10.3: the zone is the account's, automatic only); removed in 0.47.
+     *  Shown read-only while `zone` is left out; the card no longer offers a picker. */
+    timezone?: string | null;
     /**
-     * Save one change — `PATCH /notifications/settings`: a time (`null` when cleared), with
-     * the device's zone the first time one is entered while `timezone` is `null`; or
-     * `{timezone}`. The field shows the new value while the call runs and goes back if it
+     * 0.46 (§10.3, amended 2026-10-20: automatic only): the account's zone — `/auth/me`'s
+     * `device_timezone`, the zone of the device last used; `null` while no device has
+     * reported one, and the card then names `fallbackZone`, the zone the server applies.
+     * Shown read-only once a time is set ("In your time zone (Europe / Zurich), which follows
+     * the device you last used."). No picker: the zone is never chosen.
+     */
+    zone?: string | null;
+    /** 0.46 (§10.4): the app queues a held push and sends it when the window ends (it runs
+     *  the notifications tick); the description says so. Default `false`: dropped. */
+    held?: boolean;
+    /**
+     * Save one change — `PATCH /notifications/settings`: a time, or `null` when cleared.
+     * Never a zone. The field shows the new value while the call runs and goes back if it
      * rejects.
      */
     onChange: (patch: NotificationSettingsPatch) => Promise<unknown> | void;
-    /** The zone shown, and the one the server applies, while `timezone` is `null`.
-     *  Default `"Europe/Zurich"`, every app's (decision 6). */
+    /** The zone named while neither `zone` nor `timezone` names one: the one the server
+     *  applies. Default `"Europe/Zurich"`, every app's. */
     fallbackZone?: string;
     /** The app keeps an inbox, and the description says a held push still reaches it. */
     inbox?: boolean;
@@ -29,19 +41,19 @@ export interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<"div"
 /**
  * Quiet hours (docs/notifications-harmonization.md §2.4, §2.6, §4.2): a window of local
  * times in the account's zone, which may cross midnight, when no push of a machine-sent
- * type is sent. A held push is dropped, not delayed; the inbox row and the mail go as
- * usual. keksdose's block, as a card of its own.
+ * type is sent. A held push is dropped — or, with `held` (0.46, §10.4), sent when the
+ * window ends; the inbox row and the mail go as usual. keksdose's block, as a card of its
+ * own.
+ *
+ * **0.46 (§10.3, amended 2026-10-20, Marcel): the zone is the account's, automatic
+ * only** — the zone of the device last used, else `Europe/Zurich`. The card names it
+ * read-only and never sends one; there is no picker and no "Use it".
  *
  * - **Two times**, each saved as it is entered; a cleared time sends `null`. While only
  *   one is set the card says so: the window fails open until both are.
- * - **The zone** shows while a time is set. The first time entered while the account has
- *   none sends this device's zone with it, so "22:00" means the person's 22:00
- *   (keksdose `notifications-card.tsx:288-292`). With none stored, the card shows
- *   `fallbackZone` — the zone the server then applies — never the device's (keksdose's
- *   card showed the device's zone while its server applied UTC).
- * - **"This device is in …"** with "Use it" when the device's zone is not the one in
- *   effect. Never written on its own: a zone is written by a person's pick (§2.6).
+ * - **The zone** shows while a time is set: `zone`, else the deprecated `timezone`, else
+ *   `fallbackZone`.
  *
  * Under a write lock the fields are `commit` controls exempt from billing.
  */
-export declare function QuietHoursSetting({ start, end, timezone, onChange, fallbackZone, inbox, disabled, describeError, labels: labelsProp, className, ...rest }: QuietHoursSettingProps): import("react").JSX.Element;
+export declare function QuietHoursSetting({ start, end, timezone, zone, held, onChange, fallbackZone, inbox, disabled, describeError, labels: labelsProp, className, ...rest }: QuietHoursSettingProps): import("react").JSX.Element;

package/dist/notifications/quiet-hours-setting.js

@@ -2,7 +2,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useId, useState } from "react";
 import { cn } from "../lib/cn.js";
-import { Button } from "../components/button.js";
 import { Card } from "../components/card.js";
 import { TimeInput } from "../components/time-input.js";
 import { COMMIT_EXCEPT_BILLING } from "../components/write-lock.js";
@@ -10,12 +9,14 @@ import { CARD_DESCRIPTION_CLASS } from "../settings/settings-card-classes.js";
 import { SettingsCardTitle } from "../settings/settings-heading.js";
 import { settle, useMounted } from "../account/account-parts.js";
 import { describeFailure, FailureLine, useNotificationsLabels, useWriteOverlay } from "./notification-parts.js";
-import { deviceTimeZone, TimeZoneSelect, zoneName } from "./time-zone-select.js";
+import { zoneName } from "./time-zone-select.js";
 const DEFAULT_FALLBACK_ZONE = "Europe/Zurich";
 function QuietHoursSetting({
   start,
   end,
-  timezone,
+  timezone = null,
+  zone,
+  held = false,
   onChange,
   fallbackZone = DEFAULT_FALLBACK_ZONE,
   inbox = false,
@@ -26,16 +27,14 @@ function QuietHoursSetting({
   ...rest
 }) {
   const labels = useNotificationsLabels(labelsProp);
-  const overlay = useWriteOverlay(`${start}|${end}|${timezone}`);
+  const overlay = useWriteOverlay(`${start}|${end}`);
   const [failure, setFailure] = useState(null);
   const mounted = useMounted();
   const id = useId();
   const shown = (field, server) => overlay.has(field) ? overlay.get(field) ?? null : server;
   const startShown = shown("quiet_hours_start", start);
   const endShown = shown("quiet_hours_end", end);
-  const zoneShown = shown("timezone", timezone);
-  const effectiveZone = zoneShown ?? fallbackZone;
-  const device = deviceTimeZone();
+  const accountZone = (zone === void 0 ? timezone : zone) ?? fallbackZone;
   const save = (patch) => {
     const fields = Object.keys(patch);
     setFailure(null);
@@ -54,16 +53,14 @@ function QuietHoursSetting({
   const saveTime = (field, value) => {
     const next = value || null;
     if (next === shown(field, field === "quiet_hours_start" ? start : end)) return;
-    const patch = { [field]: next };
-    if (next && zoneShown === null) patch.timezone = device;
-    save(patch);
+    save({ [field]: next });
   };
   const anySet = Boolean(startShown || endShown);
   const halfSet = Boolean(startShown) !== Boolean(endShown);
   return /* @__PURE__ */ jsxs(Card, { ...rest, className: cn("p-4 space-y-3", className), children: [
     /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(SettingsCardTitle, { children: labels.quietTitle }),
-      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.quietDescription(inbox) })
+      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.quietDescription(inbox, held) })
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-end gap-3", children: [
       /* @__PURE__ */ jsx(
@@ -92,36 +89,7 @@ function QuietHoursSetting({
       )
     ] }),
     halfSet && /* @__PURE__ */ jsx("p", { className: "text-xs text-warning", "data-quiet-incomplete": "", children: labels.quietIncomplete }),
-    anySet && /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
-      /* @__PURE__ */ jsx(
-        TimeZoneSelect,
-        {
-          id: `${id}-zone`,
-          value: effectiveZone,
-          disabled,
-          commit: COMMIT_EXCEPT_BILLING,
-          onChange: (zone) => save({ timezone: zone }),
-          className: "max-w-72",
-          labels: labelsProp
-        }
-      ),
-      device !== effectiveZone && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
-        /* @__PURE__ */ jsx("span", { id: `${id}-device`, className: CARD_DESCRIPTION_CLASS, children: labels.deviceZone(zoneName(device, labels.regions)) }),
-        /* @__PURE__ */ jsx(
-          Button,
-          {
-            type: "button",
-            size: "sm",
-            variant: "link",
-            disabled,
-            commit: COMMIT_EXCEPT_BILLING,
-            "aria-describedby": `${id}-device`,
-            onClick: () => save({ timezone: device }),
-            children: labels.useDeviceZone
-          }
-        )
-      ] })
-    ] }),
+    anySet && /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, "data-quiet-zone": "", children: labels.quietZone(zoneName(accountZone, labels.regions)) }),
     /* @__PURE__ */ jsx(FailureLine, { children: failure })
   ] });
 }

package/dist/notifications/quiet-hours-setting.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/quiet-hours-setting.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ComponentPropsWithRef, ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { Button } from \"../components/button\";\nimport { Card } from \"../components/card\";\nimport { TimeInput } from \"../components/time-input\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { CARD_DESCRIPTION_CLASS } from \"../settings/settings-card-classes\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { settle, useMounted } from \"../account/account-parts\";\nimport { describeFailure, FailureLine, useNotificationsLabels, useWriteOverlay } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { NotificationSettingsPatch } from \"./notification-types\";\nimport { deviceTimeZone, TimeZoneSelect, zoneName } from \"./time-zone-select\";\n\n/** The zone the server applies while the account has none (§2.6): every app's. */\nconst DEFAULT_FALLBACK_ZONE = \"Europe/Zurich\";\n\nexport interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onChange\"> {\n  /** The `GET`'s `quiet_hours_start`, `\"HH:MM\"`, or `null`. */\n  start: string | null;\n  /** The `GET`'s `quiet_hours_end`. */\n  end: string | null;\n  /** The `GET`'s `timezone`, an IANA name, or `null` (the app's zone applies). */\n  timezone: string | null;\n  /**\n   * Save one change — `PATCH /notifications/settings`: a time (`null` when cleared), with\n   * the device's zone the first time one is entered while `timezone` is `null`; or\n   * `{timezone}`. The field shows the new value while the call runs and goes back if it\n   * rejects.\n   */\n  onChange: (patch: NotificationSettingsPatch) => Promise<unknown> | void;\n  /** The zone shown, and the one the server applies, while `timezone` is `null`.\n   *  Default `\"Europe/Zurich\"`, every app's (decision 6). */\n  fallbackZone?: string;\n  /** The app keeps an inbox, and the description says a held push still reaches it. */\n  inbox?: boolean;\n  disabled?: boolean;\n  /** The app's own words for a failed save, or `undefined` for the kit's `failed`. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\ntype QuietField = \"quiet_hours_start\" | \"quiet_hours_end\" | \"timezone\";\n\n/**\n * Quiet hours (docs/notifications-harmonization.md §2.4, §2.6, §4.2): a window of local\n * times in the account's zone, which may cross midnight, when no push of a machine-sent\n * type is sent. A held push is dropped, not delayed; the inbox row and the mail go as\n * usual. keksdose's block, as a card of its own.\n *\n * - **Two times**, each saved as it is entered; a cleared time sends `null`. While only\n *   one is set the card says so: the window fails open until both are.\n * - **The zone** shows while a time is set. The first time entered while the account has\n *   none sends this device's zone with it, so \"22:00\" means the person's 22:00\n *   (keksdose `notifications-card.tsx:288-292`). With none stored, the card shows\n *   `fallbackZone` — the zone the server then applies — never the device's (keksdose's\n *   card showed the device's zone while its server applied UTC).\n * - **\"This device is in …\"** with \"Use it\" when the device's zone is not the one in\n *   effect. Never written on its own: a zone is written by a person's pick (§2.6).\n *\n * Under a write lock the fields are `commit` controls exempt from billing.\n */\nexport function QuietHoursSetting({\n  start,\n  end,\n  timezone,\n  onChange,\n  fallbackZone = DEFAULT_FALLBACK_ZONE,\n  inbox = false,\n  disabled = false,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: QuietHoursSettingProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const overlay = useWriteOverlay<string | null>(`${start}|${end}|${timezone}`);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const id = useId();\n\n  const shown = (field: QuietField, server: string | null) =>\n    overlay.has(field) ? (overlay.get(field) ?? null) : server;\n  const startShown = shown(\"quiet_hours_start\", start);\n  const endShown = shown(\"quiet_hours_end\", end);\n  const zoneShown = shown(\"timezone\", timezone);\n  const effectiveZone = zoneShown ?? fallbackZone;\n  const device = deviceTimeZone();\n\n  const save = (patch: NotificationSettingsPatch) => {\n    const fields = Object.keys(patch) as QuietField[];\n    setFailure(null);\n    for (const field of fields) overlay.set(field, patch[field] ?? null);\n    settle(() => onChange(patch)).then(\n      () => {\n        if (mounted.current) for (const field of fields) overlay.settle(field, true);\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        for (const field of fields) overlay.settle(field, false);\n        setFailure(describeFailure(describeError?.(error), labels.failed));\n      },\n    );\n  };\n\n  const saveTime = (field: \"quiet_hours_start\" | \"quiet_hours_end\", value: string) => {\n    const next = value || null;\n    if (next === shown(field, field === \"quiet_hours_start\" ? start : end)) return;\n    const patch: NotificationSettingsPatch = { [field]: next };\n    if (next && zoneShown === null) patch.timezone = device;\n    save(patch);\n  };\n\n  const anySet = Boolean(startShown || endShown);\n  const halfSet = Boolean(startShown) !== Boolean(endShown);\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.quietTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.quietDescription(inbox)}</div>\n      </div>\n      <div className=\"flex flex-wrap items-end gap-3\">\n        <TimeInput\n          id={`${id}-start`}\n          label={labels.quietFrom}\n          value={startShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_start\", value)}\n          className=\"w-36\"\n        />\n        <TimeInput\n          id={`${id}-end`}\n          label={labels.quietUntil}\n          value={endShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_end\", value)}\n          className=\"w-36\"\n        />\n      </div>\n      {halfSet && (\n        <p className=\"text-xs text-warning\" data-quiet-incomplete=\"\">\n          {labels.quietIncomplete}\n        </p>\n      )}\n      {anySet && (\n        <div className=\"space-y-2\">\n          <TimeZoneSelect\n            id={`${id}-zone`}\n            value={effectiveZone}\n            disabled={disabled}\n            commit={COMMIT_EXCEPT_BILLING}\n            onChange={(zone) => save({ timezone: zone })}\n            className=\"max-w-72\"\n            labels={labelsProp}\n          />\n          {device !== effectiveZone && (\n            <div className=\"flex flex-wrap items-center gap-x-2 gap-y-1\">\n              <span id={`${id}-device`} className={CARD_DESCRIPTION_CLASS}>\n                {labels.deviceZone(zoneName(device, labels.regions))}\n              </span>\n              <Button\n                type=\"button\"\n                size=\"sm\"\n                variant=\"link\"\n                disabled={disabled}\n                commit={COMMIT_EXCEPT_BILLING}\n                aria-describedby={`${id}-device`}\n                onClick={() => save({ timezone: device })}\n              >\n                {labels.useDeviceZone}\n              </Button>\n            </div>\n          )}\n        </div>\n      )}\n      <FailureLine>{failure}</FailureLine>\n    </Card>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/notifications/quiet-hours-setting.tsx"],"sourcesContent":["import { useId, useState } from \"react\";\nimport type { ComponentPropsWithRef, ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { cn } from \"../lib/cn\";\nimport { Card } from \"../components/card\";\nimport { TimeInput } from \"../components/time-input\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { CARD_DESCRIPTION_CLASS } from \"../settings/settings-card-classes\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { settle, useMounted } from \"../account/account-parts\";\nimport { describeFailure, FailureLine, useNotificationsLabels, useWriteOverlay } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { NotificationSettingsPatch } from \"./notification-types\";\nimport { zoneName } from \"./time-zone-select\";\n\n/** The zone the server applies while no device ever reported one (§10.3): every app's. */\nconst DEFAULT_FALLBACK_ZONE = \"Europe/Zurich\";\n\nexport interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onChange\"> {\n  /** The `GET`'s `quiet_hours_start`, `\"HH:MM\"`, or `null`. */\n  start: string | null;\n  /** The `GET`'s `quiet_hours_end`. */\n  end: string | null;\n  /** The zone the 0.36 card showed, an IANA name, or `null`.\n   *  @deprecated 0.46 — pass `zone` (§10.3: the zone is the account's, automatic only); removed in 0.47.\n   *  Shown read-only while `zone` is left out; the card no longer offers a picker. */\n  timezone?: string | null;\n  /**\n   * 0.46 (§10.3, amended 2026-10-20: automatic only): the account's zone — `/auth/me`'s\n   * `device_timezone`, the zone of the device last used; `null` while no device has\n   * reported one, and the card then names `fallbackZone`, the zone the server applies.\n   * Shown read-only once a time is set (\"In your time zone (Europe / Zurich), which follows\n   * the device you last used.\"). No picker: the zone is never chosen.\n   */\n  zone?: string | null;\n  /** 0.46 (§10.4): the app queues a held push and sends it when the window ends (it runs\n   *  the notifications tick); the description says so. Default `false`: dropped. */\n  held?: boolean;\n  /**\n   * Save one change — `PATCH /notifications/settings`: a time, or `null` when cleared.\n   * Never a zone. The field shows the new value while the call runs and goes back if it\n   * rejects.\n   */\n  onChange: (patch: NotificationSettingsPatch) => Promise<unknown> | void;\n  /** The zone named while neither `zone` nor `timezone` names one: the one the server\n   *  applies. Default `\"Europe/Zurich\"`, every app's. */\n  fallbackZone?: string;\n  /** The app keeps an inbox, and the description says a held push still reaches it. */\n  inbox?: boolean;\n  disabled?: boolean;\n  /** The app's own words for a failed save, or `undefined` for the kit's `failed`. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\ntype QuietField = \"quiet_hours_start\" | \"quiet_hours_end\";\n\n/**\n * Quiet hours (docs/notifications-harmonization.md §2.4, §2.6, §4.2): a window of local\n * times in the account's zone, which may cross midnight, when no push of a machine-sent\n * type is sent. A held push is dropped — or, with `held` (0.46, §10.4), sent when the\n * window ends; the inbox row and the mail go as usual. keksdose's block, as a card of its\n * own.\n *\n * **0.46 (§10.3, amended 2026-10-20, Marcel): the zone is the account's, automatic\n * only** — the zone of the device last used, else `Europe/Zurich`. The card names it\n * read-only and never sends one; there is no picker and no \"Use it\".\n *\n * - **Two times**, each saved as it is entered; a cleared time sends `null`. While only\n *   one is set the card says so: the window fails open until both are.\n * - **The zone** shows while a time is set: `zone`, else the deprecated `timezone`, else\n *   `fallbackZone`.\n *\n * Under a write lock the fields are `commit` controls exempt from billing.\n */\nexport function QuietHoursSetting({\n  start,\n  end,\n  timezone = null,\n  zone,\n  held = false,\n  onChange,\n  fallbackZone = DEFAULT_FALLBACK_ZONE,\n  inbox = false,\n  disabled = false,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: QuietHoursSettingProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const overlay = useWriteOverlay<string | null>(`${start}|${end}`);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const id = useId();\n\n  const shown = (field: QuietField, server: string | null) =>\n    overlay.has(field) ? (overlay.get(field) ?? null) : server;\n  const startShown = shown(\"quiet_hours_start\", start);\n  const endShown = shown(\"quiet_hours_end\", end);\n  const accountZone = (zone === undefined ? timezone : zone) ?? fallbackZone;\n\n  const save = (patch: NotificationSettingsPatch) => {\n    const fields = Object.keys(patch) as QuietField[];\n    setFailure(null);\n    for (const field of fields) overlay.set(field, patch[field] ?? null);\n    settle(() => onChange(patch)).then(\n      () => {\n        if (mounted.current) for (const field of fields) overlay.settle(field, true);\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        for (const field of fields) overlay.settle(field, false);\n        setFailure(describeFailure(describeError?.(error), labels.failed));\n      },\n    );\n  };\n\n  const saveTime = (field: \"quiet_hours_start\" | \"quiet_hours_end\", value: string) => {\n    const next = value || null;\n    if (next === shown(field, field === \"quiet_hours_start\" ? start : end)) return;\n    save({ [field]: next });\n  };\n\n  const anySet = Boolean(startShown || endShown);\n  const halfSet = Boolean(startShown) !== Boolean(endShown);\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.quietTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.quietDescription(inbox, held)}</div>\n      </div>\n      <div className=\"flex flex-wrap items-end gap-3\">\n        <TimeInput\n          id={`${id}-start`}\n          label={labels.quietFrom}\n          value={startShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_start\", value)}\n          className=\"w-36\"\n        />\n        <TimeInput\n          id={`${id}-end`}\n          label={labels.quietUntil}\n          value={endShown ?? \"\"}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onValueChange={(value) => saveTime(\"quiet_hours_end\", value)}\n          className=\"w-36\"\n        />\n      </div>\n      {halfSet && (\n        <p className=\"text-xs text-warning\" data-quiet-incomplete=\"\">\n          {labels.quietIncomplete}\n        </p>\n      )}\n      {anySet && (\n        <p className={CARD_DESCRIPTION_CLASS} data-quiet-zone=\"\">\n          {labels.quietZone(zoneName(accountZone, labels.regions))}\n        </p>\n      )}\n      <FailureLine>{failure}</FailureLine>\n    </Card>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/notifications/time-zone-select.d.ts

@@ -4,11 +4,12 @@ import type { ComboOption } from "../components/combobox-core.js";
 import type { CommitScope } from "../components/write-lock.js";
 import type { NotificationRegionLabels, NotificationsLabels } from "./notifications-labels.js";
 /**
- * This device's IANA zone ("Europe/Zurich"), or `"UTC"` where the runtime names none —
- * the zone quiet hours are entered in the first time (§2.6), and the one the card offers
- * when it differs from the account's.
+ * This device's IANA zone — the same function as the package root's, which lives beside
+ * `useDeviceZoneReport` now (0.46.1).
+ * @deprecated 0.46 — import `deviceTimeZone` from `@eifi1/ui-kit` (notifications/device-zone-report); this
+ * module is removed in 0.47.
  */
-export declare function deviceTimeZone(): string;
+export declare const deviceTimeZone: () => string;
 /**
  * The zone picker's rows (keksdose `notifications-card.tsx:131-146`): every zone `Intl`
  * lists, as its city ("Argentina / Buenos Aires") under its region, the region named by
@@ -17,6 +18,7 @@ export declare function deviceTimeZone(): string;
  * rather than trailing the last group as if it were Pacific. `current` is kept even when
  * the runtime does not list it (an old alias such as "Europe/Kiev"): a picker without its
  * own value would show an empty field.
+ * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.
  */
 export declare function timeZoneOptions(current: string, regionLabel: (region: string) => string | undefined): ComboOption<string>[];
 /** The region's name in `regions`, or `undefined` for one the labels do not know.
@@ -25,6 +27,7 @@ export declare function regionName(regions: NotificationRegionLabels, region: st
 /** A zone as the picker shows it, for a sentence: "Europe / Zurich", the region in the
  *  kit's words. @internal Not part of the barrel. */
 export declare function zoneName(zone: string, regions: NotificationRegionLabels): string;
+/** @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47. */
 export interface TimeZoneSelectProps {
     /** The IANA zone. Not clearable: a zone can be changed, never emptied. */
     value: string;
@@ -46,5 +49,6 @@ export interface TimeZoneSelectProps {
  * a search box instead of a 400-row wheel. Rows are the city under its region, the region
  * in the kit's words (`labels.regions`); a zone with no region first; a stored zone the
  * runtime does not list is kept. On the kit's {@link InlineEntityCombobox}.
+ * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.
  */
 export declare function TimeZoneSelect({ value, onChange, label, disabled, id, className, commit, labels: labelsProp, }: TimeZoneSelectProps): import("react").JSX.Element;

package/dist/notifications/time-zone-select.js

@@ -2,14 +2,9 @@
 import { jsx } from "react/jsx-runtime";
 import { useMemo } from "react";
 import { InlineEntityCombobox } from "../components/inline-entity-combobox.js";
+import { deviceTimeZone as zoneOfDevice } from "./device-zone-report.js";
 import { useNotificationsLabels } from "./notification-parts.js";
-function deviceTimeZone() {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
-  } catch {
-    return "UTC";
-  }
-}
+const deviceTimeZone = zoneOfDevice;
 function runtimeZones() {
   const intl = Intl;
   return typeof intl.supportedValuesOf === "function" ? intl.supportedValuesOf("timeZone") : [];

package/dist/notifications/time-zone-select.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/notifications/time-zone-select.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport type { ComboOption } from \"../components/combobox-core\";\nimport { InlineEntityCombobox } from \"../components/inline-entity-combobox\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationRegionLabels, NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * This device's IANA zone (\"Europe/Zurich\"), or `\"UTC\"` where the runtime names none —\n * the zone quiet hours are entered in the first time (§2.6), and the one the card offers\n * when it differs from the account's.\n */\nexport function deviceTimeZone(): string {\n  try {\n    return Intl.DateTimeFormat().resolvedOptions().timeZone || \"UTC\";\n  } catch {\n    return \"UTC\";\n  }\n}\n\n/** Every zone the runtime lists; `[]` where `Intl.supportedValuesOf` is missing. */\nfunction runtimeZones(): string[] {\n  const intl = Intl as typeof Intl & { supportedValuesOf?: (key: \"timeZone\") => string[] };\n  return typeof intl.supportedValuesOf === \"function\" ? intl.supportedValuesOf(\"timeZone\") : [];\n}\n\n/** \"Argentina/Buenos_Aires\" → \"Argentina / Buenos Aires\": the zone's city, as a row. */\nfunction cityOf(rest: string): string {\n  return rest.replace(/_/g, \" \").replace(/\\//g, \" / \");\n}\n\n/**\n * The zone picker's rows (keksdose `notifications-card.tsx:131-146`): every zone `Intl`\n * lists, as its city (\"Argentina / Buenos Aires\") under its region, the region named by\n * `regionLabel` — which answers `undefined` for a region it does not know, and the region\n * keeps its IANA name. A zone with no region (\"UTC\") comes first, ahead of every heading,\n * rather than trailing the last group as if it were Pacific. `current` is kept even when\n * the runtime does not list it (an old alias such as \"Europe/Kiev\"): a picker without its\n * own value would show an empty field.\n */\nexport function timeZoneOptions(\n  current: string,\n  regionLabel: (region: string) => string | undefined,\n): ComboOption<string>[] {\n  const zones = runtimeZones();\n  const all = !current || zones.includes(current) ? zones : [...zones, current].sort();\n  const rows = all.map((zone): ComboOption<string> => {\n    const slash = zone.indexOf(\"/\");\n    if (slash < 0) return { value: zone, label: zone };\n    const region = zone.slice(0, slash);\n    return { value: zone, label: cityOf(zone.slice(slash + 1)), group: regionLabel(region) ?? region };\n  });\n  return [...rows.filter((row) => !row.group), ...rows.filter((row) => row.group)];\n}\n\n/** The region's name in `regions`, or `undefined` for one the labels do not know.\n *  @internal Not part of the barrel. */\nexport function regionName(regions: NotificationRegionLabels, region: string): string | undefined {\n  return Object.prototype.hasOwnProperty.call(regions, region)\n    ? regions[region as keyof NotificationRegionLabels]\n    : undefined;\n}\n\n/** A zone as the picker shows it, for a sentence: \"Europe / Zurich\", the region in the\n *  kit's words. @internal Not part of the barrel. */\nexport function zoneName(zone: string, regions: NotificationRegionLabels): string {\n  const slash = zone.indexOf(\"/\");\n  if (slash < 0) return zone;\n  const region = zone.slice(0, slash);\n  return `${regionName(regions, region) ?? region} / ${cityOf(zone.slice(slash + 1))}`;\n}\n\nexport interface TimeZoneSelectProps {\n  /** The IANA zone. Not clearable: a zone can be changed, never emptied. */\n  value: string;\n  /** The zone picked. Never called for the value it already has. */\n  onChange: (zone: string) => void;\n  /** Default `labels.timeZone`. */\n  label?: ReactNode;\n  disabled?: boolean;\n  /** The input's id. */\n  id?: string;\n  className?: string;\n  /** The picker SAVES on change (quiet hours do): locked under a write lock in scope. */\n  commit?: CommitScope;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/**\n * An IANA time zone, searchable (docs/notifications-harmonization.md §4.2, keksdose's\n * quiet-hours picker): type \"Zur\" for Europe/Zurich, and on a phone the kit's sheet with\n * a search box instead of a 400-row wheel. Rows are the city under its region, the region\n * in the kit's words (`labels.regions`); a zone with no region first; a stored zone the\n * runtime does not list is kept. On the kit's {@link InlineEntityCombobox}.\n */\nexport function TimeZoneSelect({\n  value,\n  onChange,\n  label,\n  disabled,\n  id,\n  className,\n  commit,\n  labels: labelsProp,\n}: TimeZoneSelectProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const { regions } = labels;\n  const options = useMemo(() => timeZoneOptions(value, (region) => regionName(regions, region)), [value, regions]);\n  return (\n    <InlineEntityCombobox<string>\n      id={id}\n      label={label ?? labels.timeZone}\n      value={value}\n      options={options}\n      disabled={disabled}\n      commit={commit}\n      onChange={(zone) => {\n        if (zone && zone !== value) onChange(zone);\n      }}\n      className={className}\n    />\n  );\n}\n"],"mappings":";AAgHI;AAhHJ,SAAS,eAAe;AAKxB,SAAS,4BAA4B;AAErC,SAAS,8BAA8B;AAQhC,SAAS,iBAAyB;AACvC,MAAI;AACF,WAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE,YAAY;AAAA,EAC7D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,eAAyB;AAChC,QAAM,OAAO;AACb,SAAO,OAAO,KAAK,sBAAsB,aAAa,KAAK,kBAAkB,UAAU,IAAI,CAAC;AAC9F;AAGA,SAAS,OAAO,MAAsB;AACpC,SAAO,KAAK,QAAQ,MAAM,GAAG,EAAE,QAAQ,OAAO,KAAK;AACrD;AAWO,SAAS,gBACd,SACA,aACuB;AACvB,QAAM,QAAQ,aAAa;AAC3B,QAAM,MAAM,CAAC,WAAW,MAAM,SAAS,OAAO,IAAI,QAAQ,CAAC,GAAG,OAAO,OAAO,EAAE,KAAK;AACnF,QAAM,OAAO,IAAI,IAAI,CAAC,SAA8B;AAClD,UAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,QAAI,QAAQ,EAAG,QAAO,EAAE,OAAO,MAAM,OAAO,KAAK;AACjD,UAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,WAAO,EAAE,OAAO,MAAM,OAAO,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,YAAY,MAAM,KAAK,OAAO;AAAA,EACnG,CAAC;AACD,SAAO,CAAC,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;AACjF;AAIO,SAAS,WAAW,SAAmC,QAAoC;AAChG,SAAO,OAAO,UAAU,eAAe,KAAK,SAAS,MAAM,IACvD,QAAQ,MAAwC,IAChD;AACN;AAIO,SAAS,SAAS,MAAc,SAA2C;AAChF,QAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,SAAO,GAAG,WAAW,SAAS,MAAM,KAAK,MAAM,MAAM,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC;AACpF;AAyBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAAwB;AACtB,QAAM,SAAS,uBAAuB,UAAU;AAChD,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,UAAU,QAAQ,MAAM,gBAAgB,OAAO,CAAC,WAAW,WAAW,SAAS,MAAM,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC;AAC/G,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,SAAS,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,CAAC,SAAS;AAClB,YAAI,QAAQ,SAAS,MAAO,UAAS,IAAI;AAAA,MAC3C;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/notifications/time-zone-select.tsx"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport type { ComboOption } from \"../components/combobox-core\";\nimport { InlineEntityCombobox } from \"../components/inline-entity-combobox\";\nimport type { CommitScope } from \"../components/write-lock\";\nimport { deviceTimeZone as zoneOfDevice } from \"./device-zone-report\";\nimport { useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationRegionLabels, NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * This device's IANA zone — the same function as the package root's, which lives beside\n * `useDeviceZoneReport` now (0.46.1).\n * @deprecated 0.46 — import `deviceTimeZone` from `@eifi1/ui-kit` (notifications/device-zone-report); this\n * module is removed in 0.47.\n */\nexport const deviceTimeZone: () => string = zoneOfDevice;\n\n/** Every zone the runtime lists; `[]` where `Intl.supportedValuesOf` is missing. */\nfunction runtimeZones(): string[] {\n  const intl = Intl as typeof Intl & { supportedValuesOf?: (key: \"timeZone\") => string[] };\n  return typeof intl.supportedValuesOf === \"function\" ? intl.supportedValuesOf(\"timeZone\") : [];\n}\n\n/** \"Argentina/Buenos_Aires\" → \"Argentina / Buenos Aires\": the zone's city, as a row. */\nfunction cityOf(rest: string): string {\n  return rest.replace(/_/g, \" \").replace(/\\//g, \" / \");\n}\n\n/**\n * The zone picker's rows (keksdose `notifications-card.tsx:131-146`): every zone `Intl`\n * lists, as its city (\"Argentina / Buenos Aires\") under its region, the region named by\n * `regionLabel` — which answers `undefined` for a region it does not know, and the region\n * keeps its IANA name. A zone with no region (\"UTC\") comes first, ahead of every heading,\n * rather than trailing the last group as if it were Pacific. `current` is kept even when\n * the runtime does not list it (an old alias such as \"Europe/Kiev\"): a picker without its\n * own value would show an empty field.\n * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.\n */\nexport function timeZoneOptions(\n  current: string,\n  regionLabel: (region: string) => string | undefined,\n): ComboOption<string>[] {\n  const zones = runtimeZones();\n  const all = !current || zones.includes(current) ? zones : [...zones, current].sort();\n  const rows = all.map((zone): ComboOption<string> => {\n    const slash = zone.indexOf(\"/\");\n    if (slash < 0) return { value: zone, label: zone };\n    const region = zone.slice(0, slash);\n    return { value: zone, label: cityOf(zone.slice(slash + 1)), group: regionLabel(region) ?? region };\n  });\n  return [...rows.filter((row) => !row.group), ...rows.filter((row) => row.group)];\n}\n\n/** The region's name in `regions`, or `undefined` for one the labels do not know.\n *  @internal Not part of the barrel. */\nexport function regionName(regions: NotificationRegionLabels, region: string): string | undefined {\n  return Object.prototype.hasOwnProperty.call(regions, region)\n    ? regions[region as keyof NotificationRegionLabels]\n    : undefined;\n}\n\n/** A zone as the picker shows it, for a sentence: \"Europe / Zurich\", the region in the\n *  kit's words. @internal Not part of the barrel. */\nexport function zoneName(zone: string, regions: NotificationRegionLabels): string {\n  const slash = zone.indexOf(\"/\");\n  if (slash < 0) return zone;\n  const region = zone.slice(0, slash);\n  return `${regionName(regions, region) ?? region} / ${cityOf(zone.slice(slash + 1))}`;\n}\n\n/** @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47. */\nexport interface TimeZoneSelectProps {\n  /** The IANA zone. Not clearable: a zone can be changed, never emptied. */\n  value: string;\n  /** The zone picked. Never called for the value it already has. */\n  onChange: (zone: string) => void;\n  /** Default `labels.timeZone`. */\n  label?: ReactNode;\n  disabled?: boolean;\n  /** The input's id. */\n  id?: string;\n  className?: string;\n  /** The picker SAVES on change (quiet hours do): locked under a write lock in scope. */\n  commit?: CommitScope;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/**\n * An IANA time zone, searchable (docs/notifications-harmonization.md §4.2, keksdose's\n * quiet-hours picker): type \"Zur\" for Europe/Zurich, and on a phone the kit's sheet with\n * a search box instead of a 400-row wheel. Rows are the city under its region, the region\n * in the kit's words (`labels.regions`); a zone with no region first; a stored zone the\n * runtime does not list is kept. On the kit's {@link InlineEntityCombobox}.\n * @deprecated 0.46 — the zone is automatic (§10.3, amended 2026-10-20), no app picks one; removed in 0.47.\n */\nexport function TimeZoneSelect({\n  value,\n  onChange,\n  label,\n  disabled,\n  id,\n  className,\n  commit,\n  labels: labelsProp,\n}: TimeZoneSelectProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const { regions } = labels;\n  const options = useMemo(() => timeZoneOptions(value, (region) => regionName(regions, region)), [value, regions]);\n  return (\n    <InlineEntityCombobox<string>\n      id={id}\n      label={label ?? labels.timeZone}\n      value={value}\n      options={options}\n      disabled={disabled}\n      commit={commit}\n      onChange={(zone) => {\n        if (zone && zone !== value) onChange(zone);\n      }}\n      className={className}\n    />\n  );\n}\n"],"mappings":";AA+GI;AA/GJ,SAAS,eAAe;AAKxB,SAAS,4BAA4B;AAErC,SAAS,kBAAkB,oBAAoB;AAC/C,SAAS,8BAA8B;AAShC,MAAM,iBAA+B;AAG5C,SAAS,eAAyB;AAChC,QAAM,OAAO;AACb,SAAO,OAAO,KAAK,sBAAsB,aAAa,KAAK,kBAAkB,UAAU,IAAI,CAAC;AAC9F;AAGA,SAAS,OAAO,MAAsB;AACpC,SAAO,KAAK,QAAQ,MAAM,GAAG,EAAE,QAAQ,OAAO,KAAK;AACrD;AAYO,SAAS,gBACd,SACA,aACuB;AACvB,QAAM,QAAQ,aAAa;AAC3B,QAAM,MAAM,CAAC,WAAW,MAAM,SAAS,OAAO,IAAI,QAAQ,CAAC,GAAG,OAAO,OAAO,EAAE,KAAK;AACnF,QAAM,OAAO,IAAI,IAAI,CAAC,SAA8B;AAClD,UAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,QAAI,QAAQ,EAAG,QAAO,EAAE,OAAO,MAAM,OAAO,KAAK;AACjD,UAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,WAAO,EAAE,OAAO,MAAM,OAAO,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,YAAY,MAAM,KAAK,OAAO;AAAA,EACnG,CAAC;AACD,SAAO,CAAC,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,GAAG,KAAK,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC;AACjF;AAIO,SAAS,WAAW,SAAmC,QAAoC;AAChG,SAAO,OAAO,UAAU,eAAe,KAAK,SAAS,MAAM,IACvD,QAAQ,MAAwC,IAChD;AACN;AAIO,SAAS,SAAS,MAAc,SAA2C;AAChF,QAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,SAAS,KAAK,MAAM,GAAG,KAAK;AAClC,SAAO,GAAG,WAAW,SAAS,MAAM,KAAK,MAAM,MAAM,OAAO,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC;AACpF;AA2BO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAAwB;AACtB,QAAM,SAAS,uBAAuB,UAAU;AAChD,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,UAAU,QAAQ,MAAM,gBAAgB,OAAO,CAAC,WAAW,WAAW,SAAS,MAAM,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC;AAC/G,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,SAAS,OAAO;AAAA,MACvB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,CAAC,SAAS;AAClB,YAAI,QAAQ,SAAS,MAAO,UAAS,IAAI;AAAA,MAC3C;AAAA,MACA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/notifications/use-push-device.d.ts

@@ -1,3 +1,7 @@
+import { PUSH_SUBSCRIPTION_CHANGED } from "./push-worker.js";
+import type { PushSubscriptionInput } from "./push-worker.js";
+export { PUSH_SUBSCRIPTION_CHANGED };
+export type { PushSubscriptionInput };
 /**
  * This browser's Web Push subscription for the signed-in account
  * (docs/notifications-harmonization.md §2.7, §3.5, §4.2) — keksdose's
@@ -21,15 +25,6 @@ export declare class PushDeviceError extends Error {
     readonly code: PushDeviceErrorCode;
     constructor(code: PushDeviceErrorCode);
 }
-/** What `register` sends: `POST /notifications/devices` (§3.5). */
-export interface PushSubscriptionInput {
-    endpoint: string;
-    keys: {
-        p256dh: string;
-        auth: string;
-    };
-    user_agent: string | null;
-}
 export interface UsePushDeviceOptions {
     /** `GET /notifications/push-key` → its `key`; `""` when push is off on the server. */
     pushKey: () => Promise<string>;
@@ -85,14 +80,6 @@ export interface PushDevice {
         sent: number;
     }>;
 }
-/**
- * The window event every mounted {@link usePushDevice} re-reads its state on. Fired by
- * every enable and disable, and by `PushDevicesSetting` when it removes this device — so
- * an app's own card on the same hook (keksdose's check-up) stays in step. The hook that
- * fires it does not re-read: it knows what it changed. Namespaced for the kit;
- * keksdose's was `"keksdose:push-subscription-changed"`.
- */
-export declare const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
 /** Tell every {@link usePushDevice} that this browser's subscription changed. */
 export declare function notifyPushSubscriptionChanged(): void;
 /** Whether this browser has the APIs push needs. iOS exposes them only to an INSTALLED

package/dist/notifications/use-push-device.js

@@ -2,6 +2,7 @@
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useMediaQuery } from "../hooks/use-media-query.js";
 import { httpStatusOf } from "../auth/auth-errors.js";
+import { PUSH_SUBSCRIPTION_CHANGED, keyBytes, pushSubscriptionInput as inputOf } from "./push-worker.js";
 class PushDeviceError extends Error {
   code;
   constructor(code) {
@@ -10,7 +11,6 @@ class PushDeviceError extends Error {
     this.code = code;
   }
 }
-const PUSH_SUBSCRIPTION_CHANGED = "eifi1:push-subscription-changed";
 function notifyPushSubscriptionChanged() {
   if (typeof window !== "undefined") window.dispatchEvent(new Event(PUSH_SUBSCRIPTION_CHANGED));
 }
@@ -38,20 +38,6 @@ async function activeRegistration() {
   if (!existing) throw new PushDeviceError("no_service_worker");
   return within(navigator.serviceWorker.ready, READY_TIMEOUT_MS, "no_service_worker");
 }
-function keyBytes(key) {
-  const base64 = key.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - key.length % 4) % 4);
-  const raw = atob(base64);
-  const bytes = new Uint8Array(new ArrayBuffer(raw.length));
-  for (let i = 0; i < raw.length; i++) bytes[i] = raw.charCodeAt(i);
-  return bytes;
-}
-function inputOf(subscription) {
-  const json = subscription.toJSON();
-  const p256dh = json.keys?.p256dh;
-  const auth = json.keys?.auth;
-  if (!json.endpoint || !p256dh || !auth) return null;
-  return { endpoint: json.endpoint, keys: { p256dh, auth }, user_agent: navigator.userAgent || null };
-}
 const defaultEndpointTaken = (error) => httpStatusOf(error) === 409;
 function usePushDevice(options) {
   const latest = useRef(options);
@@ -133,11 +119,17 @@ function usePushDevice(options) {
     const heard = () => {
       if (!announcing.current) void sync();
     };
+    const fromWorker = (event) => {
+      if (event.data?.type === PUSH_SUBSCRIPTION_CHANGED) void sync();
+    };
+    const worker = navigator.serviceWorker;
     void sync();
     window.addEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);
+    worker?.addEventListener?.("message", fromWorker);
     return () => {
       cancelled = true;
       window.removeEventListener(PUSH_SUBSCRIPTION_CHANGED, heard);
+      worker?.removeEventListener?.("message", fromWorker);
     };
   }, [supported]);
   const enable = useCallback(async () => {