@alfadocs/ui-kit 1.66.0 → 1.68.0

package/dist/_chunks/{warning-stack-HYWAytZV.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-DdDpOi-P.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-HYWAytZV.js.map
+//# sourceMappingURL=warning-stack-BhHUmRiD.js.map

package/dist/_chunks/{workflow-map-C2B2qIr1.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-DdDpOi-P.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-C2B2qIr1.js.map
+//# sourceMappingURL=workflow-map-ln4_OG8A.js.map

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "1.66.0",
+  "packageVersion": "1.68.0",
   "components": [
     {
       "kind": "component",
@@ -424,6 +424,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "ai-credits-exhausted-notice",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "ai-credits-exhausted-notice",
+          "description": "Marks the out-of-credits notice. Each next-step button carries `data-credits-action=\"buy|upgrade|support|costs\"`."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "ai-credits-notice",
@@ -438,6 +452,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "ai-credits-warning",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "ai-credits-warning",
+          "description": "Marks the quiet credit lines. Each line carries `data-credits-line=\"low|expiring|exhausted\"`."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "ai-prompt-input",
@@ -539,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."
         }
       }
     },
@@ -3275,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": [
@@ -3404,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\"."
         }
       }
     },
@@ -8586,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",
@@ -11936,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",
@@ -13227,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."
         }
       }
     },
@@ -16441,6 +16637,18 @@
           "type": "boolean",
           "description": "Floating layout: true when the panel above the pill is open. Always false inline.",
           "descriptionKey": "ui.agent.voiceControlPanel.state.panelOpen"
+        },
+        {
+          "name": "creditsExhausted",
+          "type": "boolean",
+          "description": "True when the practice is out of AI credits: every start shows the out-of-credits notice instead of listening.",
+          "descriptionKey": "ui.agent.voiceControlPanel.state.creditsExhausted"
+        },
+        {
+          "name": "creditsNoticeOpen",
+          "type": "boolean",
+          "description": "True when the out-of-credits notice is showing in the panel, in place of the controls.",
+          "descriptionKey": "ui.agent.voiceControlPanel.state.creditsNoticeOpen"
         }
       ],
       "actions": [
@@ -16453,14 +16661,14 @@
             "Microphone permission denied",
             "Speech service unavailable"
           ],
-          "description": "Ask the host to start listening (it opens the microphone). Does nothing when already starting or listening, or while the panel is disabled.",
+          "description": "Ask the host to start listening (it opens the microphone). Does nothing when already starting or listening, or while the panel is disabled. Without patient AI consent it shows the consent banner instead; out of AI credits (creditsExhausted) it shows the out-of-credits notice instead.",
           "descriptionKey": "ui.agent.voiceControlPanel.actions.startListening"
         },
         {
           "name": "stop_listening",
           "safety": "write",
           "idempotent": true,
-          "description": "Ask the host to stop listening, or to cancel a start. Does nothing when not starting or listening.",
+          "description": "Ask the host to stop listening, cancel a start or end a paused session. Never gated by consent or AI credits. Does nothing when idle or stopped.",
           "descriptionKey": "ui.agent.voiceControlPanel.actions.stopListening"
         },
         {
@@ -16518,6 +16726,13 @@
           "idempotent": true,
           "description": "Floating layout: close the panel above the pill. Listening carries on. Does nothing inline.",
           "descriptionKey": "ui.agent.voiceControlPanel.actions.closePanel"
+        },
+        {
+          "name": "close_credits_notice",
+          "safety": "read",
+          "idempotent": true,
+          "description": "Close the out-of-credits notice and go back to the controls. Credits stay out: the next start shows it again.",
+          "descriptionKey": "ui.agent.voiceControlPanel.actions.closeCreditsNotice"
         }
       ],
       "domHooks": {

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.",
@@ -1635,16 +1659,19 @@
         "status": "Where the host voice session is: idle, starting, listening, paused or error.",
         "candidateIds": "Ids of the matches currently offered, in spoken order (option 1 first). Empty when there is nothing to choose.",
         "commandsOpen": "True when the voice commands list is expanded.",
-        "panelOpen": "Floating layout: true when the panel above the pill is open. Always false inline."
+        "panelOpen": "Floating layout: true when the panel above the pill is open. Always false inline.",
+        "creditsExhausted": "True when the practice is out of AI credits: every start shows the out-of-credits notice instead of listening.",
+        "creditsNoticeOpen": "True when the out-of-credits notice is showing in the panel, in place of the controls."
       },
       "actions": {
-        "startListening": "Ask the host to start listening (it opens the microphone). Does nothing when already starting or listening, or while the panel is disabled.",
-        "stopListening": "Ask the host to stop listening, or to cancel a start. Does nothing when not starting or listening.",
+        "startListening": "Ask the host to start listening (it opens the microphone). Does nothing when already starting or listening, or while the panel is disabled. Without patient AI consent it shows the consent banner instead; out of AI credits (creditsExhausted) it shows the out-of-credits notice instead.",
+        "stopListening": "Ask the host to stop listening, cancel a start or end a paused session. Never gated by consent or AI credits. Does nothing when idle or stopped.",
         "pickCandidate": "Pick one of the offered matches by id, the same as saying its option number or pressing it. Unknown ids are ignored.",
         "openCommands": "Expand the voice commands list.",
         "closeCommands": "Collapse the voice commands list.",
         "openPanel": "Floating layout: open the panel above the pill. Does nothing inline.",
-        "closePanel": "Floating layout: close the panel above the pill. Listening carries on. Does nothing inline."
+        "closePanel": "Floating layout: close the panel above the pill. Listening carries on. Does nothing inline.",
+        "closeCreditsNotice": "Close the out-of-credits notice and go back to the controls. Credits stay out: the next start shows it again."
       }
     },
     "widgetPicker": {

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/ai-credits-exhausted-notice.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+export declare const aiCreditsExhaustedNoticeAgent: AgentAdapter;
+export declare const aiCreditsWarningAgent: AgentAdapter;
+//# sourceMappingURL=ai-credits-exhausted-notice.agent.d.ts.map

package/dist/components/ai-credits-notice/ai-credits-exhausted-notice.d.ts

@@ -0,0 +1,96 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type AlertAnnounce } from '../alert';
+/** Credits that expire soon: the platform's yearly allowance at the end of
+ *  the subscription term. Welcome and bought credits never expire. */
+export interface AiCreditsExpiring {
+    /** How many credits expire. */
+    amount: number;
+    /** When they expire. */
+    date: Date;
+}
+/** The practice's AI credits and the next steps the host can offer. All
+ *  optional: the kit shows only what it is given. */
+export interface AiCreditsInfo {
+    /** Credits left. */
+    remaining?: number;
+    /** The allowance `remaining` counts down from, for the meter. */
+    limit?: number;
+    /**
+     * When a new allowance starts: "renews on". On the platform, the yearly
+     * allowance at the subscription's renewal. Omit when it will not renew.
+     */
+    renewsOn?: Date;
+    /** @deprecated Use `renewsOn`. Read the same way, as a renewal date. */
+    resetsOn?: Date;
+    /**
+     * Credits that expire soon: "expire on". `AiCreditsWarning` shows it as
+     * a quiet line; the out-of-credits notice never does (nothing is left to
+     * expire).
+     */
+    expiring?: AiCreditsExpiring;
+    /**
+     * Shows the running-low line in `AiCreditsWarning`. Default: true when
+     * 80% or more of `limit` is used and some credit is left. A host whose
+     * balance mixes the yearly allowance with welcome or bought credits
+     * passes it itself: 80% of one `limit` does not describe that balance.
+     */
+    runningLow?: boolean;
+    /**
+     * Shows a "Buy AI credits" button. Omit while the practice cannot buy
+     * credits (on the platform, without the module and the pack page).
+     */
+    onBuyCredits?: () => void;
+    /**
+     * Shows an "Enable the AI credits module" button: the upgrade path for a
+     * practice without the module.
+     */
+    onUpgrade?: () => void;
+    /** Shows a "Contact support" button. */
+    onContactSupport?: () => void;
+    /** Shows a "See what each action costs" link. */
+    onSeeCosts?: () => void;
+}
+/** Heading levels the notice title accepts. */
+export type AiCreditsHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/** Whether `credits` are running low: the host's `runningLow`, else 80% or
+ *  more of `limit` used with some credit left. */
+export declare function isAiCreditsRunningLow(credits?: AiCreditsInfo): boolean;
+export interface AiCreditsExhaustedNoticeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** The allowance and the next steps the host can offer. */
+    credits?: AiCreditsInfo;
+    /** Shows a Back button under the notice. */
+    onBack?: () => void;
+    /** A quiet line under the notice, beside Back: what the user keeps. */
+    footnote?: ReactNode;
+    /** Heading level of the title. Default 2. */
+    headingLevel?: AiCreditsHeadingLevel;
+    /**
+     * How the notice is announced when it appears. Default: the promo
+     * Alert's polite status. Pass `'off'` when the host announces it.
+     */
+    announce?: AlertAnnounce;
+}
+/**
+ * The out-of-credits state: what happened, the allowance, and the next
+ * step. The first of buy, enable the module and contact support the host
+ * passes is the main button; any others follow as links. With none, it
+ * says when AI comes back, or plainly that it is unavailable and how to
+ * get help: never a dead end.
+ */
+export declare const AiCreditsExhaustedNotice: import("react").ForwardRefExoticComponent<AiCreditsExhaustedNoticeProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AiCreditsWarningProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** The allowance, the expiring credits and the next steps. */
+    credits?: AiCreditsInfo;
+    /**
+     * Out of credits: one quiet line saying so, instead of the running-low
+     * and expiring lines. The full notice is `AiCreditsExhaustedNotice`.
+     */
+    exhausted?: boolean;
+}
+/**
+ * The quiet, non-blocking credit lines: running low (with the buy or
+ * upgrade step as a link) and credits expiring, or out of credits at rest.
+ * Renders nothing when none applies.
+ */
+export declare const AiCreditsWarning: import("react").ForwardRefExoticComponent<AiCreditsWarningProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=ai-credits-exhausted-notice.d.ts.map

package/dist/components/ai-credits-notice/ai-credits-notice.d.ts

@@ -1,9 +1,12 @@
-import { type HTMLAttributes } from 'react';
+import { type HTMLAttributes, type ReactNode } from 'react';
 /** The practice's current AI allowance, when the host tracks one. */
 export interface AiCreditsNoticeAllowance {
-    /** AI actions left in the current period. */
+    /** AI credits left. */
     remaining: number;
-    /** The monthly cap. */
+    /**
+     * The allowance `remaining` counts down from, whatever its period (on
+     * the platform, a yearly allowance).
+     */
     limit: number;
     /** When the allowance next resets. Omit if unknown. */
     resetsOn?: Date;
@@ -12,7 +15,7 @@ interface AiCreditsNoticeSharedProps {
     /**
      * The practice's current AI allowance. In `included` mode it renders as an
      * optional usage line + meter; in `bundles` mode it drives the heading
-     * ("{{remaining}} of {{limit}} credits") and the free-tier line in the
+     * ("{{remaining}} of {{limit}} credits") and the allowance line in the
      * body. Omit either mode's allowance to fall back to a generic line.
      */
     allowance?: AiCreditsNoticeAllowance;
@@ -44,5 +47,28 @@ export interface AiCreditsNoticeBundlesProps extends AiCreditsNoticeSharedProps
 }
 export type AiCreditsNoticeProps = AiCreditsNoticeIncludedProps | AiCreditsNoticeBundlesProps;
 export declare const AiCreditsNotice: import("react").ForwardRefExoticComponent<(AiCreditsNoticeProps & Omit<HTMLAttributes<HTMLDivElement>, "className">) & import("react").RefAttributes<HTMLDivElement>>;
+/** Which side of the trigger the card opens on. A trigger fixed to the
+ *  bottom of the viewport (the VoiceControlPanel pill) opens it on top. */
+export type AiActionHoverCardSide = 'top' | 'bottom';
+/**
+ * Wraps `trigger` in the credits notice when `notice` is given, else returns
+ * it unchanged: the one seam every kit AI trigger goes through (the
+ * RichTextEditor's pill, bubble and mics, and the VoiceControlPanel's mic).
+ * Internal to the kit: not exported from the component's index.
+ */
+export declare function withAiCreditsNotice(trigger: ReactNode, notice: AiCreditsNoticeProps | undefined, side?: AiActionHoverCardSide): ReactNode;
+/**
+ * "Don't show again" (`onDismiss`) stops the card on EVERY trigger for the
+ * rest of this mount, not just the trigger it was dismissed from. Scoped to
+ * the MODE that was dismissed: `included` and `bundles` are different
+ * messages, so a host that flips the same mounted component's mode (for
+ * example once bundles ship) must see the new one, matching the
+ * mode-scoped storage key the docs tell a host to use across a remount. A
+ * SET, not a single slot: dismissing both modes in turn must remember both.
+ * Reset only by remounting; a host that wants a dismissal to survive a
+ * reload persists it itself and omits the notice on the next mount. Moved
+ * here from RichTextEditor so VoiceControlPanel shares it.
+ */
+export declare function useDismissibleAiCreditsNotice(notice: AiCreditsNoticeProps | undefined): AiCreditsNoticeProps | undefined;
 export {};
 //# sourceMappingURL=ai-credits-notice.d.ts.map

package/dist/components/ai-credits-notice/index.d.ts

@@ -1,4 +1,7 @@
 export { AiCreditsNotice } from './ai-credits-notice';
 export type { AiCreditsNoticeProps, AiCreditsNoticeIncludedProps, AiCreditsNoticeBundlesProps, AiCreditsNoticeAllowance, } from './ai-credits-notice';
 export { aiCreditsNoticeAgent } from './ai-credits-notice.agent';
+export { AiCreditsExhaustedNotice, AiCreditsWarning, isAiCreditsRunningLow, } from './ai-credits-exhausted-notice';
+export type { AiCreditsExhaustedNoticeProps, AiCreditsWarningProps, AiCreditsInfo, AiCreditsExpiring, AiCreditsHeadingLevel, } from './ai-credits-exhausted-notice';
+export { aiCreditsExhaustedNoticeAgent, aiCreditsWarningAgent, } from './ai-credits-exhausted-notice.agent';
 //# sourceMappingURL=index.d.ts.map