@alfadocs/ui-kit 1.65.0 → 1.67.0

package/dist/components/heatmap/heatmap-model.d.ts

@@ -1,4 +1,4 @@
-import { type AggregateResult, type HeatmapAggregate } from './heatmap-scale';
+import { type HeatmapAggregate } from './heatmap-scale';
 /** One row of the heatmap. */
 export interface HeatmapRow {
     /** Stable, opaque id. Emitted in DOM hooks, so never a name. */
@@ -97,6 +97,10 @@ export interface ModelCell {
     count?: number;
     label?: string;
     status: HeatmapCellStatus;
+    /** A total withheld to protect hidden cells. Its status stays
+     *  `low-sample`, but it may rest on many records, so it is worded apart
+     *  from a cell that is too few to show. */
+    withheld?: true;
 }
 /** How rows are ordered (within their group when grouped). */
 export type HeatmapSortRows = 'none' | 'label' | 'total-asc' | 'total-desc';
@@ -110,26 +114,114 @@ export declare function buildMatrix(rows: readonly HeatmapRow[], columns: readon
 export declare function shownValues(matrix: readonly ModelCell[][]): number[];
 /** Whether at least one cell carries data (a value or a low sample). */
 export declare function hasAnyData(matrix: readonly ModelCell[][]): boolean;
+/**
+ * Which total `getTotal` is asked for, with the rows, columns and group it
+ * covers. `method` is how the kit combines the cells for it: the
+ * `rowTotals` method for a row, a group and the grand total, the
+ * `columnTotals` method for a column, and the column method (else the row
+ * method) for a group header cell.
+ */
+export type HeatmapTotalScope = {
+    /** A row's total, in the totals column. */
+    kind: 'row';
+    method: HeatmapAggregate;
+    row: HeatmapRow;
+    rowId: string;
+    /** Index into the `rows` prop. */
+    rowIndex: number;
+} | {
+    /** A column's total, in the totals row. */
+    kind: 'column';
+    method: HeatmapAggregate;
+    column: HeatmapColumn;
+    columnId: string | number;
+    /** Index into the `columns` prop. */
+    columnIndex: number;
+} | {
+    /** A group's total, in the totals column of its header row. */
+    kind: 'group';
+    method: HeatmapAggregate;
+    /** The id the group's rows carry in `group`. */
+    groupId: string;
+    /** The group's entry in `groups`, when it has one. */
+    group?: HeatmapGroup;
+    /** The group's rows, in the order of the `rows` prop. */
+    rows: readonly HeatmapRow[];
+    rowIndexes: readonly number[];
+} | {
+    /** One column's total within a group, in the group's header row. */
+    kind: 'group-column';
+    method: HeatmapAggregate;
+    groupId: string;
+    group?: HeatmapGroup;
+    rows: readonly HeatmapRow[];
+    rowIndexes: readonly number[];
+    column: HeatmapColumn;
+    columnId: string | number;
+    columnIndex: number;
+} | {
+    /** The grand total of every cell, in the corner. */
+    kind: 'grand';
+    method: HeatmapAggregate;
+};
+/** Returns a total, or undefined to let the kit work it out from the cells. */
+export type HeatmapGetTotal = (scope: HeatmapTotalScope) => HeatmapCellInput | undefined;
+/**
+ * Every margin, ready to render. A withheld total is `{ value: null,
+ * status: 'low-sample', withheld: true }`: no value and no count, so
+ * nothing that reads it (the grid, the table view, a sort by total) can
+ * pass one on.
+ */
 export interface HeatmapTotals {
     /** Per row index (props order), by the row method. */
-    rows: AggregateResult[];
+    rows: ModelCell[];
     /** Per column index, by the column method. */
-    columns: AggregateResult[];
+    columns: ModelCell[];
     /** Every cell, by the row method (it sits in the row-totals column). */
-    grand: AggregateResult;
-    /** Per group id: one result per column, by the group column method. */
-    groupColumns: Map<string, AggregateResult[]>;
-    /** Per group id: every cell in the group, by the row method (it sits in
-     *  the row-totals column). */
-    groups: Map<string, AggregateResult>;
+    grand: ModelCell;
+    /** Per group id, whenever rows carry a group: one per column, by the
+     *  group column method. */
+    groupColumns: Map<string, ModelCell[]>;
+    /** Per group id, whenever rows carry a group: every cell in the group,
+     *  by the row method (it sits in the row-totals column). */
+    groups: Map<string, ModelCell>;
+}
+/** Which totals the viewer sees: drawn, or, for rows, ordering the rows. */
+export interface ShownTotals {
+    rows: boolean;
+    columns: boolean;
+    grand: boolean;
+    groups: boolean;
+    groupColumns: boolean;
+}
+export interface TotalsOptions {
+    rowMethod: HeatmapAggregate;
+    columnMethod: HeatmapAggregate;
+    groupColumnMethod: HeatmapAggregate;
+    groups?: readonly HeatmapGroup[];
+    minCount?: number;
+    getTotal?: HeatmapGetTotal;
+    /** `rate` values are proportions of their count. Default `number`. */
+    valueType?: 'number' | 'rate';
+    /** Which totals the viewer sees. Default: every one. */
+    shown?: ShownTotals;
 }
 /**
- * Works out every margin. A total in the row-totals column (a row's, a
- * group's, the grand total) uses the row method, so the column means one
- * thing; a group's per-column totals use the group column method. Low-sample
- * cells count: their data is real, only too thin to show on its own.
+ * Works out every margin, then withholds whatever would let someone work
+ * out a hidden cell (status `low-sample`), alone or with any combination
+ * of the other totals shown, the shown cells and the known bounds. A total
+ * in the row-totals column (a row's, a group's, the grand total) uses the
+ * row method, so the column means one thing; a group's per-column totals
+ * use the group column method. Low-sample cells count: their data is real,
+ * only too thin to show on its own. `getTotal` may supply any total
+ * instead; the same rule applies.
+ *
+ * Primary: a total under minCount on its own count, one the kit would work
+ * out over a value it never had, and one whose hidden cells hold fewer
+ * than minCount records. Secondary: the disclosure audit in
+ * heatmap-disclosure.ts, over every total the viewer sees.
  */
-export declare function computeTotals(matrix: readonly ModelCell[][], rows: readonly HeatmapRow[], columnCount: number, rowMethod: HeatmapAggregate, columnMethod: HeatmapAggregate, groupColumnMethod: HeatmapAggregate): HeatmapTotals;
+export declare function computeTotals(matrix: readonly ModelCell[][], rows: readonly HeatmapRow[], columns: readonly HeatmapColumn[], options: TotalsOptions): HeatmapTotals;
 /** A row the grid body renders. */
 export type BodyRow = {
     kind: 'group';
@@ -149,7 +241,7 @@ export declare const dataRowKey: (rowId: string) => string;
 export declare const groupRowKey: (groupId: string) => string;
 export declare const FOOTER_ROW_KEY = "f";
 /** Orders row indexes. Ties keep the props order (a stable sort). */
-export declare function sortRowIndexes(indexes: readonly number[], rows: readonly HeatmapRow[], totals: readonly AggregateResult[], sort: HeatmapSortRows, collator: Intl.Collator): number[];
+export declare function sortRowIndexes(indexes: readonly number[], rows: readonly HeatmapRow[], totals: readonly ModelCell[], sort: HeatmapSortRows, collator: Intl.Collator): number[];
 /** Builds the body: group headers (when grouping) and data rows. */
 export declare function buildBodyRows(rows: readonly HeatmapRow[], sortedIndexes: readonly number[], groupRows: boolean, collapsed: ReadonlySet<string>): BodyRow[];
 //# sourceMappingURL=heatmap-model.d.ts.map

package/dist/components/heatmap/heatmap-table-view.d.ts

@@ -16,11 +16,12 @@ export interface HeatmapTableViewProps {
     /** Each group's public id, for the table's row ids (never a label). */
     groupIds: ReadonlyMap<string, string>;
     describer: HeatmapDescriber;
+    /** The grid's totals, withheld ones already reduced to a value-less
+     *  cell, so the table can show nothing the grid does not. */
     totals: HeatmapTotals | null;
     rowTotals: HeatmapAggregate | false;
     columnTotals: HeatmapAggregate | false;
     groupColumnMethod: HeatmapAggregate;
-    minCount?: number;
     /** The table failed to load or render (announced by the heatmap). */
     onLoadError?: () => void;
 }
@@ -31,5 +32,5 @@ export interface HeatmapTableViewProps {
  * their groups in the grid's order. Labels go through the same privacy
  * masking as the grid.
  */
-export declare function HeatmapTableView({ title, rowsLabel, rows, columns, matrix, body, grouped, groupIds, describer, totals, rowTotals, columnTotals, groupColumnMethod, minCount, onLoadError, }: HeatmapTableViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function HeatmapTableView({ title, rowsLabel, rows, columns, matrix, body, grouped, groupIds, describer, totals, rowTotals, columnTotals, groupColumnMethod, onLoadError, }: HeatmapTableViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=heatmap-table-view.d.ts.map

package/dist/components/heatmap/heatmap.d.ts

@@ -1,11 +1,11 @@
 import { type ReactNode } from 'react';
 import { type HeatmapPrivacyScope, type HeatmapValueType } from './heatmap-format';
 import { type HeatmapSelectionMode } from './heatmap-grid';
-import { type HeatmapCellInfo, type HeatmapCellInput, type HeatmapCellKey, type HeatmapColumn, type HeatmapGroup, type HeatmapRow, type HeatmapSortRows } from './heatmap-model';
+import { type HeatmapCellInfo, type HeatmapCellInput, type HeatmapCellKey, type HeatmapColumn, type HeatmapGetTotal, type HeatmapGroup, type HeatmapRow, type HeatmapSortRows } from './heatmap-model';
 import { type HeatmapAggregate, type HeatmapScale } from './heatmap-scale';
 import { HeatmapTooltip } from './heatmap-tooltip';
 import { type HeatmapPalette } from './heatmap-variants';
-export type { HeatmapCellData, HeatmapCellInfo, HeatmapCellInput, HeatmapCellKey, HeatmapCellStatus, HeatmapColumn, HeatmapGroup, HeatmapRow, HeatmapSortRows, } from './heatmap-model';
+export type { HeatmapCellData, HeatmapCellInfo, HeatmapCellInput, HeatmapCellKey, HeatmapCellStatus, HeatmapColumn, HeatmapGetTotal, HeatmapGroup, HeatmapRow, HeatmapSortRows, HeatmapTotalScope, } from './heatmap-model';
 export type { HeatmapAggregate, HeatmapScale } from './heatmap-scale';
 export type { HeatmapPalette } from './heatmap-variants';
 export type { HeatmapPrivacyScope, HeatmapValueType } from './heatmap-format';
@@ -85,12 +85,32 @@ export interface HeatmapProps {
     valueType?: HeatmapValueType;
     /**
      * Cells with a count below this render as "too few to show", hatched.
-     * A display rule, not disclosure control: `read_cell`, `onCellClick`,
-     * `onSelectionChange` and the totals still carry any value you pass. To
-     * keep a value off the page, send `{ value: null, count }`: it still
+     * For a cell it is a display rule, not disclosure control: `read_cell`,
+     * `onCellClick` and `onSelectionChange` still carry any value you pass.
+     * To keep a value off the page, send `{ value: null, count }`: it still
      * renders as too few, and nothing can read a value the kit never had.
+     * Totals follow small-number disclosure control: any total that, in any
+     * combination with the other totals and cells, would pin down a hidden
+     * cell, narrow it below the protection level (half its range, for a
+     * rate), or determine a set of hidden cells with fewer than minCount
+     * records, is withheld too, and carries no value anywhere. Every total
+     * the data could show is audited, drawn or not. See `getTotal` and
+     * heatmap.mdx.
      */
     minCount?: number;
+    /**
+     * Supplies a total: a row's, a column's, a group's, a group header cell
+     * or the grand total, as `scope.kind` says. Return a cell input (`null`
+     * for no total), or `undefined` to let the kit work it out from the
+     * cells. Needed when you withhold values (`value: null`): the kit cannot
+     * add up a value it never had, so it withholds any total it would get
+     * wrong. `minCount` and the disclosure audit apply to a supplied total
+     * exactly as to a worked-out one, which must be the exact count-weighted
+     * mean (or sum) of its cells. Asked for every row, every column and the
+     * grand total, and, whenever rows carry a group, every group and group
+     * header cell, drawn or not. Keep it stable (`useCallback`).
+     */
+    getTotal?: HeatmapGetTotal;
     /** Formats a value. Default: Intl in the active locale. Keep it stable. */
     valueFormatter?: (value: number) => string;
     /** Print the value inside each cell. */
@@ -100,18 +120,24 @@ export interface HeatmapProps {
     /**
      * A totals column at the row ends. A mean weights by count. Everything in
      * that column uses this method: each row's total, each group's and the
-     * grand total in the corner.
+     * grand total in the corner. With `minCount`, a mean of plain numbers
+     * (`valueType="number"`) is not audited for hidden cells: every such
+     * average that holds one is withheld, so use `sum` for plain numbers.
      */
     rowTotals?: HeatmapAggregate | false;
     /**
      * A totals row under the columns. A mean weights by count. A group
      * header's per-column totals use this method too (else `rowTotals`).
+     * With `minCount`, a mean of plain numbers is withheld wherever it holds
+     * a hidden cell, as for `rowTotals`: use `sum` for plain numbers.
      */
     columnTotals?: HeatmapAggregate | false;
     /**
      * Row order (within each group). Controlled when set. In privacy mode
      * `label` keeps the given order: sorting by masked names would reveal
-     * their order.
+     * their order. A sort by total reads each row's total by the
+     * `rowTotals` method (else the `columnTotals` one, else mean); a row
+     * whose total is withheld sorts last.
      */
     sortRows?: HeatmapSortRows;
     /** Initial row order when uncontrolled. Default `none`. */

package/dist/components/heatmap/index.d.ts

@@ -1,5 +1,5 @@
 export { Heatmap } from './heatmap';
-export type { HeatmapProps, HeatmapHandle, HeatmapView, HeatmapCellReading, HeatmapCellData, HeatmapCellInfo, HeatmapCellInput, HeatmapCellKey, HeatmapCellStatus, HeatmapColumn, HeatmapGroup, HeatmapRow, HeatmapSortRows, HeatmapAggregate, HeatmapScale, HeatmapPalette, HeatmapValueType, HeatmapSelectionMode, HeatmapPrivacyScope, HeatmapTooltipContext, } from './heatmap';
+export type { HeatmapProps, HeatmapHandle, HeatmapView, HeatmapCellReading, HeatmapCellData, HeatmapCellInfo, HeatmapCellInput, HeatmapCellKey, HeatmapCellStatus, HeatmapColumn, HeatmapGetTotal, HeatmapGroup, HeatmapRow, HeatmapSortRows, HeatmapTotalScope, HeatmapAggregate, HeatmapScale, HeatmapPalette, HeatmapValueType, HeatmapSelectionMode, HeatmapPrivacyScope, HeatmapTooltipContext, } from './heatmap';
 export { HeatmapLegend } from './heatmap-legend';
 export type { HeatmapLegendProps } from './heatmap-legend';
 export { HeatmapTooltip } from './heatmap-tooltip';

package/dist/components/heatmap/index.js

@@ -1,4 +1,4 @@
-import { H as t, a as p, b as m, h as o } from "../../_chunks/heatmap-BxRHM8Et.js";
+import { H as t, a as p, b as m, h as o } from "../../_chunks/heatmap-C1TeC7wT.js";
 export {
   t as Heatmap,
   p as HeatmapLegend,

package/dist/components/notes-panel/index.js

@@ -1,4 +1,4 @@
-import { N as a } from "../../_chunks/notes-panel-uEGIL7mi.js";
+import { N as a } from "../../_chunks/notes-panel-IdsmqRFC.js";
 export {
   a as NotesPanel
 };

package/dist/components/patient-details/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as i } from "../../_chunks/patient-details-4P1vA9Ls.js";
+import { P as e, p as i } from "../../_chunks/patient-details-C-EWQTms.js";
 export {
   e as PatientDetails,
   i as patientDetailsAgent

package/dist/components/patient-search/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as r } from "../../_chunks/patient-search-DOnDUVsl.js";
+import { P as t, p as r } from "../../_chunks/patient-search-DpAKidZ5.js";
 export {
   t as PatientSearch,
   r as patientSearchAgent

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

@@ -1,4 +1,4 @@
-import { P as t, p as m } from "../../_chunks/patient-summary-card-CuDLo8MP.js";
+import { P as t, p as m } from "../../_chunks/patient-summary-card-Bpto_VCD.js";
 export {
   t as PatientSummaryCard,
   m as patientSummaryCardAgent

package/dist/components/payment-form/index.js

@@ -1,4 +1,4 @@
-import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-C3dGY7v4.js";
+import { P as r, f as s, p as m, a as e, s as n, b as o, c as i } from "../../_chunks/payment-form-XKtinW8r.js";
 export {
   r as PaymentForm,
   s as formatPaymentAmount,

package/dist/components/pdf-viewer/index.js

@@ -1,4 +1,4 @@
-import { P as p, p as a } from "../../_chunks/pdf-viewer-DJ9VN7cu.js";
+import { P as p, p as a } from "../../_chunks/pdf-viewer-BvoVMjH4.js";
 export {
   p as PDFViewer,
   a as pdfViewerAgent

package/dist/components/practice-results/index.js

@@ -1,4 +1,4 @@
-import { P as t, p as a } from "../../_chunks/practice-results-8h2Utpt3.js";
+import { P as t, p as a } from "../../_chunks/practice-results-BrUDDMXC.js";
 export {
   t as PracticeResults,
   a as practiceResultsAgent

package/dist/components/rich-text-editor/index.js

@@ -1,4 +1,4 @@
-import { R as i, r as o, w as a } from "../../_chunks/rich-text-editor-M2gT_E7f.js";
+import { R as i, r as o, w as a } from "../../_chunks/rich-text-editor-aCIoptbg.js";
 import { k as s } from "../../_chunks/kit-extensions-DWs1UEXb.js";
 export {
   i as RichTextEditor,

package/dist/components/sign-document/index.js

@@ -1,4 +1,4 @@
-import { S as o, s } from "../../_chunks/sign-document-CY7xTXbm.js";
+import { S as o, s } from "../../_chunks/sign-document-D1P1nUQA.js";
 export {
   o as SignDocument,
   s as signDocumentAgent

package/dist/components/task-editor/index.js

@@ -1,4 +1,4 @@
-import { T as o, t as r } from "../../_chunks/task-editor-CifOznfq.js";
+import { T as o, t as r } from "../../_chunks/task-editor-Bb5MMcid.js";
 export {
   o as TaskEditor,
   r as taskEditorAgent

package/dist/components/tasks-panel/index.js

@@ -1,4 +1,4 @@
-import { T as e, t } from "../../_chunks/tasks-panel-8nLwBw6P.js";
+import { T as e, t } from "../../_chunks/tasks-panel-BOb57Ysw.js";
 export {
   e as TasksPanel,
   t as tasksPanelAgent

package/dist/components/voice-control-panel/index.d.ts

@@ -1,5 +1,6 @@
 export { VoiceControlPanel } from './voice-control-panel';
-export type { VoiceControlPanelProps, VoiceControlPanelHandle, VoiceControlStatus, VoiceControlTone, VoiceControlError, VoiceControlMessage, VoiceControlTranscript, VoiceControlLanguage, VoiceControlCandidate, VoiceControlCommand, VoiceControlToggle, VoiceControlLayout, VoiceControlPosition, } from './voice-control-panel';
+export type { VoiceControlPanelProps, VoiceControlPanelHandle, VoiceControlStatus, VoiceControlTone, VoiceControlError, VoiceControlMessage, VoiceControlTranscript, VoiceControlLanguage, VoiceControlCandidate, VoiceControlCommand, VoiceControlToggle, VoiceControlLayout, VoiceControlPosition, VoiceControlAiCredits, } from './voice-control-panel';
 export type { AiConsentGate } from '../ai-permission-notice';
+export type { AiCreditsInfo, AiCreditsExpiring, AiCreditsNoticeProps, } from '../ai-credits-notice';
 export { voiceControlPanelAgent } from './voice-control-panel.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/voice-control-panel/index.js

@@ -1,4 +1,4 @@
-import { V as n, v as a } from "../../_chunks/voice-control-panel-C0BfY23Y.js";
+import { V as n, v as a } from "../../_chunks/voice-control-panel-BJIEbDq6.js";
 export {
   n as VoiceControlPanel,
   a as voiceControlPanelAgent

package/dist/components/voice-control-panel/voice-control-panel.d.ts

@@ -1,4 +1,5 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
+import { type AiCreditsInfo, type AiCreditsNoticeProps } from '../ai-credits-notice';
 import { type AiConsentBannerHeadingLevel, type AiConsentGate } from '../ai-permission-notice';
 import { type KbdNamedKey } from '../kbd';
 /** Where the host's voice session is. */
@@ -45,14 +46,29 @@ export type VoiceControlToggle = 'start' | 'stop';
 export type VoiceControlLayout = 'inline' | 'floating';
 /** The viewport corner of the floating pill. Logical: mirrors in RTL. */
 export type VoiceControlPosition = 'bottom-end' | 'bottom-start';
+/**
+ * The practice's AI credits, as the platform keeps them (a yearly allowance
+ * that expires, then welcome and bought credits that do not), plus whether
+ * they have run out. See `AiCreditsInfo` for the allowance, the dates and
+ * the next steps the host can offer.
+ */
+export interface VoiceControlAiCredits extends AiCreditsInfo {
+    /**
+     * Out of AI credits. Every way of starting shows the out-of-credits
+     * notice in the panel instead of calling `onToggle`; stopping is never
+     * gated. Set while a session runs or is paused, the panel stops it
+     * (`onToggle('stop')`, once) and shows the notice on its own.
+     */
+    exhausted?: boolean;
+}
 /** Curated imperative handle for agent / external automation. */
 export interface VoiceControlPanelHandle {
     getStatus: () => VoiceControlStatus;
     /** Ask the host to start (`onToggle('start')`) unless already starting
      *  or listening, or disabled. Gated by `aiConsent` like a press. */
     start: () => void;
-    /** Ask the host to stop or cancel a start (`onToggle('stop')`); a no-op
-     *  when not starting or listening. Never gated. */
+    /** Ask the host to stop, cancel a start or end a paused session
+     *  (`onToggle('stop')`); a no-op when idle or stopped. Never gated. */
     stop: () => void;
     getCandidateIds: () => string[];
     pickCandidate: (id: string) => void;
@@ -66,6 +82,12 @@ export interface VoiceControlPanelHandle {
     openPanel: () => void;
     /** Floating layout: close the panel; listening carries on. A no-op inline. */
     closePanel: () => void;
+    /** Whether `aiCredits.exhausted` is gating every start. */
+    isCreditsExhausted: () => boolean;
+    /** Whether the out-of-credits notice is showing. */
+    isCreditsNoticeOpen: () => boolean;
+    /** Close the out-of-credits notice, back to the controls. */
+    closeCreditsNotice: () => void;
 }
 export interface VoiceControlPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title' | 'children' | 'onToggle'> {
     /** Where the host's voice session is. Drives the button, dot and status. */
@@ -154,8 +176,26 @@ export interface VoiceControlPanelProps extends Omit<HTMLAttributes<HTMLDivEleme
      * calling `onToggle`; stopping is never gated. Omit for ungated behaviour.
      */
     aiConsent?: AiConsentGate;
-    /** Heading level for the `AiConsentBanner` title. Default: the banner's. */
+    /**
+     * Heading level for the `AiConsentBanner` title and the out-of-credits
+     * notice title, which show in the same place. Default 5.
+     */
     aiConsentHeadingLevel?: AiConsentBannerHeadingLevel;
+    /**
+     * The practice's AI credits. With `exhausted`, every way of starting (the
+     * Start button, the pill's mic, the shortcut, the agent's
+     * `start_listening`) shows the out-of-credits notice instead of calling
+     * `onToggle`, after the consent check; stopping is never gated. Running
+     * low (80% used, or `runningLow`) and `expiring` show as quiet lines in
+     * the panel and never block. Omit for ungated behaviour.
+     */
+    aiCredits?: VoiceControlAiCredits;
+    /**
+     * Floating only: the `AiCreditsNotice` hover card on the pill's mic, as on
+     * the RichTextEditor's AI triggers. It never takes the click: the mic
+     * still starts, stops or opens a gate exactly as without it.
+     */
+    aiCreditsNotice?: AiCreditsNoticeProps;
 }
 type ShortcutModifier = Extract<KbdNamedKey, 'Alt' | 'Control' | 'Shift' | 'Meta'>;
 interface ParsedShortcut {

package/dist/components/warning-stack/index.js

@@ -1,4 +1,4 @@
-import { W as n } from "../../_chunks/warning-stack-HYWAytZV.js";
+import { W as n } from "../../_chunks/warning-stack-BdY-0bd3.js";
 export {
   n as WarningStack
 };

package/dist/components/workflow/index.js

@@ -1,4 +1,4 @@
-import { C as r, W as e, a as s, b as d, c as w, i as t, l as f, m as l, r as i, w as k, d as n, e as A, f as C } from "../../_chunks/workflow-map-C2B2qIr1.js";
+import { C as r, W as e, a as s, b as d, c as w, i as t, l as f, m as l, r as i, w as k, d as n, e as A, f as C } from "../../_chunks/workflow-map-CYbRD9ek.js";
 export {
   r as CORE_PATIENT_FIELDS,
   e as WorkflowCard,

package/dist/i18n/locales/ar.d.ts

@@ -64,19 +64,44 @@ export declare const arUi: {
             readonly eyebrow: "مساعدة الذكاء الاصطناعي";
             readonly heading: "مُدرج ضمن خطتك";
             readonly body: "تُقدَّم ميزات الذكاء الاصطناعي دون أي تكلفة إضافية خلال فترة التجربة هذه.";
-            readonly allowance: "{{remaining}} من {{limit}} إجراءً بالذكاء الاصطناعي هذا الشهر";
+            readonly allowance: "تبقّى {{remaining}} من {{limit}} من أرصدة الذكاء الاصطناعي";
             readonly resetsOn: "يتجدد في {{date}}";
             readonly learnMore: "معرفة المزيد";
         };
         readonly bundles: {
             readonly eyebrow: "أرصدة الذكاء الاصطناعي";
             readonly headingWithAllowance: "{{remaining}} من {{limit}} رصيدًا";
-            readonly body: "عدد الإجراءات المشمولة شهريًا في الخطة المجانية: {{limit}}. اختر باقة أرصدة لمواصلة استخدام ميزات الذكاء الاصطناعي.";
+            readonly body: "حصتك هي {{limit}} من أرصدة الذكاء الاصطناعي. للحصول على المزيد، اختر باقة أرصدة.";
             readonly bodyGeneric: "اختر باقة أرصدة لمواصلة استخدام ميزات الذكاء الاصطناعي.";
             readonly viewBundles: "عرض الباقات";
             readonly seeCosts: "تكلفة كل إجراء";
         };
     };
+    readonly aiCredits: {
+        readonly title: "نفدت أرصدة الذكاء الاصطناعي";
+        readonly bodyBuy: "أضف أرصدة للمتابعة اليوم.";
+        readonly bodyUpgrade: "فعّل وحدة أرصدة الذكاء الاصطناعي لمواصلة استخدام مساعدة الذكاء الاصطناعي.";
+        readonly bodySupport: "تواصل مع الدعم لمواصلة استخدام مساعدة الذكاء الاصطناعي.";
+        readonly bodyRenews: "ستتوفر مساعدة الذكاء الاصطناعي مجددًا في {{date}}، عند تجديد حصتك.";
+        readonly bodyNone: "مساعدة الذكاء الاصطناعي غير متاحة إلى أن يتوفر لدى عيادتك مزيد من الأرصدة. للمساعدة، اسأل مسؤول العيادة أو تواصل مع دعم Alfadocs.";
+        readonly renewsOn: "تتجدد حصتك في {{date}}.";
+        readonly meterLabel: "أرصدة الذكاء الاصطناعي";
+        readonly remaining: "تبقّى {{remaining}} من {{limit}}";
+        readonly buy: "اشترِ أرصدة الذكاء الاصطناعي";
+        readonly upgrade: "فعّل وحدة أرصدة الذكاء الاصطناعي";
+        readonly contactSupport: "تواصل مع الدعم";
+        readonly seeCosts: "اطّلع على تكلفة كل إجراء";
+        readonly back: "رجوع";
+        readonly runningLow: "أرصدة الذكاء الاصطناعي توشك على النفاد: تبقّى {{remaining}} من {{limit}}.";
+        readonly runningLowCount: "أرصدة الذكاء الاصطناعي توشك على النفاد: تبقّى {{remaining}}.";
+        readonly runningLowPlain: "أرصدة الذكاء الاصطناعي توشك على النفاد.";
+        readonly expiring_zero: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.";
+        readonly expiring_one: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.";
+        readonly expiring_two: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.";
+        readonly expiring_few: "تنتهي صلاحية {{amount}} أرصدة ذكاء اصطناعي في {{date}}.";
+        readonly expiring_many: "تنتهي صلاحية {{amount}} رصيدًا من أرصدة الذكاء الاصطناعي في {{date}}.";
+        readonly expiring_other: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.";
+    };
     readonly opticalPrescription: {
         readonly ariaLabel: "وصفة النظارات";
         readonly metaLabel: "تفاصيل الوصفة";
@@ -1553,6 +1578,7 @@ export declare const arUi: {
         readonly allCells: "كل الخلايا";
         readonly noData: "لا توجد بيانات";
         readonly lowSample: "بيانات غير كافية";
+        readonly totalWithheld: "مخفي لحماية الأعداد الصغيرة";
         readonly countOf: "{{part}} من {{total}}";
         readonly records_zero: "عدد السجلات: {{formatted}}";
         readonly records_one: "عدد السجلات: {{formatted}}";
@@ -1581,6 +1607,7 @@ export declare const arUi: {
             readonly noData: "لا توجد بيانات";
             readonly lowSample: "بيانات غير كافية";
             readonly lowSampleUnder: "بيانات غير كافية (أقل من {{value}})";
+            readonly totalWithheld: "الإجماليات مخفية لحماية الأعداد الصغيرة";
             readonly descriptionBands_zero: "مقياس الألوان مقسّم إلى فئات عددها {{formatted}}، وحدود التقسيم عند {{edges}}.";
             readonly descriptionBands_one: "مقياس الألوان مقسّم إلى فئات عددها {{formatted}}، وحدود التقسيم عند {{edges}}.";
             readonly descriptionBands_two: "مقياس الألوان مقسّم إلى فئات عددها {{formatted}}، وحدود التقسيم عند {{edges}}.";
@@ -3714,16 +3741,6 @@ export declare const arUi: {
             readonly undo: "تراجع";
         };
         readonly credits: {
-            readonly title: "نفدت أرصدة الذكاء الاصطناعي";
-            readonly body: "أضف أرصدة للمتابعة اليوم.";
-            readonly bodyResets: "يعود رصيدك المجاني في {{date}}. أضف أرصدة للمتابعة اليوم.";
-            readonly bodyWait: "تتوفر مساعدة الذكاء الاصطناعي من جديد عند تجديد رصيدك الشهري.";
-            readonly bodyWaitResets: "تتوفر مساعدة الذكاء الاصطناعي من جديد في {{date}}، عند تجديد رصيدك الشهري.";
-            readonly meterLabel: "أرصدة الذكاء الاصطناعي هذا الشهر";
-            readonly remaining: "تبقّى {{remaining}} من {{limit}}";
-            readonly cta: "اشترِ أرصدة الذكاء الاصطناعي";
-            readonly secondary: "اطّلع على تكلفة كل إجراء";
-            readonly back: "رجوع";
             readonly kept: "ملاحظتك وتعليماتك محفوظة.";
         };
         readonly manager: {

package/dist/i18n/locales/ar.js

@@ -55,19 +55,44 @@ const e = {
       eyebrow: "مساعدة الذكاء الاصطناعي",
       heading: "مُدرج ضمن خطتك",
       body: "تُقدَّم ميزات الذكاء الاصطناعي دون أي تكلفة إضافية خلال فترة التجربة هذه.",
-      allowance: "{{remaining}} من {{limit}} إجراءً بالذكاء الاصطناعي هذا الشهر",
+      allowance: "تبقّى {{remaining}} من {{limit}} من أرصدة الذكاء الاصطناعي",
       resetsOn: "يتجدد في {{date}}",
       learnMore: "معرفة المزيد"
     },
     bundles: {
       eyebrow: "أرصدة الذكاء الاصطناعي",
       headingWithAllowance: "{{remaining}} من {{limit}} رصيدًا",
-      body: "عدد الإجراءات المشمولة شهريًا في الخطة المجانية: {{limit}}. اختر باقة أرصدة لمواصلة استخدام ميزات الذكاء الاصطناعي.",
+      body: "حصتك هي {{limit}} من أرصدة الذكاء الاصطناعي. للحصول على المزيد، اختر باقة أرصدة.",
       bodyGeneric: "اختر باقة أرصدة لمواصلة استخدام ميزات الذكاء الاصطناعي.",
       viewBundles: "عرض الباقات",
       seeCosts: "تكلفة كل إجراء"
     }
   },
+  aiCredits: {
+    title: "نفدت أرصدة الذكاء الاصطناعي",
+    bodyBuy: "أضف أرصدة للمتابعة اليوم.",
+    bodyUpgrade: "فعّل وحدة أرصدة الذكاء الاصطناعي لمواصلة استخدام مساعدة الذكاء الاصطناعي.",
+    bodySupport: "تواصل مع الدعم لمواصلة استخدام مساعدة الذكاء الاصطناعي.",
+    bodyRenews: "ستتوفر مساعدة الذكاء الاصطناعي مجددًا في {{date}}، عند تجديد حصتك.",
+    bodyNone: "مساعدة الذكاء الاصطناعي غير متاحة إلى أن يتوفر لدى عيادتك مزيد من الأرصدة. للمساعدة، اسأل مسؤول العيادة أو تواصل مع دعم Alfadocs.",
+    renewsOn: "تتجدد حصتك في {{date}}.",
+    meterLabel: "أرصدة الذكاء الاصطناعي",
+    remaining: "تبقّى {{remaining}} من {{limit}}",
+    buy: "اشترِ أرصدة الذكاء الاصطناعي",
+    upgrade: "فعّل وحدة أرصدة الذكاء الاصطناعي",
+    contactSupport: "تواصل مع الدعم",
+    seeCosts: "اطّلع على تكلفة كل إجراء",
+    back: "رجوع",
+    runningLow: "أرصدة الذكاء الاصطناعي توشك على النفاد: تبقّى {{remaining}} من {{limit}}.",
+    runningLowCount: "أرصدة الذكاء الاصطناعي توشك على النفاد: تبقّى {{remaining}}.",
+    runningLowPlain: "أرصدة الذكاء الاصطناعي توشك على النفاد.",
+    expiring_zero: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.",
+    expiring_one: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.",
+    expiring_two: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}.",
+    expiring_few: "تنتهي صلاحية {{amount}} أرصدة ذكاء اصطناعي في {{date}}.",
+    expiring_many: "تنتهي صلاحية {{amount}} رصيدًا من أرصدة الذكاء الاصطناعي في {{date}}.",
+    expiring_other: "تنتهي صلاحية {{amount}} من أرصدة الذكاء الاصطناعي في {{date}}."
+  },
   opticalPrescription: {
     ariaLabel: "وصفة النظارات",
     metaLabel: "تفاصيل الوصفة",
@@ -1548,6 +1573,7 @@ const e = {
     allCells: "كل الخلايا",
     noData: "لا توجد بيانات",
     lowSample: "بيانات غير كافية",
+    totalWithheld: "مخفي لحماية الأعداد الصغيرة",
     countOf: "{{part}} من {{total}}",
     records_zero: "عدد السجلات: {{formatted}}",
     records_one: "عدد السجلات: {{formatted}}",
@@ -1576,6 +1602,7 @@ const e = {
       noData: "لا توجد بيانات",
       lowSample: "بيانات غير كافية",
       lowSampleUnder: "بيانات غير كافية (أقل من {{value}})",
+      totalWithheld: "الإجماليات مخفية لحماية الأعداد الصغيرة",
       descriptionBands_zero: "مقياس الألوان مقسّم إلى فئات عددها {{formatted}}، وحدود التقسيم عند {{edges}}.",
       descriptionBands_one: "مقياس الألوان مقسّم إلى فئات عددها {{formatted}}، وحدود التقسيم عند {{edges}}.",
       descriptionBands_two: "مقياس الألوان مقسّم إلى فئات عددها {{formatted}}، وحدود التقسيم عند {{edges}}.",
@@ -3681,16 +3708,6 @@ const e = {
       undo: "تراجع"
     },
     credits: {
-      title: "نفدت أرصدة الذكاء الاصطناعي",
-      body: "أضف أرصدة للمتابعة اليوم.",
-      bodyResets: "يعود رصيدك المجاني في {{date}}. أضف أرصدة للمتابعة اليوم.",
-      bodyWait: "تتوفر مساعدة الذكاء الاصطناعي من جديد عند تجديد رصيدك الشهري.",
-      bodyWaitResets: "تتوفر مساعدة الذكاء الاصطناعي من جديد في {{date}}، عند تجديد رصيدك الشهري.",
-      meterLabel: "أرصدة الذكاء الاصطناعي هذا الشهر",
-      remaining: "تبقّى {{remaining}} من {{limit}}",
-      cta: "اشترِ أرصدة الذكاء الاصطناعي",
-      secondary: "اطّلع على تكلفة كل إجراء",
-      back: "رجوع",
       kept: "ملاحظتك وتعليماتك محفوظة."
     },
     manager: {