@mieweb/ui 0.6.1 → 0.7.0-dev.179

package/README.md

@@ -54,15 +54,7 @@ Heavy or specialized dependencies are kept in separate entry points so they don'
 | Entry point              | Install                                              | Import path              |
 | ------------------------ | ---------------------------------------------------- | ------------------------ |
 | **AG Grid**              | `npm install ag-grid-community ag-grid-react`        | `@mieweb/ui/ag-grid`    |
-| **DataVis**              | `npm install datavis-ace`                             | `@mieweb/ui/datavis`    |
-| **Ozwell AI Widget**     | `npm install @ozwell/react`                           | `@mieweb/ui/ozwell`     |
-
-```tsx
-// Example: Ozwell widget
-import { OzwellWidget } from '@mieweb/ui/ozwell';
-
-<OzwellWidget apiKey="agnt_key-your-key" />
-```
+| **DataVis**              | `npm install @mieweb/datavis datavis-ace`            | `@mieweb/ui/datavis`    |
 
 ## Quick Start
 
@@ -121,35 +113,73 @@ import { Button } from '@mieweb/ui';
 
 ### Getting Started
 
-1. **Clone the repository:**
+1. **Clone the repository (including submodules):**
 
 ```bash
-git clone https://github.com/mieweb/ui.git
+git clone --recurse-submodules https://github.com/mieweb/ui.git
 cd ui
 ```
 
+> `--recurse-submodules` is strongly recommended for first clone so the `packages/esheet` and `packages/ychart` submodules are populated immediately. Without them, the eSheet and YChart stories will not work. DataVis NITRO is not a submodule — it ships as the published `@mieweb/datavis` npm package.
+
+If you already cloned without submodules, run:
+
+```bash
+git submodule update --init --recursive
+```
+
 2. **Install dependencies:**
 
 ```bash
 npm install
 ```
 
-3. **Start development mode:**
+Use one package manager consistently per clone. The commands below use npm.
+
+3. **eSheet packages build automatically.** A `prestorybook` hook runs `npm run build:esheet` before Storybook starts, so the `@esheet/*` packages are compiled on first run with no manual step. It's a near-instant no-op on later runs once the artifacts exist.
+
+If `packages/esheet` is updated later (submodule update, branch switch, or pull) and you need to force a fresh rebuild, remove the built artifacts and run the build again:
+
+```bash
+rm -f packages/esheet/packages/core/dist/index.d.ts packages/esheet/packages/renderer/src/index.output.css
+npm run build:esheet
+```
+
+4. **Start Storybook:**
+
+```bash
+npm run storybook
+```
+
+This starts the Storybook development server at [http://localhost:6006](http://localhost:6006) with all components, including eSheet, DataVis NITRO, and YChart.
+
+### How the Sub-Packages Are Wired
+
+Storybook integrates three sibling MIE projects, each sourced differently:
+
+- **DataVis NITRO** — npm package `@mieweb/datavis`. No build step; consumed as a published package (no submodule needed).
+- **eSheet** — git submodule `packages/esheet`. Built automatically by the `prestorybook` hook; rebuilds only when its artifacts are missing.
+- **YChart** — git submodule `packages/ychart`. No build step; the story imports it directly from source via a relative dynamic import, and Storybook's Vite config adds a `virtual:git-info` plugin, a `__YCHART_VERSION__` define, and dependency pre-bundling (`optimizeDeps`).
+
+### Library Development (watch mode)
+
+To rebuild the library on file changes (for consumers that link this repo locally):
 
 ```bash
 npm run dev
 ```
 
-This will watch for changes and rebuild the library automatically.
+This watches for source changes and rebuilds automatically. It does **not** start Storybook.
 
 ### Available Scripts
 
-| Script                    | Description                         |
-| ------------------------- | ----------------------------------- |
-| `npm run dev`             | Start development mode with watch   |
-| `npm run build`           | Build the library for production    |
-| `npm run storybook`       | Start Storybook development server  |
-| `npm run build-storybook` | Build Storybook for static hosting  |
+| Script                    | Description                                               |
+| ------------------------- | --------------------------------------------------------- |
+| `npm run dev`             | Watch & rebuild the library (for local consumers, not Storybook) |
+| `npm run build:esheet`    | Build eSheet submodule packages (auto-run by `prestorybook`/`prebuild`; skips when already built) |
+| `npm run build`           | Build the library for production                          |
+| `npm run storybook`       | Start Storybook development server                        |
+| `npm run build-storybook` | Build Storybook for static hosting                        |
 | `npm run typecheck`       | Run TypeScript type checking        |
 | `npm run lint`            | Run ESLint                          |
 | `npm run lint:fix`        | Run ESLint with auto-fix            |
@@ -216,6 +246,26 @@ npm run build-storybook
 
 The output will be in the `storybook-static` directory.
 
+### Configuring the Ozwell API (AI stories)
+
+The AI stories (AIChat, Hands-Free Chat, and the DataVis NITRO **Ozwell Assistant**
+story) call the real Ozwell backend when a key is configured and fall back to a
+canned reply when it isn't. Set the key and endpoint from the browser console:
+
+```js
+// Recommended — survives reloads and is shared with the story iframe:
+localStorage.setItem(
+  'ozwellConfig',
+  JSON.stringify({ apiKey: 'YOUR_KEY', baseURL: 'https://your-ozwell-host' })
+);
+```
+
+`baseURL` is optional (defaults to `https://api.ozwell.ai`); other optional keys are
+`model`, `system`, and `temperature`. Never commit a key — see
+[src/components/AI/OZWELL-BACKEND.md](src/components/AI/OZWELL-BACKEND.md) for full
+details, including why `window.__ozwell` is unreliable inside Storybook iframes and
+how to proxy the key for public deploys.
+
 ## Using in Other Projects
 
 ### Method 1: NPM Package (Recommended)
@@ -701,40 +751,27 @@ We follow [Semantic Versioning](https://semver.org/):
 
 ## Contributing
 
-We welcome contributions! Here's how to get started:
-
-### Development Workflow
-
-1. **Fork and clone the repository**
-2. **Install dependencies:** `npm install`
-3. **Create a branch:** `git checkout -b feature/your-feature`
-4. **Start Storybook:** `npm run storybook`
-5. **Make your changes**
-6. **Run checks:**
-   ```bash
-   npm run typecheck  # TypeScript
-   npm run lint       # ESLint
-   npm run format     # Prettier
-   npm run test       # Tests
-   ```
-7. **Commit your changes** following [Conventional Commits](https://www.conventionalcommits.org/)
-8. **Push and create a Pull Request**
-
-### Adding a New Component
-
-1. Create a new directory in `src/components/YourComponent/`
-2. Add the component file: `YourComponent.tsx`
-3. Add the index export: `index.ts`
-4. Add Storybook stories: `YourComponent.stories.tsx`
-5. Export from `src/components/index.ts`
-6. Add to the README components list
-
-### Adding a New Brand
-
-1. Create `src/brands/your-brand.ts` with the `BrandConfig`
-2. Create `src/brands/your-brand.css` with CSS variables
-3. Export from `src/brands/index.ts`
-4. Add to the README brands table
+We welcome contributions! This README and the [Storybook](https://ui.mieweb.org)
+are the **consumer** docs (how to *use* the library). If you want to *build or
+change* the library itself, the **provider / maintainer** guide is
+**[CONTRIBUTING.md](CONTRIBUTING.md)** — it covers repo layout, the component
+anatomy and conventions, the autodocs story pattern, exports & tree-shaking,
+build, testing (unit + visual baselines), submodules, brands, and the release
+process.
+
+Quick start for contributors:
+
+```bash
+git clone --recurse-submodules https://github.com/mieweb/ui.git
+cd ui && pnpm install
+pnpm storybook            # http://localhost:6006
+# before opening a PR:
+pnpm typecheck && pnpm lint && pnpm format && pnpm test
+```
+
+Non-trivial modules also carry a `MAINTAINERS.md` next to the code with internals,
+invariants, and gotchas for that module — see the table in
+[CONTRIBUTING.md](CONTRIBUTING.md#per-component-maintainer-notes).
 
 ## License
 

package/dist/CsvBlock-2A5VEDD3.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkV25Z5GR6_cjs = require('./chunk-V25Z5GR6.cjs');
+require('./chunk-CKD554XR.cjs');
+require('./chunk-A2QVQF54.cjs');
+require('./chunk-OR5DRJCW.cjs');
+
+
+
+Object.defineProperty(exports, "CsvBlock", {
+  enumerable: true,
+  get: function () { return chunkV25Z5GR6_cjs.CsvBlock; }
+});
+//# sourceMappingURL=CsvBlock-2A5VEDD3.cjs.map
+//# sourceMappingURL=CsvBlock-2A5VEDD3.cjs.map

package/dist/CsvBlock-2A5VEDD3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"CsvBlock-2A5VEDD3.cjs"}

package/dist/CsvBlock-D6PWAJ5X.js

@@ -0,0 +1,6 @@
+export { CsvBlock } from './chunk-7WMSUXOQ.js';
+import './chunk-RHYIFIT5.js';
+import './chunk-ZVSW2KS6.js';
+import './chunk-F3SOEIN2.js';
+//# sourceMappingURL=CsvBlock-D6PWAJ5X.js.map
+//# sourceMappingURL=CsvBlock-D6PWAJ5X.js.map

package/dist/CsvBlock-D6PWAJ5X.js.map

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

package/dist/HtmlPreviewBlock-PEHTJ6C3.js

@@ -0,0 +1,6 @@
+export { HtmlPreviewBlock } from './chunk-UFYXU7KV.js';
+import './chunk-RHYIFIT5.js';
+import './chunk-ZVSW2KS6.js';
+import './chunk-F3SOEIN2.js';
+//# sourceMappingURL=HtmlPreviewBlock-PEHTJ6C3.js.map
+//# sourceMappingURL=HtmlPreviewBlock-PEHTJ6C3.js.map

package/dist/HtmlPreviewBlock-PEHTJ6C3.js.map

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

package/dist/HtmlPreviewBlock-SYXCV5RH.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkBB4WQ4LV_cjs = require('./chunk-BB4WQ4LV.cjs');
+require('./chunk-CKD554XR.cjs');
+require('./chunk-A2QVQF54.cjs');
+require('./chunk-OR5DRJCW.cjs');
+
+
+
+Object.defineProperty(exports, "HtmlPreviewBlock", {
+  enumerable: true,
+  get: function () { return chunkBB4WQ4LV_cjs.HtmlPreviewBlock; }
+});
+//# sourceMappingURL=HtmlPreviewBlock-SYXCV5RH.cjs.map
+//# sourceMappingURL=HtmlPreviewBlock-SYXCV5RH.cjs.map

package/dist/HtmlPreviewBlock-SYXCV5RH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"HtmlPreviewBlock-SYXCV5RH.cjs"}

package/dist/MedicationEditor-Bp4NLy7y.d.cts

@@ -0,0 +1,352 @@
+import * as React from 'react';
+
+/** 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;
+}
+/** Row actions revealed on hover. */
+type AllergyAction = 'correct' | 'note' | 'remove';
+interface AllergyListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'title'> {
+    /** Allergies to display (controlled) */
+    allergies: Allergy[];
+    /**
+     * No-known-allergies flag (NKA/NKDA). An empty list is ambiguous —
+     * "not asked" vs "asked, none" — so this is explicit tri-state:
+     * undefined = not recorded, true = no known allergies.
+     * Ignored when `allergies` is non-empty.
+     */
+    noKnownAllergies?: boolean;
+    /** Called when the no-known-allergies affordance is toggled */
+    onNoKnownAllergiesChange?: (value: boolean) => void;
+    /** Header title (pass null to hide) */
+    title?: string | null;
+    /** Row actions to show (default: all) */
+    actions?: AllergyAction[];
+    /** Called when a row action is clicked */
+    onAction?: (allergy: Allergy, action: AllergyAction) => void;
+    /**
+     * Called with the full new id order after a drag/keyboard reorder.
+     * Omit to disable reordering. Drops are restricted to the same
+     * category group.
+     */
+    onReorder?: (allergyIds: string[]) => void;
+    /** Custom add UI (e.g. an inline CodeLookup search) */
+    addSearch?: React.ReactNode;
+    /** Called when the "Add allergy" button is clicked (omit to hide) */
+    onAdd?: () => void;
+    /** Hide all action affordances (display only) */
+    readOnly?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+    /** Test ID for testing */
+    'data-testid'?: string;
+}
+declare const ALLERGY_TYPE_LABELS: Record<AllergyType, string>;
+/**
+ * Allergy / intolerance list — presentational layer.
+ *
+ * Controlled: allergies come in via props; every interaction is reported
+ * through callbacks. Entries group by category (Drug → Food →
+ * Environmental → Other); severity renders as a colored badge; hover (or
+ * keyboard-focus) a row for Correct / Notes / Remove.
+ *
+ * The empty state is explicit tri-state via `noKnownAllergies` (NKA):
+ * an empty list shows "Allergy status not recorded" until the No Known
+ * Allergies affordance is confirmed — an empty list must never silently
+ * read as "no allergies".
+ *
+ * Pair with `AllergyManager` for the batteries-included experience.
+ */
+declare const AllergyList: React.ForwardRefExoticComponent<AllergyListProps & React.RefAttributes<HTMLDivElement>>;
+
+/** 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;
+}
+/** Non-status row actions revealed on hover. */
+type MedicationAction = 'open' | 'correct' | 'refill' | 'add-task' | 'note' | 'remove' | 'move-up' | 'move-down';
+interface MedicationListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'title'> {
+    /** Medications to display (controlled — grouping is derived from status) */
+    medications: Medication[];
+    /** Header title (pass null to hide) */
+    title?: string | null;
+    /** Called when a status button is clicked on a row */
+    onStatusChange?: (medication: Medication, status: MedicationStatus) => void;
+    /** Called when a non-status row action is clicked */
+    onAction?: (medication: Medication, action: MedicationAction) => void;
+    /**
+     * Called with the full ordered list of medication ids after a drag —
+     * enables drag & drop reordering within a status group. The list renders in
+     * props order; persist the ids and feed them back in.
+     */
+    onReorder?: (medicationIds: string[]) => void;
+    /** Which non-status actions to show on each row (default: all) */
+    actions?: MedicationAction[];
+    /** Common medication names for the quick-add list (omit to hide) */
+    quickAddOptions?: string[];
+    /** Called when a quick-add option is clicked */
+    onQuickAdd?: (name: string) => void;
+    /** Called when "Other…" is clicked in the quick-add list */
+    onAddOther?: () => void;
+    /** Hide all action buttons (display only) */
+    readOnly?: boolean;
+    /** Message shown when the Unreconciled group is empty */
+    reconciledMessage?: string;
+    /** Message shown when the medication list has no entries at all */
+    emptyMessage?: string;
+    /**
+     * Custom add UI (e.g. an inline CodeLookup search) rendered in the
+     * add-medication section, before any quick-add pills. Use for
+     * patient-facing entry where suggested medications would be leading.
+     */
+    addSearch?: React.ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+    /** Test ID for testing */
+    'data-testid'?: string;
+}
+declare const MEDICATION_STATUS_LABELS: Record<MedicationStatus, string>;
+/**
+ * Presenting-medications list with medication reconciliation.
+ *
+ * Controlled component: medications (with their statuses) come in via props;
+ * every user interaction is reported through callbacks. Rows are grouped by
+ * reconciliation status; hovering (or keyboard-focusing) a row reveals the
+ * status buttons and other row actions.
+ *
+ * @example
+ * ```tsx
+ * <MedicationList
+ *   medications={meds}
+ *   onStatusChange={(med, status) =>
+ *     setMeds((prev) =>
+ *       prev.map((m) => (m.id === med.id ? { ...m, status } : m))
+ *     )
+ *   }
+ *   onAction={(med, action) => handleAction(med, action)}
+ * />
+ * ```
+ */
+declare const MedicationList: React.ForwardRefExoticComponent<MedicationListProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * 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;
+}
+interface MedicationEditorProps {
+    /** Whether the editor is open */
+    open: boolean;
+    /** Medication being edited — omit for "add" mode */
+    medication?: Medication;
+    /**
+     * Codify shard location for RxNorm/FDB coding. Defaults to the ambient
+     * `CodeLookupProvider`; pass `false` to force a plain name input.
+     */
+    codeLookup?: CodeLookupConfig | false;
+    /** Called when the editor is dismissed without saving */
+    onClose: () => void;
+    /** Called with the complete medication on save */
+    onSave: (medication: Medication) => void;
+}
+/**
+ * Parse strength + dose form out of a coded drug label,
+ * e.g. "lisinopril 20 mg tablet" → { strength: '20 mg', doseForm: 'tablet' }.
+ */
+declare function parseMedicationLabel(label: string): {
+    strength?: string;
+    doseForm?: string;
+};
+/**
+ * Derive route / frequency / PRN from free-text sig,
+ * e.g. "1 tablet by mouth daily as needed" →
+ * { route: 'oral', frequency: 'Once daily', prn: true }.
+ */
+declare function parseSig(sig: string): {
+    route?: string;
+    frequency?: string;
+    prn: boolean;
+};
+/**
+ * Derive the label-parsed Medication fields — strength, dose form, and the
+ * form-implied quantity unit — from a drug display label,
+ * e.g. "lisinopril 10 mg tablet" → { strength: '10 mg', doseForm: 'tablet',
+ * quantityUnit: 'tablet' }.
+ */
+declare function labelToMedicationFields(label: string): Partial<Medication>;
+/**
+ * Derive Medication fields from a CodeLookup pick: name, code reference,
+ * and — parsed from the label — strength, dose form, and quantity unit.
+ * Used by the editor and by inline add-search flows.
+ */
+declare function lookupToMedicationFields(result: MedicationLookupResult): Partial<Medication>;
+declare function MedicationEditor({ open, medication, codeLookup, onClose, onSave, }: MedicationEditorProps): React.JSX.Element | null;
+
+export { type Allergy as A, type CodeLookupConfig as C, type Medication as M, type MedicationAction as a, ALLERGY_TYPE_LABELS as b, type AllergyAction as c, type AllergyCode as d, type AllergyKind as e, AllergyList as f, type AllergyListProps as g, type AllergySeverity as h, type AllergyType as i, MEDICATION_STATUS_LABELS as j, type MedicationCode as k, MedicationEditor as l, type MedicationEditorProps as m, MedicationList as n, type MedicationListProps as o, type MedicationLookupProps as p, type MedicationLookupResult as q, type MedicationStatus as r, labelToMedicationFields as s, lookupToMedicationFields as t, parseMedicationLabel as u, parseSig as v };