@mieweb/ui 0.10.0-dev.11 → 0.10.0-dev.13

package/dist/datavis.d.cts

@@ -1,7 +1,6 @@
-import * as React$1 from 'react';
-import React__default from 'react';
+import * as react from 'react';
+import react__default from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PatientHistory, a as ProgramsMap, O as OrderRow } from './orderRows-BUJYgSc7.cjs';
 
 /**
  * EventBridge — Adapts the wcdatavis `mixinEventHandling` pub/sub pattern
@@ -345,7 +344,7 @@ interface TableFeatures {
     rowMode?: 'wrapped' | 'clipped';
 }
 /** Cell formatter function — returns React node */
-type CellFormatter = (value: unknown, row: RowData, column: TableColumn) => React__default.ReactNode;
+type CellFormatter = (value: unknown, row: RowData, column: TableColumn) => react__default.ReactNode;
 
 /**
  * OperationsPalette — Inline toolbar of action buttons for row-level operations.
@@ -359,7 +358,7 @@ interface Operation {
     /** Display label */
     label?: string;
     /** Optional icon element */
-    icon?: React__default.ReactNode;
+    icon?: react__default.ReactNode;
     /** Category for grouping */
     category?: string;
     /** Callback invoked when the operation is triggered */
@@ -369,7 +368,7 @@ interface OperationContext {
     /** Currently selected rows */
     rows: unknown[];
     /** The button element (for positioning popovers, etc.) */
-    buttonRef?: React__default.RefObject<HTMLButtonElement>;
+    buttonRef?: react__default.RefObject<HTMLButtonElement>;
 }
 
 /**
@@ -627,7 +626,7 @@ interface DataVisNitroAggregate {
     fields: string[];
 }
 interface DataVisNitroSourceConfigurationProps {
-    children?: React__default.ReactNode;
+    children?: react__default.ReactNode;
     groupBy?: Array<string | DataVisNitroGroupField>;
     aggregates?: DataVisNitroAggregate[];
 }
@@ -648,15 +647,15 @@ interface DataVisNitroGridProps extends Omit<DataGridProps, 'view' | 'children'
     columns?: DataVisNitroColumn[];
     allColumns?: TableColumn[];
     features?: TableFeatures;
-    style?: React__default.CSSProperties;
+    style?: react__default.CSSProperties;
     trans?: TranslateFn;
 }
-declare const DataVisNitroContext: React__default.Context<ViewInstance | null>;
-declare function DataVisNitroSource(props: DataVisNitroSourceProps): React__default.JSX.Element;
+declare const DataVisNitroContext: react__default.Context<ViewInstance | null>;
+declare function DataVisNitroSource(props: DataVisNitroSourceProps): react__default.JSX.Element;
 declare namespace DataVisNitroSource {
     var displayName: string;
 }
-declare function DataVisNitroGrid(props: DataVisNitroGridProps): React__default.JSX.Element | null;
+declare function DataVisNitroGrid(props: DataVisNitroGridProps): react__default.JSX.Element | null;
 declare namespace DataVisNitroGrid {
     var displayName: string;
 }
@@ -669,7 +668,7 @@ interface DataVisNitroGraphProps {
     height?: string;
     onConfigChange?: (config: GraphConfig) => void;
 }
-declare function DataVisNitroGraph(props: DataVisNitroGraphProps): React$1.JSX.Element | null;
+declare function DataVisNitroGraph(props: DataVisNitroGraphProps): react.JSX.Element | null;
 declare namespace DataVisNitroGraph {
     var displayName: string;
 }
@@ -682,7 +681,162 @@ interface LanguageSelectorProps {
     /** Extra CSS class. */
     className?: string;
 }
-declare function LanguageSelector({ value, onLanguageChange, className, }: LanguageSelectorProps): React$1.JSX.Element;
+declare function LanguageSelector({ value, onLanguageChange, className, }: LanguageSelectorProps): react.JSX.Element;
+
+/**
+ * Patient history — the minimal longitudinal facts the health-surveillance
+ * due engine needs: who the patient is (age, sex) and what has been done or
+ * is in flight (orders with status, observations, procedures, immunizations),
+ * plus problem-list context (conditions) and allergies for display/interop.
+ *
+ * All clinical entries are keyed by `CODETYPE|FULLCODE` — the same keys used
+ * by programs.json order sets and the codify shards — so the due engine can
+ * match history against a program's satisfying orders with plain string
+ * equality.
+ */
+/** ISO date string (YYYY-MM-DD or full ISO timestamp). */
+type IsoDate = string;
+interface HistoryOrder {
+    /** CODETYPE|FULLCODE, e.g. "Quest Order|3058" or "HCPCS|92551" */
+    key: string;
+    /** Display label (optional; the due list falls back to the key) */
+    label?: string;
+    status: 'completed' | 'pending';
+    /** Completion date for completed orders; order date for pending ones */
+    date: IsoDate;
+    /** Ordering/performing provider display name (e.g. "Dr. Patel") */
+    provider?: string;
+    /** Requisition the order was bundled into — the document routing a batch
+     * of encounter orders to a provider/referral (e.g. "REQ-2024-0117") */
+    requisitionId?: string;
+    /** Encounter (visit) the order was placed in (e.g. "ENC-2024-0117") */
+    encounterId?: string;
+}
+interface HistoryObservation {
+    /** CODETYPE|FULLCODE, e.g. "LOINC|4548-4" (HbA1c) */
+    key: string;
+    label?: string;
+    /** Display value with units, e.g. "7.2 %" or "38 ug/dL" */
+    value?: string;
+    date: IsoDate;
+}
+interface HistoryProcedure {
+    key: string;
+    label?: string;
+    date: IsoDate;
+}
+interface HistoryImmunization {
+    /** CODETYPE|FULLCODE, e.g. "CVX|88" */
+    key: string;
+    label?: string;
+    date: IsoDate;
+}
+interface HistoryCondition {
+    key: string;
+    label?: string;
+    onset?: IsoDate;
+}
+interface HistoryAllergy {
+    /** Allergen key when coded (e.g. "RxNORM|7980"), else omit */
+    key?: string;
+    label: string;
+    reaction?: string;
+    severity?: 'mild' | 'moderate' | 'severe';
+}
+interface HistoryMedication {
+    key?: string;
+    label: string;
+    /** Sig / dose display, e.g. "10 mg daily" */
+    detail?: string;
+}
+interface PatientHistory {
+    /** Age in years */
+    age: number;
+    sex: 'M' | 'F';
+    /** Past + in-flight orders (completion drives the due engine) */
+    orders: HistoryOrder[];
+    observations?: HistoryObservation[];
+    procedures?: HistoryProcedure[];
+    immunizations?: HistoryImmunization[];
+    conditions?: HistoryCondition[];
+    allergies?: HistoryAllergy[];
+    medications?: HistoryMedication[];
+}
+
+/**
+ * Due-evaluation engine — the "knowledge" layer of health surveillance.
+ * Given a patient's history and the program metadata (programs.json from
+ * mieweb/codify, or a deployment's own), decides which programs/measures are
+ * due, overdue, pending, or satisfied. Pure functions, no I/O — the metadata
+ * is small, so this runs on the main thread.
+ */
+
+/**
+ * One entry in a program's order set:
+ * - `"CODETYPE|FULLCODE"` — a plain required order
+ * - `{ alt: [a, b] }` — mutually exclusive alternatives (one-of): a
+ *   colonoscopy OR a FIT satisfies colorectal screening
+ * - `{ key, after: […] }` — depends on completed prerequisites (Gantt edge):
+ *   the RMO's fitness-for-duty determination needs the panel results first,
+ *   and a program may carry several determinations (per panel / per SEG)
+ */
+type ProgramOrder = string | {
+    key?: string;
+    alt?: string[];
+    after?: string[];
+};
+/** Program metadata — mirrors programs.json (see mieweb/codify). */
+interface ProgramMeta {
+    kind?: 'surveillance' | 'fitness' | 'credential' | 'quality';
+    /** Omitted = one-time / event-driven (satisfied forever once done) */
+    periodicityMonths?: number;
+    ageMin?: number;
+    ageMax?: number;
+    sex?: 'M' | 'F';
+    /** Satisfying orders — plain keys, one-of alternatives, or dependent
+     * entries (see ProgramOrder) */
+    orders?: ProgramOrder[];
+}
+type ProgramsMap = Record<string, ProgramMeta>;
+
+/**
+ * Order-row builders — flatten the order history and the due-evaluation
+ * output into grid-friendly rows (one row per encounter order) for the
+ * NITRO-backed ChartOrdersGrid / EncounterOrdersGrid.
+ *
+ * Pure functions, no I/O. Every field is a flat string so the DataVis engine
+ * can group/filter/aggregate on any of them (reason, provider, requisition,
+ * status, kind, date).
+ */
+
+/** Per-order status — finer grained than the program-level DueStatus. */
+type OrderRowStatus = 'completed' | 'pending' | 'available' | 'blocked';
+/** One encounter order as a flat grid row. */
+interface OrderRow {
+    /** CODETYPE|FULLCODE of the order */
+    orderKey: string;
+    /** Order display label */
+    order: string;
+    /** Reason/concern — the surveillance program or quality measure label */
+    reason: string;
+    /** Program key (CODETYPE|FULLCODE); '' when no program matches */
+    reasonKey: string;
+    /** Program kind label ('surveillance', 'quality measure', …) */
+    kind: string;
+    status: OrderRowStatus;
+    /** Completion date (completed) or order date (pending); '' otherwise */
+    date: string;
+    /** Program due date, when known */
+    dueDate: string;
+    /** Ordering/performing provider; '' when unknown */
+    provider: string;
+    /** Requisition the order is bundled into; '' = unprocessed */
+    requisitionId: string;
+    /** Encounter the order was placed in; '' for not-yet-placed rows */
+    encounterId: string;
+    /** Unmet prerequisite labels, comma-joined ('' when unblocked) */
+    blockedBy: string;
+}
 
 interface OrdersGridBaseProps {
     history: PatientHistory;

package/dist/datavis.d.ts

@@ -1,7 +1,6 @@
-import * as React$1 from 'react';
-import React__default from 'react';
+import * as react from 'react';
+import react__default from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { P as PatientHistory, a as ProgramsMap, O as OrderRow } from './orderRows-BUJYgSc7.js';
 
 /**
  * EventBridge — Adapts the wcdatavis `mixinEventHandling` pub/sub pattern
@@ -345,7 +344,7 @@ interface TableFeatures {
     rowMode?: 'wrapped' | 'clipped';
 }
 /** Cell formatter function — returns React node */
-type CellFormatter = (value: unknown, row: RowData, column: TableColumn) => React__default.ReactNode;
+type CellFormatter = (value: unknown, row: RowData, column: TableColumn) => react__default.ReactNode;
 
 /**
  * OperationsPalette — Inline toolbar of action buttons for row-level operations.
@@ -359,7 +358,7 @@ interface Operation {
     /** Display label */
     label?: string;
     /** Optional icon element */
-    icon?: React__default.ReactNode;
+    icon?: react__default.ReactNode;
     /** Category for grouping */
     category?: string;
     /** Callback invoked when the operation is triggered */
@@ -369,7 +368,7 @@ interface OperationContext {
     /** Currently selected rows */
     rows: unknown[];
     /** The button element (for positioning popovers, etc.) */
-    buttonRef?: React__default.RefObject<HTMLButtonElement>;
+    buttonRef?: react__default.RefObject<HTMLButtonElement>;
 }
 
 /**
@@ -627,7 +626,7 @@ interface DataVisNitroAggregate {
     fields: string[];
 }
 interface DataVisNitroSourceConfigurationProps {
-    children?: React__default.ReactNode;
+    children?: react__default.ReactNode;
     groupBy?: Array<string | DataVisNitroGroupField>;
     aggregates?: DataVisNitroAggregate[];
 }
@@ -648,15 +647,15 @@ interface DataVisNitroGridProps extends Omit<DataGridProps, 'view' | 'children'
     columns?: DataVisNitroColumn[];
     allColumns?: TableColumn[];
     features?: TableFeatures;
-    style?: React__default.CSSProperties;
+    style?: react__default.CSSProperties;
     trans?: TranslateFn;
 }
-declare const DataVisNitroContext: React__default.Context<ViewInstance | null>;
-declare function DataVisNitroSource(props: DataVisNitroSourceProps): React__default.JSX.Element;
+declare const DataVisNitroContext: react__default.Context<ViewInstance | null>;
+declare function DataVisNitroSource(props: DataVisNitroSourceProps): react__default.JSX.Element;
 declare namespace DataVisNitroSource {
     var displayName: string;
 }
-declare function DataVisNitroGrid(props: DataVisNitroGridProps): React__default.JSX.Element | null;
+declare function DataVisNitroGrid(props: DataVisNitroGridProps): react__default.JSX.Element | null;
 declare namespace DataVisNitroGrid {
     var displayName: string;
 }
@@ -669,7 +668,7 @@ interface DataVisNitroGraphProps {
     height?: string;
     onConfigChange?: (config: GraphConfig) => void;
 }
-declare function DataVisNitroGraph(props: DataVisNitroGraphProps): React$1.JSX.Element | null;
+declare function DataVisNitroGraph(props: DataVisNitroGraphProps): react.JSX.Element | null;
 declare namespace DataVisNitroGraph {
     var displayName: string;
 }
@@ -682,7 +681,162 @@ interface LanguageSelectorProps {
     /** Extra CSS class. */
     className?: string;
 }
-declare function LanguageSelector({ value, onLanguageChange, className, }: LanguageSelectorProps): React$1.JSX.Element;
+declare function LanguageSelector({ value, onLanguageChange, className, }: LanguageSelectorProps): react.JSX.Element;
+
+/**
+ * Patient history — the minimal longitudinal facts the health-surveillance
+ * due engine needs: who the patient is (age, sex) and what has been done or
+ * is in flight (orders with status, observations, procedures, immunizations),
+ * plus problem-list context (conditions) and allergies for display/interop.
+ *
+ * All clinical entries are keyed by `CODETYPE|FULLCODE` — the same keys used
+ * by programs.json order sets and the codify shards — so the due engine can
+ * match history against a program's satisfying orders with plain string
+ * equality.
+ */
+/** ISO date string (YYYY-MM-DD or full ISO timestamp). */
+type IsoDate = string;
+interface HistoryOrder {
+    /** CODETYPE|FULLCODE, e.g. "Quest Order|3058" or "HCPCS|92551" */
+    key: string;
+    /** Display label (optional; the due list falls back to the key) */
+    label?: string;
+    status: 'completed' | 'pending';
+    /** Completion date for completed orders; order date for pending ones */
+    date: IsoDate;
+    /** Ordering/performing provider display name (e.g. "Dr. Patel") */
+    provider?: string;
+    /** Requisition the order was bundled into — the document routing a batch
+     * of encounter orders to a provider/referral (e.g. "REQ-2024-0117") */
+    requisitionId?: string;
+    /** Encounter (visit) the order was placed in (e.g. "ENC-2024-0117") */
+    encounterId?: string;
+}
+interface HistoryObservation {
+    /** CODETYPE|FULLCODE, e.g. "LOINC|4548-4" (HbA1c) */
+    key: string;
+    label?: string;
+    /** Display value with units, e.g. "7.2 %" or "38 ug/dL" */
+    value?: string;
+    date: IsoDate;
+}
+interface HistoryProcedure {
+    key: string;
+    label?: string;
+    date: IsoDate;
+}
+interface HistoryImmunization {
+    /** CODETYPE|FULLCODE, e.g. "CVX|88" */
+    key: string;
+    label?: string;
+    date: IsoDate;
+}
+interface HistoryCondition {
+    key: string;
+    label?: string;
+    onset?: IsoDate;
+}
+interface HistoryAllergy {
+    /** Allergen key when coded (e.g. "RxNORM|7980"), else omit */
+    key?: string;
+    label: string;
+    reaction?: string;
+    severity?: 'mild' | 'moderate' | 'severe';
+}
+interface HistoryMedication {
+    key?: string;
+    label: string;
+    /** Sig / dose display, e.g. "10 mg daily" */
+    detail?: string;
+}
+interface PatientHistory {
+    /** Age in years */
+    age: number;
+    sex: 'M' | 'F';
+    /** Past + in-flight orders (completion drives the due engine) */
+    orders: HistoryOrder[];
+    observations?: HistoryObservation[];
+    procedures?: HistoryProcedure[];
+    immunizations?: HistoryImmunization[];
+    conditions?: HistoryCondition[];
+    allergies?: HistoryAllergy[];
+    medications?: HistoryMedication[];
+}
+
+/**
+ * Due-evaluation engine — the "knowledge" layer of health surveillance.
+ * Given a patient's history and the program metadata (programs.json from
+ * mieweb/codify, or a deployment's own), decides which programs/measures are
+ * due, overdue, pending, or satisfied. Pure functions, no I/O — the metadata
+ * is small, so this runs on the main thread.
+ */
+
+/**
+ * One entry in a program's order set:
+ * - `"CODETYPE|FULLCODE"` — a plain required order
+ * - `{ alt: [a, b] }` — mutually exclusive alternatives (one-of): a
+ *   colonoscopy OR a FIT satisfies colorectal screening
+ * - `{ key, after: […] }` — depends on completed prerequisites (Gantt edge):
+ *   the RMO's fitness-for-duty determination needs the panel results first,
+ *   and a program may carry several determinations (per panel / per SEG)
+ */
+type ProgramOrder = string | {
+    key?: string;
+    alt?: string[];
+    after?: string[];
+};
+/** Program metadata — mirrors programs.json (see mieweb/codify). */
+interface ProgramMeta {
+    kind?: 'surveillance' | 'fitness' | 'credential' | 'quality';
+    /** Omitted = one-time / event-driven (satisfied forever once done) */
+    periodicityMonths?: number;
+    ageMin?: number;
+    ageMax?: number;
+    sex?: 'M' | 'F';
+    /** Satisfying orders — plain keys, one-of alternatives, or dependent
+     * entries (see ProgramOrder) */
+    orders?: ProgramOrder[];
+}
+type ProgramsMap = Record<string, ProgramMeta>;
+
+/**
+ * Order-row builders — flatten the order history and the due-evaluation
+ * output into grid-friendly rows (one row per encounter order) for the
+ * NITRO-backed ChartOrdersGrid / EncounterOrdersGrid.
+ *
+ * Pure functions, no I/O. Every field is a flat string so the DataVis engine
+ * can group/filter/aggregate on any of them (reason, provider, requisition,
+ * status, kind, date).
+ */
+
+/** Per-order status — finer grained than the program-level DueStatus. */
+type OrderRowStatus = 'completed' | 'pending' | 'available' | 'blocked';
+/** One encounter order as a flat grid row. */
+interface OrderRow {
+    /** CODETYPE|FULLCODE of the order */
+    orderKey: string;
+    /** Order display label */
+    order: string;
+    /** Reason/concern — the surveillance program or quality measure label */
+    reason: string;
+    /** Program key (CODETYPE|FULLCODE); '' when no program matches */
+    reasonKey: string;
+    /** Program kind label ('surveillance', 'quality measure', …) */
+    kind: string;
+    status: OrderRowStatus;
+    /** Completion date (completed) or order date (pending); '' otherwise */
+    date: string;
+    /** Program due date, when known */
+    dueDate: string;
+    /** Ordering/performing provider; '' when unknown */
+    provider: string;
+    /** Requisition the order is bundled into; '' = unprocessed */
+    requisitionId: string;
+    /** Encounter the order was placed in; '' for not-yet-placed rows */
+    encounterId: string;
+    /** Unmet prerequisite labels, comma-joined ('' when unblocked) */
+    blockedBy: string;
+}
 
 interface OrdersGridBaseProps {
     history: PatientHistory;

package/dist/esheet.d.cts

@@ -3,7 +3,143 @@ export { FormDefinition } from '@esheet/core';
 export { EsheetBuilder, EsheetBuilderProps } from '@esheet/builder';
 export { EsheetRenderer, EsheetRendererHandle, EsheetRendererProps } from '@esheet/renderer';
 import * as React from 'react';
-import { C as CodeLookupConfig, M as Medication, A as Allergy } from './MedicationEditor-Bp4NLy7y.cjs';
+
+/** Reconciliation status of a medication. */
+type MedicationStatus = 'unreconciled' | 'taking' | 'taking-noncompliant' | 'not-taking' | 'unknown';
+/** Coding-system reference for a medication (RxNorm / FDB / NDC …). */
+interface MedicationCode {
+    /** Coding system, e.g. 'RxNORM', 'FDB', 'NDC' */
+    system: string;
+    /** Code within the system */
+    code: string;
+    /** Human-readable label the code was selected under */
+    display?: string;
+}
+/**
+ * A single medication in the presenting-medications list.
+ *
+ * Prescription-detail fields follow the NCPDP SCRIPT NewRx
+ * `MedicationPrescribed` composite — see the README for the field mapping.
+ * All are optional: a bare `{ id, name, status }` renders fine.
+ */
+interface Medication {
+    /** Stable unique id */
+    id: string;
+    /** Display name, e.g. "lisinopril 10 mg tablet" (NCPDP DrugDescription) */
+    name: string;
+    /** Patient-friendly instructions (NCPDP Sig / Directions) */
+    sig?: string;
+    /** Current reconciliation status */
+    status: MedicationStatus;
+    /** Whether the medication's end date has passed */
+    expired?: boolean;
+    /** Discontinued date (display string) — shown as "Discontinued on: date" */
+    discontinuedDate?: string;
+    /** Free-text note attached to the medication */
+    note?: string;
+    /** Follow-up task attached to the medication */
+    task?: string;
+    /** Code reference (RxNorm / FDB / NDC) */
+    code?: MedicationCode;
+    /** Strength, e.g. "10 mg" (Strength + StrengthUnitOfMeasure) */
+    strength?: string;
+    /** Dose form, e.g. "tablet" (DrugCoded/FormCode) */
+    doseForm?: string;
+    /** Quantity dispensed (Quantity/Value) */
+    quantity?: string;
+    /** Quantity unit of measure (Quantity/QuantityUnitOfMeasure) */
+    quantityUnit?: string;
+    /** Days supply (DaysSupply) */
+    daysSupply?: string;
+    /** Route of administration, e.g. "oral" */
+    route?: string;
+    /** Administration frequency, e.g. "Twice daily" */
+    frequency?: string;
+    /** As-needed flag (PRN) */
+    prn?: boolean;
+    /** Number of refills (NumberOfRefills) */
+    refills?: string;
+    /** Substitution / DAW: '0' permitted, '1' dispense as written */
+    substitution?: '0' | '1';
+    /** Start / written date (ISO yyyy-mm-dd) */
+    startDate?: string;
+    /** End date (ISO yyyy-mm-dd) */
+    endDate?: string;
+    /** Indication / diagnosis the medication treats */
+    indication?: string;
+    /** Note to pharmacy (Note) */
+    pharmacyNotes?: string;
+}
+
+/**
+ * MedicationEditor — prescription editor modal for a `Medication`.
+ *
+ * Captures the NCPDP SCRIPT NewRx `MedicationPrescribed` field set and codes
+ * the drug via `CodeLookup` (RxNorm / FDB, offline). Used by
+ * `MedicationReconciliation` for both **Correct** (edit) and **Add
+ * Medication**, and usable directly:
+ *
+ * ```tsx
+ * <MedicationEditor
+ *   open={editing !== null}
+ *   medication={editing ?? undefined}
+ *   codeLookup={{ indexUrl: '/codify' }}
+ *   onClose={() => setEditing(null)}
+ *   onSave={(med) => upsert(med)}
+ * />
+ * ```
+ *
+ * NCPDP mapping (NewRx / MedicationPrescribed):
+ *
+ * | Editor field   | NCPDP element                          |
+ * |----------------|----------------------------------------|
+ * | Medication     | DrugDescription                        |
+ * | Code           | DrugCoded (ProductCode / DrugDBCode)   |
+ * | Strength       | Strength + StrengthUnitOfMeasure       |
+ * | Dose form      | DrugCoded/FormCode                     |
+ * | Quantity       | Quantity/Value                         |
+ * | Quantity unit  | Quantity/QuantityUnitOfMeasure         |
+ * | Days supply    | DaysSupply                             |
+ * | Directions     | Sig/SigText                            |
+ * | Refills        | NumberOfRefills                        |
+ * | Substitution   | Substitutions (0 permitted / 1 DAW)    |
+ * | Start date     | WrittenDate / EffectiveDate            |
+ * | Indication     | Diagnosis/Primary                      |
+ * | Pharmacy notes | Note                                   |
+ */
+
+/** Minimal shape of a CodeLookup selection the editor consumes. */
+interface MedicationLookupResult {
+    label: string;
+    codetype: string;
+    fullcode: string;
+}
+/**
+ * Structural subset of `CodeLookupProps` the editor uses. `CodeLookup`
+ * satisfies this — it is injected (not imported) because its Web Worker
+ * keeps it out of the library build (see CodeLookup/index.ts).
+ */
+interface MedicationLookupProps {
+    indexUrl: string;
+    locale?: string;
+    domains?: 'med'[];
+    bare?: boolean;
+    clearOnSelect?: boolean;
+    placeholder?: string;
+    initialQuery?: string;
+    initialSearch?: boolean;
+    onSelect?: (result: MedicationLookupResult) => void;
+    onFreeText?: (text: string) => void;
+}
+/** CodeLookup wiring for the editor (component injected by the consumer). */
+interface CodeLookupConfig {
+    /** The CodeLookup component: `import { CodeLookup } from '…/CodeLookup'` */
+    component: React.ComponentType<MedicationLookupProps>;
+    /** Base URL of the codify index, e.g. '/codify' */
+    indexUrl: string;
+    /** Shard locale (default 'en') */
+    locale?: string;
+}
 
 /**
  * MedicationListField — eSheet custom field wrapper around
@@ -51,6 +187,52 @@ declare function registerMedicationListFieldType(options?: {
     codeLookup?: CodeLookupConfig | false;
 }): void;
 
+/** Allergy category (FHIR AllergyIntolerance.category). */
+type AllergyType = 'drug' | 'food' | 'environmental' | 'other';
+/**
+ * Mechanism distinction (FHIR AllergyIntolerance.type): a true
+ * immune-mediated allergy vs a non-immune intolerance (e.g. GI upset).
+ * The distinction matters clinically — an intolerance mislabeled as an
+ * allergy causes unnecessary avoidance of first-line drugs.
+ */
+type AllergyKind = 'allergy' | 'intolerance';
+/** Reaction severity (FHIR reaction.severity). */
+type AllergySeverity = 'mild' | 'moderate' | 'severe';
+/** Coding-system reference for an allergen (RxNorm / FDB / SNOMED …). */
+interface AllergyCode {
+    system: string;
+    code: string;
+    display?: string;
+}
+/**
+ * A single allergy / intolerance.
+ *
+ * Loosely follows FHIR AllergyIntolerance: allergen (+ optional code),
+ * category, reaction, severity, onset, and clinical status.
+ */
+interface Allergy {
+    /** Stable unique id */
+    id: string;
+    /** Allergen display name, e.g. "penicillin" */
+    allergen: string;
+    /** Category — groups the list */
+    type?: AllergyType;
+    /** Allergy vs intolerance (FHIR AllergyIntolerance.type; default 'allergy') */
+    kind?: AllergyKind;
+    /** Reaction description, e.g. "hives" */
+    reaction?: string;
+    /** Reaction severity — drives the badge color */
+    severity?: AllergySeverity;
+    /** Onset date (display string) */
+    onsetDate?: string;
+    /** Free-text note */
+    note?: string;
+    /** Inactive/resolved entries render struck through */
+    inactive?: boolean;
+    /** Code reference (RxNorm/FDB for drugs, SNOMED otherwise) */
+    code?: AllergyCode;
+}
+
 /**
  * AllergyListField — eSheet custom field wrapper around AllergyManager.
  *