@alfadocs/ui-kit 0.68.0 → 0.70.0

package/dist/components/_shared/entity-card/entity-card.d.ts

@@ -36,5 +36,11 @@ export declare const APPOINTMENT_STATE_BADGE_DEFAULT: BadgeVariant;
  */
 export declare function appointmentStateBadge(state: string): BadgeVariant;
 export declare function colorIdToToken(colorId: number | string | null | undefined): string;
+/**
+ * Avatar-fill variant of {@link colorIdToToken} — returns the same operator
+ * hue at an AA-safe darkness for swatches that carry the Avatar's light
+ * initials. Pair it with the bright -500 dot from {@link colorIdToToken}.
+ */
+export declare function colorIdToAvatarToken(colorId: number | string | null | undefined): string;
 export { isSafeEntityUrl } from '../is-safe-url';
 //# sourceMappingURL=entity-card.d.ts.map

package/dist/components/_shared/entity-card/index.d.ts

@@ -1,3 +1,3 @@
-export { entitySurfaceVariants, CARE_PLAN_STATE_BADGE, APPOINTMENT_STATE_BADGE, APPOINTMENT_STATE_BADGE_DEFAULT, appointmentStateBadge, colorIdToToken, isSafeEntityUrl, } from './entity-card';
+export { entitySurfaceVariants, CARE_PLAN_STATE_BADGE, APPOINTMENT_STATE_BADGE, APPOINTMENT_STATE_BADGE_DEFAULT, appointmentStateBadge, colorIdToToken, colorIdToAvatarToken, isSafeEntityUrl, } from './entity-card';
 export type { CarePlanState, AppointmentState } from './entity-card';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/_shared/field-value.d.ts

@@ -0,0 +1,21 @@
+import { type ReactElement, type ReactNode } from 'react';
+import type { PatientField } from './patient-fields';
+/** A neutral pill with high-contrast text + an optional leading glyph. */
+export declare function NeutralChip({ icon, mono, children, }: {
+    icon?: ReactElement;
+    mono?: boolean;
+    children: ReactNode;
+}): ReactNode;
+/** Sex chip — Venus / Mars / User glyph + localised label. Female / male carry a
+ *  tonal pink / blue FILL; unspecified stays the neutral pill. */
+export declare function SexChip({ code }: {
+    code: string;
+}): ReactNode;
+/** Age chip — hourglass glyph + localised, pluralised age. */
+export declare function AgeChip({ years }: {
+    years: number;
+}): ReactNode;
+export declare function FieldValue({ field }: {
+    field: PatientField;
+}): ReactNode;
+//# sourceMappingURL=field-value.d.ts.map

package/dist/components/_shared/field-visibility-cog.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from 'react';
+import type { PatientFieldSection } from './patient-fields';
+export interface FieldVisibilityCogProps {
+    /** The sectioned field catalogue. */
+    sections: PatientFieldSection[];
+    /** Current ordered visible field ids. */
+    visible: string[];
+    /** Show / hide a single field. */
+    onToggleField: (fieldId: string) => void;
+    /** Show / hide every field in a section. */
+    onToggleSection: (sectionId: string, show: boolean) => void;
+    /** Move a field onto another field's slot within its section. */
+    onMoveFieldOnto: (fromId: string, toId: string) => void;
+    /** Reset to the default field set / order. */
+    onReset: () => void;
+    /** Override the cog trigger's accessible name. */
+    label?: string;
+}
+export declare function FieldVisibilityCog({ sections, visible, onToggleField, onToggleSection, onMoveFieldOnto, onReset, label, }: FieldVisibilityCogProps): ReactNode;
+//# sourceMappingURL=field-visibility-cog.d.ts.map

package/dist/components/_shared/field-visibility.d.ts

@@ -0,0 +1,36 @@
+import { type PatientField, type PatientFieldSection } from './patient-fields';
+export interface UsePatientFieldVisibilityOptions {
+    /** Controlled ordered list of visible field ids. */
+    value?: string[];
+    /** Uncontrolled initial order. Omit both ⇒ every field, declaration order. */
+    defaultValue?: string[];
+    /** Fired on any show / hide / reorder, with the next ordered visible set. */
+    onChange?: (orderedIds: string[]) => void;
+}
+export interface PatientFieldVisibility {
+    /** Current ordered list of visible field ids (filtered to known fields). */
+    visible: string[];
+    /** Flat declaration-order catalogue of every field id ("show everything"). */
+    catalogueIds: string[];
+    /** field id → its field + owning section id. */
+    fieldById: Map<string, {
+        field: PatientField;
+        sectionId: string;
+    }>;
+    /** Replace the visible set / order (filtered to known fields). */
+    setOrder: (orderedIds: string[]) => void;
+    /** Show or hide a single field. */
+    toggleField: (fieldId: string) => void;
+    /** Show or hide every field in a section. */
+    toggleSection: (sectionId: string, show: boolean) => void;
+    /**
+     * Move a field to land at another field's slot, WITHIN its section's
+     * visible subsequence. Cross-section moves are ignored — sections stay in
+     * declaration order. Drives both pointer drops and keyboard (Alt+Arrow).
+     */
+    moveFieldOnto: (fromId: string, toId: string) => void;
+    /** Reset to `defaultValue` (or the full catalogue when none was given). */
+    reset: () => void;
+}
+export declare function usePatientFieldVisibility(sections: PatientFieldSection[], { value, defaultValue, onChange }?: UsePatientFieldVisibilityOptions): PatientFieldVisibility;
+//# sourceMappingURL=field-visibility.d.ts.map

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';
+/** 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/accordion/index.js

@@ -1,4 +1,4 @@
-import { A as r, a as n, b as a, c as d, d as i } from "../../_chunks/accordion-9lJSMMsZ.js";
+import { A as r, a as n, b as a, c as d, d as i } from "../../_chunks/accordion-DnIa7OHX.js";
 export {
   r as Accordion,
   n as AccordionContent,

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

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { AddressAutocompleteHandle } from './address-autocomplete';
+export declare const addressAutocompleteAgent: AgentAdapter<AddressAutocompleteHandle>;
+//# sourceMappingURL=address-autocomplete.agent.d.ts.map

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

@@ -27,6 +27,24 @@ export interface AddressSuggestion {
  * selection resolves without a real Google call.
  */
 export type GetSuggestions = (query: string) => AddressSuggestion[] | Promise<AddressSuggestion[]>;
+export interface AddressAutocompleteHandle {
+    /** Current free-text value of the input. */
+    getValue: () => string;
+    /** Current query (same as the input value) used to drive suggestions. */
+    getQuery: () => string;
+    /** True when the suggestion listbox is visible. */
+    getIsOpen: () => boolean;
+    /** Set the input text programmatically (also drives a suggestion fetch). */
+    setValue: (value: string) => void;
+    /** Set the query text — alias of `setValue`. */
+    setQuery: (query: string) => void;
+    /** Clear the typed text and dismiss the listbox. */
+    clear: () => void;
+    /** Open the suggestion listbox. */
+    open: () => void;
+    /** Close the suggestion listbox. */
+    close: () => void;
+}
 export interface AddressAutocompleteProps {
     /**
      * Google Maps JS API key. Consumer-owned; never cached by the kit. When

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

@@ -1,4 +1,5 @@
 export { AddressAutocomplete } from './address-autocomplete';
-export type { AddressAutocompleteProps, AddressSuggestion, GetSuggestions, } from './address-autocomplete';
+export type { AddressAutocompleteProps, AddressAutocompleteHandle, AddressSuggestion, GetSuggestions, } from './address-autocomplete';
+export { addressAutocompleteAgent } from './address-autocomplete.agent';
 export { parseAddressComponents, type StructuredAddress, type RawAddressComponent, } from './parse-address';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,6 +1,7 @@
-import { A as o, p } from "../../_chunks/address-autocomplete-CT-9AOli.js";
+import { A as o, a as t, p as a } from "../../_chunks/address-autocomplete-BEX9PXty.js";
 export {
   o as AddressAutocomplete,
-  p as parseAddressComponents
+  t as addressAutocompleteAgent,
+  a as parseAddressComponents
 };
 //# sourceMappingURL=index.js.map

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

@@ -1,5 +1,5 @@
-import { A as e } from "../../_chunks/agenda-card-BxSFkqgY.js";
-import { a as d } from "../../_chunks/agenda-card.agent-B_R47-c9.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 {
   e as AgendaCard,

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

@@ -1,4 +1,4 @@
-import { A as r, a as g } from "../../_chunks/agenda-tray-T-BumlGZ.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-Dxtx_WAh.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-BwEACCPm.js";
+import { A as a, a as o } from "../../_chunks/ai-prompt-input-CuhTo9mh.js";
 export {
   a as AIPromptInput,
   o as aiPromptInputAgent

package/dist/components/ai-tools-rail/ai-tools-rail.d.ts

@@ -12,10 +12,44 @@ export interface AiToolsRailTool {
     /** Panel body for this tool. Rendered inline-start of the strip when
      *  `side='end'` (mirrored for `'start'`). The consumer composes it. */
     panel: ReactNode;
+    /**
+     * Optional non-scrolling header for this tool's panel. Rendered pinned at
+     * the top of the open panel — above the scroll region — so a tool's title /
+     * filters stay visible as the body scrolls. This is the rail-level home for
+     * a sticky tool header; every tool gets it for free.
+     */
+    header?: ReactNode;
+    /**
+     * When true the panel body is NOT wrapped in the rail's `ScrollArea` — the
+     * tool fills the (height-bounded) panel and owns its own scroll/layout.
+     * Use for self-scrolling tools (e.g. `AppointmentTimeline`, whose infinite
+     * scroll + today-anchoring + edge fades require it to be the scroll
+     * container). Default `false` (the rail scrolls the body).
+     */
+    fill?: boolean;
     /** Optional unseen / notification count shown on the strip icon. */
     badgeCount?: number;
     /** When true the icon is non-interactive and skipped by roving focus. */
     disabled?: boolean;
+    /**
+     * Scope tier (drives the two-group divider). The two scope values render in
+     * array order with a divider at the boundary between them — order the array
+     * so the groups stay contiguous. A divider only appears when BOTH groups are
+     * present; omit `scope` on every tool for an ungrouped strip (legacy). The
+     * rail attaches no meaning beyond grouping — the host decides which value
+     * leads (e.g. the Control Room pins favourites first).
+     */
+    scope?: 'global' | 'contextual';
+    /**
+     * When true this icon joins the drag-and-drop / `Alt`+Arrow reorder run.
+     * The host supplies `onReorder` and owns the resulting order. Moves are
+     * confined to the contiguous run of `reorderable` tools — so if EVERY tool
+     * is `reorderable` the run is the whole strip and a tool can be dragged
+     * across the scope divider; the host's `onReorder` decides what crossing it
+     * means (e.g. the Control Room reads it as pin / unpin). Reordering never
+     * changes focus roving — focus follows the moved tool to its new slot.
+     */
+    reorderable?: boolean;
 }
 /**
  * Curated imperative handle for AiToolsRail. Exposed as the forwardRef
@@ -61,6 +95,47 @@ export interface AiToolsRailProps extends VariantProps<typeof railVariants> {
      * Enter / double-click resets to the token-driven default. Default `false`.
      */
     resizablePanel?: boolean;
+    /**
+     * Fires when the user reorders the `reorderable` run (drag-drop or
+     * `Alt`+Arrow). `from` / `to` are indices into `tools`; the host applies the
+     * move to the array it passes back. Reordering is enabled when this callback
+     * is supplied AND at least one tool is `reorderable`. When the whole strip is
+     * reorderable, `to` may land in the other scope group — the host interprets
+     * the crossing (and may treat it as a no-op, e.g. reordering within a
+     * host-ordered group).
+     */
+    onReorder?: (from: number, to: number) => void;
+    /**
+     * Optional override for the polite live-region message announced after a
+     * reorder. Lets the host phrase membership-aware moves (e.g. "Pinned X to
+     * favourites") instead of the generic "moved to position N". Return an empty
+     * string to stay silent (e.g. for a move the host treats as a no-op). When
+     * omitted, the rail announces the generic run-relative position.
+     */
+    formatReorderAnnouncement?: (args: {
+        tool: AiToolsRailTool;
+        from: number;
+        to: number;
+    }) => string;
+    /**
+     * Optional per-icon overlay control, rendered as a sibling of each strip
+     * IconButton (the same positioned box the notification badge uses). Use for
+     * a small affordance such as a pin toggle — the rail attaches no meaning to
+     * what it renders. Receives the tool and its index / active state.
+     */
+    renderToolAffordance?: (tool: AiToolsRailTool, context: {
+        index: number;
+        isActive: boolean;
+        isRovingTarget: boolean;
+    }) => ReactNode;
+    /**
+     * Optional non-scrolling header rendered at the top of the OPEN tool panel,
+     * above its scroll region. Host-owned content (e.g. a pin / unpin control) —
+     * the rail attaches no meaning. Receives the active tool.
+     */
+    renderPanelHeader?: (tool: AiToolsRailTool, context: {
+        isActive: boolean;
+    }) => ReactNode;
     className?: string;
 }
 export declare const AiToolsRail: import("react").ForwardRefExoticComponent<AiToolsRailProps & import("react").RefAttributes<AiToolsRailHandle>>;

package/dist/components/ai-tools-rail/index.js

@@ -1,4 +1,4 @@
-import { A as i, a as l } from "../../_chunks/ai-tools-rail-CInA_1-E.js";
+import { A as i, a as l } from "../../_chunks/ai-tools-rail-B5NEghsp.js";
 export {
   i as AiToolsRail,
   l as aiToolsRailAgent

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-N8pIKWuS.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