@alfadocs/ui-kit 0.1.7 → 0.1.9

package/dist/components/text-area/text-area.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { TextAreaHandle } from './text-area';
+export declare const textAreaAgent: AgentAdapter<TextAreaHandle>;
+//# sourceMappingURL=text-area.agent.d.ts.map

package/dist/components/text-area/text-area.d.ts

@@ -1,5 +1,12 @@
 import { type TextareaHTMLAttributes } from 'react';
 import { type VariantProps } from 'class-variance-authority';
+/** Agent-readiness curated handle for TextArea. */
+export interface TextAreaHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+    focus: () => void;
+}
 declare const textAreaVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
     tone?: "default" | "error" | null | undefined;

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

@@ -1,4 +1,4 @@
-import { T as o } from "../../_chunks/text-input-CRHvl5zk.js";
+import { T as o } from "../../_chunks/text-input-BX39e6T6.js";
 export {
   o as TextInput
 };

package/dist/components/text-input/text-input.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { TextInputHandle } from './text-input';
+export declare const textInputAgent: AgentAdapter<TextInputHandle>;
+//# sourceMappingURL=text-input.agent.d.ts.map

package/dist/components/text-input/text-input.d.ts

@@ -1,5 +1,15 @@
 import { type ChangeEvent, type CompositionEvent, type InputHTMLAttributes, type ReactNode } from 'react';
 import { type VariantProps } from 'class-variance-authority';
+/**
+ * Agent-readiness curated handle. The internal value setter drives the DOM
+ * input via the native value setter so React picks up the change.
+ */
+export interface TextInputHandle {
+    getValue: () => string;
+    setValue: (value: string) => void;
+    clear: () => void;
+    focus: () => void;
+}
 declare const inputVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
     tone?: "default" | "error" | null | undefined;

package/dist/components/theme-toggle/index.d.ts

@@ -1,3 +1,4 @@
 export { ThemeToggle } from './theme-toggle';
-export type { ThemeToggleProps, ThemeToggleVariant, } from './theme-toggle';
+export type { ThemeToggleProps, ThemeToggleHandle, ThemeToggleVariant, } from './theme-toggle';
+export { themeToggleAgent } from './theme-toggle.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/theme-toggle/index.js

@@ -1,5 +1,6 @@
-import { T } from "../../_chunks/theme-toggle-BHiMMEQN.js";
+import { T as o, t } from "../../_chunks/theme-toggle.agent-btmXTWdW.js";
 export {
-  T as ThemeToggle
+  o as ThemeToggle,
+  t as themeToggleAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/theme-toggle/theme-toggle.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { ThemeToggleHandle } from './theme-toggle';
+export declare const themeToggleAgent: AgentAdapter<ThemeToggleHandle>;
+//# sourceMappingURL=theme-toggle.agent.d.ts.map

package/dist/components/theme-toggle/theme-toggle.d.ts

@@ -2,7 +2,7 @@ import { type HTMLAttributes } from 'react';
 import { type VariantProps } from 'class-variance-authority';
 import { type AccessibilityPreference, type ThemePreference } from '../../hooks';
 declare const wrapperVariants: (props?: ({
-    variant?: "menu" | "split" | "compact" | null | undefined;
+    variant?: "split" | "menu" | "compact" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type ThemeToggleVariant = 'menu' | 'compact' | 'split';
 interface ThemeToggleBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof wrapperVariants> {
@@ -29,6 +29,13 @@ interface ThemeToggleBaseProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onC
     onAccessibilityChange?: (next: AccessibilityPreference) => void;
 }
 export type ThemeToggleProps = ThemeToggleBaseProps;
-export declare const ThemeToggle: import("react").ForwardRefExoticComponent<ThemeToggleBaseProps & import("react").RefAttributes<HTMLDivElement>>;
+/** Curated imperative handle for agent / external automation. */
+export interface ThemeToggleHandle {
+    getCurrentTheme: () => ThemePreference;
+    getCurrentAccessibility: () => AccessibilityPreference;
+    setTheme: (next: ThemePreference) => void;
+    setAccessibility: (next: AccessibilityPreference) => void;
+}
+export declare const ThemeToggle: import("react").ForwardRefExoticComponent<ThemeToggleBaseProps & import("react").RefAttributes<ThemeToggleHandle>>;
 export {};
 //# sourceMappingURL=theme-toggle.d.ts.map

package/dist/components/time-picker/index.d.ts

@@ -1,3 +1,4 @@
 export { TimePicker } from './time-picker';
-export type { TimePickerProps } from './time-picker';
+export type { TimePickerProps, TimePickerHandle } from './time-picker';
+export { timePickerAgent } from './time-picker.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/time-picker/index.js

@@ -1,5 +1,6 @@
-import { T as i } from "../../_chunks/time-picker-D-EueWUG.js";
+import { T as r, t } from "../../_chunks/time-picker-B8AMIrX7.js";
 export {
-  i as TimePicker
+  r as TimePicker,
+  t as timePickerAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/time-picker/time-picker.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { TimePickerHandle } from './time-picker';
+export declare const timePickerAgent: AgentAdapter<TimePickerHandle>;
+//# sourceMappingURL=time-picker.agent.d.ts.map

package/dist/components/time-picker/time-picker.d.ts

@@ -1,5 +1,20 @@
 import { type VariantProps } from 'class-variance-authority';
 import type { TimeValue } from '../_shared/time';
+/** Curated imperative handle exposed via `ref` — also consumed by the agent adapter. */
+export interface TimePickerHandle {
+    /** Get the current time value, or null when unset. */
+    getValue: () => TimeValue | null;
+    /** Set the time value. */
+    setValue: (value: TimeValue) => void;
+    /** Clear the value (resets to 00:00). */
+    clear: () => void;
+    /** Whether a popover is open. TimePicker has no popover; always false. */
+    isOpen: () => boolean;
+    /** No-op: TimePicker has no popover. */
+    open: () => void;
+    /** No-op: TimePicker has no popover. */
+    close: () => void;
+}
 declare const wrapperVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
     tone?: "default" | "error" | null | undefined;
@@ -33,6 +48,6 @@ export interface TimePickerProps extends Pick<VariantProps<typeof wrapperVariant
     /** id override. */
     id?: string;
 }
-export declare const TimePicker: import("react").ForwardRefExoticComponent<TimePickerProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const TimePicker: import("react").ForwardRefExoticComponent<TimePickerProps & import("react").RefAttributes<TimePickerHandle>>;
 export {};
 //# sourceMappingURL=time-picker.d.ts.map

package/dist/components/timeline/index.d.ts

@@ -1,3 +1,4 @@
 export { Timeline } from './timeline';
-export type { TimelineProps, TimelineEventProps, TimelineDotProps, TimelineContentProps, TimelineTimestampProps, } from './timeline';
+export type { TimelineProps, TimelineHandle, TimelineEventProps, TimelineDotProps, TimelineContentProps, TimelineTimestampProps, } from './timeline';
+export { timelineAgent } from './timeline.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/timeline/index.js

@@ -1,5 +1,6 @@
-import { T as m } from "../../_chunks/timeline-RgAIzpMd.js";
+import { T as t, t as m } from "../../_chunks/timeline.agent-CRPza9wc.js";
 export {
-  m as Timeline
+  t as Timeline,
+  m as timelineAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/timeline/timeline.agent.d.ts

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

package/dist/components/timeline/timeline.d.ts

@@ -14,9 +14,16 @@ export interface TimelineProps extends Omit<OlHTMLAttributes<HTMLOListElement>,
 }
 export interface TimelineEventProps extends LiHTMLAttributes<HTMLLIElement> {
     type?: EventType;
+    /** Opaque event id — when set, the component emits `data-event-id` for agent addressing. */
+    eventId?: string;
     children: ReactNode;
     className?: string;
 }
+/** Curated imperative handle for agent / external automation. */
+export interface TimelineHandle {
+    getSelectedEvent: () => string | null;
+    selectEvent: (id: string) => void;
+}
 export interface TimelineDotProps extends HTMLAttributes<HTMLDivElement> {
     icon?: ReactNode;
     className?: string;
@@ -37,7 +44,7 @@ export interface TimelineTimestampProps extends TimeHTMLAttributes<HTMLTimeEleme
     format?: Intl.DateTimeFormatOptions;
     className?: string;
 }
-export declare const Timeline: import("react").ForwardRefExoticComponent<TimelineProps & import("react").RefAttributes<HTMLOListElement>> & {
+export declare const Timeline: import("react").ForwardRefExoticComponent<TimelineProps & import("react").RefAttributes<TimelineHandle>> & {
     Event: import("react").ForwardRefExoticComponent<TimelineEventProps & import("react").RefAttributes<HTMLLIElement>>;
     Dot: import("react").ForwardRefExoticComponent<TimelineDotProps & import("react").RefAttributes<HTMLDivElement>>;
     Content: import("react").ForwardRefExoticComponent<TimelineContentProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/toast/index.d.ts

@@ -1,3 +1,4 @@
-export { Toaster, toastInfo, toastSuccess, toastWarning, toastError } from './toast';
-export type { ToasterProps, ToastOptions } from './toast';
+export { Toaster, toastInfo, toastSuccess, toastWarning, toastError, toastAgentHandle, } from './toast';
+export type { ToasterProps, ToastOptions, ToastAgentHandle } from './toast';
+export { toastAgent } from './toast.agent';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/toast/index.js

@@ -1,9 +1,11 @@
-import { T as t, t as o, a as r, b as c, c as e } from "../../_chunks/toast-lOhJDKOH.js";
+import { T as s, t as o, a as e, b as r, c as n, d as c, e as g } from "../../_chunks/toast.agent-BjEGuq1Z.js";
 export {
-  t as Toaster,
-  o as toastError,
-  r as toastInfo,
+  s as Toaster,
+  o as toastAgent,
+  e as toastAgentHandle,
+  r as toastError,
+  n as toastInfo,
   c as toastSuccess,
-  e as toastWarning
+  g as toastWarning
 };
 //# sourceMappingURL=index.js.map

package/dist/components/toast/toast.agent.d.ts

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

package/dist/components/toast/toast.d.ts

@@ -28,5 +28,13 @@ export declare function toastInfo(message: string, options?: ToastOptions): stri
 export declare function toastSuccess(message: string, options?: ToastOptions): string | number;
 export declare function toastWarning(message: string, options?: ToastOptions): string | number;
 export declare function toastError(message: string, options?: ToastOptions): string | number;
+export interface ToastAgentHandle {
+    getVisibleToasts: () => Array<{
+        id: string;
+    }>;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+}
+export declare const toastAgentHandle: ToastAgentHandle;
 export {};
 //# sourceMappingURL=toast.d.ts.map

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

@@ -1,4 +1,4 @@
-import { C as s, a as t, b as O, F as e, c as o, d as E, P as _, e as I, T as N, f as h, g as S, h as r, l as A, i as C, t as R, r as m } from "../../_chunks/tooth-scheme.agent-BlDyu-Gx.js";
+import { C as s, a as t, b as O, F as e, c as o, d as E, P as _, e as I, T as N, f as h, g as S, h as r, l as A, i as C, t as R, r as m } from "../../_chunks/tooth-scheme.agent-CWrQBjJM.js";
 export {
   s as CONDITION_COLORS,
   t as CONDITION_PATTERNS,

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

@@ -1,5 +1,7 @@
 import { PERMANENT_TEETH, PRIMARY_TEETH, type Dentition, type FdiId, type Numbering, type ToothChart, type ToothCondition, type ToothMode } from './tooth-data';
 export interface ToothSchemeProps {
+    /** Opaque instance id — emitted as `data-component-id` for the agent registry. */
+    id?: string;
     /** Which teeth to render. Default `'permanent'`. */
     dentition?: Dentition;
     /** Numbering system shown on each tooth label. Default `'fdi'`. */

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

@@ -1,3 +1,4 @@
 export { TranscriptPanel } from './transcript-panel';
-export type { TranscriptPanelProps, TranscriptLine, } from './transcript-panel';
+export type { TranscriptPanelProps, TranscriptPanelHandle, TranscriptLine, } from './transcript-panel';
+export { transcriptPanelAgent } from './transcript-panel.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,5 +1,6 @@
-import { T as e } from "../../_chunks/transcript-panel-CNbVGG9L.js";
+import { T as t, t as n } from "../../_chunks/transcript-panel.agent-BXEYP6w-.js";
 export {
-  e as TranscriptPanel
+  t as TranscriptPanel,
+  n as transcriptPanelAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -9,6 +9,15 @@ export interface TranscriptLine {
     /** 0..1 — rendered with a dotted underline when below 0.6. */
     confidence?: number;
 }
+/** Curated imperative handle for agent / external automation. */
+export interface TranscriptPanelHandle {
+    /** Opaque id (line index) of the active turn, or null. */
+    getSelectedTurn: () => string | null;
+    /** Scroll the turn with the given id into view and focus its seek button. */
+    focusTurn: (id: string) => void;
+    /** 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> {
     lines: TranscriptLine[];
     /** Current playback time in seconds — drives the active line highlight. */
@@ -20,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<TranscriptPanelHandle>>;
 export {};
 //# sourceMappingURL=transcript-panel.d.ts.map

package/dist/components/workflow/index.d.ts

@@ -1,7 +1,8 @@
 export { WorkflowCard } from './workflow-card';
 export type { WorkflowCardProps } from './workflow-card';
 export { WorkflowEditor } from './workflow-editor';
-export type { WorkflowEditorProps } from './workflow-editor';
+export type { WorkflowEditorProps, WorkflowEditorHandle, } from './workflow-editor';
+export { workflowCardAgent, workflowMapAgent, workflowEditorAgent, } from './workflow.agent';
 export { WorkflowMap } from './workflow-map';
 export type { WorkflowMapProps } from './workflow-map';
 export { workflowActionRegistry, addNodeAfter, removeNode, moveNode, linearOrder, CORE_PATIENT_FIELDS, isCorePatientField, } from './workflow-types';

package/dist/components/workflow/index.js

@@ -1,14 +1,17 @@
-import { C as r, W as e, a as s, b as d, c as i, i as l, l as t, m as f, r as w, w as k } from "../../_chunks/workflow-map-XeqHDFvp.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-D2A7rTEG.js";
 export {
   r as CORE_PATIENT_FIELDS,
   e as WorkflowCard,
   s as WorkflowEditor,
   d as WorkflowMap,
-  i as addNodeAfter,
-  l as isCorePatientField,
-  t as linearOrder,
-  f as moveNode,
-  w as removeNode,
-  k as workflowActionRegistry
+  w as addNodeAfter,
+  t as isCorePatientField,
+  f as linearOrder,
+  l as moveNode,
+  i as removeNode,
+  k as workflowActionRegistry,
+  n as workflowCardAgent,
+  A as workflowEditorAgent,
+  C as workflowMapAgent
 };
 //# sourceMappingURL=index.js.map

package/dist/components/workflow/workflow-editor.d.ts

@@ -1,4 +1,10 @@
 import { type EnrollmentCriteria, type WorkflowActionType, type WorkflowGraph } from './workflow-types';
+/** Curated imperative handle for agent / external automation. */
+export interface WorkflowEditorHandle {
+    getTotalSteps: () => number;
+    getCurrentStep: () => string | null;
+    gotoStep: (id: string) => void;
+}
 export interface WorkflowEditorProps {
     /** DAG-shaped graph. v1 renders the linear chain via `linearOrder`. */
     graph: WorkflowGraph;
@@ -25,5 +31,5 @@ export interface WorkflowEditorProps {
     onDeleteNode?: (nodeId: string) => void;
     className?: string;
 }
-export declare const WorkflowEditor: import("react").ForwardRefExoticComponent<WorkflowEditorProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const WorkflowEditor: import("react").ForwardRefExoticComponent<WorkflowEditorProps & import("react").RefAttributes<WorkflowEditorHandle>>;
 //# sourceMappingURL=workflow-editor.d.ts.map

package/dist/components/workflow/workflow-map.d.ts

@@ -5,6 +5,8 @@ declare const rootVariants: (props?: ({
     compact?: boolean | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface WorkflowMapProps extends VariantProps<typeof rootVariants> {
+    /** Instance id surfaced as `data-component-id` on the root. */
+    id?: string;
     /** Workflow graph (DAG-shaped, linear in v1). */
     graph: WorkflowGraph;
     /** Id of the currently active step. When unset, the map is structural. */

package/dist/components/workflow/workflow.agent.d.ts

@@ -0,0 +1,6 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { WorkflowEditorHandle } from './workflow-editor';
+export declare const workflowCardAgent: AgentAdapter;
+export declare const workflowMapAgent: AgentAdapter;
+export declare const workflowEditorAgent: AgentAdapter<WorkflowEditorHandle>;
+//# sourceMappingURL=workflow.agent.d.ts.map

package/dist/i18n/config.js

@@ -1,7 +1,7 @@
 import n from "i18next";
 import { default as m } from "i18next";
 import { initReactI18next as i } from "react-i18next";
-const t = {
+const e = {
   common: {
     save: "Save",
     cancel: "Cancel",
@@ -29,6 +29,9 @@ const t = {
     resultsLabel: "Search results",
     noResults: "No results for “{{query}}”"
   },
+  link: {
+    opensInNewTab: "Opens in a new tab"
+  },
   inputs: {
     switch: {
       on: "On",
@@ -40,6 +43,10 @@ const t = {
     text: {
       clear: "Clear input"
     },
+    recaptcha: {
+      expired: "Verification expired — please retry.",
+      error: "Verification failed — please retry."
+    },
     search: {
       clear: "Clear search",
       loading: "Searching…",
@@ -2785,36 +2792,42 @@ const t = {
     accountPage: "Kontoseite",
     signOut: "Abmelden"
   }
-}, a = {}, u = ["en", "it", "de", "ar"], d = {
-  en: t,
+}, t = {}, u = ["en", "it", "de", "ar"], d = {
+  en: e,
   it: o,
   de: r,
-  ar: a
-}, s = {}, e = typeof import.meta < "u" && typeof s < "u" && !1;
+  ar: t
+}, s = {}, a = typeof import.meta < "u" && typeof s < "u" && !1;
 n.use(i).init({
   lng: "en",
   fallbackLng: "en",
   ns: ["ui"],
   defaultNS: "ui",
-  debug: e,
-  saveMissing: e,
+  debug: a,
+  saveMissing: a,
   missingKeyHandler: void 0,
   interpolation: {
     escapeValue: !1
   },
+  // Component code is split between two key conventions — `t('common.save')`
+  // (bare) and `t('ui.common.save')` (namespaced). i18next's defaultNS
+  // resolution handles the bare form natively, but for the namespaced form
+  // it would otherwise look up `enUi.ui.common.save`, which doesn't exist.
+  // We mirror the bundle under a `ui` sub-key so both call sites resolve
+  // to the same strings rather than rendering the raw key.
   resources: {
-    en: { ui: t },
+    en: { ui: { ...e, ui: e } },
     // Minimal Arabic locale — provides RTL direction detection via i18n.dir('ar').
     // Full translation bundle belongs in a separate locale file; this entry ensures
     // changeLanguage('ar') resolves without a 404 and direction returns 'rtl'.
-    ar: { ui: a }
+    ar: { ui: { ...t, ui: t } }
   }
 });
 export {
   u as LOCALES_WITH_BUNDLES,
-  a as arUi,
+  t as arUi,
   m as default,
-  t as enUi,
+  e as enUi,
   d as uiResources
 };
 //# sourceMappingURL=config.js.map

package/dist/i18n/resources.d.ts

@@ -27,6 +27,9 @@ export declare const enUi: {
         readonly resultsLabel: "Search results";
         readonly noResults: "No results for “{{query}}”";
     };
+    readonly link: {
+        readonly opensInNewTab: "Opens in a new tab";
+    };
     readonly inputs: {
         readonly switch: {
             readonly on: "On";
@@ -38,6 +41,10 @@ export declare const enUi: {
         readonly text: {
             readonly clear: "Clear input";
         };
+        readonly recaptcha: {
+            readonly expired: "Verification expired — please retry.";
+            readonly error: "Verification failed — please retry.";
+        };
         readonly search: {
             readonly clear: "Clear search";
             readonly loading: "Searching…";