@alfadocs/ui-kit 0.70.0 → 0.71.0

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

@@ -0,0 +1,51 @@
+import { type IbanReason } from './is-valid-iban';
+/** Agent-readiness curated handle for IbanInput. */
+export interface IbanInputHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+    focus: () => void;
+    isValid: () => boolean;
+}
+/** Structured payload emitted on every keystroke alongside the raw value. */
+export interface IbanChangeMeta {
+    /** Structurally complete AND the mod-97-10 checksum matches. */
+    isValid: boolean;
+    /** Whether the value has reached its country's expected length. */
+    isComplete: boolean;
+    /** Why the value is (in)valid — drives consumer messaging. */
+    reason: IbanReason;
+}
+export interface IbanInputProps {
+    /** Controlled value (raw, uppercased, no spaces). Pair with onChange. */
+    value?: string;
+    /** Uncontrolled initial value. Normalised on mount. */
+    defaultValue?: string;
+    /** Fires on every keystroke with the normalised raw string + meta. */
+    onChange?: (raw: string, meta: IbanChangeMeta) => void;
+    size?: 'sm' | 'md' | 'lg';
+    tone?: 'default' | 'error';
+    /** When the invalid tone + error string surface. Never marks partial input invalid. */
+    validateOn?: 'change' | 'blur' | 'submit';
+    /** Controlled escape hatch to force the invalid state (e.g. bank rejection). */
+    showError?: boolean;
+    /** Overrides the kit's default i18n error string. */
+    errorMessage?: string;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    placeholder?: string;
+    /** Render the format caption when NOT inside a FormField. */
+    showFormatHint?: boolean;
+    id?: string;
+    name?: string;
+    className?: string;
+    'aria-label'?: string;
+}
+declare const wrapperVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    tone?: "default" | "error" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const IbanInput: import("react").ForwardRefExoticComponent<IbanInputProps & import("react").RefAttributes<HTMLInputElement>>;
+export { wrapperVariants as ibanWrapperVariants };
+//# sourceMappingURL=iban-input.d.ts.map

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

@@ -0,0 +1,5 @@
+export { IbanInput, ibanWrapperVariants } from './iban-input';
+export type { IbanInputProps, IbanInputHandle, IbanChangeMeta, } from './iban-input';
+export { ibanInputAgent } from './iban-input.agent';
+export { classifyIban, isValidIban, ibanMod97, IBAN_LENGTHS, MIN_IBAN_LENGTH, MAX_IBAN_LENGTH, type IbanReason, } from './is-valid-iban';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,13 @@
+import { I as n, a as I, M as i, b, c as N, i as p, d as r, w as t, e as A } from "../../_chunks/iban-input-B0TWzR1R.js";
+export {
+  n as IBAN_LENGTHS,
+  I as IbanInput,
+  i as MAX_IBAN_LENGTH,
+  b as MIN_IBAN_LENGTH,
+  N as classifyIban,
+  p as ibanInputAgent,
+  r as ibanMod97,
+  t as ibanWrapperVariants,
+  A as isValidIban
+};
+//# sourceMappingURL=index.js.map

package/dist/components/iban-input/is-valid-iban.d.ts

@@ -0,0 +1,31 @@
+/** Why an IBAN is (in)valid — drives the component's error messaging. */
+export type IbanReason = 'valid' | 'empty' | 'incomplete' | 'badFormat' | 'badChecksum';
+/**
+ * Published IBAN lengths by ISO-3166 alpha-2 country code (the SEPA zone plus
+ * the common non-SEPA registry entries). Used to decide when a typed value is
+ * "complete" so the component never flags a partially-entered IBAN as invalid.
+ */
+export declare const IBAN_LENGTHS: Record<string, number>;
+/** The shortest registered IBAN (Norway, 15) — the completeness floor for an
+ *  unknown country code. */
+export declare const MIN_IBAN_LENGTH = 15;
+/** The longest registered IBAN (34) — the hard input cap. */
+export declare const MAX_IBAN_LENGTH = 34;
+/**
+ * ISO 7064 mod-97-10. Moves the leading 4 characters (country + check digits)
+ * to the end, maps letters A–Z to 10–35, and reduces the resulting decimal
+ * string modulo 97 in chunks (avoids BigInt). A valid IBAN yields `1`.
+ *
+ * Assumes `value` is already normalised to `[A-Z0-9]` (uppercase, no spaces).
+ */
+export declare function ibanMod97(value: string): number;
+/**
+ * Classify a normalised (uppercased, `[A-Z0-9]`, ≤34-char) IBAN string. Returns
+ * `'incomplete'` while the value is shorter than its country expects so the
+ * caller can stay silent mid-entry, and only `'badFormat'` / `'badChecksum'`
+ * once the value is structurally complete.
+ */
+export declare function classifyIban(raw: string): IbanReason;
+/** Convenience boolean wrapper around {@link classifyIban}. */
+export declare function isValidIban(raw: string): boolean;
+//# sourceMappingURL=is-valid-iban.d.ts.map

package/dist/components/icon-picker/icon-picker.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { IconPickerHandle } from './icon-picker';
+export declare const iconPickerAgent: AgentAdapter<IconPickerHandle>;
+//# sourceMappingURL=icon-picker.agent.d.ts.map

package/dist/components/icon-picker/icon-picker.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+/** One selectable glyph. `label` is the accessible name (consumer-localised);
+ *  `node` is the rendered lucide/SVG element. */
+export interface IconPickerIcon {
+    id: string;
+    label: string;
+    node: ReactNode;
+}
+/** Agent-readiness curated handle for IconPicker. */
+export interface IconPickerHandle {
+    getValue: () => string;
+    setValue: (id: string) => void;
+    isOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+    getQuery: () => string;
+    setQuery: (query: string) => void;
+}
+export interface IconPickerProps {
+    /** The glyph set. `label` is each glyph's accessible name. */
+    icons: IconPickerIcon[];
+    /** Controlled selected icon id. Pair with onChange. */
+    value?: string;
+    /** Uncontrolled initial selected icon id. */
+    defaultValue?: string;
+    /** Fires with the chosen icon id when a glyph is picked. */
+    onChange?: (id: string) => void;
+    /** Shown on the trigger when nothing is selected. */
+    placeholder?: ReactNode;
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+    /** Trigger accessible name. Defaults to the bundled `iconPicker.trigger`. */
+    'aria-label'?: string;
+}
+declare const optionVariants: (props?: ({
+    selected?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const IconPicker: import("react").ForwardRefExoticComponent<IconPickerProps & import("react").RefAttributes<HTMLButtonElement>>;
+export { optionVariants as iconPickerOptionVariants };
+//# sourceMappingURL=icon-picker.d.ts.map

package/dist/components/icon-picker/index.d.ts

@@ -0,0 +1,4 @@
+export { IconPicker } from './icon-picker';
+export type { IconPickerProps, IconPickerHandle, IconPickerIcon, } from './icon-picker';
+export { iconPickerAgent } from './icon-picker.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/icon-picker/index.js

@@ -0,0 +1,6 @@
+import { I as i, i as o } from "../../_chunks/icon-picker-0B7KhrF1.js";
+export {
+  i as IconPicker,
+  o as iconPickerAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/image-cropper/crop-geometry.d.ts

@@ -0,0 +1,30 @@
+/** Normalised crop rectangle (each field in the closed interval [0, 1]). */
+export interface CropRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare const clamp01: (v: number) => number;
+/**
+ * Clamp a rectangle so it stays within the unit box and never shrinks below
+ * `minSize` on either axis.
+ */
+export declare function clampRect(rect: CropRect, minSize: number): CropRect;
+/**
+ * Coerce a rectangle's height to honour a pixel aspect ratio
+ * (`width_px / height_px`), anchored at its top-inline-start corner. `boxW` /
+ * `boxH` are the displayed image box's pixel dimensions. A non-positive aspect
+ * or unmeasured box returns the rectangle unchanged.
+ */
+export declare function applyAspect(rect: CropRect, aspect: number | undefined, boxW: number, boxH: number): CropRect;
+/** A sensible centred default — an 80% box, aspect-coerced when one is set. */
+export declare function defaultCrop(aspect: number | undefined, boxW: number, boxH: number): CropRect;
+/** Round each field to whole percentages — used for the live-region readout. */
+export declare function toPercent(rect: CropRect): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=crop-geometry.d.ts.map

package/dist/components/image-cropper/image-cropper.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ImageCropperHandle } from './image-cropper';
+export declare const imageCropperAgent: AgentAdapter<ImageCropperHandle>;
+//# sourceMappingURL=image-cropper.agent.d.ts.map

package/dist/components/image-cropper/image-cropper.d.ts

@@ -0,0 +1,32 @@
+import { type CropRect } from './crop-geometry';
+/** Agent-readiness curated handle for ImageCropper. */
+export interface ImageCropperHandle {
+    getCrop: () => CropRect;
+    setCrop: (rect: CropRect) => void;
+    reset: () => void;
+    focus: () => void;
+}
+export interface ImageCropperProps {
+    /** Source of the image to crop (object URL, data URL, or remote src). */
+    src: string;
+    /** Accessible description of the image being cropped (consumer-supplied). */
+    alt: string;
+    /** Pixel aspect ratio (width / height) to lock the crop to. Omit for free-form. */
+    aspect?: number;
+    /** Controlled crop rect in normalised [0,1] coordinates. Pair with onChange. */
+    value?: CropRect;
+    /** Uncontrolled initial crop rect. */
+    defaultValue?: CropRect;
+    /** Fires with the new normalised crop rect on every move/resize. */
+    onChange?: (rect: CropRect) => void;
+    /** Smallest crop edge as a fraction of the image (default 0.1). */
+    minSize?: number;
+    /** Normalised step applied per arrow-key press (default 0.02). */
+    keyboardStep?: number;
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+    'aria-label'?: string;
+}
+export declare const ImageCropper: import("react").ForwardRefExoticComponent<ImageCropperProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=image-cropper.d.ts.map

package/dist/components/image-cropper/index.d.ts

@@ -0,0 +1,5 @@
+export { ImageCropper } from './image-cropper';
+export type { ImageCropperProps, ImageCropperHandle } from './image-cropper';
+export { imageCropperAgent } from './image-cropper.agent';
+export { clampRect, applyAspect, defaultCrop, toPercent, clamp01, type CropRect, } from './crop-geometry';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/image-cropper/index.js

@@ -0,0 +1,11 @@
+import { I as p, a as r, c as s, b as t, d as c, i as o, t as m } from "../../_chunks/image-cropper-D9jqJy19.js";
+export {
+  p as ImageCropper,
+  r as applyAspect,
+  s as clamp01,
+  t as clampRect,
+  c as defaultCrop,
+  o as imageCropperAgent,
+  m as toPercent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/index.d.ts

@@ -10,6 +10,11 @@ export { SafeHtml, sanitiseHtml } from './_shared/safe-html';
 export type { SafeHtmlProps, SafeHtmlProfile } from './_shared/safe-html';
 export type { OptionShape } from './_shared/option';
 export * from './address-autocomplete';
+export * from './address-fields';
+export * from './city-input';
+export * from './country-select';
+export * from './postal-code-input';
+export * from './province-select';
 export * from './autocomplete';
 export * from './checkbox';
 export * from './checkbox-group';
@@ -26,6 +31,13 @@ export * from './bishop-score';
 export * from './fetal-weight';
 export * from './hcg-doubling';
 export * from './email-input';
+export * from './iban-input';
+export * from './field-array';
+export * from './icon-picker';
+export * from './image-cropper';
+export * from './permission-matrix';
+export * from './position-grid';
+export * from './token-insert-menu';
 export * from './file-upload';
 export * from './form-field';
 export * from './multi-select';
@@ -54,6 +66,7 @@ export * from './calculator-dialog';
 export * from './cycle-calculator';
 export * from './card';
 export * from './carousel';
+export * from './connection-status';
 export * from './contact-card';
 export * from './counter';
 export * from './data-table';
@@ -75,12 +88,12 @@ export * from './stat';
 export * from './tag';
 export * from './timeline';
 export * from './timestamp';
-export * from './ai-tools-rail';
 export * from './control-room-rail';
 export * from './breadcrumb';
 export * from './command-palette';
 export * from './header';
 export * from './navigation-menu';
+export * from './nav-grid';
 export * from './link';
 export * from './pagination';
 export * from './public-footer';
@@ -119,12 +132,14 @@ export * from './sheet';
 export * from './spinner';
 export * from './task-card';
 export * from './task-tray';
+export * from './tasks-panel';
 export * from './toast';
 export * from './tooltip';
 export * from './warning-stack';
 export * from './app-frame';
 export * from './aspect-ratio';
 export * from './collapsible';
+export * from './panel-header';
 export * from './resizable';
 export * from './scroll-area';
 export * from './separator';

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

@@ -1,4 +1,4 @@
-import { M as a } from "../../_chunks/message-card-Bx4GmLvf.js";
+import { M as a } from "../../_chunks/message-card-DsHFFiL1.js";
 import { m as o } from "../../_chunks/message-card.agent-ZLhx3Bs5.js";
 import { i as f } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {

package/dist/components/message-card/message-card.d.ts

@@ -39,6 +39,19 @@ export interface MessageCardProps extends Omit<HTMLAttributes<HTMLDivElement>, '
      *   controls (used by dashboards / sidebars).
      */
     variant?: 'compact' | 'dashboard';
+    /**
+     * Fires when the read/unread status ball (the corner badge on the avatar) is
+     * activated. Supply to make the ball an interactive toggle; omit and it
+     * renders as a static read-state indicator.
+     */
+    onToggleRead?: (item: MessageItem) => void;
+    /**
+     * Row chrome for the `compact` variant (ignored for `dashboard`). `'flat'`
+     * (default) — chrome-less row inside a bordered tray. `'elevated'` — own
+     * card chrome (border + `--shadow-sm`), matching `AppointmentCard` /
+     * `ClinicalNoteCard` for rail feeds (e.g. the Inbox).
+     */
+    surface?: 'flat' | 'elevated';
     /** Visual density. */
     size?: 'sm' | 'md';
     /** Fires when the row / title is activated. */
@@ -67,6 +80,7 @@ declare const cardVariants: (props?: ({
     variant?: "compact" | "dashboard" | null | undefined;
     size?: "sm" | "md" | null | undefined;
     state?: "read" | "unread" | null | undefined;
+    surface?: "flat" | "elevated" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export declare const MessageCard: import("react").ForwardRefExoticComponent<MessageCardProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=message-card.d.ts.map

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

@@ -1,4 +1,4 @@
-import { M as s, m as r } from "../../_chunks/message-tray-DwrBLJlf.js";
+import { M as s, m as r } from "../../_chunks/message-tray-C0a6CL1_.js";
 export {
   s as MessageTray,
   r as messageTrayAgent

package/dist/components/message-tray/message-tray.d.ts

@@ -18,6 +18,10 @@ export interface MessageTrayHandle {
     selectItem: (id: string) => void;
     markRead: (id: string) => void;
     dismiss: (id: string) => void;
+    /** Request the host to mark every message as read (mirrors onMarkAllRead). */
+    markAllRead: () => void;
+    /** Navigate to the full inbox (mirrors onViewAll). */
+    viewAll: () => void;
 }
 export interface MessageTrayProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'children' | 'role' | 'id'>, VariantProps<typeof messageTrayVariants> {
     /**

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

@@ -1,4 +1,4 @@
-import { M as a, m as l, a as i } from "../../_chunks/multi-select-BdHHDrRN.js";
+import { M as a, m as l, a as i } from "../../_chunks/multi-select-WE4S9FIF.js";
 export {
   a as MultiSelect,
   l as multiSelectAgent,

package/dist/components/nav-grid/index.d.ts

@@ -0,0 +1,4 @@
+export { NavGrid, navGridTileVariants } from './nav-grid';
+export type { NavGridProps, NavGridItem, NavGridHandle } from './nav-grid';
+export { navGridAgent } from './nav-grid.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/nav-grid/index.js

@@ -0,0 +1,7 @@
+import { N as i, n, t as s } from "../../_chunks/nav-grid-9xphY3FM.js";
+export {
+  i as NavGrid,
+  n as navGridAgent,
+  s as navGridTileVariants
+};
+//# sourceMappingURL=index.js.map

package/dist/components/nav-grid/nav-grid.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { NavGridHandle } from './nav-grid';
+export declare const navGridAgent: AgentAdapter<NavGridHandle>;
+//# sourceMappingURL=nav-grid.agent.d.ts.map

package/dist/components/nav-grid/nav-grid.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+export interface NavGridItem {
+    /** Stable, opaque id. Emitted as `data-nav-item-id`; agents target it. */
+    id: string;
+    /** Localised tile label — supplied by the consumer (never bundled here). */
+    label: string;
+    /** Optional localised supporting text shown under the label. */
+    description?: string;
+    /** Decorative leading glyph. Rendered `aria-hidden`. */
+    icon?: ReactNode;
+    /** When set, the tile is a navigating anchor (kit Link). */
+    href?: string;
+    /** When `href` is absent, the tile is a button firing this handler. */
+    onSelect?: () => void;
+    /** Render the tile non-interactive and visually muted. */
+    disabled?: boolean;
+}
+/** Agent-readiness curated handle for NavGrid. */
+export interface NavGridHandle {
+    getItemCount: () => number;
+    /** Activate the tile with the given id (navigate, or fire its onSelect). */
+    openItem: (id: string) => void;
+}
+export interface NavGridProps {
+    /** Tiles to render. label / description / icon are consumer-supplied props. */
+    items: NavGridItem[];
+    /** REQUIRED — the nav landmark's accessible name (e.g. "Settings sections"). */
+    ariaLabel: string;
+    /** Column count. Omit for the responsive default (1 → 2 → 3 at sm / lg). */
+    columns?: 1 | 2 | 3 | 4;
+    /** `label` sorts tiles by `label.localeCompare`; `none` (default) preserves order. */
+    sort?: 'label' | 'none';
+    id?: string;
+    className?: string;
+}
+declare const tileVariants: (props?: ({
+    disabled?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const NavGrid: import("react").ForwardRefExoticComponent<NavGridProps & import("react").RefAttributes<HTMLElement>>;
+export { tileVariants as navGridTileVariants };
+//# sourceMappingURL=nav-grid.d.ts.map

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

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

package/dist/components/notes-panel/notes-panel.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { NotesPanelHandle } from './notes-panel';
+export declare const notesPanelAgent: AgentAdapter<NotesPanelHandle>;
+//# sourceMappingURL=notes-panel.agent.d.ts.map

package/dist/components/notes-panel/notes-panel.d.ts

@@ -3,6 +3,31 @@ import type { ClinicalNoteCardProps } from '../clinical-note-card';
 import type { RichTextEditorProps, RichTextEditorToolbar, RedactorFactory } from '../rich-text-editor';
 /** One note in the panel — the data subset of `ClinicalNoteCard`. */
 export type NotesPanelNote = Pick<ClinicalNoteCardProps, 'id' | 'dateIso' | 'createdAtIso' | 'author' | 'clinical' | 'attachedTo' | 'content' | 'contentFormat' | 'pinned' | 'flagged'>;
+/**
+ * Curated agent handle for NotesPanel. Reads the note timeline's STRUCTURE
+ * (ids + pinned / flagged / clinical flags — never the note body or author,
+ * both PHI) and drives the composer + per-note toggles. See
+ * `notes-panel.agent.ts`.
+ */
+export interface NotesPanelHandle {
+    /** Timeline snapshot — ids + flags only, never note content (PHI). */
+    getNotes: () => Array<{
+        id?: string;
+        pinned: boolean;
+        flagged: boolean;
+        clinical: boolean;
+    }>;
+    /** Whether the composer is mounted (onAddNote is wired). */
+    canAddNote: () => boolean;
+    /** Whether clinical notes may be written (the permission gate). */
+    canAddClinical: () => boolean;
+    /** Commit a new note with explicit content (mirrors the composer's submit). */
+    addNote: (submission: NotesPanelSubmission) => void;
+    /** Toggle a note's pinned state (mirrors onTogglePin). */
+    togglePin: (id: string) => void;
+    /** Toggle a note's flagged state (mirrors onToggleFlag). */
+    toggleFlag: (id: string) => void;
+}
 /** Payload handed to `onAddNote` when the composer commits. */
 export interface NotesPanelSubmission {
     /** The note body — rich HTML (`composer='rich'`) or plain text. */
@@ -11,6 +36,11 @@ export interface NotesPanelSubmission {
     clinical: boolean;
 }
 export interface NotesPanelProps 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 notes panel.
+     */
+    id?: string;
     /** Notes to render, newest-first by convention. Pinned notes lead. */
     notes: NotesPanelNote[];
     /** Commit a new note. Omit to hide the composer (read-only timeline). */

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

@@ -1,4 +1,4 @@
-import { N as a, i as t } from "../../_chunks/notification-card-D2jiKSJJ.js";
+import { N as a, i as t } from "../../_chunks/notification-card-BMqNzCIt.js";
 import { n as f } from "../../_chunks/notification-card.agent-DxGBZb8T.js";
 export {
   a as NotificationCard,

package/dist/components/notification-card/notification-card.d.ts

@@ -27,10 +27,24 @@ export interface NotificationCardProps extends Omit<HTMLAttributes<HTMLDivElemen
      *   controls (used by dashboards / sidebars).
      */
     variant?: 'compact' | 'dashboard';
+    /**
+     * Row chrome for the `compact` variant (ignored for `dashboard`, which
+     * always carries its own card border). `'flat'` (default) — chrome-less row
+     * for use inside a bordered tray. `'elevated'` — each row carries its own
+     * card chrome (border + `--shadow-sm`), matching `AppointmentCard` /
+     * `ClinicalNoteCard` for placing rows directly on a rail (e.g. the Inbox).
+     */
+    surface?: 'flat' | 'elevated';
     /** Visual density. */
     size?: 'sm' | 'md';
     /** Fires when the card title / body is activated. */
     onActivate?: (item: NotificationItem) => void;
+    /**
+     * Fires when the read/unread status ball (the corner badge on the category
+     * icon) is activated. Supply to make the ball an interactive toggle; omit and
+     * it renders as a static read-state indicator.
+     */
+    onToggleRead?: (item: NotificationItem) => void;
     /** Fires when the dismiss control is activated. */
     onDismiss?: (item: NotificationItem) => void;
     /**
@@ -55,6 +69,7 @@ declare const cardVariants: (props?: ({
     variant?: "compact" | "dashboard" | null | undefined;
     size?: "sm" | "md" | null | undefined;
     state?: "read" | "unread" | null | undefined;
+    surface?: "flat" | "elevated" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export declare function isSafeNotificationUrl(url: string): boolean;
 export declare const NotificationCard: import("react").ForwardRefExoticComponent<NotificationCardProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/notification-tray/index.js

@@ -1,4 +1,4 @@
-import { N as o, n as t } from "../../_chunks/notification-tray-AEun6DN2.js";
+import { N as o, n as t } from "../../_chunks/notification-tray-BmUlCx3g.js";
 export {
   o as NotificationTray,
   t as notificationTrayAgent

package/dist/components/notification-tray/notification-tray.d.ts

@@ -18,6 +18,10 @@ export interface NotificationTrayHandle {
     selectItem: (id: string) => void;
     markRead: (id: string) => void;
     dismiss: (id: string) => void;
+    /** Request the host to mark every notification as read (mirrors onMarkAllRead). */
+    markAllRead: () => void;
+    /** Navigate to the full notification list (mirrors onViewAll). */
+    viewAll: () => void;
 }
 export interface NotificationTrayProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'children' | 'role' | 'id'>, VariantProps<typeof notificationTrayVariants> {
     /**

package/dist/components/operator-hero/index.js

@@ -1,4 +1,4 @@
-import { O as e, o as a } from "../../_chunks/operator-hero-CR0Rqh4-.js";
+import { O as e, o as a } from "../../_chunks/operator-hero-BO8TqzX2.js";
 export {
   e as OperatorHero,
   a as operatorHeroAgent

package/dist/components/panel-header/index.d.ts

@@ -0,0 +1,3 @@
+export { PanelHeader, PanelHeaderActionsProvider, usePanelHeaderActions, } from './panel-header';
+export type { PanelHeaderProps } from './panel-header';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,7 @@
+import { P as r, a as s, u as n } from "../../_chunks/panel-header-D313n_9-.js";
+export {
+  r as PanelHeader,
+  s as PanelHeaderActionsProvider,
+  n as usePanelHeaderActions
+};
+//# sourceMappingURL=index.js.map

package/dist/components/panel-header/panel-header.d.ts

@@ -0,0 +1,41 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+/**
+ * Provides rail-injected actions that every descendant `PanelHeader`
+ * appends to its action cluster, after the panel's own `actions`. The
+ * rail (or any host) wraps the panel subtree once; standalone panels
+ * render without a provider and inject nothing.
+ */
+export declare function PanelHeaderActionsProvider({ actions, children, }: {
+    actions: ReactNode;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** Reads the rail-injected actions for the current subtree (default `null`). */
+export declare function usePanelHeaderActions(): ReactNode;
+declare const headerVariants: (props?: ({
+    sticky?: boolean | null | undefined;
+    divider?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface PanelHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'>, VariantProps<typeof headerVariants> {
+    /** Heading content. Already translated upstream. */
+    title: ReactNode;
+    /** Optional leading glyph — auto `aria-hidden` and sized to `--spacing` 4. */
+    icon?: ReactNode;
+    /** `id` applied to the heading so panels can wire `aria-labelledby`. */
+    headingId?: string;
+    /** Semantic heading level. Default `2`. */
+    headingLevel?: 2 | 3;
+    /** Panel-owned actions, rendered inline-end of the title row. */
+    actions?: ReactNode;
+    /** Optional second row, typically filter controls. */
+    filters?: ReactNode;
+    /** Pin to the top of the scroll region. Default `false`. */
+    sticky?: boolean;
+    /** Bottom hairline. Default `true`. */
+    divider?: boolean;
+    /** Type scale of the heading. Default `'card'`. */
+    titleScale?: 'card' | 'section';
+}
+export declare const PanelHeader: import("react").ForwardRefExoticComponent<PanelHeaderProps & import("react").RefAttributes<HTMLElement>>;
+export {};
+//# sourceMappingURL=panel-header.d.ts.map

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

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

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

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