@eifi1/ui-kit 0.35.0 → 0.37.0

package/dist/notifications/notification-parts.js

@@ -0,0 +1,47 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { hasContent } from "../lib/presence.js";
+import { AlertBanner } from "../components/alert-banner.js";
+import { DEFAULT_NOTIFICATIONS_LABELS } from "./notifications-labels.js";
+function useNotificationsLabels(prop) {
+  return useKitLabels("notifications", DEFAULT_NOTIFICATIONS_LABELS, prop);
+}
+function describeFailure(own, fallback) {
+  return hasContent(own) ? own : fallback;
+}
+function FailureLine({ children }) {
+  if (!hasContent(children)) return null;
+  return /* @__PURE__ */ jsx(AlertBanner, { tone: "danger", size: "sm", role: "alert", children });
+}
+function useWriteOverlay(source) {
+  const [entries, setEntries] = useState(/* @__PURE__ */ new Map());
+  const [seen, setSeen] = useState(source);
+  if (seen !== source) {
+    setSeen(source);
+    const kept = new Map([...entries].filter(([, entry]) => entry.running));
+    if (kept.size !== entries.size) setEntries(kept);
+  }
+  return {
+    has: (key) => entries.has(key),
+    get: (key) => entries.get(key)?.value,
+    pending: (key) => entries.get(key)?.running === true,
+    set: (key, value) => setEntries((current) => new Map(current).set(key, { value, running: true })),
+    settle: (key, ok) => setEntries((current) => {
+      const entry = current.get(key);
+      if (!entry) return current;
+      const next = new Map(current);
+      if (ok) next.set(key, { value: entry.value, running: false });
+      else next.delete(key);
+      return next;
+    })
+  };
+}
+export {
+  FailureLine,
+  describeFailure,
+  useNotificationsLabels,
+  useWriteOverlay
+};
+//# sourceMappingURL=notification-parts.js.map

package/dist/notifications/notification-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/notification-parts.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\n\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { hasContent } from \"../lib/presence\";\nimport { AlertBanner } from \"../components/alert-banner\";\nimport { DEFAULT_NOTIFICATIONS_LABELS } from \"./notifications-labels\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\n\n/**\n * What the notification cards share: their words, the failure line under a card, and\n * the overlay a card shows while its write runs.\n *\n * @internal Not part of the barrel; the cards are.\n */\n\n/** The `notifications` namespace: English, then the provider, then the card's prop. */\nexport function useNotificationsLabels(prop?: LabelOverride<NotificationsLabels>): NotificationsLabels {\n  return useKitLabels(\"notifications\", DEFAULT_NOTIFICATIONS_LABELS, prop);\n}\n\n/** The app's words for a failure, else `fallback`. */\nexport function describeFailure(own: ReactNode | undefined, fallback: ReactNode): ReactNode {\n  return hasContent(own) ? own : fallback;\n}\n\n/** A failure, said under the card's controls — nothing toasts (§4.2). */\nexport function FailureLine({ children }: { children: ReactNode }) {\n  if (!hasContent(children)) return null;\n  return (\n    <AlertBanner tone=\"danger\" size=\"sm\" role=\"alert\">\n      {children}\n    </AlertBanner>\n  );\n}\n\n/** What {@link useWriteOverlay} answers. */\nexport interface WriteOverlay<V> {\n  has: (key: string) => boolean;\n  get: (key: string) => V | undefined;\n  pending: (key: string) => boolean;\n  set: (key: string, value: V) => void;\n  settle: (key: string, ok: boolean) => void;\n}\n\n/**\n * Values a card shows while its write runs, over what the server last answered.\n *\n * `set(key, value)` shows `value` at once; `settle(key, ok)` drops it again when the\n * write failed (the server's value comes back) and keeps it when it succeeded, until the\n * app hands the card a new `source` — the PATCH's answer, or a refetch — which clears\n * every settled entry, so a card whose app does not update its query on success does not\n * flick back to the old value in between. `pending(key)` says whether a write for `key`\n * is still running.\n *\n * The reset on a new `source` is React's \"adjust state while rendering\" pattern, not an\n * effect: the overlay is gone in the same render that shows the new value.\n */\nexport function useWriteOverlay<V>(source: unknown): WriteOverlay<V> {\n  const [entries, setEntries] = useState<ReadonlyMap<string, { value: V; running: boolean }>>(new Map());\n  const [seen, setSeen] = useState(source);\n  if (seen !== source) {\n    setSeen(source);\n    const kept = new Map([...entries].filter(([, entry]) => entry.running));\n    if (kept.size !== entries.size) setEntries(kept);\n  }\n  return {\n    has: (key: string) => entries.has(key),\n    get: (key: string) => entries.get(key)?.value,\n    pending: (key: string) => entries.get(key)?.running === true,\n    set: (key: string, value: V) =>\n      setEntries((current) => new Map(current).set(key, { value, running: true })),\n    settle: (key: string, ok: boolean) =>\n      setEntries((current) => {\n        const entry = current.get(key);\n        if (!entry) return current;\n        const next = new Map(current);\n        if (ok) next.set(key, { value: entry.value, running: false });\n        else next.delete(key);\n        return next;\n      }),\n  };\n}\n"],"mappings":";AA8BI;AA9BJ,SAAS,gBAAgB;AAGzB,SAAS,oBAAwC;AACjD,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,oCAAoC;AAWtC,SAAS,uBAAuB,MAAgE;AACrG,SAAO,aAAa,iBAAiB,8BAA8B,IAAI;AACzE;AAGO,SAAS,gBAAgB,KAA4B,UAAgC;AAC1F,SAAO,WAAW,GAAG,IAAI,MAAM;AACjC;AAGO,SAAS,YAAY,EAAE,SAAS,GAA4B;AACjE,MAAI,CAAC,WAAW,QAAQ,EAAG,QAAO;AAClC,SACE,oBAAC,eAAY,MAAK,UAAS,MAAK,MAAK,MAAK,SACvC,UACH;AAEJ;AAwBO,SAAS,gBAAmB,QAAkC;AACnE,QAAM,CAAC,SAAS,UAAU,IAAI,SAA8D,oBAAI,IAAI,CAAC;AACrG,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,MAAM;AACvC,MAAI,SAAS,QAAQ;AACnB,YAAQ,MAAM;AACd,UAAM,OAAO,IAAI,IAAI,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,MAAM,OAAO,CAAC;AACtE,QAAI,KAAK,SAAS,QAAQ,KAAM,YAAW,IAAI;AAAA,EACjD;AACA,SAAO;AAAA,IACL,KAAK,CAAC,QAAgB,QAAQ,IAAI,GAAG;AAAA,IACrC,KAAK,CAAC,QAAgB,QAAQ,IAAI,GAAG,GAAG;AAAA,IACxC,SAAS,CAAC,QAAgB,QAAQ,IAAI,GAAG,GAAG,YAAY;AAAA,IACxD,KAAK,CAAC,KAAa,UACjB,WAAW,CAAC,YAAY,IAAI,IAAI,OAAO,EAAE,IAAI,KAAK,EAAE,OAAO,SAAS,KAAK,CAAC,CAAC;AAAA,IAC7E,QAAQ,CAAC,KAAa,OACpB,WAAW,CAAC,YAAY;AACtB,YAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,UAAI,CAAC,MAAO,QAAO;AACnB,YAAM,OAAO,IAAI,IAAI,OAAO;AAC5B,UAAI,GAAI,MAAK,IAAI,KAAK,EAAE,OAAO,MAAM,OAAO,SAAS,MAAM,CAAC;AAAA,UACvD,MAAK,OAAO,GAAG;AACpB,aAAO;AAAA,IACT,CAAC;AAAA,EACL;AACF;","names":[]}

package/dist/notifications/notification-types-setting.d.ts

@@ -0,0 +1,62 @@
+import type { ComponentPropsWithRef, ReactNode } from "react";
+import type { LabelOverride } from "../i18n/kit-labels.js";
+import type { NotificationsLabels } from "./notifications-labels.js";
+import type { DigestCadence, NotificationSettingsPatch, NotificationTypeEntry, NotificationTypeGroup, NotificationTypesValue } from "./notification-types.js";
+export interface NotificationTypesSettingProps<Id extends string = string> extends Omit<ComponentPropsWithRef<"div">, "children" | "onChange"> {
+    /** The app's words for its types, in its order. Where an app types its ids. */
+    types: readonly NotificationTypeEntry<Id>[];
+    /** The `GET`'s `types` (§3.2); `undefined` while the first load runs. */
+    value: NotificationTypesValue | undefined;
+    /** The settings are loading. */
+    loading?: boolean;
+    /**
+     * Save one change — `PATCH /notifications/settings` with this body: one switch per
+     * call (`{types: {digest: {app: true}}}`), or `{digest_cadence}`. The switch shows its
+     * new state while the call runs and goes back if it rejects; hand the card the
+     * PATCH's answer (or refetch) when it resolves.
+     */
+    onChange: (patch: NotificationSettingsPatch<Id>) => Promise<unknown> | void;
+    /** Headings over the types, in the app's words (keksdose's three). Without them, one
+     *  list in the order of `types`. In development every type the server answered must
+     *  be in one. */
+    groups?: readonly NotificationTypeGroup<Id>[];
+    /** The digest type and the account's cadence: a cadence `Select` under that type
+     *  while it is on. */
+    digest?: {
+        type: Id;
+        cadence: DigestCadence;
+    };
+    /** Under a type while it is on — keksdose's low-balance threshold field. */
+    renderExtra?: (id: Id) => ReactNode;
+    /** The account's address is unverified: every e-mail switch says
+     *  `labels.emailUnverified` under it (decision 16). */
+    emailUnverified?: boolean;
+    /** Nothing can be changed (the switches stay readable). */
+    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>;
+}
+/**
+ * What the person hears about, and how (docs/notifications-harmonization.md §2.1–§2.3,
+ * §4.2): one row per type the SERVER answered, the app's words on it, a switch for "in
+ * the app" and "By e-mail" under it where the type offers mail. Where the app has no
+ * "in the app" channel (Kurvenschmiede), the e-mail switch is the row's own, with the
+ * type's label.
+ *
+ * **The server's list is the only list.** The card keeps no defaults and no list of
+ * types: it draws what `value` holds, in the order of `groups`, else of `types`. A type
+ * the app names that the server did not answer is not drawn (kastlan's tenant receives
+ * neither of its types). In development a type the server answered with no entry in
+ * `types`, or in no group when `groups` is given, throws — keksdose's compile-time
+ * `_EVERY_TYPE_IS_GROUPED`, now at run time, since the list is the server's.
+ *
+ * **Each flip saves at once**, one switch per call; the switch shows its new state while
+ * the call runs and goes back if it rejects, with the failure said under the card. The
+ * digest's cadence and the app's extra field (`renderExtra`) show under their type while
+ * it is on.
+ *
+ * Under a write lock the switches are `commit` controls exempt from billing: a lapsed
+ * plan never keeps a person from turning notifications off (billing §12.13).
+ */
+export declare function NotificationTypesSetting<Id extends string = string>({ types, value, loading, onChange, groups, digest, renderExtra, emailUnverified, disabled, describeError, labels: labelsProp, className, ...rest }: NotificationTypesSettingProps<Id>): import("react").JSX.Element;

package/dist/notifications/notification-types-setting.js

@@ -0,0 +1,192 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useId, useState } from "react";
+import { cn } from "../lib/cn.js";
+import { hasContent } from "../lib/presence.js";
+import { Card } from "../components/card.js";
+import { Select } from "../components/select.js";
+import { Skeleton } from "../components/skeleton.js";
+import { Switch } from "../components/switch.js";
+import { SectionLabel } from "../components/text.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, useWriteOverlay } from "./notification-parts.js";
+function devChecks() {
+  return Boolean(import.meta.env?.DEV);
+}
+const switchKey = (id, channel) => `${id}.${channel}`;
+const CADENCE_KEY = "digest_cadence";
+function NotificationTypesSetting({
+  types,
+  value,
+  loading,
+  onChange,
+  groups,
+  digest,
+  renderExtra,
+  emailUnverified = false,
+  disabled = false,
+  describeError,
+  labels: labelsProp,
+  className,
+  ...rest
+}) {
+  const labels = useNotificationsLabels(labelsProp);
+  const overlay = useWriteOverlay(value);
+  const cadenceOverlay = useWriteOverlay(digest?.cadence);
+  const [failure, setFailure] = useState(null);
+  const mounted = useMounted();
+  const groupId = useId();
+  const answered = value ? Object.keys(value) : [];
+  const entries = new Map(types.map((entry) => [entry.id, entry]));
+  if (value && devChecks()) {
+    const unnamed = answered.filter((id) => !entries.has(id));
+    if (unnamed.length) {
+      throw new Error(
+        `NotificationTypesSetting: the server answered ${unnamed.map((id) => `"${id}"`).join(", ")} with no entry in \`types\` \u2014 give every type the server can send its words.`
+      );
+    }
+    if (groups) {
+      const grouped = new Set(groups.flatMap((group) => group.types));
+      const loose = answered.filter((id) => !grouped.has(id));
+      if (loose.length) {
+        throw new Error(
+          `NotificationTypesSetting: ${loose.map((id) => `"${id}"`).join(", ")} is in no group \u2014 a type in no group is drawn nowhere, and could not be turned off.`
+        );
+      }
+    }
+  }
+  const rowOf = (id) => {
+    const switches = value?.[id];
+    const entry = entries.get(id);
+    if (!switches || !entry || switches.app === null && switches.email === null) return null;
+    return { entry, switches };
+  };
+  const rowsOf = (ids) => ids.map(rowOf).filter((row) => row !== null);
+  const shown = (id, channel, server) => {
+    const key = switchKey(id, channel);
+    return overlay.get(key) ?? server;
+  };
+  const rowOn = ({ entry, switches }) => switches.app !== null ? shown(entry.id, "app", switches.app) : shown(entry.id, "email", switches.email === true);
+  const save = (key, patch, which, next) => {
+    if (which.pending(key)) return;
+    setFailure(null);
+    which.set(key, next);
+    settle(() => onChange(patch)).then(
+      () => {
+        if (mounted.current) which.settle(key, true);
+      },
+      (error) => {
+        if (!mounted.current) return;
+        which.settle(key, false);
+        setFailure(describeFailure(describeError?.(error), labels.failed));
+      }
+    );
+  };
+  const flip = (id, channel, on) => save(
+    switchKey(id, channel),
+    { types: { [id]: { [channel]: on } } },
+    overlay,
+    on
+  );
+  const cadence = cadenceOverlay.get(CADENCE_KEY) ?? digest?.cadence;
+  const unverifiedLine = emailUnverified ? /* @__PURE__ */ jsx("span", { className: "block", "data-email-unverified": "", children: labels.emailUnverified }) : null;
+  const renderRow = (row) => {
+    const { entry, switches } = row;
+    const on = rowOn(row);
+    const emailOnly = switches.app === null;
+    const both = !emailOnly && switches.email !== null;
+    const cadenceSelect = on && digest?.type === entry.id && cadence ? /* @__PURE__ */ jsxs(
+      Select,
+      {
+        label: labels.digestCadence,
+        value: cadence,
+        disabled,
+        commit: COMMIT_EXCEPT_BILLING,
+        onChange: (event) => {
+          const next = event.target.value;
+          if (next !== cadence) save(CADENCE_KEY, { digest_cadence: next }, cadenceOverlay, next);
+        },
+        className: "max-w-44",
+        children: [
+          /* @__PURE__ */ jsx("option", { value: "weekly", children: labels.digestWeekly }),
+          /* @__PURE__ */ jsx("option", { value: "monthly", children: labels.digestMonthly })
+        ]
+      }
+    ) : null;
+    const extra = on ? renderExtra?.(entry.id) : null;
+    const description = emailOnly && unverifiedLine ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      entry.description !== void 0 && /* @__PURE__ */ jsx("span", { className: "block", children: entry.description }),
+      unverifiedLine
+    ] }) : entry.description;
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        "data-notification-type": entry.id,
+        role: both ? "group" : void 0,
+        "aria-label": both ? entry.label : void 0,
+        className: "space-y-2",
+        children: [
+          /* @__PURE__ */ jsx(
+            Switch,
+            {
+              label: entry.label,
+              description,
+              checked: on,
+              disabled,
+              commit: COMMIT_EXCEPT_BILLING,
+              onCheckedChange: (next) => flip(entry.id, emailOnly ? "email" : "app", next)
+            }
+          ),
+          both && /* @__PURE__ */ jsx("div", { className: "ps-4", children: /* @__PURE__ */ jsx(
+            Switch,
+            {
+              size: "sm",
+              label: labels.byEmail,
+              description: unverifiedLine ?? void 0,
+              checked: shown(entry.id, "email", switches.email === true),
+              disabled,
+              commit: COMMIT_EXCEPT_BILLING,
+              onCheckedChange: (next) => flip(entry.id, "email", next)
+            }
+          ) }),
+          (cadenceSelect || hasContent(extra)) && /* @__PURE__ */ jsxs("div", { className: "ps-4 space-y-2", children: [
+            cadenceSelect,
+            extra
+          ] })
+        ]
+      },
+      entry.id
+    );
+  };
+  let body;
+  if (loading || value === void 0) {
+    body = /* @__PURE__ */ jsx(Skeleton, { lines: 3, label: labels.typesLoading });
+  } else if (groups) {
+    const drawn = groups.map((group) => ({ group, rows: rowsOf(group.types) })).filter(({ rows }) => rows.length > 0);
+    body = drawn.length === 0 ? /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.typesEmpty }) : drawn.map(({ group, rows }) => {
+      const headingId = `${groupId}-${group.id}`;
+      return /* @__PURE__ */ jsxs("div", { role: "group", "aria-labelledby": headingId, className: "space-y-3", children: [
+        /* @__PURE__ */ jsx(SectionLabel, { as: "div", size: "xs", id: headingId, children: group.label }),
+        rows.map(renderRow)
+      ] }, group.id);
+    });
+  } else {
+    const rows = rowsOf(types.map((entry) => entry.id));
+    body = rows.length === 0 ? /* @__PURE__ */ jsx("p", { className: CARD_DESCRIPTION_CLASS, children: labels.typesEmpty }) : /* @__PURE__ */ jsx("div", { className: "space-y-3", children: rows.map(renderRow) });
+  }
+  return /* @__PURE__ */ jsxs(Card, { ...rest, className: cn("p-4 space-y-3", className), children: [
+    /* @__PURE__ */ jsxs("div", { children: [
+      /* @__PURE__ */ jsx(SettingsCardTitle, { children: labels.typesTitle }),
+      /* @__PURE__ */ jsx("div", { className: CARD_DESCRIPTION_CLASS, children: labels.typesDescription })
+    ] }),
+    body,
+    /* @__PURE__ */ jsx(FailureLine, { children: failure })
+  ] });
+}
+export {
+  NotificationTypesSetting
+};
+//# sourceMappingURL=notification-types-setting.js.map

package/dist/notifications/notification-types-setting.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/notifications/notification-types-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 { hasContent } from \"../lib/presence\";\nimport { Card } from \"../components/card\";\nimport { Select } from \"../components/select\";\nimport { Skeleton } from \"../components/skeleton\";\nimport { Switch } from \"../components/switch\";\nimport { SectionLabel } from \"../components/text\";\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 { WriteOverlay } from \"./notification-parts\";\nimport type { NotificationsLabels } from \"./notifications-labels\";\nimport type {\n  DigestCadence,\n  NotificationSettingsPatch,\n  NotificationSwitches,\n  NotificationTypeEntry,\n  NotificationTypeGroup,\n  NotificationTypesValue,\n} from \"./notification-types\";\n\n/** Is this a development build? Dead code in a consumer's production bundle; on under\n *  vitest, where a type the card cannot draw is a bug a test should fail on (as\n *  `SettingsSection`'s catalogue check). */\nfunction devChecks(): boolean {\n  return Boolean(import.meta.env?.DEV);\n}\n\nexport interface NotificationTypesSettingProps<Id extends string = string>\n  extends Omit<ComponentPropsWithRef<\"div\">, \"children\" | \"onChange\"> {\n  /** The app's words for its types, in its order. Where an app types its ids. */\n  types: readonly NotificationTypeEntry<Id>[];\n  /** The `GET`'s `types` (§3.2); `undefined` while the first load runs. */\n  value: NotificationTypesValue | undefined;\n  /** The settings are loading. */\n  loading?: boolean;\n  /**\n   * Save one change — `PATCH /notifications/settings` with this body: one switch per\n   * call (`{types: {digest: {app: true}}}`), or `{digest_cadence}`. The switch shows its\n   * new state while the call runs and goes back if it rejects; hand the card the\n   * PATCH's answer (or refetch) when it resolves.\n   */\n  onChange: (patch: NotificationSettingsPatch<Id>) => Promise<unknown> | void;\n  /** Headings over the types, in the app's words (keksdose's three). Without them, one\n   *  list in the order of `types`. In development every type the server answered must\n   *  be in one. */\n  groups?: readonly NotificationTypeGroup<Id>[];\n  /** The digest type and the account's cadence: a cadence `Select` under that type\n   *  while it is on. */\n  digest?: { type: Id; cadence: DigestCadence };\n  /** Under a type while it is on — keksdose's low-balance threshold field. */\n  renderExtra?: (id: Id) => ReactNode;\n  /** The account's address is unverified: every e-mail switch says\n   *  `labels.emailUnverified` under it (decision 16). */\n  emailUnverified?: boolean;\n  /** Nothing can be changed (the switches stay readable). */\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\n/** One drawn type: the app's words and the server's switches. */\ninterface Row<Id extends string> {\n  entry: NotificationTypeEntry<Id>;\n  switches: NotificationSwitches;\n}\n\n/** A switch's key in the write overlay. */\nconst switchKey = (id: string, channel: \"app\" | \"email\") => `${id}.${channel}`;\nconst CADENCE_KEY = \"digest_cadence\";\n\n/**\n * What the person hears about, and how (docs/notifications-harmonization.md §2.1–§2.3,\n * §4.2): one row per type the SERVER answered, the app's words on it, a switch for \"in\n * the app\" and \"By e-mail\" under it where the type offers mail. Where the app has no\n * \"in the app\" channel (Kurvenschmiede), the e-mail switch is the row's own, with the\n * type's label.\n *\n * **The server's list is the only list.** The card keeps no defaults and no list of\n * types: it draws what `value` holds, in the order of `groups`, else of `types`. A type\n * the app names that the server did not answer is not drawn (kastlan's tenant receives\n * neither of its types). In development a type the server answered with no entry in\n * `types`, or in no group when `groups` is given, throws — keksdose's compile-time\n * `_EVERY_TYPE_IS_GROUPED`, now at run time, since the list is the server's.\n *\n * **Each flip saves at once**, one switch per call; the switch shows its new state while\n * the call runs and goes back if it rejects, with the failure said under the card. The\n * digest's cadence and the app's extra field (`renderExtra`) show under their type while\n * it is on.\n *\n * Under a write lock the switches are `commit` controls exempt from billing: a lapsed\n * plan never keeps a person from turning notifications off (billing §12.13).\n */\nexport function NotificationTypesSetting<Id extends string = string>({\n  types,\n  value,\n  loading,\n  onChange,\n  groups,\n  digest,\n  renderExtra,\n  emailUnverified = false,\n  disabled = false,\n  describeError,\n  labels: labelsProp,\n  className,\n  ...rest\n}: NotificationTypesSettingProps<Id>) {\n  const labels = useNotificationsLabels(labelsProp);\n  const overlay = useWriteOverlay<boolean>(value);\n  const cadenceOverlay = useWriteOverlay<DigestCadence>(digest?.cadence);\n  const [failure, setFailure] = useState<ReactNode>(null);\n  const mounted = useMounted();\n  const groupId = useId();\n\n  const answered = value ? Object.keys(value) : [];\n  const entries = new Map(types.map((entry) => [entry.id as string, entry]));\n  if (value && devChecks()) {\n    const unnamed = answered.filter((id) => !entries.has(id));\n    if (unnamed.length) {\n      throw new Error(\n        `NotificationTypesSetting: the server answered ${unnamed.map((id) => `\"${id}\"`).join(\", \")} with no entry in \\`types\\` — give every type the server can send its words.`,\n      );\n    }\n    if (groups) {\n      const grouped = new Set<string>(groups.flatMap((group) => group.types));\n      const loose = answered.filter((id) => !grouped.has(id));\n      if (loose.length) {\n        throw new Error(\n          `NotificationTypesSetting: ${loose.map((id) => `\"${id}\"`).join(\", \")} is in no group — a type in no group is drawn nowhere, and could not be turned off.`,\n        );\n      }\n    }\n  }\n\n  const rowOf = (id: Id): Row<Id> | null => {\n    const switches = value?.[id];\n    const entry = entries.get(id);\n    if (!switches || !entry || (switches.app === null && switches.email === null)) return null;\n    return { entry, switches };\n  };\n  const rowsOf = (ids: readonly Id[]) => ids.map(rowOf).filter((row): row is Row<Id> => row !== null);\n\n  const shown = (id: string, channel: \"app\" | \"email\", server: boolean): boolean => {\n    const key = switchKey(id, channel);\n    return overlay.get(key) ?? server;\n  };\n  /** The row's own switch: `app`, or `email` where the app has no `app` channel. */\n  const rowOn = ({ entry, switches }: Row<Id>) =>\n    switches.app !== null\n      ? shown(entry.id, \"app\", switches.app)\n      : shown(entry.id, \"email\", switches.email === true);\n\n  const save = <V,>(key: string, patch: NotificationSettingsPatch<Id>, which: WriteOverlay<V>, next: V) => {\n    if (which.pending(key)) return;\n    setFailure(null);\n    which.set(key, next);\n    settle(() => onChange(patch)).then(\n      () => {\n        if (mounted.current) which.settle(key, true);\n      },\n      (error: unknown) => {\n        if (!mounted.current) return;\n        which.settle(key, false);\n        setFailure(describeFailure(describeError?.(error), labels.failed));\n      },\n    );\n  };\n\n  const flip = (id: Id, channel: \"app\" | \"email\", on: boolean) =>\n    save(\n      switchKey(id, channel),\n      { types: { [id]: { [channel]: on } } as NotificationSettingsPatch<Id>[\"types\"] },\n      overlay,\n      on,\n    );\n\n  const cadence = cadenceOverlay.get(CADENCE_KEY) ?? digest?.cadence;\n\n  const unverifiedLine = emailUnverified ? (\n    <span className=\"block\" data-email-unverified=\"\">\n      {labels.emailUnverified}\n    </span>\n  ) : null;\n\n  const renderRow = (row: Row<Id>) => {\n    const { entry, switches } = row;\n    const on = rowOn(row);\n    const emailOnly = switches.app === null;\n    const both = !emailOnly && switches.email !== null;\n    const cadenceSelect =\n      on && digest?.type === entry.id && cadence ? (\n        <Select\n          label={labels.digestCadence}\n          value={cadence}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onChange={(event) => {\n            const next = event.target.value as DigestCadence;\n            if (next !== cadence) save(CADENCE_KEY, { digest_cadence: next }, cadenceOverlay, next);\n          }}\n          className=\"max-w-44\"\n        >\n          <option value=\"weekly\">{labels.digestWeekly}</option>\n          <option value=\"monthly\">{labels.digestMonthly}</option>\n        </Select>\n      ) : null;\n    const extra = on ? renderExtra?.(entry.id) : null;\n    const description =\n      emailOnly && unverifiedLine ? (\n        <>\n          {entry.description !== undefined && <span className=\"block\">{entry.description}</span>}\n          {unverifiedLine}\n        </>\n      ) : (\n        entry.description\n      );\n    return (\n      <div\n        key={entry.id}\n        data-notification-type={entry.id}\n        // A row with two switches is a group named by its type, so \"By e-mail\" is heard\n        // with the type it belongs to.\n        role={both ? \"group\" : undefined}\n        aria-label={both ? entry.label : undefined}\n        className=\"space-y-2\"\n      >\n        <Switch\n          label={entry.label}\n          description={description}\n          checked={on}\n          disabled={disabled}\n          commit={COMMIT_EXCEPT_BILLING}\n          onCheckedChange={(next) => flip(entry.id, emailOnly ? \"email\" : \"app\", next)}\n        />\n        {both && (\n          <div className=\"ps-4\">\n            <Switch\n              size=\"sm\"\n              label={labels.byEmail}\n              description={unverifiedLine ?? undefined}\n              checked={shown(entry.id, \"email\", switches.email === true)}\n              disabled={disabled}\n              commit={COMMIT_EXCEPT_BILLING}\n              onCheckedChange={(next) => flip(entry.id, \"email\", next)}\n            />\n          </div>\n        )}\n        {(cadenceSelect || hasContent(extra)) && (\n          <div className=\"ps-4 space-y-2\">\n            {cadenceSelect}\n            {extra}\n          </div>\n        )}\n      </div>\n    );\n  };\n\n  let body: ReactNode;\n  if (loading || value === undefined) {\n    body = <Skeleton lines={3} label={labels.typesLoading} />;\n  } else if (groups) {\n    const drawn = groups\n      .map((group) => ({ group, rows: rowsOf(group.types) }))\n      .filter(({ rows }) => rows.length > 0);\n    body =\n      drawn.length === 0 ? (\n        <p className={CARD_DESCRIPTION_CLASS}>{labels.typesEmpty}</p>\n      ) : (\n        drawn.map(({ group, rows }) => {\n          const headingId = `${groupId}-${group.id}`;\n          return (\n            <div key={group.id} role=\"group\" aria-labelledby={headingId} className=\"space-y-3\">\n              <SectionLabel as=\"div\" size=\"xs\" id={headingId}>\n                {group.label}\n              </SectionLabel>\n              {rows.map(renderRow)}\n            </div>\n          );\n        })\n      );\n  } else {\n    const rows = rowsOf(types.map((entry) => entry.id));\n    body =\n      rows.length === 0 ? (\n        <p className={CARD_DESCRIPTION_CLASS}>{labels.typesEmpty}</p>\n      ) : (\n        <div className=\"space-y-3\">{rows.map(renderRow)}</div>\n      );\n  }\n\n  return (\n    <Card {...rest} className={cn(\"p-4 space-y-3\", className)}>\n      <div>\n        <SettingsCardTitle>{labels.typesTitle}</SettingsCardTitle>\n        <div className={CARD_DESCRIPTION_CLASS}>{labels.typesDescription}</div>\n      </div>\n      {body}\n      <FailureLine>{failure}</FailureLine>\n    </Card>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/notifications/notification-types.d.ts

@@ -0,0 +1,75 @@
+import type { ReactNode } from "react";
+/**
+ * The shapes the notification cards share (docs/notifications-harmonization.md §3.2,
+ * §3.5, §4.2): the server's `GET /notifications/settings` answer, the parts of its
+ * `PATCH` the cards send, one push device, and the app's words for its types.
+ *
+ * Types only — the kit keeps no list of notification types and no defaults (§2.1): the
+ * server's registry is the one list, and the cards draw what it answers.
+ */
+/** The digest's cadence, one for the account (§2.5): Monday, or the 1st, in its zone. */
+export type DigestCadence = "weekly" | "monthly";
+/**
+ * One type's two switches in the `GET` (§3.2). `null` where the type does not offer
+ * that channel: `email` for a type with no mail, `app` in an app with no "in the app"
+ * channel (Kurvenschmiede: `{app: null, email: true}`). An unset switch already reads as
+ * its default — the server fills it in.
+ */
+export interface NotificationSwitches {
+    app: boolean | null;
+    email: boolean | null;
+}
+/** The `GET`'s `types`: every type the account can receive, in the registry's order. */
+export type NotificationTypesValue = Readonly<Record<string, NotificationSwitches>>;
+/**
+ * The app's words for one of its types — where an app TYPES its ids, so its own maps
+ * (keksdose's inbox icons) are keyed on the same list (§5.1). The kit draws the type
+ * only when the server answered it.
+ */
+export interface NotificationTypeEntry<Id extends string = string> {
+    id: Id;
+    /** The switch's label: what the person hears about. */
+    label: string;
+    /** The line under it, attached to the switch. */
+    description?: ReactNode;
+}
+/** A heading over some of the types, in the app's words (keksdose's "Budget", "Scans &
+ *  sharing", "Summaries & news"). */
+export interface NotificationTypeGroup<Id extends string = string> {
+    /** A stable key for the group. */
+    id: string;
+    label: ReactNode;
+    /** The group's types, in the order they are drawn. */
+    types: readonly Id[];
+}
+/**
+ * The parts of `PATCH /notifications/settings` (§3.2) the cards send. Omitted keeps; a
+ * type's `null` puts both its switches back to their defaults; `quiet_hours_*: null`
+ * clears a time. One switch per call from the types card (`{types: {digest: {app:
+ * true}}}`), or `{digest_cadence}`; quiet hours send a time, with the device's zone the
+ * first time; the zone picker sends `{timezone}`.
+ */
+export interface NotificationSettingsPatch<Id extends string = string> {
+    types?: Partial<Record<Id, {
+        app?: boolean;
+        email?: boolean;
+    } | null>>;
+    digest_cadence?: DigestCadence;
+    quiet_hours_start?: string | null;
+    quiet_hours_end?: string | null;
+    timezone?: string;
+}
+/** One registered push device, as `GET /notifications/devices` lists it (§3.5), oldest
+ *  first. The owner gets the whole endpoint, which marks "this device". */
+export interface PushDeviceItem<Id extends string | number = string> {
+    id: Id;
+    endpoint: string;
+    /** The browser's user agent at registration; `null` when it sent none. */
+    user_agent: string | null;
+    /** ISO date-time. */
+    created_at: string;
+    /** ISO date-time of the last delivery the push service accepted, or `null`. */
+    last_success_at: string | null;
+    /** Failed deliveries in a row; the server removes the device at 10. */
+    failure_count: number;
+}

package/dist/notifications/notification-types.js

@@ -0,0 +1,2 @@
+"use client";
+//# sourceMappingURL=notification-types.js.map

package/dist/notifications/notification-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/notifications/notifications-labels.d.ts

@@ -0,0 +1,131 @@
+/** The ten IANA regions `Intl` lists zones under — keksdose's `tz_region_*` — in the
+ *  kit's words. A region a runtime adds later keeps its IANA name. */
+export interface NotificationRegionLabels {
+    Africa: string;
+    America: string;
+    Antarctica: string;
+    Arctic: string;
+    Asia: string;
+    Atlantic: string;
+    Australia: string;
+    Europe: string;
+    Indian: string;
+    Pacific: string;
+}
+/**
+ * Every string the notification parts render — the `notifications` namespace of
+ * `<UiKitProvider labels>`, overridable per instance through `labels`: the types card,
+ * quiet hours and the zone picker, this device's push, the device list, and the
+ * unsubscribe page. Cancel is `common.cancel`.
+ */
+export interface NotificationsLabels {
+    /** The types card's title. */
+    typesTitle: string;
+    /** The line under it. */
+    typesDescription: string;
+    /** The e-mail switch under a type that offers mail. */
+    byEmail: string;
+    /** Under every e-mail switch while the account's address is unverified (decision 16):
+     *  no notification mail goes to an unverified address. */
+    emailUnverified: string;
+    /** The digest's cadence select. */
+    digestCadence: string;
+    digestWeekly: string;
+    digestMonthly: string;
+    /** While the settings load. */
+    typesLoading: string;
+    /** The server answered no types for this account. */
+    typesEmpty: string;
+    quietTitle: string;
+    /** The line under the title; `inbox`: the app keeps an inbox, which a held push still
+     *  reaches. */
+    quietDescription: (inbox: boolean) => string;
+    /** The start time's label. */
+    quietFrom: string;
+    /** The end time's label. */
+    quietUntil: string;
+    /** One time set, the other not: quiet hours fail open until both are. */
+    quietIncomplete: string;
+    /** The zone picker's label. */
+    timeZone: string;
+    /** Given the device's zone, as the picker names it, when it differs from the one the
+     *  server applies. */
+    deviceZone: (zone: string) => string;
+    /** The button that takes the device's zone. */
+    useDeviceZone: string;
+    /** The zone picker's region headings. */
+    regions: NotificationRegionLabels;
+    pushTitle: string;
+    pushDescription: string;
+    /** The browser has no push. */
+    unsupported: string;
+    /** iOS outside the installed app, given the app's name. */
+    iosInstall: (app: string) => string;
+    /** The server has no VAPID keys. */
+    notConfigured: string;
+    /** The browser's permission is denied. */
+    blocked: string;
+    /** This device gets notifications for the signed-in account. */
+    on: string;
+    off: string;
+    /** This browser's subscription belongs to another account. */
+    otherAccount: string;
+    enable: string;
+    disable: string;
+    sendTest: string;
+    /** Turning on did not finish (the permission prompt dismissed, a refusal). */
+    enableFailed: string;
+    /** No service worker, or one that is not ready in 10 s. */
+    noServiceWorker: string;
+    /** The browser's push service did not answer in 15 s. */
+    pushTimeout: string;
+    /** Given how many devices the push service accepted the test for (≥ 1). */
+    testSent: (count: number) => string;
+    /** The test reached no device. */
+    testNone: string;
+    testFailed: string;
+    /** The explainer before the browser's one permission prompt. */
+    explainerTitle: string;
+    explainerBody: (app: string) => string;
+    explainerHint: string;
+    explainerContinue: string;
+    devicesTitle: string;
+    devicesDescription: string;
+    devicesLoading: string;
+    devicesEmpty: string;
+    /** A device whose user agent says nothing the kit recognises. */
+    unknownDevice: string;
+    /** The chip on this browser's row. */
+    thisDevice: string;
+    /** Given the registration date, formatted. */
+    added: (date: string) => string;
+    /** Given the last accepted delivery, formatted. */
+    lastDelivery: (date: string) => string;
+    noDelivery: string;
+    /** Given the failed deliveries in a row (≥ 1). */
+    failures: (count: number) => string;
+    /** A row's button, visible text — and the confirm's answer. */
+    remove: string;
+    /** The same button's accessible name, given the device: it starts with `remove`. */
+    removeItem: (device: string) => string;
+    /** The question the row asks before it removes. */
+    removePrompt: string;
+    unsubscribeTitle: string;
+    /** Given the type's name in the app's words. */
+    unsubscribeAbout: (type: string) => string;
+    /** No type name to give. */
+    unsubscribeGeneric: string;
+    stopThese: string;
+    stopAll: (app: string) => string;
+    stoppedThese: string;
+    stoppedAll: (app: string) => string;
+    /** Account mail is not a notification, and keeps coming. */
+    accountMail: string;
+    turnBackOn: string;
+    openSettings: string;
+    /** A token the server refused, or one that does not parse. */
+    invalidLink: string;
+    /** A request failed, and the app had no words of its own. */
+    failed: string;
+}
+export declare const DEFAULT_NOTIFICATIONS_LABELS: NotificationsLabels;

package/dist/notifications/notifications-labels.js

@@ -0,0 +1,83 @@
+"use client";
+const DEFAULT_NOTIFICATIONS_LABELS = {
+  typesTitle: "Notify me about",
+  typesDescription: "Choose what you hear about, and how.",
+  byEmail: "By e-mail",
+  emailUnverified: "Confirm your address to receive these.",
+  digestCadence: "Frequency",
+  digestWeekly: "Weekly",
+  digestMonthly: "Monthly",
+  typesLoading: "Loading notification settings\u2026",
+  typesEmpty: "There are no notifications for this account.",
+  quietTitle: "Quiet hours",
+  quietDescription: (inbox) => inbox ? "No push notifications during this window. They still reach your inbox." : "No push notifications during this window.",
+  quietFrom: "From",
+  quietUntil: "Until",
+  quietIncomplete: "Set both a start and an end time. Quiet hours take effect once both are set.",
+  timeZone: "Time zone",
+  deviceZone: (zone) => `This device is in ${zone}.`,
+  useDeviceZone: "Use it",
+  regions: {
+    Africa: "Africa",
+    America: "Americas",
+    Antarctica: "Antarctica",
+    Arctic: "Arctic",
+    Asia: "Asia",
+    Atlantic: "Atlantic",
+    Australia: "Australia",
+    Europe: "Europe",
+    Indian: "Indian Ocean",
+    Pacific: "Pacific"
+  },
+  pushTitle: "Push notifications",
+  pushDescription: "Notifications on this device, also while the app is closed.",
+  unsupported: "This browser doesn\u2019t support push notifications.",
+  iosInstall: (app) => `On iPhone or iPad, add ${app} to your Home Screen first: iOS delivers notifications only to the installed app.`,
+  notConfigured: "Push notifications aren\u2019t set up on this server.",
+  blocked: "Notifications are blocked in this browser\u2019s settings.",
+  on: "Notifications are on for this device.",
+  off: "Notifications are off for this device.",
+  otherAccount: "This browser gets notifications for another account. Turn them on here to get them for the account you\u2019re signed in with.",
+  enable: "Turn on notifications",
+  disable: "Turn off",
+  sendTest: "Send a test",
+  enableFailed: "Couldn\u2019t turn on notifications.",
+  noServiceWorker: "Couldn\u2019t reach the app\u2019s service worker. Reload the page and try again.",
+  pushTimeout: "The browser\u2019s push service didn\u2019t answer. Check your connection and try again.",
+  testSent: (count) => count === 1 ? "Test sent to 1 device" : `Test sent to ${count} devices`,
+  testNone: "No device accepted the test. Turn notifications on for this device first.",
+  testFailed: "Couldn\u2019t send a test notification.",
+  explainerTitle: "Turn on notifications?",
+  explainerBody: (app) => `${app} sends a notification only for the kinds you choose, and you can turn them off at any time.`,
+  explainerHint: "Your browser asks for permission next.",
+  explainerContinue: "Continue",
+  devicesTitle: "Notification devices",
+  devicesDescription: "Every device that gets push notifications for your account. Remove any you no longer use.",
+  devicesLoading: "Loading devices\u2026",
+  devicesEmpty: "No device gets notifications yet.",
+  unknownDevice: "Unknown device",
+  thisDevice: "This device",
+  added: (date) => `Added ${date}`,
+  lastDelivery: (date) => `Last delivery ${date}`,
+  noDelivery: "No delivery yet",
+  failures: (count) => count === 1 ? "1 failed delivery in a row" : `${count} failed deliveries in a row`,
+  remove: "Remove",
+  removeItem: (device) => `Remove ${device}`,
+  removePrompt: "Stop sending notifications to this device?",
+  unsubscribeTitle: "E-mail notifications",
+  unsubscribeAbout: (type) => `You get e-mails about: ${type}.`,
+  unsubscribeGeneric: "You get notification e-mails.",
+  stopThese: "Stop these e-mails",
+  stopAll: (app) => `Stop all notification e-mails from ${app}`,
+  stoppedThese: "Done. You won\u2019t get these e-mails any more.",
+  stoppedAll: (app) => `Done. You won\u2019t get notification e-mails from ${app} any more.`,
+  accountMail: "E-mails about your account still come.",
+  turnBackOn: "You can turn them back on at any time in Settings.",
+  openSettings: "Open Settings",
+  invalidLink: "This link doesn\u2019t work any more. You can turn e-mails off in Settings instead.",
+  failed: "That didn\u2019t work. Please try again."
+};
+export {
+  DEFAULT_NOTIFICATIONS_LABELS
+};
+//# sourceMappingURL=notifications-labels.js.map