@alfadocs/ui-kit 0.69.0 → 0.70.0

package/dist/components/anatomy-scheme/anatomy-scheme-data.d.ts

@@ -0,0 +1,121 @@
+import type { MarkerShape, MarkerTone } from '../annotation-marker';
+/** Whole-body silhouette variant a body/muscular/skeletal view is drawn on. */
+export type FigureVariant = 'adult-male' | 'adult-female' | 'child';
+/** Organ / surface system a view belongs to — drives the practice-type fit. */
+export type AnatomySystem = 'body' | 'face' | 'female-reproductive' | 'male-reproductive' | 'urinary' | 'muscular' | 'skeletal';
+export type AnatomyViewId = string;
+export type AnatomyMode = 'interactive' | 'display';
+export type AnatomySide = 'left' | 'right' | 'midline';
+/**
+ * Generic, specialty-agnostic finding type. Each maps to a distinct
+ * AnnotationMarker SHAPE so the chart never relies on colour alone; the tone is
+ * decorative reinforcement. Consumers label these per specialty (a "lesion" is
+ * a derm lesion, an ortho fracture site, a gynae cyst, …).
+ */
+export type FindingType = 'observation' | 'lesion' | 'pain' | 'treatment' | 'note';
+export declare const FINDING_TYPES: FindingType[];
+export declare const FINDING_MARKER: Record<FindingType, {
+    shape: MarkerShape;
+    tone: MarkerTone;
+}>;
+export interface AnatomyFinding {
+    type: FindingType;
+    /** Optional free-text clinical note. PHI — never bundle real notes in stories. */
+    note?: string;
+}
+/** Findings keyed by region id. */
+export type AnatomyChart = Record<string, AnatomyFinding[]>;
+export type RegionShape = {
+    kind: 'ellipse';
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+} | {
+    kind: 'rect';
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    r?: number;
+} | {
+    kind: 'polygon';
+    points: Array<[number, number]>;
+} | {
+    kind: 'path';
+    d: string;
+    fillRule?: 'evenodd';
+};
+export interface AnatomyRegion {
+    /** Stable id, unique within a view — the finding key + `data-region`. */
+    id: string;
+    /** i18n key suffix under `anatomyScheme.region.*`. */
+    labelKey: string;
+    system: AnatomySystem;
+    shape: RegionShape;
+    /** Bilateral side, where meaningful (drives "left/right" in the label). */
+    side?: AnatomySide;
+    /** Optional grouping (e.g. 'upper-limb', 'internal', 'external'). */
+    group?: string;
+    /** Marker anchor; defaults to the shape centroid. */
+    marker?: {
+        x: number;
+        y: number;
+    };
+}
+export interface AnatomyView {
+    id: AnatomyViewId;
+    system: AnatomySystem;
+    /** i18n key suffix under `anatomyScheme.view.*`. */
+    labelKey: string;
+    /** Body silhouette this view is drawn on, when applicable. */
+    figure?: FigureVariant;
+    viewBox: string;
+    /** Decorative silhouette/outline drawn behind the regions (`aria-hidden`). */
+    silhouette?: string;
+    /** Optional SVG transform applied to the regions group (and the silhouette,
+     * unless `silhouetteTransform` overrides it). */
+    transform?: string;
+    /** Optional separate transform for the silhouette (head) group — lets the
+     * child figure carry a proportionally larger head than its scaled-down body. */
+    silhouetteTransform?: string;
+    /** Filled feature layer drawn over the silhouette, under the stroke detail
+     * (`aria-hidden`): the solid brows / eyelids / irises / lips that give a drawn
+     * face its weight. Painted with `--muted-foreground`. Shares the silhouette's
+     * transform group. */
+    silhouetteInk?: string;
+    /** Stroke-only feature layer drawn over the filled silhouette (`aria-hidden`):
+     * the line-art hairline / nose / ears / lower-lids of a drawn face. Shares the
+     * silhouette's transform group. */
+    silhouetteDetail?: string;
+    /** When true, the view's regions render as transparent click hotspots (tinting
+     * only on hover / focus / finding) rather than filled schematic shapes — used
+     * when a detailed `silhouette` already carries the drawing, so the zones don't
+     * cover it. Implied when a realistic illustration is loaded. */
+    hotspotZones?: boolean;
+    regions: AnatomyRegion[];
+}
+export declare function regionCentroid(region: AnatomyRegion): {
+    x: number;
+    y: number;
+};
+export declare const ANATOMY_VIEWS: Record<AnatomyViewId, AnatomyView>;
+export declare function getView(id: AnatomyViewId): AnatomyView | undefined;
+export declare function viewsForSystem(system: AnatomySystem): AnatomyView[];
+export declare function getRegion(viewId: AnatomyViewId, regionId: string): AnatomyRegion | undefined;
+/** Default view shown when only a `system` is given. */
+export declare const DEFAULT_VIEW_FOR_SYSTEM: Record<AnatomySystem, AnatomyViewId>;
+/**
+ * Pick a body figure from patient demographics — mirrors the platform's
+ * `getDefaultFigureVariant(gender, age)`. Pure heuristic; the host can override
+ * with the explicit `figure` prop.
+ */
+export declare function figureFromPatient(sex: 'm' | 'f' | 'x' | undefined, ageYears: number | undefined): FigureVariant;
+/**
+ * Practice-branch → the systems whose views that branch typically charts.
+ * Mirrors `PracticeBranch.php`; consumed by demos and the (future) preset
+ * editor to seed the available views. Not exhaustive — a branch can enable any.
+ */
+export declare const SYSTEMS_FOR_BRANCH: Record<string, AnatomySystem[]>;
+export declare function emptyChart(): AnatomyChart;
+//# sourceMappingURL=anatomy-scheme-data.d.ts.map

package/dist/components/anatomy-scheme/anatomy-scheme.agent.d.ts

@@ -0,0 +1,6 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { AnatomySchemeHandle } from './anatomy-scheme';
+import type { FindingType } from './anatomy-scheme-data';
+export declare const anatomySchemeAgent: AgentAdapter<AnatomySchemeHandle>;
+export type { FindingType };
+//# sourceMappingURL=anatomy-scheme.agent.d.ts.map

package/dist/components/anatomy-scheme/anatomy-scheme.d.ts

@@ -0,0 +1,69 @@
+import { type AnatomyChart, type AnatomyFinding, type AnatomyMode, type AnatomySystem, type AnatomyViewId, type FigureVariant, type FindingType } from './anatomy-scheme-data';
+export interface AnatomySchemeProps {
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
+    /** Organ / surface system to chart. Default `'body'`. */
+    system?: AnatomySystem;
+    /** Body silhouette variant (body/muscular/skeletal systems). */
+    figure?: FigureVariant;
+    /**
+     * Explicit view ids to expose. When more than one, they render as tabs.
+     * Defaults to every view of `system` (filtered to `figure` for body systems).
+     */
+    views?: AnatomyViewId[];
+    /** `'interactive'` enables region selection + finding edits; `'display'` is read-only. */
+    mode?: AnatomyMode;
+    /** Controlled findings — `Record<regionId, AnatomyFinding[]>`. */
+    value?: AnatomyChart;
+    /** Uncontrolled initial findings. */
+    defaultValue?: AnatomyChart;
+    /** Fired whenever the chart changes. */
+    onChange?: (next: AnatomyChart) => void;
+    /** Fired when a region is activated (click / Enter / Space / focus-select). */
+    onSelectRegion?: (regionId: string, viewId: AnatomyViewId) => void;
+    /**
+     * The finding type a region-click applies in interactive mode (the selected
+     * tool in a finding picker). Clicking a region toggles this finding.
+     */
+    activeFinding?: FindingType;
+    /** Show the finding-type legend below the figure. Default `false`. */
+    legend?: boolean;
+    /**
+     * Base URL for realistic anatomical illustrations, served per-view as
+     * `${illustrationBaseUrl}/${viewId}.svg` (e.g. `…/female-reproductive.svg`).
+     * When set, each view renders that illustration as the figure and the regions
+     * become transparent CLICK HOTSPOTS layered over it; when unset, the kit's
+     * built-in schematic silhouette is the fallback. The art is NOT bundled in
+     * the kit — host it (CDN) and pass the base here, mirroring `ToothScheme`'s
+     * `assetBaseUrl`. Trusted developer-controlled value, interpolated into an SVG
+     * `<image href>` (which cannot execute scripts). Sourcing + licensing +
+     * attribution live in `ANATOMY-ASSETS.md`.
+     */
+    illustrationBaseUrl?: string;
+    /** Accessible label override for the chart region. */
+    ariaLabel?: string;
+    /** Extra class names on the wrapper. */
+    className?: string;
+}
+export interface AnatomySchemeHandle {
+    /** Programmatically focus a region by id (in the active view). */
+    focusRegion: (regionId: string) => void;
+    /** Read the current chart state. */
+    getChart: () => AnatomyChart;
+    /** Read the findings recorded on one region (empty array if none). */
+    getRegion: (regionId: string) => AnatomyFinding[];
+    /** Read the region ids carrying a given finding type. */
+    regionsWith: (type: FindingType) => string[];
+    /** Add a finding to a region (no-op if already present). */
+    setFinding: (regionId: string, type: FindingType, note?: string) => void;
+    /** Remove a finding type from a region (no-op if absent). */
+    removeFinding: (regionId: string, type: FindingType) => void;
+    /** Clear every finding from a region. */
+    clearRegion: (regionId: string) => void;
+    /** Switch the active view. */
+    setView: (viewId: AnatomyViewId) => void;
+    /** Read the active view id. */
+    getView: () => AnatomyViewId;
+}
+export declare const AnatomyScheme: import("react").ForwardRefExoticComponent<AnatomySchemeProps & import("react").RefAttributes<AnatomySchemeHandle>>;
+//# sourceMappingURL=anatomy-scheme.d.ts.map

package/dist/components/anatomy-scheme/index.d.ts

@@ -0,0 +1,6 @@
+export { AnatomyScheme } from './anatomy-scheme';
+export type { AnatomySchemeProps, AnatomySchemeHandle } from './anatomy-scheme';
+export { ANATOMY_VIEWS, DEFAULT_VIEW_FOR_SYSTEM, SYSTEMS_FOR_BRANCH, FINDING_TYPES, FINDING_MARKER, getView, viewsForSystem, getRegion, regionCentroid, figureFromPatient, emptyChart as emptyAnatomyChart, } from './anatomy-scheme-data';
+export type { AnatomySystem, AnatomyViewId, AnatomyView, AnatomyRegion, AnatomyChart, AnatomyFinding, AnatomyMode, AnatomySide, FigureVariant, FindingType, RegionShape, } from './anatomy-scheme-data';
+export { anatomySchemeAgent } from './anatomy-scheme.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/anatomy-scheme/index.js

@@ -0,0 +1,17 @@
+import { A as s, a as t, D as S, F as o, b as m, S as r, c as A, e as n, f as F, g as _, d as g, r as i, v as E } from "../../_chunks/anatomy-scheme-CJB6dI6p.js";
+export {
+  s as ANATOMY_VIEWS,
+  t as AnatomyScheme,
+  S as DEFAULT_VIEW_FOR_SYSTEM,
+  o as FINDING_MARKER,
+  m as FINDING_TYPES,
+  r as SYSTEMS_FOR_BRANCH,
+  A as anatomySchemeAgent,
+  n as emptyAnatomyChart,
+  F as figureFromPatient,
+  _ as getRegion,
+  g as getView,
+  i as regionCentroid,
+  E as viewsForSystem
+};
+//# sourceMappingURL=index.js.map

package/dist/components/annotation-marker/annotation-marker.d.ts

@@ -0,0 +1,33 @@
+import { type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+export type MarkerShape = 'circle' | 'square' | 'triangle' | 'diamond' | 'cross';
+export type MarkerTone = 'neutral' | 'info' | 'success' | 'warning' | 'error' | 'accent';
+export declare const MARKER_SHAPES: MarkerShape[];
+/**
+ * SVG path `d` for a marker shape centred at `(cx, cy)` with radius `r`,
+ * in the parent SVG's own user units. Pure — no React, no DOM. AnatomyScheme
+ * draws its finding overlay with this exact function so the figure overlay and
+ * the standalone glyph stay visually identical.
+ */
+export declare function markerPath(shape: MarkerShape, cx: number, cy: number, r: number): string;
+declare const wrapperVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface AnnotationMarkerProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'>, VariantProps<typeof wrapperVariants> {
+    /** Shape of the marker — the accessible channel (never colour alone). */
+    shape: MarkerShape;
+    /** Semantic tone. Decorative reinforcement of the shape, not the meaning. */
+    tone?: MarkerTone;
+    /** Fill the shape (default) or draw it as an outline. */
+    filled?: boolean;
+    /**
+     * Accessible name. Required for an icon-only marker (no `label`); when `label`
+     * text is shown, this overrides the visible text for assistive tech.
+     */
+    'aria-label'?: string;
+    /** Optional visible label rendered after the glyph (e.g. in a legend). */
+    label?: ReactNode;
+}
+export declare const AnnotationMarker: import("react").ForwardRefExoticComponent<AnnotationMarkerProps & import("react").RefAttributes<HTMLSpanElement>>;
+export {};
+//# sourceMappingURL=annotation-marker.d.ts.map

package/dist/components/annotation-marker/index.d.ts

@@ -0,0 +1,3 @@
+export { AnnotationMarker, markerPath, MARKER_SHAPES, } from './annotation-marker';
+export type { AnnotationMarkerProps, MarkerShape, MarkerTone, } from './annotation-marker';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/annotation-marker/index.js

@@ -0,0 +1,7 @@
+import { A as o, M as t, m as A } from "../../_chunks/annotation-marker-qt5R9WZX.js";
+export {
+  o as AnnotationMarker,
+  t as MARKER_SHAPES,
+  A as markerPath
+};
+//# sourceMappingURL=index.js.map

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

@@ -60,8 +60,18 @@ export interface AppointmentItem {
     firstVisit?: AppointmentFirstVisit;
     /** Assigned operator. */
     operator?: AppointmentOperator;
-    /** Chair / room label. */
+    /** Chair / room label — surfaced as a chip. */
     chair?: string;
+    /**
+     * The care plan this appointment belongs to, when any — surfaced as a chip
+     * (`Care plan {number}`). `url` is the deep link the consumer may use for
+     * navigation; the chip itself is non-interactive so it never nests an anchor
+     * inside the row's own stretched link.
+     */
+    carePlan?: {
+        number: string;
+        url?: string;
+    };
     /** Patient identity. */
     patient?: AppointmentPatient;
     /** Treatment lines. */
@@ -76,16 +86,30 @@ export interface AppointmentItem {
 declare const appointmentCardVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
     interactive?: boolean | null | undefined;
+    surface?: "flat" | "elevated" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface AppointmentCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onClick' | 'role' | 'title'>, VariantProps<typeof appointmentCardVariants> {
     /** The appointment to render. */
     item: AppointmentItem;
     /** Visual density. */
     size?: 'sm' | 'md';
+    /**
+     * `'flat'` (default) — chrome-less row for use inside a bordered
+     * `AppointmentTray`. `'elevated'` — each row carries its own card chrome
+     * (border + shadow), for placing rows directly on a rail (AppointmentTimeline).
+     */
+    surface?: 'flat' | 'elevated';
     /** BCP-47 locale override for the timestamp + currency. */
     locale?: string;
     /** ISO-4217 currency code for the advance-deposit chip. Defaults to `EUR`. */
     currency?: string;
+    /**
+     * Show the patient identity (avatar + name as the row title). Default `true`.
+     * Set `false` in single-patient surfaces (e.g. a patient's own
+     * `AppointmentTimeline`) where repeating the name is redundant — the row then
+     * leads with the operator as its title, falling back to a generic label.
+     */
+    showPatient?: boolean;
     /** Fires when the row is activated. */
     onActivate?: (item: AppointmentItem) => void;
 }

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

@@ -1,10 +1,11 @@
-import { A as n, a as p, b as e, c as o } from "../../_chunks/appointment-tray-CZtvtaH-.js";
+import { A as p } from "../../_chunks/appointment-card-C06aZqA7.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-DRRw5ROi.js";
 import { i } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {
-  n as AppointmentCard,
-  p as AppointmentTray,
-  e as appointmentCardAgent,
-  o as appointmentTrayAgent,
+  p as AppointmentCard,
+  e as AppointmentTray,
+  o as appointmentCardAgent,
+  r as appointmentTrayAgent,
   i as isSafeAppointmentUrl
 };
 //# sourceMappingURL=index.js.map

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-BJM0S_Fg.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-Cpdk5qpQ.js";
 export {
   r as AudioRecorder,
   a as audioRecorderAgent

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-DnYWtZa_.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-DUBI0oqt.js";
 export {
   A as Booking,
   R as CONFIRMATION_CHANNEL_ORDER,

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-C5sTfY9G.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-CXnxGCWA.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,100 @@
+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 — rendered in the eyebrow (or as the heading when no `name`). */
+    number: string | number;
+    /**
+     * Override the eyebrow's plan-number label (e.g. a consumer's own
+     * `Plan #15`). Defaults to the localised `Care plan {{number}}` shared with
+     * `CarePlanCard`, so the two surfaces read alike unless a consumer opts out.
+     */
+    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 rendered as a muted `Timestamp` line. */
+    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-BUwqDTtz.js";
+export {
+  r as CarePlanHeader,
+  n as carePlanHeaderAgent
+};
+//# sourceMappingURL=index.js.map