@eifi1/ui-kit 0.35.0 → 0.37.0

package/dist/notifications/notifications-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/notifications-labels.ts"],"sourcesContent":["// The words of the notification cards (docs/notifications-harmonization.md §4.2), in a\n// module with no component code: the English catalogue (src/i18n/defaults.ts) imports\n// them without the components, so `en` loads as one chunk like the other languages\n// (0.34, KS U8). The cards read it through `useKitLabels(\"notifications\", …)`.\n\n/** The ten IANA regions `Intl` lists zones under — keksdose's `tz_region_*` — in the\n *  kit's words. A region a runtime adds later keeps its IANA name. */\nexport interface NotificationRegionLabels {\n  Africa: string;\n  America: string;\n  Antarctica: string;\n  Arctic: string;\n  Asia: string;\n  Atlantic: string;\n  Australia: string;\n  Europe: string;\n  Indian: string;\n  Pacific: string;\n}\n\n/**\n * Every string the notification parts render — the `notifications` namespace of\n * `<UiKitProvider labels>`, overridable per instance through `labels`: the types card,\n * quiet hours and the zone picker, this device's push, the device list, and the\n * unsubscribe page. Cancel is `common.cancel`.\n */\nexport interface NotificationsLabels {\n  /* ── The types card ─────────────────────────────────────────────────── */\n  /** The types card's title. */\n  typesTitle: string;\n  /** The line under it. */\n  typesDescription: string;\n  /** The e-mail switch under a type that offers mail. */\n  byEmail: string;\n  /** Under every e-mail switch while the account's address is unverified (decision 16):\n   *  no notification mail goes to an unverified address. */\n  emailUnverified: string;\n  /** The digest's cadence select. */\n  digestCadence: string;\n  digestWeekly: string;\n  digestMonthly: string;\n  /** While the settings load. */\n  typesLoading: string;\n  /** The server answered no types for this account. */\n  typesEmpty: string;\n\n  /* ── Quiet hours ────────────────────────────────────────────────────── */\n  quietTitle: string;\n  /** The line under the title; `inbox`: the app keeps an inbox, which a held push still\n   *  reaches. */\n  quietDescription: (inbox: boolean) => string;\n  /** The start time's label. */\n  quietFrom: string;\n  /** The end time's label. */\n  quietUntil: string;\n  /** One time set, the other not: quiet hours fail open until both are. */\n  quietIncomplete: string;\n  /** The zone picker's label. */\n  timeZone: string;\n  /** Given the device's zone, as the picker names it, when it differs from the one the\n   *  server applies. */\n  deviceZone: (zone: string) => string;\n  /** The button that takes the device's zone. */\n  useDeviceZone: string;\n  /** The zone picker's region headings. */\n  regions: NotificationRegionLabels;\n\n  /* ── This device ────────────────────────────────────────────────────── */\n  pushTitle: string;\n  pushDescription: string;\n  /** The browser has no push. */\n  unsupported: string;\n  /** iOS outside the installed app, given the app's name. */\n  iosInstall: (app: string) => string;\n  /** The server has no VAPID keys. */\n  notConfigured: string;\n  /** The browser's permission is denied. */\n  blocked: string;\n  /** This device gets notifications for the signed-in account. */\n  on: string;\n  off: string;\n  /** This browser's subscription belongs to another account. */\n  otherAccount: string;\n  enable: string;\n  disable: string;\n  sendTest: string;\n  /** Turning on did not finish (the permission prompt dismissed, a refusal). */\n  enableFailed: string;\n  /** No service worker, or one that is not ready in 10 s. */\n  noServiceWorker: string;\n  /** The browser's push service did not answer in 15 s. */\n  pushTimeout: string;\n  /** Given how many devices the push service accepted the test for (≥ 1). */\n  testSent: (count: number) => string;\n  /** The test reached no device. */\n  testNone: string;\n  testFailed: string;\n  /** The explainer before the browser's one permission prompt. */\n  explainerTitle: string;\n  explainerBody: (app: string) => string;\n  explainerHint: string;\n  explainerContinue: string;\n\n  /* ── The device list ────────────────────────────────────────────────── */\n  devicesTitle: string;\n  devicesDescription: string;\n  devicesLoading: string;\n  devicesEmpty: string;\n  /** A device whose user agent says nothing the kit recognises. */\n  unknownDevice: string;\n  /** The chip on this browser's row. */\n  thisDevice: string;\n  /** Given the registration date, formatted. */\n  added: (date: string) => string;\n  /** Given the last accepted delivery, formatted. */\n  lastDelivery: (date: string) => string;\n  noDelivery: string;\n  /** Given the failed deliveries in a row (≥ 1). */\n  failures: (count: number) => string;\n  /** A row's button, visible text — and the confirm's answer. */\n  remove: string;\n  /** The same button's accessible name, given the device: it starts with `remove`. */\n  removeItem: (device: string) => string;\n  /** The question the row asks before it removes. */\n  removePrompt: string;\n\n  /* ── The unsubscribe page ───────────────────────────────────────────── */\n  unsubscribeTitle: string;\n  /** Given the type's name in the app's words. */\n  unsubscribeAbout: (type: string) => string;\n  /** No type name to give. */\n  unsubscribeGeneric: string;\n  stopThese: string;\n  stopAll: (app: string) => string;\n  stoppedThese: string;\n  stoppedAll: (app: string) => string;\n  /** Account mail is not a notification, and keeps coming. */\n  accountMail: string;\n  turnBackOn: string;\n  openSettings: string;\n  /** A token the server refused, or one that does not parse. */\n  invalidLink: string;\n\n  /* ── Every card ─────────────────────────────────────────────────────── */\n  /** A request failed, and the app had no words of its own. */\n  failed: string;\n}\n\nexport const DEFAULT_NOTIFICATIONS_LABELS: NotificationsLabels = {\n  typesTitle: \"Notify me about\",\n  typesDescription: \"Choose what you hear about, and how.\",\n  byEmail: \"By e-mail\",\n  emailUnverified: \"Confirm your address to receive these.\",\n  digestCadence: \"Frequency\",\n  digestWeekly: \"Weekly\",\n  digestMonthly: \"Monthly\",\n  typesLoading: \"Loading notification settings…\",\n  typesEmpty: \"There are no notifications for this account.\",\n\n  quietTitle: \"Quiet hours\",\n  quietDescription: (inbox) =>\n    inbox\n      ? \"No push notifications during this window. They still reach your inbox.\"\n      : \"No push notifications during this window.\",\n  quietFrom: \"From\",\n  quietUntil: \"Until\",\n  quietIncomplete: \"Set both a start and an end time. Quiet hours take effect once both are set.\",\n  timeZone: \"Time zone\",\n  deviceZone: (zone) => `This device is in ${zone}.`,\n  useDeviceZone: \"Use it\",\n  regions: {\n    Africa: \"Africa\",\n    America: \"Americas\",\n    Antarctica: \"Antarctica\",\n    Arctic: \"Arctic\",\n    Asia: \"Asia\",\n    Atlantic: \"Atlantic\",\n    Australia: \"Australia\",\n    Europe: \"Europe\",\n    Indian: \"Indian Ocean\",\n    Pacific: \"Pacific\",\n  },\n\n  pushTitle: \"Push notifications\",\n  pushDescription: \"Notifications on this device, also while the app is closed.\",\n  unsupported: \"This browser doesn’t support push notifications.\",\n  iosInstall: (app) =>\n    `On iPhone or iPad, add ${app} to your Home Screen first: iOS delivers notifications only to the installed app.`,\n  notConfigured: \"Push notifications aren’t set up on this server.\",\n  blocked: \"Notifications are blocked in this browser’s settings.\",\n  on: \"Notifications are on for this device.\",\n  off: \"Notifications are off for this device.\",\n  otherAccount:\n    \"This browser gets notifications for another account. Turn them on here to get them for the account you’re signed in with.\",\n  enable: \"Turn on notifications\",\n  disable: \"Turn off\",\n  sendTest: \"Send a test\",\n  enableFailed: \"Couldn’t turn on notifications.\",\n  noServiceWorker: \"Couldn’t reach the app’s service worker. Reload the page and try again.\",\n  pushTimeout: \"The browser’s push service didn’t answer. Check your connection and try again.\",\n  testSent: (count) => (count === 1 ? \"Test sent to 1 device\" : `Test sent to ${count} devices`),\n  testNone: \"No device accepted the test. Turn notifications on for this device first.\",\n  testFailed: \"Couldn’t send a test notification.\",\n  explainerTitle: \"Turn on notifications?\",\n  explainerBody: (app) =>\n    `${app} sends a notification only for the kinds you choose, and you can turn them off at any time.`,\n  explainerHint: \"Your browser asks for permission next.\",\n  explainerContinue: \"Continue\",\n\n  devicesTitle: \"Notification devices\",\n  devicesDescription: \"Every device that gets push notifications for your account. Remove any you no longer use.\",\n  devicesLoading: \"Loading devices…\",\n  devicesEmpty: \"No device gets notifications yet.\",\n  unknownDevice: \"Unknown device\",\n  thisDevice: \"This device\",\n  added: (date) => `Added ${date}`,\n  lastDelivery: (date) => `Last delivery ${date}`,\n  noDelivery: \"No delivery yet\",\n  failures: (count) =>\n    count === 1 ? \"1 failed delivery in a row\" : `${count} failed deliveries in a row`,\n  remove: \"Remove\",\n  removeItem: (device) => `Remove ${device}`,\n  removePrompt: \"Stop sending notifications to this device?\",\n\n  unsubscribeTitle: \"E-mail notifications\",\n  unsubscribeAbout: (type) => `You get e-mails about: ${type}.`,\n  unsubscribeGeneric: \"You get notification e-mails.\",\n  stopThese: \"Stop these e-mails\",\n  stopAll: (app) => `Stop all notification e-mails from ${app}`,\n  stoppedThese: \"Done. You won’t get these e-mails any more.\",\n  stoppedAll: (app) => `Done. You won’t get notification e-mails from ${app} any more.`,\n  accountMail: \"E-mails about your account still come.\",\n  turnBackOn: \"You can turn them back on at any time in Settings.\",\n  openSettings: \"Open Settings\",\n  invalidLink: \"This link doesn’t work any more. You can turn e-mails off in Settings instead.\",\n\n  failed: \"That didn’t work. Please try again.\",\n};\n"],"mappings":";AAoJO,MAAM,+BAAoD;AAAA,EAC/D,YAAY;AAAA,EACZ,kBAAkB;AAAA,EAClB,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,eAAe;AAAA,EACf,cAAc;AAAA,EACd,YAAY;AAAA,EAEZ,YAAY;AAAA,EACZ,kBAAkB,CAAC,UACjB,QACI,2EACA;AAAA,EACN,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,iBAAiB;AAAA,EACjB,UAAU;AAAA,EACV,YAAY,CAAC,SAAS,qBAAqB,IAAI;AAAA,EAC/C,eAAe;AAAA,EACf,SAAS;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,UAAU;AAAA,IACV,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AAAA,EAEA,WAAW;AAAA,EACX,iBAAiB;AAAA,EACjB,aAAa;AAAA,EACb,YAAY,CAAC,QACX,0BAA0B,GAAG;AAAA,EAC/B,eAAe;AAAA,EACf,SAAS;AAAA,EACT,IAAI;AAAA,EACJ,KAAK;AAAA,EACL,cACE;AAAA,EACF,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,UAAU;AAAA,EACV,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,aAAa;AAAA,EACb,UAAU,CAAC,UAAW,UAAU,IAAI,0BAA0B,gBAAgB,KAAK;AAAA,EACnF,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,eAAe,CAAC,QACd,GAAG,GAAG;AAAA,EACR,eAAe;AAAA,EACf,mBAAmB;AAAA,EAEnB,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,cAAc;AAAA,EACd,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,OAAO,CAAC,SAAS,SAAS,IAAI;AAAA,EAC9B,cAAc,CAAC,SAAS,iBAAiB,IAAI;AAAA,EAC7C,YAAY;AAAA,EACZ,UAAU,CAAC,UACT,UAAU,IAAI,+BAA+B,GAAG,KAAK;AAAA,EACvD,QAAQ;AAAA,EACR,YAAY,CAAC,WAAW,UAAU,MAAM;AAAA,EACxC,cAAc;AAAA,EAEd,kBAAkB;AAAA,EAClB,kBAAkB,CAAC,SAAS,0BAA0B,IAAI;AAAA,EAC1D,oBAAoB;AAAA,EACpB,WAAW;AAAA,EACX,SAAS,CAAC,QAAQ,sCAAsC,GAAG;AAAA,EAC3D,cAAc;AAAA,EACd,YAAY,CAAC,QAAQ,sDAAiD,GAAG;AAAA,EACzE,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,aAAa;AAAA,EAEb,QAAQ;AACV;","names":[]}

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

@@ -0,0 +1,37 @@
+import type { ComponentPropsWithRef, ReactNode } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import type { NotificationsLabels } from "./notifications-labels.js";
+import type { PushDevice } from "./use-push-device.js";
+/** Which action failed — {@link PushDeviceSettingProps.describeError}'s second argument. */
+export type PushDeviceAction = "enable" | "disable" | "test";
+export interface PushDeviceSettingProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
+    /** This browser's push, from {@link usePushDevice}. */
+    push: PushDevice;
+    /** The app's name, for the iOS line and the explainer. */
+    appName: string;
+    /** The app's own words for a failure, or `undefined` for the kit's. The kit already
+     *  has words for a missing service worker and an unanswered push service. */
+    describeError?: (error: unknown, action: PushDeviceAction) => ReactNode | undefined;
+    labels?: LabelOverride<NotificationsLabels>;
+}
+/**
+ * Push on THIS device (docs/notifications-harmonization.md §2.2, §2.7, §4.2): keksdose's
+ * push block, as a card of its own. Registering the device is the switch — push has no
+ * account switch. One state at a time, in keksdose's order
+ * (`notifications-card.tsx:333-402`):
+ *
+ * 1. the browser has no push;
+ * 2. iOS outside the installed app (iOS delivers only to the installed app);
+ * 3. push is not set up on the server (no VAPID keys);
+ * 4. notifications blocked in the browser;
+ * 5. on or off — with "another account" when this browser's subscription is someone
+ *    else's — and "Turn on notifications", or "Send a test" and "Turn off".
+ *
+ * **The explainer comes before the browser's one prompt**: turning on while the
+ * permission is still `"default"` opens a dialog first (what the notifications are for,
+ * that the browser asks next); with it granted, it goes straight on. A test that reached
+ * no device says so (`testNone`) — a 404/410 removes the row on the server while this
+ * browser still holds its subscription. Outcomes are a line under the buttons; nothing
+ * toasts.
+ */
+export declare function PushDeviceSetting({ push, appName, describeError, labels: labelsProp, className, ...rest }: PushDeviceSettingProps): import("react").JSX.Element;

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

@@ -0,0 +1,164 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels.js";
+import { cn } from "../lib/cn.js";
+import { AlertBanner } from "../components/alert-banner.js";
+import { Button } from "../components/button.js";
+import { Card } from "../components/card.js";
+import { DialogFrame } from "../components/dialog-frame.js";
+import { COMMIT_EXCEPT_BILLING } from "../components/write-lock.js";
+import { CARD_DESCRIPTION_CLASS } from "../settings/settings-card-classes.js";
+import { SettingsCardTitle } from "../settings/settings-heading.js";
+import { useMounted } from "../account/account-parts.js";
+import { describeFailure, FailureLine, useNotificationsLabels } from "./notification-parts.js";
+import { PushDeviceError } from "./use-push-device.js";
+function PushDeviceSetting({
+  push,
+  appName,
+  describeError,
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useNotificationsLabels(labelsProp);
+  const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
+  const [explainer, setExplainer] = useState(false);
+  const [running, setRunning] = useState(null);
+  const [outcome, setOutcome] = useState(null);
+  const mounted = useMounted();
+  const failureOf = (error, action, fallback) => {
+    if (error instanceof PushDeviceError) {
+      return error.code === "no_service_worker" ? labels.noServiceWorker : labels.pushTimeout;
+    }
+    return describeFailure(describeError?.(error, action), fallback);
+  };
+  const run = (action, call, done, fallback) => {
+    if (running) return;
+    setRunning(action);
+    setOutcome(null);
+    call().then(
+      (value) => {
+        if (!mounted.current) return;
+        setRunning(null);
+        setOutcome(done(value));
+      },
+      (error) => {
+        if (!mounted.current) return;
+        setRunning(null);
+        setOutcome({ tone: "danger", text: failureOf(error, action, fallback) });
+      }
+    );
+  };
+  const enable = () => run(
+    "enable",
+    () => push.enable(),
+    (ok) => ok ? null : { tone: "danger", text: labels.enableFailed },
+    labels.enableFailed
+  );
+  const disable = () => run("disable", () => push.disable(), () => null, labels.failed);
+  const test = () => run(
+    "test",
+    () => push.sendTest(),
+    ({ sent }) => sent > 0 ? { tone: "status", text: labels.testSent(sent) } : { tone: "warning", text: labels.testNone },
+    labels.testFailed
+  );
+  const turnOn = () => {
+    if (push.permission === "granted") enable();
+    else setExplainer(true);
+  };
+  let state;
+  if (!push.supported) {
+    state = /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.unsupported });
+  } else if (push.ios && !push.installed) {
+    state = /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.iosInstall(appName) });
+  } else if (push.configured === false) {
+    state = /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.notConfigured });
+  } else if (push.permission === "denied") {
+    state = /* @__PURE__ */ jsx("p", { className: "text-xs text-warning", children: labels.blocked });
+  } else {
+    const busy = push.busy || running !== null;
+    state = /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, "data-push-state": push.subscribed ? "on" : "off", children: push.subscribed ? labels.on : labels.off }),
+      push.foreignSubscription && /* @__PURE__ */ jsx("p", { className: "text-xs text-warning", children: labels.otherAccount }),
+      /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2", children: push.subscribed ? /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(
+          Button,
+          {
+            type: "button",
+            size: "sm",
+            variant: "secondary",
+            commit: COMMIT_EXCEPT_BILLING,
+            pending: running === "test",
+            disabled: busy && running !== "test",
+            onClick: test,
+            children: labels.sendTest
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          Button,
+          {
+            type: "button",
+            size: "sm",
+            variant: "ghost",
+            commit: COMMIT_EXCEPT_BILLING,
+            pending: running === "disable",
+            disabled: busy && running !== "disable",
+            onClick: disable,
+            children: labels.disable
+          }
+        )
+      ] }) : /* @__PURE__ */ jsx(
+        Button,
+        {
+          type: "button",
+          size: "sm",
+          commit: COMMIT_EXCEPT_BILLING,
+          pending: running === "enable",
+          disabled: busy && running !== "enable",
+          onClick: turnOn,
+          children: labels.enable
+        }
+      ) }),
+      outcome?.tone === "status" && /* @__PURE__ */ jsx("p", { role: "status", className: CARD_DESCRIPTION_CLASS, children: outcome.text }),
+      outcome?.tone === "warning" && /* @__PURE__ */ jsx(AlertBanner, { tone: "warning", size: "sm", role: "status", children: outcome.text }),
+      outcome?.tone === "danger" && /* @__PURE__ */ jsx(FailureLine, { children: outcome.text })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs(Card, { ...rest, className: cn("p-4 space-y-3", className), children: [
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(SettingsCardTitle, { children: labels.pushTitle }),
+      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.pushDescription })
+    ] }),
+    state,
+    /* @__PURE__ */ jsx(
+      DialogFrame,
+      {
+        open: explainer,
+        onClose: () => setExplainer(false),
+        title: labels.explainerTitle,
+        description: labels.explainerBody(appName),
+        actions: (close) => /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2", children: [
+          /* @__PURE__ */ jsx(Button, { type: "button", variant: "ghost", onClick: close, children: common.cancel }),
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              onClick: () => {
+                setExplainer(false);
+                enable();
+              },
+              children: labels.explainerContinue
+            }
+          )
+        ] }),
+        children: /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.explainerHint })
+      }
+    )
+  ] });
+}
+export {
+  PushDeviceSetting
+};
+//# sourceMappingURL=push-device-setting.js.map

package/dist/notifications/push-device-setting.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/push-device-setting.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ComponentPropsWithRef, ReactNode } from \"react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_COMMON_LABELS } from \"../i18n/shared-labels\";\nimport { cn } from \"../lib/cn\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { Button } from \"../components/button\";\nimport { Card } from \"../components/card\";\nimport { DialogFrame } from \"../components/dialog-frame\";\nimport { COMMIT_EXCEPT_BILLING } from \"../components/write-lock\";\nimport { CARD_DESCRIPTION_CLASS } from \"../settings/settings-card-classes\";\nimport { SettingsCardTitle } from \"../settings/settings-heading\";\nimport { useMounted } from \"../account/account-parts\";\nimport { describeFailure, FailureLine, useNotificationsLabels } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport { PushDeviceError } from \"./use-push-device\";\nimport type { PushDevice } from \"./use-push-device\";\n\n/** Which action failed — {@link PushDeviceSettingProps.describeError}'s second argument. */\nexport type PushDeviceAction = \"enable\" | \"disable\" | \"test\";\n\nexport interface PushDeviceSettingProps extends Omit<ComponentPropsWithRef<\"div\">, \"children\"> {\n  /** This browser's push, from {@link usePushDevice}. */\n  push: PushDevice;\n  /** The app's name, for the iOS line and the explainer. */\n  appName: string;\n  /** The app's own words for a failure, or `undefined` for the kit's. The kit already\n   *  has words for a missing service worker and an unanswered push service. */\n  describeError?: (error: unknown, action: PushDeviceAction) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/** What the line under the buttons says. */\ntype Outcome = { tone: \"status\" | \"warning\" | \"danger\"; text: ReactNode } | null;\n\n/**\n * Push on THIS device (docs/notifications-harmonization.md §2.2, §2.7, §4.2): keksdose's\n * push block, as a card of its own. Registering the device is the switch — push has no\n * account switch. One state at a time, in keksdose's order\n * (`notifications-card.tsx:333-402`):\n *\n * 1. the browser has no push;\n * 2. iOS outside the installed app (iOS delivers only to the installed app);\n * 3. push is not set up on the server (no VAPID keys);\n * 4. notifications blocked in the browser;\n * 5. on or off — with \"another account\" when this browser's subscription is someone\n *    else's — and \"Turn on notifications\", or \"Send a test\" and \"Turn off\".\n *\n * **The explainer comes before the browser's one prompt**: turning on while the\n * permission is still `\"default\"` opens a dialog first (what the notifications are for,\n * that the browser asks next); with it granted, it goes straight on. A test that reached\n * no device says so (`testNone`) — a 404/410 removes the row on the server while this\n * browser still holds its subscription. Outcomes are a line under the buttons; nothing\n * toasts.\n */\nexport function PushDeviceSetting({\n  push,\n  appName,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: PushDeviceSettingProps) {\n  const labels = useNotificationsLabels(labelsProp);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n  const [explainer, setExplainer] = useState(false);\n  const [running, setRunning] = useState<PushDeviceAction | null>(null);\n  const [outcome, setOutcome] = useState<Outcome>(null);\n  const mounted = useMounted();\n\n  const failureOf = (error: unknown, action: PushDeviceAction, fallback: string): ReactNode => {\n    if (error instanceof PushDeviceError) {\n      return error.code === \"no_service_worker\" ? labels.noServiceWorker : labels.pushTimeout;\n    }\n    return describeFailure(describeError?.(error, action), fallback);\n  };\n\n  const run = <T,>(action: PushDeviceAction, call: () => Promise<T>, done: (value: T) => Outcome, fallback: string) => {\n    if (running) return;\n    setRunning(action);\n    setOutcome(null);\n    call().then(\n      (value) => {\n        if (!mounted.current) return;\n        setRunning(null);\n        setOutcome(done(value));\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        setRunning(null);\n        setOutcome({ tone: \"danger\", text: failureOf(error, action, fallback) });\n      },\n    );\n  };\n\n  const enable = () =>\n    run(\n      \"enable\",\n      () => push.enable(),\n      (ok): Outcome => (ok ? null : { tone: \"danger\", text: labels.enableFailed }),\n      labels.enableFailed,\n    );\n  const disable = () => run(\"disable\", () => push.disable(), () => null, labels.failed);\n  const test = () =>\n    run(\n      \"test\",\n      () => push.sendTest(),\n      ({ sent }): Outcome =>\n        sent > 0 ? { tone: \"status\", text: labels.testSent(sent) } : { tone: \"warning\", text: labels.testNone },\n      labels.testFailed,\n    );\n\n  const turnOn = () => {\n    if (push.permission === \"granted\") enable();\n    else setExplainer(true);\n  };\n\n  let state: ReactNode;\n  if (!push.supported) {\n    state = <p className={CARD_DESCRIPTION_CLASS}>{labels.unsupported}</p>;\n  } else if (push.ios && !push.installed) {\n    state = <p className={CARD_DESCRIPTION_CLASS}>{labels.iosInstall(appName)}</p>;\n  } else if (push.configured === false) {\n    state = <p className={CARD_DESCRIPTION_CLASS}>{labels.notConfigured}</p>;\n  } else if (push.permission === \"denied\") {\n    state = <p className=\"text-xs text-warning\">{labels.blocked}</p>;\n  } else {\n    const busy = push.busy || running !== null;\n    state = (\n      <>\n        <p className={CARD_DESCRIPTION_CLASS} data-push-state={push.subscribed ? \"on\" : \"off\"}>\n          {push.subscribed ? labels.on : labels.off}\n        </p>\n        {push.foreignSubscription && <p className=\"text-xs text-warning\">{labels.otherAccount}</p>}\n        <div className=\"flex flex-wrap gap-2\">\n          {push.subscribed ? (\n            <>\n              <Button\n                type=\"button\"\n                size=\"sm\"\n                variant=\"secondary\"\n                commit={COMMIT_EXCEPT_BILLING}\n                pending={running === \"test\"}\n                disabled={busy && running !== \"test\"}\n                onClick={test}\n              >\n                {labels.sendTest}\n              </Button>\n              <Button\n                type=\"button\"\n                size=\"sm\"\n                variant=\"ghost\"\n                commit={COMMIT_EXCEPT_BILLING}\n                pending={running === \"disable\"}\n                disabled={busy && running !== \"disable\"}\n                onClick={disable}\n              >\n                {labels.disable}\n              </Button>\n            </>\n          ) : (\n            <Button\n              type=\"button\"\n              size=\"sm\"\n              commit={COMMIT_EXCEPT_BILLING}\n              pending={running === \"enable\"}\n              disabled={busy && running !== \"enable\"}\n              onClick={turnOn}\n            >\n              {labels.enable}\n            </Button>\n          )}\n        </div>\n        {outcome?.tone === \"status\" && (\n          <p role=\"status\" className={CARD_DESCRIPTION_CLASS}>\n            {outcome.text}\n          </p>\n        )}\n        {outcome?.tone === \"warning\" && (\n          <AlertBanner tone=\"warning\" size=\"sm\" role=\"status\">\n            {outcome.text}\n          </AlertBanner>\n        )}\n        {outcome?.tone === \"danger\" && <FailureLine>{outcome.text}</FailureLine>}\n      </>\n    );\n  }\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.pushTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.pushDescription}</div>\n      </div>\n      {state}\n      <DialogFrame\n        open={explainer}\n        onClose={() => setExplainer(false)}\n        title={labels.explainerTitle}\n        description={labels.explainerBody(appName)}\n        actions={(close) => (\n          <div className=\"flex justify-end gap-2\">\n            <Button type=\"button\" variant=\"ghost\" onClick={close}>\n              {common.cancel}\n            </Button>\n            <Button\n              type=\"button\"\n              onClick={() => {\n                setExplainer(false);\n                // Only now the browser's one permission prompt.\n                enable();\n              }}\n            >\n              {labels.explainerContinue}\n            </Button>\n          </div>\n        )}\n      >\n        <p className={CARD_DESCRIPTION_CLASS}>{labels.explainerHint}</p>\n      </DialogFrame>\n    </Card>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/notifications/push-devices-setting.d.ts

@@ -0,0 +1,44 @@
+import type { ComponentPropsWithRef, ReactNode } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import type { NotificationsLabels } from "./notifications-labels.js";
+import type { PushDeviceItem } from "./notification-types.js";
+/**
+ * A name for a stored user agent: "Chrome · Android", "Firefox · Windows" (keksdose
+ * `push-devices-card.tsx:19-45`). Best effort: an agent it does not recognise comes back
+ * as it is, cut at 60 characters so a token soup cannot blow up the row; `null` for none.
+ * The order matters — Edge and Opera say "Chrome" too, and Chrome says "Safari".
+ */
+export declare function describeUserAgent(ua: string | null): string | null;
+export interface PushDevicesSettingProps<Id extends string | number = string> extends Omit<ComponentPropsWithRef<"div">, "children"> {
+    /** `GET /notifications/devices`, oldest first; `undefined` while the first load runs. */
+    devices: readonly PushDeviceItem<Id>[] | undefined;
+    loading?: boolean;
+    /** This browser's endpoint (`usePushDevice().currentEndpoint`): its row says "This
+     *  device", and removing it also unsubscribes the browser. */
+    currentEndpoint?: string | null;
+    /** `DELETE /notifications/devices/{id}`. Asked first; refresh `devices` once it
+     *  resolves. */
+    onRemove: (id: Id) => Promise<unknown> | void;
+    /** The dates' text. Default: the provider's locale, medium date. */
+    formatDate?: (date: Date) => string;
+    /** Overrides the provider's locale for the default format. */
+    locale?: string;
+    /** The app's own words for a failed removal, or `undefined` for the kit's `failed`. */
+    describeError?: (error: unknown) => ReactNode | undefined;
+    labels?: LabelOverride<NotificationsLabels>;
+}
+/**
+ * Every device that gets push for the account (docs/notifications-harmonization.md §3.5,
+ * §4.2) — keksdose's devices card: the browser and system read from the stored user
+ * agent, "This device" on this browser's row, when it was added and last delivered to,
+ * the failures in a row in the warning tone, and "Remove".
+ *
+ * **Remove asks first, in the row**, as `PasskeysSetting` does: the card must work in an
+ * app without a `ConfirmProvider`, and the question belongs beside the device it names.
+ * Focus moves to Cancel. **Removing this device** also unsubscribes the browser and fires
+ * `PUSH_SUBSCRIPTION_CHANGED` (keksdose `push-devices-card.tsx:83-97`), so the push card
+ * stops saying "on".
+ *
+ * Under a write lock Remove is a `commit` control exempt from billing.
+ */
+export declare function PushDevicesSetting<Id extends string | number = string>({ devices, loading, currentEndpoint, onRemove, formatDate: formatDateProp, locale: localeProp, describeError, labels: labelsProp, className, ...rest }: PushDevicesSettingProps<Id>): import("react").JSX.Element;

package/dist/notifications/push-devices-setting.js

@@ -0,0 +1,203 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { MonitorSmartphone } from "lucide-react";
+import { useKitLabels, useKitLocale } from "../i18n/kit-labels.js";
+import { DEFAULT_COMMON_LABELS } from "../i18n/shared-labels.js";
+import { cn } from "../lib/cn.js";
+import { formatDate } from "../lib/format.js";
+import { Button } from "../components/button.js";
+import { Card } from "../components/card.js";
+import { Chip } from "../components/chip.js";
+import { Skeleton } from "../components/skeleton.js";
+import { COMMIT_EXCEPT_BILLING } from "../components/write-lock.js";
+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 } from "./notification-parts.js";
+import { notifyPushSubscriptionChanged } from "./use-push-device.js";
+function describeUserAgent(ua) {
+  if (!ua) return null;
+  const browser = /edg(?:e|a|ios)?\//i.test(ua) ? "Edge" : /opr\/|opera/i.test(ua) ? "Opera" : /firefox|fxios/i.test(ua) ? "Firefox" : /chrome|crios/i.test(ua) ? "Chrome" : /safari/i.test(ua) ? "Safari" : null;
+  const os = /windows/i.test(ua) ? "Windows" : /android/i.test(ua) ? "Android" : /iphone|ipad|ipod/i.test(ua) ? "iOS" : /mac os x|macintosh/i.test(ua) ? "macOS" : /linux/i.test(ua) ? "Linux" : null;
+  if (!browser && !os) return ua.length > 60 ? `${ua.slice(0, 60)}\u2026` : ua;
+  return [browser, os].filter(Boolean).join(" \xB7 ");
+}
+async function unsubscribeThisBrowser() {
+  try {
+    const registration = await navigator.serviceWorker?.getRegistration();
+    const subscription = await registration?.pushManager.getSubscription();
+    await subscription?.unsubscribe();
+  } catch {
+  }
+  notifyPushSubscriptionChanged();
+}
+function PushDevicesSetting({
+  devices,
+  loading,
+  currentEndpoint,
+  onRemove,
+  formatDate: formatDateProp,
+  locale: localeProp,
+  describeError,
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useNotificationsLabels(labelsProp);
+  const common = useKitLabels("common", DEFAULT_COMMON_LABELS);
+  const locale = useKitLocale(localeProp);
+  const [asking, setAsking] = useState(null);
+  const [busyId, setBusyId] = useState(null);
+  const [failure, setFailure] = useState(null);
+  const mounted = useMounted();
+  const dateText = (iso) => {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime())) return iso;
+    return formatDateProp ? formatDateProp(date) : formatDate(date, "medium", { locale });
+  };
+  const remove = (device) => {
+    if (busyId !== null) return;
+    setBusyId(device.id);
+    setFailure(null);
+    const isThis = Boolean(currentEndpoint) && device.endpoint === currentEndpoint;
+    settle(() => onRemove(device.id)).then(async () => {
+      if (isThis) await unsubscribeThisBrowser();
+      if (!mounted.current) return;
+      setBusyId(null);
+      setAsking(null);
+    }).catch((error) => {
+      if (!mounted.current) return;
+      setBusyId(null);
+      setFailure(describeFailure(describeError?.(error), labels.failed));
+    });
+  };
+  let body;
+  if (loading || devices === void 0) {
+    body = /* @__PURE__ */ jsx(Skeleton, { lines: 2, label: labels.devicesLoading });
+  } else if (devices.length === 0) {
+    body = /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.devicesEmpty });
+  } else {
+    body = /* @__PURE__ */ jsx("ul", { "aria-label": labels.devicesTitle, className: "divide-y divide-subtle", children: devices.map((device) => /* @__PURE__ */ jsx(
+      DeviceRow,
+      {
+        device,
+        name: describeUserAgent(device.user_agent) ?? labels.unknownDevice,
+        current: Boolean(currentEndpoint) && device.endpoint === currentEndpoint,
+        added: dateText(device.created_at),
+        lastDelivery: device.last_success_at ? dateText(device.last_success_at) : null,
+        asking: asking === device.id,
+        busy: busyId === device.id,
+        blocked: busyId !== null && busyId !== device.id,
+        onAsk: () => setAsking(device.id),
+        onCancel: () => setAsking(null),
+        onConfirm: () => remove(device),
+        labels,
+        cancelLabel: common.cancel
+      },
+      device.id
+    )) });
+  }
+  return /* @__PURE__ */ jsxs(Card, { ...rest, className: cn("p-4 space-y-3", className), children: [
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(SettingsCardTitle, { children: labels.devicesTitle }),
+      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.devicesDescription })
+    ] }),
+    body,
+    /* @__PURE__ */ jsx(FailureLine, { children: failure })
+  ] });
+}
+function DeviceRow({
+  device,
+  name,
+  current,
+  added,
+  lastDelivery,
+  asking,
+  busy,
+  blocked,
+  onAsk,
+  onCancel,
+  onConfirm,
+  labels,
+  cancelLabel
+}) {
+  const cancelRef = useRef(null);
+  const removeRef = useRef(null);
+  const [returning, setReturning] = useState(false);
+  useEffect(() => {
+    if (asking) cancelRef.current?.focus();
+    else if (returning) removeRef.current?.focus();
+  }, [asking, returning]);
+  const leave = () => {
+    setReturning(true);
+    onCancel();
+  };
+  const escapeLeaves = (event) => {
+    if (event.key === "Escape") {
+      event.preventDefault();
+      event.stopPropagation();
+      leave();
+    }
+  };
+  const row = { "data-push-device-id": String(device.id), "data-current": current || void 0 };
+  if (asking) {
+    return /* @__PURE__ */ jsxs("li", { ...row, className: "space-y-2 py-2", children: [
+      /* @__PURE__ */ jsx("p", { role: "alert", className: "text-sm", children: labels.removePrompt }),
+      /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-2", children: [
+        /* @__PURE__ */ jsx(
+          Button,
+          {
+            type: "button",
+            size: "sm",
+            variant: "danger",
+            commit: COMMIT_EXCEPT_BILLING,
+            pending: busy,
+            "aria-label": labels.removeItem(name),
+            onClick: onConfirm,
+            onKeyDown: escapeLeaves,
+            children: labels.remove
+          }
+        ),
+        /* @__PURE__ */ jsx(Button, { ref: cancelRef, type: "button", size: "sm", variant: "ghost", onClick: leave, onKeyDown: escapeLeaves, children: cancelLabel })
+      ] })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs("li", { ...row, className: "flex items-center gap-3 py-2", children: [
+    /* @__PURE__ */ jsx(MonitorSmartphone, { "aria-hidden": true, className: "size-4 shrink-0 text-muted" }),
+    /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+      /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-2 gap-y-1", children: [
+        /* @__PURE__ */ jsx("span", { className: "min-w-0 break-words text-sm font-medium", children: name }),
+        current && /* @__PURE__ */ jsx(Chip, { size: "sm", tone: "brand", children: labels.thisDevice })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: CARD_DESCRIPTION_CLASS, children: [
+        labels.added(added),
+        " \xB7 ",
+        lastDelivery ? labels.lastDelivery(lastDelivery) : labels.noDelivery
+      ] }),
+      device.failure_count > 0 && /* @__PURE__ */ jsx("div", { className: "text-xs text-warning", children: labels.failures(device.failure_count) })
+    ] }),
+    /* @__PURE__ */ jsx(
+      Button,
+      {
+        ref: removeRef,
+        type: "button",
+        size: "sm",
+        variant: "ghost",
+        commit: COMMIT_EXCEPT_BILLING,
+        disabled: blocked,
+        "aria-label": labels.removeItem(name),
+        onClick: () => {
+          setReturning(false);
+          onAsk();
+        },
+        children: labels.remove
+      }
+    )
+  ] });
+}
+export {
+  PushDevicesSetting,
+  describeUserAgent
+};
+//# sourceMappingURL=push-devices-setting.js.map

package/dist/notifications/push-devices-setting.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/push-devices-setting.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport type { ComponentPropsWithRef, KeyboardEvent, ReactNode } from \"react\";\nimport { MonitorSmartphone } from \"lucide-react\";\n\nimport { useKitLabels, useKitLocale, type LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_COMMON_LABELS } from \"../i18n/shared-labels\";\nimport { cn } from \"../lib/cn\";\nimport { formatDate } from \"../lib/format\";\nimport { Button } from \"../components/button\";\nimport { Card } from \"../components/card\";\nimport { Chip } from \"../components/chip\";\nimport { Skeleton } from \"../components/skeleton\";\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 } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type { PushDeviceItem } from \"./notification-types\";\nimport { notifyPushSubscriptionChanged } from \"./use-push-device\";\n\n/**\n * A name for a stored user agent: \"Chrome · Android\", \"Firefox · Windows\" (keksdose\n * `push-devices-card.tsx:19-45`). Best effort: an agent it does not recognise comes back\n * as it is, cut at 60 characters so a token soup cannot blow up the row; `null` for none.\n * The order matters — Edge and Opera say \"Chrome\" too, and Chrome says \"Safari\".\n */\nexport function describeUserAgent(ua: string | null): string | null {\n  if (!ua) return null;\n  const browser = /edg(?:e|a|ios)?\\//i.test(ua)\n    ? \"Edge\"\n    : /opr\\/|opera/i.test(ua)\n      ? \"Opera\"\n      : /firefox|fxios/i.test(ua)\n        ? \"Firefox\"\n        : /chrome|crios/i.test(ua)\n          ? \"Chrome\"\n          : /safari/i.test(ua)\n            ? \"Safari\"\n            : null;\n  const os = /windows/i.test(ua)\n    ? \"Windows\"\n    : /android/i.test(ua)\n      ? \"Android\"\n      : /iphone|ipad|ipod/i.test(ua)\n        ? \"iOS\"\n        : /mac os x|macintosh/i.test(ua)\n          ? \"macOS\"\n          : /linux/i.test(ua)\n            ? \"Linux\"\n            : null;\n  if (!browser && !os) return ua.length > 60 ? `${ua.slice(0, 60)}…` : ua;\n  return [browser, os].filter(Boolean).join(\" · \");\n}\n\nexport interface PushDevicesSettingProps<Id extends string | number = string>\n  extends Omit<ComponentPropsWithRef<\"div\">, \"children\"> {\n  /** `GET /notifications/devices`, oldest first; `undefined` while the first load runs. */\n  devices: readonly PushDeviceItem<Id>[] | undefined;\n  loading?: boolean;\n  /** This browser's endpoint (`usePushDevice().currentEndpoint`): its row says \"This\n   *  device\", and removing it also unsubscribes the browser. */\n  currentEndpoint?: string | null;\n  /** `DELETE /notifications/devices/{id}`. Asked first; refresh `devices` once it\n   *  resolves. */\n  onRemove: (id: Id) => Promise<unknown> | void;\n  /** The dates' text. Default: the provider's locale, medium date. */\n  formatDate?: (date: Date) => string;\n  /** Overrides the provider's locale for the default format. */\n  locale?: string;\n  /** The app's own words for a failed removal, or `undefined` for the kit's `failed`. */\n  describeError?: (error: unknown) => ReactNode | undefined;\n  labels?: LabelOverride<NotificationsLabels>;\n}\n\n/** Tear down this browser's subscription after its server row went: otherwise the\n *  browser still holds one, and the push card would say \"on\" for a device nothing can\n *  reach. Best effort — the row is already gone. */\nasync function unsubscribeThisBrowser(): Promise<void> {\n  try {\n    const registration = await navigator.serviceWorker?.getRegistration();\n    const subscription = await registration?.pushManager.getSubscription();\n    await subscription?.unsubscribe();\n  } catch {\n    /* the server row is gone either way */\n  }\n  notifyPushSubscriptionChanged();\n}\n\n/**\n * Every device that gets push for the account (docs/notifications-harmonization.md §3.5,\n * §4.2) — keksdose's devices card: the browser and system read from the stored user\n * agent, \"This device\" on this browser's row, when it was added and last delivered to,\n * the failures in a row in the warning tone, and \"Remove\".\n *\n * **Remove asks first, in the row**, as `PasskeysSetting` does: the card must work in an\n * app without a `ConfirmProvider`, and the question belongs beside the device it names.\n * Focus moves to Cancel. **Removing this device** also unsubscribes the browser and fires\n * `PUSH_SUBSCRIPTION_CHANGED` (keksdose `push-devices-card.tsx:83-97`), so the push card\n * stops saying \"on\".\n *\n * Under a write lock Remove is a `commit` control exempt from billing.\n */\nexport function PushDevicesSetting<Id extends string | number = string>({\n  devices,\n  loading,\n  currentEndpoint,\n  onRemove,\n  formatDate: formatDateProp,\n  locale: localeProp,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: PushDevicesSettingProps<Id>) {\n  const labels = useNotificationsLabels(labelsProp);\n  const common = useKitLabels(\"common\", DEFAULT_COMMON_LABELS);\n  const locale = useKitLocale(localeProp);\n  const [asking, setAsking] = useState<Id | null>(null);\n  const [busyId, setBusyId] = useState<Id | null>(null);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n\n  const dateText = (iso: string): string => {\n    const date = new Date(iso);\n    if (Number.isNaN(date.getTime())) return iso;\n    return formatDateProp ? formatDateProp(date) : formatDate(date, \"medium\", { locale });\n  };\n\n  const remove = (device: PushDeviceItem<Id>) => {\n    if (busyId !== null) return;\n    setBusyId(device.id);\n    setFailure(null);\n    const isThis = Boolean(currentEndpoint) && device.endpoint === currentEndpoint;\n    settle(() => onRemove(device.id))\n      .then(async () => {\n        if (isThis) await unsubscribeThisBrowser();\n        if (!mounted.current) return;\n        setBusyId(null);\n        setAsking(null);\n      })\n      .catch((error: unknown) => {\n        if (!mounted.current) return;\n        setBusyId(null);\n        setFailure(describeFailure(describeError?.(error), labels.failed));\n      });\n  };\n\n  let body: ReactNode;\n  if (loading || devices === undefined) {\n    body = <Skeleton lines={2} label={labels.devicesLoading} />;\n  } else if (devices.length === 0) {\n    body = <p className={CARD_DESCRIPTION_CLASS}>{labels.devicesEmpty}</p>;\n  } else {\n    body = (\n      <ul aria-label={labels.devicesTitle} className=\"divide-y divide-subtle\">\n        {devices.map((device) => (\n          <DeviceRow\n            key={device.id}\n            device={device}\n            name={describeUserAgent(device.user_agent) ?? labels.unknownDevice}\n            current={Boolean(currentEndpoint) && device.endpoint === currentEndpoint}\n            added={dateText(device.created_at)}\n            lastDelivery={device.last_success_at ? dateText(device.last_success_at) : null}\n            asking={asking === device.id}\n            busy={busyId === device.id}\n            blocked={busyId !== null && busyId !== device.id}\n            onAsk={() => setAsking(device.id)}\n            onCancel={() => setAsking(null)}\n            onConfirm={() => remove(device)}\n            labels={labels}\n            cancelLabel={common.cancel}\n          />\n        ))}\n      </ul>\n    );\n  }\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.devicesTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.devicesDescription}</div>\n      </div>\n      {body}\n      <FailureLine>{failure}</FailureLine>\n    </Card>\n  );\n}\n\nfunction DeviceRow<Id extends string | number>({\n  device,\n  name,\n  current,\n  added,\n  lastDelivery,\n  asking,\n  busy,\n  blocked,\n  onAsk,\n  onCancel,\n  onConfirm,\n  labels,\n  cancelLabel,\n}: {\n  device: PushDeviceItem<Id>;\n  name: string;\n  current: boolean;\n  added: string;\n  lastDelivery: string | null;\n  asking: boolean;\n  busy: boolean;\n  blocked: boolean;\n  onAsk: () => void;\n  onCancel: () => void;\n  onConfirm: () => void;\n  labels: NotificationsLabels;\n  cancelLabel: string;\n}) {\n  const cancelRef = useRef<HTMLButtonElement>(null);\n  const removeRef = useRef<HTMLButtonElement>(null);\n  // Which way the confirm closed: back to Remove, so focus does not fall to <body>.\n  const [returning, setReturning] = useState(false);\n  useEffect(() => {\n    if (asking) cancelRef.current?.focus();\n    else if (returning) removeRef.current?.focus();\n  }, [asking, returning]);\n\n  const leave = () => {\n    setReturning(true);\n    onCancel();\n  };\n  const escapeLeaves = (event: KeyboardEvent<HTMLButtonElement>) => {\n    if (event.key === \"Escape\") {\n      event.preventDefault();\n      event.stopPropagation();\n      leave();\n    }\n  };\n\n  const row = { \"data-push-device-id\": String(device.id), \"data-current\": current || undefined };\n\n  if (asking) {\n    return (\n      <li {...row} className=\"space-y-2 py-2\">\n        <p role=\"alert\" className=\"text-sm\">\n          {labels.removePrompt}\n        </p>\n        <div className=\"flex flex-wrap gap-2\">\n          <Button\n            type=\"button\"\n            size=\"sm\"\n            variant=\"danger\"\n            commit={COMMIT_EXCEPT_BILLING}\n            pending={busy}\n            aria-label={labels.removeItem(name)}\n            onClick={onConfirm}\n            onKeyDown={escapeLeaves}\n          >\n            {labels.remove}\n          </Button>\n          <Button ref={cancelRef} type=\"button\" size=\"sm\" variant=\"ghost\" onClick={leave} onKeyDown={escapeLeaves}>\n            {cancelLabel}\n          </Button>\n        </div>\n      </li>\n    );\n  }\n\n  return (\n    <li {...row} className=\"flex items-center gap-3 py-2\">\n      <MonitorSmartphone aria-hidden className=\"size-4 shrink-0 text-muted\" />\n      <div className=\"min-w-0 flex-1\">\n        <div className=\"flex flex-wrap items-center gap-x-2 gap-y-1\">\n          <span className=\"min-w-0 break-words text-sm font-medium\">{name}</span>\n          {current && (\n            <Chip size=\"sm\" tone=\"brand\">\n              {labels.thisDevice}\n            </Chip>\n          )}\n        </div>\n        <div className={CARD_DESCRIPTION_CLASS}>\n          {labels.added(added)}\n          {\" · \"}\n          {lastDelivery ? labels.lastDelivery(lastDelivery) : labels.noDelivery}\n        </div>\n        {device.failure_count > 0 && <div className=\"text-xs text-warning\">{labels.failures(device.failure_count)}</div>}\n      </div>\n      <Button\n        ref={removeRef}\n        type=\"button\"\n        size=\"sm\"\n        variant=\"ghost\"\n        commit={COMMIT_EXCEPT_BILLING}\n        disabled={blocked}\n        aria-label={labels.removeItem(name)}\n        onClick={() => {\n          setReturning(false);\n          onAsk();\n        }}\n      >\n        {labels.remove}\n      </Button>\n    </li>\n  );\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,47 @@
+import type { ComponentPropsWithRef, ReactNode } from "react";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { NotificationsLabels } from "./notifications-labels.js";
+import type { NotificationSettingsPatch } from "./notification-types.js";
+export interface QuietHoursSettingProps extends Omit<ComponentPropsWithRef<"div">, "children" | "onChange"> {
+    /** The `GET`'s `quiet_hours_start`, `"HH:MM"`, or `null`. */
+    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;
+    /**
+     * 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
+     * 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). */
+    fallbackZone?: string;
+    /** The app keeps an inbox, and the description says a held push still reaches it. */
+    inbox?: boolean;
+    disabled?: boolean;
+    /** The app's own words for a failed save, or `undefined` for the kit's `failed`. */
+    describeError?: (error: unknown) => ReactNode | undefined;
+    labels?: LabelOverride<NotificationsLabels>;
+}
+/**
+ * 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.
+ *
+ * - **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).
+ *
+ * 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;