@alfadocs/ui-kit 0.70.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/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.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/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.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/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.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/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/{ai-tools-rail/ai-tools-rail.d.ts → tool-rail/tool-rail.d.ts}

@@ -1,6 +1,7 @@
 import { type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
-export interface AiToolsRailTool {
+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;
@@ -52,14 +53,14 @@ export interface AiToolsRailTool {
     reorderable?: boolean;
 }
 /**
- * Curated imperative handle for AiToolsRail. Exposed as the forwardRef
+ * 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 `ai-tools-rail.agent.ts`.
+ * 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 AiToolsRailHandle {
+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. */
@@ -72,11 +73,11 @@ export interface AiToolsRailHandle {
 declare const railVariants: (props?: ({
     side?: "end" | "start" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export interface AiToolsRailProps extends VariantProps<typeof railVariants> {
+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: AiToolsRailTool[];
+    tools: ToolRailTool[];
     /** Controlled active tool id (null = collapsed / strip-only). */
     activeToolId?: string | null;
     /** Uncontrolled initial active tool id (default null). */
@@ -91,7 +92,7 @@ export interface AiToolsRailProps extends VariantProps<typeof railVariants> {
      * 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
-     * `--ai-tools-rail-panel-inline-size` on the panel element (288–640px);
+     * `--tool-rail-panel-inline-size` on the panel element (288–640px);
      * Enter / double-click resets to the token-driven default. Default `false`.
      */
     resizablePanel?: boolean;
@@ -113,7 +114,7 @@ export interface AiToolsRailProps extends VariantProps<typeof railVariants> {
      * omitted, the rail announces the generic run-relative position.
      */
     formatReorderAnnouncement?: (args: {
-        tool: AiToolsRailTool;
+        tool: ToolRailTool;
         from: number;
         to: number;
     }) => string;
@@ -123,7 +124,7 @@ export interface AiToolsRailProps extends VariantProps<typeof railVariants> {
      * 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: {
+    renderToolAffordance?: (tool: ToolRailTool, context: {
         index: number;
         isActive: boolean;
         isRovingTarget: boolean;
@@ -133,11 +134,27 @@ export interface AiToolsRailProps extends VariantProps<typeof railVariants> {
      * 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: {
+    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 AiToolsRail: import("react").ForwardRefExoticComponent<AiToolsRailProps & import("react").RefAttributes<AiToolsRailHandle>>;
+export declare const ToolRail: import("react").ForwardRefExoticComponent<ToolRailProps & import("react").RefAttributes<ToolRailHandle>>;
 export {};
-//# sourceMappingURL=ai-tools-rail.d.ts.map
+//# sourceMappingURL=tool-rail.d.ts.map

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

@@ -1,4 +1,4 @@
-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-BhQoPNBD.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,
   e as CONDITION_PLAN_FOLDER,

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

@@ -93,6 +93,15 @@ export interface ToothSchemeProps {
      * chart directly. Default `false`.
      */
     controls?: boolean;
+    /**
+     * Where to render the `controls` gear. `undefined` (default) renders it
+     * inline at the top-end of the chart. Pass a DOM element (e.g. a ref'd slot in
+     * your card header) to portal the gear + its popover into that slot instead,
+     * so the chart options can sit on the title line. While the slot is mounting
+     * the prop will be `null`; the gear renders nothing until the element exists,
+     * so it never flashes inline first. No effect unless `controls` is on.
+     */
+    controlsContainer?: HTMLElement | null;
     /** Accessible label override for the chart region. */
     ariaLabel?: string;
     /** Extra class names on the wrapper. */

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

@@ -1,4 +1,4 @@
-import { T as t, t as n } from "../../_chunks/transcript-panel-3THQX6nJ.js";
+import { T as t, t as n } from "../../_chunks/transcript-panel-CHGHHHdT.js";
 export {
   t as TranscriptPanel,
   n as transcriptPanelAgent

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

@@ -18,7 +18,7 @@ export interface TranscriptPanelHandle {
     /** Copy the turn's text to the clipboard. */
     copyTurn: (id: string) => Promise<void> | void;
 }
-export interface TranscriptPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof rootVariants> {
+export interface TranscriptPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'children'>, VariantProps<typeof rootVariants> {
     lines: TranscriptLine[];
     /** Current playback time in seconds — drives the active line highlight. */
     currentTime?: number;
@@ -29,6 +29,6 @@ export interface TranscriptPanelProps extends Omit<HTMLAttributes<HTMLDivElement
 declare const rootVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-export declare const TranscriptPanel: import("react").ForwardRefExoticComponent<TranscriptPanelProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const TranscriptPanel: import("react").ForwardRefExoticComponent<TranscriptPanelProps & import("react").RefAttributes<HTMLElement>>;
 export {};
 //# sourceMappingURL=transcript-panel.d.ts.map

package/dist/components/unit-converter/index.js

@@ -1,4 +1,4 @@
-import { C as r, U as t, a as U, b as e, c as n } from "../../_chunks/unit-converter-YEpD9evj.js";
+import { C as r, U as t, a as U, b as e, c as n } from "../../_chunks/unit-converter-CwlZbfdn.js";
 export {
   r as CATEGORIES,
   t as UNITS,

package/dist/components/workflow/index.js

@@ -1,4 +1,4 @@
-import { C as r, W as e, a as s, b as d, c as w, i as t, l as f, m as l, r as i, w as k, d as n, e as A, f as C } from "../../_chunks/workflow-map-Dy8mLCqF.js";
+import { C as r, W as e, a as s, b as d, c as w, i as t, l as f, m as l, r as i, w as k, d as n, e as A, f as C } from "../../_chunks/workflow-map-M8MBBHQm.js";
 export {
   r as CORE_PATIENT_FIELDS,
   e as WorkflowCard,

package/dist/hooks/use-edge-resize.d.ts

@@ -1,6 +1,6 @@
 /**
  * Pixel-based edge-resize for fixed-width chrome surfaces (the Sidebar's
- * inline-end edge, the AiToolsRail panel's inner edge). Mirrors the
+ * inline-end edge, the ToolRail panel's inner edge). Mirrors the
  * separator semantics of `Resizable`'s Handle — `role="separator"`,
  * arrow keys with RTL flip, Shift for coarse steps, Home/End to the
  * extremes, Enter or double-click to reset — but sizes a single target
@@ -19,7 +19,7 @@ export interface UseEdgeResizeOptions {
     /**
      * Which logical edge of the target carries the handle. `inline-end`
      * for a start-docked surface (Sidebar); `inline-start` for an
-     * end-docked one (AiToolsRail panel with `side="end"`).
+     * end-docked one (ToolRail panel with `side="end"`).
      */
     edge: 'inline-start' | 'inline-end';
     /** The element being resized. The width override lands on its style. */