@alfadocs/ui-kit 0.69.0 → 0.70.0

package/dist/agent-i18n/en.json

@@ -51,6 +51,21 @@
         "focus": "Move keyboard focus into the textarea."
       }
     },
+    "anatomyScheme": {
+      "state": {
+        "chart": "Current anatomy chart — findings keyed by region id. Notes are PHI and omitted from this snapshot; read them per-region via get_region.",
+        "activeView": "Id of the currently displayed anatomy view."
+      },
+      "actions": {
+        "focusRegion": "Move focus to a specific region in the active view.",
+        "getRegion": "Read the findings (incl. notes) recorded on one region.",
+        "regionsWith": "List the region ids carrying a given finding type.",
+        "setFinding": "Record a finding (observation / lesion / pain / treatment / note) on a region.",
+        "removeFinding": "Remove a single finding type from a region.",
+        "clearRegion": "Clear every finding from a region.",
+        "setView": "Switch the active anatomy view."
+      }
+    },
     "appointmentTray": {
       "state": {
         "items": "Currently-displayed appointments. Ids + lifecycle state only — never patient identity."
@@ -59,6 +74,15 @@
         "selectItem": "Activate the appointment with the given id."
       }
     },
+    "appointmentTimeline": {
+      "state": {
+        "items": "Currently-rendered appointments. Ids + lifecycle state only — never patient identity."
+      },
+      "actions": {
+        "selectItem": "Activate the appointment with the given id.",
+        "jumpToToday": "Re-anchor the timeline scroll on today's appointments."
+      }
+    },
     "audioRecorder": {
       "state": {
         "isRecording": "True while actively capturing audio (not paused).",
@@ -154,6 +178,12 @@
         "phaseProgress": "Phase progress as executed / total counts. Counts only — never phase labels or operator identity."
       }
     },
+    "carePlanHeader": {
+      "state": {
+        "state": "The plan lifecycle state. Enum value only — never the localised label or any PHI.",
+        "alertCount": "How many attention alerts (e.g. missing signature) are showing. Count only — never the alert labels."
+      }
+    },
     "carousel": {
       "state": {
         "activeIndex": "Zero-based index of the currently snapped slide.",
@@ -520,6 +550,17 @@
         "toggleVisibility": "Toggle between masked and plain-text display."
       }
     },
+    "patientDetails": {
+      "state": {
+        "visibleFieldOrder": "Ordered list of visible field KEYS (e.g. \"fiscalCode\"). Never a field value.",
+        "patientId": "Opaque patient id the panel is bound to. No patient-identifiable data."
+      },
+      "actions": {
+        "setVisibleFields": "Set which fields are visible (and their order). Unknown ids are ignored.",
+        "setFieldOrder": "Reorder the visible fields. Order within a section is honoured; sections stay fixed.",
+        "updateField": "Write a patient field value via the consumer's audited save path. Subject to the same permissions and validation as a human edit."
+      }
+    },
     "patientSearch": {
       "state": {
         "variant": "Active variant — one of `who-where`, `who-where-when`, `faceted`, `discovery`."
@@ -650,6 +691,15 @@
         "setValue": "Select the radio with the given value."
       }
     },
+    "radiographPanel": {
+      "state": {
+        "radiographs": "Structural references (id + kind) to the films shown for the selected tooth."
+      },
+      "actions": {
+        "viewRadiograph": "Open a film in the fullscreen viewer by id.",
+        "closeViewer": "Close the fullscreen radiograph viewer."
+      }
+    },
     "recaptchaWidget": {
       "state": {
         "hasToken": "True when the widget currently holds a valid verification token."
@@ -891,14 +941,18 @@
     },
     "toothScheme": {
       "state": {
-        "chart": "Current dental chart — findings (and marked surfaces) keyed by FDI id.",
-        "chartedTeeth": "FDI ids of every tooth carrying at least one finding."
+        "chart": "Current dental chart — findings (and marked surfaces) keyed by FDI id, or by a special-element id (quadrant / sextant / arch / general) for region-spanning findings.",
+        "chartedTeeth": "Ids carrying at least one finding — FDI tooth ids and/or special-element ids (quadrant / sextant / arch / general).",
+        "radiographs": "Structural references (id + kind) to the radiographs on each tooth, keyed by FDI id. Notes, dates and image URLs are not exposed here — fetch them on demand via get_radiographs.",
+        "teethWithRadiographs": "FDI ids of every tooth carrying at least one radiograph."
       },
       "actions": {
         "focusTooth": "Move focus to a specific tooth by FDI id.",
         "getTooth": "Read the findings recorded on one tooth (FDI id).",
-        "teethWith": "List the FDI ids of every tooth carrying a given finding (e.g. all teeth with caries).",
-        "setFinding": "Record a finding on a tooth (crown, implant, root canal, caries, …). Optionally mark the affected surfaces for a surface finding.",
+        "teethWith": "List the ids carrying a given finding — FDI tooth ids and/or special-element ids (e.g. all teeth with caries).",
+        "getRadiographs": "Read the radiographs (x-rays) attached to one tooth.",
+        "openRadiographs": "Focus a tooth and open its radiograph archive (fires the host's onOpenRadiographs).",
+        "setFinding": "Record a finding on a tooth or region element (crown, implant, root canal, caries, …). Optionally mark the affected surfaces for a surface finding.",
         "removeFinding": "Remove a single finding from a tooth.",
         "clearTooth": "Clear every finding from a tooth."
       }
@@ -976,7 +1030,7 @@
     "carePlans": {
       "workflows": {
         "selectPlans": "Select one or more plan or care rows in the register for a bulk action.",
-        "filterByPeriod": "Choose a period preset (e.g. this month, this year) and filter the register to it.",
+        "filterByPeriod": "Filter the register to a created/scheduled date range via the per-column date filters.",
         "createPlan": "Open the \"New plan\" action from the page header and persist a new treatment plan for the patient.",
         "createAppointmentForCare": "From a planned care row action, schedule an appointment for that treatment.",
         "generateInvoice": "Bill a completed treatment: create the doctor bill / invoice the selected care sits on.",
@@ -1028,6 +1082,18 @@
         "exportCsv": "Trigger the CSV export of the current filtered set."
       }
     },
+    "invoices": {
+      "workflows": {
+        "filterInvoices": "Narrow the ledger by number, relation, status, date range or amount using the per-column filters.",
+        "sortLedger": "Re-sort the ledger by any column (e.g. issue date, total, balance).",
+        "paginate": "Move to another page of the ledger.",
+        "exportLedger": "Export the current (optionally filtered) ledger from the page-header table-tools cluster — CSV / Excel / PDF.",
+        "viewInvoice": "Open a single invoice from its row action to inspect line items and payment history.",
+        "downloadPdf": "Download the selected invoice as a PDF from its row action.",
+        "sendReminder": "Send a payment reminder for the selected invoice through its eligible channel (email or SMS).",
+        "deleteInvoice": "Delete the selected invoice from its row action. Paid invoices cannot be deleted. Irreversible."
+      }
+    },
     "marketplaceAppShell": {
       "workflows": {
         "navigate": "Navigate to one of the app sections via the sidebar nav (or the embedded tab strip). Routing is consumer-owned, so the destination resolves through the host router.",
@@ -1090,7 +1156,7 @@
         "sendReminders": "Send an appointment or balance reminder to the selected patients through their eligible channel (email or SMS).",
         "tagPatients": "Add a tag to every selected patient.",
         "deletePatients": "Delete the selected patients. Archived patients cannot be deleted. Irreversible.",
-        "applyView": "Choose a saved view from the switcher to apply its filter and sort (and saved column layout) to the roster."
+        "exportRoster": "Export the current (optionally filtered) patient roster from the page-header table-tools cluster — CSV / Excel / PDF."
       }
     },
     "practiceProfileHero": {
@@ -1127,6 +1193,18 @@
         "dismissAlert": "Dismiss an item from the top-of-page alerts strip. Persists the dismissal so it stays hidden."
       }
     },
+    "services": {
+      "workflows": {
+        "filterServices": "Narrow the catalogue by name, code, category, VAT rate or active status using the per-column filters.",
+        "sortCatalogue": "Re-sort the catalogue by any column (e.g. price, duration, active).",
+        "compactActions": "Toggle the ColumnToggle settings-footer switch to compact the per-row action column.",
+        "toggleActive": "Flip a service’s availability via its per-row Active toggle so it is offered (or withdrawn) on new plans.",
+        "exportCatalogue": "Export the current (optionally filtered) catalogue from the page-header table-tools cluster — CSV / Excel / PDF.",
+        "editService": "Edit the selected service (e.g. price, duration, VAT) from its row action.",
+        "duplicateService": "Duplicate the selected service into a new editable copy from its row action.",
+        "deleteService": "Delete the selected service from its row action. A service in use on a plan cannot be deleted. Irreversible."
+      }
+    },
     "settings": {
       "workflows": {
         "switchSection": "Switch the active settings section (Profile / Notifications / Billing / Security) via the vertical tab strip.",
@@ -1155,6 +1233,18 @@
         "completeEnvelope": "Finalise the envelope once every required field carries a signature, persisting the completed document."
       }
     },
+    "tasks": {
+      "workflows": {
+        "filterTasks": "Narrow the roster by title, type, assignee, due range or status using the per-column filters.",
+        "filterFromNotice": "Apply a WarningStack notice’s \"View\" action (e.g. \"View overdue\", \"View collections\") to narrow the roster to the flagged tasks.",
+        "sortRoster": "Re-sort the roster by any column (e.g. soonest due first, created date).",
+        "toggleDone": "Mark a task as done (or reopen it) via its per-row done toggle.",
+        "compactActions": "Toggle the ColumnToggle settings-footer switch to compact the per-row action column.",
+        "exportRoster": "Export the current (optionally filtered) roster from the page-header table-tools cluster — CSV / Excel / PDF.",
+        "editTask": "Edit the selected task from its row action.",
+        "deleteTask": "Delete the selected task from its row action. Completed tasks cannot be deleted. Irreversible."
+      }
+    },
     "twoFactorLogin": {
       "workflows": {
         "enterCode": "Type the 6-digit verification code into the OTP field.",
@@ -1170,6 +1260,18 @@
         "configurePackage": "In the basket, set the quantity or tier for a tiered/quantity package and read back the chosen value; the monthly-price-increase summary recomputes.",
         "confirmUpgrade": "Confirm the upgrade — add the configured package to the practice subscription and bill the prorated partial period. Persists a billing change."
       }
+    },
+    "warehouse": {
+      "workflows": {
+        "filterInventory": "Narrow the inventory by product, SKU, category, supplier or stock status using the per-column filters.",
+        "sortInventory": "Re-sort the inventory by any column (e.g. in-stock, total value, last restocked).",
+        "compactActions": "Toggle the ColumnToggle settings-footer switch to compact the per-row action column.",
+        "exportInventory": "Export the current (optionally filtered) inventory from the page-header table-tools cluster — CSV / Excel / PDF.",
+        "stockIn": "Record incoming stock for the selected item from its row action.",
+        "stockOut": "Record outgoing stock for the selected item from its row action.",
+        "editItem": "Edit the selected inventory item (e.g. min-stock threshold, supplier) from its row action.",
+        "importFatturapa": "Open the FatturaPA XML import dialog, upload supplier e-invoice XML files, review the classified line preview, deselect any unwanted lines, and confirm to create articles and stock movements."
+      }
     }
   }
 }

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/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-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-BA_sqy1A.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-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