@alfadocs/ui-kit 1.3.13 → 1.4.1

package/dist/components/pregnancy-dating/pregnancy-dating.d.ts

@@ -1,6 +1,6 @@
 import { type VariantProps } from 'class-variance-authority';
 import { type InsertPayload, type InsertVariant, type InsertMode } from '../_shared/insert-result';
-import { type GestationalAge, type DueDateResult, type Plurality, type Chorionicity } from '../_shared/obstetrics';
+import { type EmbryoAge, type GestationalAge, type DueDateResult, type Plurality, type Chorionicity } from '../_shared/obstetrics';
 import { type AntenatalScheduleOptions, type GdmRisk } from '../_shared/antenatal-schedule';
 declare const rootVariants: (props?: ({
     width?: "auto" | "full" | null | undefined;
@@ -16,6 +16,70 @@ export interface PregnancyDatingResult {
     gestationalAge: GestationalAge | null;
     trimester: DueDateResult['trimester'];
 }
+/** The dating inputs as entered. */
+export interface PregnancyDatingInputsSnapshot {
+    /** Which anchor the pregnancy is dated from. */
+    method: DatingMethod;
+    /** The method's reference date (`yyyy-MM-dd`), or null when unset. */
+    referenceDate: string | null;
+    /** LMP only — average cycle length in days, or null for the 28-day default. */
+    cycleLength: number | null;
+    /** IVF only — embryo age at transfer, in days. */
+    embryoAge: EmbryoAge;
+    /** LMP only — crown-rump length in millimetres, or null. */
+    crlMm: number | null;
+    /** LMP only — date of the CRL scan (`yyyy-MM-dd`), or null. */
+    scanDate: string | null;
+    /** Manual ±days nudge applied to the dating, or null. */
+    datingAdjustment: number | null;
+    /** The date gestational age and trimester are evaluated against. */
+    asOfDate: string;
+}
+/** `PregnancyDatingResult` projected onto the agent boundary — ISO dates. */
+export interface PregnancyDatingSnapshot {
+    /** Estimated date of delivery, `yyyy-MM-dd`. */
+    dueDate: string;
+    /** GA day-0 anchor after any re-dating / adjustment, `yyyy-MM-dd`. */
+    gestationalStart: string;
+    /** Gestational age as of the evaluation date; null before conception. */
+    gestationalAge: {
+        weeks: number;
+        days: number;
+        totalDays: number;
+    } | null;
+    /** Trimester band as of the evaluation date. */
+    trimester: DueDateResult['trimester'];
+}
+/**
+ * Curated imperative handle for agent / external automation. Reads the dating
+ * inputs and the computed EDD + gestational age, and drives the inputs the way
+ * a user would. Never exposes patient identity — only structural dates and
+ * numbers. Consumed by `pregnancy-dating.agent.ts`; the public `ref` stays the
+ * root DOM element.
+ */
+export interface PregnancyDatingHandle {
+    /** The dating inputs as entered. */
+    getInputs: () => PregnancyDatingInputsSnapshot;
+    /** Computed due date, gestational age and trimester, or null until a reference date is set. */
+    getResult: () => PregnancyDatingSnapshot | null;
+    /** Switch the dating anchor. Keeps the reference date, which is re-interpreted. */
+    setMethod: (method: DatingMethod) => boolean;
+    /** Set the method's reference date (`yyyy-MM-dd`); only a known EDD may be in the future. */
+    setReferenceDate: (isoDate: string | null) => boolean;
+    /** LMP only — set the average cycle length in days (20–45). */
+    setCycleLength: (days: number | null) => boolean;
+    /** IVF only — set the embryo age at transfer (3 or 5 days). */
+    setEmbryoAge: (days: EmbryoAge) => boolean;
+    /** LMP only — set the CRL measurement and/or its scan date for ACOG re-dating. */
+    setCrl: (next: {
+        crlMm?: number | null;
+        scanDate?: string | null;
+    }) => boolean;
+    /** Set the manual ±days dating nudge (positive = further along). */
+    setDatingAdjustment: (days: number | null) => boolean;
+    /** Set the date gestational age and trimester are evaluated against. */
+    setAsOfDate: (isoDate: string) => boolean;
+}
 export interface PregnancyDatingProps extends VariantProps<typeof rootVariants> {
     /** Initial dating method. Defaults to `'lmp'`. */
     defaultMethod?: DatingMethod;

package/dist/components/pregnancy-weight-gain/index.d.ts

@@ -1,4 +1,5 @@
 export { PregnancyWeightGain } from './pregnancy-weight-gain';
-export type { PregnancyWeightGainProps } from './pregnancy-weight-gain';
+export type { PregnancyWeightGainProps, PregnancyWeightGainHandle, PregnancyWeightGainInputs, } from './pregnancy-weight-gain';
+export { pregnancyWeightGainAgent } from './pregnancy-weight-gain.agent';
 export { assessWeightGain, recommendedGainToDate, TOTAL_GAIN_BANDS, RATE_BANDS, type GainBand, type GainStatus, type WeightGainInput, type WeightGainResult, } from './weight-gain';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/pregnancy-weight-gain/index.js

@@ -1,9 +1,10 @@
-import { P as s, R as n, T as i, a as r, r as A } from "../../_chunks/pregnancy-weight-gain-O6J0sUIi.js";
+import { P as n, R as s, T as i, a as g, p as r, r as t } from "../../_chunks/pregnancy-weight-gain-B5KSJzdc.js";
 export {
-  s as PregnancyWeightGain,
-  n as RATE_BANDS,
+  n as PregnancyWeightGain,
+  s as RATE_BANDS,
   i as TOTAL_GAIN_BANDS,
-  r as assessWeightGain,
-  A as recommendedGainToDate
+  g as assessWeightGain,
+  r as pregnancyWeightGainAgent,
+  t as recommendedGainToDate
 };
 //# sourceMappingURL=index.js.map

package/dist/components/pregnancy-weight-gain/pregnancy-weight-gain.agent.d.ts

@@ -0,0 +1,4 @@
+import type { AgentAdapter } from '../../agent/types';
+import type { PregnancyWeightGainHandle } from './pregnancy-weight-gain';
+export declare const pregnancyWeightGainAgent: AgentAdapter<PregnancyWeightGainHandle>;
+//# sourceMappingURL=pregnancy-weight-gain.agent.d.ts.map

package/dist/components/pregnancy-weight-gain/pregnancy-weight-gain.d.ts

@@ -5,6 +5,41 @@ import { type WeightGainResult } from './weight-gain';
 declare const rootVariants: (props?: ({
     width?: "auto" | "full" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Canonical metric snapshot of the four inputs. Measurements only — the
+ * calculator is never handed a patient, so no identity can reach the agent.
+ */
+export interface PregnancyWeightGainInputs {
+    /** Height, cm. */
+    heightCm: number | null;
+    /** Pre-pregnancy weight, kg. */
+    prePregnancyKg: number | null;
+    /** Current weight, kg. */
+    currentKg: number | null;
+    /** Completed gestational weeks. */
+    gestationalWeeks: number | null;
+}
+/**
+ * Curated imperative handle for agent / external automation. Reads and writes
+ * the four measurements plus the plurality choice, and reads back the computed
+ * IOM assessment. Never exposes patient identity — the component only ever
+ * holds numbers. Consumed by the `pregnancy-weight-gain.agent.ts` adapter; the
+ * public `ref` stays the DOM element.
+ */
+export interface PregnancyWeightGainHandle {
+    /** Canonical metric snapshot of the four inputs. */
+    getInputs: () => PregnancyWeightGainInputs;
+    /** Set one or more inputs; omitted fields are left unchanged. */
+    setInputs: (next: Partial<PregnancyWeightGainInputs>) => void;
+    /** Number of babies the assessment is computed for. */
+    getPlurality: () => Plurality;
+    /** Switch the plurality (re-keys the IOM bands). */
+    setPlurality: (next: Plurality) => void;
+    /** Current computed assessment, or null until every input is valid. */
+    getResult: () => WeightGainResult | null;
+    /** Clear the four measurements (plurality is a setting and is kept). */
+    reset: () => void;
+}
 export interface PregnancyWeightGainProps extends VariantProps<typeof rootVariants> {
     /** Initial number of babies. Defaults to `'singleton'`. */
     defaultPlurality?: Plurality;

package/dist/components/progress/index.js

@@ -1,4 +1,4 @@
-import { P as e, p as o } from "../../_chunks/progress-DA413-zn.js";
+import { P as e, p as o } from "../../_chunks/progress-CK8otcQ-.js";
 export {
   e as Progress,
   o as progressAgent

package/dist/components/progress/progress.d.ts

@@ -1,6 +1,19 @@
 import { type HTMLAttributes, type ReactNode } from 'react';
 export interface ProgressHandle {
+    /**
+     * Paint a progress value straight onto the DOM, bypassing React. High-
+     * frequency escape hatch — the `value` prop is NOT updated, so read the
+     * painted figure back with `getValue()`, not from props.
+     */
     setValue: (value: number) => void;
+    /**
+     * What the bar currently SHOWS, in the same units as `value` / `max` —
+     * written by both the render path and `setValue`, so it stays defined after
+     * an imperative write. `null` while indeterminate.
+     */
+    getValue: () => number | null;
+    /** True when no measurable progress is set (`value` prop omitted). */
+    isIndeterminate: () => boolean;
 }
 export interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     value?: number;

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

@@ -1,4 +1,4 @@
-import { R as o, I as e, r as n } from "../../_chunks/radiograph-panel.agent-BQZ64Riy.js";
+import { R as o, I as e, r as n } from "../../_chunks/radiograph-panel.agent-CtFtNMzk.js";
 export {
   o as RadiographPanel,
   e as RadiographPanelIcon,

package/dist/components/rich-text-editor/index.js

@@ -1,4 +1,4 @@
-import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-CfeXPPWs.js";
+import { R as a, r as e, w as i } from "../../_chunks/rich-text-editor-BedTpWzL.js";
 export {
   a as RichTextEditor,
   e as richTextEditorAgent,

package/dist/components/session-countdown/index.js

@@ -1,4 +1,4 @@
-import { S as n, s as e } from "../../_chunks/session-countdown-Bc70VXN1.js";
+import { S as n, s as e } from "../../_chunks/session-countdown-BL-Psg8u.js";
 export {
   n as SessionCountdown,
   e as sessionCountdownAgent

package/dist/components/sign-document/index.js

@@ -1,4 +1,4 @@
-import { S as o, s } from "../../_chunks/sign-document-CW_ByDUh.js";
+import { S as o, s } from "../../_chunks/sign-document-jF4fZDJ5.js";
 export {
   o as SignDocument,
   s as signDocumentAgent

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

@@ -1,3 +1,4 @@
 export { SlotGrid, isSameDate, findFirstAvailable } from './slot-grid';
-export type { SlotGridProps, SlotGridSlot, SlotGridDay, SlotGridState, SlotGridSize, } from './slot-grid';
+export type { SlotGridProps, SlotGridSlot, SlotGridDay, SlotGridState, SlotGridSize, SlotGridHandle, } from './slot-grid';
+export { slotGridAgent } from './slot-grid.agent';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,7 +1,8 @@
-import { S as s, f as e, i as r } from "../../_chunks/slot-grid-CQSULZjd.js";
+import { S as i, f as t, i as e, s as r } from "../../_chunks/slot-grid-DNiUcXy2.js";
 export {
-  s as SlotGrid,
-  e as findFirstAvailable,
-  r as isSameDate
+  i as SlotGrid,
+  t as findFirstAvailable,
+  e as isSameDate,
+  r as slotGridAgent
 };
 //# sourceMappingURL=index.js.map

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

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

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

@@ -67,6 +67,40 @@ export interface SlotGridProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ari
     /** Fires when the user clicks the "Next available" CTA. */
     onJumpToNextAvailable?: () => void;
 }
+/**
+ * Imperative handle the agent adapter (`slot-grid.agent.ts`) reads and drives.
+ *
+ * It is NOT the `ref` — `ref` stays the outer `HTMLDivElement` so existing
+ * consumers are unaffected. The handle is built with `useMemo` and handed to
+ * `useAgentRegistration`, the same shape Autocomplete uses.
+ *
+ * Every getter returns identifiers and structural state only — availability
+ * slot ids, calendar day keys, booleans. Never patient data (PRS §26 §7).
+ */
+export interface SlotGridHandle {
+    /** Current visual / interactive state (`default` / `loading` / `disabled` / `empty`). */
+    getStatus: () => SlotGridState;
+    /** Controlled `selectedSlotId` prop, or `null` when nothing is selected. */
+    getSelectedSlotId: () => string | null;
+    /** Day keys (`yyyy-MM-dd`) of the currently-rendered columns, in order. */
+    getVisibleDays: () => string[];
+    /** Day key → ids of that day's AVAILABLE slots (collapsed ones included). */
+    getSlotsByDay: () => Record<string, string[]>;
+    /** Day keys whose "Show more" control has been used. */
+    getExpandedDays: () => string[];
+    /** Mirrors the `hasPrevious` prop — whether an earlier window exists. */
+    getHasPrevious: () => boolean;
+    /** Mirrors the `hasNext` prop — whether a later window exists. */
+    getHasNext: () => boolean;
+    /** Select an available slot by id. Returns `false` when it cannot be selected. */
+    selectSlot: (slotId: string) => boolean;
+    /** Page the window forward. Returns `false` when the arrow would be disabled. */
+    nextDays: () => boolean;
+    /** Page the window back. Returns `false` when the arrow would be disabled. */
+    previousDays: () => boolean;
+    /** Reveal a day's collapsed slots. Returns `false` when the day is not visible. */
+    showMoreDay: (dayKey: string) => boolean;
+}
 declare const slotGridVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;

package/dist/components/sparkline/index.js

@@ -1,4 +1,4 @@
-import { S as r, s, u as n } from "../../_chunks/sparkline-BTY4B5tv.js";
+import { S as r, s, u as n } from "../../_chunks/sparkline-BmGcEyZO.js";
 export {
   r as Sparkline,
   s as sparklineAgent,

package/dist/components/sparkline/sparkline.d.ts

@@ -13,6 +13,16 @@ export interface SparklineHandle {
      * annotation's band would. No-op when the sparkline is not selectable, or
      * when `id` names no currently drawn annotation. */
     selectAnnotation: (id: string) => void;
+    /** Ids of the annotations currently drawn — the only ids `selectAnnotation`
+     * will accept. Ids only: an annotation's `label` is human-readable and could
+     * name a clinical event, so it is never exposed. */
+    getAnnotationIds: () => string[];
+    /** True when the host wired `onAnnotationSelect`. False means every
+     * `selectAnnotation` call is a no-op. */
+    isSelectable: () => boolean;
+    /** Number of positions in the currently rendered series, gaps included.
+     * A count only — the plotted values are measurements and stay private. */
+    getPointCount: () => number;
 }
 /** Semantic tint for an annotation. Decorative reinforcement of `shape` —
  * never the only channel carrying which event this is. */

package/dist/components/tab-bar/index.js

@@ -1,4 +1,4 @@
-import { T as o } from "../../_chunks/tab-bar-Axhk6xzx.js";
+import { T as o } from "../../_chunks/tab-bar-BYESZINM.js";
 export {
   o as TabBar
 };

package/dist/components/tab-bar/tab-bar.d.ts

@@ -70,12 +70,25 @@ export interface TabBarRenderLinkProps {
     children: ReactNode;
     /** `'page'` on the active tab, otherwise omitted — forward to the link. */
     'aria-current'?: 'page';
+    /**
+     * The tab's stable `TabBarItem.id`, as the agent / automation DOM hook.
+     * Spread it onto your router link (`{...rest}`) so the tab stays addressable
+     * by `[data-tab-id]` the same way the kit's own `<a>` / `<button>` tabs are —
+     * see PRS §26 §6.
+     */
+    'data-tab-id'?: string;
     /** Optional per-item click handler (the item's `onClick`), if supplied. */
     onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
 }
 export interface TabBarProps {
     /** The tabs, in order. */
     items: TabBarItem[];
+    /**
+     * Opaque instance id, emitted on the strip as `data-component-id`. Pass it
+     * when more than one TabBar can be on screen so an agent / automation tool
+     * can scope its `[data-tab-id]` lookup to one bar (PRS §26 §6).
+     */
+    id?: string;
     /** Accessible name for the `<nav>` landmark. */
     ariaLabel: string;
     /** Fires with the tab `id` when a button tab (one without `href`) is chosen. */

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

@@ -1,5 +1,5 @@
 import { T as s, i as t } from "../../_chunks/task-card-BUgK6yZT.js";
-import { t as o } from "../../_chunks/task-card.agent-Bt14CzUd.js";
+import { t as o } from "../../_chunks/task-card.agent-CF2N_uu4.js";
 export {
   s as TaskCard,
   t as isSafeTaskUrl,

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-COgkN7YP.js";
+import { C as r, U as t, a as U, b as e, c as n } from "../../_chunks/unit-converter-CHPDuV7W.js";
 export {
   r as CATEGORIES,
   t as UNITS,

package/dist/components/warning-stack/index.js

@@ -1,4 +1,4 @@
-import { W as n } from "../../_chunks/warning-stack-BtjmJChC.js";
+import { W as n } from "../../_chunks/warning-stack-B7t_8jRE.js";
 export {
   n as WarningStack
 };