@eifi1/ui-kit 0.44.0 → 0.45.0

package/dist/offline/shared-computer.d.ts

@@ -0,0 +1,44 @@
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { DEFAULT_SHARED_COMPUTER_LABELS } from "./shared-computer-labels.js";
+/**
+ * "This is a shared computer" — a choice on the sign-in form that persists nothing
+ * (docs/local-first-harmonization.md §1.5 D6, D7). When it is on, the app does not mount
+ * the query persistence (`createQueryPersistence`): the cache lives in memory only.
+ *
+ * The choice must live exactly as long as the session it governs. By default it is held in
+ * `sessionStorage`, which fits a session that ends with the tab. An app whose session
+ * outlives the tab (a refresh token in `localStorage`: kastlan) passes `storage: "local"`
+ * and calls `setSharedComputer(false)` at every end of that session (logout, a failed
+ * refresh), beside removing the token. `isSharedComputer()` reads both places, so a choice
+ * made in either keeps the cache in memory. Where storage is blocked, `isSharedComputer()`
+ * is `false` and `setSharedComputer` does nothing.
+ */
+export interface SharedComputerLabels {
+    label: string;
+    /** The one line under it: what the choice does. */
+    hint: string;
+}
+export { DEFAULT_SHARED_COMPUTER_LABELS };
+/** Where the choice is held: `"session"` (this tab, the default) or `"local"` (as long as
+ *  a session kept in `localStorage`, until `setSharedComputer(false)`). */
+export type SharedComputerStorage = "session" | "local";
+/** Whether this session was signed in as on a shared computer, the choice held in either
+ *  place. `false` when storage is unavailable. */
+export declare function isSharedComputer(): boolean;
+/** Records the choice in `options.storage` (default `"session"`), and only there; `false`
+ *  forgets it in both places. */
+export declare function setSharedComputer(on: boolean, options?: {
+    storage?: SharedComputerStorage;
+}): void;
+export interface SharedComputerChoiceProps {
+    /** Controlled. Left out, the box starts from {@link isSharedComputer}. */
+    checked?: boolean;
+    /** Told after the choice is stored. */
+    onCheckedChange?: (on: boolean) => void;
+    /** Where the choice is stored: see {@link setSharedComputer}. Default `"session"`. */
+    storage?: SharedComputerStorage;
+    disabled?: boolean;
+    className?: string;
+    labels?: LabelOverride<SharedComputerLabels>;
+}
+export declare function SharedComputerChoice({ checked, onCheckedChange, storage, disabled, className, labels: labelsProp, }: SharedComputerChoiceProps): import("react").JSX.Element;

package/dist/offline/shared-computer.js

@@ -0,0 +1,51 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { Checkbox } from "../components/checkbox.js";
+import { readSessionStored, readStored, removeStored, writeSessionStored, writeStored } from "../lib/safe-storage.js";
+import { DEFAULT_SHARED_COMPUTER_LABELS } from "./shared-computer-labels.js";
+const KEY = "eifi1-shared-computer";
+function isSharedComputer() {
+  return readSessionStored(KEY) === "1" || readStored(KEY) === "1";
+}
+function setSharedComputer(on, options = {}) {
+  const local = options.storage === "local";
+  writeSessionStored(KEY, on && !local ? "1" : null);
+  if (on && local) writeStored(KEY, "1");
+  else removeStored(KEY);
+}
+function SharedComputerChoice({
+  checked,
+  onCheckedChange,
+  storage,
+  disabled,
+  className,
+  labels: labelsProp
+}) {
+  const labels = useKitLabels("sharedComputer", DEFAULT_SHARED_COMPUTER_LABELS, labelsProp);
+  const [own, setOwn] = useState(isSharedComputer);
+  const on = checked ?? own;
+  return /* @__PURE__ */ jsx(
+    Checkbox,
+    {
+      className,
+      label: labels.label,
+      description: labels.hint,
+      checked: on,
+      disabled,
+      onCheckedChange: (next) => {
+        setSharedComputer(next, { storage });
+        setOwn(next);
+        onCheckedChange?.(next);
+      }
+    }
+  );
+}
+export {
+  DEFAULT_SHARED_COMPUTER_LABELS,
+  SharedComputerChoice,
+  isSharedComputer,
+  setSharedComputer
+};
+//# sourceMappingURL=shared-computer.js.map

package/dist/offline/shared-computer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/offline/shared-computer.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Checkbox } from \"../components/checkbox\";\nimport { readSessionStored, readStored, removeStored, writeSessionStored, writeStored } from \"../lib/safe-storage\";\nimport { DEFAULT_SHARED_COMPUTER_LABELS } from \"./shared-computer-labels\";\n\n/**\n * \"This is a shared computer\" — a choice on the sign-in form that persists nothing\n * (docs/local-first-harmonization.md §1.5 D6, D7). When it is on, the app does not mount\n * the query persistence (`createQueryPersistence`): the cache lives in memory only.\n *\n * The choice must live exactly as long as the session it governs. By default it is held in\n * `sessionStorage`, which fits a session that ends with the tab. An app whose session\n * outlives the tab (a refresh token in `localStorage`: kastlan) passes `storage: \"local\"`\n * and calls `setSharedComputer(false)` at every end of that session (logout, a failed\n * refresh), beside removing the token. `isSharedComputer()` reads both places, so a choice\n * made in either keeps the cache in memory. Where storage is blocked, `isSharedComputer()`\n * is `false` and `setSharedComputer` does nothing.\n */\nexport interface SharedComputerLabels {\n  label: string;\n  /** The one line under it: what the choice does. */\n  hint: string;\n}\n\n// Defined in ./shared-computer-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_SHARED_COMPUTER_LABELS };\n\nconst KEY = \"eifi1-shared-computer\";\n\n/** Where the choice is held: `\"session\"` (this tab, the default) or `\"local\"` (as long as\n *  a session kept in `localStorage`, until `setSharedComputer(false)`). */\nexport type SharedComputerStorage = \"session\" | \"local\";\n\n/** Whether this session was signed in as on a shared computer, the choice held in either\n *  place. `false` when storage is unavailable. */\nexport function isSharedComputer(): boolean {\n  return readSessionStored(KEY) === \"1\" || readStored(KEY) === \"1\";\n}\n\n/** Records the choice in `options.storage` (default `\"session\"`), and only there; `false`\n *  forgets it in both places. */\nexport function setSharedComputer(on: boolean, options: { storage?: SharedComputerStorage } = {}): void {\n  const local = options.storage === \"local\";\n  writeSessionStored(KEY, on && !local ? \"1\" : null);\n  if (on && local) writeStored(KEY, \"1\");\n  else removeStored(KEY);\n}\n\nexport interface SharedComputerChoiceProps {\n  /** Controlled. Left out, the box starts from {@link isSharedComputer}. */\n  checked?: boolean;\n  /** Told after the choice is stored. */\n  onCheckedChange?: (on: boolean) => void;\n  /** Where the choice is stored: see {@link setSharedComputer}. Default `\"session\"`. */\n  storage?: SharedComputerStorage;\n  disabled?: boolean;\n  className?: string;\n  labels?: LabelOverride<SharedComputerLabels>;\n}\n\nexport function SharedComputerChoice({\n  checked,\n  onCheckedChange,\n  storage,\n  disabled,\n  className,\n  labels: labelsProp,\n}: SharedComputerChoiceProps) {\n  const labels = useKitLabels(\"sharedComputer\", DEFAULT_SHARED_COMPUTER_LABELS, labelsProp);\n  const [own, setOwn] = useState(isSharedComputer);\n  const on = checked ?? own;\n  return (\n    <Checkbox\n      className={className}\n      label={labels.label}\n      description={labels.hint}\n      checked={on}\n      disabled={disabled}\n      onCheckedChange={(next) => {\n        setSharedComputer(next, { storage });\n        setOwn(next);\n        onCheckedChange?.(next);\n      }}\n    />\n  );\n}\n"],"mappings":";AAyEI;AAzEJ,SAAS,gBAAgB;AACzB,SAAS,oBAAwC;AACjD,SAAS,gBAAgB;AACzB,SAAS,mBAAmB,YAAY,cAAc,oBAAoB,mBAAmB;AAC7F,SAAS,sCAAsC;AAwB/C,MAAM,MAAM;AAQL,SAAS,mBAA4B;AAC1C,SAAO,kBAAkB,GAAG,MAAM,OAAO,WAAW,GAAG,MAAM;AAC/D;AAIO,SAAS,kBAAkB,IAAa,UAA+C,CAAC,GAAS;AACtG,QAAM,QAAQ,QAAQ,YAAY;AAClC,qBAAmB,KAAK,MAAM,CAAC,QAAQ,MAAM,IAAI;AACjD,MAAI,MAAM,MAAO,aAAY,KAAK,GAAG;AAAA,MAChC,cAAa,GAAG;AACvB;AAcO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAA8B;AAC5B,QAAM,SAAS,aAAa,kBAAkB,gCAAgC,UAAU;AACxF,QAAM,CAAC,KAAK,MAAM,IAAI,SAAS,gBAAgB;AAC/C,QAAM,KAAK,WAAW;AACtB,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,OAAO,OAAO;AAAA,MACd,aAAa,OAAO;AAAA,MACpB,SAAS;AAAA,MACT;AAAA,MACA,iBAAiB,CAAC,SAAS;AACzB,0BAAkB,MAAM,EAAE,QAAQ,CAAC;AACnC,eAAO,IAAI;AACX,0BAAkB,IAAI;AAAA,MACxB;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/offline/sign-out-pending-dialog-labels.d.ts

@@ -0,0 +1,2 @@
+import type { SignOutPendingDialogLabels } from "./sign-out-pending-dialog.js";
+export declare const DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS: SignOutPendingDialogLabels;

package/dist/offline/sign-out-pending-dialog-labels.js

@@ -0,0 +1,14 @@
+"use client";
+const DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS = {
+  title: "Some changes have not been saved to the server yet",
+  lost: (count) => count === 1 ? "1 change is still waiting to sync. Logging out clears this device\u2019s copy, and it is the only copy." : `${count} changes are still waiting to sync. Logging out clears this device\u2019s copy, and it is the only copy.`,
+  kept: (count) => count === 1 ? "1 change is still waiting to sync. It stays on this device for you and syncs the next time you log in here." : `${count} changes are still waiting to sync. They stay on this device for you and sync the next time you log in here.`,
+  syncNow: "Sync now",
+  signOutAnyway: "Log out anyway",
+  discardWaiting: "Discard waiting changes",
+  cancel: "Cancel"
+};
+export {
+  DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS
+};
+//# sourceMappingURL=sign-out-pending-dialog-labels.js.map

package/dist/offline/sign-out-pending-dialog-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/offline/sign-out-pending-dialog-labels.ts"],"sourcesContent":["// The English words of ./sign-out-pending-dialog, in a module with no component code: the\n// English catalogue (src/i18n/defaults.ts) imports them without the component (0.34, KS U8).\n// keksdose's reviewed words (nav.logout_queued_*, account-menu.tsx:247-317) are the canon.\n\nimport type { SignOutPendingDialogLabels } from \"./sign-out-pending-dialog\";\n\nexport const DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS: SignOutPendingDialogLabels = {\n  title: \"Some changes have not been saved to the server yet\",\n  lost: (count) =>\n    count === 1\n      ? \"1 change is still waiting to sync. Logging out clears this device’s copy, and it is the only copy.\"\n      : `${count} changes are still waiting to sync. Logging out clears this device’s copy, and it is the only copy.`,\n  kept: (count) =>\n    count === 1\n      ? \"1 change is still waiting to sync. It stays on this device for you and syncs the next time you log in here.\"\n      : `${count} changes are still waiting to sync. They stay on this device for you and sync the next time you log in here.`,\n  syncNow: \"Sync now\",\n  signOutAnyway: \"Log out anyway\",\n  discardWaiting: \"Discard waiting changes\",\n  cancel: \"Cancel\",\n};\n"],"mappings":";AAMO,MAAM,yCAAqE;AAAA,EAChF,OAAO;AAAA,EACP,MAAM,CAAC,UACL,UAAU,IACN,4GACA,GAAG,KAAK;AAAA,EACd,MAAM,CAAC,UACL,UAAU,IACN,gHACA,GAAG,KAAK;AAAA,EACd,SAAS;AAAA,EACT,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,QAAQ;AACV;","names":[]}

package/dist/offline/sign-out-pending-dialog.d.ts

@@ -0,0 +1,58 @@
+import type { ReactNode } from "react";
+import { type LabelOverride } from "../i18n/kit-labels.js";
+import { DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS } from "./sign-out-pending-dialog-labels.js";
+/**
+ * The question before an explicit sign-out while changes still wait to sync — keksdose's
+ * confirm (account-menu.tsx:247-317) as a kit dialog (docs/local-first-harmonization.md
+ * §1.5 D6, §1.6). Show it only when `queued > 0` and only on a sign-out someone asked for:
+ * never from a session-ended hook, which cannot ask anyone.
+ *
+ * "Sync now" is the primary action: the queued writes are the person's own data. It runs
+ * `onSyncNow`, is busy while that runs, then calls `onClose` without signing out — the
+ * count has moved and the caller re-evaluates (signs out at once when nothing is left, or
+ * opens this again with the new number). "Log out anyway" stays as the escape hatch, usable
+ * while a sync runs (a hanging one would trap the person otherwise): a device that cannot
+ * reach the server must still be able to sign out. Only a running discard holds it.
+ *
+ * The words depend on what the app does with the queue at sign-out (`keepsChanges`):
+ * kastlan keeps the outbox for its owner, keksdose wipes it — and keksdose's copy must not
+ * say the changes stay.
+ */
+export interface SignOutPendingDialogLabels {
+    title: string;
+    /** `keepsChanges={false}`: signing out destroys the device's copy. */
+    lost: (count: number) => string;
+    /** `keepsChanges`: the queue stays on the device for its owner. */
+    kept: (count: number) => string;
+    syncNow: string;
+    signOutAnyway: string;
+    /** Only with `onDiscardWaiting` and `waitingForPlan > 0` (the billing kit's words). */
+    discardWaiting: string;
+    cancel: string;
+}
+export { DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS };
+export interface SignOutPendingDialogProps {
+    open: boolean;
+    /** Changes not yet on the server: pending + blocked. The tour `:pending` record is not
+     *  one of them (D6). */
+    queued: number;
+    /** Of those, the ones waiting for a plan (billing's read-only refusal). */
+    waitingForPlan: number;
+    /** Runs one sync round. The dialog closes when it settles, whatever it managed. */
+    onSyncNow: () => Promise<unknown> | void;
+    /** Signs out now, queue or not. */
+    onSignOutAnyway: () => void;
+    /** Lets the plan-waiting changes go; the dialog then signs out as asked. Without it
+     *  (or with `waitingForPlan` 0) the button is not shown. */
+    onDiscardWaiting?: () => Promise<unknown> | void;
+    /** `true` (kastlan): the changes stay on this device for their owner. `false`
+     *  (keksdose): they are lost. Picks the words. */
+    keepsChanges: boolean;
+    /** Room under the sentence — the billing kit's `waitingChanges` line. Shown only while
+     *  `waitingForPlan > 0`, so a 0-count line never shows. */
+    extra?: ReactNode;
+    /** Cancel, Escape, the X — and after "Sync now". */
+    onClose: () => void;
+    labels?: LabelOverride<SignOutPendingDialogLabels>;
+}
+export declare function SignOutPendingDialog({ open, queued, waitingForPlan, onSyncNow, onSignOutAnyway, onDiscardWaiting, keepsChanges, extra, onClose, labels: labelsProp, }: SignOutPendingDialogProps): import("react").JSX.Element;

package/dist/offline/sign-out-pending-dialog.js

@@ -0,0 +1,66 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { useKitLabels } from "../i18n/kit-labels.js";
+import { Button } from "../components/button.js";
+import { DialogFrame } from "../components/dialog-frame.js";
+import { DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS } from "./sign-out-pending-dialog-labels.js";
+function SignOutPendingDialog({
+  open,
+  queued,
+  waitingForPlan,
+  onSyncNow,
+  onSignOutAnyway,
+  onDiscardWaiting,
+  keepsChanges,
+  extra,
+  onClose,
+  labels: labelsProp
+}) {
+  const labels = useKitLabels("signOutPending", DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS, labelsProp);
+  const [syncing, setSyncing] = useState(false);
+  const [discarding, setDiscarding] = useState(false);
+  const syncNow = async () => {
+    setSyncing(true);
+    try {
+      await onSyncNow();
+    } catch {
+    } finally {
+      setSyncing(false);
+    }
+    onClose();
+  };
+  const discard = async () => {
+    if (!onDiscardWaiting) return;
+    setDiscarding(true);
+    try {
+      await onDiscardWaiting();
+    } finally {
+      setDiscarding(false);
+    }
+    onSignOutAnyway();
+  };
+  return /* @__PURE__ */ jsx(
+    DialogFrame,
+    {
+      open,
+      role: "alertdialog",
+      onClose,
+      title: labels.title,
+      description: keepsChanges ? labels.kept(queued) : labels.lost(queued),
+      closeButton: true,
+      actions: /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(Button, { variant: "secondary", onClick: onClose, children: labels.cancel }),
+        onDiscardWaiting && waitingForPlan > 0 && /* @__PURE__ */ jsx(Button, { variant: "secondary", pending: discarding, disabled: syncing, onClick: () => void discard(), children: labels.discardWaiting }),
+        /* @__PURE__ */ jsx(Button, { pending: syncing, disabled: discarding, onClick: () => void syncNow(), children: labels.syncNow }),
+        /* @__PURE__ */ jsx(Button, { variant: "secondary", disabled: discarding, onClick: onSignOutAnyway, children: labels.signOutAnyway })
+      ] }),
+      children: waitingForPlan > 0 && (typeof extra === "string" ? /* @__PURE__ */ jsx("p", { className: "text-sm text-muted", children: extra }) : extra)
+    }
+  );
+}
+export {
+  DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS,
+  SignOutPendingDialog
+};
+//# sourceMappingURL=sign-out-pending-dialog.js.map

package/dist/offline/sign-out-pending-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/offline/sign-out-pending-dialog.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport type { ReactNode } from \"react\";\nimport { useKitLabels, type LabelOverride } from \"../i18n/kit-labels\";\nimport { Button } from \"../components/button\";\nimport { DialogFrame } from \"../components/dialog-frame\";\nimport { DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS } from \"./sign-out-pending-dialog-labels\";\n\n/**\n * The question before an explicit sign-out while changes still wait to sync — keksdose's\n * confirm (account-menu.tsx:247-317) as a kit dialog (docs/local-first-harmonization.md\n * §1.5 D6, §1.6). Show it only when `queued > 0` and only on a sign-out someone asked for:\n * never from a session-ended hook, which cannot ask anyone.\n *\n * \"Sync now\" is the primary action: the queued writes are the person's own data. It runs\n * `onSyncNow`, is busy while that runs, then calls `onClose` without signing out — the\n * count has moved and the caller re-evaluates (signs out at once when nothing is left, or\n * opens this again with the new number). \"Log out anyway\" stays as the escape hatch, usable\n * while a sync runs (a hanging one would trap the person otherwise): a device that cannot\n * reach the server must still be able to sign out. Only a running discard holds it.\n *\n * The words depend on what the app does with the queue at sign-out (`keepsChanges`):\n * kastlan keeps the outbox for its owner, keksdose wipes it — and keksdose's copy must not\n * say the changes stay.\n */\nexport interface SignOutPendingDialogLabels {\n  title: string;\n  /** `keepsChanges={false}`: signing out destroys the device's copy. */\n  lost: (count: number) => string;\n  /** `keepsChanges`: the queue stays on the device for its owner. */\n  kept: (count: number) => string;\n  syncNow: string;\n  signOutAnyway: string;\n  /** Only with `onDiscardWaiting` and `waitingForPlan > 0` (the billing kit's words). */\n  discardWaiting: string;\n  cancel: string;\n}\n\n// Defined in ./sign-out-pending-dialog-labels, which holds no component code (0.34, KS U8).\nexport { DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS };\n\nexport interface SignOutPendingDialogProps {\n  open: boolean;\n  /** Changes not yet on the server: pending + blocked. The tour `:pending` record is not\n   *  one of them (D6). */\n  queued: number;\n  /** Of those, the ones waiting for a plan (billing's read-only refusal). */\n  waitingForPlan: number;\n  /** Runs one sync round. The dialog closes when it settles, whatever it managed. */\n  onSyncNow: () => Promise<unknown> | void;\n  /** Signs out now, queue or not. */\n  onSignOutAnyway: () => void;\n  /** Lets the plan-waiting changes go; the dialog then signs out as asked. Without it\n   *  (or with `waitingForPlan` 0) the button is not shown. */\n  onDiscardWaiting?: () => Promise<unknown> | void;\n  /** `true` (kastlan): the changes stay on this device for their owner. `false`\n   *  (keksdose): they are lost. Picks the words. */\n  keepsChanges: boolean;\n  /** Room under the sentence — the billing kit's `waitingChanges` line. Shown only while\n   *  `waitingForPlan > 0`, so a 0-count line never shows. */\n  extra?: ReactNode;\n  /** Cancel, Escape, the X — and after \"Sync now\". */\n  onClose: () => void;\n  labels?: LabelOverride<SignOutPendingDialogLabels>;\n}\n\nexport function SignOutPendingDialog({\n  open,\n  queued,\n  waitingForPlan,\n  onSyncNow,\n  onSignOutAnyway,\n  onDiscardWaiting,\n  keepsChanges,\n  extra,\n  onClose,\n  labels: labelsProp,\n}: SignOutPendingDialogProps) {\n  const labels = useKitLabels(\"signOutPending\", DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS, labelsProp);\n  const [syncing, setSyncing] = useState(false);\n  const [discarding, setDiscarding] = useState(false);\n\n  const syncNow = async () => {\n    setSyncing(true);\n    try {\n      await onSyncNow();\n    } catch {\n      /* whatever the sync managed, the decision is the person's again */\n    } finally {\n      setSyncing(false);\n    }\n    onClose();\n  };\n\n  const discard = async () => {\n    if (!onDiscardWaiting) return;\n    setDiscarding(true);\n    try {\n      await onDiscardWaiting();\n    } finally {\n      setDiscarding(false);\n    }\n    onSignOutAnyway();\n  };\n\n  return (\n    <DialogFrame\n      open={open}\n      role=\"alertdialog\"\n      onClose={onClose}\n      title={labels.title}\n      description={keepsChanges ? labels.kept(queued) : labels.lost(queued)}\n      closeButton\n      actions={\n        <>\n          <Button variant=\"secondary\" onClick={onClose}>\n            {labels.cancel}\n          </Button>\n          {onDiscardWaiting && waitingForPlan > 0 && (\n            <Button variant=\"secondary\" pending={discarding} disabled={syncing} onClick={() => void discard()}>\n              {labels.discardWaiting}\n            </Button>\n          )}\n          <Button pending={syncing} disabled={discarding} onClick={() => void syncNow()}>\n            {labels.syncNow}\n          </Button>\n          <Button variant=\"secondary\" disabled={discarding} onClick={onSignOutAnyway}>\n            {labels.signOutAnyway}\n          </Button>\n        </>\n      }\n    >\n      {waitingForPlan > 0 && (typeof extra === \"string\" ? <p className=\"text-sm text-muted\">{extra}</p> : extra)}\n    </DialogFrame>\n  );\n}\n"],"mappings":";AAiHQ,mBACE,KADF;AAjHR,SAAS,gBAAgB;AAEzB,SAAS,oBAAwC;AACjD,SAAS,cAAc;AACvB,SAAS,mBAAmB;AAC5B,SAAS,8CAA8C;AA4DhD,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,GAA8B;AAC5B,QAAM,SAAS,aAAa,kBAAkB,wCAAwC,UAAU;AAChG,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAC5C,QAAM,CAAC,YAAY,aAAa,IAAI,SAAS,KAAK;AAElD,QAAM,UAAU,YAAY;AAC1B,eAAW,IAAI;AACf,QAAI;AACF,YAAM,UAAU;AAAA,IAClB,QAAQ;AAAA,IAER,UAAE;AACA,iBAAW,KAAK;AAAA,IAClB;AACA,YAAQ;AAAA,EACV;AAEA,QAAM,UAAU,YAAY;AAC1B,QAAI,CAAC,iBAAkB;AACvB,kBAAc,IAAI;AAClB,QAAI;AACF,YAAM,iBAAiB;AAAA,IACzB,UAAE;AACA,oBAAc,KAAK;AAAA,IACrB;AACA,oBAAgB;AAAA,EAClB;AAEA,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,MAAK;AAAA,MACL;AAAA,MACA,OAAO,OAAO;AAAA,MACd,aAAa,eAAe,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,MAAM;AAAA,MACpE,aAAW;AAAA,MACX,SACE,iCACE;AAAA,4BAAC,UAAO,SAAQ,aAAY,SAAS,SAClC,iBAAO,QACV;AAAA,QACC,oBAAoB,iBAAiB,KACpC,oBAAC,UAAO,SAAQ,aAAY,SAAS,YAAY,UAAU,SAAS,SAAS,MAAM,KAAK,QAAQ,GAC7F,iBAAO,gBACV;AAAA,QAEF,oBAAC,UAAO,SAAS,SAAS,UAAU,YAAY,SAAS,MAAM,KAAK,QAAQ,GACzE,iBAAO,SACV;AAAA,QACA,oBAAC,UAAO,SAAQ,aAAY,UAAU,YAAY,SAAS,iBACxD,iBAAO,eACV;AAAA,SACF;AAAA,MAGD,2BAAiB,MAAM,OAAO,UAAU,WAAW,oBAAC,OAAE,WAAU,sBAAsB,iBAAM,IAAO;AAAA;AAAA,EACtG;AAEJ;","names":[]}

package/dist/offline.d.ts

@@ -0,0 +1,8 @@
+export { createQueryPersistence, DEFAULT_SCRUB_FIELDS, isCacheSafe } from "./offline/query-persistence.js";
+export type { QueryPersistence, QueryPersistenceOptions, QueryPersistenceStorage, ScrubField, } from "./offline/query-persistence.js";
+export { SignOutPendingDialog, DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS } from "./offline/sign-out-pending-dialog.js";
+export type { SignOutPendingDialogProps, SignOutPendingDialogLabels } from "./offline/sign-out-pending-dialog.js";
+export { PwaUpdatePrompt, DEFAULT_PWA_UPDATE_PROMPT_LABELS } from "./offline/pwa-update-prompt.js";
+export type { PwaUpdatePromptProps, PwaUpdatePromptLabels } from "./offline/pwa-update-prompt.js";
+export { SharedComputerChoice, DEFAULT_SHARED_COMPUTER_LABELS, isSharedComputer, setSharedComputer, } from "./offline/shared-computer.js";
+export type { SharedComputerChoiceProps, SharedComputerLabels, SharedComputerStorage } from "./offline/shared-computer.js";

package/dist/offline.js

@@ -0,0 +1,24 @@
+"use client";
+import { createQueryPersistence, DEFAULT_SCRUB_FIELDS, isCacheSafe } from "./offline/query-persistence.js";
+import { SignOutPendingDialog, DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS } from "./offline/sign-out-pending-dialog.js";
+import { PwaUpdatePrompt, DEFAULT_PWA_UPDATE_PROMPT_LABELS } from "./offline/pwa-update-prompt.js";
+import {
+  SharedComputerChoice,
+  DEFAULT_SHARED_COMPUTER_LABELS,
+  isSharedComputer,
+  setSharedComputer
+} from "./offline/shared-computer.js";
+export {
+  DEFAULT_PWA_UPDATE_PROMPT_LABELS,
+  DEFAULT_SCRUB_FIELDS,
+  DEFAULT_SHARED_COMPUTER_LABELS,
+  DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS,
+  PwaUpdatePrompt,
+  SharedComputerChoice,
+  SignOutPendingDialog,
+  createQueryPersistence,
+  isCacheSafe,
+  isSharedComputer,
+  setSharedComputer
+};
+//# sourceMappingURL=offline.js.map

package/dist/offline.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/offline.ts"],"sourcesContent":["// `@eifi1/ui-kit/offline` — local-first phase 1 (docs/local-first-harmonization.md §1.6,\n// 0.45): the persisted query cache with its scrub list, the sign-out question while changes\n// wait, the service-worker update prompt, and the shared-computer choice.\n//\n// The only entry point that requires `@tanstack/react-query`,\n// `@tanstack/react-query-persist-client`, `@tanstack/query-async-storage-persister` and\n// `idb-keyval` — optional peers for that reason. NOT re-exported from the main barrel, which\n// would make them everyone's install; the packaging contract test holds that line.\nexport { createQueryPersistence, DEFAULT_SCRUB_FIELDS, isCacheSafe } from \"./offline/query-persistence\";\nexport type {\n  QueryPersistence,\n  QueryPersistenceOptions,\n  QueryPersistenceStorage,\n  ScrubField,\n} from \"./offline/query-persistence\";\nexport { SignOutPendingDialog, DEFAULT_SIGN_OUT_PENDING_DIALOG_LABELS } from \"./offline/sign-out-pending-dialog\";\nexport type { SignOutPendingDialogProps, SignOutPendingDialogLabels } from \"./offline/sign-out-pending-dialog\";\nexport { PwaUpdatePrompt, DEFAULT_PWA_UPDATE_PROMPT_LABELS } from \"./offline/pwa-update-prompt\";\nexport type { PwaUpdatePromptProps, PwaUpdatePromptLabels } from \"./offline/pwa-update-prompt\";\nexport {\n  SharedComputerChoice,\n  DEFAULT_SHARED_COMPUTER_LABELS,\n  isSharedComputer,\n  setSharedComputer,\n} from \"./offline/shared-computer\";\nexport type { SharedComputerChoiceProps, SharedComputerLabels, SharedComputerStorage } from \"./offline/shared-computer\";\n"],"mappings":";AAQA,SAAS,wBAAwB,sBAAsB,mBAAmB;AAO1E,SAAS,sBAAsB,8CAA8C;AAE7E,SAAS,iBAAiB,wCAAwC;AAElE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/shell/admin-menu.d.ts

@@ -1,6 +1,30 @@
 import type { LabelOverride } from "../i18n/kit-labels.js";
 import type { AdminAreaLabels } from "../admin/admin-area-labels.js";
 import type { TopBarMenuEntry } from "./topbar-action-menu.js";
+export interface AdminWaitingBadgeProps {
+    /** The waiting count: only work that waits on this admin. `0`, `null` or none draws
+     *  nothing; past 99 it reads "99+". */
+    count: number | null | undefined;
+    /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */
+    labels?: LabelOverride<AdminAreaLabels>;
+    className?: string;
+}
+/**
+ * The waiting pill of {@link AdminMenuRow} on its own (0.45, docs/admin-harmonization.md
+ * §9.3.4): the `solid` warning count, "99+" past 99, nothing for 0. Fit for `IconButton`'s
+ * `badge` — kastlan's top-bar platform button. There the badge is DECORATIVE (`aria-hidden`
+ * by IconButton), so the button's name carries the count: `adminArea.waitingLabel`.
+ *
+ *     const area = useAdminAreaLabels();
+ *     <IconButton
+ *       label={waiting > 0 ? area.waitingLabel("Platform", waiting) : "Platform"}
+ *       badge={<AdminWaitingBadge count={waiting} />}
+ *       …
+ *     />
+ *
+ * Read on its own (outside an IconButton), the pill still says ", 3 waiting" to a reader.
+ */
+export declare function AdminWaitingBadge({ count, labels: labelsProp, className }: AdminWaitingBadgeProps): import("react").JSX.Element;
 export interface AdminMenuEntryOptions {
     /** The admin area. Default `/admin`. */
     href?: string;

package/dist/shell/admin-menu.js

@@ -9,10 +9,14 @@ function badgeText(badge) {
   if (typeof badge !== "number" || !(badge > 0)) return null;
   return badge > 99 ? "99+" : String(Math.floor(badge));
 }
-function WaitingBadge({ badge, labels }) {
+function WaitingBadge({
+  badge,
+  labels,
+  className
+}) {
   const text = badgeText(badge);
   if (text === null) return null;
-  return /* @__PURE__ */ jsxs(Chip, { size: "sm", variant: "solid", tone: "warning", "data-slot": "admin-badge", children: [
+  return /* @__PURE__ */ jsxs(Chip, { size: "sm", variant: "solid", tone: "warning", "data-slot": "admin-badge", className, children: [
     /* @__PURE__ */ jsx("span", { "aria-hidden": true, children: text }),
     /* @__PURE__ */ jsxs("span", { className: "sr-only-fixed", children: [
       ", ",
@@ -20,6 +24,10 @@ function WaitingBadge({ badge, labels }) {
     ] })
   ] });
 }
+function AdminWaitingBadge({ count, labels: labelsProp, className }) {
+  const labels = useAdminAreaLabels(labelsProp);
+  return /* @__PURE__ */ jsx(WaitingBadge, { badge: count, labels, className });
+}
 function adminMenuEntry({
   href = "/admin",
   badge,
@@ -50,7 +58,7 @@ function AdminMenuRow({ href = "/admin", badge, onNavigate, current, labels: lab
       renderLink: ({ href: to, ...p }) => /* @__PURE__ */ jsx(Link, { to, ...p }),
       onClick: onNavigate ? () => onNavigate() : void 0,
       leading: /* @__PURE__ */ jsx(ShieldCheck, { className: "size-4", "aria-hidden": true }),
-      trailing: badgeText(badge) === null ? void 0 : /* @__PURE__ */ jsx(WaitingBadge, { badge, labels }),
+      trailing: badgeText(badge) === null ? void 0 : /* @__PURE__ */ jsx(AdminWaitingBadge, { count: badge, labels }),
       current,
       children: labels.title
     }
@@ -58,6 +66,7 @@ function AdminMenuRow({ href = "/admin", badge, onNavigate, current, labels: lab
 }
 export {
   AdminMenuRow,
+  AdminWaitingBadge,
   adminMenuEntry,
   useAdminMenuEntry
 };

package/dist/shell/admin-menu.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shell/admin-menu.tsx"],"sourcesContent":["import { Link } from \"react-router\";\nimport { ShieldCheck } from \"lucide-react\";\nimport { Chip } from \"../components/chip\";\nimport { MenuItem } from \"../components/menu-item\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_ADMIN_AREA_LABELS, useAdminAreaLabels } from \"../admin/admin-area-labels\";\nimport type { AdminAreaLabels } from \"../admin/admin-area-labels\";\nimport type { TopBarMenuEntry } from \"./topbar-action-menu\";\n\n/**\n * The account menu's \"Administration\" row (0.42.0, docs/admin-harmonization.md §2.1, §6.6,\n * §7): the way into the admin area everyone finds, in every app, for an admin only. Two\n * forms of one row — {@link adminMenuEntry} for `TopBarActionMenu`'s `entries`, and\n * {@link AdminMenuRow} for a menu built from `HoverMenu` children (Kurvenschmiede's).\n */\n\n/** The badge's text: nothing for none or 0, \"99+\" past 99. */\nfunction badgeText(badge: number | null | undefined): string | null {\n  if (typeof badge !== \"number\" || !(badge > 0)) return null;\n  return badge > 99 ? \"99+\" : String(Math.floor(badge));\n}\n\n/**\n * The waiting count at the row's end: the `solid` count pill of {@link Chip}, in the\n * pending count's tone, with the number for the eye and `adminArea.waiting` for a reader\n * (\"Administration, 3 waiting\"). `null` for no count.\n */\nfunction WaitingBadge({ badge, labels }: { badge: number | null | undefined; labels: AdminAreaLabels }) {\n  const text = badgeText(badge);\n  if (text === null) return null;\n  return (\n    <Chip size=\"sm\" variant=\"solid\" tone=\"warning\" data-slot=\"admin-badge\">\n      <span aria-hidden>{text}</span>\n      {/* The comma parts it from the row's label in the name: \"Administration, 3 waiting\". */}\n      <span className=\"sr-only-fixed\">, {labels.waiting(badge as number)}</span>\n    </Chip>\n  );\n}\n\nexport interface AdminMenuEntryOptions {\n  /** The admin area. Default `/admin`. */\n  href?: string;\n  /**\n   * The waiting count (§2.4 decision 15, §6.3): only work that waits on this admin —\n   * `adminWaitingCount(attention, […])`. `0`, `null` or none shows no badge.\n   */\n  badge?: number | null;\n  /**\n   * The resolved `adminArea` words — pass `useAdminAreaLabels()`, or the row is ENGLISH\n   * in every language: a plain function reads no provider (kastlan, 0.42 adoption). Builds\n   * no hook, so the entry can be made in the list of entries. {@link useAdminMenuEntry}\n   * (0.43) is the same entry with the provider's words read for you.\n   */\n  labels?: AdminAreaLabels;\n  /** The entry's `key`. Default `\"administration\"`. */\n  key?: string;\n  /** The page already open: `aria-current` and a check mark. */\n  current?: boolean;\n}\n\n/**\n * The \"Administration\" {@link TopBarMenuEntry}: a link row with the `ShieldCheck` icon,\n * the kit's word and the waiting count as its badge. Put it in the entries for an admin\n * only — the menu closes on the way, as any link row:\n *\n *     const labels = useAdminAreaLabels();\n *     entries={[…, ...(isAdmin ? [adminMenuEntry({ badge: waiting, labels })] : []), …]}\n *\n * A function, not a hook: it reads NO provider, so pass `labels` (`useAdminAreaLabels()`)\n * or the row says \"Administration\" in every language — or call {@link useAdminMenuEntry}\n * at the component's top.\n */\nexport function adminMenuEntry({\n  href = \"/admin\",\n  badge,\n  labels = DEFAULT_ADMIN_AREA_LABELS,\n  key = \"administration\",\n  current,\n}: AdminMenuEntryOptions = {}): TopBarMenuEntry {\n  return {\n    kind: \"link\",\n    key,\n    to: href,\n    icon: <ShieldCheck className=\"size-4\" aria-hidden />,\n    label: labels.title,\n    trailing: badgeText(badge) === null ? undefined : <WaitingBadge badge={badge} labels={labels} />,\n    current,\n  };\n}\n\nexport interface UseAdminMenuEntryOptions extends Omit<AdminMenuEntryOptions, \"labels\"> {\n  /** Over the provider's `adminArea` words: prop > `<UiKitProvider labels={{ adminArea }}>`\n   *  > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n}\n\n/**\n * {@link adminMenuEntry} with the provider's words (0.43, kastlan): the hook reads\n * `useAdminAreaLabels()` itself, so the row is in the app's language without a `labels`\n * to remember. Call it at the component's top, then put it in the entries:\n *\n *     const admin = useAdminMenuEntry({ badge: waiting });\n *     entries={[…, ...(isAdmin ? [admin] : []), …]}\n */\nexport function useAdminMenuEntry({ labels: labelsProp, ...options }: UseAdminMenuEntryOptions = {}): TopBarMenuEntry {\n  const labels = useAdminAreaLabels(labelsProp);\n  return adminMenuEntry({ ...options, labels });\n}\n\nexport interface AdminMenuRowProps {\n  /** The admin area. Default `/admin`. */\n  href?: string;\n  /** As {@link AdminMenuEntryOptions.badge}. */\n  badge?: number | null;\n  /** Runs on the way — `HoverMenu`'s `close`. */\n  onNavigate?: () => void;\n  current?: boolean;\n  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n}\n\n/**\n * The same row as {@link adminMenuEntry} for a menu drawn from `HoverMenu` children: the\n * `<li>` holding the router-link {@link MenuItem} `TopBarActionMenu` draws for a link\n * entry, so the two menus look alike.\n *\n *     {(close) => <ul>… {isAdmin && <AdminMenuRow badge={waiting} onNavigate={close} />} …</ul>}\n */\nexport function AdminMenuRow({ href = \"/admin\", badge, onNavigate, current, labels: labelsProp }: AdminMenuRowProps) {\n  // The provider's words, as every kit part (0.43: through the namespace's own hook).\n  const labels = useAdminAreaLabels(labelsProp);\n  return (\n    <li>\n      <MenuItem\n        href={href}\n        renderLink={({ href: to, ...p }) => <Link to={to} {...p} />}\n        onClick={onNavigate ? () => onNavigate() : undefined}\n        leading={<ShieldCheck className=\"size-4\" aria-hidden />}\n        trailing={badgeText(badge) === null ? undefined : <WaitingBadge badge={badge} labels={labels} />}\n        current={current}\n      >\n        {labels.title}\n      </MenuItem>\n    </li>\n  );\n}\n"],"mappings":";AAgCM,cAEA,YAFA;AAhCN,SAAS,YAAY;AACrB,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AACrB,SAAS,gBAAgB;AAEzB,SAAS,2BAA2B,0BAA0B;AAY9D,SAAS,UAAU,OAAiD;AAClE,MAAI,OAAO,UAAU,YAAY,EAAE,QAAQ,GAAI,QAAO;AACtD,SAAO,QAAQ,KAAK,QAAQ,OAAO,KAAK,MAAM,KAAK,CAAC;AACtD;AAOA,SAAS,aAAa,EAAE,OAAO,OAAO,GAAkE;AACtG,QAAM,OAAO,UAAU,KAAK;AAC5B,MAAI,SAAS,KAAM,QAAO;AAC1B,SACE,qBAAC,QAAK,MAAK,MAAK,SAAQ,SAAQ,MAAK,WAAU,aAAU,eACvD;AAAA,wBAAC,UAAK,eAAW,MAAE,gBAAK;AAAA,IAExB,qBAAC,UAAK,WAAU,iBAAgB;AAAA;AAAA,MAAG,OAAO,QAAQ,KAAe;AAAA,OAAE;AAAA,KACrE;AAEJ;AAmCO,SAAS,eAAe;AAAA,EAC7B,OAAO;AAAA,EACP;AAAA,EACA,SAAS;AAAA,EACT,MAAM;AAAA,EACN;AACF,IAA2B,CAAC,GAAoB;AAC9C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,IAAI;AAAA,IACJ,MAAM,oBAAC,eAAY,WAAU,UAAS,eAAW,MAAC;AAAA,IAClD,OAAO,OAAO;AAAA,IACd,UAAU,UAAU,KAAK,MAAM,OAAO,SAAY,oBAAC,gBAAa,OAAc,QAAgB;AAAA,IAC9F;AAAA,EACF;AACF;AAgBO,SAAS,kBAAkB,EAAE,QAAQ,YAAY,GAAG,QAAQ,IAA8B,CAAC,GAAoB;AACpH,QAAM,SAAS,mBAAmB,UAAU;AAC5C,SAAO,eAAe,EAAE,GAAG,SAAS,OAAO,CAAC;AAC9C;AAqBO,SAAS,aAAa,EAAE,OAAO,UAAU,OAAO,YAAY,SAAS,QAAQ,WAAW,GAAsB;AAEnH,QAAM,SAAS,mBAAmB,UAAU;AAC5C,SACE,oBAAC,QACC;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,oBAAC,QAAK,IAAS,GAAG,GAAG;AAAA,MACzD,SAAS,aAAa,MAAM,WAAW,IAAI;AAAA,MAC3C,SAAS,oBAAC,eAAY,WAAU,UAAS,eAAW,MAAC;AAAA,MACrD,UAAU,UAAU,KAAK,MAAM,OAAO,SAAY,oBAAC,gBAAa,OAAc,QAAgB;AAAA,MAC9F;AAAA,MAEC,iBAAO;AAAA;AAAA,EACV,GACF;AAEJ;","names":[]}
+{"version":3,"sources":["../../src/shell/admin-menu.tsx"],"sourcesContent":["import { Link } from \"react-router\";\nimport { ShieldCheck } from \"lucide-react\";\nimport { Chip } from \"../components/chip\";\nimport { MenuItem } from \"../components/menu-item\";\nimport type { LabelOverride } from \"../i18n/kit-labels\";\nimport { DEFAULT_ADMIN_AREA_LABELS, useAdminAreaLabels } from \"../admin/admin-area-labels\";\nimport type { AdminAreaLabels } from \"../admin/admin-area-labels\";\nimport type { TopBarMenuEntry } from \"./topbar-action-menu\";\n\n/**\n * The account menu's \"Administration\" row (0.42.0, docs/admin-harmonization.md §2.1, §6.6,\n * §7): the way into the admin area everyone finds, in every app, for an admin only. Two\n * forms of one row — {@link adminMenuEntry} for `TopBarActionMenu`'s `entries`, and\n * {@link AdminMenuRow} for a menu built from `HoverMenu` children (Kurvenschmiede's).\n */\n\n/** The badge's text: nothing for none or 0, \"99+\" past 99. */\nfunction badgeText(badge: number | null | undefined): string | null {\n  if (typeof badge !== \"number\" || !(badge > 0)) return null;\n  return badge > 99 ? \"99+\" : String(Math.floor(badge));\n}\n\n/**\n * The waiting count at the row's end: the `solid` count pill of {@link Chip}, in the\n * pending count's tone, with the number for the eye and `adminArea.waiting` for a reader\n * (\"Administration, 3 waiting\"). `null` for no count.\n */\nfunction WaitingBadge({\n  badge,\n  labels,\n  className,\n}: {\n  badge: number | null | undefined;\n  labels: AdminAreaLabels;\n  className?: string;\n}) {\n  const text = badgeText(badge);\n  if (text === null) return null;\n  return (\n    <Chip size=\"sm\" variant=\"solid\" tone=\"warning\" data-slot=\"admin-badge\" className={className}>\n      <span aria-hidden>{text}</span>\n      {/* The comma parts it from the row's label in the name: \"Administration, 3 waiting\". */}\n      <span className=\"sr-only-fixed\">, {labels.waiting(badge as number)}</span>\n    </Chip>\n  );\n}\n\nexport interface AdminWaitingBadgeProps {\n  /** The waiting count: only work that waits on this admin. `0`, `null` or none draws\n   *  nothing; past 99 it reads \"99+\". */\n  count: number | null | undefined;\n  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n  className?: string;\n}\n\n/**\n * The waiting pill of {@link AdminMenuRow} on its own (0.45, docs/admin-harmonization.md\n * §9.3.4): the `solid` warning count, \"99+\" past 99, nothing for 0. Fit for `IconButton`'s\n * `badge` — kastlan's top-bar platform button. There the badge is DECORATIVE (`aria-hidden`\n * by IconButton), so the button's name carries the count: `adminArea.waitingLabel`.\n *\n *     const area = useAdminAreaLabels();\n *     <IconButton\n *       label={waiting > 0 ? area.waitingLabel(\"Platform\", waiting) : \"Platform\"}\n *       badge={<AdminWaitingBadge count={waiting} />}\n *       …\n *     />\n *\n * Read on its own (outside an IconButton), the pill still says \", 3 waiting\" to a reader.\n */\nexport function AdminWaitingBadge({ count, labels: labelsProp, className }: AdminWaitingBadgeProps) {\n  const labels = useAdminAreaLabels(labelsProp);\n  return <WaitingBadge badge={count} labels={labels} className={className} />;\n}\n\nexport interface AdminMenuEntryOptions {\n  /** The admin area. Default `/admin`. */\n  href?: string;\n  /**\n   * The waiting count (§2.4 decision 15, §6.3): only work that waits on this admin —\n   * `adminWaitingCount(attention, […])`. `0`, `null` or none shows no badge.\n   */\n  badge?: number | null;\n  /**\n   * The resolved `adminArea` words — pass `useAdminAreaLabels()`, or the row is ENGLISH\n   * in every language: a plain function reads no provider (kastlan, 0.42 adoption). Builds\n   * no hook, so the entry can be made in the list of entries. {@link useAdminMenuEntry}\n   * (0.43) is the same entry with the provider's words read for you.\n   */\n  labels?: AdminAreaLabels;\n  /** The entry's `key`. Default `\"administration\"`. */\n  key?: string;\n  /** The page already open: `aria-current` and a check mark. */\n  current?: boolean;\n}\n\n/**\n * The \"Administration\" {@link TopBarMenuEntry}: a link row with the `ShieldCheck` icon,\n * the kit's word and the waiting count as its badge. Put it in the entries for an admin\n * only — the menu closes on the way, as any link row:\n *\n *     const labels = useAdminAreaLabels();\n *     entries={[…, ...(isAdmin ? [adminMenuEntry({ badge: waiting, labels })] : []), …]}\n *\n * A function, not a hook: it reads NO provider, so pass `labels` (`useAdminAreaLabels()`)\n * or the row says \"Administration\" in every language — or call {@link useAdminMenuEntry}\n * at the component's top.\n */\nexport function adminMenuEntry({\n  href = \"/admin\",\n  badge,\n  labels = DEFAULT_ADMIN_AREA_LABELS,\n  key = \"administration\",\n  current,\n}: AdminMenuEntryOptions = {}): TopBarMenuEntry {\n  return {\n    kind: \"link\",\n    key,\n    to: href,\n    icon: <ShieldCheck className=\"size-4\" aria-hidden />,\n    label: labels.title,\n    trailing: badgeText(badge) === null ? undefined : <WaitingBadge badge={badge} labels={labels} />,\n    current,\n  };\n}\n\nexport interface UseAdminMenuEntryOptions extends Omit<AdminMenuEntryOptions, \"labels\"> {\n  /** Over the provider's `adminArea` words: prop > `<UiKitProvider labels={{ adminArea }}>`\n   *  > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n}\n\n/**\n * {@link adminMenuEntry} with the provider's words (0.43, kastlan): the hook reads\n * `useAdminAreaLabels()` itself, so the row is in the app's language without a `labels`\n * to remember. Call it at the component's top, then put it in the entries:\n *\n *     const admin = useAdminMenuEntry({ badge: waiting });\n *     entries={[…, ...(isAdmin ? [admin] : []), …]}\n */\nexport function useAdminMenuEntry({ labels: labelsProp, ...options }: UseAdminMenuEntryOptions = {}): TopBarMenuEntry {\n  const labels = useAdminAreaLabels(labelsProp);\n  return adminMenuEntry({ ...options, labels });\n}\n\nexport interface AdminMenuRowProps {\n  /** The admin area. Default `/admin`. */\n  href?: string;\n  /** As {@link AdminMenuEntryOptions.badge}. */\n  badge?: number | null;\n  /** Runs on the way — `HoverMenu`'s `close`. */\n  onNavigate?: () => void;\n  current?: boolean;\n  /** Prop > `<UiKitProvider labels={{ adminArea }}>` > English. */\n  labels?: LabelOverride<AdminAreaLabels>;\n}\n\n/**\n * The same row as {@link adminMenuEntry} for a menu drawn from `HoverMenu` children: the\n * `<li>` holding the router-link {@link MenuItem} `TopBarActionMenu` draws for a link\n * entry, so the two menus look alike.\n *\n *     {(close) => <ul>… {isAdmin && <AdminMenuRow badge={waiting} onNavigate={close} />} …</ul>}\n */\nexport function AdminMenuRow({ href = \"/admin\", badge, onNavigate, current, labels: labelsProp }: AdminMenuRowProps) {\n  // The provider's words, as every kit part (0.43: through the namespace's own hook).\n  const labels = useAdminAreaLabels(labelsProp);\n  return (\n    <li>\n      <MenuItem\n        href={href}\n        renderLink={({ href: to, ...p }) => <Link to={to} {...p} />}\n        onClick={onNavigate ? () => onNavigate() : undefined}\n        leading={<ShieldCheck className=\"size-4\" aria-hidden />}\n        trailing={badgeText(badge) === null ? undefined : <AdminWaitingBadge count={badge} labels={labels} />}\n        current={current}\n      >\n        {labels.title}\n      </MenuItem>\n    </li>\n  );\n}\n"],"mappings":";AAwCM,cAEA,YAFA;AAxCN,SAAS,YAAY;AACrB,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AACrB,SAAS,gBAAgB;AAEzB,SAAS,2BAA2B,0BAA0B;AAY9D,SAAS,UAAU,OAAiD;AAClE,MAAI,OAAO,UAAU,YAAY,EAAE,QAAQ,GAAI,QAAO;AACtD,SAAO,QAAQ,KAAK,QAAQ,OAAO,KAAK,MAAM,KAAK,CAAC;AACtD;AAOA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,OAAO,UAAU,KAAK;AAC5B,MAAI,SAAS,KAAM,QAAO;AAC1B,SACE,qBAAC,QAAK,MAAK,MAAK,SAAQ,SAAQ,MAAK,WAAU,aAAU,eAAc,WACrE;AAAA,wBAAC,UAAK,eAAW,MAAE,gBAAK;AAAA,IAExB,qBAAC,UAAK,WAAU,iBAAgB;AAAA;AAAA,MAAG,OAAO,QAAQ,KAAe;AAAA,OAAE;AAAA,KACrE;AAEJ;AA0BO,SAAS,kBAAkB,EAAE,OAAO,QAAQ,YAAY,UAAU,GAA2B;AAClG,QAAM,SAAS,mBAAmB,UAAU;AAC5C,SAAO,oBAAC,gBAAa,OAAO,OAAO,QAAgB,WAAsB;AAC3E;AAmCO,SAAS,eAAe;AAAA,EAC7B,OAAO;AAAA,EACP;AAAA,EACA,SAAS;AAAA,EACT,MAAM;AAAA,EACN;AACF,IAA2B,CAAC,GAAoB;AAC9C,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,IAAI;AAAA,IACJ,MAAM,oBAAC,eAAY,WAAU,UAAS,eAAW,MAAC;AAAA,IAClD,OAAO,OAAO;AAAA,IACd,UAAU,UAAU,KAAK,MAAM,OAAO,SAAY,oBAAC,gBAAa,OAAc,QAAgB;AAAA,IAC9F;AAAA,EACF;AACF;AAgBO,SAAS,kBAAkB,EAAE,QAAQ,YAAY,GAAG,QAAQ,IAA8B,CAAC,GAAoB;AACpH,QAAM,SAAS,mBAAmB,UAAU;AAC5C,SAAO,eAAe,EAAE,GAAG,SAAS,OAAO,CAAC;AAC9C;AAqBO,SAAS,aAAa,EAAE,OAAO,UAAU,OAAO,YAAY,SAAS,QAAQ,WAAW,GAAsB;AAEnH,QAAM,SAAS,mBAAmB,UAAU;AAC5C,SACE,oBAAC,QACC;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,oBAAC,QAAK,IAAS,GAAG,GAAG;AAAA,MACzD,SAAS,aAAa,MAAM,WAAW,IAAI;AAAA,MAC3C,SAAS,oBAAC,eAAY,WAAU,UAAS,eAAW,MAAC;AAAA,MACrD,UAAU,UAAU,KAAK,MAAM,OAAO,SAAY,oBAAC,qBAAkB,OAAO,OAAO,QAAgB;AAAA,MACnG;AAAA,MAEC,iBAAO;AAAA;AAAA,EACV,GACF;AAEJ;","names":[]}

package/dist/shell.d.ts

@@ -12,6 +12,8 @@ export { adminMenuEntry, AdminMenuRow } from "./shell/admin-menu.js";
 export type { AdminMenuEntryOptions, AdminMenuRowProps } from "./shell/admin-menu.js";
 export { useAdminMenuEntry } from "./shell/admin-menu.js";
 export type { UseAdminMenuEntryOptions } from "./shell/admin-menu.js";
+export { AdminWaitingBadge } from "./shell/admin-menu.js";
+export type { AdminWaitingBadgeProps } from "./shell/admin-menu.js";
 export { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from "./settings/settings-layout.js";
 export type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from "./settings/settings-layout.js";
 export { useSettingsRoute, resolveSettingsLocation, settingsFromListState, SETTINGS_FROM_LIST_STATE, } from "./settings/use-settings-route.js";

package/dist/shell.js

@@ -10,6 +10,7 @@ export * from "./shell/auth-layout.js";
 import { FillHeight, FILL_HEIGHT_CLASS } from "./shell/fill-height.js";
 import { adminMenuEntry, AdminMenuRow } from "./shell/admin-menu.js";
 import { useAdminMenuEntry } from "./shell/admin-menu.js";
+import { AdminWaitingBadge } from "./shell/admin-menu.js";
 import { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from "./settings/settings-layout.js";
 import {
   useSettingsRoute,
@@ -47,6 +48,7 @@ import { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from "./shell/top-
 export {
   AccountMenuLanguage,
   AdminMenuRow,
+  AdminWaitingBadge,
   DEFAULT_LAST_VISITED_EXCLUDES,
   DEFAULT_TOP_BAR_PARTS_LABELS,
   DEV_ORIGINAL_ROLE_KEY,

package/dist/shell.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.40.0: the list page's fill (docs/page-layout-harmonization.md §1.3).\nexport { FillHeight, FILL_HEIGHT_CLASS } from \"./shell/fill-height\";\nexport type { FillHeightProps } from \"./shell/fill-height\";\n// 0.42.0: the account menu's \"Administration\" row, as an entry and as a HoverMenu row\n// (docs/admin-harmonization.md §2.1, §6.6).\nexport { adminMenuEntry, AdminMenuRow } from \"./shell/admin-menu\";\nexport type { AdminMenuEntryOptions, AdminMenuRowProps } from \"./shell/admin-menu\";\n// 0.43.0 (kastlan): the entry with the provider's words.\nexport { useAdminMenuEntry } from \"./shell/admin-menu\";\nexport type { UseAdminMenuEntryOptions } from \"./shell/admin-menu\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n// 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in\n// §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the\n// local-dev switchers, and their words.\nexport { TopBarActions, TOP_BAR_ACTION_ORDER } from \"./shell/top-bar-actions\";\nexport type { TopBarActionsProps } from \"./shell/top-bar-actions\";\nexport { AccountMenuLanguage } from \"./shell/account-menu-language\";\nexport type { AccountMenuLanguageProps, AccountMenuLanguageOption } from \"./shell/account-menu-language\";\nexport { TourMenu } from \"./shell/tour-menu\";\nexport type { TourMenuProps, TourMenuTour } from \"./shell/tour-menu\";\nexport { SyncStatusIndicator, syncState } from \"./shell/sync-status-indicator\";\nexport type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from \"./shell/sync-status-indicator\";\nexport { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from \"./shell/dev-switchers\";\nexport type { DevSwitchersProps } from \"./shell/dev-switchers\";\nexport { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from \"./shell/top-bar-parts-labels\";\nexport type {\n  TopBarPartsLabels,\n  TourMenuLabels,\n  SyncStatusLabels,\n  DevSwitchersLabels,\n} from \"./shell/top-bar-parts-labels\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,YAAY,yBAAyB;AAI9C,SAAS,gBAAgB,oBAAoB;AAG7C,SAAS,yBAAyB;AAGlC,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;AAK7B,SAAS,eAAe,4BAA4B;AAEpD,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB,iBAAiB;AAE/C,SAAS,cAAc,6BAA6B;AAEpD,SAAS,8BAA8B,4BAA4B;","names":[]}
+{"version":3,"sources":["../src/shell.ts"],"sourcesContent":["// `@eifi1/ui-kit/shell` — the composable app chrome.\n//\n// A re-slicing of the main barrel, not a new API. This entry point requires\n// `react-router`: AppShell renders NavLink and TopBarActionMenu renders Link.\nexport * from \"./shell/topbar-controls\";\nexport * from \"./shell/top-bar\";\nexport * from \"./shell/app-shell\";\nexport * from \"./shell/option-switcher-menu\";\nexport * from \"./shell/role-switcher\";\nexport * from \"./shell/topbar-action-menu\";\nexport * from \"./shell/top-bar-brand\";\nexport * from \"./shell/auth-layout\";\n// 0.40.0: the list page's fill (docs/page-layout-harmonization.md §1.3).\nexport { FillHeight, FILL_HEIGHT_CLASS } from \"./shell/fill-height\";\nexport type { FillHeightProps } from \"./shell/fill-height\";\n// 0.42.0: the account menu's \"Administration\" row, as an entry and as a HoverMenu row\n// (docs/admin-harmonization.md §2.1, §6.6).\nexport { adminMenuEntry, AdminMenuRow } from \"./shell/admin-menu\";\nexport type { AdminMenuEntryOptions, AdminMenuRowProps } from \"./shell/admin-menu\";\n// 0.43.0 (kastlan): the entry with the provider's words.\nexport { useAdminMenuEntry } from \"./shell/admin-menu\";\nexport type { UseAdminMenuEntryOptions } from \"./shell/admin-menu\";\n// 0.45.0 (docs/admin-harmonization.md §9.3.4): the row's waiting pill on its own, for\n// IconButton's `badge` (kastlan's platform button); its name is `adminArea.waitingLabel`.\nexport { AdminWaitingBadge } from \"./shell/admin-menu\";\nexport type { AdminWaitingBadgeProps } from \"./shell/admin-menu\";\n// 0.31.0: the settings and admin pages' shell (docs/settings-harmonization.md §3, §5).\nexport { SettingsLayout, SETTINGS_SEARCH_THRESHOLD } from \"./settings/settings-layout\";\nexport type { SettingsLayoutProps, SettingsLayoutWidth, SettingsDocumentTitleParts } from \"./settings/settings-layout\";\nexport {\n  useSettingsRoute,\n  resolveSettingsLocation,\n  settingsFromListState,\n  SETTINGS_FROM_LIST_STATE,\n} from \"./settings/use-settings-route\";\nexport type {\n  UseSettingsRouteOptions,\n  SettingsRoute,\n  SettingsLayoutMode,\n  SettingsLocation,\n  SettingsLocationRules,\n  SettingsLocationResult,\n} from \"./settings/use-settings-route\";\nexport { useSettingsFocus, SETTINGS_FOCUS_RING, SETTINGS_FOCUS_MS } from \"./settings/use-settings-focus\";\nexport { SettingsSection } from \"./settings/settings-section\";\nexport type { SettingsSectionProps } from \"./settings/settings-section\";\nexport { useSettingsLayout } from \"./settings/settings-context\";\nexport type { SettingsLayoutContextValue } from \"./settings/settings-context\";\nexport { SettingsHeadingLevel, useSettingsHeadingLevel } from \"./settings/settings-heading\";\nexport type { SettingsHeadingLevelProps, SettingsHeadingTag } from \"./settings/settings-heading\";\nexport {\n  settingsSearchEntries,\n  visibleSettingsGroups,\n  visibleSettingsEntries,\n  settingsHref,\n} from \"./settings/settings-catalogue\";\nexport type { SettingsGroup, SettingsEntry, SettingsSearchEntriesOptions } from \"./settings/settings-catalogue\";\n// 0.31.0: the public pages' header and the resume (docs/landing-demo-harmonization.md §3, §4.1).\nexport {\n  RootEntry,\n  RedirectIfAuthed,\n  useLastVisitedPage,\n  readLastVisitedPage,\n  clearLastVisitedPage,\n  safeNextPath,\n  NEXT_PARAM,\n  DEFAULT_LAST_VISITED_EXCLUDES,\n} from \"./landing/routing\";\nexport type {\n  RootEntryProps,\n  RedirectIfAuthedProps,\n  RoutingSession,\n  LastVisitedPageOptions,\n  PathPattern,\n} from \"./landing/routing\";\nexport { PublicHeader } from \"./landing/public-header\";\nexport type { PublicHeaderProps, PublicHeaderBrand } from \"./landing/public-header\";\n// 0.42.0: the top bar's shared parts (docs/top-bar-harmonization.md §3.1) — the slots in\n// §2.1's order, the account menu's language sub-list, the tours menu, the sync status, the\n// local-dev switchers, and their words.\nexport { TopBarActions, TOP_BAR_ACTION_ORDER } from \"./shell/top-bar-actions\";\nexport type { TopBarActionsProps } from \"./shell/top-bar-actions\";\nexport { AccountMenuLanguage } from \"./shell/account-menu-language\";\nexport type { AccountMenuLanguageProps, AccountMenuLanguageOption } from \"./shell/account-menu-language\";\nexport { TourMenu } from \"./shell/tour-menu\";\nexport type { TourMenuProps, TourMenuTour } from \"./shell/tour-menu\";\nexport { SyncStatusIndicator, syncState } from \"./shell/sync-status-indicator\";\nexport type { SyncStatus, SyncState, SyncStatusScope, SyncStatusIndicatorProps } from \"./shell/sync-status-indicator\";\nexport { DevSwitchers, DEV_ORIGINAL_ROLE_KEY } from \"./shell/dev-switchers\";\nexport type { DevSwitchersProps } from \"./shell/dev-switchers\";\nexport { DEFAULT_TOP_BAR_PARTS_LABELS, useTopBarPartsLabels } from \"./shell/top-bar-parts-labels\";\nexport type {\n  TopBarPartsLabels,\n  TourMenuLabels,\n  SyncStatusLabels,\n  DevSwitchersLabels,\n} from \"./shell/top-bar-parts-labels\";\n"],"mappings":";AAIA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAEd,SAAS,YAAY,yBAAyB;AAI9C,SAAS,gBAAgB,oBAAoB;AAG7C,SAAS,yBAAyB;AAIlC,SAAS,yBAAyB;AAGlC,SAAS,gBAAgB,iCAAiC;AAE1D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,kBAAkB,qBAAqB,yBAAyB;AACzE,SAAS,uBAAuB;AAEhC,SAAS,yBAAyB;AAElC,SAAS,sBAAsB,+BAA+B;AAE9D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,oBAAoB;AAK7B,SAAS,eAAe,4BAA4B;AAEpD,SAAS,2BAA2B;AAEpC,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB,iBAAiB;AAE/C,SAAS,cAAc,6BAA6B;AAEpD,SAAS,8BAA8B,4BAA4B;","names":[]}

package/dist/tour/tour-catalogue.d.ts

@@ -14,7 +14,12 @@ export interface TourCatalogueCardProps {
     onLaunch: (id: string) => void;
     /** "Mark as not done". Without it, the link is not drawn. */
     onReset?: (id: string) => void;
-    /** Formats the completion and update days. Default: the kit's medium date in the provider's locale. */
+    /**
+     * Formats the completion and update days. Default: the kit's medium date in the provider's locale.
+     * It gets the completion's ISO instant and the update's bare `"YYYY-MM-DD"` (`updated.date`): read
+     * the bare day on its calendar (the kit's `formatDate`, `parseIsoDate`), never `new Date(day)`,
+     * which is UTC midnight and the day before west of UTC (round 0.45, N9).
+     */
     formatDate?: (iso: string) => string;
     labels?: LabelOverride<TourCatalogueLabels>;
     className?: string;
@@ -44,6 +49,7 @@ export interface TourCatalogueProps extends TourCatalogueFilter {
     onReset?: (id: string) => void;
     /** Above the filter bar: the app's page header with its points tile (§6.1). */
     header?: ReactNode;
+    /** Each card's `formatDate`: see {@link TourCatalogueCardProps.formatDate} (a bare day for the update). */
     formatDate?: (iso: string) => string;
     /** The search's locale (case folding). Default: the provider's. */
     locale?: string;