@mieweb/ui 0.6.1-dev.159 → 0.6.1-dev.165

package/dist/{nitroTableGrid-RQNSZQO4.cjs → nitroTableGrid-3J2GY6CK.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkWJIANZPI_cjs = require('./chunk-WJIANZPI.cjs');
+var chunkVJOVJTFP_cjs = require('./chunk-VJOVJTFP.cjs');
 var React = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -39,9 +39,9 @@ function NitroTableGrid({ headers, rows }) {
     },
     [varName]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-slot": "superchat-nitro-table", className: "my-2", children: /* @__PURE__ */ jsxRuntime.jsx(chunkWJIANZPI_cjs.DataVisNitroSource, { type: "local", varName, children: /* @__PURE__ */ jsxRuntime.jsx(chunkWJIANZPI_cjs.DataVisNitroGrid, { columns: headers, className: "max-h-80" }) }) });
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-slot": "superchat-nitro-table", className: "my-2", children: /* @__PURE__ */ jsxRuntime.jsx(chunkVJOVJTFP_cjs.DataVisNitroSource, { type: "local", varName, children: /* @__PURE__ */ jsxRuntime.jsx(chunkVJOVJTFP_cjs.DataVisNitroGrid, { columns: headers, className: "max-h-80" }) }) });
 }
 
 module.exports = NitroTableGrid;
-//# sourceMappingURL=nitroTableGrid-RQNSZQO4.cjs.map
-//# sourceMappingURL=nitroTableGrid-RQNSZQO4.cjs.map
+//# sourceMappingURL=nitroTableGrid-3J2GY6CK.cjs.map
+//# sourceMappingURL=nitroTableGrid-3J2GY6CK.cjs.map

package/dist/{nitroTableGrid-RQNSZQO4.cjs.map → nitroTableGrid-3J2GY6CK.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/SuperChat/plugins/nitroTableGrid.tsx"],"names":["React","DataVisNitroSource","DataVisNitroGrid"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAqBe,SAAR,cAAA,CAAgC,EAAE,OAAA,EAAS,IAAA,EAAK,EAAwB;AAC7E,EAAA,MAAM,OAAA,GAAgBA,yBAAQ,MAAM;AAClC,IAAA,MAAM,WAAA,GAAc,CAAA,wBAAA,EAA2B,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAClF,IAAC,MAAA,CAA8C,WAAW,CAAA,GAAI;AAAA,MAC5D,QAAA,EAAU,QAAQ,GAAA,CAAI,CAAC,WAAW,EAAE,KAAA,EAAO,IAAA,EAAM,QAAA,EAAS,CAAE,CAAA;AAAA,MAC5D,IAAA,EAAM;AAAA,KACR;AACA,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA;AAElB,EAAMA,gBAAA,CAAA,SAAA;AAAA,IACJ,MAAM,MAAM;AACV,MAAA,OAAQ,OAA8C,OAAO,CAAA;AAAA,IAC/D,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,sCACG,KAAA,EAAA,EAAI,WAAA,EAAU,yBAAwB,SAAA,EAAU,MAAA,EAC/C,yCAACC,oCAAA,EAAA,EAAmB,IAAA,EAAK,OAAA,EAAQ,OAAA,EAC/B,yCAACC,kCAAA,EAAA,EAAiB,OAAA,EAAS,SAAS,SAAA,EAAU,UAAA,EAAW,GAC3D,CAAA,EACF,CAAA;AAEJ","file":"nitroTableGrid-RQNSZQO4.cjs","sourcesContent":["/**\n * SuperChat NITRO table grid (lazy chunk).\n *\n * Default-exported so it can be pulled in with `React.lazy` only when a GFM\n * table actually renders — this keeps the heavy `datavis` / `datavis-ace`\n * dependencies out of the SuperChat (and Markdown core) bundle.\n *\n * Data is handed to {@link DataVisNitroSource} through a short-lived local\n * source so Storybook never pauses in the intermediate \"Waiting…\" state.\n */\n\nimport * as React from 'react';\nimport { DataVisNitroGrid, DataVisNitroSource } from '../../DataVisNITRO';\n\nexport interface NitroTableGridProps {\n  /** Column headers, in order. */\n  headers: string[];\n  /** Row objects keyed by header. */\n  rows: Array<Record<string, string>>;\n}\n\nexport default function NitroTableGrid({ headers, rows }: NitroTableGridProps) {\n  const varName = React.useMemo(() => {\n    const nextVarName = `__superchat_nitro_table_${Math.random().toString(36).slice(2)}`;\n    (window as unknown as Record<string, unknown>)[nextVarName] = {\n      typeInfo: headers.map((field) => ({ field, type: 'string' })),\n      data: rows,\n    };\n    return nextVarName;\n  }, [headers, rows]);\n\n  React.useEffect(\n    () => () => {\n      delete (window as unknown as Record<string, unknown>)[varName];\n    },\n    [varName]\n  );\n\n  return (\n    <div data-slot=\"superchat-nitro-table\" className=\"my-2\">\n      <DataVisNitroSource type=\"local\" varName={varName}>\n        <DataVisNitroGrid columns={headers} className=\"max-h-80\" />\n      </DataVisNitroSource>\n    </div>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/SuperChat/plugins/nitroTableGrid.tsx"],"names":["React","DataVisNitroSource","DataVisNitroGrid"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAqBe,SAAR,cAAA,CAAgC,EAAE,OAAA,EAAS,IAAA,EAAK,EAAwB;AAC7E,EAAA,MAAM,OAAA,GAAgBA,yBAAQ,MAAM;AAClC,IAAA,MAAM,WAAA,GAAc,CAAA,wBAAA,EAA2B,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAClF,IAAC,MAAA,CAA8C,WAAW,CAAA,GAAI;AAAA,MAC5D,QAAA,EAAU,QAAQ,GAAA,CAAI,CAAC,WAAW,EAAE,KAAA,EAAO,IAAA,EAAM,QAAA,EAAS,CAAE,CAAA;AAAA,MAC5D,IAAA,EAAM;AAAA,KACR;AACA,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA;AAElB,EAAMA,gBAAA,CAAA,SAAA;AAAA,IACJ,MAAM,MAAM;AACV,MAAA,OAAQ,OAA8C,OAAO,CAAA;AAAA,IAC/D,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,sCACG,KAAA,EAAA,EAAI,WAAA,EAAU,yBAAwB,SAAA,EAAU,MAAA,EAC/C,yCAACC,oCAAA,EAAA,EAAmB,IAAA,EAAK,OAAA,EAAQ,OAAA,EAC/B,yCAACC,kCAAA,EAAA,EAAiB,OAAA,EAAS,SAAS,SAAA,EAAU,UAAA,EAAW,GAC3D,CAAA,EACF,CAAA;AAEJ","file":"nitroTableGrid-3J2GY6CK.cjs","sourcesContent":["/**\n * SuperChat NITRO table grid (lazy chunk).\n *\n * Default-exported so it can be pulled in with `React.lazy` only when a GFM\n * table actually renders — this keeps the heavy `datavis` / `datavis-ace`\n * dependencies out of the SuperChat (and Markdown core) bundle.\n *\n * Data is handed to {@link DataVisNitroSource} through a short-lived local\n * source so Storybook never pauses in the intermediate \"Waiting…\" state.\n */\n\nimport * as React from 'react';\nimport { DataVisNitroGrid, DataVisNitroSource } from '../../DataVisNITRO';\n\nexport interface NitroTableGridProps {\n  /** Column headers, in order. */\n  headers: string[];\n  /** Row objects keyed by header. */\n  rows: Array<Record<string, string>>;\n}\n\nexport default function NitroTableGrid({ headers, rows }: NitroTableGridProps) {\n  const varName = React.useMemo(() => {\n    const nextVarName = `__superchat_nitro_table_${Math.random().toString(36).slice(2)}`;\n    (window as unknown as Record<string, unknown>)[nextVarName] = {\n      typeInfo: headers.map((field) => ({ field, type: 'string' })),\n      data: rows,\n    };\n    return nextVarName;\n  }, [headers, rows]);\n\n  React.useEffect(\n    () => () => {\n      delete (window as unknown as Record<string, unknown>)[varName];\n    },\n    [varName]\n  );\n\n  return (\n    <div data-slot=\"superchat-nitro-table\" className=\"my-2\">\n      <DataVisNitroSource type=\"local\" varName={varName}>\n        <DataVisNitroGrid columns={headers} className=\"max-h-80\" />\n      </DataVisNitroSource>\n    </div>\n  );\n}\n"]}

package/dist/{nitroTableGrid-W6XWRFA7.js → nitroTableGrid-SIMT7635.js}

@@ -1,4 +1,4 @@
-import { DataVisNitroSource, DataVisNitroGrid } from './chunk-4N72FAQW.js';
+import { DataVisNitroSource, DataVisNitroGrid } from './chunk-YBLIDESO.js';
 import * as React from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -21,5 +21,5 @@ function NitroTableGrid({ headers, rows }) {
 }
 
 export { NitroTableGrid as default };
-//# sourceMappingURL=nitroTableGrid-W6XWRFA7.js.map
-//# sourceMappingURL=nitroTableGrid-W6XWRFA7.js.map
+//# sourceMappingURL=nitroTableGrid-SIMT7635.js.map
+//# sourceMappingURL=nitroTableGrid-SIMT7635.js.map

package/dist/{nitroTableGrid-W6XWRFA7.js.map → nitroTableGrid-SIMT7635.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/components/SuperChat/plugins/nitroTableGrid.tsx"],"names":[],"mappings":";;;;AAqBe,SAAR,cAAA,CAAgC,EAAE,OAAA,EAAS,IAAA,EAAK,EAAwB;AAC7E,EAAA,MAAM,OAAA,GAAgB,cAAQ,MAAM;AAClC,IAAA,MAAM,WAAA,GAAc,CAAA,wBAAA,EAA2B,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAClF,IAAC,MAAA,CAA8C,WAAW,CAAA,GAAI;AAAA,MAC5D,QAAA,EAAU,QAAQ,GAAA,CAAI,CAAC,WAAW,EAAE,KAAA,EAAO,IAAA,EAAM,QAAA,EAAS,CAAE,CAAA;AAAA,MAC5D,IAAA,EAAM;AAAA,KACR;AACA,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA;AAElB,EAAM,KAAA,CAAA,SAAA;AAAA,IACJ,MAAM,MAAM;AACV,MAAA,OAAQ,OAA8C,OAAO,CAAA;AAAA,IAC/D,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,2BACG,KAAA,EAAA,EAAI,WAAA,EAAU,yBAAwB,SAAA,EAAU,MAAA,EAC/C,8BAAC,kBAAA,EAAA,EAAmB,IAAA,EAAK,OAAA,EAAQ,OAAA,EAC/B,8BAAC,gBAAA,EAAA,EAAiB,OAAA,EAAS,SAAS,SAAA,EAAU,UAAA,EAAW,GAC3D,CAAA,EACF,CAAA;AAEJ","file":"nitroTableGrid-W6XWRFA7.js","sourcesContent":["/**\n * SuperChat NITRO table grid (lazy chunk).\n *\n * Default-exported so it can be pulled in with `React.lazy` only when a GFM\n * table actually renders — this keeps the heavy `datavis` / `datavis-ace`\n * dependencies out of the SuperChat (and Markdown core) bundle.\n *\n * Data is handed to {@link DataVisNitroSource} through a short-lived local\n * source so Storybook never pauses in the intermediate \"Waiting…\" state.\n */\n\nimport * as React from 'react';\nimport { DataVisNitroGrid, DataVisNitroSource } from '../../DataVisNITRO';\n\nexport interface NitroTableGridProps {\n  /** Column headers, in order. */\n  headers: string[];\n  /** Row objects keyed by header. */\n  rows: Array<Record<string, string>>;\n}\n\nexport default function NitroTableGrid({ headers, rows }: NitroTableGridProps) {\n  const varName = React.useMemo(() => {\n    const nextVarName = `__superchat_nitro_table_${Math.random().toString(36).slice(2)}`;\n    (window as unknown as Record<string, unknown>)[nextVarName] = {\n      typeInfo: headers.map((field) => ({ field, type: 'string' })),\n      data: rows,\n    };\n    return nextVarName;\n  }, [headers, rows]);\n\n  React.useEffect(\n    () => () => {\n      delete (window as unknown as Record<string, unknown>)[varName];\n    },\n    [varName]\n  );\n\n  return (\n    <div data-slot=\"superchat-nitro-table\" className=\"my-2\">\n      <DataVisNitroSource type=\"local\" varName={varName}>\n        <DataVisNitroGrid columns={headers} className=\"max-h-80\" />\n      </DataVisNitroSource>\n    </div>\n  );\n}\n"]}
+{"version":3,"sources":["../src/components/SuperChat/plugins/nitroTableGrid.tsx"],"names":[],"mappings":";;;;AAqBe,SAAR,cAAA,CAAgC,EAAE,OAAA,EAAS,IAAA,EAAK,EAAwB;AAC7E,EAAA,MAAM,OAAA,GAAgB,cAAQ,MAAM;AAClC,IAAA,MAAM,WAAA,GAAc,CAAA,wBAAA,EAA2B,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAClF,IAAC,MAAA,CAA8C,WAAW,CAAA,GAAI;AAAA,MAC5D,QAAA,EAAU,QAAQ,GAAA,CAAI,CAAC,WAAW,EAAE,KAAA,EAAO,IAAA,EAAM,QAAA,EAAS,CAAE,CAAA;AAAA,MAC5D,IAAA,EAAM;AAAA,KACR;AACA,IAAA,OAAO,WAAA;AAAA,EACT,CAAA,EAAG,CAAC,OAAA,EAAS,IAAI,CAAC,CAAA;AAElB,EAAM,KAAA,CAAA,SAAA;AAAA,IACJ,MAAM,MAAM;AACV,MAAA,OAAQ,OAA8C,OAAO,CAAA;AAAA,IAC/D,CAAA;AAAA,IACA,CAAC,OAAO;AAAA,GACV;AAEA,EAAA,2BACG,KAAA,EAAA,EAAI,WAAA,EAAU,yBAAwB,SAAA,EAAU,MAAA,EAC/C,8BAAC,kBAAA,EAAA,EAAmB,IAAA,EAAK,OAAA,EAAQ,OAAA,EAC/B,8BAAC,gBAAA,EAAA,EAAiB,OAAA,EAAS,SAAS,SAAA,EAAU,UAAA,EAAW,GAC3D,CAAA,EACF,CAAA;AAEJ","file":"nitroTableGrid-SIMT7635.js","sourcesContent":["/**\n * SuperChat NITRO table grid (lazy chunk).\n *\n * Default-exported so it can be pulled in with `React.lazy` only when a GFM\n * table actually renders — this keeps the heavy `datavis` / `datavis-ace`\n * dependencies out of the SuperChat (and Markdown core) bundle.\n *\n * Data is handed to {@link DataVisNitroSource} through a short-lived local\n * source so Storybook never pauses in the intermediate \"Waiting…\" state.\n */\n\nimport * as React from 'react';\nimport { DataVisNitroGrid, DataVisNitroSource } from '../../DataVisNITRO';\n\nexport interface NitroTableGridProps {\n  /** Column headers, in order. */\n  headers: string[];\n  /** Row objects keyed by header. */\n  rows: Array<Record<string, string>>;\n}\n\nexport default function NitroTableGrid({ headers, rows }: NitroTableGridProps) {\n  const varName = React.useMemo(() => {\n    const nextVarName = `__superchat_nitro_table_${Math.random().toString(36).slice(2)}`;\n    (window as unknown as Record<string, unknown>)[nextVarName] = {\n      typeInfo: headers.map((field) => ({ field, type: 'string' })),\n      data: rows,\n    };\n    return nextVarName;\n  }, [headers, rows]);\n\n  React.useEffect(\n    () => () => {\n      delete (window as unknown as Record<string, unknown>)[varName];\n    },\n    [varName]\n  );\n\n  return (\n    <div data-slot=\"superchat-nitro-table\" className=\"my-2\">\n      <DataVisNitroSource type=\"local\" varName={varName}>\n        <DataVisNitroGrid columns={headers} className=\"max-h-80\" />\n      </DataVisNitroSource>\n    </div>\n  );\n}\n"]}

package/dist/orderRows-BUJYgSc7.d.cts

@@ -0,0 +1,221 @@
+/**
+ * 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>;
+type DueStatus = 'due' | 'overdue' | 'pending' | 'satisfied' | 'not-applicable';
+interface DueItem {
+    /** Program key, CODETYPE|FULLCODE (e.g. "OSHA|1910.95", "eCQM|CMS125") */
+    key: string;
+    program: ProgramMeta;
+    status: DueStatus;
+    /** Most recent completion date of any satisfying order */
+    lastCompleted?: string;
+    /** When the current/last satisfaction lapses (satisfied/overdue only) */
+    dueDate?: string;
+    /** Satisfying orders currently pending */
+    pendingKeys: string[];
+}
+/** Is the patient inside the program's age/sex gates? */
+declare function isApplicable(history: Pick<PatientHistory, 'age' | 'sex'>, program: ProgramMeta): boolean;
+/**
+ * Evaluate one program against the history.
+ * `now` defaults to today; injectable for tests.
+ */
+declare function evaluateProgram(key: string, program: ProgramMeta, history: PatientHistory, now?: Date): DueItem;
+/**
+ * Evaluate a set of programs against the history, most actionable first
+ * (overdue → due → pending → satisfied; not-applicable omitted unless
+ * `includeNotApplicable`).
+ *
+ * `enrolledKeys` restricts occupational programs to the patient's actual
+ * enrollments (a clerk isn't due for cadmium surveillance just because the
+ * program exists); quality measures apply to everyone passing their gates.
+ */
+declare function evaluateDue(history: PatientHistory, programs: ProgramsMap, options?: {
+    enrolledKeys?: string[];
+    includeNotApplicable?: boolean;
+    now?: Date;
+}): DueItem[];
+/**
+ * Ordering-time prompt: is this order key part of a due/overdue program?
+ * Returns the matching due items so the UI can badge "due for OSHA 1910.95"
+ * or warn "already satisfied" while the clinician is ordering.
+ */
+declare function dueForOrder(orderKey: string, dueItems: DueItem[]): DueItem[];
+
+/**
+ * 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 OrderRowsOptions {
+    /** Occupational enrollments; quality measures apply to everyone in-gate */
+    enrolledKeys?: string[];
+    /** Evaluation clock (defaults to today; inject for determinism) */
+    now?: Date;
+    /** Display labels for program keys (falls back to the key) */
+    programLabels?: Record<string, string>;
+    /** Display labels for order keys (falls back to history labels, then key) */
+    orderLabels?: Record<string, string>;
+    /** Include not-yet-placed due-list orders as available/blocked rows
+     * (default true) */
+    includeDue?: boolean;
+}
+/**
+ * Chart-wide rows: every past + in-flight order in the history, plus (by
+ * default) the actionable due-list orders that haven't been placed yet
+ * (`available`, or `blocked` while prerequisites are incomplete).
+ */
+declare function buildChartOrderRows(history: PatientHistory, programs: ProgramsMap, options?: OrderRowsOptions): OrderRow[];
+/**
+ * Current-encounter rows: the encounter's own orders (pending unprocessed
+ * ones are the mass-operation targets) plus the actionable due-list orders
+ * available to place this visit.
+ */
+declare function buildEncounterOrderRows(history: PatientHistory, programs: ProgramsMap, encounterId: string, options?: OrderRowsOptions): OrderRow[];
+
+export { type DueItem as D, type HistoryAllergy as H, type IsoDate as I, type OrderRow as O, type PatientHistory as P, type ProgramsMap as a, type DueStatus as b, type HistoryCondition as c, type HistoryImmunization as d, type HistoryMedication as e, type HistoryObservation as f, type HistoryOrder as g, type HistoryProcedure as h, type OrderRowStatus as i, type OrderRowsOptions as j, type ProgramMeta as k, buildChartOrderRows as l, buildEncounterOrderRows as m, dueForOrder as n, evaluateDue as o, evaluateProgram as p, isApplicable as q };

package/dist/orderRows-BUJYgSc7.d.ts

@@ -0,0 +1,221 @@
+/**
+ * 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>;
+type DueStatus = 'due' | 'overdue' | 'pending' | 'satisfied' | 'not-applicable';
+interface DueItem {
+    /** Program key, CODETYPE|FULLCODE (e.g. "OSHA|1910.95", "eCQM|CMS125") */
+    key: string;
+    program: ProgramMeta;
+    status: DueStatus;
+    /** Most recent completion date of any satisfying order */
+    lastCompleted?: string;
+    /** When the current/last satisfaction lapses (satisfied/overdue only) */
+    dueDate?: string;
+    /** Satisfying orders currently pending */
+    pendingKeys: string[];
+}
+/** Is the patient inside the program's age/sex gates? */
+declare function isApplicable(history: Pick<PatientHistory, 'age' | 'sex'>, program: ProgramMeta): boolean;
+/**
+ * Evaluate one program against the history.
+ * `now` defaults to today; injectable for tests.
+ */
+declare function evaluateProgram(key: string, program: ProgramMeta, history: PatientHistory, now?: Date): DueItem;
+/**
+ * Evaluate a set of programs against the history, most actionable first
+ * (overdue → due → pending → satisfied; not-applicable omitted unless
+ * `includeNotApplicable`).
+ *
+ * `enrolledKeys` restricts occupational programs to the patient's actual
+ * enrollments (a clerk isn't due for cadmium surveillance just because the
+ * program exists); quality measures apply to everyone passing their gates.
+ */
+declare function evaluateDue(history: PatientHistory, programs: ProgramsMap, options?: {
+    enrolledKeys?: string[];
+    includeNotApplicable?: boolean;
+    now?: Date;
+}): DueItem[];
+/**
+ * Ordering-time prompt: is this order key part of a due/overdue program?
+ * Returns the matching due items so the UI can badge "due for OSHA 1910.95"
+ * or warn "already satisfied" while the clinician is ordering.
+ */
+declare function dueForOrder(orderKey: string, dueItems: DueItem[]): DueItem[];
+
+/**
+ * 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 OrderRowsOptions {
+    /** Occupational enrollments; quality measures apply to everyone in-gate */
+    enrolledKeys?: string[];
+    /** Evaluation clock (defaults to today; inject for determinism) */
+    now?: Date;
+    /** Display labels for program keys (falls back to the key) */
+    programLabels?: Record<string, string>;
+    /** Display labels for order keys (falls back to history labels, then key) */
+    orderLabels?: Record<string, string>;
+    /** Include not-yet-placed due-list orders as available/blocked rows
+     * (default true) */
+    includeDue?: boolean;
+}
+/**
+ * Chart-wide rows: every past + in-flight order in the history, plus (by
+ * default) the actionable due-list orders that haven't been placed yet
+ * (`available`, or `blocked` while prerequisites are incomplete).
+ */
+declare function buildChartOrderRows(history: PatientHistory, programs: ProgramsMap, options?: OrderRowsOptions): OrderRow[];
+/**
+ * Current-encounter rows: the encounter's own orders (pending unprocessed
+ * ones are the mass-operation targets) plus the actionable due-list orders
+ * available to place this visit.
+ */
+declare function buildEncounterOrderRows(history: PatientHistory, programs: ProgramsMap, encounterId: string, options?: OrderRowsOptions): OrderRow[];
+
+export { type DueItem as D, type HistoryAllergy as H, type IsoDate as I, type OrderRow as O, type PatientHistory as P, type ProgramsMap as a, type DueStatus as b, type HistoryCondition as c, type HistoryImmunization as d, type HistoryMedication as e, type HistoryObservation as f, type HistoryOrder as g, type HistoryProcedure as h, type OrderRowStatus as i, type OrderRowsOptions as j, type ProgramMeta as k, buildChartOrderRows as l, buildEncounterOrderRows as m, dueForOrder as n, evaluateDue as o, evaluateProgram as p, isApplicable as q };