@alfadocs/ui-kit 0.69.0 → 0.71.0

package/dist/components/appointment-timeline/appointment-timeline.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { AppointmentTimelineHandle } from './appointment-timeline';
+export declare const appointmentTimelineAgent: AgentAdapter<AppointmentTimelineHandle>;
+//# sourceMappingURL=appointment-timeline.agent.d.ts.map

package/dist/components/appointment-timeline/appointment-timeline.d.ts

@@ -0,0 +1,66 @@
+import { type HTMLAttributes } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { type AppointmentItem } from '../appointment-card';
+/** Curated imperative handle — identifiers + lifecycle state only. */
+export interface AppointmentTimelineHandle {
+    getItems: () => Array<{
+        id: string;
+        state: string;
+    }>;
+    selectItem: (id: string) => void;
+    jumpToToday: () => void;
+}
+export interface AppointmentTimelineProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick' | 'id' | 'title'> {
+    /** Stable instance id, surfaced as `data-component-id`. */
+    id?: string;
+    /** Appointments to render — any order; grouped + sorted internally. */
+    items: AppointmentItem[];
+    /**
+     * ISO-8601 "now" anchor — the timeline scrolls to this day on mount and the
+     * "Today" preset returns to it. Defaults to the current instant. Stories pass
+     * a fixed value for deterministic snapshots.
+     */
+    nowIso?: string;
+    /** Panel heading. Defaults to the localised "Appointments". */
+    title?: string;
+    /** BCP-47 locale override for day headers + each AppointmentCard. */
+    locale?: string;
+    /** ISO-4217 currency code passed to each AppointmentCard. */
+    currency?: string;
+    /** Visual density passed to each AppointmentCard. */
+    size?: 'sm' | 'md';
+    /** Fires when a row is activated. */
+    onOpenAppointment?: (item: AppointmentItem) => void;
+    /** Load earlier (past) appointments — fired when the top edge is reached. */
+    onLoadEarlier?: () => void;
+    /** Load later (future) appointments — fired when the bottom edge is reached. */
+    onLoadLater?: () => void;
+    /** Whether more past appointments exist. Defaults to `true` when `onLoadEarlier` is set. */
+    hasMoreEarlier?: boolean;
+    /** Whether more future appointments exist. Defaults to `true` when `onLoadLater` is set. */
+    hasMoreLater?: boolean;
+    /** Show a loading row at the top edge. */
+    loadingEarlier?: boolean;
+    /** Show a loading row at the bottom edge. */
+    loadingLater?: boolean;
+    /** Show the date-filter row (presets + jump-to-date). Default `true`. */
+    showFilters?: boolean;
+    /**
+     * Fired when a jump-to-date / preset targets a day outside the loaded range,
+     * so the consumer can load it. The timeline scrolls to the nearest rendered
+     * day until then.
+     */
+    onJumpToDate?: (dateIso: string) => void;
+    emptyTitle?: string;
+    emptyDescription?: string;
+    /** Accessible name for the panel region (defaults to `title`). */
+    'aria-label'?: string;
+}
+declare const rootVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const AppointmentTimeline: import("react").ForwardRefExoticComponent<AppointmentTimelineProps & import("react").RefAttributes<HTMLElement>>;
+/** Re-export of the size variant union for downstream typing. */
+export type AppointmentTimelineSize = NonNullable<VariantProps<typeof rootVariants>['size']>;
+export {};
+//# sourceMappingURL=appointment-timeline.d.ts.map

package/dist/components/appointment-timeline/index.d.ts

@@ -0,0 +1,4 @@
+export { AppointmentTimeline } from './appointment-timeline';
+export type { AppointmentTimelineProps, AppointmentTimelineHandle, AppointmentTimelineSize, } from './appointment-timeline';
+export { appointmentTimelineAgent } from './appointment-timeline.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,6 @@
+import { A as i, a as t } from "../../_chunks/appointment-timeline-PJgnrjFb.js";
+export {
+  i as AppointmentTimeline,
+  t as appointmentTimelineAgent
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/autocomplete/autocomplete.d.ts

@@ -39,6 +39,16 @@ export interface AutocompleteProps<T extends string = string> extends Pick<CVAPr
     id?: string;
     className?: string;
     'aria-label'?: string;
+    /**
+     * Invalid-state fallback for use OUTSIDE a `<FormField>` (e.g. an inline
+     * editor). Inside a FormField the context wins.
+     */
+    'aria-invalid'?: boolean;
+    /**
+     * Error-message id fallback for use OUTSIDE a `<FormField>`. Inside a
+     * FormField the context's `describedBy` wins.
+     */
+    'aria-describedby'?: string;
 }
 interface AutocompleteComponent {
     <T extends string = string>(props: AutocompleteProps<T> & {

package/dist/components/autocomplete/index.js

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

package/dist/components/badge/badge.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const badgeVariants: (props?: ({
-    variant?: "error" | "neutral" | "info" | "success" | "warning" | "brand" | "accent" | null | undefined;
+    variant?: "error" | "neutral" | "info" | "success" | "warning" | "brand" | "accent" | "accentSoft" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
     shape?: "pill" | "rectangular" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
@@ -12,7 +12,11 @@ export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, Varia
     withDot?: boolean;
     /** Truncate long text with ellipsis + tooltip showing full text */
     truncate?: boolean;
-    /** For icon-only badges — provides the accessible name */
+    /**
+     * For icon-only badges, provides the accessible name. For count (numeric)
+     * badges, overrides the default "{count} notifications" screen-reader label
+     * so a non-notification count reads correctly (e.g. `aria-label="4 treatments"`).
+     */
     'aria-label'?: string;
 }
 export declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;

package/dist/components/badge/index.js

@@ -1,4 +1,4 @@
-import { B as o } from "../../_chunks/badge-CqGsX32l.js";
+import { B as o } from "../../_chunks/badge-DCOqV9mI.js";
 export {
   o as Badge
 };

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-PJI3AXzA.js";
+import { B as O, a as S, b as o, c as B, d as P, e } from "../../_chunks/bishop-score-Cym_TeQY.js";
 export {
   O as BISHOP_COMPONENTS,
   S as BISHOP_MAX_SCORE,

package/dist/components/bmi-calculator/index.js

@@ -1,4 +1,4 @@
-import { B as m } from "../../_chunks/bmi-calculator-BZtIJ53x.js";
+import { B as m } from "../../_chunks/bmi-calculator-zjeY4E7J.js";
 import { b as e, a as t, c as r, d as T, e as c, f as i, i as b, k as n, l as f } from "../../_chunks/bmi-BxD-tFzU.js";
 export {
   m as BmiCalculator,

package/dist/components/booking/index.js

@@ -1,4 +1,4 @@
-import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-C3VqFReX.js";
+import { B as A, C as R, O as a, b as s } from "../../_chunks/booking-C7do4vaR.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

package/dist/components/button-group/index.js

@@ -1,4 +1,4 @@
-import { B as t } from "../../_chunks/button-group-Ciq6J4IW.js";
+import { B as t } from "../../_chunks/button-group-CvEnVzY7.js";
 export {
   t as ButtonGroup
 };

package/dist/components/care-plan-card/index.js

@@ -1,4 +1,4 @@
-import { C as e, c as C } from "../../_chunks/care-plan-card-CvFGXa2z.js";
+import { C as e, c as C } from "../../_chunks/care-plan-card-DzPDYgtK.js";
 export {
   e as CarePlanCard,
   C as carePlanCardAgent

package/dist/components/care-plan-entry-card/index.js

@@ -1,4 +1,4 @@
-import { C as n, c as e } from "../../_chunks/care-plan-entry-card-C3E_gClk.js";
+import { C as n, c as e } from "../../_chunks/care-plan-entry-card-CEnQy7YP.js";
 export {
   n as CarePlanEntryCard,
   e as carePlanEntryCardAgent

package/dist/components/care-plan-header/care-plan-header.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { CarePlanHeaderHandle } from './care-plan-header';
+export declare const carePlanHeaderAgent: AgentAdapter<CarePlanHeaderHandle>;
+//# sourceMappingURL=care-plan-header.agent.d.ts.map

package/dist/components/care-plan-header/care-plan-header.d.ts

@@ -0,0 +1,111 @@
+import { type HTMLAttributes, type ReactElement, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { entitySurfaceVariants, type CarePlanState } from '../_shared/entity-card';
+export type { CarePlanState } from '../_shared/entity-card';
+/** Heading element the plan name / number renders as. */
+export type CarePlanHeaderHeadingTag = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+/** Tone of an attention alert chip → the Badge variant it paints with. */
+export type CarePlanHeaderAlertTone = 'warning' | 'error' | 'info';
+/**
+ * One attention alert shown as a chip beneath the heading — e.g. a missing
+ * signature, an expired estimate. The kit owns the chip; the consumer owns the
+ * (already-localised) label and the meaning.
+ */
+export interface CarePlanHeaderAlert {
+    /** Stable key — identifier only, never PHI. Keys the chip + agent count. */
+    id: string;
+    /** Already-localised label (consumer-provided). */
+    label: ReactNode;
+    /** Severity tone. Defaults to `warning`. */
+    tone?: CarePlanHeaderAlertTone;
+    /** Optional leading glyph (a single lucide element). */
+    icon?: ReactElement;
+}
+/**
+ * One meta fact in the footer strip — operator, price list, referrer, …. The
+ * label is consumer-localised; the value is any node (text, an Avatar + name,
+ * a Link). Rendered through the shared `KeyValuePair`.
+ */
+export interface CarePlanHeaderMetaItem {
+    /** Stable key — identifier only, never PHI. */
+    id: string;
+    /** Already-localised label (consumer-provided). */
+    label: string;
+    /** Value node. */
+    value: ReactNode;
+    /** Optional leading glyph for the pair (a single lucide element). */
+    icon?: ReactElement | null;
+}
+/** Lifecycle dates — each an ISO-8601 string, rendered via `Timestamp`. */
+export interface CarePlanHeaderDates {
+    /** Acceptance date. */
+    acceptedIso?: string;
+    /** Closure date. */
+    closedIso?: string;
+    /** Discard date. */
+    discardedIso?: string;
+}
+/**
+ * Imperative handle the agent adapter drives. Reads only structural state —
+ * the lifecycle enum and the count of alerts. Never the plan name, the meta
+ * values, or any patient identity.
+ */
+export interface CarePlanHeaderHandle {
+    /** The plan lifecycle state (enum, never the localised label). */
+    getState: () => CarePlanState;
+    /** How many attention alerts are showing. */
+    getAlertCount: () => number;
+}
+export interface CarePlanHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    /** Agent-readiness instance id, surfaced as `data-component-id`. */
+    id?: string;
+    /**
+     * Plan number — used as the heading when no `name` is given (matching
+     * platform's `getPresentationName()`, which falls back to `Piano #{number}`)
+     * and as the plan's structural identity for the agent layer.
+     */
+    number: string | number;
+    /**
+     * Override the number-as-heading label (e.g. a consumer's own `Plan #15`),
+     * used ONLY when no `name` is given. Defaults to the localised
+     * `Care plan {{number}}` shared with `CarePlanCard`, so the two surfaces read
+     * alike unless a consumer opts out. With a `name` present the number is not
+     * shown — platform draws no separate plan-number eyebrow.
+     */
+    numberLabel?: ReactNode;
+    /** Plan name — the title heading. Omit for a number-only header. */
+    name?: ReactNode;
+    /** Lifecycle state — drives the badge variant + localised label. */
+    state: CarePlanState;
+    /** Deep link for the heading. Rendered only when it passes the safe-URL gate. */
+    url?: string;
+    /** Attention alerts (e.g. signature missing) shown as chips under the heading. */
+    alerts?: CarePlanHeaderAlert[];
+    /** Consumer-labelled meta facts (operator, price list, …) in the footer. */
+    meta?: CarePlanHeaderMetaItem[];
+    /**
+     * Lifecycle dates. The date matching the current `state` is folded into the
+     * lifecycle badge (e.g. "Accepted · {date}"), making the badge self-describing;
+     * any other date (e.g. the acceptance date of a now-closed plan) renders as a
+     * muted `Timestamp` line beneath the meta.
+     */
+    dates?: CarePlanHeaderDates;
+    /** Inline-end actions slot (e.g. Share / Print). */
+    actions?: ReactNode;
+    /** Heading element the name / number renders as. Defaults to `h3`. */
+    headingTag?: CarePlanHeaderHeadingTag;
+    /** `elevated` (default) paints the kit card chrome; `flat` drops it. */
+    surface?: 'flat' | 'elevated';
+    /** Internal padding density. Defaults to `comfortable`. */
+    density?: 'comfortable' | 'compact';
+    /** BCP-47 locale override for the dates. Defaults to `i18n.language`. */
+    locale?: string;
+    /** Fires when the plan deep link / heading is activated. */
+    onActivate?: () => void;
+    /** Accessible name override for the plan region (defaults to the heading). */
+    'aria-label'?: string;
+}
+export declare const CarePlanHeader: import("react").ForwardRefExoticComponent<CarePlanHeaderProps & import("react").RefAttributes<HTMLElement>>;
+/** Surface variant union re-exported for downstream typing. */
+export type CarePlanHeaderSurface = NonNullable<VariantProps<typeof entitySurfaceVariants>['surface']>;
+//# sourceMappingURL=care-plan-header.d.ts.map

package/dist/components/care-plan-header/index.d.ts

@@ -0,0 +1,4 @@
+export { CarePlanHeader } from './care-plan-header';
+export type { CarePlanHeaderProps, CarePlanHeaderHandle, CarePlanHeaderSurface, CarePlanHeaderHeadingTag, CarePlanHeaderAlert, CarePlanHeaderAlertTone, CarePlanHeaderMetaItem, CarePlanHeaderDates, } from './care-plan-header';
+export { carePlanHeaderAgent } from './care-plan-header.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/care-plan-header/index.js

@@ -0,0 +1,6 @@
+import { C as r, c as n } from "../../_chunks/care-plan-header-DcXFXWit.js";
+export {
+  r as CarePlanHeader,
+  n as carePlanHeaderAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/chat-message/index.js

@@ -1,4 +1,4 @@
-import { C as s } from "../../_chunks/chat-message-3V54YipB.js";
+import { C as s } from "../../_chunks/chat-message-DzpcJR-q.js";
 export {
   s as ChatMessage
 };

package/dist/components/city-input/city-input.agent.d.ts

@@ -0,0 +1,8 @@
+import type { AgentAdapter } from '../../agent/types';
+export interface CityInputHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+}
+export declare const cityInputAgent: AgentAdapter<CityInputHandle>;
+//# sourceMappingURL=city-input.agent.d.ts.map

package/dist/components/city-input/city-input.d.ts

@@ -0,0 +1,57 @@
+import type { OptionShape } from '../_shared/option';
+export interface CityLoaderContext {
+    signal: AbortSignal;
+    locale: string;
+    /** Selected country (lowercase alpha-2), passed through to bias results. */
+    country?: string;
+    /** Selected province/region code, passed through to bias results. */
+    province?: string;
+}
+export interface CityInputProps {
+    /** City / town name (free text). */
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (city: string) => void;
+    /**
+     * Optional async suggestion source. Omit → the field is a plain text
+     * input with no suggestions. The kit never imports a geocoder; wire your
+     * own here.
+     */
+    loadCities?: (query: string, ctx: CityLoaderContext) => Promise<OptionShape[]>;
+    /** Fires when a suggestion is picked, with the full option. */
+    onCitySelect?: (option: OptionShape) => void;
+    /** Passed through to `loadCities` to bias suggestions. */
+    country?: string;
+    /** Passed through to `loadCities` to bias suggestions. */
+    province?: string;
+    /** Frequently-picked cities surfaced before the user types. */
+    recents?: OptionShape[];
+    debounceMs?: number;
+    /** Snap the value back to the last picked suggestion on blur. */
+    snapOnBlur?: boolean;
+    placeholder?: string;
+    /** Clear button — text-fallback mode only. */
+    clearable?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    name?: string;
+    id?: string;
+    size?: 'sm' | 'md' | 'lg';
+    tone?: 'default' | 'error';
+    /**
+     * Accessible name. In **suggestion mode** (`loadCities` set) this becomes
+     * the input's computed name — set it to the visible label text when used
+     * inside a `<FormField>`, otherwise the name falls back to a generic
+     * "Search". In **text-fallback mode** the FormField label associates
+     * natively, so this is optional.
+     */
+    'aria-label'?: string;
+    /** Invalid-state fallback for use outside a `<FormField>` (inline editors). */
+    'aria-invalid'?: boolean;
+    /** Error-message id fallback for use outside a `<FormField>`. */
+    'aria-describedby'?: string;
+    className?: string;
+}
+export declare const CityInput: import("react").ForwardRefExoticComponent<CityInputProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=city-input.d.ts.map

package/dist/components/city-input/index.d.ts

@@ -0,0 +1,5 @@
+export { CityInput } from './city-input';
+export type { CityInputProps, CityLoaderContext } from './city-input';
+export { cityInputAgent } from './city-input.agent';
+export type { CityInputHandle } from './city-input.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/city-input/index.js

@@ -0,0 +1,6 @@
+import { C as p, c as a } from "../../_chunks/city-input-Dkgaak7I.js";
+export {
+  p as CityInput,
+  a as cityInputAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/clinical-note-card/clinical-note-card.d.ts

@@ -74,11 +74,31 @@ export interface ClinicalNoteCardProps extends Omit<HTMLAttributes<HTMLDivElemen
      * raw HTML and unsafe link schemes are stripped.
      */
     content: string;
+    /**
+     * How `content` is authored. `'markdown'` (default) runs the small Markdown
+     * subset through the converter; `'html'` treats `content` as rich HTML
+     * (e.g. Redactor output) and renders it through SafeHtml's `rich-text`
+     * profile, so colours, sizes, tables and images survive sanitisation.
+     */
+    contentFormat?: 'markdown' | 'html';
     /** Pin the note to the top of a timeline — shows a "Pinned" chip. */
     pinned?: boolean;
     /** Flag the note for follow-up / attention — shows a "Flagged" chip. */
     flagged?: boolean;
-    /** Clamp the rendered body to a few lines. */
+    /**
+     * When provided, the pinned chip becomes an `aria-pressed` toggle button so
+     * the note can be (un)pinned in place — the pin glyph fills and tints to the
+     * accent when pinned (no button fill). Omit for a static, display-only card.
+     */
+    onTogglePin?: () => void;
+    /** As `onTogglePin`, for the flagged state (warning-tinted when flagged). */
+    onToggleFlag?: () => void;
+    /**
+     * Clamp the rendered body to five lines. When the body is taller than the
+     * clamp, a "Read more" / "Read less" disclosure toggles the full text in
+     * place — the note stays a read-only display surface, so this is the
+     * sighted-user escape hatch (assistive tech reads the full body regardless).
+     */
     truncate?: boolean;
     /**
      * `'elevated'` (default) wraps the note in `<Card variant="elevated">`.

package/dist/components/clinical-note-card/index.js

@@ -1,4 +1,4 @@
-import { C as e, c as i } from "../../_chunks/clinical-note-card-DqQYf_D4.js";
+import { C as e, c as i } from "../../_chunks/clinical-note-card-BUvNMNGL.js";
 export {
   e as ClinicalNoteCard,
   i as clinicalNoteCardAgent

package/dist/components/combobox/combobox.d.ts

@@ -32,6 +32,23 @@ export interface ComboboxProps<T extends string = string> {
     onOpenChange?: (open: boolean) => void;
     emptyMessage?: ReactNode;
     'aria-label'?: string;
+    /**
+     * Invalid-state fallback for use OUTSIDE a `<FormField>` (e.g. an inline
+     * editor). Inside a FormField the context wins. Drives the error border and
+     * the input's `aria-invalid`.
+     */
+    'aria-invalid'?: boolean;
+    /**
+     * Error-message id fallback for use OUTSIDE a `<FormField>`. Inside a
+     * FormField the context's `describedBy` wins.
+     */
+    'aria-describedby'?: string;
+    /**
+     * Forwarded to the underlying input as the HTML `autocomplete` token
+     * (e.g. `country`, `address-level1`) — WCAG 2.1 §1.3.5. cmdk passes it
+     * through to its `Command.Input`.
+     */
+    autoComplete?: string;
     className?: string;
 }
 declare const comboboxInputVariants: (props?: ({

package/dist/components/combobox/index.js

@@ -1,4 +1,4 @@
-import { C as b, c as s, a as t, b as m, d as n, e as r } from "../../_chunks/combobox-Clum7gJ1.js";
+import { C as b, c as s, a as t, b as m, d as n, e as r } from "../../_chunks/combobox-DnqSF0IH.js";
 export {
   b as Combobox,
   s as comboboxAgent,

package/dist/components/connection-status/connection-status.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ConnectionStatusHandle } from './connection-status';
+export declare const connectionStatusAgent: AgentAdapter<ConnectionStatusHandle>;
+//# sourceMappingURL=connection-status.agent.d.ts.map

package/dist/components/connection-status/connection-status.d.ts

@@ -0,0 +1,36 @@
+export type ConnectionStatusValue = 'connected' | 'disconnected' | 'pending' | 'error';
+/** One read-only account row, shown under a connected service. */
+export interface ConnectionStatusSummaryRow {
+    label: string;
+    value: string;
+}
+/** Agent-readiness curated handle for ConnectionStatus. */
+export interface ConnectionStatusHandle {
+    getStatus: () => ConnectionStatusValue;
+    connect: () => void;
+    disconnect: () => void;
+}
+export interface ConnectionStatusProps {
+    /** Service name — consumer-domain text (e.g. `"Stripe"`). */
+    service: string;
+    /** External-service connection state. */
+    status: ConnectionStatusValue;
+    /** Short explanatory line — consumer-domain text. */
+    description?: string;
+    /**
+     * Read-only account rows rendered via the kit DescriptionList. Consumer-domain
+     * text. Shown only when `status === 'connected'`.
+     */
+    summary?: ConnectionStatusSummaryRow[];
+    /** Called by the Connect action (disconnected / error states). */
+    onConnect?: () => void;
+    /** Called by the Disconnect action (connected state). */
+    onDisconnect?: () => void;
+    /** Disable the connect / disconnect action. */
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+    'aria-label'?: string;
+}
+export declare const ConnectionStatus: import("react").ForwardRefExoticComponent<ConnectionStatusProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=connection-status.d.ts.map

package/dist/components/connection-status/index.d.ts

@@ -0,0 +1,4 @@
+export { ConnectionStatus } from './connection-status';
+export type { ConnectionStatusProps, ConnectionStatusHandle, ConnectionStatusValue, ConnectionStatusSummaryRow, } from './connection-status';
+export { connectionStatusAgent } from './connection-status.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/connection-status/index.js

@@ -0,0 +1,6 @@
+import { C as o, c as a } from "../../_chunks/connection-status-CY1HV8Wg.js";
+export {
+  o as ConnectionStatus,
+  a as connectionStatusAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/contact-profile-card/index.js

@@ -1,4 +1,4 @@
-import { C as _, a as O, b as o, c as r } from "../../_chunks/contact-profile-card-Dramqa9C.js";
+import { C as _, a as O, b as o, c as r } from "../../_chunks/contact-profile-card-DDPwRFiP.js";
 export {
   _ as CONTACT_PROFILE_CARD_ROW_ICONS,
   O as CONTACT_PROFILE_CARD_ROW_KEYS,

package/dist/components/control-room-rail/control-room-context.d.ts

@@ -0,0 +1,53 @@
+import { type ReactNode } from 'react';
+import type { ToolRailHandle, ToolRailTool } from '../tool-rail';
+export interface ControlRoomProviderProps {
+    /**
+     * Tools valid in every context (Alia, Inbox). Set once at the app shell —
+     * they pin to the rail's far end and persist across navigation. Memoise
+     * this array so it doesn't re-register every render.
+     */
+    globalTools?: ToolRailTool[];
+    children: ReactNode;
+}
+/**
+ * Holds the Control Room's global tools and the registry of per-context
+ * contextual tools. Mount once at the app shell, inside the frame that also
+ * renders `<ControlRoomRail>`.
+ */
+export declare function ControlRoomProvider({ globalTools, children, }: ControlRoomProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Register this context's **contextual** tools (Notes, Appointments, the entity
+ * summary). They sit below the favourites divider and unregister automatically
+ * when the calling component unmounts (i.e. when you leave the context).
+ *
+ * Pass a **stable / memoised** array — like `useEffect` deps, a fresh array
+ * every render re-registers every render. Wrap it in `useMemo`.
+ *
+ * No-op when rendered outside a `<ControlRoomProvider>`.
+ */
+export declare function useControlRoomTools(tools: ToolRailTool[]): void;
+/**
+ * The merged tool set the rail consumes: contextual tools (auto-tagged
+ * `scope: 'contextual'`) then globals (`scope: 'global'`). Scope is assigned
+ * here by which API registered the tool — `global` seeds the Control Room's
+ * default favourites (pinned on top); `contextual` falls below the divider.
+ * `ControlRoomRail` re-groups by favourite membership for the final order.
+ * Returns `[]` outside a provider.
+ */
+export declare function useControlRoomMergedTools(): ToolRailTool[];
+/**
+ * Imperative actions to drive the rail from a page: open a tool's panel (e.g.
+ * the X-ray viewer when a tooth is clicked) or collapse it. No-ops outside a
+ * `<ControlRoomProvider>`. The functions are stable across renders.
+ */
+export declare function useControlRoomActions(): {
+    openTool: (id: string) => void;
+    closeTool: () => void;
+};
+/**
+ * Internal: the rail registers its imperative handle with the provider so
+ * `useControlRoomActions().openTool` can drive it. Returns the stable
+ * `registerRail` callback (or a no-op outside a provider).
+ */
+export declare function useControlRoomRailRegister(): (handle: ToolRailHandle | null) => void;
+//# sourceMappingURL=control-room-context.d.ts.map

package/dist/components/control-room-rail/control-room-rail.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ControlRoomRailHandle } from './control-room-rail';
+export declare const controlRoomRailAgent: AgentAdapter<ControlRoomRailHandle>;
+//# sourceMappingURL=control-room-rail.agent.d.ts.map