@mieweb/ui 0.10.0-dev.10 → 0.10.0-dev.12

package/dist/components/ViewSet/index.d.cts

@@ -1,14 +1,125 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { ViewOption } from '../ViewSwitcher/index.cjs';
-import { ListViewProps } from '../ListView/index.cjs';
-import { BoardLabels, BoardViewProps } from '../BoardView/index.cjs';
-import { CalendarLabels, CalendarViewProps } from '../CalendarView/index.cjs';
-import { GanttLabels, GanttViewProps } from '../GanttView/index.cjs';
-import { a as ViewBaseProps, b as ViewId, S as Stage } from '../../types-CbWXIKbe.cjs';
-import 'class-variance-authority/types';
-import 'class-variance-authority';
-import 'luxon';
+import { V as ViewBaseProps, S as Stage, a as ViewLabels, b as ViewId, c as ViewOption } from '../../index-DoYYWsNc.cjs';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+type ListViewSlot = 'group' | 'groupHeader' | 'item' | 'selectedItem' | 'state';
+interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVariants> {
+    /**
+     * Group rows by `accessors.getStatus`, using these stages for order and
+     * labels. Items whose status matches no stage are appended under their own
+     * heading rather than dropped.
+     */
+    stages?: readonly Stage[];
+    /** Group by `accessors.getGroup` instead of by stage. */
+    groupBy?: 'status' | 'group' | 'none';
+    /** Groups that start collapsed. Uncontrolled; the user can reopen them. */
+    defaultCollapsedGroups?: readonly string[];
+    /** Retries the failed load. Renders the retry action only when provided. */
+    onRetry?: () => void;
+    classNames?: Partial<Record<ListViewSlot, string>>;
+    /** Heading level for group headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const itemVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type BoardViewSlot = 'column' | 'columnHeader' | 'card' | 'selectedCard' | 'state';
+interface BoardLabels extends ViewLabels {
+    /** Accessible name of the scrollable board region. */
+    board: string;
+    /** Announced when a card starts moving. `{item}` and `{stage}` are substituted. */
+    moved: string;
+    /** Announced when `onMove` rejects. */
+    moveFailed: string;
+    /** Hint on a focusable card describing the keyboard move. */
+    moveHint: string;
+}
+interface BoardViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof cardVariants> {
+    /** Columns, in order. A board without stages has nothing to draw. */
+    stages: readonly Stage[];
+    /**
+     * Commits a move. The board shows the card in its new column while this is
+     * pending and puts it back if the promise rejects, so the caller never has to
+     * re-render it home.
+     */
+    onMove?: (id: string, toStage: string, item: T) => void | Promise<void>;
+    labels?: Partial<BoardLabels>;
+    classNames?: Partial<Record<BoardViewSlot, string>>;
+    /** Heading level for column headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const cardVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+    pending?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type CalendarViewSlot = 'toolbar' | 'weekday' | 'day' | 'outsideDay' | 'today' | 'entry' | 'selectedEntry' | 'state';
+interface CalendarLabels extends ViewLabels {
+    previousMonth: string;
+    nextMonth: string;
+    today: string;
+    /** Overflow affordance. `{count}` is substituted. */
+    more: string;
+}
+interface CalendarViewProps<T> extends ViewBaseProps<T> {
+    /** Controlled month. Any date inside the month works. */
+    month?: Date;
+    /** Starting month when uncontrolled. Defaults to the month containing `now`. */
+    defaultMonth?: Date;
+    onMonthChange?: (month: Date) => void;
+    /**
+     * IANA zone the grid is drawn in, e.g. `America/New_York`. Defaults to the
+     * runtime's. A day boundary is a business fact, so state it explicitly when
+     * the collection belongs to somewhere other than the viewer.
+     */
+    timeZone?: string;
+    /** 1 = Monday … 7 = Sunday. Defaults to Monday. */
+    weekStartsOn?: number;
+    /** Locale for month, weekday and day-number formatting. */
+    locale?: string;
+    /** Entries to show per day before collapsing into "{count} more". */
+    maxPerDay?: number;
+    labels?: Partial<CalendarLabels>;
+    classNames?: Partial<Record<CalendarViewSlot, string>>;
+    /** Hide the month toolbar when the host renders its own. */
+    hideToolbar?: boolean;
+}
+
+/**
+ * Column width in time. `month` and `quarter` are what a roadmap is — the
+ * family has no separate RoadmapView, because it would be this component with
+ * wider columns.
+ */
+type GanttCadence = 'day' | 'week' | 'month' | 'quarter';
+type GanttViewSlot = 'header' | 'groupLabel' | 'row' | 'bar' | 'selectedBar' | 'state';
+interface GanttLabels extends ViewLabels {
+    /** Accessible name of the scrollable chart region. */
+    chart: string;
+    /** Footnote for records a time axis cannot place. `{count}` is substituted. */
+    undated: string;
+}
+interface GanttViewProps<T> extends ViewBaseProps<T> {
+    /** Column width in time. Defaults to `week`. */
+    cadence?: GanttCadence;
+    /** First column. Defaults to the earliest start in `items`. */
+    rangeStart?: Date;
+    /** Last column. Defaults to the latest end in `items`. */
+    rangeEnd?: Date;
+    /** Group rows into swimlanes by `accessors.getGroup`. */
+    groupByLane?: boolean;
+    timeZone?: string;
+    locale?: string;
+    labels?: Partial<GanttLabels>;
+    classNames?: Partial<Record<GanttViewSlot, string>>;
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
 
 /**
  * Every string any layout in the set can render.

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

@@ -1,14 +1,125 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import { ViewOption } from '../ViewSwitcher/index.js';
-import { ListViewProps } from '../ListView/index.js';
-import { BoardLabels, BoardViewProps } from '../BoardView/index.js';
-import { CalendarLabels, CalendarViewProps } from '../CalendarView/index.js';
-import { GanttLabels, GanttViewProps } from '../GanttView/index.js';
-import { a as ViewBaseProps, b as ViewId, S as Stage } from '../../types-CbWXIKbe.js';
-import 'class-variance-authority/types';
-import 'class-variance-authority';
-import 'luxon';
+import { V as ViewBaseProps, S as Stage, a as ViewLabels, b as ViewId, c as ViewOption } from '../../index-DoYYWsNc.js';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+type ListViewSlot = 'group' | 'groupHeader' | 'item' | 'selectedItem' | 'state';
+interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVariants> {
+    /**
+     * Group rows by `accessors.getStatus`, using these stages for order and
+     * labels. Items whose status matches no stage are appended under their own
+     * heading rather than dropped.
+     */
+    stages?: readonly Stage[];
+    /** Group by `accessors.getGroup` instead of by stage. */
+    groupBy?: 'status' | 'group' | 'none';
+    /** Groups that start collapsed. Uncontrolled; the user can reopen them. */
+    defaultCollapsedGroups?: readonly string[];
+    /** Retries the failed load. Renders the retry action only when provided. */
+    onRetry?: () => void;
+    classNames?: Partial<Record<ListViewSlot, string>>;
+    /** Heading level for group headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const itemVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type BoardViewSlot = 'column' | 'columnHeader' | 'card' | 'selectedCard' | 'state';
+interface BoardLabels extends ViewLabels {
+    /** Accessible name of the scrollable board region. */
+    board: string;
+    /** Announced when a card starts moving. `{item}` and `{stage}` are substituted. */
+    moved: string;
+    /** Announced when `onMove` rejects. */
+    moveFailed: string;
+    /** Hint on a focusable card describing the keyboard move. */
+    moveHint: string;
+}
+interface BoardViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof cardVariants> {
+    /** Columns, in order. A board without stages has nothing to draw. */
+    stages: readonly Stage[];
+    /**
+     * Commits a move. The board shows the card in its new column while this is
+     * pending and puts it back if the promise rejects, so the caller never has to
+     * re-render it home.
+     */
+    onMove?: (id: string, toStage: string, item: T) => void | Promise<void>;
+    labels?: Partial<BoardLabels>;
+    classNames?: Partial<Record<BoardViewSlot, string>>;
+    /** Heading level for column headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const cardVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+    pending?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type CalendarViewSlot = 'toolbar' | 'weekday' | 'day' | 'outsideDay' | 'today' | 'entry' | 'selectedEntry' | 'state';
+interface CalendarLabels extends ViewLabels {
+    previousMonth: string;
+    nextMonth: string;
+    today: string;
+    /** Overflow affordance. `{count}` is substituted. */
+    more: string;
+}
+interface CalendarViewProps<T> extends ViewBaseProps<T> {
+    /** Controlled month. Any date inside the month works. */
+    month?: Date;
+    /** Starting month when uncontrolled. Defaults to the month containing `now`. */
+    defaultMonth?: Date;
+    onMonthChange?: (month: Date) => void;
+    /**
+     * IANA zone the grid is drawn in, e.g. `America/New_York`. Defaults to the
+     * runtime's. A day boundary is a business fact, so state it explicitly when
+     * the collection belongs to somewhere other than the viewer.
+     */
+    timeZone?: string;
+    /** 1 = Monday … 7 = Sunday. Defaults to Monday. */
+    weekStartsOn?: number;
+    /** Locale for month, weekday and day-number formatting. */
+    locale?: string;
+    /** Entries to show per day before collapsing into "{count} more". */
+    maxPerDay?: number;
+    labels?: Partial<CalendarLabels>;
+    classNames?: Partial<Record<CalendarViewSlot, string>>;
+    /** Hide the month toolbar when the host renders its own. */
+    hideToolbar?: boolean;
+}
+
+/**
+ * Column width in time. `month` and `quarter` are what a roadmap is — the
+ * family has no separate RoadmapView, because it would be this component with
+ * wider columns.
+ */
+type GanttCadence = 'day' | 'week' | 'month' | 'quarter';
+type GanttViewSlot = 'header' | 'groupLabel' | 'row' | 'bar' | 'selectedBar' | 'state';
+interface GanttLabels extends ViewLabels {
+    /** Accessible name of the scrollable chart region. */
+    chart: string;
+    /** Footnote for records a time axis cannot place. `{count}` is substituted. */
+    undated: string;
+}
+interface GanttViewProps<T> extends ViewBaseProps<T> {
+    /** Column width in time. Defaults to `week`. */
+    cadence?: GanttCadence;
+    /** First column. Defaults to the earliest start in `items`. */
+    rangeStart?: Date;
+    /** Last column. Defaults to the latest end in `items`. */
+    rangeEnd?: Date;
+    /** Group rows into swimlanes by `accessors.getGroup`. */
+    groupByLane?: boolean;
+    timeZone?: string;
+    locale?: string;
+    labels?: Partial<GanttLabels>;
+    classNames?: Partial<Record<GanttViewSlot, string>>;
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
 
 /**
  * Every string any layout in the set can render.

package/dist/components/ViewSwitcher/index.d.cts

@@ -1,40 +1,4 @@
-import * as class_variance_authority_types from 'class-variance-authority/types';
-import * as React from 'react';
-import { VariantProps } from 'class-variance-authority';
-import { b as ViewId } from '../../types-CbWXIKbe.cjs';
-import 'luxon';
-
-interface ViewOption {
-    id: ViewId;
-    /** Overrides the built-in English label. */
-    label?: string;
-    /** Overrides the built-in icon. */
-    icon?: React.ComponentType<{
-        className?: string;
-        'aria-hidden'?: boolean;
-    }>;
-    disabled?: boolean;
-}
-interface ViewSwitcherProps extends VariantProps<typeof viewSwitcherVariants> {
-    /** Views to offer, in order. Accepts bare ids or `ViewOption`s. */
-    views: readonly (ViewId | ViewOption)[];
-    value: ViewId;
-    onValueChange: (view: ViewId) => void;
-    /** Accessible name of the group. */
-    label?: string;
-    /** Show labels beside the icons. `responsive` hides them below `sm`. */
-    showLabels?: boolean | 'responsive';
-    className?: string;
-    classNames?: Partial<Record<'option' | 'activeOption', string>>;
-}
-declare const viewSwitcherVariants: (props?: ({
-    size?: "sm" | "md" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-/**
- * Keyboard model is a radio group: one tab stop, arrows move *and* select.
- * Every option is visible, so moving the selection is the whole interaction —
- * there is nothing to "commit" afterwards.
- */
-declare const ViewSwitcher: React.ForwardRefExoticComponent<ViewSwitcherProps & React.RefAttributes<HTMLDivElement>>;
-
-export { type ViewOption, ViewSwitcher, type ViewSwitcherProps, viewSwitcherVariants };
+export { c as ViewOption, d as ViewSwitcher, e as ViewSwitcherProps, v as viewSwitcherVariants } from '../../index-DoYYWsNc.cjs';
+import 'class-variance-authority/types';
+import 'react';
+import 'class-variance-authority';

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

@@ -1,40 +1,4 @@
-import * as class_variance_authority_types from 'class-variance-authority/types';
-import * as React from 'react';
-import { VariantProps } from 'class-variance-authority';
-import { b as ViewId } from '../../types-CbWXIKbe.js';
-import 'luxon';
-
-interface ViewOption {
-    id: ViewId;
-    /** Overrides the built-in English label. */
-    label?: string;
-    /** Overrides the built-in icon. */
-    icon?: React.ComponentType<{
-        className?: string;
-        'aria-hidden'?: boolean;
-    }>;
-    disabled?: boolean;
-}
-interface ViewSwitcherProps extends VariantProps<typeof viewSwitcherVariants> {
-    /** Views to offer, in order. Accepts bare ids or `ViewOption`s. */
-    views: readonly (ViewId | ViewOption)[];
-    value: ViewId;
-    onValueChange: (view: ViewId) => void;
-    /** Accessible name of the group. */
-    label?: string;
-    /** Show labels beside the icons. `responsive` hides them below `sm`. */
-    showLabels?: boolean | 'responsive';
-    className?: string;
-    classNames?: Partial<Record<'option' | 'activeOption', string>>;
-}
-declare const viewSwitcherVariants: (props?: ({
-    size?: "sm" | "md" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-/**
- * Keyboard model is a radio group: one tab stop, arrows move *and* select.
- * Every option is visible, so moving the selection is the whole interaction —
- * there is nothing to "commit" afterwards.
- */
-declare const ViewSwitcher: React.ForwardRefExoticComponent<ViewSwitcherProps & React.RefAttributes<HTMLDivElement>>;
-
-export { type ViewOption, ViewSwitcher, type ViewSwitcherProps, viewSwitcherVariants };
+export { c as ViewOption, d as ViewSwitcher, e as ViewSwitcherProps, v as viewSwitcherVariants } from '../../index-DoYYWsNc.js';
+import 'class-variance-authority/types';
+import 'react';
+import 'class-variance-authority';

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;