@alfadocs/ui-kit 1.54.3 → 1.56.0

package/dist/agent-i18n/en.json

@@ -248,8 +248,8 @@
       },
       "actions": {
         "changeView": "Switch the rendered chart type via the type switcher. No-op (returns false) when the chart has no switcher or the type is not offered.",
-        "updateSeries": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state) — when the user has switched the view cross-shape the values are converted to the rendered shape. The write targets the live instance only: a later type switch re-reads the original props and discards it.",
-        "exportPng": "Return a PNG data URI of the chart for export or screenshotting."
+        "updateSeries": "Replace the chart series without remounting. Pass the DECLARED type’s shape (see declaredType state); when the user has switched the view cross-shape the values are converted to the rendered shape. The data and its summary table persist across type switches, resizes and theme changes until the host passes a new series prop.",
+        "exportPng": "Return a PNG data URI of the chart for export or screenshotting. Waits until series pushed with update_series are drawn."
       }
     },
     "chatContainer": {
@@ -399,11 +399,12 @@
       "state": {
         "layout": "Current widget geometry in cell units — ids and rectangles only, no widget content.",
         "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."
+        "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."
       },
       "actions": {
-        "moveWidget": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off.",
-        "resizeWidget": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off."
+        "moveWidget": "Move a widget to a cell. Out-of-bounds targets are clamped; colliding widgets are pushed down and the layout re-compacts. Refused while edit mode is off or the board is stacked.",
+        "resizeWidget": "Resize a widget to a span. Clamped to the grid and the widget’s min/max; colliding widgets are pushed down. Refused while edit mode is off or the board is stacked."
       }
     },
     "dataTableTabs": {
@@ -677,6 +678,30 @@
         "setAccessibility": "Switch the accessibility preference. Verify with the `accessibility` slot (the stored preference) and `resolvedTheme` (what is actually painted)."
       }
     },
+    "heatmap": {
+      "state": {
+        "selection": "Row and column ids of the selected cells.",
+        "selectionMode": "How cells can be selected in this heatmap.",
+        "view": "Whether the heatmap or its table view is showing.",
+        "sortRows": "Current row order.",
+        "rowIds": "Row ids in display order, every group expanded. Opaque, never a label.",
+        "columnIds": "Column ids in order. Opaque, never a label.",
+        "groupIds": "Group ids in display order, empty unless rows are grouped. A group not listed in `groups` shows as group-1, group-2 and so on.",
+        "collapsedGroups": "Ids (as in groupIds) of the row groups that are collapsed."
+      },
+      "actions": {
+        "selectCell": "Make one cell the whole selection.",
+        "selectCells": "Replace the selection with the given cells.",
+        "selectRange": "Select the rectangle of cells between two corners, in the rows as shown.",
+        "clearSelection": "Deselect every cell.",
+        "readCell": "Read a cell's value, count, status and colour step (no labels).",
+        "toggleTableView": "Switch between the heatmap and its table view.",
+        "setView": "Show the heatmap or its table view.",
+        "sortRows": "Reorder the rows.",
+        "expandGroup": "Show a group's rows.",
+        "collapseGroup": "Hide a group's rows, leaving its totals row."
+      }
+    },
     "hoverCard": {
       "state": {
         "isOpen": "True when the hover card is currently open."
@@ -1002,7 +1027,7 @@
         "chartedTeeth": "FDI ids of teeth carrying at least one probing reading or flag. Identifiers only — never patient identity or the free-text note."
       },
       "actions": {
-        "focusSite": "Move focus to a specific probing-measurement input.",
+        "focusSite": "Move focus to one per-site input: a probing measurement (pocket depth, recession) or the bleeding or plaque checkbox.",
         "getTooth": "Read one tooth’s structural readings (sites, flags, mobility, furcation). The free-text note is never returned.",
         "getIndices": "Read the derived whole-mouth summary indices.",
         "getFindings": "Read the narratable per-tooth problem list (flagged teeth only). Use it to summarise the chart aloud — e.g. “46: 8 mm disto-buccal pocket, bleeding, grade 2 mobility”. Structural readings and FDI ids only; the free-text note is never returned.",
@@ -1488,13 +1513,13 @@
     "timePicker": {
       "state": {
         "value": "Currently-selected time as 24h HH:MM (always present — defaults to 00:00 when unset).",
-        "isOpen": "Whether the time popover is open. TimePicker has no popover of its own; always false."
+        "isOpen": "Whether the time dropdown is open. Always false unless the picker has the dropdown prop."
       },
       "actions": {
         "setTime": "Set the time using a 24h HH:MM string.",
         "clear": "Clear the time (resets to 00:00).",
-        "open": "No-op: TimePicker has no popover of its own.",
-        "close": "No-op: TimePicker has no popover of its own."
+        "open": "Open the time dropdown without moving focus. A no-op unless the picker has the dropdown prop and is enabled.",
+        "close": "Close the time dropdown. A no-op unless the picker has the dropdown prop."
       }
     },
     "timeline": {
@@ -1591,6 +1616,23 @@
         "close": "Dismiss the menu without inserting anything."
       }
     },
+    "voiceControlPanel": {
+      "state": {
+        "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."
+      },
+      "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.",
+        "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."
+      }
+    },
     "widgetPicker": {
       "state": {
         "open": "Whether the picker dialog is currently open.",
@@ -1782,21 +1824,21 @@
     "errorPage": {
       "workflows": {
         "readError": "Read which error the visitor hit (`data-status` on the root), what it means and the reference to quote to support, if shown.",
-        "retry": "Try the failed page again (`data-action=\"retry\"`). By default this reloads the page."
+        "retry": "Try again (`data-action=\"retry\"`). By default this reloads the page. Inside an app the host may handle it instead and send the failed request again, such as a booking confirmation, so it counts as a write."
       }
     },
     "forgotPasswordForm": {
       "workflows": {
-        "readForm": "Read where the request stands. The root carries `data-state`: `asking` while the form shows, `sent` once the confirmation has taken its place (`data-slot=\"confirmation\"`). While asking, the email sits in `data-field=\"email\"`, with `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element when it has a problem; a message about the whole request is in `data-field=\"form\"`. The confirmation is the same for every address: it does not say whether an account exists.",
+        "readForm": "Read where the request stands. The root carries `data-state`: `asking` while the form shows, `sent` once the confirmation has taken its place (`data-slot=\"confirmation\"`). While asking, the email sits in `data-field=\"email\"`, with `aria-invalid=\"true\"` on its control and its message in a `data-slot=\"error\"` element when it has a problem, also listed in `data-component=\"error-summary\"` after a refused submit; a message about the whole request is in `data-field=\"form\"`. The confirmation is the same for every address: it does not say whether an account exists.",
         "requestResetLink": "Ask for a password reset link (`data-action=\"submit\"`). The person types the email themselves; the form does not submit until it is a valid address. The host then sends the link, through its `onSubmit` handler or a native form post, and shows the confirmation for every address, whether or not an account exists for it.",
         "backToSignIn": "Go back to the sign-in page (`data-action=\"login\"`). Present only when the host gives its address."
       }
     },
     "helpMeWriteTemplates": {
       "workflows": {
-        "runTemplate": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (default first). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
+        "runTemplate": "Open the Templates menu from the editor's AI pill, or from the bubble that appears over selected text, and pick a template (listed in the practice's order). It runs straight away and rewrites the selected text, or the whole note when nothing is selected; the notice that follows offers Undo. Without patient AI consent the consent banner shows first. Out of AI credits opens the Alia Writing Assistant on the out-of-credits notice.",
         "freePrompt": "Type (or dictate with the bar mic) what to write and press Write; the draft is inserted at the caret on Insert.",
-        "manageTemplates": "Open Manage templates from the Templates menu in the AI pill: list the practice's templates, create or edit one (name, optional short description, instructions for the AI, use as default; names are unique) and delete one after a confirmation. Shown only when the host allows managing."
+        "manageTemplates": "Open Manage templates from the Templates menu in the AI pill: list the practice's templates, create or edit one (name, optional short description, instructions for the AI; names are unique), reorder them by dragging and delete one after a confirmation. Shown only when the host allows managing."
       }
     },
     "invoices": {
@@ -1813,8 +1855,8 @@
     },
     "loginForm": {
       "workflows": {
-        "readForm": "Read the sign-in form and what is wrong with it. Each field sits in a wrapper with `data-field` (`email`, `password`). A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element inside the wrapper. A message about the whole form, such as a refused sign-in, is in `data-field=\"form\"`; it never says which of the two values was wrong. Never read or repeat the password.",
-        "signIn": "Sign in (`data-action=\"submit\"`). The person types the email and the password themselves; the form does not submit until the email is a valid address and the password is not empty, and moves focus to the first field that is not. The host then signs the person in: through its `onSubmit` handler, or as a native form post to its own field names.",
+        "readForm": "Read the sign-in form and what is wrong with it. Each field sits in a wrapper with `data-field` (`email`, `password`). A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `data-slot=\"error\"` element inside the wrapper. After a refused submit the fields with a problem are also listed in `data-component=\"error-summary\"` at the top of the form, one item per field (`data-error-field`). A message about the whole form, such as a refused sign-in, is in `data-field=\"form\"`; it never says which of the two values was wrong. Never read or repeat the password.",
+        "signIn": "Sign in (`data-action=\"submit\"`). The person types the email and the password themselves; the form does not submit until the email is a valid address and the password is not empty; it lists what is wrong in its error summary and moves focus there. The host then signs the person in: through its `onSubmit` handler, or as a native form post to its own field names.",
         "forgotPassword": "Go to the page that asks for a password reset link (`data-action=\"forgot-password\"`). Present only when the host gives its address.",
         "devSignIn": "Development only: follow one of the quick sign-in links (`data-action=\"dev-login\"`, inside `data-component=\"login-dev-card\"`). Each leads to a route on the host that signs a test account in. The kit holds no test data. The card is present only when the host's server reports a development environment, and the server refuses those routes anywhere else."
       }
@@ -1945,8 +1987,8 @@
     },
     "registrationForm": {
       "workflows": {
-        "readForm": "Read which fields the form asks for and which have a problem. The host picks the fields, so read them from the page: each one that shows sits in a wrapper with `data-field`. A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `role=\"alert\"` element inside the wrapper. A message about the whole form is in `data-field=\"form\"`. An email the person cannot change is marked `readonly`. Never read or repeat the password fields.",
-        "register": "Create the account (`data-action=\"submit\"`). The person fills in the fields and accepts the terms themselves; the form does not submit until every field is valid, and moves focus to the first one that is not. The host then registers the account: through its `onSubmit` handler, or as a native form post to its own field names.",
+        "readForm": "Read which fields the form asks for and which have a problem. The host picks the fields, so read them from the page: each one that shows sits in a wrapper with `data-field`. A field with a problem has `aria-invalid=\"true\"` on its control and its message in a `data-slot=\"error\"` element inside the wrapper. After a refused submit the fields with a problem are also listed in `data-component=\"error-summary\"` at the top of the form, one item per field (`data-error-field`). A message about the whole form is in `data-field=\"form\"`. An email the person cannot change is marked `readonly`. Never read or repeat the password fields.",
+        "register": "Create the account (`data-action=\"submit\"`). The person fills in the fields and accepts the terms themselves; the form does not submit until every field is valid; it lists what is wrong in its error summary and moves focus there. The host then registers the account: through its `onSubmit` handler, or as a native form post to its own field names.",
         "devBypass": "Development only: press the shortcut (`data-component=\"dev-bypass-button\"`). It puts the values the host supplied into the fields that show, as if typed, and submits the form through the normal path when the host asked for that; a host may instead run a handler of its own, such as a development-only route. The kit holds no test data. The button is present only when the host's server reports a development environment, and what it submits is checked by the server like any other submit."
       }
     },

package/dist/components/_shared/ai-fab-pill.d.ts

@@ -0,0 +1,18 @@
+/** The pill: brand gradient over a primary fill, full radius, a
+ *  primary-tinted shadow. It clips its segments (`overflow-hidden`). */
+export declare const aiFabPillClass = "ds:relative ds:flex ds:items-center ds:overflow-hidden ds:rounded-full ds:bg-[var(--primary)] ds:bg-[image:var(--gradient-brand)] ds:shadow-[0_8px_24px_color-mix(in_srgb,var(--primary)_35%,transparent)]";
+/** The hairline between two segments. Decorative: render it `aria-hidden`. */
+export declare const aiFabDividerClass = "ds:self-stretch ds:[inline-size:var(--border-width-sm)] ds:bg-[color-mix(in_srgb,var(--primary-foreground)_35%,transparent)]";
+/** The sparkle's light sweep across the pill. Decorative; append the
+ *  shimmer class from `useAiSparkle(...).props.className`. */
+export declare const aiFabSweepClass = "ds:pointer-events-none ds:absolute ds:inset-0 ds:-translate-x-full ds:bg-[linear-gradient(90deg,transparent,color-mix(in_srgb,var(--primary-foreground)_45%,transparent),transparent)]";
+/**
+ * One pill segment. Idle: a translucent-white hover overlay over the pill.
+ * Recording: a solid destructive (red) fill that stays red on hover, so a
+ * live microphone reads as live. Deliberately no `aria-pressed` overlay: its
+ * attribute selector would out-specify the red and wash it out.
+ */
+export declare const aiFabSegmentVariants: (props?: ({
+    recording?: boolean | "labelled" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+//# sourceMappingURL=ai-fab-pill.d.ts.map

package/dist/components/_shared/floating-clearance.d.ts

@@ -0,0 +1,12 @@
+/** The custom property on the document root, in px. */
+export declare const FLOATING_CLEARANCE_PROPERTY = "--voice-control-clearance";
+/** Fired on `document` after the published clearance changes. */
+export declare const FLOATING_CLEARANCE_EVENT = "ds:voice-control-clearance";
+/**
+ * Record (or, with `null`, drop) one floating instance's clearance and
+ * publish the largest on the document root.
+ */
+export declare function publishFloatingClearance(owner: object, px: number | null): void;
+/** Listen for clearance changes. Returns the unsubscribe function. */
+export declare function onFloatingClearanceChange(listener: () => void): () => void;
+//# sourceMappingURL=floating-clearance.d.ts.map

package/dist/components/_shared/glass-surface.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Apple "Liquid Glass": `--glass-surface-fill` (`--popover` at 85%) over a
+ * backdrop blur and saturate, so the page shows through; a specular top rim
+ * and an inner hairline ring from `--card-border` (dark on light themes,
+ * bright on dark, so the rim reads in all four); a soft `--shadow-lg`;
+ * `--radius-lg` corners and `--spacing-md` padding.
+ *
+ * The fill falls back to that 85% mix for a host serving an older
+ * tokens.css. Solid where the reader needs it: the fill is `--popover`
+ * itself in the accessible themes (the token), under `prefers-contrast:
+ * more` and `prefers-reduced-transparency`, and `Canvas` in forced colours.
+ * The edge is `--surface-border-width`: 1px, 2px in the accessible themes.
+ */
+export declare const glassSurfaceClass: string;
+/**
+ * The grow out of the pill: a fade and a 95% zoom from the transform origin
+ * the component sets (the pill's corner). Timed by the kit's motion token,
+ * 150ms (`--animation-duration` × 0.75), so it is instant in the accessible
+ * themes and under reduced motion, where it is also switched off.
+ */
+export declare const glassEntranceClass: string;
+//# sourceMappingURL=glass-surface.d.ts.map

package/dist/components/_shared/input-surface.d.ts

@@ -1,6 +1,6 @@
 export declare const INPUT_SURFACE_CHROME: string;
 export declare const INPUT_SURFACE_TONE: {
-    readonly default: "ds:border-border";
+    readonly default: "ds:border-[color:var(--control-border)]";
     readonly error: "ds:border-destructive";
 };
 export declare const INPUT_SURFACE_HEIGHT: {

package/dist/components/_shared/intl-locale.d.ts

@@ -4,6 +4,13 @@
  * back to English rather than breaking the render.
  */
 export declare function canonicalLocale(language: string): string;
+/**
+ * The tag to hand `Intl.NumberFormat` for a UI language. It is the
+ * language itself unless the engine has no number data for it and the kit
+ * knows a donor with the same pattern. Every other tag passes through
+ * unchanged, so the caller keeps its own error handling.
+ */
+export declare function numberLocale(language: string): string;
 /** The kit's formatting tag: base English is British and base Portuguese
  * European, matching the date-fns locales the kit loads. */
 export declare function formatLocale(language: string): string;

package/dist/components/_shared/non-modal-tab-exit.d.ts

@@ -0,0 +1,8 @@
+import { type KeyboardEvent } from 'react';
+/**
+ * Lets Tab leave non-modal Radix Dialog content instead of wrapping. Enable it
+ * only with `modal={false}`; modal content keeps Radix's trap and loop.
+ * Returns a handler for the content's `onKeyDown`, after the consumer's own.
+ */
+export declare function useNonModalTabExit(enabled: boolean): (event: KeyboardEvent<HTMLElement>) => void;
+//# sourceMappingURL=non-modal-tab-exit.d.ts.map

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

@@ -0,0 +1,30 @@
+/** The option label: one line with an ellipsis, or with `wrapOptionLabels`
+ *  up to two wrapped lines. */
+export declare const optionLabelVariants: (props?: ({
+    wrap?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** How an option's second line reads: muted meta text, or FormField's error
+ *  text colour for a line that warns. */
+export type OptionDescriptionTone = 'default' | 'error';
+/** The second line under the label, from the option's `description`. It
+ *  wraps rather than truncating: it is a sentence, not a name. */
+export declare const optionDescriptionVariants: (props?: ({
+    tone?: "default" | "error" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** The label and its end content inside Select's ItemText: the end content
+ *  is centred on a one-line label and sits on the first line of one that
+ *  wraps. */
+export declare const optionLabelRowVariants: (props?: ({
+    wrap?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** The column holding the label row and the description under it. The
+ *  list adds vertical padding if its rows have none of their own. */
+export declare const OPTION_BODY_CLASSES = "ds:flex ds:min-w-0 ds:flex-1 ds:flex-col";
+/** The label and the end content side by side. The end content sits on the
+ *  label's first line when the label wraps. */
+export declare const OPTION_LABEL_ROW_CLASSES = "ds:flex ds:min-w-0 ds:items-start ds:gap-[var(--spacing-sm)]";
+/** The end content, pinned to the inline-end and centred on the label's
+ *  first line (`1lh`, whatever the theme's type size). Browsers without the
+ *  `lh` unit (Safari before 16.4) fall back to the base line height. */
+export declare const OPTION_END_CLASSES = "ds:inline-flex ds:min-h-[1lh] ds:not-supports-[min-height:1lh]:min-h-[calc(var(--line-height-base)*1em)] ds:shrink-0 ds:items-center ds:ms-auto";
+//# sourceMappingURL=option-row.d.ts.map

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

@@ -1,10 +1,12 @@
 import type { ReactNode } from 'react';
+import type { OptionDescriptionTone } from './option-row';
 export interface OptionShape<T extends string = string> {
     value: T;
     label: string;
     group?: string;
     disabled?: boolean;
     description?: string;
+    descriptionTone?: OptionDescriptionTone;
     startAdornment?: ReactNode;
     endContent?: ReactNode;
 }

package/dist/components/_shared/state-backed-text-input.d.ts

@@ -0,0 +1,16 @@
+import { type TextInputProps } from '../text-input/text-input';
+export interface StateBackedTextInputProps extends Omit<TextInputProps, 'value' | 'defaultValue'> {
+    /** The text, held in the kit component's own state. */
+    value: string;
+}
+/**
+ * TextInput for a field whose text a kit component keeps in its own state:
+ * the state reaches the input's `value` property, never its `value`
+ * attribute, and `onChange` still reports each edit.
+ *
+ * TextInput now does this itself for a controlled `value` (useDomValue), so
+ * a plain `<TextInput value={state}>` is just as safe. Do not add new call
+ * sites; folding the existing ones back is a planned follow-up.
+ */
+export declare const StateBackedTextInput: import("react").ForwardRefExoticComponent<StateBackedTextInputProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=state-backed-text-input.d.ts.map

package/dist/components/_shared/use-apex-chart-semantics.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `legendToggles`: whether a legend press hides its series. It does on axis
+ * charts and radialBar; on pie and donut it selects the slice instead.
+ */
+export declare function useApexChartSemantics(root: HTMLElement | null, legendToggles: boolean): void;
+//# sourceMappingURL=use-apex-chart-semantics.d.ts.map

package/dist/components/_shared/use-dom-value.d.ts

@@ -0,0 +1,20 @@
+import { type RefObject } from 'react';
+type ValueElement = HTMLInputElement | HTMLTextAreaElement;
+/**
+ * Shows a controlled value without writing it into the markup.
+ *
+ * React copies a controlled `value` into the `value` attribute (into the
+ * text of a `<textarea>`), where a copied outerHTML or a session replay can
+ * read it. A field that renders its element without `value` and calls this
+ * instead still behaves as a controlled one: after every render the
+ * element's value property is set to `value` when it differs. Nothing is
+ * written while `value` is undefined (the text is then the user's), nor
+ * while `pausedRef` is true (mid IME composition, before the host has been
+ * told of the edit).
+ *
+ * Call the returned `sync` after handling each change. A refused edit does
+ * not re-render the field, so without it the refused text would stay.
+ */
+export declare function useDomValue(elementRef: RefObject<ValueElement | null>, value: string | undefined, pausedRef?: RefObject<boolean>): () => void;
+export {};
+//# sourceMappingURL=use-dom-value.d.ts.map

package/dist/components/_shared/use-select-on-arrow.d.ts

@@ -0,0 +1,20 @@
+import { type KeyboardEvent } from 'react';
+export interface SelectOnArrow {
+    /** Put on the Radix `RadioGroup.Root`, after any consumer `onKeyDown`. */
+    onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
+    /** Call first thing in the Root's `onValueChange`. */
+    noteSelection: () => void;
+}
+/**
+ * Arrow keys move focus AND selection in a Radix radio group (WAI-ARIA radio
+ * pattern). Radix selects only if the next radio takes focus while the arrow
+ * key is still down: it moves focus in a timeout and forgets the key on
+ * `keyup`. A quick tap, a script or an assistive technology can release the
+ * key before that timeout runs, and focus then moves without selecting.
+ *
+ * This finishes the move: its own timeout runs after Radix's and clicks the
+ * newly focused radio, as Radix would have. `noteSelection` tells it Radix
+ * already selected, so each move fires `onValueChange` once.
+ */
+export declare function useSelectOnArrow(): SelectOnArrow;
+//# sourceMappingURL=use-select-on-arrow.d.ts.map

package/dist/components/_shared/use-state-backed-input.d.ts

@@ -0,0 +1,31 @@
+import { type Ref } from 'react';
+/**
+ * Puts `next` into an input as typing would: through the native setter, so
+ * React sees a change, then an `input` event, so state that follows the
+ * field (TextInput's clear button, EmailInput's check) stays in step.
+ * Returns false when there is no input or it already holds `next`.
+ */
+export declare function writeInputValue(node: HTMLInputElement | null, next: string): boolean;
+export interface StateBackedInput {
+    /** For the field's `<input>`. Also sets the `ref` passed to the hook. */
+    ref: (node: HTMLInputElement | null) => void;
+    /** Wraps the field's change handler so the writes made here are not
+     *  reported back as edits. */
+    quiet: <A extends unknown[]>(handler?: (...args: A) => void) => (...args: A) => void;
+}
+/**
+ * For a field whose text the kit keeps in its own state.
+ *
+ * React copies a controlled input's value into its `value` attribute, where
+ * a copied outerHTML or a session replay can read it. TextInput and
+ * TextArea now avoid this for a controlled `value` themselves (useDomValue),
+ * so a field passed straight to them does not need this hook. Give the
+ * field this `ref` and no `value` or `defaultValue`: the input stays
+ * uncontrolled and the state is written to its `value` property, on mount
+ * and whenever the two differ. The attribute never holds the text, not
+ * even the text a field had when it mounted again. An edit the state
+ * refuses or rewrites is put back, as React does, but never in the middle
+ * of an IME composition. `ref` must keep the same identity.
+ */
+export declare function useStateBackedInput(value: string, ref?: Ref<HTMLInputElement>): StateBackedInput;
+//# sourceMappingURL=use-state-backed-input.d.ts.map

package/dist/components/accordion/index.js

@@ -1,4 +1,4 @@
-import { A as r, a as n, b as a, c as d, d as i } from "../../_chunks/accordion-C11v9ouP.js";
+import { A as r, a as n, b as a, c as d, d as i } from "../../_chunks/accordion-Ch3xp0mX.js";
 export {
   r as Accordion,
   n as AccordionContent,

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

@@ -1,4 +1,4 @@
-import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-BBZ0u_U1.js";
+import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-bPR2mNBt.js";
 export {
   o as AddressAutocomplete,
   t as addressAutocompleteAgent,

package/dist/components/address-fields/address-fields.d.ts

@@ -28,6 +28,10 @@ export interface AddressFieldsProps {
     /** An error message per field, shown under it. The host validates and
      *  decides when to show each one. */
     errors?: Partial<Record<AddressFieldKey | 'country', string>>;
+    /** Whether a field's message raises `role="alert"`, per field; each
+     *  does unless set to `false`. Turn it off for messages shown together,
+     *  such as by a refused submit, so they are not all announced at once. */
+    announceErrors?: Partial<Record<AddressFieldKey | 'country', boolean>>;
     disabled?: boolean;
     id?: string;
     className?: string;

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

@@ -1,4 +1,4 @@
-import { A as e, a } from "../../_chunks/address-fields-BaClzQLM.js";
+import { A as e, a } from "../../_chunks/address-fields-BfjxS05Z.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-CakEvwnM.js";
+import { A as e } from "../../_chunks/agenda-card-DauvvKX6.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-B8vuZKjH.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-ZKhDxlfw.js";
 export {
   r as AgendaTray,
   g as agendaTrayAgent

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

@@ -1,4 +1,4 @@
-import { A as i } from "../../_chunks/ai-credits-notice-D9_qP2xc.js";
+import { A as i } from "../../_chunks/ai-credits-notice-BoNJtOuE.js";
 import { a as r } from "../../_chunks/ai-credits-notice.agent-C9L7orrP.js";
 export {
   i as AiCreditsNotice,

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

@@ -6,6 +6,40 @@ declare const rootVariants: (props?: ({
 export type AiConsentState = NonNullable<VariantProps<typeof rootVariants>['state']>;
 /** Heading levels `AiConsentBanner.headingLevel` accepts. */
 export type AiConsentBannerHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Patient AI-consent gate for an AI surface that sends patient data to a
+ * service: the RichTextEditor's Help-me-write action and dictation mics, and
+ * the VoiceControlPanel's microphone. Omit entirely for today's ungated
+ * behaviour — no existing host breaks.
+ *
+ * Present and `granted: false`: the affordances stay visible (this never
+ * hides a control), but using one shows the kit's `AiConsentBanner` instead
+ * of starting the AI action. When `granted` flips `true` after a Grant click
+ * in that banner, the surface resumes exactly the action it gated; when it
+ * flips for any other reason (another patient, another tab) it only closes
+ * the banner.
+ *
+ * Present and `granted: true`: normal behaviour.
+ */
+export interface AiConsentGate {
+    /** Whether AI consent has already been recorded for the current patient. */
+    granted: boolean;
+    /** When consent was granted — passed straight to `AiConsentBanner`. */
+    grantedAt?: string | number | Date;
+    /** Who granted consent — passed straight to `AiConsentBanner`. */
+    grantedBy?: string;
+    /** Whether the signed-in reader may grant consent. Default `true`; treated
+     *  as `false` when `onGrant` is absent, so no dead Grant control shows. */
+    canGrant?: boolean;
+    /** The grant is being persisted server-side (host-driven busy state). */
+    pending?: boolean;
+    /**
+     * Fired when the reader confirms the grant in the banner. A returned
+     * promise drives the banner's own pending/Spinner state until it settles,
+     * in addition to (or absent) a host-supplied `pending`.
+     */
+    onGrant?: () => void | Promise<void>;
+}
 /** Agent-readiness curated handle. Exposes the structural consent state only. */
 export interface AiConsentBannerHandle {
     /** Current derived state: 'granted' | 'required' | 'pending'. */

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

@@ -1,4 +1,4 @@
 export { AiConsentBanner } from './ai-permission-notice';
-export type { AiConsentBannerProps, AiConsentBannerHandle, AiConsentState, AiConsentBannerHeadingLevel, } from './ai-permission-notice';
+export type { AiConsentBannerProps, AiConsentBannerHandle, AiConsentState, AiConsentBannerHeadingLevel, AiConsentGate, } from './ai-permission-notice';
 export { aiConsentBannerAgent } from './ai-permission-notice.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,4 +1,4 @@
-import { A as e, a as o } from "../../_chunks/ai-permission-notice-Cr6o1f0f.js";
+import { A as e, a as o } from "../../_chunks/ai-permission-notice-5vpblPCx.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-DkL8W-nt.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input-Beh-O_rJ.js";
 export {
   a as AIPromptInput,
   o as aiPromptInputAgent

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

@@ -1,4 +1,4 @@
-import { A as s } from "../../_chunks/anamnesis-card-BT1tMt5O.js";
+import { A as s } from "../../_chunks/anamnesis-card-BSlAhaoG.js";
 export {
   s as AnamnesisCard
 };

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

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

package/dist/components/app-frame/index.js

@@ -1,4 +1,4 @@
-import { A as a } from "../../_chunks/app-frame-Cos-GSfw.js";
+import { A as a } from "../../_chunks/app-frame-B-0O9CrU.js";
 export {
   a as AppFrame
 };

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

@@ -1,5 +1,5 @@
-import { A as p } from "../../_chunks/appointment-card-CA2ynsmN.js";
-import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-EQUjllVy.js";
+import { A as p } from "../../_chunks/appointment-card-Dh3fAcyf.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-CyI_p3zU.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-B6dBBgDa.js";
+import { A as e, a as n, p, u as s } from "../../_chunks/use-appointment-details-read-JsDM48tf.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-Cbrg36wj.js";
+import { A as o } from "../../_chunks/appointment-peek-BIZaDeCi.js";
 import { a as n } from "../../_chunks/appointment-peek.agent-C539tNFM.js";
 export {
   o as AppointmentPeek,

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

@@ -1,4 +1,4 @@
-import { A as i, a as t } from "../../_chunks/appointment-timeline-CssAJLpL.js";
+import { A as i, a as t } from "../../_chunks/appointment-timeline-DmqYEIT9.js";
 export {
   i as AppointmentTimeline,
   t as appointmentTimelineAgent

package/dist/components/audio-recorder/index.js

@@ -1,4 +1,4 @@
-import { A as r, a } from "../../_chunks/audio-recorder-BM68r6fe.js";
+import { A as r, a } from "../../_chunks/audio-recorder-DWKKjGPt.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

package/dist/components/autocomplete/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o, b as m } from "../../_chunks/autocomplete-BXm1rnT0.js";
+import { A as e, a as o, b as m } from "../../_chunks/autocomplete-DosDnGie.js";
 export {
   e as Autocomplete,
   o as autocompleteAgent,

package/dist/components/avatar/index.js

@@ -1,4 +1,4 @@
-import { A as o, g as r, n as t } from "../../_chunks/avatar-DYtwj1-R.js";
+import { A as o, g as r, n as t } from "../../_chunks/avatar-WZY3eGE7.js";
 export {
   o as Avatar,
   r as getInitials,

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

@@ -1,4 +1,4 @@
-import { B as a } from "../../_chunks/benefit-card-DB1Kdrmc.js";
+import { B as a } from "../../_chunks/benefit-card-BWBClvdF.js";
 export {
   a as BenefitCard
 };

package/dist/components/bishop-score/index.js

@@ -1,4 +1,4 @@
-import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-BzvVol-u.js";
+import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-BxA20j9T.js";
 export {
   O as BISHOP_COMPONENTS,
   S as BISHOP_MAX_SCORE,