@alfadocs/ui-kit-debug 0.69.0 → 0.71.0

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

@@ -0,0 +1,152 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import { type TaskItem } from '../task-card';
+/** Which set of tasks the panel shows — the host owns the actual feed. */
+export type TasksPanelScope = 'patient' | 'mine';
+/** Status segment value. Mirrors the platform `done` filter (default `todo`). */
+export type TasksPanelStatusFilter = 'todo' | 'done' | 'all';
+/**
+ * Panel-local extension of the card's `TaskItem`. The extra fields here drive
+ * bucketing + filtering; the row's display fields (the typed link via
+ * `linkType` + `linkedLabel`, the `assigneeLabel`, `dueLabel`) live on
+ * `TaskItem` and are rendered by `TaskCard` itself. The host maps the platform
+ * `DoctorReminder` → this shape — composing `title` (a summary, NOT the bare
+ * type), `note`, the linked entity, the assignee, and `dueLabel`.
+ */
+export interface TasksPanelItem extends TaskItem {
+    /** ISO-8601 due/scheduled instant (platform `DoctorReminder.date`). Buckets + orders the list. */
+    dueIso: string;
+    /** System or custom task-type key (`recall` | `payment` | `collection` | `other` | `custom-*`). Drives the type filter + badge. */
+    type?: string;
+    /**
+     * Localised type label, required for CUSTOM types (the panel resolves system
+     * keys itself). Falls back to the system label for the four known keys.
+     */
+    typeLabel?: string;
+    /**
+     * Assignee id (the platform `practiceUser`). Omit ⇒ unassigned; give pool
+     * tasks a shared sentinel value (e.g. `'unassigned'`) if you want the pool
+     * itself filterable. Drives the assignee FILTER (exact match); the displayed
+     * name is `TaskItem.assigneeLabel`.
+     */
+    assignee?: string;
+    /** Provenance — manual vs workflow-created. Filter only. */
+    createdBy?: 'user' | 'workflow';
+}
+/** Curated imperative handle — identifiers + structural state only, no PHI. */
+export interface TasksPanelHandle {
+    getItems: () => Array<{
+        id: string;
+        status: string;
+    }>;
+    selectItem: (id: string) => void;
+    toggleDone: (id: string) => void;
+    dismiss: (id: string) => void;
+    jumpToOverdue: () => void;
+    setFilter: (next: {
+        status?: TasksPanelStatusFilter;
+        type?: string | null;
+        assignee?: string | null;
+        overdueOnly?: boolean;
+    }) => void;
+    /** Switch the task scope segment (patient ↔ mine). The host re-feeds items. */
+    changeScope: (next: TasksPanelScope) => void;
+    /** Request the host to append the next page of tasks (mirrors onLoadMore). */
+    loadMore: () => void;
+}
+interface FilterOption {
+    /** Stable value passed back through the matching `on…Change`. */
+    value: string;
+    /** Localised label. */
+    label: string;
+}
+export interface TasksPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick' | 'id' | 'title'> {
+    /** Stable instance id, surfaced as `data-component-id`. */
+    id?: string;
+    /** Tasks to render — any order; bucketed + sorted internally (due ASC, Done last). */
+    items: TasksPanelItem[];
+    /** ISO-8601 "now" anchor — buckets + overdue compute against it. Defaults to the current instant; stories pass a fixed value. */
+    nowIso?: string;
+    /** Panel heading. Defaults to the localised "Tasks". */
+    title?: string;
+    /** Visual density forwarded to each TaskCard. Defaults to `xs` — the compact rail row. */
+    size?: 'xs' | 'sm' | 'md';
+    /** Fires when a row is activated. */
+    onOpenTask?: (item: TasksPanelItem) => void;
+    /** Fires when the host should toggle a task's done state. */
+    onToggleDone?: (item: TasksPanelItem) => void;
+    /** Fires when the host should open the task editor. Omit to hide the per-row edit action. */
+    onEditTask?: (item: TasksPanelItem) => void;
+    /** Fires when the host should dismiss / remove a task. Omit to hide the per-row dismiss action. */
+    onDismissTask?: (item: TasksPanelItem) => void;
+    /** Fires when the header "Add" affordance is activated. Omit to hide it. */
+    onAddTask?: () => void;
+    /**
+     * Read-only mode — hides every write affordance (toggle / edit / dismiss /
+     * add). Mirrors the platform gating writes behind `practice_task_edit`.
+     */
+    readOnly?: boolean;
+    /**
+     * Per-row trailing action toolbar, forwarded to each TaskCard's `actions`
+     * slot. Overrides the default toggle / edit / dismiss buttons (the type Badge
+     * is always prepended by the panel). Ignored when `readOnly`.
+     */
+    renderItemActions?: (item: TasksPanelItem) => ReactNode;
+    /** Controlled scope segment. */
+    scope?: TasksPanelScope;
+    /** Uncontrolled initial scope. Default `'patient'` when both scopes are available, else the only one. */
+    defaultScope?: TasksPanelScope;
+    /** Fires when the user switches scope — the host re-feeds `items`. */
+    onScopeChange?: (next: TasksPanelScope) => void;
+    /** Which scopes the segment offers. Omit ⇒ no scope segment (single-scope panel). */
+    availableScopes?: TasksPanelScope[];
+    /** Load the next page — fired when the bottom edge is reached and via the footer button. */
+    onLoadMore?: () => void;
+    /** Whether more tasks exist. Defaults to `true` when `onLoadMore` is set. */
+    hasMore?: boolean;
+    /** Show the bottom loading row while the next page is fetched. */
+    loadingMore?: boolean;
+    /** Full-panel initial loading state (skeleton rows in the body). */
+    loading?: boolean;
+    /** Error surface — `true` for the default error EmptyState, or a custom node. */
+    error?: boolean | ReactNode;
+    /** Show the filter header (status segment + type / assignee selects + overdue toggle). Default `true`. */
+    showFilters?: boolean;
+    /** Controlled status segment. */
+    statusFilter?: TasksPanelStatusFilter;
+    /** Uncontrolled initial status segment. Default `'todo'` (the platform default). */
+    defaultStatusFilter?: TasksPanelStatusFilter;
+    onStatusFilterChange?: (next: TasksPanelStatusFilter) => void;
+    /** Task types for the type filter. Omit ⇒ no type filter. */
+    typeOptions?: FilterOption[];
+    /** Controlled type filter (`null`/empty ⇒ all). */
+    typeFilter?: string | null;
+    onTypeFilterChange?: (next: string | null) => void;
+    /** Assignees for the assignee filter. Pass an explicit Unassigned option if wanted. Omit ⇒ no assignee filter. */
+    assigneeOptions?: FilterOption[];
+    /** Controlled assignee filter (`null`/empty ⇒ anyone). */
+    assigneeFilter?: string | null;
+    onAssigneeFilterChange?: (next: string | null) => void;
+    /** Controlled overdue-only toggle. */
+    overdueOnly?: boolean;
+    /** Uncontrolled initial overdue-only state. Default `false`. */
+    defaultOverdueOnly?: boolean;
+    onOverdueOnlyChange?: (next: boolean) => void;
+    emptyTitle?: string;
+    emptyDescription?: string;
+    /** CTA wired into the first-use empty state (e.g. Create task). */
+    emptyAction?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Accessible name for the panel region (defaults to `title`). */
+    'aria-label'?: string;
+}
+declare const rootVariants: (props?: ({
+    size?: "sm" | "md" | "xs" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export declare const TasksPanel: import("react").ForwardRefExoticComponent<TasksPanelProps & import("react").RefAttributes<HTMLElement>>;
+/** Re-export of the size variant union for downstream typing. */
+export type TasksPanelSize = NonNullable<VariantProps<typeof rootVariants>['size']>;
+export {};
+//# sourceMappingURL=tasks-panel.d.ts.map

package/dist/components/tasks-panel/tasks-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-panel.d.ts","sourceRoot":"","sources":["../../../src/components/tasks-panel/tasks-panel.tsx"],"names":[],"mappings":"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"}

package/dist/components/token-insert-menu/index.d.ts

@@ -0,0 +1,4 @@
+export { TokenInsertMenu } from './token-insert-menu';
+export type { TokenInsertMenuProps, TokenInsertMenuToken, TokenInsertMenuHandle, } from './token-insert-menu';
+export { tokenInsertMenuAgent } from './token-insert-menu.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/token-insert-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/token-insert-menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/components/token-insert-menu/index.js

@@ -0,0 +1,6 @@
+import { T as t, t as o } from "../../_chunks/token-insert-menu-CFQqTe_n.js";
+export {
+  t as TokenInsertMenu,
+  o as tokenInsertMenuAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/token-insert-menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/token-insert-menu/token-insert-menu.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { TokenInsertMenuHandle } from './token-insert-menu';
+export declare const tokenInsertMenuAgent: AgentAdapter<TokenInsertMenuHandle>;
+//# sourceMappingURL=token-insert-menu.agent.d.ts.map

package/dist/components/token-insert-menu/token-insert-menu.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-insert-menu.agent.d.ts","sourceRoot":"","sources":["../../../src/components/token-insert-menu/token-insert-menu.agent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,qBAAqB,CA+DpE,CAAC"}

package/dist/components/token-insert-menu/token-insert-menu.d.ts

@@ -0,0 +1,33 @@
+/** One selectable merge-token. */
+export interface TokenInsertMenuToken {
+    /** Raw token text inserted verbatim (e.g. `"{{patient.name}}"`). */
+    value: string;
+    /** Human-readable label shown in the menu. Already localised by the consumer. */
+    label: string;
+    /** Optional section heading — when ANY token has one, the menu renders grouped. */
+    group?: string;
+}
+/** Agent-readiness curated handle for TokenInsertMenu. */
+export interface TokenInsertMenuHandle {
+    isOpen: () => boolean;
+    open: () => void;
+    close: () => void;
+    /** Emit a token to the consumer (mirrors a user selecting it). */
+    insert: (token: string) => void;
+}
+export interface TokenInsertMenuProps {
+    /** The merge-tokens to offer. `value` is inserted; `label` is shown. */
+    tokens: TokenInsertMenuToken[];
+    /** Called with the chosen token's raw `value`. The consumer inserts it at
+     *  the caret of their target field — this component never owns the field. */
+    onInsert: (token: string) => void;
+    /** The trigger button's visible text (already localised by the consumer). */
+    triggerLabel: string;
+    disabled?: boolean;
+    /** Opaque instance id — surfaced as `data-component-id` + agent instance id. */
+    id?: string;
+    /** Extra classes for the trigger button. */
+    className?: string;
+}
+export declare const TokenInsertMenu: import("react").ForwardRefExoticComponent<TokenInsertMenuProps & import("react").RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=token-insert-menu.d.ts.map

package/dist/components/token-insert-menu/token-insert-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-insert-menu.d.ts","sourceRoot":"","sources":["../../../src/components/token-insert-menu/token-insert-menu.tsx"],"names":[],"mappings":"AAaA,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kEAAkE;IAClE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B;iFAC6E;IAC7E,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,eAAO,MAAM,eAAe,oHA2G1B,CAAC"}

package/dist/components/tool-rail/index.d.ts

@@ -0,0 +1,4 @@
+export { ToolRail } from './tool-rail';
+export type { ToolRailProps, ToolRailHandle, ToolRailTool } from './tool-rail';
+export { toolRailAgent } from './tool-rail.agent';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/tool-rail/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tool-rail/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/tool-rail/index.js

@@ -0,0 +1,6 @@
+import { T as l, t } from "../../_chunks/tool-rail-BZx0-yIr.js";
+export {
+  l as ToolRail,
+  t as toolRailAgent
+};
+//# sourceMappingURL=index.js.map

package/dist/components/tool-rail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/tool-rail/tool-rail.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ToolRailHandle } from './tool-rail';
+export declare const toolRailAgent: AgentAdapter<ToolRailHandle>;
+//# sourceMappingURL=tool-rail.agent.d.ts.map

package/dist/components/tool-rail/tool-rail.agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-rail.agent.d.ts","sourceRoot":"","sources":["../../../src/components/tool-rail/tool-rail.agent.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,aAAa,EAAE,YAAY,CAAC,cAAc,CA4EtD,CAAC"}

package/dist/components/tool-rail/tool-rail.d.ts

@@ -0,0 +1,160 @@
+import { type ReactNode } from 'react';
+import { type VariantProps } from 'class-variance-authority';
+import type { AgentAdapter } from '../../agent/types';
+export interface ToolRailTool {
+    /** Stable tool id — used in `data-active`, the imperative handle, and
+     *  to label the open panel region. */
+    id: string;
+    /** Accessible name for the strip icon + tooltip, and the open panel's
+     *  region label. Never rendered as visible body text. */
+    label: string;
+    /** lucide-react glyph (rendered `aria-hidden` inside the IconButton). */
+    icon: ReactNode;
+    /** 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 ToolRail. Exposed as the forwardRef
+ * target so a future agent / MCP UI bridge can drive the rail without
+ * touching the DOM. See `tool-rail.agent.ts`.
+ *
+ * State surfaced here is strictly identifiers + counts — never any
+ * tool's panel content (which may carry PHI).
+ */
+export interface ToolRailHandle {
+    /** Currently-active tool id, or null when collapsed to strip-only. */
+    getActiveToolId: () => string | null;
+    /** Activate a tool by id (opens its panel), or null to collapse. */
+    setActiveTool: (id: string | null) => void;
+    /** Activate a tool by id (opens its panel). */
+    open: (id: string) => void;
+    /** Collapse to strip-only (no active tool). */
+    close: () => void;
+}
+declare const railVariants: (props?: ({
+    side?: "end" | "start" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface ToolRailProps extends VariantProps<typeof railVariants> {
+    /** Stable instance id, surfaced on the root as `data-component-id`. */
+    id?: string;
+    /** The tools shown as icons on the strip. */
+    tools: ToolRailTool[];
+    /** Controlled active tool id (null = collapsed / strip-only). */
+    activeToolId?: string | null;
+    /** Uncontrolled initial active tool id (default null). */
+    defaultActiveToolId?: string | null;
+    /** Fires whenever the active tool changes (incl. → null on collapse). */
+    onActiveToolChange?: (id: string | null) => void;
+    /** Which edge the rail docks to. Default `'end'` (inline-end). */
+    side?: 'start' | 'end';
+    /** Accessible label for the toolbar strip. */
+    railLabel?: string;
+    /**
+     * Opt-in resize affordance for the open tool panel. Renders a
+     * `role="separator"` drag handle on the panel's inner edge (the edge
+     * facing the main content). The committed width is written to
+     * `--tool-rail-panel-inline-size` on the panel element (288–640px);
+     * 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: ToolRailTool;
+        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: ToolRailTool, 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: ToolRailTool, context: {
+        isActive: boolean;
+    }) => ReactNode;
+    /**
+     * Identity override for the root's `data-component` attribute. Defaults to
+     * `'tool-rail'`. A product wrapper (e.g. ControlRoomRail) passes its own
+     * kebab id so the DOM / cascade boundary — and an agent's `domHooks.root` —
+     * can tell its surface apart from a bare ToolRail, without the engine ever
+     * importing the wrapper.
+     */
+    dataComponent?: string;
+    /**
+     * Agent adapter registered for this rail instance. Defaults to
+     * `toolRailAgent`. A wrapper passes its own adapter (matching
+     * `dataComponent`) so the rail registers under the wrapper's identity. The
+     * instance id is sourced from the `id` prop (also stamped as
+     * `data-component-id`).
+     */
+    agentAdapter?: AgentAdapter<ToolRailHandle>;
+    className?: string;
+}
+export declare const ToolRail: import("react").ForwardRefExoticComponent<ToolRailProps & import("react").RefAttributes<ToolRailHandle>>;
+export {};
+//# sourceMappingURL=tool-rail.d.ts.map

package/dist/components/tool-rail/tool-rail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-rail.d.ts","sourceRoot":"","sources":["../../../src/components/tool-rail/tool-rail.tsx"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,5 @@
 export * from './tooth-scheme';
-export { FDI_TO_META, FDI_TO_UNIVERSAL, FDI_TO_PALMER, CONDITION_COLORS, CONDITION_TOKENS, CONDITION_SIDE_SYMBOL, CONDITION_PLAN_FOLDER, SURFACE_ASSET_NAME, toothImageUrl, conditionSymbolUrl, surfaceSymbolUrl, zonesForTooth, zoneSurface, zonePath, chartFromConditions, emptyChart, labelFor, layoutTeeth, } from './tooth-data';
-export type { Anatomy, Arch, Quadrant, Side, Surface, SurfaceZone, Projection, SideSymbolSpec, ToothMeta, PositionedTooth, } from './tooth-data';
+export { FDI_TO_META, FDI_TO_UNIVERSAL, FDI_TO_PALMER, CONDITION_COLORS, CONDITION_TOKENS, CONDITION_SIDE_SYMBOL, CONDITION_PLAN_FOLDER, SURFACE_ASSET_NAME, toothImageUrl, conditionSymbolUrl, surfaceSymbolUrl, zonesForTooth, zoneSurface, zonePath, chartFromConditions, emptyChart, labelFor, layoutTeeth, layoutSpecials, specialsForRow, specialIconUrl, generalElement, isSpecialElement, SPECIAL_ELEMENTS, SPECIAL_BY_ID, } from './tooth-data';
+export type { Anatomy, Arch, Quadrant, Side, Surface, SurfaceZone, Projection, Radiograph, RadiographKind, SideSymbolSpec, SpecialElement, SpecialElementKind, PositionedSpecial, ToothMeta, PositionedTooth, } from './tooth-data';
 export { toothSchemeAgent } from './tooth-scheme.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/tooth-scheme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooth-scheme/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,WAAW,EACX,UAAU,EACV,cAAc,EACd,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/tooth-scheme/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -1,27 +1,34 @@
-import { C as o, a as t, b as e, c as T, F as O, d as _, e as E, P as I, f as S, S as r, T as N, g as h, h as m, i as n, l as A, j as l, s as C, t as D, k as F, r as c, z as R, m as i, n as L } from "../../_chunks/tooth-scheme-yBr53cvv.js";
+import { C as o, a as e, b as t, c as E, F as S, d as T, e as I, P as _, f as l, S as r, g as O, h as N, T as n, i as c, j as h, k as m, l as A, m as i, n as C, o as D, p as F, s as L, q as R, r as P, t as p, u as M, v as U, z as u, w as y, x as b } from "../../_chunks/tooth-scheme-DJZtzfeY.js";
 export {
   o as CONDITION_COLORS,
-  t as CONDITION_PLAN_FOLDER,
-  e as CONDITION_SIDE_SYMBOL,
-  T as CONDITION_TOKENS,
-  O as FDI_TO_META,
-  _ as FDI_TO_PALMER,
-  E as FDI_TO_UNIVERSAL,
-  I as PERMANENT_TEETH,
-  S as PRIMARY_TEETH,
-  r as SURFACE_ASSET_NAME,
-  N as ToothScheme,
-  h as chartFromConditions,
-  m as conditionSymbolUrl,
-  n as emptyChart,
-  A as labelFor,
-  l as layoutTeeth,
-  C as surfaceSymbolUrl,
-  D as toothImageUrl,
-  F as toothSchemeAgent,
-  c as toothSchemeVariants,
-  R as zonePath,
-  i as zoneSurface,
-  L as zonesForTooth
+  e as CONDITION_PLAN_FOLDER,
+  t as CONDITION_SIDE_SYMBOL,
+  E as CONDITION_TOKENS,
+  S as FDI_TO_META,
+  T as FDI_TO_PALMER,
+  I as FDI_TO_UNIVERSAL,
+  _ as PERMANENT_TEETH,
+  l as PRIMARY_TEETH,
+  r as SPECIAL_BY_ID,
+  O as SPECIAL_ELEMENTS,
+  N as SURFACE_ASSET_NAME,
+  n as ToothScheme,
+  c as chartFromConditions,
+  h as conditionSymbolUrl,
+  m as emptyChart,
+  A as generalElement,
+  i as isSpecialElement,
+  C as labelFor,
+  D as layoutSpecials,
+  F as layoutTeeth,
+  L as specialIconUrl,
+  R as specialsForRow,
+  P as surfaceSymbolUrl,
+  p as toothImageUrl,
+  M as toothSchemeAgent,
+  U as toothSchemeVariants,
+  u as zonePath,
+  y as zoneSurface,
+  b as zonesForTooth
 };
 //# sourceMappingURL=index.js.map

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

@@ -10,6 +10,35 @@ export interface ToothState {
     notes?: string;
 }
 export type ToothChart = Record<FdiId, ToothState>;
+/** Radiograph (x-ray) type. `'periapical'` is the intraoral *endorale*. */
+export type RadiographKind = 'periapical' | 'bitewing' | 'panoramic' | 'other';
+/**
+ * A single radiograph attached to a tooth. Image urls are opaque,
+ * consumer-hosted strings, interpolated into an SVG `<image href>` / `<img src>`
+ * (which cannot execute scripts) — never bundled and never runtime-validated.
+ * Real radiographs are PHI: stories and demos must use synthetic placeholders.
+ */
+export interface Radiograph {
+    /** Stable id — keys the archive list and the imperative open call. */
+    id: string;
+    /** Full-resolution image url. */
+    url: string;
+    /** Optional smaller preview url (falls back to `url`). */
+    thumbnailUrl?: string;
+    /** ISO acquisition date (`YYYY-MM-DD`). */
+    date?: string;
+    /** Free-text clinical note. */
+    note?: string;
+    /** Radiograph type. Default `'periapical'` (an *endorale*). */
+    kind?: RadiographKind;
+    /**
+     * Accessible description for the FULL-SIZE image, consumed by a downstream
+     * viewer (e.g. the Dental Imaging Hub archive `<img>`). The chart's slot
+     * render is decorative (`aria-hidden` — the tooth's accessible name carries
+     * the radiograph count), so `alt` is intentionally not read by the chart.
+     */
+    alt?: string;
+}
 export type Anatomy = 'incisor' | 'canine' | 'premolar' | 'molar';
 export type Arch = 'upper' | 'lower';
 export type Side = 'right' | 'left';
@@ -141,11 +170,93 @@ export interface PositionedTooth {
  * is preserved: the patient's right sits on the viewer's left in both
  * arches, regardless of document direction.
  */
-export declare function layoutTeeth(dentition: Dentition, slotHeight?: number): {
+export declare function layoutTeeth(dentition: Dentition, slotHeight?: number, options?: {
+    arch?: Arch;
+}): {
     teeth: PositionedTooth[];
     width: number;
     height: number;
 };
+export type SpecialElementKind = 'quadrant' | 'sextant' | 'arch' | 'general';
+export interface SpecialElement {
+    /**
+     * Stable id — a chart key and the value emitted by `onSelect`. Permanent:
+     * `Q1`–`Q4`, `S1`–`S6`, `AS`, `AI`, `general`. Primary mirrors with an `m`
+     * prefix: `mQ1`…, `mS1`…, `mAS`, `mAI`, `mGeneral`.
+     */
+    id: string;
+    kind: SpecialElementKind;
+    arch: Arch;
+    dentition: 'permanent' | 'primary';
+    /** i18n token under `toothScheme.special.*` for the accessible name. */
+    labelKey: 'quadrant' | 'sextant' | 'archUpper' | 'archLower' | 'general';
+    /** Interpolated into the `{{n}}` of quadrant / sextant labels (e.g. `1`). */
+    labelIndex?: number;
+    /** Short code shown in the slot, e.g. `Q1`, `S3`, `AS`, `Gen.`. */
+    code: string;
+    /**
+     * Member teeth (FDI) — informational for consumers that highlight or expand a
+     * region. Selection itself keys on `id`; the platform expands membership
+     * server-side. Sextants follow the WHO/CPITN convention.
+     */
+    teeth: FdiId[];
+    /**
+     * Column within the special-element block. Quadrant and its paired sextant
+     * share a column so they stack (Q1↕S1, Q2↕S2, AS↕S3 / S4↕Q4, S5↕Q3, S6↕AI).
+     */
+    column: number;
+    /** Row the element attaches to: side (quadrant/arch/general) or plan (sextant). */
+    row: Projection;
+}
+/** Every special element, flat — permanent then primary. */
+export declare const SPECIAL_ELEMENTS: SpecialElement[];
+/** Lookup a special element by its id (`Q1`, `mS3`, `AS`, `general`…). */
+export declare const SPECIAL_BY_ID: Record<string, SpecialElement>;
+/** True when an id names a special element rather than a tooth. */
+export declare function isSpecialElement(id: string): boolean;
+/**
+ * The special-element SLOTS that attach to a given row, ordered by column.
+ * Quadrant / arch live on the `side` row; sextants on the `plan` row. The
+ * whole-mouth `general` element is excluded — it renders as a switch beneath the
+ * chart (see `generalElement`), not as a column. Mixed dentition reuses the
+ * permanent set (the platform has no mixed view).
+ */
+export declare function specialsForRow(dentition: Dentition, arch: Arch, projection: Projection): SpecialElement[];
+/**
+ * The whole-mouth `general` element for a dentition. It is rendered as a switch
+ * beneath the chart rather than as a cramped icon column (the platform's vertical
+ * "GENERALE" glyph is illegible at column width).
+ */
+export declare function generalElement(dentition: Dentition): SpecialElement;
+/** A special-element slot placed in an SVG, to the inline-end of the teeth. */
+export interface PositionedSpecial {
+    element: SpecialElement;
+    x: number;
+    y: number;
+}
+/** Special-element slot block-size — matches a tooth slot so icons read clearly. */
+export declare const SPECIAL_SLOT_WIDTH = 36;
+/**
+ * Resolve the photoreal icon URL for a special element, or `null` when it has
+ * none (sextants are label-only — the platform ships no sextant icon). Icons
+ * live in the `global/` sibling of the `teeth/` render folder; quadrants and
+ * arches reuse their code as the file stem (`Q1`, `AS`, …), general resolves to
+ * `general`, and primary elements reuse the permanent art.
+ */
+export declare function specialIconUrl(element: SpecialElement, assetBaseUrl: string): string | null;
+/** Gap between the last tooth and the first special-element column. */
+export declare const SPECIAL_GAP = 8;
+/** Column pitch within the special-element block. */
+export declare const SPECIAL_PITCH: number;
+/**
+ * Place a row's special elements after the teeth (inline-end) and report the
+ * total row width. Columns are derived from `element.column`, so a quadrant and
+ * its paired sextant share an x and stack across the two rows.
+ */
+export declare function layoutSpecials(specials: SpecialElement[], teethWidth: number): {
+    specials: PositionedSpecial[];
+    width: number;
+};
 export declare function labelFor(id: FdiId, numbering: Numbering): string;
 export declare function emptyChart(): ToothChart;
 export declare function chartFromConditions(conditions: Partial<Record<FdiId, ToothCondition[]>>): ToothChart;