@alfadocs/ui-kit 1.67.0 → 1.68.0

package/dist/_chunks/use-dismissed-CTOWqA0e.js

@@ -0,0 +1,177 @@
+import { useMemo as b, useSyncExternalStore as v, useCallback as g } from "react";
+const f = "alfadocs-ui.dismissed.", _ = 720 * 60 * 60 * 1e3, S = 200, c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), M = 2 ** 31 - 1;
+let a = null;
+function m() {
+  if (typeof window > "u") return null;
+  try {
+    return window.localStorage;
+  } catch {
+    return null;
+  }
+}
+function w(t) {
+  return typeof t == "string" && t.length > 0 ? t : void 0;
+}
+function E(t, e) {
+  if (e === Number.POSITIVE_INFINITY) return null;
+  const n = e !== void 0 && Number.isFinite(e) && e > 0 ? e : _;
+  return t + n;
+}
+function p(t) {
+  if (t === null) return null;
+  try {
+    const e = JSON.parse(t);
+    if (e !== null && typeof e == "object" && typeof e.at == "number") {
+      const n = e.until;
+      return {
+        at: e.at,
+        until: typeof n == "number" ? n : null
+      };
+    }
+  } catch {
+  }
+  return "legacy";
+}
+const I = (t, e) => t !== null && t <= e;
+function D(t) {
+  const e = Date.now();
+  if (l.has(t)) {
+    if (!I(l.get(t) ?? null, e)) return !0;
+    l.delete(t);
+  }
+  const n = m();
+  if (!n) return !1;
+  try {
+    const o = p(n.getItem(f + t));
+    return o === null ? !1 : o === "legacy" || !I(o.until, e) ? !0 : (n.removeItem(f + t), !1);
+  } catch {
+    return !1;
+  }
+}
+function O(t, e) {
+  try {
+    const n = [], o = [], r = [];
+    for (let i = 0; i < t.length; i += 1) {
+      const s = t.key(i);
+      if (s === null || !s.startsWith(f)) continue;
+      const u = p(t.getItem(s));
+      u !== null && (u === "legacy" ? (r.push(s), n.push({ name: s, at: e })) : I(u.until, e) ? o.push(s) : n.push({ name: s, at: u.at }));
+    }
+    for (const i of r) {
+      const s = {
+        at: e,
+        until: E(e, void 0)
+      };
+      t.setItem(i, JSON.stringify(s));
+    }
+    if (n.length > S) {
+      n.sort((i, s) => i.at - s.at);
+      for (const { name: i } of n.slice(0, n.length - S))
+        o.push(i);
+    }
+    for (const i of o) t.removeItem(i);
+  } catch {
+  }
+}
+function N() {
+  for (const t of c.keys()) t();
+}
+function F(t) {
+  if (l.has(t)) return l.get(t) ?? null;
+  const e = m();
+  if (!e) return null;
+  try {
+    const n = p(e.getItem(f + t));
+    return n === null || n === "legacy" ? null : n.until;
+  } catch {
+    return null;
+  }
+}
+function d() {
+  if (a !== null && (clearTimeout(a), a = null), typeof window > "u" || c.size === 0) return;
+  const t = Date.now();
+  let e = Number.POSITIVE_INFINITY;
+  for (const n of c.values())
+    for (const o of n) {
+      const r = F(o);
+      r !== null && r > t && r < e && (e = r);
+    }
+  e !== Number.POSITIVE_INFINITY && (a = setTimeout(
+    () => {
+      a = null, N(), d();
+    },
+    Math.min(e - t, M)
+  ));
+}
+function y() {
+  N(), d();
+}
+function x(t, e) {
+  const n = Date.now(), o = {
+    at: n,
+    until: E(n, e)
+  }, r = m();
+  let i = !1;
+  if (r) {
+    try {
+      r.setItem(f + t, JSON.stringify(o)), i = !0;
+    } catch {
+      i = !1;
+    }
+    i && O(r, n);
+  }
+  i ? l.delete(t) : l.set(t, o.until), y();
+}
+function A(t) {
+  l.delete(t);
+  const e = m();
+  if (e)
+    try {
+      e.removeItem(f + t);
+    } catch {
+    }
+  y();
+}
+function h(t) {
+  (t.key === null || t.key.startsWith(f)) && y();
+}
+function T(t) {
+  return (e) => (c.set(e, t), c.size === 1 && typeof window < "u" && window.addEventListener("storage", h), d(), () => {
+    c.delete(e), c.size === 0 && typeof window < "u" && window.removeEventListener("storage", h), d();
+  });
+}
+function L(t, e) {
+  const n = w(t), o = e == null ? void 0 : e.lifetimeMs, r = b(
+    () => T(n === void 0 ? [] : [n]),
+    [n]
+  ), i = v(
+    r,
+    () => n === void 0 ? !1 : D(n),
+    () => n !== void 0
+  ), s = g(() => {
+    n !== void 0 && x(n, o);
+  }, [n, o]), u = g(() => {
+    n !== void 0 && A(n);
+  }, [n]);
+  return { dismissed: i, dismiss: s, restore: u };
+}
+function P(t) {
+  const e = t.map(w), n = e.filter((s) => s !== void 0), o = JSON.stringify(n), r = b(
+    () => T(JSON.parse(o)),
+    [o]
+  ), i = v(
+    r,
+    () => e.map((s) => s !== void 0 && D(s) ? "1" : "0").join(""),
+    () => e.map((s) => s !== void 0 ? "1" : "0").join("")
+  );
+  return e.map((s, u) => i[u] === "1");
+}
+export {
+  _ as D,
+  S as a,
+  f as b,
+  w as c,
+  P as d,
+  L as u
+};
+//# sourceMappingURL=use-dismissed-CTOWqA0e.js.map

package/dist/_chunks/{voice-control-panel-BJIEbDq6.js → voice-control-panel-B8Lrk0C4.js}

@@ -3,8 +3,8 @@ import { forwardRef as on, useId as $e, useState as I, useRef as r, useMemo as j
 import { c as K } from "./index-D2ZczOXr.js";
 import { useTranslation as sn, Trans as rn } from "react-i18next";
 import { u as an, w as cn } from "./ai-credits-notice-DQ-r3iQU.js";
-import { A as ln, a as dn } from "./ai-credits-exhausted-notice-DfAgfZDF.js";
-import { A as un } from "./ai-permission-notice-qsdm4Sx4.js";
+import { A as ln, a as dn } from "./ai-credits-exhausted-notice-Bg8NpW2K.js";
+import { A as un } from "./ai-permission-notice-C00i6VhY.js";
 import { A as fn } from "./ai-sparkle-D23NT8Z_.js";
 import { B as pn } from "./badge-BUk4RjTS.js";
 import { B as qe } from "./button-D-MQxsA_.js";
@@ -14,7 +14,7 @@ import { F as yn } from "./form-field-Ani72sVY.js";
 import { K as bn } from "./kbd-Bx7eQv9f.js";
 import { L as pe } from "./list-CNnn7DOD.js";
 import { L as xn } from "./live-region-C41SO3cA.js";
-import { S as wn } from "./select-k4gBdS8N.js";
+import { S as wn } from "./select-4S-eYZUf.js";
 import { a as Nn, b as Ct, c as Cn, d as kn } from "./ai-fab-pill-BOu96kCx.js";
 import { c as An } from "./compose-refs-C0k0tdqF.js";
 import { g as Rn, a as En } from "./glass-surface-CPok0jEe.js";
@@ -1145,4 +1145,4 @@ export {
   no as V,
   Gn as v
 };
-//# sourceMappingURL=voice-control-panel-BJIEbDq6.js.map
+//# sourceMappingURL=voice-control-panel-B8Lrk0C4.js.map

package/dist/_chunks/{warning-stack-BdY-0bd3.js → warning-stack-BhHUmRiD.js}

@@ -3,7 +3,7 @@ import { forwardRef as dn, useId as P, useState as y, useEffect as f, useMemo as
 import { c as cn } from "./index-D2ZczOXr.js";
 import { useTranslation as ln } from "react-i18next";
 import { u as un } from "./use-isomorphic-layout-effect-BGfaCOP1.js";
-import { A as C } from "./alert-DjsJMGRE.js";
+import { A as C } from "./alert-9kEwDza3.js";
 import { B as fn } from "./button-D-MQxsA_.js";
 import { I as mn } from "./icon-button-C_1TgRiK.js";
 import { X as gn } from "./x-B5YnXwCz.js";
@@ -270,4 +270,4 @@ Nn.displayName = "WarningStack";
 export {
   Nn as W
 };
-//# sourceMappingURL=warning-stack-BdY-0bd3.js.map
+//# sourceMappingURL=warning-stack-BhHUmRiD.js.map

package/dist/_chunks/{workflow-map-CYbRD9ek.js → workflow-map-ln4_OG8A.js}

@@ -13,7 +13,7 @@ import { T as ae } from "./trash-2-uumy3fy1.js";
 import { C as Ne } from "./circle-dashed-CUj6o2cA.js";
 import { C as Ce } from "./circle-j7oZoouK.js";
 import { u as _e } from "./registry-DvAUVLHh.js";
-import { A as V } from "./alert-DjsJMGRE.js";
+import { A as V } from "./alert-9kEwDza3.js";
 import { B as Se } from "./button-D-MQxsA_.js";
 import { D as N } from "./dropdown-menu-D1we7oAY.js";
 import { E } from "./empty-state-pL1qum99.js";
@@ -1321,4 +1321,4 @@ export {
   ee as r,
   D as w
 };
-//# sourceMappingURL=workflow-map-CYbRD9ek.js.map
+//# sourceMappingURL=workflow-map-ln4_OG8A.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.67.0",
+  "packageVersion": "1.68.0",
   "components": [
     {
       "kind": "component",
@@ -567,7 +567,7 @@
         "root": {
           "attr": "data-component",
           "value": "alert",
-          "description": "Marks the element as a kit Alert. The root also emits `data-state=\"open\" | \"closing\"` while the dismiss animation runs. Alerts inherit native `id` from props, which is what agents address them by."
+          "description": "Marks the element as a kit Alert. The root also emits `data-state=\"open\" | \"closing\"` while the dismiss animation runs. Alerts inherit native `id` from props, which is what agents address them by. An alert with `dismissKey` that was dismissed in this browser is not rendered at all."
         }
       }
     },
@@ -3303,6 +3303,12 @@
           "type": "string | null",
           "description": "The widget the host has marked (for example while its settings are open), or null. Set by the host, not by agents.",
           "descriptionKey": "ui.agent.dashboardGrid.state.selectedId"
+        },
+        {
+          "name": "loadingIds",
+          "type": "string[]",
+          "description": "Ids of the widgets still waiting for their figures (the host set loading). Their bodies show placeholders, so read their values only once they leave this list. Set by the host, not by agents.",
+          "descriptionKey": "ui.agent.dashboardGrid.state.loadingIds"
         }
       ],
       "actions": [
@@ -3432,7 +3438,7 @@
         },
         "item": {
           "attr": "data-widget-id",
-          "description": "Each widget wrapper carries its layout id."
+          "description": "Each widget wrapper carries its layout id. While its figures load it also carries data-loading=\"true\" and aria-busy=\"true\"."
         }
       }
     },
@@ -8614,6 +8620,75 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "notice-group",
+      "capabilities": [
+        "expand"
+      ],
+      "state": [
+        {
+          "name": "noteCount",
+          "type": "number",
+          "description": "How many folding notes (not errors or progress notices) are still shown, dismissed ones excluded.",
+          "descriptionKey": "ui.agent.noticeGroup.state.noteCount"
+        },
+        {
+          "name": "grouped",
+          "type": "boolean",
+          "description": "True while the notes sit behind one summary row (two or more notes).",
+          "descriptionKey": "ui.agent.noticeGroup.state.grouped"
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "description": "Whether the summary row is open (expanded), so every note is visible.",
+          "descriptionKey": "ui.agent.noticeGroup.state.open"
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_open",
+          "safety": "read",
+          "argsType": "open",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "open": {
+                "type": "boolean",
+                "description": "True to show every note, false to fold them."
+              }
+            },
+            "required": [
+              "open"
+            ]
+          },
+          "returns": "boolean (applied)",
+          "returnsSchema": {
+            "type": "boolean",
+            "description": "True when applied (with a controlled open, when asked of the host); false when there is no summary row (fewer than two notes)."
+          },
+          "idempotent": true,
+          "errors": [
+            "Fewer than two notes (grouped is false): returns false."
+          ],
+          "description": "Open (expand) or fold the notes behind the summary row. With a controlled open the host decides.",
+          "descriptionKey": "ui.agent.noticeGroup.actions.setOpen"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "notice-group",
+          "description": "Marks the NoticeGroup. Carries data-grouped=\"true\" while the notes fold behind the summary row, whose Alert carries data-notice-group-summary."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "notification-card",
@@ -11964,6 +12039,99 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "progress-notice",
+      "capabilities": [
+        "expand",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "number",
+          "description": "Progress so far, in the units of max.",
+          "descriptionKey": "ui.agent.progressNotice.state.value"
+        },
+        {
+          "name": "max",
+          "type": "number",
+          "description": "The value at which the import is done.",
+          "descriptionKey": "ui.agent.progressNotice.state.max"
+        },
+        {
+          "name": "complete",
+          "type": "boolean",
+          "description": "True once every item is ready or the value has reached max.",
+          "descriptionKey": "ui.agent.progressNotice.state.complete"
+        },
+        {
+          "name": "readyCount",
+          "type": "number",
+          "description": "How many items in the details list are ready.",
+          "descriptionKey": "ui.agent.progressNotice.state.readyCount"
+        },
+        {
+          "name": "itemCount",
+          "type": "number",
+          "description": "How many items the details list has (0: no list).",
+          "descriptionKey": "ui.agent.progressNotice.state.itemCount"
+        },
+        {
+          "name": "detailsOpen",
+          "type": "boolean",
+          "description": "Whether the details list is open.",
+          "descriptionKey": "ui.agent.progressNotice.state.detailsOpen"
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_details_open",
+          "safety": "read",
+          "argsType": "open",
+          "argsSchema": {
+            "type": "object",
+            "properties": {
+              "open": {
+                "type": "boolean",
+                "description": "True to open the details list, false to close it."
+              }
+            },
+            "required": [
+              "open"
+            ]
+          },
+          "returns": "boolean (applied)",
+          "returnsSchema": {
+            "type": "boolean",
+            "description": "True when applied; false when the notice has no list."
+          },
+          "idempotent": true,
+          "errors": [
+            "No details list (itemCount is 0): returns false."
+          ],
+          "description": "Open or close the details list of the import.",
+          "descriptionKey": "ui.agent.progressNotice.actions.setDetailsOpen"
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "progress-notice",
+          "description": "Marks the ProgressNotice. Also carries data-complete=\"true\" once the import is complete. The notice inside is a kit Alert; its close control is [data-alert-dismiss]."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-item-id",
+          "sourceProp": "items[].id",
+          "description": "Each row of the details list, from ProgressNoticeItem.id. A ready row also carries data-ready=\"true\"."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "province-select",
@@ -13255,7 +13423,7 @@
         "root": {
           "attr": "data-component",
           "value": "skeleton",
-          "description": "Marks the element as a kit Skeleton placeholder."
+          "description": "Marks the element as a kit Skeleton placeholder. A preset root also carries data-preset: figure, line-chart, bar-chart, heatmap, table or list. Decorative; the busy region around it says what is loading."
         }
       }
     },

package/dist/agent-i18n/en.json

@@ -406,7 +406,8 @@
         "cols": "Logical column count of the board.",
         "editing": "Whether edit mode is on. Move/resize actions are refused while it is off — the host app owns the toggle.",
         "stacked": "Whether the board is narrower than its stackBelow width and shows its widgets as one read-only column. Move/resize actions are unavailable while it is true, even in edit mode; the saved layout is unchanged.",
-        "selectedId": "The widget the host has marked (for example while its settings are open), or null. Set by the host, not by agents."
+        "selectedId": "The widget the host has marked (for example while its settings are open), or null. Set by the host, not by agents.",
+        "loadingIds": "Ids of the widgets still waiting for their figures (the host set loading). Their bodies show placeholders, so read their values only once they leave this list. Set by the host, not by agents."
       },
       "actions": {
         "revealWidget": "Scroll a widget into view (its scrolling ancestor and the window) and highlight it briefly. Works in view and edit mode, and for a widget added a moment ago. Does not move focus.",
@@ -874,6 +875,16 @@
         "toggleFlag": "Toggle the flagged state of the note with the given id. Returns the host's promise; a refusal restores the flag and the panel shows the host's message. Rejects without reaching the host when the panel refuses: a deleted note, or a write for the note still pending."
       }
     },
+    "noticeGroup": {
+      "state": {
+        "noteCount": "How many folding notes (not errors or progress notices) are still shown, dismissed ones excluded.",
+        "grouped": "True while the notes sit behind one summary row (two or more notes).",
+        "open": "Whether the summary row is open (expanded), so every note is visible."
+      },
+      "actions": {
+        "setOpen": "Open (expand) or fold the notes behind the summary row. With a controlled open the host decides."
+      }
+    },
     "notificationTray": {
       "state": {
         "items": "Currently-displayed notifications. Ids + read flag only — no PHI.",
@@ -1185,6 +1196,19 @@
         "close": "Close the product-updates panel."
       }
     },
+    "progressNotice": {
+      "state": {
+        "value": "Progress so far, in the units of max.",
+        "max": "The value at which the import is done.",
+        "complete": "True once every item is ready or the value has reached max.",
+        "readyCount": "How many items in the details list are ready.",
+        "itemCount": "How many items the details list has (0: no list).",
+        "detailsOpen": "Whether the details list is open."
+      },
+      "actions": {
+        "setDetailsOpen": "Open or close the details list of the import."
+      }
+    },
     "progress": {
       "state": {
         "value": "The figure the bar currently shows, in the same units as the `max` prop (default max 100) — including a value written imperatively by `set_value`. Null while indeterminate.",

package/dist/components/_shared/format-number.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared number formatter for figures the kit shows or announces: a rating,
+ * a file size, an angle, a contrast ratio. Use it instead of `toFixed`,
+ * which always writes a dot, and instead of a bare `Intl.NumberFormat`,
+ * which shows English digits in Albanian on Chromium (no Albanian number
+ * data there; see `numberLocale`).
+ *
+ * The UI language goes through `canonicalLocale` first, so a host's POSIX
+ * tag (`it_IT.UTF-8`) formats as Italian rather than throwing.
+ */
+/** `value` in the UI `language`, with the given `Intl` options. */
+export declare function formatNumber(value: number, language: string | undefined, options?: Intl.NumberFormatOptions): string;
+/**
+ * A star rating as the kit writes it everywhere: at most one decimal, in
+ * the language's own separator ("4,6" in Italian, "4.6" in English, "5"
+ * for a whole number). Rating, OperatorHero and every hero or card that
+ * shows a score use this, so visible text and aria-labels always agree.
+ */
+export declare function formatRating(value: number, language: string | undefined): string;
+//# sourceMappingURL=format-number.d.ts.map

package/dist/components/_shared/length-token.d.ts

@@ -0,0 +1,12 @@
+import { type RefObject } from 'react';
+/**
+ * A length token (`--spacing-lg`) in px, as `context` resolves it, for an
+ * API that takes only a number: Radix `collisionPadding`, say. The token
+ * is read from the element (so a theme root or a host override applies)
+ * and may be px (host-compat writes px) or rem (the kit's own sheet).
+ * Anything else, or no DOM, gives `fallback`.
+ */
+export declare function lengthTokenPx(token: string, context: Element | null, fallback: number): number;
+/** {@link lengthTokenPx} for the element behind `ref`, read after mount. */
+export declare function useLengthTokenPx(token: string, ref: RefObject<Element | null>, fallback: number): number;
+//# sourceMappingURL=length-token.d.ts.map

package/dist/components/_shared/option.d.ts

@@ -7,6 +7,7 @@ export interface OptionShape<T extends string = string> {
     disabled?: boolean;
     description?: string;
     descriptionTone?: OptionDescriptionTone;
+    dir?: 'auto' | 'ltr' | 'rtl';
     startAdornment?: ReactNode;
     endContent?: ReactNode;
 }

package/dist/components/address-fields/index.js

@@ -1,4 +1,4 @@
-import { A as e, a } from "../../_chunks/address-fields-CJtu7LQU.js";
+import { A as e, a } from "../../_chunks/address-fields-BUPRs3n-.js";
 export {
   e as AddressFields,
   a as addressFieldsAgent

package/dist/components/agenda-card/index.js

@@ -1,4 +1,4 @@
-import { A as e } from "../../_chunks/agenda-card-DR9gDdKp.js";
+import { A as e } from "../../_chunks/agenda-card-BDuvreCe.js";
 import { a as d } from "../../_chunks/agenda-card.agent-Cb5tuEh3.js";
 import { i as g } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {

package/dist/components/agenda-tray/index.js

@@ -1,4 +1,4 @@
-import { A as r, a as g } from "../../_chunks/agenda-tray-DGB1Zup-.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-CfwylhWf.js";
 export {
   r as AgendaTray,
   g as agendaTrayAgent

package/dist/components/ai-credits-notice/index.js

@@ -1,6 +1,6 @@
 import { A as t } from "../../_chunks/ai-credits-notice-DQ-r3iQU.js";
 import { a, b as r, c as o } from "../../_chunks/ai-credits-exhausted-notice.agent-DgTSTgez.js";
-import { A as d, a as A, i as C } from "../../_chunks/ai-credits-exhausted-notice-DfAgfZDF.js";
+import { A as d, a as A, i as C } from "../../_chunks/ai-credits-exhausted-notice-Bg8NpW2K.js";
 export {
   d as AiCreditsExhaustedNotice,
   t as AiCreditsNotice,

package/dist/components/ai-permission-notice/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o } from "../../_chunks/ai-permission-notice-qsdm4Sx4.js";
+import { A as e, a as o } from "../../_chunks/ai-permission-notice-C00i6VhY.js";
 export {
   e as AiConsentBanner,
   o as aiConsentBannerAgent

package/dist/components/ai-prompt-input/index.js

@@ -1,4 +1,4 @@
-import { A as a, a as o } from "../../_chunks/ai-prompt-input-DSGSe4LH.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input-DzgyoKyk.js";
 export {
   a as AIPromptInput,
   o as aiPromptInputAgent

package/dist/components/alert/alert.d.ts

@@ -20,8 +20,34 @@ interface AlertTitleProps extends HTMLAttributes<HTMLHeadingElement> {
 export type AlertAnnounce = 'off' | 'polite' | 'assertive';
 export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'>, VariantProps<typeof alertVariants> {
     variant?: 'info' | 'success' | 'warning' | 'error' | 'promo';
+    /** Shows the close button. Defaults to true when `dismissKey` is set. */
     dismissible?: boolean;
+    /**
+     * Remember a dismissal in this browser. Dismissing stores the key (in
+     * `localStorage`, under `alfadocs-ui.dismissed.`), and the alert stays
+     * hidden for that key from then on, even when `open` is true. A new key
+     * shows it again, so put the condition in the key, for example
+     * `hours-${hoursVersion}`. The key is stored as written in plain
+     * browser storage: never put personal or patient data in it. Where
+     * storage is unavailable the dismissal lasts for this page only.
+     * Errors should not be dismissible. A dismissal lasts 30 days (see
+     * `dismissLifetimeMs`), and the kit keeps at most 200, oldest out first.
+     */
+    dismissKey?: string;
+    /**
+     * How long a `dismissKey` dismissal lasts, in ms. Defaults to 30 days
+     * (`DISMISSED_DEFAULT_LIFETIME_MS`). `Infinity` keeps it until the cap
+     * drops it. Stored with the dismissal, so changing it later affects
+     * only new dismissals.
+     */
+    dismissLifetimeMs?: number;
+    /** Controlled visibility. `false` hides the alert whatever `dismissKey` says. */
     open?: boolean;
+    /**
+     * Fires `false` when the user dismisses the alert. With `dismissKey`
+     * the stored key hides it, so an uncontrolled alert returns by itself
+     * on a new key; a host that sets `open` to false here must set it back.
+     */
     onOpenChange?: (open: boolean) => void;
     icon?: ReactNode;
     /** Announcement urgency — sets `role` **and** `aria-live` together, so the

package/dist/components/alert/index.js

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/alert-DjsJMGRE.js";
+import { A as o } from "../../_chunks/alert-9kEwDza3.js";
 export {
   o as Alert
 };

package/dist/components/anamnesis-summary-card/index.js

@@ -1,4 +1,4 @@
-import { A as r, a as s } from "../../_chunks/anamnesis-summary-card-CMzBLTiN.js";
+import { A as r, a as s } from "../../_chunks/anamnesis-summary-card-DQ3iE1gD.js";
 export {
   r as AnamnesisSummaryCard,
   s as anamnesisSummaryCardAgent

package/dist/components/appointment-card/index.js

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-CL32sux-.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-qtpJt8e0.js";
+import { A as p } from "../../_chunks/appointment-card-5JMWi9_f.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-B3PDER3I.js";
 import { i } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
   p as AppointmentCard,

package/dist/components/appointment-details-panel/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as n, p, u as s } from "../../_chunks/use-appointment-details-read-CVSPoP5j.js";
+import { A as e, a as n, p, u as s } from "../../_chunks/use-appointment-details-read-CUGfE0hV.js";
 export {
   e as AppointmentDetailsPanel,
   n as appointmentDetailsPanelAgent,

package/dist/components/appointment-peek/index.js

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/appointment-peek-B5mcDcXt.js";
+import { A as o } from "../../_chunks/appointment-peek-D5XCfYKu.js";
 import { a as n } from "../../_chunks/appointment-peek.agent-C539tNFM.js";
 export {
   o as AppointmentPeek,