@alfadocs/ui-kit 0.70.0 → 0.71.0

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/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/control-room-rail/control-room-context.d.ts

@@ -1,12 +1,12 @@
 import { type ReactNode } from 'react';
-import type { AiToolsRailHandle, AiToolsRailTool } from '../ai-tools-rail';
+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?: AiToolsRailTool[];
+    globalTools?: ToolRailTool[];
     children: ReactNode;
 }
 /**
@@ -25,7 +25,7 @@ export declare function ControlRoomProvider({ globalTools, children, }: ControlR
  *
  * No-op when rendered outside a `<ControlRoomProvider>`.
  */
-export declare function useControlRoomTools(tools: AiToolsRailTool[]): void;
+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
@@ -34,7 +34,7 @@ export declare function useControlRoomTools(tools: AiToolsRailTool[]): void;
  * `ControlRoomRail` re-groups by favourite membership for the final order.
  * Returns `[]` outside a provider.
  */
-export declare function useControlRoomMergedTools(): AiToolsRailTool[];
+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
@@ -49,5 +49,5 @@ export declare function useControlRoomActions(): {
  * `useControlRoomActions().openTool` can drive it. Returns the stable
  * `registerRail` callback (or a no-op outside a provider).
  */
-export declare function useControlRoomRailRegister(): (handle: AiToolsRailHandle | null) => void;
+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

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

@@ -1,9 +1,9 @@
-import { type AiToolsRailHandle, type AiToolsRailProps, type AiToolsRailTool } from '../ai-tools-rail';
+import { type ToolRailHandle, type ToolRailProps, type ToolRailTool } from '../tool-rail';
 /** A Control Room tool — the rail tool descriptor, `scope`-aware. */
-export type ControlRoomTool = AiToolsRailTool;
+export type ControlRoomTool = ToolRailTool;
 /** Imperative handle — open / collapse a tool panel without the DOM. */
-export type ControlRoomRailHandle = AiToolsRailHandle;
-export interface ControlRoomRailProps extends Omit<AiToolsRailProps, 'tools' | 'onReorder' | 'formatReorderAnnouncement' | 'renderToolAffordance' | 'renderPanelHeader'> {
+export type ControlRoomRailHandle = ToolRailHandle;
+export interface ControlRoomRailProps extends Omit<ToolRailProps, 'tools' | 'onReorder' | 'formatReorderAnnouncement' | 'renderToolAffordance' | 'renderPanelHeader'> {
     /**
      * Explicit tool set. Omit to read the merged global + contextual tools from
      * the nearest `<ControlRoomProvider>` (+ `useControlRoomTools`).
@@ -31,5 +31,5 @@ export interface ControlRoomRailProps extends Omit<AiToolsRailProps, 'tools' | '
     /** localStorage key for the uncontrolled favourites. */
     persistFavoritesKey?: string;
 }
-export declare const ControlRoomRail: import("react").ForwardRefExoticComponent<ControlRoomRailProps & import("react").RefAttributes<AiToolsRailHandle>>;
+export declare const ControlRoomRail: import("react").ForwardRefExoticComponent<ControlRoomRailProps & import("react").RefAttributes<ToolRailHandle>>;
 //# sourceMappingURL=control-room-rail.d.ts.map

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

@@ -1,5 +1,6 @@
 export { ControlRoomRail } from './control-room-rail';
 export type { ControlRoomRailProps, ControlRoomRailHandle, ControlRoomTool, } from './control-room-rail';
+export { controlRoomRailAgent } from './control-room-rail.agent';
 export { ControlRoomProvider, useControlRoomTools, useControlRoomMergedTools, useControlRoomActions, } from './control-room-context';
 export type { ControlRoomProviderProps } from './control-room-context';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/control-room-rail/index.js

@@ -1,9 +1,10 @@
-import { C as r, a as l, u as a, b as e, c as t } from "../../_chunks/control-room-rail-Y8ryLYsP.js";
+import { C as r, a as l, c as a, u as t, b as e, d as n } from "../../_chunks/control-room-rail-FAQZrGVL.js";
 export {
   r as ControlRoomProvider,
   l as ControlRoomRail,
-  a as useControlRoomActions,
+  a as controlRoomRailAgent,
+  t as useControlRoomActions,
   e as useControlRoomMergedTools,
-  t as useControlRoomTools
+  n as useControlRoomTools
 };
 //# sourceMappingURL=index.js.map

package/dist/components/counter/counter.d.ts

@@ -1,7 +1,7 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const counterVariants: (props?: ({
-    variant?: "outline" | "neutral" | "notification" | "solid" | null | undefined;
+    variant?: "outline" | "neutral" | "solid" | "notification" | null | undefined;
     size?: "sm" | "md" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface CounterProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'>, VariantProps<typeof counterVariants> {

package/dist/components/country-select/country-select.agent.d.ts

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

package/dist/components/country-select/country-select.d.ts

@@ -0,0 +1,51 @@
+export interface CountrySelectProps {
+    /** Selected country — ISO 3166-1 alpha-2, lowercased (e.g. `'it'`). */
+    value?: string;
+    /** Uncontrolled initial value. Ignored once `value` is set. */
+    defaultValue?: string;
+    /** Fires with the new lowercased alpha-2 code (or `''` when cleared). */
+    onValueChange?: (code: string) => void;
+    /**
+     * Restrict the list to these codes (lowercase alpha-2). Default: every
+     * ISO 3166-1 alpha-2 country.
+     */
+    countries?: string[];
+    /**
+     * Float these countries to the top under a "Popular" heading, in the
+     * given order (lowercase alpha-2). They are removed from their region
+     * group so they never appear twice.
+     */
+    popularCountries?: string[];
+    /** Group the remaining countries by world region. Default `true`. */
+    grouped?: boolean;
+    /**
+     * Override the localized display name for specific codes — e.g. to pin
+     * politically-sensitive wording. Keyed by lowercase alpha-2.
+     */
+    nameOverrides?: Record<string, string>;
+    /** Show a flag before each country name. Default `true`. */
+    showFlag?: boolean;
+    placeholder?: string;
+    clearable?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    name?: string;
+    id?: string;
+    size?: 'sm' | 'md' | 'lg';
+    tone?: 'default' | 'error';
+    /**
+     * Accessible name. REQUIRED when used inside a `<FormField>`: cmdk labels
+     * the input through its own hidden element, so the visible FormField label
+     * is not the computed accessible name unless this is passed. Set it to the
+     * visible label text (e.g. `"Country"`).
+     */
+    '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 CountrySelect: import("react").ForwardRefExoticComponent<CountrySelectProps & import("react").RefAttributes<HTMLInputElement>>;
+//# sourceMappingURL=country-select.d.ts.map

package/dist/components/country-select/index.d.ts

@@ -0,0 +1,6 @@
+export { CountrySelect } from './country-select';
+export type { CountrySelectProps } from './country-select';
+export { countrySelectAgent } from './country-select.agent';
+export type { CountrySelectHandle } from './country-select.agent';
+export { ISO_3166_ALPHA2, ISO_3166_REGIONS, regionForCountry, type CountryRegion, } from './iso-3166';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/country-select/index.js

@@ -0,0 +1,9 @@
+import { C as o, I as t, a, c as n, r as s } from "../../_chunks/country-select-BwUZQvTa.js";
+export {
+  o as CountrySelect,
+  t as ISO_3166_ALPHA2,
+  a as ISO_3166_REGIONS,
+  n as countrySelectAgent,
+  s as regionForCountry
+};
+//# sourceMappingURL=index.js.map

package/dist/components/country-select/iso-3166.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bundled closed dataset for CountrySelect — ISO 3166-1 alpha-2 codes mapped to
+ * UN geoscheme continental region. Localised country *names* are resolved at render
+ * via Intl.DisplayNames and are never bundled here.
+ *
+ * Source: ISO 3166-1 (249 entries, current as of 2025).
+ * Region assignment follows the UN M.49 geoscheme with the following project-level
+ * overrides: Russia → 'Europe'; Turkey and Cyprus → 'Asia'; Greenland → 'Americas';
+ * Antarctica territories (aq, bv, gs, hm, tf) → 'Antarctica'.
+ */
+export type CountryRegion = 'Africa' | 'Americas' | 'Asia' | 'Europe' | 'Oceania' | 'Antarctica';
+export declare const ISO_3166_REGIONS: Record<string, CountryRegion>;
+export declare const ISO_3166_ALPHA2: readonly string[];
+export declare function regionForCountry(code: string): CountryRegion | undefined;
+//# sourceMappingURL=iso-3166.d.ts.map

package/dist/components/data-table/cell-renderers/reorder-cell-renderer.d.ts

@@ -0,0 +1,34 @@
+import type { CustomCellRendererProps } from 'ag-grid-react';
+/**
+ * Keyboard-accessible row-reorder cell. AG Grid's native row dragging is
+ * mouse/touch only; this renderer adds move-up / move-down buttons so the order
+ * is reachable by keyboard too (the missing accessible half of the
+ * "drag-sortable column" primitive). The consumer owns `rowData` order and
+ * reorders it in `onMove` — the same controlled contract as the editable cells.
+ */
+export interface ReorderCellRendererParams<TData = unknown> {
+    /** Move the row one step in the given direction (consumer reorders rowData). */
+    onMove: (data: TData, direction: 'up' | 'down') => void;
+    /** Accessible name for the move-up button (defaults to a kit string). */
+    moveUpLabel?: string;
+    /** Accessible name for the move-down button (defaults to a kit string). */
+    moveDownLabel?: string;
+    /** Button intent (default `ghost`). */
+    intent?: 'ghost' | 'outline';
+    /** Render the two buttons as a connected `IconButtonGroup` (default true). */
+    group?: boolean;
+    /**
+     * Disable move-up on the first displayed row and move-down on the last
+     * (default true). Turn off when the grid is filtered/sorted and the ends are
+     * not meaningful.
+     */
+    disableAtEnds?: boolean;
+}
+/**
+ * Pixel width a reorder column needs for the two `sm` IconButtons (32px each)
+ * plus the data-table cell's inline padding so the controls never clip. Mirrors
+ * {@link actionsColumnWidth}.
+ */
+export declare function reorderColumnWidth(): number;
+export declare function ReorderCellRenderer<TData = unknown>(props: CustomCellRendererProps<TData> & ReorderCellRendererParams<TData>): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=reorder-cell-renderer.d.ts.map

package/dist/components/data-table/index.d.ts

@@ -30,6 +30,8 @@ export { CurrencyCellRenderer } from './cell-renderers/currency-cell-renderer';
 export type { CurrencyCellRendererParams } from './cell-renderers/currency-cell-renderer';
 export { ActionsCellRenderer, actionsColumnWidth, } from './cell-renderers/actions-cell-renderer';
 export type { ActionDef, ActionsCellRendererParams, } from './cell-renderers/actions-cell-renderer';
+export { ReorderCellRenderer, reorderColumnWidth, } from './cell-renderers/reorder-cell-renderer';
+export type { ReorderCellRendererParams } from './cell-renderers/reorder-cell-renderer';
 export { LinkCellRenderer } from './cell-renderers/link-cell-renderer';
 export type { LinkCellRendererParams } from './cell-renderers/link-cell-renderer';
 export { ToggleCellRenderer } from './cell-renderers/toggle-cell-renderer';

package/dist/components/data-table/index.js

@@ -1,10 +1,10 @@
-import { A as l, C as r, D as t, a as s, b as n, c as o, I as d, L as i, N as C, d as R, S as F, e as T, f as g, T as b, g as u, h as c, i as m, j as x, k as D, l as f, U as h, m as p, n as y, o as E } from "../../_chunks/link-cell-renderer-CTXqtXV-.js";
-import { B as A, C as L, E as N, a as k, T as B, b as I, u as P } from "../../_chunks/editable-currency-cell-renderer-C9twtALM.js";
+import { A as r, C as l, D as t, a as s, b as n, c as o, I as d, L as i, N as C, d as R, S as F, e as T, f as g, T as b, g as u, h as c, i as m, j as h, k as x, l as D, U as f, m as p, n as y, o as E } from "../../_chunks/link-cell-renderer-De_SLjSq.js";
+import { B as A, C as L, E as N, a as k, R as B, T as I, b as P, r as U, u as W } from "../../_chunks/editable-currency-cell-renderer-CGELrkIj.js";
 export {
-  l as ActionsCellRenderer,
+  r as ActionsCellRenderer,
   A as BalanceCellRenderer,
   L as ColorDotCellRenderer,
-  r as CurrencyCellRenderer,
+  l as CurrencyCellRenderer,
   t as DataTable,
   s as DateCellRenderer,
   n as DateRangeFilter,
@@ -15,22 +15,24 @@ export {
   i as LinkCellRenderer,
   C as NumberFilter,
   R as NumberFloatingFilter,
+  B as ReorderCellRenderer,
   F as SelectFilter,
   T as SelectFloatingFilter,
   g as StatusCellRenderer,
   b as TagListCellRenderer,
   u as TextFilter,
   c as TextFloatingFilter,
-  B as ToggleCellRenderer,
+  I as ToggleCellRenderer,
   m as Toolbar,
-  x as ToolbarProvider,
-  I as ToothCellRenderer,
-  D as TypeaheadFilter,
-  f as TypeaheadFloatingFilter,
-  h as UserCellRenderer,
+  h as ToolbarProvider,
+  P as ToothCellRenderer,
+  x as TypeaheadFilter,
+  D as TypeaheadFloatingFilter,
+  f as UserCellRenderer,
   p as actionsColumnWidth,
   y as dataTableAgent,
   E as defaultExportPdf,
-  P as useTotalRow
+  U as reorderColumnWidth,
+  W as useTotalRow
 };
 //# sourceMappingURL=index.js.map

package/dist/components/entity-summary/entity-summary.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { EntitySummaryHandle } from './entity-summary';
+export declare const entitySummaryAgent: AgentAdapter<EntitySummaryHandle>;
+//# sourceMappingURL=entity-summary.agent.d.ts.map

package/dist/components/entity-summary/entity-summary.d.ts

@@ -8,21 +8,65 @@ export interface EntitySummaryStat {
 export interface EntitySummarySection {
     id: string;
     heading: string;
-    /** `attention` renders the risk-flag treatment (warning-tinted, alert glyph). */
+    /**
+     * Leading glyph for the section. On default sections it's the scannability
+     * anchor shown in a `--primary`-tinted medallion beside the heading (e.g. a
+     * calendar for "Scheduled", a wallet for "Financial"); omit it to render no
+     * medallion. On `attention` sections it overrides the warning Alert's icon
+     * (which defaults to an alert triangle).
+     */
+    icon?: ReactNode;
+    /**
+     * `attention` renders the section as the kit's warning `Alert` — the
+     * standard risk-flag treatment (border, warning surface, alert glyph,
+     * `--warning-foreground` text) — for clinically important callouts.
+     */
     tone?: 'default' | 'attention';
     /** Bullet items — `ReactNode` so consumers compose inline entity links. */
     items: ReactNode[];
 }
+/**
+ * Curated agent handle for EntitySummary. Exposes structural state only —
+ * never the entity name or the section items (both PHI). See
+ * `entity-summary.agent.ts`.
+ */
+export interface EntitySummaryHandle {
+    /** Structural snapshot — generated-at + section ids/headings/tone/count. No PHI. */
+    getState: () => {
+        generatedAtIso?: string;
+        sections: Array<{
+            id: string;
+            heading: string;
+            tone: 'default' | 'attention';
+            itemCount: number;
+        }>;
+    };
+    /** Whether the regenerate affordance is available. */
+    canRegenerate: () => boolean;
+    /** Request the host to regenerate the brief (mirrors onRegenerate). */
+    regenerate: () => void;
+    /** Whether the close affordance is available. */
+    canClose: () => boolean;
+    /** Dismiss the panel (mirrors onClose). */
+    close: () => void;
+}
 export interface EntitySummaryProps extends Omit<HTMLAttributes<HTMLElement>, 'title' | 'children'> {
+    /**
+     * Stable instance id. Surfaced on the root as `data-component-id` so an
+     * agent / MCP UI bridge can address this specific summary panel.
+     */
+    id?: string;
     /** Panel title. Defaults to the localised "AI summary". */
     title?: string;
-    /** Entity name shown as a link in the header. */
+    /** Entity name shown beside its avatar in the header (links when `entityHref` is set). */
     entityName?: string;
     /** Entity href for the name link. */
     entityHref?: string;
+    /** Avatar image URL for the entity. Falls back to initials derived from `entityName`. */
+    entityAvatarSrc?: string;
     /** ISO-8601 instant the brief was generated. */
     generatedAtIso?: string;
-    /** Corpus the brief was built from, shown as a "·"-joined line. */
+    /** Corpus the brief was built from, shown as a compact KPI card. */
     stats?: EntitySummaryStat[];
     /** The narrative sections, in order. */
     sections: EntitySummarySection[];
@@ -30,7 +74,12 @@ export interface EntitySummaryProps extends Omit<HTMLAttributes<HTMLElement>, 't
     onRegenerate?: () => void;
     /** Regenerate-button label. */
     regenerateLabel?: string;
-    /** Dismiss the panel. Omit to hide the close affordance. */
+    /**
+     * Dismiss the panel. Renders a close button in the panel header for
+     * STANDALONE use (outside the rail). When docked in `ControlRoomRail`, omit
+     * this — the rail injects its own close via `PanelHeaderActionsProvider`
+     * (passing it while docked would render a duplicate close control).
+     */
     onClose?: () => void;
     /** Footer disclaimer. Defaults to the BETA clinical-judgement note. */
     disclaimer?: ReactNode;

package/dist/components/entity-summary/index.js

@@ -1,4 +1,4 @@
-import { E as t } from "../../_chunks/entity-summary-BxRjFh_4.js";
+import { E as t } from "../../_chunks/entity-summary-CaM1Y-xE.js";
 export {
   t as EntitySummary
 };

package/dist/components/field-array/field-array.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { FieldArrayHandle } from './field-array';
+export declare const fieldArrayAgent: AgentAdapter<FieldArrayHandle>;
+//# sourceMappingURL=field-array.agent.d.ts.map

package/dist/components/field-array/field-array.d.ts

@@ -0,0 +1,45 @@
+import { type ReactElement, type ReactNode } from 'react';
+/**
+ * Agent-readiness curated handle for FieldArray. Non-generic on purpose — the
+ * adapter is typed `AgentAdapter<FieldArrayHandle>` and never sees `T`, so the
+ * handle exposes only the structural surface (row count + add/remove).
+ */
+export interface FieldArrayHandle {
+    getCount: () => number;
+    add: () => void;
+    remove: (index: number) => void;
+}
+export interface FieldArrayProps<T> {
+    /** The current rows. The consumer owns this array. */
+    items: T[];
+    /** Renders one row's fields. Called once per item. */
+    renderItem: (item: T, index: number) => ReactNode;
+    /** Append a new (consumer-shaped) row. */
+    onAdd: () => void;
+    /** Remove the row at `index`. */
+    onRemove: (index: number) => void;
+    /** Visible text on the add control. Consumer supplies localised text. */
+    addLabel: string;
+    /**
+     * Per-row accessible name for the remove control, e.g.
+     * `(i) => \`Remove rule ${i + 1}\``. Defaults to the kit's localised
+     * `Remove` string so the control always has an accessible name.
+     */
+    removeItemLabel?: (index: number) => string;
+    /** Group accessible name, rendered as a visible `<legend>` when provided. */
+    legend?: string;
+    /** Minimum rows — remove is disabled once `items.length <= min`. */
+    min?: number;
+    /** Maximum rows — add is disabled once `items.length >= max`. */
+    max?: number;
+    /** Stable id, used to address this instance from the agent runtime. */
+    id?: string;
+    className?: string;
+    /** Accessible name used when no `legend` is supplied. */
+    'aria-label'?: string;
+}
+export declare function FieldArray<T>({ items, renderItem, onAdd, onRemove, addLabel, removeItemLabel, legend, min, max, id, className, 'aria-label': ariaLabel, }: FieldArrayProps<T>): ReactElement;
+export declare namespace FieldArray {
+    var displayName: string;
+}
+//# sourceMappingURL=field-array.d.ts.map

package/dist/components/field-array/index.d.ts

@@ -0,0 +1,4 @@
+export { FieldArray } from './field-array';
+export type { FieldArrayProps, FieldArrayHandle } from './field-array';
+export { fieldArrayAgent } from './field-array.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/field-array/index.js

@@ -0,0 +1,6 @@
+import { F as e, f } from "../../_chunks/field-array-siUZzfYe.js";
+export {
+  e as FieldArray,
+  f as fieldArrayAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/freemium-paywall/freemium-paywall.d.ts

@@ -15,7 +15,7 @@ export interface FreemiumPlan {
 }
 declare const contentVariants: (props?: ({
     layout?: "sheet" | "centered" | null | undefined;
-    density?: "compact" | "full" | null | undefined;
+    density?: "full" | "compact" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 /** Curated imperative handle for agent / external automation. */
 export interface FreemiumPaywallHandle {

package/dist/components/gestational-age-calculator/index.js

@@ -1,4 +1,4 @@
-import { G as t } from "../../_chunks/gestational-age-calculator-CF2ISaYQ.js";
+import { G as t } from "../../_chunks/gestational-age-calculator-DKzEV5Qi.js";
 export {
   t as GestationalAgeCalculator
 };

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

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { IbanInputHandle } from './iban-input';
+export declare const ibanInputAgent: AgentAdapter<IbanInputHandle>;
+//# sourceMappingURL=iban-input.agent.d.ts.map