@alfadocs/ui-kit 0.69.0 → 0.71.0

package/dist/components/_shared/patient-fields.d.ts

@@ -0,0 +1,119 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * Canonical field TYPE. When set (and no explicit `value` is supplied), the
+ * kit renders the field's canonical chip from the shared `<FieldValue>`
+ * registry instead of plain text — so the SAME field type looks the same on
+ * every surface. Each chip is a high-contrast neutral pill with a glyph:
+ *
+ * - `sex`        → Venus / Mars / User glyph + localised label
+ * - `age`        → hourglass glyph + localised, pluralised age
+ * - `dob`        → calendar glyph + locale-formatted date
+ * - `fiscalCode` → hash glyph + monospace code (already mono — no `mono` flag
+ *                  needed; copy + PHI lock stay the row-level affordance via
+ *                  `copyable` / `sensitive`)
+ * - `discount`   → `TransactionChip` `state="discount"` (the canonical monetary
+ *                  discount chip — magnitude + `currency`, sign owned by the chip)
+ * - `email`      → a `mailto:` `Link` (the address is both display + target)
+ * - `phone`      → a `tel:` `Link` (formatted display, target normalised to
+ *                  `+` and digits)
+ *
+ * The raw datum is read from `editValue` (the same scalar that seeds the
+ * editor): a number for `age` / `discount`, an ISO string or `Date` for `dob`,
+ * a code string for `sex`, the code string for `fiscalCode`. For the contact
+ * link kinds the DISPLAY string is read from `value` (or `editValue`) and the
+ * href is derived from it — so a plain-string `value` still becomes a link.
+ * For every OTHER kind an explicit `value` ALWAYS wins, so a consumer can still
+ * override per placement.
+ */
+export type PatientFieldKind = 'sex' | 'age' | 'dob' | 'fiscalCode' | 'discount' | 'email' | 'phone';
+/** Editor control rendered when a field enters inline-edit mode. */
+export type PatientFieldEditType = 'text' | 'textarea' | 'select' | 'boolean' | 'date' | 'number' | 'email' | 'phone' | 'fiscalCode' | 'province' | 'country' | 'postalCode' | 'city';
+/** A choice for an `editType: 'select'` field. */
+export interface PatientFieldOption {
+    value: string;
+    label: string;
+}
+/**
+ * Raw value seeded into an editor. The kit never inspects this beyond
+ * handing it to the matching control and back through a save callback.
+ */
+export type PatientFieldEditValue = string | number | boolean | Date | null | undefined;
+/** One label→value patient field. */
+export interface PatientField {
+    /**
+     * Stable field key — drives visibility, ordering, the `data-field-id`
+     * hook, and agent addressing. MUST NOT be the value (no PHI in keys).
+     */
+    id: string;
+    /** Display label (already localised by the consumer, or a kit label). */
+    label: string;
+    /**
+     * Display node — formatted by the consumer (Badge / Tag / Link / text).
+     * Optional: omit it and set `kind` to let the kit render the field's
+     * canonical chip from `editValue`. When present, `value` ALWAYS wins.
+     */
+    value?: ReactNode;
+    /**
+     * Canonical field type — when set and `value` is omitted, the kit renders
+     * the matching canonical chip from the shared registry. Presentation only;
+     * NEVER emitted into any `data-*` attribute (same rule as `sensitive`).
+     */
+    kind?: PatientFieldKind;
+    /** Leading icon (a single lucide element). */
+    icon?: ReactElement | null;
+    /** Render the copy-to-clipboard affordance (fiscal code, ids). */
+    copyable?: boolean;
+    /** Text written to the clipboard when `copyable`. */
+    copyText?: string;
+    /** Render the value monospaced (codes, ids). */
+    mono?: boolean;
+    /**
+     * High-sensitivity PHI marker — renders a lock glyph next to the label.
+     * Presentation only; NEVER emitted into any `data-*` attribute.
+     */
+    sensitive?: boolean;
+    /** Whether this field can be inline-edited (consumer gates by permission). */
+    editable?: boolean;
+    /** Control used in edit mode. Defaults to `'text'`. */
+    editType?: PatientFieldEditType;
+    /** Options for `editType: 'select'`. */
+    options?: PatientFieldOption[];
+    /** Value seeded into the editor when editing begins. */
+    editValue?: PatientFieldEditValue;
+    /** Currency code for `editType: 'number'` (renders a currency input). */
+    currency?: string;
+}
+/** A labelled, collapsible group of fields. */
+export interface PatientFieldSection {
+    /** Stable section key. */
+    id: string;
+    /** Section heading. */
+    heading: string;
+    fields: PatientField[];
+    /** Wrap the section in a Collapsible (default `true`). Honoured by PatientDetails. */
+    collapsible?: boolean;
+    /** Initial open state when `collapsible` (default `true`). */
+    defaultOpen?: boolean;
+}
+/** The flat declaration-order list of every field id — the "show everything" default. */
+export declare function patientFieldCatalogue(sections: PatientFieldSection[]): string[];
+/** A section paired with its currently-visible fields, in the chosen order. */
+export interface ResolvedPatientSection {
+    section: PatientFieldSection;
+    fields: PatientField[];
+}
+/**
+ * Project `sections` to the visible fields per section, ordered by
+ * `visibleFieldOrder`. This is the single piece of visibility logic shared
+ * by every patient surface, so the card and the details panel always agree
+ * on what is shown and in what order.
+ *
+ * `visibleFieldOrder` omitted (`undefined`) ⇒ every field visible in
+ * declaration order ("show everything by default", design doc D3). An explicit
+ * empty array `[]` ⇒ NO fields visible — a surface that starts collapsed and
+ * reveals fields via the customize-fields cog. Unknown ids are ignored.
+ * Sections stay in declaration order; only intra-section field order follows
+ * `visibleFieldOrder`.
+ */
+export declare function resolveVisibleFields(sections: PatientFieldSection[], visibleFieldOrder?: string[]): ResolvedPatientSection[];
+//# sourceMappingURL=patient-fields.d.ts.map

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

@@ -0,0 +1,9 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { StructuredAddress } from '../address-autocomplete';
+export interface AddressFieldsHandle {
+    getValue: () => StructuredAddress;
+    setValue: (value: StructuredAddress) => void;
+    setField: (field: keyof StructuredAddress, value: string) => void;
+}
+export declare const addressFieldsAgent: AgentAdapter<AddressFieldsHandle>;
+//# sourceMappingURL=address-fields.agent.d.ts.map

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

@@ -0,0 +1,29 @@
+import { type CityLoaderContext } from '../city-input/city-input';
+import { type GetSuggestions, type StructuredAddress } from '../address-autocomplete';
+import type { OptionShape } from '../_shared/option';
+export type AddressFieldKey = 'street' | 'city' | 'postcode' | 'province';
+export interface AddressFieldsProps {
+    /** The controlled address value. */
+    value?: StructuredAddress;
+    /** Fires with the next full address on any field change. */
+    onChange?: (next: StructuredAddress) => void;
+    /**
+     * Which address-line fields to render, in order. The country picker
+     * always renders first. Default resolves from the selected country.
+     */
+    fields?: AddressFieldKey[];
+    /** Async city suggestion loader, forwarded to CityInput. */
+    loadCities?: (query: string, ctx: CityLoaderContext) => Promise<OptionShape[]>;
+    /** Float these countries to the top of the country picker. */
+    popularCountries?: string[];
+    /** Enable the "find address" bar — provide a Places API key… */
+    apiKey?: string;
+    /** …or a mock/real suggestion injector (wins over apiKey, like AddressAutocomplete). */
+    getSuggestions?: GetSuggestions;
+    layout?: 'stacked' | 'grid';
+    disabled?: boolean;
+    id?: string;
+    className?: string;
+}
+export declare const AddressFields: import("react").ForwardRefExoticComponent<AddressFieldsProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=address-fields.d.ts.map

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

@@ -0,0 +1,5 @@
+export { AddressFields } from './address-fields';
+export type { AddressFieldsProps, AddressFieldKey } from './address-fields';
+export { addressFieldsAgent } from './address-fields.agent';
+export type { AddressFieldsHandle } from './address-fields.agent';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,6 @@
+import { A as e, a } from "../../_chunks/address-fields-CPbFJ8e8.js";
+export {
+  e as AddressFields,
+  a as addressFieldsAgent
+};
+//# sourceMappingURL=index.js.map

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

@@ -1,4 +1,4 @@
-import { A as e } from "../../_chunks/agenda-card-BxSFkqgY.js";
+import { A as e } from "../../_chunks/agenda-card-BQ-IKAru.js";
 import { a as d } from "../../_chunks/agenda-card.agent-mTCrkKSZ.js";
 import { i as g } from "../../_chunks/is-safe-url-DkETxeHz.js";
 export {

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

@@ -1,4 +1,4 @@
-import { A as r, a as g } from "../../_chunks/agenda-tray-g0kg7HwB.js";
+import { A as r, a as g } from "../../_chunks/agenda-tray-CGXRk58j.js";
 export {
   r as AgendaTray,
   g as agendaTrayAgent

package/dist/components/ai-consent-banner/index.js

@@ -1,4 +1,4 @@
-import { A as e, a as o } from "../../_chunks/ai-consent-banner-CXlsNX1c.js";
+import { A as e, a as o } from "../../_chunks/ai-consent-banner-Be-h9mRI.js";
 export {
   e as AiConsentBanner,
   o as aiConsentBannerAgent

package/dist/components/ai-prompt-input/index.js

@@ -1,4 +1,4 @@
-import { A as a, a as o } from "../../_chunks/ai-prompt-input-CuhTo9mh.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input-V4DdOeqv.js";
 export {
   a as AIPromptInput,
   o as aiPromptInputAgent

package/dist/components/alert/alert.d.ts

@@ -13,6 +13,11 @@ export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'>
     onOpenChange?: (open: boolean) => void;
     icon?: ReactNode;
     live?: 'assertive' | 'polite' | 'off';
+    /** Compact mode: clamps `Alert.Title` to 2 lines (with a tooltip when the
+     *  title is truncated) and `Alert.Description` to 2 lines (with a "Read more"
+     *  toggle). Opt-in — leave off for standalone alerts whose full message must
+     *  always be visible. */
+    clamp?: boolean;
 }
 export type { AlertTitleProps };
 export declare const Alert: import("react").ForwardRefExoticComponent<AlertProps & import("react").RefAttributes<HTMLDivElement>> & {

package/dist/components/alert/index.js

@@ -1,4 +1,4 @@
-import { A as o } from "../../_chunks/alert-_mUKLmwA.js";
+import { A as o } from "../../_chunks/alert-CHYZ96tR.js";
 export {
   o as Alert
 };

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

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

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

@@ -0,0 +1,15 @@
+export declare const FACE_FRONT_VIEWBOX = "0 0 200 240";
+export declare const FACE_FRONT_SIL = "M100.0 24.0 C104.8 24.0 109.9 23.9 114.4 24.2 C118.9 24.5 122.7 25.0 126.9 25.9 C131.0 26.9 135.6 28.1 139.1 29.9 C142.6 31.7 145.4 33.9 147.8 36.5 C150.3 39.1 152.4 42.4 154.0 45.5 C155.6 48.7 156.7 51.8 157.6 55.7 C158.4 59.6 158.9 64.6 159.0 68.9 C159.1 73.3 158.7 77.5 158.4 81.8 C158.1 86.2 158.0 90.4 157.5 94.9 C157.0 99.5 156.4 104.2 155.4 109.0 C154.4 113.7 152.9 119.2 151.2 123.4 C149.5 127.7 147.3 131.3 145.3 134.4 C143.2 137.4 141.1 139.4 138.7 141.7 C136.4 143.9 133.4 146.1 131.0 147.9 C128.6 149.6 126.7 150.7 124.5 152.0 C122.2 153.2 120.0 154.4 117.6 155.3 C115.2 156.3 112.8 157.2 109.9 157.8 C106.9 158.3 103.3 158.6 100.0 158.6 C96.7 158.6 93.1 158.3 90.1 157.8 C87.2 157.2 84.8 156.3 82.4 155.3 C80.0 154.4 77.8 153.2 75.5 152.0 C73.3 150.7 71.4 149.6 69.0 147.9 C66.6 146.1 63.6 143.9 61.3 141.7 C58.9 139.4 56.8 137.4 54.7 134.4 C52.7 131.3 50.5 127.7 48.8 123.4 C47.1 119.2 45.6 113.7 44.6 109.0 C43.6 104.2 43.0 99.5 42.5 94.9 C42.0 90.4 41.9 86.2 41.6 81.8 C41.3 77.5 40.9 73.3 41.0 68.9 C41.1 64.6 41.6 59.6 42.4 55.7 C43.3 51.8 44.4 48.7 46.0 45.5 C47.6 42.4 49.7 39.1 52.2 36.5 C54.6 33.9 57.4 31.7 60.9 29.9 C64.4 28.1 69.0 26.9 73.1 25.9 C77.3 25.0 81.1 24.5 85.6 24.2 C90.1 23.9 95.2 24.0 100.0 24.0 Z";
+export declare const FACE_FRONT_INK = "M60.0 57.4 C61.4 57.3 63.1 55.0 65.0 54.2 C67.0 53.4 69.1 52.9 71.5 52.6 C74.0 52.3 76.7 52.0 79.8 52.5 C83.0 52.9 89.1 56.0 90.7 55.4 C92.3 54.8 91.3 50.0 89.4 48.8 C87.4 47.5 82.3 48.2 79.0 48.1 C75.7 48.0 72.5 47.6 69.6 48.0 C66.8 48.4 64.2 49.3 62.0 50.4 C59.8 51.4 56.7 53.4 56.4 54.5 C56.1 55.7 58.5 57.4 60.0 57.4 Z M140.0 57.4 C138.6 57.3 136.9 55.0 135.0 54.2 C133.0 53.4 130.9 52.9 128.5 52.6 C126.0 52.3 123.3 52.0 120.2 52.5 C117.0 52.9 110.9 56.0 109.3 55.4 C107.7 54.8 108.7 50.0 110.6 48.8 C112.6 47.5 117.7 48.2 121.0 48.1 C124.3 48.0 127.5 47.6 130.4 48.0 C133.2 48.4 135.8 49.3 138.0 50.4 C140.2 51.4 143.3 53.4 143.6 54.5 C143.9 55.7 141.5 57.4 140.0 57.4 Z M73.5 66.8 a2.4 2.4 0 1 0 4.8 0 a2.4 2.4 0 1 0 -4.8 0 M121.7 66.8 a2.4 2.4 0 1 0 4.8 0 a2.4 2.4 0 1 0 -4.8 0 M81.3 120.0 C81.4 120.7 82.5 121.4 83.3 122.0 C84.1 122.6 84.9 123.1 86.0 123.7 C87.1 124.4 88.5 125.3 89.9 125.9 C91.3 126.5 93.0 126.9 94.7 127.3 C96.4 127.6 98.2 127.8 100.0 127.8 C101.8 127.8 103.6 127.6 105.3 127.3 C107.0 126.9 108.7 126.5 110.1 125.9 C111.5 125.3 112.9 124.4 114.0 123.7 C115.1 123.1 115.9 122.6 116.7 122.0 C117.5 121.4 118.6 120.7 118.7 120.0 C118.8 119.3 118.1 118.5 117.4 117.8 C116.7 117.1 115.7 116.6 114.6 115.9 C113.5 115.2 112.4 114.2 110.9 113.6 C109.4 113.0 107.2 112.4 105.4 112.3 C103.6 112.2 101.8 112.9 100.0 112.9 C98.2 112.9 96.4 112.2 94.6 112.3 C92.8 112.4 90.6 113.0 89.1 113.6 C87.6 114.2 86.5 115.2 85.4 115.9 C84.3 116.6 83.3 117.1 82.6 117.8 C81.9 118.5 81.2 119.3 81.3 120.0 Z M83.6 119.5 C83.6 119.9 85.3 120.3 86.1 120.5 C86.9 120.7 87.4 120.6 88.3 120.7 C89.2 120.7 90.4 120.8 91.6 120.9 C92.8 121.0 94.2 121.3 95.6 121.4 C97.0 121.5 98.5 121.6 100.0 121.6 C101.5 121.6 103.0 121.5 104.4 121.4 C105.8 121.3 107.2 121.0 108.4 120.9 C109.6 120.8 110.8 120.7 111.7 120.7 C112.6 120.6 113.1 120.7 113.9 120.5 C114.7 120.3 116.4 119.9 116.4 119.5 C116.4 119.2 114.9 118.5 114.1 118.2 C113.2 117.9 112.2 117.8 111.2 117.7 C110.2 117.6 109.0 117.4 107.8 117.4 C106.6 117.3 105.4 117.4 104.1 117.4 C102.8 117.4 101.4 117.4 100.0 117.4 C98.6 117.4 97.2 117.4 95.9 117.4 C94.6 117.4 93.4 117.3 92.2 117.4 C91.0 117.4 89.8 117.6 88.8 117.7 C87.8 117.8 86.8 117.9 85.9 118.2 C85.1 118.5 83.6 119.2 83.6 119.5 Z";
+export declare const FACE_FRONT_DETAIL = "M66.1 66.7 C66.4 66.8 67.0 67.1 67.6 67.3 C68.1 67.5 68.6 67.8 69.4 68.0 C70.1 68.3 71.0 68.7 72.0 69.0 C73.1 69.2 74.6 69.4 75.8 69.5 C77.0 69.5 78.1 69.4 79.2 69.3 C80.4 69.2 81.6 68.9 82.6 68.7 C83.5 68.4 84.2 68.2 84.8 67.9 C85.3 67.7 85.9 67.6 85.9 67.3 C85.9 66.9 85.3 66.4 84.8 66.0 C84.2 65.7 83.5 65.2 82.6 65.0 C81.6 64.7 80.4 64.5 79.2 64.4 C78.1 64.3 77.0 64.3 75.8 64.4 C74.6 64.4 73.1 64.5 72.0 64.6 C71.0 64.8 70.1 65.0 69.4 65.2 C68.6 65.4 67.9 65.7 67.6 65.8 M114.1 67.3 C114.3 67.4 114.7 67.7 115.2 67.9 C115.8 68.2 116.5 68.4 117.4 68.7 C118.4 68.9 119.6 69.2 120.8 69.3 C121.9 69.4 123.0 69.5 124.2 69.5 C125.4 69.4 126.9 69.2 128.0 69.0 C129.0 68.7 129.9 68.3 130.6 68.0 C131.4 67.8 131.9 67.5 132.4 67.3 C133.0 67.1 133.9 66.9 133.9 66.7 C133.9 66.4 133.0 66.1 132.4 65.8 C131.9 65.6 131.4 65.4 130.6 65.2 C129.9 65.0 129.0 64.8 128.0 64.6 C126.9 64.5 125.4 64.4 124.2 64.4 C123.0 64.3 121.9 64.3 120.8 64.4 C119.6 64.5 118.4 64.7 117.4 65.0 C116.5 65.2 115.6 65.9 115.2 66.0 M100.0 62.0 C100.0 63.0 100.0 66.1 100.0 68.1 C100.0 70.1 100.0 72.0 100.0 73.8 C100.0 75.6 100.0 77.1 100.0 78.9 C100.0 80.6 100.0 82.2 100.0 84.2 C100.0 86.1 100.0 88.6 100.0 90.5 C100.0 92.4 100.0 94.7 100.0 95.5 M89.3 98.0 C87.3 101.0 88.3 103.0 97.0 102.9 C100.0 104.4 100.0 104.4 103.0 102.9 C111.7 103.0 112.7 101.0 110.7 98.0 M41.6 74.8 C33.2 74.8 32.5 89.8 38.8 90.8 C40.9 90.8 41.6 87.8 41.6 86.8 M158.4 74.8 C166.8 74.8 167.5 89.8 161.2 90.8 C159.1 90.8 158.4 87.8 158.4 86.8";
+export interface FaceZone {
+    id: string;
+    labelKey: string;
+    side: 'left' | 'right' | 'midline';
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+}
+export declare const FACE_FRONT_ZONES: FaceZone[];
+//# sourceMappingURL=anatomy-face-paths.d.ts.map

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

@@ -0,0 +1,20 @@
+export interface MuscleArt {
+    id: string;
+    labelKey: string;
+    side: 'left' | 'right' | 'midline';
+    cx: number;
+    cy: number;
+    /** Set on the female pectoralis (breast cut out via evenodd). */
+    fillRule?: 'evenodd';
+    d: string;
+}
+export interface MuscleFigureArt {
+    viewBox: string;
+    silhouette: string;
+    muscles: MuscleArt[];
+}
+export declare const MUSCLE_MALE_FRONT: MuscleFigureArt;
+export declare const MUSCLE_MALE_BACK: MuscleFigureArt;
+export declare const MUSCLE_FEMALE_FRONT: MuscleFigureArt;
+export declare const MUSCLE_FEMALE_BACK: MuscleFigureArt;
+//# sourceMappingURL=anatomy-muscle-paths.d.ts.map

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-CXSk11UJ.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/app-frame/app-frame.d.ts

@@ -1,9 +1,9 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
-declare const mainVariants: (props?: ({
+declare const mainContentVariants: (props?: ({
     padded?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface AppFrameProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof mainVariants> {
+export interface AppFrameProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof mainContentVariants> {
     /** `<Header>` instance rendered full-width at the block-start of the shell. */
     header: ReactNode;
     /** `<Sidebar>` instance rendered inline-start of the row beneath the header on ≥ md viewports. */

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

@@ -1,4 +1,4 @@
-import { A as a } from "../../_chunks/app-frame-BYx1gcV7.js";
+import { A as a } from "../../_chunks/app-frame-DIEMIC5V.js";
 export {
   a as AppFrame
 };

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-DVaeJNVB.js";
+import { A as e, a as o, b as r } from "../../_chunks/appointment-tray-B16QPGbm.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