@alfadocs/ui-kit 0.70.0 → 0.72.0

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

@@ -0,0 +1,107 @@
+import type { MarkerShape, MarkerTone } from '../annotation-marker';
+/** Muscle figure variant. `child` is the adult-male map scaled down. */
+export type FigureVariant = 'adult-male' | 'adult-female' | 'child';
+export type MuscleViewId = string;
+export type MuscleSchemeMode = 'interactive' | 'display';
+export type RegionSide = '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 strain, a trigger point, …).
+ */
+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 MuscleFinding {
+    type: FindingType;
+    /** Optional free-text clinical note. PHI — never bundle real notes in stories. */
+    note?: string;
+}
+/** Findings keyed by region id. */
+export type MuscleChart = Record<string, MuscleFinding[]>;
+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 MuscleRegion {
+    /** Stable id, unique within a view — the finding key + `data-region`. */
+    id: string;
+    /** i18n key suffix under `muscleScheme.region.*`. */
+    labelKey: string;
+    shape: RegionShape;
+    /** Bilateral side, where meaningful (drives "left/right" in the label). */
+    side?: RegionSide;
+    /** Optional grouping (e.g. 'upper-limb'). */
+    group?: string;
+    /** Marker anchor; defaults to the shape centroid. */
+    marker?: {
+        x: number;
+        y: number;
+    };
+}
+export interface MuscleView {
+    id: MuscleViewId;
+    /** i18n key suffix under `muscleScheme.view.*`. */
+    labelKey: string;
+    /** Which muscle figure this view is drawn on. */
+    figure: FigureVariant;
+    viewBox: string;
+    /** Decorative head silhouette 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;
+    /** Stroke-only body contour drawn in the regions (body) group so it scales
+     * with the body `transform`, not the `silhouetteTransform` — this is what lets
+     * the child carry an enlarged head while its body stays scaled down. */
+    bodyDetail?: string;
+    /** When true, the view's regions render as transparent click hotspots (tinting
+     * only on hover / focus / finding) rather than filled shapes — implied when a
+     * realistic illustration is loaded over the figure. */
+    hotspotZones?: boolean;
+    regions: MuscleRegion[];
+}
+export declare function regionCentroid(region: MuscleRegion): {
+    x: number;
+    y: number;
+};
+export declare const MUSCLE_VIEWS: Record<MuscleViewId, MuscleView>;
+export declare function getView(id: MuscleViewId): MuscleView | undefined;
+/** All views for a figure, in front-then-back order. */
+export declare function viewsForFigure(figure: FigureVariant): MuscleView[];
+export declare function getRegion(viewId: MuscleViewId, regionId: string): MuscleRegion | undefined;
+/** Default view shown when no explicit `views` are given. */
+export declare const DEFAULT_MUSCLE_VIEW: MuscleViewId;
+/**
+ * Pick a muscle figure from patient demographics — mirrors the platform's
+ * `getDefaultFigureVariant(gender, age)`. Pure heuristic; the host can override
+ * with the explicit `figure` prop. Patients under 12 resolve to the (scaled-down)
+ * `child` figure regardless of sex; otherwise the figure follows sex.
+ */
+export declare function figureFromPatient(sex: 'm' | 'f' | 'x' | undefined, ageYears: number | undefined): FigureVariant;
+export declare function emptyChart(): MuscleChart;
+//# sourceMappingURL=muscle-scheme-data.d.ts.map

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

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

package/dist/components/{anatomy-scheme/anatomy-scheme.d.ts → muscle-scheme/muscle-scheme.d.ts}

@@ -1,26 +1,24 @@
-import { type AnatomyChart, type AnatomyFinding, type AnatomyMode, type AnatomySystem, type AnatomyViewId, type FigureVariant, type FindingType } from './anatomy-scheme-data';
-export interface AnatomySchemeProps {
+import { type MuscleChart, type MuscleFinding, type MuscleSchemeMode, type MuscleViewId, type FigureVariant, type FindingType } from './muscle-scheme-data';
+export interface MuscleSchemeProps {
     /** 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). */
+    /** Muscle figure variant. Default `'adult-male'`. */
     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).
+     * Defaults to the front + back pair for `figure`.
      */
-    views?: AnatomyViewId[];
+    views?: MuscleViewId[];
     /** `'interactive'` enables region selection + finding edits; `'display'` is read-only. */
-    mode?: AnatomyMode;
-    /** Controlled findings — `Record<regionId, AnatomyFinding[]>`. */
-    value?: AnatomyChart;
+    mode?: MuscleSchemeMode;
+    /** Controlled findings — `Record<regionId, MuscleFinding[]>`. */
+    value?: MuscleChart;
     /** Uncontrolled initial findings. */
-    defaultValue?: AnatomyChart;
+    defaultValue?: MuscleChart;
     /** Fired whenever the chart changes. */
-    onChange?: (next: AnatomyChart) => void;
+    onChange?: (next: MuscleChart) => void;
     /** Fired when a region is activated (click / Enter / Space / focus-select). */
-    onSelectRegion?: (regionId: string, viewId: AnatomyViewId) => void;
+    onSelectRegion?: (regionId: string, viewId: MuscleViewId) => void;
     /**
      * The finding type a region-click applies in interactive mode (the selected
      * tool in a finding picker). Clicking a region toggles this finding.
@@ -29,15 +27,14 @@ export interface AnatomySchemeProps {
     /** 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`).
+     * Base URL for realistic muscle illustrations, served per-view as
+     * `${illustrationBaseUrl}/${viewId}.svg` (e.g. `…/muscular-front.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`.
+     * built-in muscle art 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 live in `MUSCLE-ASSETS.md`.
      */
     illustrationBaseUrl?: string;
     /** Accessible label override for the chart region. */
@@ -45,13 +42,13 @@ export interface AnatomySchemeProps {
     /** Extra class names on the wrapper. */
     className?: string;
 }
-export interface AnatomySchemeHandle {
+export interface MuscleSchemeHandle {
     /** Programmatically focus a region by id (in the active view). */
     focusRegion: (regionId: string) => void;
     /** Read the current chart state. */
-    getChart: () => AnatomyChart;
+    getChart: () => MuscleChart;
     /** Read the findings recorded on one region (empty array if none). */
-    getRegion: (regionId: string) => AnatomyFinding[];
+    getRegion: (regionId: string) => MuscleFinding[];
     /** Read the region ids carrying a given finding type. */
     regionsWith: (type: FindingType) => string[];
     /** Add a finding to a region (no-op if already present). */
@@ -61,9 +58,9 @@ export interface AnatomySchemeHandle {
     /** Clear every finding from a region. */
     clearRegion: (regionId: string) => void;
     /** Switch the active view. */
-    setView: (viewId: AnatomyViewId) => void;
+    setView: (viewId: MuscleViewId) => void;
     /** Read the active view id. */
-    getView: () => AnatomyViewId;
+    getView: () => MuscleViewId;
 }
-export declare const AnatomyScheme: import("react").ForwardRefExoticComponent<AnatomySchemeProps & import("react").RefAttributes<AnatomySchemeHandle>>;
-//# sourceMappingURL=anatomy-scheme.d.ts.map
+export declare const MuscleScheme: import("react").ForwardRefExoticComponent<MuscleSchemeProps & import("react").RefAttributes<MuscleSchemeHandle>>;
+//# sourceMappingURL=muscle-scheme.d.ts.map

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

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

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

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

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

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

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

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

package/dist/components/navigation-menu/index.js

@@ -1,4 +1,4 @@
-import { N as i, a as t, b as e, c as o, d as g, e as s, f as u, g as v, n as M } from "../../_chunks/navigation-menu-DRUi6sSj.js";
+import { N as i, a as t, b as e, c as o, d as g, e as s, f as u, g as v, n as M } from "../../_chunks/navigation-menu-D3VndouD.js";
 import { S as r } from "../../_chunks/skip-link-BaSMtPwB.js";
 export {
   i as NavigationMenu,

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-import { N as r, u as a } from "../../_chunks/number-input-DxphVG_A.js";
+import { N as r, u as a } from "../../_chunks/number-input-DjWzmlEY.js";
 export {
   r as NumberInput,
   a as useLocaleNumber

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

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

package/dist/components/optical-prescription/index.d.ts

@@ -0,0 +1,6 @@
+export { OpticalPrescription } from './optical-prescription';
+export type { OpticalPrescriptionProps, OpticalPrescriptionHandle, } from './optical-prescription';
+export { EYES, DISTANCE_BANDS, PRISM_BASES, LENS_TYPES, AXIS_SYSTEMS, REFRACTION_COLUMNS, DIOPTRE_STEP, AXIS_STEP, AXIS_MIN, AXIS_MAX, SPHERE_MIN, SPHERE_MAX, CYLINDER_MIN, CYLINDER_MAX, ADD_MIN, ADD_MAX, PD_MIN, PD_MAX, PRISM_MIN, PRISM_MAX, formatSigned, formatSphere, formatCylinder, formatAdd, formatAxis, formatPrism, formatRefraction, emptyValue, getRow, setCell, clearBand, bandsInValue, } from './optical-prescription-data';
+export type { Eye, DistanceBand, PrismBase, LensType, AxisSystem, OpticalPrescriptionMode, RefractionRow, OpticalPrescriptionValue, } from './optical-prescription-data';
+export { opticalPrescriptionAgent } from './optical-prescription.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/optical-prescription/index.js

@@ -0,0 +1,38 @@
+import { A as S, a as A, b as r, c as I, d as _, e as t, C as E, f as e, D as M, g as o, E as P, L as N, O as R, P as i, h as D, i as m, j as f, k as n, R as X, S as l, l as p, m as C, n as c, o as d, p as T, q as L, r as O, s as Y, t as g, u, v as x, w as y, x as B, y as b } from "../../_chunks/optical-prescription-Bmlbuopi.js";
+export {
+  S as ADD_MAX,
+  A as ADD_MIN,
+  r as AXIS_MAX,
+  I as AXIS_MIN,
+  _ as AXIS_STEP,
+  t as AXIS_SYSTEMS,
+  E as CYLINDER_MAX,
+  e as CYLINDER_MIN,
+  M as DIOPTRE_STEP,
+  o as DISTANCE_BANDS,
+  P as EYES,
+  N as LENS_TYPES,
+  R as OpticalPrescription,
+  i as PD_MAX,
+  D as PD_MIN,
+  m as PRISM_BASES,
+  f as PRISM_MAX,
+  n as PRISM_MIN,
+  X as REFRACTION_COLUMNS,
+  l as SPHERE_MAX,
+  p as SPHERE_MIN,
+  C as bandsInValue,
+  c as clearBand,
+  d as emptyValue,
+  T as formatAdd,
+  L as formatAxis,
+  O as formatCylinder,
+  Y as formatPrism,
+  g as formatRefraction,
+  u as formatSigned,
+  x as formatSphere,
+  y as getRow,
+  B as opticalPrescriptionAgent,
+  b as setCell
+};
+//# sourceMappingURL=index.js.map

package/dist/components/optical-prescription/optical-prescription-data.d.ts

@@ -0,0 +1,106 @@
+/** International Latin eye abbreviations — `od` = right eye, `os` = left eye. */
+export type Eye = 'od' | 'os';
+/** Distance band — `far` (per lontano), `intermediate`, `near` (per vicino). */
+export type DistanceBand = 'far' | 'intermediate' | 'near';
+/** Prism base direction. */
+export type PrismBase = 'up' | 'down' | 'in' | 'out';
+/** Lens construction. */
+export type LensType = 'single-vision' | 'bifocal' | 'progressive';
+/** Axis notation system — TABO (European) or INT (international). */
+export type AxisSystem = 'tabo' | 'int';
+/** `'interactive'` renders editable inputs; `'display'` is a read-only grid. */
+export type OpticalPrescriptionMode = 'interactive' | 'display';
+/** One eye's refraction at one distance band. All fields optional. */
+export interface RefractionRow {
+    /** Spherical power, dioptres (±, 0.25 steps). */
+    sphere?: number;
+    /** Cylindrical power, dioptres (±, 0.25 steps). */
+    cylinder?: number;
+    /** Cylinder axis, 0–180°. */
+    axis?: number;
+    /** Reading addition, dioptres (+, 0.25 steps). */
+    add?: number;
+    /** Prismatic power, prism dioptres. */
+    prism?: number;
+    /** Prism base direction. */
+    base?: PrismBase;
+}
+/** A full glasses prescription. */
+export interface OpticalPrescriptionValue {
+    /** Refraction rows, keyed by band then eye. */
+    bands: Partial<Record<DistanceBand, Partial<Record<Eye, RefractionRow>>>>;
+    /** Interpupillary distance (DIP / PD), millimetres. */
+    pd?: number;
+    /** Lens construction. */
+    lensType?: LensType;
+    /** Axis notation system. */
+    axisSystem?: AxisSystem;
+    /** Free-text clinical note. PHI — never bundle real notes in stories. */
+    notes?: string;
+}
+export declare const EYES: readonly Eye[];
+export declare const DISTANCE_BANDS: readonly DistanceBand[];
+export declare const PRISM_BASES: readonly PrismBase[];
+export declare const LENS_TYPES: readonly LensType[];
+export declare const AXIS_SYSTEMS: readonly AxisSystem[];
+/** The dioptric columns, in display order. `base` pairs with `prism`. */
+export declare const REFRACTION_COLUMNS: readonly (keyof RefractionRow)[];
+/** Dioptric step for sphere / cylinder / add. */
+export declare const DIOPTRE_STEP = 0.25;
+/** Sphere range, dioptres. */
+export declare const SPHERE_MIN = -30;
+export declare const SPHERE_MAX = 30;
+/** Cylinder range, dioptres. */
+export declare const CYLINDER_MIN = -12;
+export declare const CYLINDER_MAX = 12;
+/** Reading addition range, dioptres. */
+export declare const ADD_MIN = 0;
+export declare const ADD_MAX = 6;
+/** Axis range, degrees. */
+export declare const AXIS_MIN = 0;
+export declare const AXIS_MAX = 180;
+export declare const AXIS_STEP = 1;
+/** Interpupillary distance range, millimetres. */
+export declare const PD_MIN = 40;
+export declare const PD_MAX = 85;
+/** Prism range, prism dioptres. */
+export declare const PRISM_MIN = 0;
+export declare const PRISM_MAX = 20;
+/**
+ * Format a number with an explicit leading sign — `+1.50`, `-2.25`. Zero is
+ * rendered unsigned (`0.00`). Used for sphere and cylinder, where optometry
+ * convention always shows the sign.
+ */
+export declare function formatSigned(value: number, fractionDigits?: number): string;
+/** Sphere power, explicit sign, 2 dp (`+2.00` / `-1.25`). */
+export declare function formatSphere(value: number): string;
+/** Cylinder power, explicit sign, 2 dp. */
+export declare function formatCylinder(value: number): string;
+/** Reading addition — always positive, 2 dp (`+2.00`). */
+export declare function formatAdd(value: number): string;
+/** Axis, integer degrees with the degree symbol (`90°`). */
+export declare function formatAxis(value: number): string;
+/** Prism, 2 dp (`2.00`). */
+export declare function formatPrism(value: number): string;
+/**
+ * Format the numeric value of one refraction column for the read-only grid.
+ * `base` is a string enum the component resolves through i18n separately, so it
+ * never reaches this numeric formatter; any unhandled field falls through the
+ * default branch and is coerced with `String(value)`.
+ */
+export declare function formatRefraction(field: keyof RefractionRow, value: number): string;
+/** An empty prescription. */
+export declare function emptyValue(): OpticalPrescriptionValue;
+/** Read one eye's row at one band (undefined when absent). */
+export declare function getRow(value: OpticalPrescriptionValue, band: DistanceBand, eye: Eye): RefractionRow | undefined;
+/**
+ * Immutably set (or clear) a single cell. Passing `undefined` / `null` removes
+ * the field; emptying a row removes the row, and emptying a band removes the
+ * band — so `bandsInValue` and the agent state snapshot stay tight.
+ */
+export declare function setCell<K extends keyof RefractionRow>(value: OpticalPrescriptionValue, band: DistanceBand, eye: Eye, field: K, fieldValue: RefractionRow[K] | undefined): OpticalPrescriptionValue;
+/** Immutably remove every row in a band. */
+export declare function clearBand(value: OpticalPrescriptionValue, band: DistanceBand): OpticalPrescriptionValue;
+/** The distance bands carrying at least one refraction value, in order. */
+export declare function bandsInValue(value: OpticalPrescriptionValue): DistanceBand[];
+//# sourceMappingURL=optical-prescription-data.d.ts.map

package/dist/components/optical-prescription/optical-prescription.agent.d.ts

@@ -0,0 +1,6 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { OpticalPrescriptionHandle } from './optical-prescription';
+import type { DistanceBand, Eye, OpticalPrescriptionValue, PrismBase, RefractionRow } from './optical-prescription-data';
+export declare const opticalPrescriptionAgent: AgentAdapter<OpticalPrescriptionHandle>;
+export type { DistanceBand, Eye, OpticalPrescriptionValue, PrismBase, RefractionRow, };
+//# sourceMappingURL=optical-prescription.agent.d.ts.map

package/dist/components/optical-prescription/optical-prescription.d.ts

@@ -0,0 +1,43 @@
+import { type DistanceBand, type Eye, type OpticalPrescriptionMode, type OpticalPrescriptionValue, type PrismBase, type RefractionRow } from './optical-prescription-data';
+export interface OpticalPrescriptionProps {
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
+    /** `'interactive'` enables editing; `'display'` is a read-only grid. Default `'interactive'`. */
+    mode?: OpticalPrescriptionMode;
+    /** Controlled prescription value. */
+    value?: OpticalPrescriptionValue;
+    /** Uncontrolled initial value. */
+    defaultValue?: OpticalPrescriptionValue;
+    /** Fired whenever the prescription changes. */
+    onChange?: (next: OpticalPrescriptionValue) => void;
+    /** Distance bands to render, in order. Default `['far', 'near']`. */
+    bands?: DistanceBand[];
+    /** Render the prism + base columns. Default `false`. */
+    showPrism?: boolean;
+    /** Render the metadata strip (PD, lens type, axis system, note). Default `true`. */
+    metadata?: boolean;
+    /** Vertical rhythm. Default `'comfortable'`. */
+    density?: 'comfortable' | 'compact';
+    /** Accessible label override for the prescription region. */
+    ariaLabel?: string;
+    /** Extra class names on the wrapper. */
+    className?: string;
+}
+export interface OpticalPrescriptionHandle {
+    /** Focus an eye's row (first editable cell in interactive mode), optionally within a band. */
+    focusEye: (eye: Eye, band?: DistanceBand) => void;
+    /** Read the current prescription value. */
+    getValue: () => OpticalPrescriptionValue;
+    /** Replace the prescription value. */
+    setValue: (next: OpticalPrescriptionValue) => void;
+    /** Read one eye's refraction row at a band (undefined when absent). */
+    getRow: (band: DistanceBand, eye: Eye) => RefractionRow | undefined;
+    /** Set (or clear, with null) a single refraction cell. */
+    setCell: (band: DistanceBand, eye: Eye, field: keyof RefractionRow, value: number | PrismBase | null) => void;
+    /** Clear every refraction row in a band. */
+    clearBand: (band: DistanceBand) => void;
+    /** The distance bands carrying at least one value. */
+    getBands: () => DistanceBand[];
+}
+export declare const OpticalPrescription: import("react").ForwardRefExoticComponent<OpticalPrescriptionProps & import("react").RefAttributes<OpticalPrescriptionHandle>>;
+//# sourceMappingURL=optical-prescription.d.ts.map

package/dist/components/pagination/index.js

@@ -1,4 +1,4 @@
-import { P as n, a as s, b as t, c as g, d as o, e as P, f as e, g as p, p as l } from "../../_chunks/pagination-D58kglCr.js";
+import { P as n, a as s, b as t, c as g, d as o, e as P, f as e, g as p, p as l } from "../../_chunks/pagination-EkD5SiCK.js";
 export {
   n as Pagination,
   s as PaginationEllipsis,

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

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

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

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