{
  "name": "CareOS",
  "package": "health-components",
  "version": "1.0.0",
  "generated": "scripts/gen-agents-manifest.mjs from the TypeScript props, READMEs, stories and the element registry",
  "rules": [
    "Import React components from 'health-components' and load 'health-components/styles.css' once.",
    "In Angular, Vue or HTML call defineCareOSElements() from 'health-components/elements' and use the <co-*> tags.",
    "Format every clinical number with fmt or render it with ClinicalValue, DoseDisplay, DateTimeClinical, IdentifierDisplay, CodeDisplay or MoneyDisplay; never toFixed or a hand-written unit.",
    "Use tokens by name (var(--co-primary)), never hex. Theme with data-co-theme on any ancestor or <ThemeProvider>.",
    "Pick the highest layer that fits (complex before basic) and check whenNotToUse before choosing a component."
  ],
  "count": 185,
  "components": [
    {
      "name": "AbnormalFlag",
      "layer": "basic",
      "group": "Clinical values",
      "summary": "AbnormalFlag marks a result as normal, low, high, critical or abnormal with a letter, an icon and a word, never colour alone.",
      "import": "import { AbnormalFlag } from 'health-components';",
      "element": {
        "tag": "co-abnormal-flag",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "flag",
          "type": "FlagCode",
          "required": true,
          "default": null,
          "allowedValues": [
            "N",
            "L",
            "H",
            "LL",
            "HH",
            "A",
            "AA"
          ],
          "description": "Interpretation code: 'N' | 'L' | 'H' | 'LL' | 'HH' | 'A' | 'AA' (HL7 v2 OBX-8 / FHIR interpretation); required",
          "callback": false
        },
        {
          "name": "variant",
          "type": "AbnormalFlagVariant",
          "required": false,
          "default": "'compact'",
          "allowedValues": [
            "compact",
            "full"
          ],
          "description": "'compact' (letter and icon) | 'full' (letter, icon and word)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Next to a result value, in result tables and in the inbox.",
        "Standalone when only the interpretation is shown."
      ],
      "whenNotToUse": [
        "Status of a workflow item: StatusTag.",
        "Allergy severity: AllergyBadge."
      ],
      "accessibility": [
        "role img with aria-label set to the full word (Critical high).",
        "Solid critical colours meet 4.5:1 for the white text."
      ],
      "example": "<AbnormalFlag flag=\"HH\" variant=\"full\" />",
      "readme": "src/components/AbnormalFlag/README.md",
      "storybook": "basic-clinical-values-abnormalflag--docs"
    },
    {
      "name": "ADTPanel",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "ADTPanel admits, transfers and discharges a patient: level of care, attending and reason for admit and transfer, and disposition for discharge.",
      "import": "import { ADTPanel } from 'health-components';",
      "element": {
        "tag": "co-adt-panel",
        "events": [
          "co-mode-change",
          "co-level-change",
          "co-reason-change",
          "co-submit",
          "co-cancel"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "ADTPatient",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{ name, mrn, location, level, isolation, status }; required",
          "callback": false
        },
        {
          "name": "mode",
          "type": "ADTMode",
          "required": false,
          "default": "'admit'",
          "allowedValues": [
            "admit",
            "transfer",
            "discharge"
          ],
          "description": "'admit' | 'transfer' | 'discharge': the starting action (uncontrolled)",
          "callback": false
        },
        {
          "name": "modeValue",
          "type": "ADTMode",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "admit",
            "transfer",
            "discharge"
          ],
          "description": "The action (controlled); pair with onModeChange",
          "callback": false
        },
        {
          "name": "onModeChange",
          "type": "(mode: ADTMode) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new action",
          "callback": true
        },
        {
          "name": "level",
          "type": "string",
          "required": false,
          "default": "'medsurg'",
          "allowedValues": null,
          "description": "Starting level of care (uncontrolled)",
          "callback": false
        },
        {
          "name": "levelValue",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Level of care (controlled)",
          "callback": false
        },
        {
          "name": "onLevelChange",
          "type": "(level: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new level of care",
          "callback": true
        },
        {
          "name": "reason",
          "type": "string",
          "required": false,
          "default": "''",
          "allowedValues": null,
          "description": "Starting reason, diagnosis or disposition (uncontrolled)",
          "callback": false
        },
        {
          "name": "reasonValue",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Reason (controlled)",
          "callback": false
        },
        {
          "name": "onReasonChange",
          "type": "(reason: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new reason",
          "callback": true
        },
        {
          "name": "blockers",
          "type": "string[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "string[]: open discharge items that block discharge",
          "callback": false
        },
        {
          "name": "units",
          "type": "string[]",
          "required": false,
          "default": "sample list",
          "allowedValues": null,
          "description": "string[]: target units for a transfer",
          "callback": false
        },
        {
          "name": "attendings",
          "type": "string[]",
          "required": false,
          "default": "sample list",
          "allowedValues": null,
          "description": "string[]: attendings",
          "callback": false
        },
        {
          "name": "dischargeAt",
          "type": "string",
          "required": false,
          "default": "'10/09/2026 14:30'",
          "allowedValues": null,
          "description": "Discharge date and time shown at start",
          "callback": false
        },
        {
          "name": "showErrors",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows required-field errors",
          "callback": false
        },
        {
          "name": "done",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the confirmation (already submitted)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "onSubmit",
          "type": "(value: ADTSubmit) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "function({ mode, level, reason }) on the main action",
          "callback": true
        },
        {
          "name": "onCancel",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "function on Cancel",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Admitting, transfer centre and discharge workflows, from the chart or the bed board."
      ],
      "whenNotToUse": [
        "Picking the bed itself: BedBoard.",
        "Order review at transfer: OrderReconciliation."
      ],
      "accessibility": [
        "The action tabs are a tablist; tabs that do not apply to the status are disabled with a reason in the status.",
        "Errors are linked to the fields."
      ],
      "example": "<ADTPanel mode=\"transfer\" patient={pt} onSubmit={({ mode, level, reason }) => adt.send(mode, level, reason)} />",
      "readme": "src/components/ADTPanel/README.md",
      "storybook": "complex-inpatient-flow-adtpanel--docs"
    },
    {
      "name": "AfterVisitSummary",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "AfterVisitSummary is the plain-language discharge summary a patient takes home: why they were here, last results, new, changed, continued and stopped medicines, appointments, home care and warning signs.",
      "import": "import { AfterVisitSummary } from 'health-components';",
      "element": {
        "tag": "co-after-visit-summary",
        "events": [
          "co-print",
          "co-send-to-portal"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient name",
          "callback": false
        },
        {
          "name": "dates",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Stay dates",
          "callback": false
        },
        {
          "name": "reason",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Why they were in the hospital, in plain words; required",
          "callback": false
        },
        {
          "name": "meds",
          "type": "AfterVisitMed[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { name, dose, unit, route, freq, action: new | changed | continue | stop, note }",
          "callback": false
        },
        {
          "name": "results",
          "type": "InpatientMeasureValue[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { measure, value, range }",
          "callback": false
        },
        {
          "name": "followups",
          "type": "AfterVisitFollowup[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { when, with, where }",
          "callback": false
        },
        {
          "name": "instructions",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "string[]: home care",
          "callback": false
        },
        {
          "name": "warnings",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "string[]: warning signs",
          "callback": false
        },
        {
          "name": "language",
          "type": "string",
          "required": false,
          "default": "'English'",
          "allowedValues": null,
          "description": "Language of the printed copy; a language other than English adds a note",
          "callback": false
        },
        {
          "name": "onPrint",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Print",
          "callback": true
        },
        {
          "name": "onSendToPortal",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Send to Portal",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Printed at discharge and sent to the patient portal."
      ],
      "whenNotToUse": [
        "Clinician discharge summary for the next provider; that is a note."
      ],
      "accessibility": [
        "Headings for each section so screen readers can jump.",
        "Written at about a sixth-grade reading level; no abbreviations like BID."
      ],
      "example": "<AfterVisitSummary patient=\"Grace Okafor\" reason=\"Your heart was not pumping well...\" meds={meds} followups={appts} warnings={redFlags} />",
      "readme": "src/components/AfterVisitSummary/README.md",
      "storybook": "complex-inpatient-flow-aftervisitsummary--docs"
    },
    {
      "name": "AISuggestion",
      "layer": "basic",
      "group": "Feedback",
      "summary": "AISuggestion holds content drafted by AI, in the AI purple, with its source, confidence and Accept or Edit actions.",
      "import": "import { AISuggestion } from 'health-components';",
      "element": {
        "tag": "co-ai-suggestion",
        "events": [],
        "slots": [
          "(default)",
          "actions"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "\"AI suggestion\"",
          "allowedValues": null,
          "description": "Title; also names the region",
          "callback": false
        },
        {
          "name": "source",
          "type": "string",
          "required": false,
          "default": "\"Draft, needs review\"",
          "allowedValues": null,
          "description": "Tag text",
          "callback": false
        },
        {
          "name": "confidence",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Confidence word shown on the right (\"medium\")",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The AI-drafted content. Required.",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Accept, Edit, Discard buttons",
          "callback": false
        }
      ],
      "whenToUse": [
        "AI-drafted notes, code suggestions, message replies, coverage guesses."
      ],
      "whenNotToUse": [
        "Content a person wrote."
      ],
      "accessibility": [
        "Region named after the title.",
        "Never apply AI output without a person accepting it."
      ],
      "example": "<AISuggestion title=\"Suggested codes\" confidence=\"medium\" actions={<Button variant=\"ai\" size=\"sm\" onClick={accept}>Accept Codes</Button>}>{suggestion}</AISuggestion>",
      "readme": "src/components/AISuggestion/README.md",
      "storybook": "basic-feedback-aisuggestion--docs"
    },
    {
      "name": "Alert",
      "layer": "basic",
      "group": "Feedback",
      "summary": "Alert is an inline banner for information, success, warnings, errors, the read-only lock, access denied and break-the-glass.",
      "import": "import { Alert } from 'health-components';",
      "element": {
        "tag": "co-alert",
        "events": [
          "co-dismiss"
        ],
        "slots": [
          "title",
          "(default)",
          "actions"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "tone",
          "type": "AlertTone",
          "required": false,
          "default": "'info'",
          "allowedValues": [
            "info",
            "success",
            "warning",
            "error",
            "lock",
            "denied",
            "btg",
            "note",
            "ai"
          ],
          "description": "'info' | 'success' | 'warning' | 'error' | 'lock' | 'denied' | 'btg' | 'note' | 'ai'",
          "callback": false
        },
        {
          "name": "title",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Bold first line",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Body text",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Buttons under the body",
          "callback": false
        },
        {
          "name": "onDismiss",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shows a Dismiss (x) button that calls this",
          "callback": true
        }
      ],
      "whenToUse": [
        "A message about this screen or record that must stay visible: coverage inactive, chart restricted, role is read-only."
      ],
      "whenNotToUse": [
        "Confirmation of an action that just finished: Toast.",
        "Blocking decisions: Modal."
      ],
      "accessibility": [
        "error, denied and btg use role alert; others role status.",
        "Every tone has its own icon."
      ],
      "example": "<Alert tone=\"warning\" title=\"Prior authorization expires in 6 days\" actions={<Button size=\"sm\">Request Extension</Button>}>PA-2026-11873 covers 20 visits; 12 used.</Alert>\n<Alert tone=\"lock\">Your role (Biller) can view this screen but not edit it.</Alert>",
      "readme": "src/components/Alert/README.md",
      "storybook": "basic-feedback-alert--docs"
    },
    {
      "name": "AllergyBadge",
      "layer": "complex",
      "group": "Clinical",
      "summary": "AllergyBadge is the red allergy tag used in banners and lists, with severity in its title and optional label.",
      "import": "import { AllergyBadge } from 'health-components';",
      "element": {
        "tag": "co-allergy-badge",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "substance",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Allergen (\"Penicillin\"); required",
          "callback": false
        },
        {
          "name": "severity",
          "type": "AllergySeverity",
          "required": false,
          "default": "'moderate'",
          "allowedValues": [
            "severe",
            "moderate",
            "mild"
          ],
          "description": "'severe' | 'moderate' | 'mild'",
          "callback": false
        },
        {
          "name": "reaction",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Reaction (\"Anaphylaxis\"), shown in the tooltip and read by screen readers",
          "callback": false
        },
        {
          "name": "showSeverity",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the severity in the label (\"Allergy: Penicillin (Severe)\")",
          "callback": false
        }
      ],
      "whenToUse": [
        "Anywhere a patient is identified and a drug may be ordered."
      ],
      "whenNotToUse": [
        "Full allergy management: AllergyList."
      ],
      "accessibility": [
        "Icon plus the word Allergy; severity in text when shown."
      ],
      "example": "<AllergyBadge substance=\"Penicillin\" severity=\"severe\" reaction=\"Hives\" showSeverity />",
      "readme": "src/components/AllergyBadge/README.md",
      "storybook": "complex-clinical-allergybadge--docs"
    },
    {
      "name": "AllergyList",
      "layer": "complex",
      "group": "Clinical",
      "summary": "AllergyList is the Allergies card: each allergy with type, reaction, severity and status, plus the NKA and not-reviewed states.",
      "import": "import { AllergyList } from 'health-components';",
      "element": {
        "tag": "co-allergy-list",
        "events": [
          "co-mark-reviewed",
          "co-add",
          "co-item-action"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "AllergyItem[]",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Allergies. `[]` shows No Known Allergies (NKA); `undefined` means not reviewed and shows a warning.\nArray<{substance, type?, reaction?, severity, onset?, status?}> | [] | undefined",
          "callback": false
        },
        {
          "name": "reviewed",
          "type": "string",
          "required": false,
          "default": "none (Not reviewed this visit)",
          "allowedValues": null,
          "description": "Review date and person (\"10/09/2026 by Lisa Chen RN\")",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Mark Reviewed, Add Allergy and the row menus",
          "callback": false
        },
        {
          "name": "onMarkReviewed",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Mark Reviewed clicked",
          "callback": true
        },
        {
          "name": "onAdd",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Add Allergy clicked",
          "callback": true
        },
        {
          "name": "onItemAction",
          "type": "(action: AllergyAction, item: AllergyItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "A row menu item was chosen",
          "callback": true
        }
      ],
      "whenToUse": [
        "Chart Allergies section, intake review."
      ],
      "whenNotToUse": [
        "Banners: AllergyBadge."
      ],
      "accessibility": [
        "Severity has icon and word."
      ],
      "example": "<AllergyList items={allergies} reviewed=\"10/09/2026 by Lisa Chen RN\" />",
      "readme": "src/components/AllergyList/README.md",
      "storybook": "complex-clinical-allergylist--docs"
    },
    {
      "name": "AnesthesiaRecord",
      "layer": "or 1 . george miller, 64 y m . lap cholecystectomy . geta",
      "group": null,
      "summary": "AnesthesiaRecord is the intraoperative record: vitals every 5 minutes as a trend and a grid, case events, medications given, airway details and fluid totals.",
      "import": "import { AnesthesiaRecord } from 'health-components';",
      "element": {
        "tag": "co-anesthesia-record",
        "events": [
          "co-add-event",
          "co-give-medication"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "times",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Column times 'HH:MM', usually every 5 minutes; required",
          "callback": false
        },
        {
          "name": "vitals",
          "type": "AnesthesiaVitals",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Vitals aligned to `times`; required",
          "callback": false
        },
        {
          "name": "events",
          "type": "AnesthesiaEvent[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Case events",
          "callback": false
        },
        {
          "name": "meds",
          "type": "AnesthesiaMed[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Medications given",
          "callback": false
        },
        {
          "name": "airway",
          "type": "AnesthesiaAirway",
          "required": false,
          "default": "none (Airway not documented)",
          "allowedValues": null,
          "description": "Airway",
          "callback": false
        },
        {
          "name": "totals",
          "type": "AnesthesiaTotals",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Fluid totals in mL",
          "callback": false
        },
        {
          "name": "alert",
          "type": "{ title: string; body: string }",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Critical event banner {title, body}",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Signed record: no actions",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "onAddEvent",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Add Event",
          "callback": true
        },
        {
          "name": "onGiveMedication",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Give Medication",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "During and after a case, by the anesthesia provider."
      ],
      "whenNotToUse": [
        "PACU vitals: VitalsPanel."
      ],
      "accessibility": [
        "Grid has a caption and row headers; each value has a range title.",
        "Chart has an aria-label with the heart rate series."
      ],
      "example": "<AnesthesiaRecord times={times} vitals={vitals} meds={meds} airway={airway} totals={{ fluids: 1200, ebl: 150, urine: 220 }} />",
      "readme": "src/components/AnesthesiaRecord/README.md",
      "storybook": "or-1-george-miller-64-y-m-lap-cholecystectomy-geta--docs"
    },
    {
      "name": "AppointmentChip",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "AppointmentChip is one appointment on the calendar, coloured by status or by appointment type, with telehealth and paid or unpaid icons.",
      "import": "import { AppointmentChip } from 'health-components';",
      "element": {
        "tag": "co-appointment-chip",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "time",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Start time, e.g. \"9:20\"",
          "callback": false
        },
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient name",
          "callback": false
        },
        {
          "name": "type",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Appointment type, e.g. \"Follow-Up\"",
          "callback": false
        },
        {
          "name": "status",
          "type": "AppointmentChipStatus",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Appointment status ('Scheduled', 'Confirmed', 'Arrived', 'In Room', 'Completed', 'No Show', 'Cancelled'...)",
          "callback": false
        },
        {
          "name": "colorBy",
          "type": "'status' | 'type'",
          "required": false,
          "default": "'status'",
          "allowedValues": [
            "type",
            "status"
          ],
          "description": "Colour the stripe by status or by appointment type",
          "callback": false
        },
        {
          "name": "color",
          "type": "AppointmentChipColor",
          "required": false,
          "default": "'blue'",
          "allowedValues": [
            "blue",
            "green",
            "teal",
            "purple",
            "red",
            "orange",
            "yellow",
            "pink",
            "gray"
          ],
          "description": "'blue' | 'green' | 'teal' | 'purple' | 'red' | 'orange' | 'yellow' | 'pink' | 'gray'",
          "callback": false
        },
        {
          "name": "telehealth",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the video icon",
          "callback": false
        },
        {
          "name": "paid",
          "type": "boolean",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "true: copay paid icon, false: copay due icon, undefined: no icon",
          "callback": false
        },
        {
          "name": "size",
          "type": "'sm' | 'md'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' (month view, no type line) | 'md'",
          "callback": false
        }
      ],
      "whenToUse": [
        "Calendar day, week and month cells; today lists."
      ],
      "whenNotToUse": [
        "Tables: use StatusTag in a status column."
      ],
      "accessibility": [
        "A button whose aria-label reads time, patient, type, status, telehealth and copay.",
        "Type colours as stripes are below 3:1 for Blue, Teal, Orange and Yellow on light styles; the type name is always printed, so colour never carries it alone."
      ],
      "example": "<AppointmentChip time=\"9:20\" patient=\"Nora Scott\" type=\"Therapy 50\" status=\"Confirmed\" telehealth paid={false} onClick={openAppt} />",
      "readme": "src/components/AppointmentChip/README.md",
      "storybook": "complex-scheduling-appointmentchip--docs"
    },
    {
      "name": "Audiogram",
      "layer": "complex",
      "group": "Specialty",
      "summary": "Audiogram plots hearing thresholds for each ear from 250 to 8000 Hz with the standard symbols, shades the degree of loss, and lists every value with the pure tone average.",
      "import": "import { Audiogram } from 'health-components';",
      "element": {
        "tag": "co-audiogram",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "right",
          "type": "AudiogramEar",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Right ear {ac, bc?, nr?}; required",
          "callback": false
        },
        {
          "name": "left",
          "type": "AudiogramEar",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Left ear {ac, bc?, nr?}; required",
          "callback": false
        },
        {
          "name": "speech",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Speech results line",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Audiogram'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Audiology, ENT and occupational hearing results; hearing screening follow-up."
      ],
      "whenNotToUse": [
        "A pass or refer newborn screen: a Badge.",
        "Tympanometry or speech-in-noise results on their own."
      ],
      "accessibility": [
        "Colour follows the audiology convention but every ear also has its own symbol shape.",
        "The chart label gives each ear’s average and degree; the table below has every value.",
        "Frequency and level axes are labelled in text."
      ],
      "example": "<Audiogram right={{ ac: { 250: 15, 500: 20, 1000: 20, 2000: 35, 4000: 55, 8000: 60 } }} left={{ ac: { 250: 15, 500: 15, 1000: 20, 2000: 30, 4000: 50, 8000: 55 } }} />",
      "readme": "src/components/Audiogram/README.md",
      "storybook": "complex-specialty-audiogram--docs"
    },
    {
      "name": "AuditLogRow",
      "layer": "complex",
      "group": "Access",
      "summary": "AuditLogRow is one audit entry: time, action, user and role, what changed, patient, IP and reason, with old and new values.",
      "import": "import { AuditLogRow } from 'health-components';",
      "element": {
        "tag": "co-audit-log-row",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "event",
          "type": "AuditLogEvent",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{time, action, user, role, what, patient?, ip?, reason?, change?}; required",
          "callback": false
        }
      ],
      "whenToUse": [
        "Audit log, privacy review, break-the-glass review."
      ],
      "whenNotToUse": [
        "Clinical history: Timeline."
      ],
      "accessibility": [
        "Action has icon and word."
      ],
      "example": "<AuditLogRow event={{ time: \"10/09 10:42\", action: \"btg\", user: \"Ana Ortiz MD\", role: \"Provider\", what: \"opened chart\", patient: \"Nora Scott\", reason: \"Emergency treatment\" }} />",
      "readme": "src/components/AuditLogRow/README.md",
      "storybook": "complex-access-auditlogrow--docs"
    },
    {
      "name": "Avatar",
      "layer": "basic",
      "group": "Data display",
      "summary": "Avatar shows a person as a photo or initials, in five sizes, with an optional presence dot.",
      "import": "import { Avatar } from 'health-components';",
      "element": {
        "tag": "co-avatar",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "name",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Full name; gives the initials and the accessible name. Required",
          "callback": false
        },
        {
          "name": "src",
          "type": "string",
          "required": false,
          "default": "none (initials)",
          "allowedValues": null,
          "description": "Photo URL",
          "callback": false
        },
        {
          "name": "size",
          "type": "AvatarSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "xs",
            "lg",
            "xl"
          ],
          "description": "'xs' 20 | 'sm' 30 | 'md' 40 | 'lg' 48 | 'xl' 64",
          "callback": false
        },
        {
          "name": "color",
          "type": "AvatarColor",
          "required": false,
          "default": "'primary'",
          "allowedValues": [
            "ai",
            "primary",
            "accent",
            "success-strong",
            "ink-2"
          ],
          "description": "Initials background: 'primary' (patients) | 'accent' (signed-in user) | 'ai' | 'success-strong' | 'ink-2'",
          "callback": false
        },
        {
          "name": "status",
          "type": "AvatarStatus",
          "required": false,
          "default": "none",
          "allowedValues": [
            "online",
            "busy",
            "away",
            "offline"
          ],
          "description": "Presence dot: 'online' | 'busy' | 'away' | 'offline'",
          "callback": false
        }
      ],
      "whenToUse": [
        "Patients in banners and search results, staff in chat, care team, assignees."
      ],
      "whenNotToUse": [
        "Decoration in empty states."
      ],
      "accessibility": [
        "role img with the full name and status in aria-label.",
        "Initials on `accent`: below 4.5:1 in Focus Rail (coral) and Command Bar (gold). Source pair kept; see README contrast list."
      ],
      "example": "<Avatar name=\"Henna West\" size=\"lg\" />\n<Avatar name=\"Mandy Harley LCSW\" size=\"sm\" status=\"online\" />",
      "readme": "src/components/Avatar/README.md",
      "storybook": "basic-data-display-avatar--docs"
    },
    {
      "name": "Badge",
      "layer": "basic",
      "group": "Data display",
      "summary": "Badge is a small coloured label for a status or attribute; StatusTag picks the right colour for claim, PA, appointment and eligibility statuses.",
      "import": "import { Badge } from 'health-components';",
      "element": {
        "tag": "co-badge",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "tone",
          "type": "BadgeTone",
          "required": false,
          "default": "'neutral'",
          "allowedValues": [
            "info",
            "success",
            "warning",
            "ai",
            "neutral",
            "danger",
            "outline"
          ],
          "description": "'neutral' | 'success' | 'danger' | 'warning' | 'info' | 'ai' | 'outline'",
          "callback": false
        },
        {
          "name": "shape",
          "type": "BadgeShape",
          "required": false,
          "default": "'square'",
          "allowedValues": [
            "square",
            "pill"
          ],
          "description": "'square' | 'pill'",
          "callback": false
        },
        {
          "name": "size",
          "type": "BadgeSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        },
        {
          "name": "icon",
          "type": "IconName",
          "required": false,
          "default": "none",
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon before the label",
          "callback": false
        },
        {
          "name": "dot",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a small dot in the current colour before the label (ignored when `icon` is set)",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Label text, a status word in Title Case.",
          "callback": false
        }
      ],
      "whenToUse": [
        "Statuses in tables and banners: Paid, Denied, Pended, Confirmed, Eligible.",
        "Attributes: \"Behavioral Health\", \"New Patient\"."
      ],
      "whenNotToUse": [
        "Actions: Button. Filters: FilterChip."
      ],
      "accessibility": [
        "Each status has a word and an icon; never colour alone.",
        "All tone pairs pass 4.5:1 in every theme (checked in tokens.json)."
      ],
      "example": "<Badge tone=\"info\" shape=\"pill\">Behavioral Health</Badge>\n<StatusTag kind=\"claim\" status=\"Denied\" />\n<StatusTag kind=\"pa\" status=\"Pended\" />",
      "readme": "src/components/Badge/README.md",
      "storybook": "basic-data-display-badge--docs"
    },
    {
      "name": "BarChart",
      "layer": "basic",
      "group": "Charts",
      "summary": "BarChart shows values per category or day with optional threshold line and out-of-range colours, for dashboards and remote monitoring.",
      "import": "import { BarChart } from 'health-components';",
      "element": {
        "tag": "co-bar-chart",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "data",
          "type": "BarChartDatum[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{label, value, tone?}>",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Caption above the chart and start of the accessible summary",
          "callback": false
        },
        {
          "name": "height",
          "type": "number",
          "required": false,
          "default": "150",
          "allowedValues": null,
          "description": "Plot height in px",
          "callback": false
        },
        {
          "name": "max",
          "type": "number",
          "required": false,
          "default": "auto (largest value)",
          "allowedValues": null,
          "description": "Top of the scale",
          "callback": false
        },
        {
          "name": "threshold",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Value of the dashed goal or limit line",
          "callback": false
        },
        {
          "name": "thresholdLabel",
          "type": "string",
          "required": false,
          "default": "\"Goal N\"",
          "allowedValues": null,
          "description": "Label of the threshold line",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Unit appended to values in the accessible text, e.g. \" mmHg\"",
          "callback": false
        },
        {
          "name": "legend",
          "type": "BarChartLegendItem[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Array<{label, tone}>",
          "callback": false
        }
      ],
      "whenToUse": [
        "Counts per day or per payer; readings against a target."
      ],
      "whenNotToUse": [
        "More than about 14 bars: a table or line chart."
      ],
      "accessibility": [
        "role img with every label and value in the aria-label; values are printed above bars.",
        "Out-of-range bars also cross the threshold line, so colour is not the only cue."
      ],
      "example": "<BarChart title=\"Systolic BP (mmHg)\" data={readings.map(r => ({ label: r.day, value: r.sys, tone: r.sys >= 140 ? \"hi\" : \"ok\" }))} threshold={140} />",
      "readme": "src/components/BarChart/README.md",
      "storybook": "basic-charts-barchart--docs"
    },
    {
      "name": "BarcodeScanPrompt",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "BarcodeScanPrompt asks for one barcode scan (wristband, medication or witness badge), checks it against the expected code and shows match, mismatch or skipped.",
      "import": "import { BarcodeScanPrompt } from 'health-components';",
      "element": {
        "tag": "co-barcode-scan-prompt",
        "events": [
          "co-state-change",
          "co-scan",
          "co-override",
          "co-reset"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "target",
          "type": "BarcodeScanTarget",
          "required": false,
          "default": "'medication'",
          "allowedValues": [
            "patient",
            "medication",
            "witness"
          ],
          "description": "'patient' (wristband) | 'medication' | 'witness' (badge)",
          "callback": false
        },
        {
          "name": "expected",
          "type": "string",
          "required": false,
          "default": "none (any scan matches)",
          "allowedValues": null,
          "description": "Code to match (compared trimmed and case-insensitive)",
          "callback": false
        },
        {
          "name": "expectedLabel",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "What it should be ('Marcus Hill, DOB 03/14/1959')",
          "callback": false
        },
        {
          "name": "step",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Step number shown before the prompt",
          "callback": false
        },
        {
          "name": "state",
          "type": "BarcodeScanState",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "waiting",
            "matched",
            "mismatch",
            "override"
          ],
          "description": "Controlled state: 'waiting' | 'matched' | 'mismatch' | 'override'",
          "callback": false
        },
        {
          "name": "defaultState",
          "type": "BarcodeScanState",
          "required": false,
          "default": "'waiting'",
          "allowedValues": [
            "waiting",
            "matched",
            "mismatch",
            "override"
          ],
          "description": "Initial state (uncontrolled)",
          "callback": false
        },
        {
          "name": "onStateChange",
          "type": "(state: BarcodeScanState) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the state changes (a scan is checked, Cannot scan, Rescan)",
          "callback": true
        },
        {
          "name": "defaultCode",
          "type": "string",
          "required": false,
          "default": "''",
          "allowedValues": null,
          "description": "Scanned code shown in the field and the status line",
          "callback": false
        },
        {
          "name": "allowOverride",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a Cannot scan button",
          "callback": false
        },
        {
          "name": "overrideReason",
          "type": "string",
          "required": false,
          "default": "'barcode damaged'",
          "allowedValues": null,
          "description": "Reason shown in the override state",
          "callback": false
        },
        {
          "name": "autoFocus",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Focuses the field on mount (the scanner types into it)",
          "callback": false
        },
        {
          "name": "matchedText",
          "type": "string",
          "required": false,
          "default": "'Scan matches <expectedLabel>'",
          "allowedValues": null,
          "description": "Replaces the matched message",
          "callback": false
        },
        {
          "name": "mismatchText",
          "type": "string",
          "required": false,
          "default": "'Scan does not match. Do not give...'",
          "allowedValues": null,
          "description": "Replaces the mismatch message",
          "callback": false
        },
        {
          "name": "onScan",
          "type": "(code: string, ok: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the code and whether it matched when a scan is checked",
          "callback": true
        },
        {
          "name": "onOverride",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called on Cannot scan",
          "callback": true
        },
        {
          "name": "onReset",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shows Rescan in the matched state and is called by it",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Accepted for API consistency with the nursing set (no values are flagged here)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Positive patient ID and drug scan in MAR, specimen collection, blood transfusion."
      ],
      "whenNotToUse": [
        "Typing an MRN to search: Combobox."
      ],
      "accessibility": [
        "Group labelled by the instruction; result announced by a polite live region.",
        "Scanner input is a labelled text field so keyboard entry works.",
        "Mismatch uses an icon and words, not only red."
      ],
      "example": "<BarcodeScanPrompt step={2} target=\"medication\" expected=\"NDC0409-7332\" expectedLabel=\"cefTRIAXone 1 g\" onScan={(c, ok) => ...} />",
      "readme": "src/components/BarcodeScanPrompt/README.md",
      "storybook": "complex-inpatient-nursing-barcodescanprompt--docs"
    },
    {
      "name": "BedBoard",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "BedBoard shows every bed on one or more units by room, with its status, the patient in it and their precautions, and lets bed management drag a waiting patient onto a clean bed.",
      "import": "import { BedBoard } from 'health-components';",
      "element": {
        "tag": "co-bed-board",
        "events": [
          "co-units-change",
          "co-queue-change",
          "co-selected-change",
          "co-assign"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "units",
          "type": "BedUnit[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array of { id, name, level, ratio, rooms: [{ id, negativePressure, beds: [{ id, status, note, patient }] }] }: the initial board (uncontrolled); required",
          "callback": false
        },
        {
          "name": "unitsValue",
          "type": "BedUnit[]",
          "required": false,
          "default": "uncontrolled from `units`",
          "allowedValues": null,
          "description": "The board (controlled); pair with onUnitsChange",
          "callback": false
        },
        {
          "name": "onUnitsChange",
          "type": "(units: BedUnit[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new board after an assignment",
          "callback": true
        },
        {
          "name": "queue",
          "type": "BedQueuePatient[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of patients waiting for a bed { id, name, age, sex, reason, level, isolation, waiting }: the initial queue",
          "callback": false
        },
        {
          "name": "queueValue",
          "type": "BedQueuePatient[]",
          "required": false,
          "default": "uncontrolled from `queue`",
          "allowedValues": null,
          "description": "The queue (controlled); pair with onQueueChange",
          "callback": false
        },
        {
          "name": "onQueueChange",
          "type": "(queue: BedQueuePatient[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new queue after an assignment",
          "callback": true
        },
        {
          "name": "defaultSelected",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Queue id selected at start (uncontrolled)",
          "callback": false
        },
        {
          "name": "selected",
          "type": "string | null",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected queue id (controlled; null for none)",
          "callback": false
        },
        {
          "name": "onSelectedChange",
          "type": "(id: string | null) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the newly selected queue id (null when cleared)",
          "callback": true
        },
        {
          "name": "onAssign",
          "type": "(patient: BedQueuePatient, bed: Bed, room: BedRoom) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "function(patient, bed, room) after a patient is assigned",
          "callback": true
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only: no drag, no assign",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Bed Board'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "House supervisor, bed management and charge nurse views.",
        "Any time a person picks a bed for an admission or transfer."
      ],
      "whenNotToUse": [
        "A list of patients without beds: CensusList.",
        "Outpatient rooms: the scheduling components."
      ],
      "accessibility": [
        "Drag is never the only way: select a waiting patient, then press Assign on a bed.",
        "Each bed has an aria-label with room, status, patient and, while a patient is selected, why it cannot take them.",
        "Bed status is in words as well as colour."
      ],
      "example": "<BedBoard units={units} queue={waiting} onAssign={(pt, bed, room) => api.assignBed(pt.id, room.id + bed.id)} />",
      "readme": "src/components/BedBoard/README.md",
      "storybook": "complex-inpatient-flow-bedboard--docs"
    },
    {
      "name": "BehavioralTreatmentPlan",
      "layer": "complex",
      "group": "Specialty",
      "summary": "BehavioralTreatmentPlan lays out a behavioral health plan as problems, goals, measurable objectives and the interventions for each, with target dates, progress, review date and signatures.",
      "import": "import { BehavioralTreatmentPlan } from 'health-components';",
      "element": {
        "tag": "co-behavioral-treatment-plan",
        "events": [
          "co-review-plan",
          "co-sign-plan"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "problems",
          "type": "ReadonlyArray<TreatmentProblem>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Problems with goals, objectives and interventions",
          "callback": false
        },
        {
          "name": "reviewDue",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Next review date",
          "callback": false
        },
        {
          "name": "reviewOverdue",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "The review date has passed",
          "callback": false
        },
        {
          "name": "signatures",
          "type": "ReadonlyArray<PlanSignature>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Signatures",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Treatment plan'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Review Plan and Sign Plan",
          "callback": false
        },
        {
          "name": "onReviewPlan",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Review Plan action",
          "callback": true
        },
        {
          "name": "onSignPlan",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Sign Plan action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Mental health and substance use treatment plans at intake, at each review and at discharge."
      ],
      "whenNotToUse": [
        "Crisis safety planning: a safety plan form.",
        "Medical problem lists: ProblemList."
      ],
      "accessibility": [
        "Each problem is a labelled region; numbering (1.1a) ties objectives to goals in text.",
        "Status is a word badge."
      ],
      "example": "<BehavioralTreatmentPlan problems={[{ code: \"F33.1\", label: \"Major depressive disorder, recurrent, moderate\", goals: [{ text: \"Reduce depressive symptoms\", objectives: [{ text: \"PHQ-9 under 10\", target: \"12/15/2026\", status: \"progressing\", measure: { name: \"PHQ-9\", baseline: 17, current: 12, target: 9 }, interventions: [{ text: \"CBT\", frequency: \"weekly\", who: \"LCSW\" }] }] }] }]} />",
      "readme": "src/components/BehavioralTreatmentPlan/README.md",
      "storybook": "complex-specialty-behavioraltreatmentplan--docs"
    },
    {
      "name": "BodyMap",
      "layer": "complex",
      "group": "Specialty",
      "summary": "BodyMap marks numbered lesions on front and back body outlines, with size in millimetres, change since last visit, status and dated photos for each one.",
      "import": "import { BodyMap } from 'health-components';",
      "element": {
        "tag": "co-body-map",
        "events": [
          "co-view-change",
          "co-mark-select",
          "co-add-photo"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "marks",
          "type": "ReadonlyArray<BodyMapMark>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Marks in a 200 by 262 frame",
          "callback": false
        },
        {
          "name": "view",
          "type": "BodyMapView",
          "required": false,
          "default": "'front'",
          "allowedValues": [
            "front",
            "back"
          ],
          "description": "First view shown (uncontrolled)",
          "callback": false
        },
        {
          "name": "currentView",
          "type": "BodyMapView",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "front",
            "back"
          ],
          "description": "Shown view (controlled)",
          "callback": false
        },
        {
          "name": "onViewChange",
          "type": "(view: BodyMapView) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the view changes",
          "callback": true
        },
        {
          "name": "onMarkSelect",
          "type": "(n: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the mark number when a pin is clicked",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Body map'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title (patient and date)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Add Photo",
          "callback": false
        },
        {
          "name": "onAddPhoto",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Add Photo action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Full skin exams, mole mapping, wound and pressure injury location, injection site rotation."
      ],
      "whenNotToUse": [
        "Comparing photos side by side at full size: a photo viewer.",
        "Wound measurements over time: a wound flowsheet."
      ],
      "accessibility": [
        "The list repeats every mark in text with its number, so the drawing is never the only record.",
        "The SVG label says which side is the patient’s left in each view.",
        "Photos carry alt text with lesion number, site and date."
      ],
      "example": "<BodyMap marks={[{ x: 88, y: 92, view: \"front\", site: \"Left upper chest\", size: [6, 5], prevSize: 4, prevDate: \"04/02/2026\", type: \"biopsy\", desc: \"Irregular border, two colors\", photos: [{ date: \"10/09/2026\" }] }]} />",
      "readme": "src/components/BodyMap/README.md",
      "storybook": "complex-specialty-bodymap--docs"
    },
    {
      "name": "BottomTabBar",
      "layer": "complex",
      "group": "Mobile and kiosk",
      "summary": "BottomTabBar is the phone and portal bottom navigation with four or five tabs and badges.",
      "import": "import { BottomTabBar } from 'health-components';",
      "element": {
        "tag": "co-bottom-tab-bar",
        "events": [
          "co-navigate"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "BottomTabBarItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Four or five tabs. Required.",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Label of the current tab",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Main\"",
          "allowedValues": null,
          "description": "Landmark name",
          "callback": false
        },
        {
          "name": "onNavigate",
          "type": "(item: BottomTabBarItem, event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a tab is clicked",
          "callback": true
        }
      ],
      "whenToUse": [
        "Phone EHR and patient portal."
      ],
      "whenNotToUse": [
        "Desktop."
      ],
      "accessibility": [
        "nav with aria-current=\"page\"; 56px targets."
      ],
      "example": "<BottomTabBar items={STAFF_TABS} active=\"Schedule\" />",
      "readme": "src/components/BottomTabBar/README.md",
      "storybook": "complex-mobile-and-kiosk-bottomtabbar--docs"
    },
    {
      "name": "BradenScore",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "BradenScore is the Braden Scale for pressure injury risk: six subscales, automatic total from 6 to 23 and the risk band (lower is higher risk).",
      "import": "import { BradenScore } from 'health-components';",
      "element": {
        "tag": "co-braden-score",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "defaultValues",
          "type": "Record<string, number>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Option index per subscale (uncontrolled), keyed by sensory, moisture, activity, mobility, nutrition, friction",
          "callback": false
        },
        {
          "name": "values",
          "type": "Record<string, number>",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Option index per subscale (controlled)",
          "callback": false
        },
        {
          "name": "band",
          "type": "(total: number) => NursingScoreBand",
          "required": false,
          "default": "bradenBand (9 or less very high ... 19+ no risk)",
          "allowedValues": null,
          "description": "Bands, total to band",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Braden Scale'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "previous",
          "type": "NursingPreviousScore",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Last score",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(values: Record<string, number>) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with all answers after each pick",
          "callback": true
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use",
          "callback": false
        }
      ],
      "whenToUse": [
        "Pressure injury risk on admission and daily, more often in ICU."
      ],
      "whenNotToUse": [
        "Documenting an existing wound: WoundCareDoc.",
        "Neonates and young children: Braden Q."
      ],
      "accessibility": [
        "Each subscale is a radiogroup; options show their points.",
        "The total says lower is higher risk in words."
      ],
      "example": "<BradenScore defaultValues={{ sensory: 1, moisture: 1, activity: 0, mobility: 1, nutrition: 1, friction: 0 }} />",
      "readme": "src/components/BradenScore/README.md",
      "storybook": "complex-inpatient-nursing-bradenscore--docs"
    },
    {
      "name": "Breadcrumb",
      "layer": "basic",
      "group": "Navigation",
      "summary": "Breadcrumb shows where a deep screen sits and links back up the path.",
      "import": "import { Breadcrumb } from 'health-components';",
      "element": {
        "tag": "co-breadcrumb",
        "events": [
          "co-navigate"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "BreadcrumbItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Path from the top level to the current page. Required.",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Breadcrumb\"",
          "allowedValues": null,
          "description": "Landmark name",
          "callback": false
        },
        {
          "name": "onNavigate",
          "type": "(item: BreadcrumbItem, event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a level is clicked (client-side routing)",
          "callback": true
        }
      ],
      "whenToUse": [
        "Three or more levels deep in Settings or Reports."
      ],
      "whenNotToUse": [
        "Inside the patient chart (the banner already anchors it)."
      ],
      "accessibility": [
        "nav \"Breadcrumb\", ordered list, aria-current=\"page\" on the last item."
      ],
      "example": "<Breadcrumb items={[{ label: \"Settings\", href: \"/settings\" }, { label: \"Roles and Permissions\", href: \"/settings/roles\" }, { label: \"Biller\" }]} />",
      "readme": "src/components/Breadcrumb/README.md",
      "storybook": "basic-navigation-breadcrumb--docs"
    },
    {
      "name": "BreakTheGlassDialog",
      "layer": "complex",
      "group": "Access",
      "summary": "BreakTheGlassDialog asks for a reason before opening a restricted chart and says the access is logged.",
      "import": "import { BreakTheGlassDialog } from 'health-components';",
      "element": {
        "tag": "co-break-the-glass-dialog",
        "events": [
          "co-confirm",
          "co-close",
          "co-access-reason-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient name. Required",
          "callback": false
        },
        {
          "name": "dob",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Date of birth. Required",
          "callback": false
        },
        {
          "name": "careTeam",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Care team members who can open the chart without a reason. Required",
          "callback": false
        },
        {
          "name": "reason",
          "type": "string",
          "required": false,
          "default": "\"This chart contains behavioral health records. Only the care team can open it without a reason.\"",
          "allowedValues": null,
          "description": "Why the chart is restricted (Alert body)",
          "callback": false
        },
        {
          "name": "note",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial explanation in the \"Other\" box",
          "callback": false
        },
        {
          "name": "onConfirm",
          "type": "(access: BreakTheGlassAccess) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by \"Open Chart and Log Access\" with the reason and explanation",
          "callback": true
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Cancel, the x button and Escape",
          "callback": true
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the dialog is shown",
          "callback": false
        },
        {
          "name": "accessReason",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled, nothing pre-selected)",
          "allowedValues": null,
          "description": "Chosen access reason (controlled)",
          "callback": false
        },
        {
          "name": "onAccessReasonChange",
          "type": "(reason: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen access reason",
          "callback": true
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a spinner on the confirm button while access is logged",
          "callback": false
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Render in place for docs: no portal, focus trap, scroll lock or Escape",
          "callback": false
        }
      ],
      "whenToUse": [
        "Opening restricted charts (staff patients, behavioral health, VIP)."
      ],
      "whenNotToUse": [
        "Normal charts."
      ],
      "accessibility": [
        "alertdialog."
      ],
      "example": "<BreakTheGlassDialog patient=\"Nora Scott\" dob=\"06/11/1999\" careTeam=\"Mandy Harley LCSW\" onConfirm={openChart} />",
      "readme": "src/components/BreakTheGlassDialog/README.md",
      "storybook": "complex-access-breaktheglassdialog--docs"
    },
    {
      "name": "Button",
      "layer": "basic",
      "group": "Actions",
      "summary": "Button runs one action on the screen, from Save Claim to Start Visit Note.",
      "import": "import { Button } from 'health-components';",
      "element": {
        "tag": "co-button",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "variant",
          "type": "ButtonVariant",
          "required": false,
          "default": "'secondary'",
          "allowedValues": [
            "ai",
            "primary",
            "danger",
            "secondary",
            "tertiary",
            "ghost",
            "danger-solid",
            "link"
          ],
          "description": "Visual weight. Use `primary` once per area; `ai` only for actions that run an AI model.",
          "callback": false
        },
        {
          "name": "size",
          "type": "ButtonSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "lg"
          ],
          "description": "'sm' 30px (tables, toolbars), 'md' 36px, 'lg' 48px (kiosk, portal)",
          "callback": false
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a spinner, keeps the label, disables the button and sets aria-busy",
          "callback": false
        },
        {
          "name": "iconLeft",
          "type": "IconName",
          "required": false,
          "default": "none",
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon before the label",
          "callback": false
        },
        {
          "name": "iconRight",
          "type": "IconName",
          "required": false,
          "default": "none",
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon after the label",
          "callback": false
        },
        {
          "name": "full",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Full width (phone screens)",
          "callback": false
        },
        {
          "name": "pressed",
          "type": "boolean",
          "required": false,
          "default": "undefined (not a toggle)",
          "allowedValues": null,
          "description": "Toggle state; sets aria-pressed",
          "callback": false
        },
        {
          "name": "href",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Renders an `<a>` with button styling",
          "callback": false
        },
        {
          "name": "target",
          "type": "AnchorHTMLAttributes<HTMLAnchorElement>['target']",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Link target when `href` is set",
          "callback": false
        },
        {
          "name": "rel",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Link rel when `href` is set",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Label text: a verb in Title Case that says what happens (\"Submit Claim\").",
          "callback": false
        }
      ],
      "whenToUse": [
        "Commit or move a task forward: Save, Submit Claim, Start Visit Note, Check In.",
        "Use `primary` once per area for the main action; everything else is `secondary`.",
        "Use `ai` only for actions that run an AI model (Draft with AI Scribe, Suggest Codes)."
      ],
      "whenNotToUse": [
        "Navigation to another screen inside running text: use a link.",
        "Filtering a list: use FilterChip or SegmentedControl.",
        "Destroying data without a confirm step: pair `danger` with a destructive Modal."
      ],
      "accessibility": [
        "Labels are verbs in Title Case and say what happens: \"Submit Claim\", not \"OK\".",
        "Loading keeps the label so screen readers still announce it; the spinner has role status.",
        "Disabled buttons are skipped by Tab. When the reason is not obvious, say it in helper text next to the button.",
        "Focus ring: 2px `focus-ring` with 2px offset."
      ],
      "example": "<Button variant=\"primary\" iconLeft=\"plus\" onClick={startNote}>Start Visit Note</Button>\n<Button variant=\"danger\" size=\"sm\">Void Claim</Button>\n<Button variant=\"primary\" loading={checking}>Check Coverage</Button>",
      "readme": "src/components/Button/README.md",
      "storybook": "basic-actions-button--docs"
    },
    {
      "name": "ButtonGroup",
      "layer": "basic",
      "group": "Actions",
      "summary": "ButtonGroup lays out related buttons with the 8px gap the screens use, or joins them into one attached control.",
      "import": "import { ButtonGroup } from 'health-components';",
      "element": {
        "tag": "co-button-group",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "attached",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Joins the buttons into one attached control (Day / Week / Month)",
          "callback": false
        },
        {
          "name": "align",
          "type": "'start' | 'end'",
          "required": false,
          "default": "'start'",
          "allowedValues": [
            "start",
            "end"
          ],
          "description": "'start' | 'end': 'end' right-aligns a footer",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "aria-label of the group",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Buttons; required",
          "callback": false
        }
      ],
      "whenToUse": [
        "Page header actions: \"Care gaps (3 open)\", \"Outside records (HIE)\", \"For developers\".",
        "Modal footers, right aligned (`align=\"end\"`).",
        "Attached: a small view switch such as Day, Week, Month on the calendar."
      ],
      "whenNotToUse": [
        "Choosing one value from a set inside a form: use SegmentedControl, which is a radio group."
      ],
      "accessibility": [
        "The group has role group; give it a label when the buttons only make sense together.",
        "Primary goes last in a footer, so the reading order ends on the main action."
      ],
      "example": "<ButtonGroup align=\"end\">\n  <Button onClick={cancel}>Cancel</Button>\n  <Button variant=\"primary\" onClick={save}>Save Changes</Button>\n</ButtonGroup>",
      "readme": "src/components/ButtonGroup/README.md",
      "storybook": "basic-actions-buttongroup--docs"
    },
    {
      "name": "Calendar",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "Calendar is the full schedule with Day, Week and Month views, built from CalendarCell and AppointmentChip.",
      "import": "import { Calendar } from 'health-components';",
      "element": {
        "tag": "co-calendar",
        "events": [
          "co-view-change",
          "co-date-change",
          "co-color-mode-change",
          "co-navigate",
          "co-book",
          "co-appointment-click"
        ],
        "slots": []
      },
      "aliases": [
        "ScheduleCalendar"
      ],
      "props": [
        {
          "name": "view",
          "type": "CalendarView",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "month",
            "day",
            "week"
          ],
          "description": "'day' | 'week' | 'month' (controlled)",
          "callback": false
        },
        {
          "name": "defaultView",
          "type": "CalendarView",
          "required": false,
          "default": "'week'",
          "allowedValues": [
            "month",
            "day",
            "week"
          ],
          "description": "Initial view (uncontrolled)",
          "callback": false
        },
        {
          "name": "onViewChange",
          "type": "(view: CalendarView) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the view switch changes",
          "callback": true
        },
        {
          "name": "date",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Shown date \"YYYY-MM-DD\" (controlled)",
          "callback": false
        },
        {
          "name": "defaultDate",
          "type": "string",
          "required": false,
          "default": "`today`",
          "allowedValues": null,
          "description": "Initial shown date \"YYYY-MM-DD\" (uncontrolled)",
          "callback": false
        },
        {
          "name": "onDateChange",
          "type": "(date: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new date on Previous, Today, Next and \"+N more\"",
          "callback": true
        },
        {
          "name": "today",
          "type": "string",
          "required": false,
          "default": "`defaultDate`, else the device's date (read once)",
          "allowedValues": null,
          "description": "Today's date \"YYYY-MM-DD\" (ringed, and where Today goes)",
          "callback": false
        },
        {
          "name": "appointments",
          "type": "CalendarAppointment[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array<AppointmentChip props & {day: number, slot?: string}>",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "the shown date (\"Friday, October 9, 2026\")",
          "allowedValues": null,
          "description": "Heading text",
          "callback": false
        },
        {
          "name": "times",
          "type": "string[]",
          "required": false,
          "default": "8:00 AM to 12:00 PM",
          "allowedValues": null,
          "description": "Day view rows",
          "callback": false
        },
        {
          "name": "blocks",
          "type": "Record<string, string>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Record<time, reason>: blocked rows in the day view",
          "callback": false
        },
        {
          "name": "monthBlocks",
          "type": "Record<number, string>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Record<day of month, reason>: blocked days in the month view",
          "callback": false
        },
        {
          "name": "colorBy",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the Color by select",
          "callback": false
        },
        {
          "name": "colorMode",
          "type": "CalendarColorMode",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "type",
            "status"
          ],
          "description": "Chip colouring: 'status' | 'type' (controlled)",
          "callback": false
        },
        {
          "name": "defaultColorMode",
          "type": "CalendarColorMode",
          "required": false,
          "default": "'status'",
          "allowedValues": [
            "type",
            "status"
          ],
          "description": "Initial chip colouring (uncontrolled)",
          "callback": false
        },
        {
          "name": "onColorModeChange",
          "type": "(mode: CalendarColorMode) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the Color by select changes",
          "callback": true
        },
        {
          "name": "onNavigate",
          "type": "(direction: CalendarNavigation, date: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called on Previous, Today and Next, after the date moves",
          "callback": true
        },
        {
          "name": "onBook",
          "type": "(date: string, time: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the free slot of a day row is chosen",
          "callback": true
        },
        {
          "name": "onAppointmentClick",
          "type": "(appointment: CalendarAppointment) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when an appointment chip is chosen",
          "callback": true
        }
      ],
      "whenToUse": [
        "The schedule screen and provider day views."
      ],
      "whenNotToUse": [
        "Picking one free time: TimeSlotPicker."
      ],
      "accessibility": [
        "Each view is a grid; every chip reads time, patient, type and status."
      ],
      "example": "<Calendar defaultView=\"week\" defaultDate=\"2026-10-09\" colorBy\n  appointments={appts.map(a => ({ ...a, day: a.date.getDate(), slot: a.timeLabel }))}\n  onBook={(date, time) => openBooking(date, time)} onAppointmentClick={openAppointment} />",
      "readme": "src/components/Calendar/README.md",
      "storybook": "complex-scheduling-calendar--docs"
    },
    {
      "name": "CalendarCell",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "CalendarCell renders one cell of the month, week or day calendar with its appointments, blocked time and free slots.",
      "import": "import { CalendarCell } from 'health-components';",
      "element": {
        "tag": "co-calendar-cell",
        "events": [
          "co-book",
          "co-more"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "view",
          "type": "CalendarCellView",
          "required": false,
          "default": "'month'",
          "allowedValues": [
            "month",
            "day",
            "week"
          ],
          "description": "'month' | 'week' | 'day'",
          "callback": false
        },
        {
          "name": "date",
          "type": "string | number",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Day number or label (\"Thu 9\"); required for month and week",
          "callback": false
        },
        {
          "name": "time",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Row time (\"9:20 AM\"); required for day",
          "callback": false
        },
        {
          "name": "appointments",
          "type": "AppointmentChipProps[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "AppointmentChip props[]",
          "callback": false
        },
        {
          "name": "count",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Appointment count shown in the month header",
          "callback": false
        },
        {
          "name": "today",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Highlights today",
          "callback": false
        },
        {
          "name": "dim",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Day outside the current month",
          "callback": false
        },
        {
          "name": "blocked",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Reason the time is blocked (\"Lunch\", \"CME conference\")",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "aria-label of the cell (month and week)",
          "callback": false
        },
        {
          "name": "onBook",
          "type": "(time: string | undefined) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with `time` when the free slot of a day row is chosen",
          "callback": true
        },
        {
          "name": "onMore",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when \"+N more\" is chosen in a month or week cell",
          "callback": true
        }
      ],
      "whenToUse": [
        "Building the schedule views."
      ],
      "whenNotToUse": [
        "A small date picker: DatePicker."
      ],
      "accessibility": [
        "gridcell role; the free slot link says \"+ Book 10:20 AM\" on focus."
      ],
      "example": "<CalendarCell view=\"month\" date={9} today count={14} appointments={dayAppts} />\n<CalendarCell view=\"day\" time=\"12:00 PM\" blocked=\"Lunch\" />",
      "readme": "src/components/CalendarCell/README.md",
      "storybook": "complex-scheduling-calendarcell--docs"
    },
    {
      "name": "Card",
      "layer": "basic",
      "group": "Data display",
      "summary": "Card is the white container every screen section sits in, with an optional title, actions and footer.",
      "import": "import { Card } from 'health-components';",
      "element": {
        "tag": "co-card",
        "events": [],
        "slots": [
          "title",
          "subtitle",
          "actions",
          "footer",
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Heading, rendered as an h2",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Header actions (one primary at most)",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer content",
          "callback": false
        },
        {
          "name": "flat",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Border instead of shadow",
          "callback": false
        },
        {
          "name": "padding",
          "type": "CardPadding",
          "required": false,
          "default": "'default'",
          "allowedValues": [
            "compact",
            "default",
            "none"
          ],
          "description": "'default' | 'compact' (10px) | 'none' (edge-to-edge tables)",
          "callback": false
        },
        {
          "name": "as",
          "type": "ElementType",
          "required": false,
          "default": "'section'",
          "allowedValues": null,
          "description": "Root tag name",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Card body.",
          "callback": false
        }
      ],
      "whenToUse": [
        "Group one topic: Allergies, Claim lines, Coverage."
      ],
      "whenNotToUse": [
        "Nesting a card in a card: use a divider or a DescriptionList."
      ],
      "accessibility": [
        "The title is an h2, so cards build the page outline."
      ],
      "example": "<Card title=\"Coverage\" subtitle=\"Verified 10/08/2026\" actions={<Button size=\"sm\">Recheck</Button>}>\n  <DescriptionList items={[[\"Payer\", \"Aetna PPO\"]]} />\n</Card>",
      "readme": "src/components/Card/README.md",
      "storybook": "basic-data-display-card--docs"
    },
    {
      "name": "CareGapRow",
      "layer": "complex",
      "group": "Quality and care programs",
      "summary": "CareGapRow is one open, closed or excluded care gap with the action that closes it.",
      "import": "import { CareGapRow } from 'health-components';",
      "element": {
        "tag": "co-care-gap-row",
        "events": [
          "co-action"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "gap",
          "type": "CareGapData",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{measure, patient?, detail?, due?, status: open|closed|excluded, action?}; required",
          "callback": false
        },
        {
          "name": "onAction",
          "type": "(action: CareGapAction, gap: CareGapData) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen action of an open gap: the main action, Record Outside Result or Mark Excluded",
          "callback": true
        }
      ],
      "whenToUse": [
        "Chart care gaps, recall lists."
      ],
      "whenNotToUse": [
        "Measure totals: QualityMeasureCard."
      ],
      "accessibility": [
        "Status in words."
      ],
      "example": "<CareGapRow gap={{ measure: \"Colorectal cancer screening\", detail: \"Last FIT 2023\", status: \"open\", action: \"Order FIT\" }} />",
      "readme": "src/components/CareGapRow/README.md",
      "storybook": "complex-quality-and-care-programs-caregaprow--docs"
    },
    {
      "name": "CarePlanByShift",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "CarePlanByShift shows each nursing problem with its goal, goal status and the interventions charted Done, Partly, Not done or N/A for each shift; only the current shift is editable.",
      "import": "import { CarePlanByShift } from 'health-components';",
      "element": {
        "tag": "co-care-plan-by-shift",
        "events": [
          "co-status-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "problems",
          "type": "CarePlanProblem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Problems; required",
          "callback": false
        },
        {
          "name": "shifts",
          "type": "string[]",
          "required": false,
          "default": "['Day 07-15', 'Evening 15-23', 'Night 23-07']",
          "allowedValues": null,
          "description": "Shift labels",
          "callback": false
        },
        {
          "name": "currentShift",
          "type": "number",
          "required": false,
          "default": "none (nothing editable)",
          "allowedValues": null,
          "description": "Index of the current (only editable) shift",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "onStatusChange",
          "type": "(e: CarePlanStatusChange) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when a current-shift status is changed (Done, Partly, Not done, N/A in turn)",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Care Plan by Shift'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; a goal measure's own range still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Daily inpatient nursing care plan review and charting."
      ],
      "whenNotToUse": [
        "Interdisciplinary long-term plans: CarePlanCard."
      ],
      "accessibility": [
        "Each problem is a labelled section with its own table and caption.",
        "Editable cells are buttons that say the current status."
      ],
      "example": "<CarePlanByShift currentShift={1} problems={plan} />",
      "readme": "src/components/CarePlanByShift/README.md",
      "storybook": "complex-inpatient-nursing-careplanbyshift--docs"
    },
    {
      "name": "CareTeamPanel",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "CareTeamPanel lists everyone caring for the patient, inside and outside the practice, with role, specialty, NPI, last contact and call or message actions.",
      "import": "import { CareTeamPanel } from 'health-components';",
      "element": {
        "tag": "co-care-team-panel",
        "events": [
          "co-add-member",
          "co-call",
          "co-message",
          "co-member-action"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "members",
          "type": "CareTeamMember[]",
          "required": false,
          "default": "none (empty state)",
          "allowedValues": null,
          "description": "Team members",
          "callback": false
        },
        {
          "name": "updated",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "When the team was last updated",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "No Add Member or row menus",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Care Team'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "onAddMember",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Add Member",
          "callback": true
        },
        {
          "name": "onCall",
          "type": "(member: CareTeamMember) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Call",
          "callback": true
        },
        {
          "name": "onMessage",
          "type": "(member: CareTeamMember) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Message",
          "callback": true
        },
        {
          "name": "onMemberAction",
          "type": "(action: CareTeamAction, member: CareTeamMember) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with a row menu action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Chart sidebar, referral routing, care coordination and transitions of care."
      ],
      "whenNotToUse": [
        "Staff scheduling: ProviderDayColumns."
      ],
      "accessibility": [
        "Icon buttons name the person and the number."
      ],
      "example": "<CareTeamPanel members={team} />",
      "readme": "src/components/CareTeamPanel/README.md",
      "storybook": "complex-chart-panels-careteampanel--docs"
    },
    {
      "name": "CCMTimer",
      "layer": "complex",
      "group": "Quality and care programs",
      "summary": "CCMTimer tracks chronic care management minutes for the month toward 99490 and 99439.",
      "import": "import { CCMTimer } from 'health-components';",
      "element": {
        "tag": "co-ccm-timer",
        "events": [
          "co-running-change",
          "co-log-activity"
        ],
        "slots": [
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient name; required",
          "callback": false
        },
        {
          "name": "month",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Month being counted (\"October 2026\"); required",
          "callback": false
        },
        {
          "name": "minutes",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Minutes already logged this month",
          "callback": false
        },
        {
          "name": "clock",
          "type": "string",
          "required": false,
          "default": "\"00:00\"",
          "allowedValues": null,
          "description": "Starting value of the session clock, \"mm:ss\" or \"h:mm:ss\"",
          "callback": false
        },
        {
          "name": "running",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled running state",
          "callback": false
        },
        {
          "name": "defaultRunning",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial running state (uncontrolled)",
          "callback": false
        },
        {
          "name": "onRunningChange",
          "type": "(running: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when Start or Pause is pressed",
          "callback": true
        },
        {
          "name": "onLogActivity",
          "type": "(seconds: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Log Activity with the session clock in seconds",
          "callback": true
        },
        {
          "name": "flat",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Border instead of shadow",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer content",
          "callback": false
        },
        {
          "name": "as",
          "type": "ElementType",
          "required": false,
          "default": "'section'",
          "allowedValues": null,
          "description": "Root tag name",
          "callback": false
        }
      ],
      "whenToUse": [
        "Care managers logging time on calls and coordination."
      ],
      "whenNotToUse": [
        "RPM time: RPMReadingChart."
      ],
      "accessibility": [
        "Clock not announced every second (aria-live off)."
      ],
      "example": "<CCMTimer patient=\"Ralph Edwards\" month=\"October 2026\" minutes={23} defaultRunning clock=\"07:12\" />",
      "readme": "src/components/CCMTimer/README.md",
      "storybook": "complex-quality-and-care-programs-ccmtimer--docs"
    },
    {
      "name": "CensusList",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "CensusList is the unit or service list of current inpatients with bed, level of care, length of stay against the expected stay, last vitals with flags, isolation and expected discharge.",
      "import": "import { CensusList } from 'health-components';",
      "element": {
        "tag": "co-census-list",
        "events": [
          "co-filter-change",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "rows",
          "type": "CensusRow[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array of { bed, name, mrn, age, sex, dx, level, pendingTo, los, gmlos, vitals: [{ measure, value }], isolation, organism, attending, edd, dischargeToday }; required",
          "callback": false
        },
        {
          "name": "defaultFilter",
          "type": "CensusFilter",
          "required": false,
          "default": "'all'",
          "allowedValues": [
            "flag",
            "all",
            "dc",
            "iso",
            "obs"
          ],
          "description": "'all' | 'dc' | 'iso' | 'flag' | 'obs': starting filter (uncontrolled)",
          "callback": false
        },
        {
          "name": "filter",
          "type": "CensusFilter",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "flag",
            "all",
            "dc",
            "iso",
            "obs"
          ],
          "description": "Filter (controlled)",
          "callback": false
        },
        {
          "name": "onFilterChange",
          "type": "(filter: CensusFilter) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new filter",
          "callback": true
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows skeleton rows",
          "callback": false
        },
        {
          "name": "pageSize",
          "type": "number",
          "required": false,
          "default": "10",
          "allowedValues": null,
          "description": "Rows per page",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Census'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Hospitalist and charge nurse lists, handoff, discharge huddles."
      ],
      "whenNotToUse": [
        "Bed-by-bed layout: BedBoard."
      ],
      "accessibility": [
        "Built on DataTable: sortable headers with aria-sort.",
        "Flags are read out (\"Heart rate 132 bpm, Critical high\")."
      ],
      "example": "<CensusList rows={census} subtitle=\"Hospital Medicine, Team B\" />",
      "readme": "src/components/CensusList/README.md",
      "storybook": "complex-inpatient-flow-censuslist--docs"
    },
    {
      "name": "ChartCard",
      "layer": "complex",
      "group": "Dashboards",
      "summary": "ChartCard wraps any chart in a Card with a title, period switch, loading and empty states, and a source line.",
      "import": "import { ChartCard } from 'health-components';",
      "element": {
        "tag": "co-chart-card",
        "events": [
          "co-period"
        ],
        "slots": [
          "subtitle",
          "source",
          "actions",
          "(default)",
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Card title, what the chart shows (\"Denials by payer\"). Required",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "periods",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Period choices shown as a small SegmentedControl (\"7d\", \"30d\", \"90d\")",
          "callback": false
        },
        {
          "name": "period",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected period (controlled)",
          "callback": false
        },
        {
          "name": "defaultPeriod",
          "type": "string",
          "required": false,
          "default": "the first period",
          "allowedValues": null,
          "description": "Initially selected period (uncontrolled)",
          "callback": false
        },
        {
          "name": "onPeriod",
          "type": "(period: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(p) => void: called with the new period",
          "callback": true
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a skeleton instead of the chart",
          "callback": false
        },
        {
          "name": "empty",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Empty message; shows an EmptyState instead of the chart",
          "callback": false
        },
        {
          "name": "source",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Muted line naming the data source and time",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Header actions, shown after the period switch",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "The chart.",
          "callback": false
        },
        {
          "name": "flat",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Border instead of shadow",
          "callback": false
        },
        {
          "name": "padding",
          "type": "CardPadding",
          "required": false,
          "default": "'default'",
          "allowedValues": [
            "compact",
            "default",
            "none"
          ],
          "description": "'default' | 'compact' (10px) | 'none' (edge-to-edge tables)",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer content",
          "callback": false
        },
        {
          "name": "as",
          "type": "ElementType",
          "required": false,
          "default": "'section'",
          "allowedValues": null,
          "description": "Root tag name",
          "callback": false
        }
      ],
      "whenToUse": [
        "Every chart on a dashboard."
      ],
      "whenNotToUse": [
        "A single number: StatCard."
      ],
      "accessibility": [
        "Chart inside carries its own aria text."
      ],
      "example": "<ChartCard title=\"Denials by payer\" periods={[\"7d\", \"30d\", \"90d\"]} source=\"Source: ERA 835 files, posted 10/09/2026\">\n  <BarChart data={denials} />\n</ChartCard>",
      "readme": "src/components/ChartCard/README.md",
      "storybook": "complex-dashboards-chartcard--docs"
    },
    {
      "name": "ChartSummary",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "ChartSummary is the one-page, problem-oriented summary: each active problem with the results, medications, plan and care gap that belong to it, plus allergies, code status and last vitals.",
      "import": "import { ChartSummary } from 'health-components';",
      "element": {
        "tag": "co-chart-summary",
        "events": [],
        "slots": [
          "actions"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "problems",
          "type": "ChartSummaryProblem[]",
          "required": false,
          "default": "none (empty state)",
          "allowedValues": null,
          "description": "Active problems with their results, medications, plan and gap",
          "callback": false
        },
        {
          "name": "allergies",
          "type": "ChartSummaryAllergy[]",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Allergies. undefined = not reviewed, [] = No Known Allergies",
          "callback": false
        },
        {
          "name": "vitals",
          "type": "ChartSummaryVital[]",
          "required": false,
          "default": "none ('No vitals this year')",
          "allowedValues": null,
          "description": "Last recorded vitals",
          "callback": false
        },
        {
          "name": "vitalsTaken",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "When the vitals were taken",
          "callback": false
        },
        {
          "name": "codeStatus",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Code status ('DNR/DNI')",
          "callback": false
        },
        {
          "name": "gaps",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Care gaps not tied to one problem",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Chart Summary'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card subtitle (patient, age, MRN)",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Header actions",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Chart landing page, pre-visit review, handoff and consult reading."
      ],
      "whenNotToUse": [
        "Editing problems: ProblemListEditor. Long result history: ResultsTrendPanel."
      ],
      "accessibility": [
        "Each problem is a group with its code read before the words.",
        "Flags are read in words, such as \"9.1 %, High\"."
      ],
      "example": "<ChartSummary problems={problems} allergies={allergies} vitals={[{ code: \"SBP\", value: 148 }]} codeStatus=\"Full code\" />",
      "readme": "src/components/ChartSummary/README.md",
      "storybook": "complex-chart-panels-chartsummary--docs"
    },
    {
      "name": "ChatMessage",
      "layer": "basic",
      "group": "Mobile",
      "summary": "ChatMessage is one bubble in a secure message thread: incoming, outgoing, AI or system.",
      "import": "import { ChatMessage } from 'health-components';",
      "element": {
        "tag": "co-chat-message",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "direction",
          "type": "'in' | 'out'",
          "required": false,
          "default": "'in'",
          "allowedValues": [
            "in",
            "out"
          ],
          "description": "'in' (received, left) | 'out' (sent, right)",
          "callback": false
        },
        {
          "name": "author",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Sender name, shown with an avatar on incoming messages",
          "callback": false
        },
        {
          "name": "time",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Time sent, e.g. \"9:02 AM\"",
          "callback": false
        },
        {
          "name": "status",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Delivery status, outgoing only (\"Sent\", \"Read\")",
          "callback": false
        },
        {
          "name": "ai",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Message written by an AI agent: purple bubble and AI tag",
          "callback": false
        },
        {
          "name": "system",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "System event (\"Henna West started a conversation\")",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Message text",
          "callback": false
        }
      ],
      "whenToUse": [
        "Patient and staff messaging, AI receptionist transcripts."
      ],
      "whenNotToUse": [
        "Clinical notes."
      ],
      "accessibility": [
        "Author and time are text, not only position."
      ],
      "example": "<ChatMessage author=\"Henna West\" time=\"9:02 AM\">Can I get my refill before Friday?</ChatMessage>\n<ChatMessage direction=\"out\" time=\"9:40 AM\" status=\"Read\">Approved.</ChatMessage>",
      "readme": "src/components/ChatMessage/README.md",
      "storybook": "basic-mobile-chatmessage--docs"
    },
    {
      "name": "ChatThread",
      "layer": "complex",
      "group": "Messaging",
      "summary": "ChatThread is a full secure-message conversation: header, message log and composer with optional AI reply suggestion.",
      "import": "import { ChatThread } from 'health-components';",
      "element": {
        "tag": "co-chat-thread",
        "events": [
          "co-messages-change",
          "co-send",
          "co-suggest",
          "co-change",
          "co-input"
        ],
        "slots": [
          "subtitle",
          "lock-text"
        ]
      },
      "aliases": [
        "SecureChatThread"
      ],
      "props": [
        {
          "name": "messages",
          "type": "ChatThreadMessage[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Array<ChatMessage props & {text}> (controlled; pair with onMessagesChange)",
          "callback": false
        },
        {
          "name": "defaultMessages",
          "type": "ChatThreadMessage[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial messages (uncontrolled); the thread appends what the user sends",
          "callback": false
        },
        {
          "name": "onMessagesChange",
          "type": "(messages: ChatThreadMessage[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new list after a send",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "none (no header)",
          "allowedValues": null,
          "description": "Header name (patient or colleague), with an avatar",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Header second line (MRN, reply time)",
          "callback": false
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "\"Write a message\"",
          "allowedValues": null,
          "description": "Composer placeholder",
          "callback": false
        },
        {
          "name": "ai",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the \"Suggest a reply with AI\" button",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Replaces the composer with a lock banner",
          "callback": false
        },
        {
          "name": "lockText",
          "type": "ReactNode",
          "required": false,
          "default": "\"Read-only preview. Sending is blocked for staff.\"",
          "allowedValues": null,
          "description": "Lock banner text",
          "callback": false
        },
        {
          "name": "onSend",
          "type": "(text: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(text) => void: called with the trimmed text when the user sends",
          "callback": true
        },
        {
          "name": "onSuggest",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by the AI button; never sends on its own",
          "callback": true
        }
      ],
      "whenToUse": [
        "Staff to patient and staff to staff messaging."
      ],
      "whenNotToUse": [
        "Comment threads on a record: a Timeline."
      ],
      "accessibility": [
        "The log has role log so new messages are announced."
      ],
      "example": "<ChatThread title=\"Henna West\" subtitle=\"MRN-100231\" ai messages={thread} onSend={text => api.send(text)} />",
      "readme": "src/components/ChatThread/README.md",
      "storybook": "complex-messaging-chatthread--docs"
    },
    {
      "name": "Checkbox",
      "layer": "basic",
      "group": "Selection",
      "summary": "Checkbox turns one option on or off, alone or in a list; it also has an indeterminate state for select-all.",
      "import": "import { Checkbox } from 'health-components';",
      "element": {
        "tag": "co-checkbox",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": [
          "label",
          "description"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; the whole row is clickable. Required",
          "callback": false
        },
        {
          "name": "checked",
          "type": "boolean",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Checked state (controlled); pair with `onChange`",
          "callback": false
        },
        {
          "name": "defaultChecked",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial checked state (uncontrolled)",
          "callback": false
        },
        {
          "name": "indeterminate",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Mixed state, for \"select all\" when only some items are selected",
          "callback": false
        },
        {
          "name": "description",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Help text under the label",
          "callback": false
        },
        {
          "name": "error",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Marks the input invalid (aria-invalid)",
          "callback": false
        },
        {
          "name": "disabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables the checkbox",
          "callback": false
        }
      ],
      "whenToUse": [
        "Independent yes/no options: \"Send reminder by SMS\", \"Patient declined\".",
        "Selecting table rows."
      ],
      "whenNotToUse": [
        "A setting that takes effect at once: Switch.",
        "One choice from several: RadioGroup."
      ],
      "accessibility": [
        "Native input inside its label, so the whole row is clickable."
      ],
      "example": "<Checkbox label=\"Send reminder by SMS\" checked={sms} onChange={e => setSms(e.target.checked)} />",
      "readme": "src/components/Checkbox/README.md",
      "storybook": "basic-selection-checkbox--docs"
    },
    {
      "name": "CheckInStepper",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "CheckInStepper is the front desk check-in checklist: steps, issues per step and Complete Check-In.",
      "import": "import { CheckInStepper } from 'health-components';",
      "element": {
        "tag": "co-check-in-stepper",
        "events": [
          "co-item-action",
          "co-complete"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient name, shown in the title. Required",
          "callback": false
        },
        {
          "name": "appt",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Appointment line under the title. Required",
          "callback": false
        },
        {
          "name": "steps",
          "type": "string[]",
          "required": false,
          "default": "Arrived, Demographics, Insurance, Forms, Copay, Ready",
          "allowedValues": null,
          "description": "Step labels",
          "callback": false
        },
        {
          "name": "current",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Current step, 0-based",
          "callback": false
        },
        {
          "name": "issues",
          "type": "number[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Indexes of steps with issues (they show the error state and block Complete Check-In)",
          "callback": false
        },
        {
          "name": "items",
          "type": "CheckInItem[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Checklist lines",
          "callback": false
        },
        {
          "name": "done",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Check-in complete: the tag reads Checked In instead of Arrived",
          "callback": false
        },
        {
          "name": "onItemAction",
          "type": "(item: CheckInItem, index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the item and its index when its action button is pressed",
          "callback": true
        },
        {
          "name": "onComplete",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Complete Check-In is pressed (enabled only with no issues)",
          "callback": true
        }
      ],
      "whenToUse": [
        "Front desk check-in."
      ],
      "whenNotToUse": [
        "Patient self check-in: KioskStep."
      ],
      "accessibility": [
        "Each item has icon label Done or Needs attention."
      ],
      "example": "<CheckInStepper patient=\"Henna West\" appt=\"9:20 AM with Dr. Bell\" current={2} issues={[2]} items={checks} />",
      "readme": "src/components/CheckInStepper/README.md",
      "storybook": "complex-scheduling-checkinstepper--docs"
    },
    {
      "name": "ClaimForm",
      "layer": "complex",
      "group": "Revenue",
      "summary": "ClaimForm is the claim line-item editor: DOS, CPT, modifiers, diagnosis pointers, units and charge per line, with totals, claim check and submit.",
      "import": "import { ClaimForm } from 'health-components';",
      "element": {
        "tag": "co-claim-form",
        "events": [
          "co-change",
          "co-save-draft",
          "co-submit"
        ],
        "slots": []
      },
      "aliases": [
        "ClaimLineEditor"
      ],
      "props": [
        {
          "name": "lines",
          "type": "ClaimLine[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Service lines (controlled): Array<{dos, cpt, mods?, dx?, units, charge, errors?: Record<field, string>}>",
          "callback": false
        },
        {
          "name": "defaultLines",
          "type": "ClaimLine[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial service lines (uncontrolled)",
          "callback": false
        },
        {
          "name": "payerOrder",
          "type": "\"Primary\" | \"Secondary\" | \"Tertiary\"",
          "required": false,
          "default": "'Primary'",
          "allowedValues": [
            "Primary",
            "Secondary",
            "Tertiary"
          ],
          "description": "'Primary' | 'Secondary' | 'Tertiary' (SBR01)",
          "callback": false
        },
        {
          "name": "frequency",
          "type": "string",
          "required": false,
          "default": "'1 Original'",
          "allowedValues": null,
          "description": "Claim frequency (CLM05-3), such as \"7 Corrected\"",
          "callback": false
        },
        {
          "name": "errorsCount",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Claim check error count; 0 shows \"Claim check passed\"",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Lock banner, read-only inputs, no buttons",
          "callback": false
        },
        {
          "name": "lockText",
          "type": "string",
          "required": false,
          "default": "\"Your role can view this claim but not edit it.\"",
          "allowedValues": null,
          "description": "Lock banner text when readOnly",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(lines: ClaimLine[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with all lines after an edit, add or remove",
          "callback": true
        },
        {
          "name": "onSaveDraft",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Save Draft",
          "callback": true
        },
        {
          "name": "onSubmit",
          "type": "(action: ClaimSubmitAction) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Submit Claim and its menu items",
          "callback": true
        }
      ],
      "whenToUse": [
        "Creating or correcting a professional claim."
      ],
      "whenNotToUse": [
        "Read-only claim lists: DataTable."
      ],
      "accessibility": [
        "Every cell input is named \"<field> line N\"; errors set aria-invalid and a title."
      ],
      "example": "<ClaimForm payerOrder=\"Primary\" frequency=\"1 Original\" errorsCount={check.errors.length}\n  lines={[{ dos: \"10/06/2026\", cpt: \"99214\", mods: \"25\", dx: \"A,B\", units: 1, charge: 182 }]} onChange={setLines} />",
      "readme": "src/components/ClaimForm/README.md",
      "storybook": "complex-revenue-claimform--docs"
    },
    {
      "name": "ClaimStatusTag",
      "layer": "complex",
      "group": "Revenue",
      "summary": "ClaimStatusTag names where a claim is in the X12 cycle: 837 sent, 999 accepted or rejected, 277CA, 277 pending and 835 paid, partial or denied.",
      "import": "import { ClaimStatusTag } from 'health-components';",
      "element": {
        "tag": "co-claim-status-tag",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "status",
          "type": "ClaimStatus | (string & {})",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "One of `ClaimStatusTag.statuses`; other strings render neutral without an icon. Required",
          "callback": false
        },
        {
          "name": "size",
          "type": "BadgeSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        },
        {
          "name": "shape",
          "type": "BadgeShape",
          "required": false,
          "default": "'square'",
          "allowedValues": [
            "square",
            "pill"
          ],
          "description": "'square' | 'pill'",
          "callback": false
        },
        {
          "name": "dot",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a small dot in the current colour before the label (ignored when `icon` is set)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Claim lists and claim detail."
      ],
      "whenNotToUse": [
        "Simple business status: StatusTag kind claim."
      ],
      "accessibility": [
        "Icon plus words; title explains the step."
      ],
      "example": "<ClaimStatusTag status=\"Rejected (277CA)\" />",
      "readme": "src/components/ClaimStatusTag/README.md",
      "storybook": "complex-revenue-claimstatustag--docs"
    },
    {
      "name": "ClinicalDecisionSupportCard",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "ClinicalDecisionSupportCard renders one CDS Hooks card: info, warning or critical indicator, summary, detail, the values behind it, suggestions to apply, links, and an override that needs a reason.",
      "import": "import { ClinicalDecisionSupportCard } from 'health-components';",
      "element": {
        "tag": "co-clinical-decision-support-card",
        "events": [
          "co-state-change",
          "co-override",
          "co-accept",
          "co-link"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "card",
          "type": "CdsCard",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The CDS Hooks card; required",
          "callback": false
        },
        {
          "name": "state",
          "type": "CdsCardState",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "open",
            "accepted",
            "overridden"
          ],
          "description": "Card state (controlled): 'open' | 'accepted' | 'overridden'",
          "callback": false
        },
        {
          "name": "defaultState",
          "type": "CdsCardState",
          "required": false,
          "default": "'open'",
          "allowedValues": [
            "open",
            "accepted",
            "overridden"
          ],
          "description": "Initial state",
          "callback": false
        },
        {
          "name": "onStateChange",
          "type": "(state: CdsCardState) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the state changes",
          "callback": true
        },
        {
          "name": "overrideReason",
          "type": "string",
          "required": false,
          "default": "'recorded'",
          "allowedValues": null,
          "description": "Reason shown for an already overridden card",
          "callback": false
        },
        {
          "name": "onOverride",
          "type": "(reasonCode: string, text?: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the reason code ('other' plus the typed text for Other) when the user overrides",
          "callback": true
        },
        {
          "name": "onAccept",
          "type": "(suggestion: CdsSuggestion) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the suggestion the user applies",
          "callback": true
        },
        {
          "name": "onLink",
          "type": "(link: CdsLink) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a link without `url` is clicked",
          "callback": true
        },
        {
          "name": "feedback",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Shows 'Overrides are logged with the reason.'",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Showing a CDS Hooks service response at order-select, order-sign or patient-view."
      ],
      "whenNotToUse": [
        "Drug-drug or allergy checks inside e-prescribing: DrugInteractionAlert."
      ],
      "accessibility": [
        "Critical cards use role alert; others are labelled regions.",
        "Values carry their flag in words and show the reference range."
      ],
      "example": "<ClinicalDecisionSupportCard card={hooksCard} onOverride={log} />",
      "readme": "src/components/ClinicalDecisionSupportCard/README.md",
      "storybook": "complex-chart-panels-clinicaldecisionsupportcard--docs"
    },
    {
      "name": "ClinicalValue",
      "layer": "complex",
      "group": "Clinical values",
      "summary": "ClinicalValue shows one clinical measurement with its unit, fixed precision, abnormal flag, trend and reference range, formatted by the shared CareOS.fmt rules.",
      "import": "import { ClinicalValue } from 'health-components';",
      "element": {
        "tag": "co-clinical-value",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "value",
          "type": "number | null",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The measured number, unrounded: fmt rounds it to the measure's precision; required",
          "callback": false
        },
        {
          "name": "measure",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Key of fmt.MEASURES ('potassium', 'temp', 'bpSys'...) or a range-registry key/alias",
          "callback": false
        },
        {
          "name": "loinc",
          "type": "string",
          "required": false,
          "default": "the measure's LOINC",
          "allowedValues": null,
          "description": "LOINC code; finds the measure when `measure` is absent",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": "the measure's unit. A different unit drops the sample range (it is in the measure's unit) unless a lab range is passed",
          "allowedValues": null,
          "description": "UCUM unit code of `value`",
          "callback": false
        },
        {
          "name": "precision",
          "type": "number",
          "required": false,
          "default": "the measure's precision, else 0",
          "allowedValues": null,
          "description": "Decimals",
          "callback": false
        },
        {
          "name": "refLow",
          "type": "number",
          "required": false,
          "default": "from the registry",
          "allowedValues": null,
          "description": "Lab reference low (FHIR Observation.referenceRange); with `refHigh` it replaces the registry range in every context",
          "callback": false
        },
        {
          "name": "refHigh",
          "type": "number",
          "required": false,
          "default": "from the registry",
          "allowedValues": null,
          "description": "Lab reference high",
          "callback": false
        },
        {
          "name": "critLow",
          "type": "number",
          "required": false,
          "default": "the registry's critical low for the context",
          "allowedValues": null,
          "description": "Lab critical low",
          "callback": false
        },
        {
          "name": "critHigh",
          "type": "number",
          "required": false,
          "default": "the registry's critical high for the context",
          "allowedValues": null,
          "description": "Lab critical high",
          "callback": false
        },
        {
          "name": "flag",
          "type": "FlagCode",
          "required": false,
          "default": "computed",
          "allowedValues": [
            "N",
            "L",
            "H",
            "LL",
            "HH",
            "A",
            "AA"
          ],
          "description": "Lab flag; overrides the computed one ('A'/'AA' for results with no direction)",
          "callback": false
        },
        {
          "name": "trend",
          "type": "ClinicalValueTrend",
          "required": false,
          "default": "none",
          "allowedValues": [
            "up",
            "down",
            "stable"
          ],
          "description": "Trend arrow, read as rising / falling / unchanged",
          "callback": false
        },
        {
          "name": "delta",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Change text shown after the arrow ('+0.6')",
          "callback": false
        },
        {
          "name": "timestamp",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "ISO time of the result, shown in the tooltip and meta line",
          "callback": false
        },
        {
          "name": "timeZone",
          "type": "string",
          "required": false,
          "default": "the browser zone",
          "allowedValues": null,
          "description": "IANA zone for the timestamp",
          "callback": false
        },
        {
          "name": "source",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Performing lab or device",
          "callback": false
        },
        {
          "name": "status",
          "type": "ClinicalValueStatus",
          "required": false,
          "default": "'final'",
          "allowedValues": [
            "final",
            "preliminary",
            "entered-in-error"
          ],
          "description": "Result status; 'entered-in-error' strikes the value through, greys it and never flags it",
          "callback": false
        },
        {
          "name": "size",
          "type": "ClinicalValueSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "lg"
          ],
          "description": "'sm' | 'md' | 'lg'",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "the measure label",
          "allowedValues": null,
          "description": "Label override",
          "callback": false
        },
        {
          "name": "showMeta",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Second line with range, time and source",
          "callback": false
        },
        {
          "name": "showLabel",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the measure name before the value",
          "callback": false
        },
        {
          "name": "showNormal",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the N flag for normal values",
          "callback": false
        },
        {
          "name": "tooltip",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Range tooltip on hover and focus",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the nearest RangeContextProvider, else the global setRangeContext, else `defaultRangeContext`, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which registry range applies: 'outpatient' | 'inpatient' | 'ed' | 'pediatric' | 'pregnancy'. The lab range (refLow/refHigh) still wins",
          "callback": false
        },
        {
          "name": "defaultRangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "context, used only when no prop, provider or global context applies; default none",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "The containing set's",
          "callback": false
        },
        {
          "name": "ageYears",
          "type": "number",
          "required": false,
          "default": "none (oldest band)",
          "allowedValues": null,
          "description": "Age in years; picks the pediatric band in the 'pediatric' context",
          "callback": false
        },
        {
          "name": "flagVariant",
          "type": "AbnormalFlagVariant",
          "required": false,
          "default": "'compact'",
          "allowedValues": [
            "compact",
            "full"
          ],
          "description": "Flag variant for non-critical flags (critical flags always show the word)",
          "callback": false
        },
        {
          "name": "display",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Preformatted text shown instead of the formatted value (e.g. '>1000')",
          "callback": false
        }
      ],
      "whenToUse": [
        "Any vital sign, lab result or score shown on a screen: banner, flowsheet, result inbox, chart summary, mobile.",
        "Inside DataTable cells, StatCards and VitalsPanel tiles."
      ],
      "whenNotToUse": [
        "Medication doses: use DoseDisplay (different trailing-zero rule).",
        "Money: MoneyDisplay. Dates and ages: DateTimeClinical.",
        "Free-text or coded results (Positive, Detected): show text with AbnormalFlag A."
      ],
      "accessibility": [
        "The value, unit and flag are read as one sentence (\"Potassium 5.4 mmol/L, High\"); the visual parts are aria-hidden.",
        "The range tooltip opens on focus as well as hover.",
        "Flags carry letter, icon and word; colour is never the only signal.",
        "Trend arrows have a text equivalent (rising, falling, unchanged)."
      ],
      "example": "<ClinicalValue measure=\"potassium\" value={5.4} trend=\"up\" delta=\"+0.6\"\n  timestamp=\"2026-10-09T13:40:00Z\" timeZone=\"America/Chicago\" source=\"Quest\" showMeta />",
      "readme": "src/components/ClinicalValue/README.md",
      "storybook": "complex-clinical-values-clinicalvalue--docs"
    },
    {
      "name": "CodeBlueTimer",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "CodeBlueTimer runs a resuscitation: elapsed time, the 2-minute CPR cycle, time since epinephrine, rhythm and shocks, one-tap event logging, and the event log for the code record.",
      "import": "import { CodeBlueTimer } from 'health-components';",
      "element": {
        "tag": "co-code-blue-timer",
        "events": [
          "co-events-change",
          "co-event",
          "co-rosc"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient ('Ruiz, Carmen, 81 F'); required",
          "callback": false
        },
        {
          "name": "location",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Location ('4 West 404B'); required",
          "callback": false
        },
        {
          "name": "startedAt",
          "type": "number",
          "required": false,
          "default": "when the component mounts",
          "allowedValues": null,
          "description": "When the code started, epoch ms",
          "callback": false
        },
        {
          "name": "now",
          "type": "number",
          "required": false,
          "default": "live",
          "allowedValues": null,
          "description": "Freezes the clock at this epoch ms (for review and tests)",
          "callback": false
        },
        {
          "name": "events",
          "type": "CodeEvent[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { t: seconds, text, by }: the starting log (uncontrolled)",
          "callback": false
        },
        {
          "name": "eventsValue",
          "type": "CodeEvent[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "The log (controlled); pair with onEventsChange",
          "callback": false
        },
        {
          "name": "onEventsChange",
          "type": "(events: CodeEvent[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new log when an event is added",
          "callback": true
        },
        {
          "name": "rhythm",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Current rhythm ('VF', 'PEA')",
          "callback": false
        },
        {
          "name": "energy",
          "type": "string | number",
          "required": false,
          "default": "none (200 in the shock log)",
          "allowedValues": null,
          "description": "Defibrillator energy, joules biphasic",
          "callback": false
        },
        {
          "name": "vitals",
          "type": "InpatientMeasureValue[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { measure, value }: monitor values",
          "callback": false
        },
        {
          "name": "team",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "string[]: the team",
          "callback": false
        },
        {
          "name": "ended",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Outcome; ends the code (header shows it, actions hidden, clock stops)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Review of a past code: no actions",
          "callback": false
        },
        {
          "name": "onEvent",
          "type": "(event: CodeEvent) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with each new event",
          "callback": true
        },
        {
          "name": "onRosc",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by ROSC",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "The recorder screen during a cardiac arrest."
      ],
      "whenNotToUse": [
        "A deteriorating patient who still has a pulse: RapidResponsePanel."
      ],
      "accessibility": [
        "Elapsed time is role timer; the log is a polite live region so new events are read once.",
        "Buttons are large and labelled with the drug and dose."
      ],
      "example": "<CodeBlueTimer patient=\"Ruiz, Carmen, 81 F\" location=\"4 West 404B\" startedAt={codeStart} rhythm=\"VF\" energy={200} />",
      "readme": "src/components/CodeBlueTimer/README.md",
      "storybook": "complex-inpatient-flow-codebluetimer--docs"
    },
    {
      "name": "CodeDisplay",
      "layer": "basic",
      "group": "Clinical values",
      "summary": "CodeDisplay shows a clinical or billing code with its code system label and description: ICD-10-CM, CPT, HCPCS, LOINC, SNOMED CT, RxNorm and NDC.",
      "import": "import { CodeDisplay } from 'health-components';",
      "element": {
        "tag": "co-code-display",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "system",
          "type": "CodeDisplaySystem",
          "required": true,
          "default": null,
          "allowedValues": [
            "icd10",
            "cpt",
            "hcpcs",
            "loinc",
            "snomed",
            "rxnorm",
            "ndc"
          ],
          "description": "'icd10' | 'cpt' | 'hcpcs' | 'loinc' | 'snomed' | 'rxnorm' | 'ndc'; required",
          "callback": false
        },
        {
          "name": "code",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The code; ICD-10 gets its dot and an 11-digit NDC shows 5-4-2; required",
          "callback": false
        },
        {
          "name": "display",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Description (use licensed short text for CPT)",
          "callback": false
        },
        {
          "name": "variant",
          "type": "CodeDisplayVariant",
          "required": false,
          "default": "'inline'",
          "allowedValues": [
            "inline",
            "stacked"
          ],
          "description": "'inline' (tag, code, description on one line) | 'stacked' (description below)",
          "callback": false
        },
        {
          "name": "showSystem",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Shows the system tag",
          "callback": false
        },
        {
          "name": "status",
          "type": "'active' | 'inactive'",
          "required": false,
          "default": "'active'",
          "allowedValues": [
            "active",
            "inactive"
          ],
          "description": "'active' | 'inactive' (amber Inactive code note)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Problem list, claim lines, order details, result headers, medication details."
      ],
      "whenNotToUse": [
        "Code search and pick: Combobox."
      ],
      "accessibility": [
        "The system tag is an abbr whose title is the FHIR system URI."
      ],
      "example": "<CodeDisplay system=\"icd10\" code=\"E119\" display=\"Type 2 diabetes mellitus without complications\" />",
      "readme": "src/components/CodeDisplay/README.md",
      "storybook": "basic-clinical-values-codedisplay--docs"
    },
    {
      "name": "CodeStatusBanner",
      "layer": "complex",
      "group": "Clinical",
      "summary": "CodeStatusBanner shows code status and advance directive, red for DNR, DNI or comfort care and green for Full Code.",
      "import": "import { CodeStatusBanner } from 'health-components';",
      "element": {
        "tag": "co-code-status-banner",
        "events": [
          "co-view-documents"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "status",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Code status (\"Full Code\", \"DNR / DNI\", \"Comfort care\"). DNR, DNI or Comfort turn the banner red. Required",
          "callback": false
        },
        {
          "name": "directive",
          "type": "string",
          "required": false,
          "default": "none (\"No advance directive on file\")",
          "allowedValues": null,
          "description": "Advance directive on file (\"Living will on file\")",
          "callback": false
        },
        {
          "name": "polst",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Date the POLST was signed",
          "callback": false
        },
        {
          "name": "proxy",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Health care proxy name and relationship",
          "callback": false
        },
        {
          "name": "onViewDocuments",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by the View Documents button",
          "callback": true
        },
        {
          "name": "documentsHref",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Makes View Documents a link to the signed documents",
          "callback": false
        }
      ],
      "whenToUse": [
        "Top of chart, inpatient-style handoff, on-call mobile."
      ],
      "whenNotToUse": [
        "Inside lists: Badge."
      ],
      "accessibility": [
        "DNR uses role alert."
      ],
      "example": "<CodeStatusBanner status=\"DNR / DNI\" polst=\"03/02/2026\" proxy=\"Maria Edwards (wife)\" />",
      "readme": "src/components/CodeStatusBanner/README.md",
      "storybook": "complex-clinical-codestatusbanner--docs"
    },
    {
      "name": "Combobox",
      "layer": "basic",
      "group": "Inputs",
      "summary": "Combobox is a search field with a result list, for finding a patient or an ICD-10 or CPT code.",
      "import": "import { Combobox } from 'health-components';",
      "element": {
        "tag": "co-combobox",
        "events": [
          "co-query-change",
          "co-open-change",
          "co-select",
          "co-input"
        ],
        "slots": [
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; required",
          "callback": false
        },
        {
          "name": "kind",
          "type": "ComboboxKind",
          "required": false,
          "default": "'plain'",
          "allowedValues": [
            "patient",
            "code",
            "plain"
          ],
          "description": "'patient' (avatar per row) | 'code' (code chip) | 'plain'",
          "callback": false
        },
        {
          "name": "options",
          "type": "ComboboxOption[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{value?, label, meta?, code?, flag?, flagTone?}>; required",
          "callback": false
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Example text in the empty input",
          "callback": false
        },
        {
          "name": "query",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled query text",
          "callback": false
        },
        {
          "name": "defaultQuery",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial query (uncontrolled)",
          "callback": false
        },
        {
          "name": "onQueryChange",
          "type": "(query: string) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the query text changes",
          "callback": true
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled open state of the list",
          "callback": false
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Open on first render (uncontrolled)",
          "callback": false
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the list opens or closes",
          "callback": true
        },
        {
          "name": "onSelect",
          "type": "(option: ComboboxOption) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen option",
          "callback": true
        },
        {
          "name": "limit",
          "type": "number",
          "required": false,
          "default": "8",
          "allowedValues": null,
          "description": "Maximum results shown",
          "callback": false
        },
        {
          "name": "emptyText",
          "type": "string",
          "required": false,
          "default": "\"No matches. Check the spelling or search by MRN.\"",
          "allowedValues": null,
          "description": "Text when nothing matches",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Node under the list (\"Search all 4,212 patients\")",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message (as TextField)",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Muted hint under the field",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk plus aria-required",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Picking from a long list by typing: patients, ICD-10, CPT, payers, pharmacies."
      ],
      "whenNotToUse": [
        "Short fixed lists: Select."
      ],
      "accessibility": [
        "ARIA combobox pattern: role combobox, aria-expanded, aria-controls, aria-activedescendant; options have role option.",
        "Arrow keys move, Enter picks, Escape closes.",
        "A name match is a candidate, not a confirmed patient. Show DOB and MRN in every row so staff confirm identity before opening the chart."
      ],
      "example": "<Combobox label=\"Patient\" kind=\"patient\" options={patients.map(p => ({ value: p.id, label: p.name, meta: p.dob + \" . \" + p.mrn }))} onSelect={openChart} />\n<Combobox label=\"Diagnosis (ICD-10)\" kind=\"code\" options={icd10} onSelect={addDx} />",
      "readme": "src/components/Combobox/README.md",
      "storybook": "basic-inputs-combobox--docs"
    },
    {
      "name": "CommandPalette",
      "layer": "complex",
      "group": "Navigation",
      "summary": "CommandPalette is the Command Bar style's \"Jump to anything\" search for screens, patients and actions, opened with Ctrl K or Cmd K.",
      "import": "import { CommandPalette } from 'health-components';",
      "element": {
        "tag": "co-command-palette",
        "events": [
          "co-query-change",
          "co-select",
          "co-close",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "T[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The search index. Required.",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the palette is shown",
          "callback": false
        },
        {
          "name": "query",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Query (controlled)",
          "callback": false
        },
        {
          "name": "defaultQuery",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial query when uncontrolled",
          "callback": false
        },
        {
          "name": "onQueryChange",
          "type": "(query: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called on every keystroke",
          "callback": true
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "\"Jump to a screen, patient or action\"",
          "allowedValues": null,
          "description": "Input placeholder and accessible name",
          "callback": false
        },
        {
          "name": "onSelect",
          "type": "(item: T) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen item (Enter or click)",
          "callback": true
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called on Escape and a scrim press",
          "callback": true
        },
        {
          "name": "maxResults",
          "type": "number",
          "required": false,
          "default": "9",
          "allowedValues": null,
          "description": "Most results shown",
          "callback": false
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Render in place for docs: no portal, focus trap, scroll lock or Escape",
          "callback": false
        },
        {
          "name": "ref",
          "type": "Ref<HTMLDivElement>",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "",
          "callback": false
        }
      ],
      "whenToUse": [
        "Command Bar style, and as a shortcut in every style."
      ],
      "whenNotToUse": [
        "Patient search inside a form: Combobox."
      ],
      "accessibility": [
        "combobox with listbox; arrows, Enter, Escape. Key hints in the footer."
      ],
      "example": "{open && <CommandPalette items={searchIndex} onSelect={go} onClose={() => setOpen(false)} />}  // open on Ctrl K / Cmd K",
      "readme": "src/components/CommandPalette/README.md",
      "storybook": "complex-navigation-commandpalette--docs"
    },
    {
      "name": "ConsentSigner",
      "layer": "complex",
      "group": "Clinical",
      "summary": "ConsentSigner shows a consent document in a scroll box with agree, signature and guardian fields.",
      "import": "import { ConsentSigner } from 'health-components';",
      "element": {
        "tag": "co-consent-signer",
        "events": [
          "co-agreed-change",
          "co-signed-change",
          "co-sign-consent",
          "co-decline"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Consent title (\"Consent for Telehealth Services\"); also names the document region. Required",
          "callback": false
        },
        {
          "name": "version",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Version and effective date (\"Version 3 . effective 01/01/2026\"). Required",
          "callback": false
        },
        {
          "name": "body",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Consent text; blank lines separate paragraphs. Required",
          "callback": false
        },
        {
          "name": "signer",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Name of the person signing. Required",
          "callback": false
        },
        {
          "name": "guardian",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Relationship to the patient; shows the guardian field when set",
          "callback": false
        },
        {
          "name": "agreed",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Agree box ticked initially (uncontrolled)",
          "callback": false
        },
        {
          "name": "agreedValue",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Agree box state (controlled)",
          "callback": false
        },
        {
          "name": "onAgreedChange",
          "type": "(agreed: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the agree box changes",
          "callback": true
        },
        {
          "name": "signed",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Signature present initially (uncontrolled)",
          "callback": false
        },
        {
          "name": "onSignedChange",
          "type": "(signed: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the signature is added or cleared",
          "callback": true
        },
        {
          "name": "agreeLabel",
          "type": "string",
          "required": false,
          "default": "\"I have read and agree to this consent.\"",
          "allowedValues": null,
          "description": "Agree box label",
          "callback": false
        },
        {
          "name": "signerLabel",
          "type": "string",
          "required": false,
          "default": "\"Patient Signature\"",
          "allowedValues": null,
          "description": "Signature pad label",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shorter signature pad",
          "callback": false
        },
        {
          "name": "onSignConsent",
          "type": "(signature: ConsentSignature) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Sign Consent (enabled once agreed and signed)",
          "callback": true
        },
        {
          "name": "onDecline",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Decline",
          "callback": true
        }
      ],
      "whenToUse": [
        "Consent to treat, telehealth consent, HIPAA notice, financial policy."
      ],
      "whenNotToUse": [
        "Unsigned information pages."
      ],
      "accessibility": [
        "Document region is focusable for keyboard scroll."
      ],
      "example": "<ConsentSigner title=\"Telehealth Consent\" version=\"v3, 01/2026\" body={text} signer=\"Henna West\" />",
      "readme": "src/components/ConsentSigner/README.md",
      "storybook": "complex-clinical-consentsigner--docs"
    },
    {
      "name": "CopayCollector",
      "layer": "complex",
      "group": "Revenue",
      "summary": "CopayCollector (PatientBalance) shows today's copay, prior balance and total, and collects by card, tap, cash or text link.",
      "import": "import { CopayCollector } from 'health-components';",
      "element": {
        "tag": "co-copay-collector",
        "events": [
          "co-amount-change",
          "co-method-change",
          "co-collect",
          "co-skip"
        ],
        "slots": []
      },
      "aliases": [
        "PatientBalance"
      ],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient (and plan) line under the title. Required",
          "callback": false
        },
        {
          "name": "copay",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Copay due today in dollars. Required",
          "callback": false
        },
        {
          "name": "prior",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Prior balance in dollars",
          "callback": false
        },
        {
          "name": "priorNote",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "What the prior balance is for, e.g. \"09/12 visit, after insurance\"",
          "callback": false
        },
        {
          "name": "plan",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Payment plan note; shows an info Alert",
          "callback": false
        },
        {
          "name": "cardLast4",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card on file, e.g. \"Visa 4242\"",
          "callback": false
        },
        {
          "name": "due",
          "type": "number",
          "required": false,
          "default": "copay",
          "allowedValues": null,
          "description": "Initial amount in the Amount field",
          "callback": false
        },
        {
          "name": "amount",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled, starts at `due`)",
          "allowedValues": null,
          "description": "Controlled amount (field text)",
          "callback": false
        },
        {
          "name": "onAmountChange",
          "type": "(amount: string) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the amount text changes",
          "callback": true
        },
        {
          "name": "method",
          "type": "PaymentMethod",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": [
            "card",
            "text",
            "tap",
            "cash"
          ],
          "description": "Controlled payment method",
          "callback": false
        },
        {
          "name": "defaultMethod",
          "type": "PaymentMethod",
          "required": false,
          "default": "'card'",
          "allowedValues": [
            "card",
            "text",
            "tap",
            "cash"
          ],
          "description": "Initial payment method when uncontrolled",
          "callback": false
        },
        {
          "name": "onMethodChange",
          "type": "(method: PaymentMethod) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the method changes",
          "callback": true
        },
        {
          "name": "onCollect",
          "type": "(collection: CopayCollection) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Collect is pressed",
          "callback": true
        },
        {
          "name": "onSkip",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Skip is pressed (the screen then asks for a reason)",
          "callback": true
        }
      ],
      "whenToUse": [
        "Check-in and checkout."
      ],
      "whenNotToUse": [
        "Posting insurer payments: ERAPostingRow."
      ],
      "accessibility": [
        "Amounts as text."
      ],
      "example": "<CopayCollector patient=\"Henna West\" copay={25} prior={40} cardLast4=\"Visa 4242\" />",
      "readme": "src/components/CopayCollector/README.md",
      "storybook": "complex-revenue-copaycollector--docs"
    },
    {
      "name": "CPTPicker",
      "layer": "complex",
      "group": "Orders and notes",
      "summary": "CPTPicker adds CPT or HCPCS codes as lines with modifiers, units and diagnosis pointers.",
      "import": "import { CPTPicker } from 'health-components';",
      "element": {
        "tag": "co-cpt-picker",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "options",
          "type": "CPTOption[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{code, label, meta?}>: the codes to search. Required",
          "callback": false
        },
        {
          "name": "lines",
          "type": "CPTLine[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array<{code, label, mods?, units?, dx?}>: initial lines (uncontrolled)",
          "callback": false
        },
        {
          "name": "value",
          "type": "CPTLine[]",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled lines",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(lines: CPTLine[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with all lines after a line is added, edited or removed",
          "callback": true
        },
        {
          "name": "telehealth",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the modifier 95 reminder for telehealth visits",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Procedure (CPT / HCPCS)\"",
          "allowedValues": null,
          "description": "Field label",
          "callback": false
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "\"Code or words, such as 99214\"",
          "allowedValues": null,
          "description": "Placeholder of the search input",
          "callback": false
        }
      ],
      "whenToUse": [
        "Coding a visit before the claim."
      ],
      "whenNotToUse": [
        "Full claim editing: ClaimForm."
      ],
      "accessibility": [
        "Inputs named per code."
      ],
      "example": "<CPTPicker options={cpt} lines={[{ code: \"99214\", label: \"Office visit\", mods: \"25\" }]} telehealth />",
      "readme": "src/components/CPTPicker/README.md",
      "storybook": "complex-orders-and-notes-cptpicker--docs"
    },
    {
      "name": "DataTable",
      "layer": "complex",
      "group": "Data",
      "summary": "DataTable lists records with sorting, row selection with bulk actions, a row menu, expandable rows, empty and loading states, and pagination with rows per page.",
      "import": "import { DataTable } from 'health-components';",
      "element": {
        "tag": "co-data-table",
        "events": [
          "co-selected-change",
          "co-expanded-change",
          "co-page-size-change",
          "co-page-change",
          "co-sort-change",
          "co-input"
        ],
        "slots": [
          "bulk-actions",
          "render-expanded",
          "empty-text",
          "empty-state",
          "toolbar"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "columns",
          "type": "ReadonlyArray<DataTableColumn<T>>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{key, label, sortable?, align?, render?, sortValue?}>. Required",
          "callback": false
        },
        {
          "name": "rows",
          "type": "ReadonlyArray<T>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The records. Required",
          "callback": false
        },
        {
          "name": "rowKey",
          "type": "(keyof T & string) | ((row: T) => DataTableRowId)",
          "required": false,
          "default": "\"id\"",
          "allowedValues": null,
          "description": "Field that identifies a row, or a function returning the id",
          "callback": false
        },
        {
          "name": "selectable",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Row checkboxes and a select-all-on-page checkbox",
          "callback": false
        },
        {
          "name": "selected",
          "type": "DataTableRowId[]",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Selected row ids (controlled)",
          "callback": false
        },
        {
          "name": "defaultSelected",
          "type": "DataTableRowId[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initially selected row ids (uncontrolled)",
          "callback": false
        },
        {
          "name": "onSelectedChange",
          "type": "(ids: DataTableRowId[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new selected ids",
          "callback": true
        },
        {
          "name": "bulkActions",
          "type": "(selectedIds: DataTableRowId[]) => ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(selectedIds) => node: actions shown in the bulk bar while rows are selected",
          "callback": false
        },
        {
          "name": "rowMenu",
          "type": "(row: T) => MenuItem[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(row) => MenuItem[]: a kebab menu at the end of each row",
          "callback": false
        },
        {
          "name": "renderExpanded",
          "type": "(row: T) => ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(row) => node: makes rows expandable",
          "callback": false
        },
        {
          "name": "expanded",
          "type": "DataTableRowId[]",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Expanded row ids (controlled)",
          "callback": false
        },
        {
          "name": "defaultExpanded",
          "type": "DataTableRowId[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initially expanded row ids (uncontrolled)",
          "callback": false
        },
        {
          "name": "onExpandedChange",
          "type": "(ids: DataTableRowId[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new expanded ids",
          "callback": true
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows skeleton rows and hides pagination",
          "callback": false
        },
        {
          "name": "emptyText",
          "type": "ReactNode",
          "required": false,
          "default": "\"No records match your search or filters.\"",
          "allowedValues": null,
          "description": "Text when there are no rows",
          "callback": false
        },
        {
          "name": "emptyState",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Node when there are no rows (an EmptyState); wins over emptyText",
          "callback": false
        },
        {
          "name": "pageSize",
          "type": "number",
          "required": false,
          "default": "10",
          "allowedValues": null,
          "description": "Initial rows per page",
          "callback": false
        },
        {
          "name": "pageSizes",
          "type": "readonly number[] | false",
          "required": false,
          "default": "[5, 10, 25, 50]",
          "allowedValues": null,
          "description": "Rows-per-page choices, or false to hide the selector",
          "callback": false
        },
        {
          "name": "onPageSizeChange",
          "type": "(size: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new rows per page",
          "callback": true
        },
        {
          "name": "page",
          "type": "number",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Current page, 1-based (controlled)",
          "callback": false
        },
        {
          "name": "defaultPage",
          "type": "number",
          "required": false,
          "default": "1",
          "allowedValues": null,
          "description": "Initial page (uncontrolled)",
          "callback": false
        },
        {
          "name": "onPageChange",
          "type": "(page: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new page",
          "callback": true
        },
        {
          "name": "pagination",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Paginate the rows",
          "callback": false
        },
        {
          "name": "sort",
          "type": "DataTableSort | null",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Active sort (controlled); null for none",
          "callback": false
        },
        {
          "name": "defaultSort",
          "type": "DataTableSort | null",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial sort {key, dir} (uncontrolled)",
          "callback": false
        },
        {
          "name": "onSortChange",
          "type": "(sort: DataTableSort | null) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new sort",
          "callback": true
        },
        {
          "name": "toolbar",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Toolbar above the table (search, filters); replaced by the bulk bar while rows are selected",
          "callback": false
        },
        {
          "name": "caption",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Screen reader caption",
          "callback": false
        }
      ],
      "whenToUse": [
        "Any list of records staff work through: claims, PA queue, patients, appointments, audit log."
      ],
      "whenNotToUse": [
        "Two or three items: a list in a card.",
        "Phone screens: list rows."
      ],
      "accessibility": [
        "Sort buttons sit inside th with aria-sort.",
        "Row checkboxes are named after the first column (\"Select CLM-20871\").",
        "Row menus are named \"Actions for CLM-20871\".",
        "Numbers are right aligned with tabular figures."
      ],
      "example": "<DataTable rows={claims} rowKey=\"id\" selectable pageSize={10}\n  columns={[{ key: \"id\", label: \"Claim\", sortable: true }, { key: \"status\", label: \"Status\", render: r => <StatusTag kind=\"claim\" status={r.status} /> }]}\n  bulkActions={ids => <Button size=\"sm\" onClick={() => resubmit(ids)}>Resubmit</Button>}\n  rowMenu={r => [{ label: \"Open Claim\", onSelect: () => open(r) }, { divider: true }, { label: \"Void Claim\", danger: true }]}\n  renderExpanded={r => <ClaimLines claim={r} />} />",
      "readme": "src/components/DataTable/README.md",
      "storybook": "complex-data-datatable--docs"
    },
    {
      "name": "DatePicker",
      "layer": "basic",
      "group": "Inputs",
      "summary": "DatePicker takes a date as MM/DD/YYYY by typing or from a month grid.",
      "import": "import { DatePicker } from 'health-components';",
      "element": {
        "tag": "co-date-picker",
        "events": [
          "co-change",
          "co-open-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; required",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled value, MM/DD/YYYY",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial value (uncontrolled), MM/DD/YYYY",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(value: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the MM/DD/YYYY text on typing and on picking a day",
          "callback": true
        },
        {
          "name": "today",
          "type": "string",
          "required": false,
          "default": "the current date",
          "allowedValues": null,
          "description": "Today's date, MM/DD/YYYY (marks the grid, limits past/future)",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled open state of the calendar",
          "callback": false
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Calendar open on first render (uncontrolled)",
          "callback": false
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the calendar opens or closes",
          "callback": true
        },
        {
          "name": "disablePast",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Days before today cannot be picked",
          "callback": false
        },
        {
          "name": "disableFuture",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Days after today cannot be picked (date of birth)",
          "callback": false
        },
        {
          "name": "disableWeekends",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Saturdays and Sundays cannot be picked",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message (as TextField); an impossible typed date shows \"Enter a real date as MM/DD/YYYY.\"",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "'MM/DD/YYYY'",
          "allowedValues": null,
          "description": "Muted hint under the field",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk plus aria-required",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Read-only lock state; the calendar button is disabled",
          "callback": false
        },
        {
          "name": "lockMessage",
          "type": "string",
          "required": false,
          "default": "'Your role can view but not edit'",
          "allowedValues": null,
          "description": "Lock line text when readOnly",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Date of birth, date of service, coverage start and end, follow-up date."
      ],
      "whenNotToUse": [
        "Picking an appointment time: TimeSlotPicker."
      ],
      "accessibility": [
        "Typing always works; the grid is optional.",
        "Grid days are buttons with aria-selected and aria-current=\"date\" for today; month changes are announced.",
        "The check on typed dates proves the date exists on the calendar. It does not prove it is plausible (a DOB of today): add that rule where it matters."
      ],
      "example": "<DatePicker label=\"Date of Birth\" required disableFuture defaultValue=\"03/14/1988\" onChange={setDob} />",
      "readme": "src/components/DatePicker/README.md",
      "storybook": "basic-inputs-datepicker--docs"
    },
    {
      "name": "DateTimeClinical",
      "layer": "basic",
      "group": "Clinical values",
      "summary": "DateTimeClinical shows dates as MM/DD/YYYY, times in 12- or 24-hour form with an optional zone, and ages from date of birth down to days for newborns, plus gestational age.",
      "import": "import { DateTimeClinical } from 'health-components';",
      "element": {
        "tag": "co-date-time-clinical",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "value",
          "type": "string | Date",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Date value: ISO string ('2026-10-09' is a calendar date) or Date; required except in 'gestational' mode",
          "callback": false
        },
        {
          "name": "mode",
          "type": "DateTimeClinicalMode",
          "required": false,
          "default": "'date'",
          "allowedValues": [
            "time",
            "dob",
            "date",
            "datetime",
            "age",
            "gestational"
          ],
          "description": "'date' (MM/DD/YYYY) | 'time' | 'datetime' | 'dob' (date and age) | 'age' | 'gestational'",
          "callback": false
        },
        {
          "name": "hour24",
          "type": "boolean",
          "required": false,
          "default": "false (12-hour)",
          "allowedValues": null,
          "description": "24-hour time",
          "callback": false
        },
        {
          "name": "timeZone",
          "type": "string",
          "required": false,
          "default": "the browser zone",
          "allowedValues": null,
          "description": "IANA zone; shows the zone abbreviation with times",
          "callback": false
        },
        {
          "name": "asOf",
          "type": "string | Date",
          "required": false,
          "default": "today",
          "allowedValues": null,
          "description": "Date the age or gestational age is computed at",
          "callback": false
        },
        {
          "name": "weeks",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Gestational age weeks",
          "callback": false
        },
        {
          "name": "days",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Gestational age days",
          "callback": false
        },
        {
          "name": "edd",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Estimated due date; gestational age is computed from it when set",
          "callback": false
        },
        {
          "name": "prefix",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Text before ('Admitted')",
          "callback": false
        },
        {
          "name": "relative",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Relative text after ('2 h ago')",
          "callback": false
        }
      ],
      "whenToUse": [
        "Every date, time, DOB and age on a clinical screen."
      ],
      "whenNotToUse": [
        "Date entry: DatePicker.",
        "Relative-only times (\"5 min ago\") with no absolute time."
      ],
      "accessibility": [
        "Renders a `<time>` element with an ISO datetime attribute.",
        "Age has a title with the long form (\"6 weeks\")."
      ],
      "example": "<DateTimeClinical mode=\"dob\" value=\"2026-08-28\" asOf=\"2026-10-09\" />",
      "readme": "src/components/DateTimeClinical/README.md",
      "storybook": "basic-clinical-values-datetimeclinical--docs"
    },
    {
      "name": "DentalChart",
      "layer": "complex",
      "group": "Specialty",
      "summary": "DentalChart draws all 32 adult teeth in universal numbering with five surfaces each, marks caries, restorations, crowns, root canals, implants and missing teeth, and lists the phased treatment plan with fees.",
      "import": "import { DentalChart } from 'health-components';",
      "element": {
        "tag": "co-dental-chart",
        "events": [
          "co-selected-change",
          "co-perio-chart",
          "co-add-procedure"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "teeth",
          "type": "Readonly<Record<number, ToothRecord>>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Record<tooth number 1-32, ToothRecord>",
          "callback": false
        },
        {
          "name": "plan",
          "type": "ReadonlyArray<DentalPlanItem>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Treatment plan rows",
          "callback": false
        },
        {
          "name": "selected",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Tooth selected first (uncontrolled)",
          "callback": false
        },
        {
          "name": "selectedTooth",
          "type": "number | null",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected tooth (controlled); null for none",
          "callback": false
        },
        {
          "name": "onSelectedChange",
          "type": "(tooth: number | null) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the tooth number, or null when the selection is cleared",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Dental chart'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "'Universal numbering . viewed facing the patient'",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides the Perio Chart and Add Procedure actions",
          "callback": false
        },
        {
          "name": "onPerioChart",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Perio Chart action",
          "callback": true
        },
        {
          "name": "onAddProcedure",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Add Procedure action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Dental exam, hygiene recall and treatment planning visits.",
        "Showing the patient what is planned and what it costs before a pre-treatment estimate."
      ],
      "whenNotToUse": [
        "Periodontal pocket depths: a perio chart.",
        "Primary (child) teeth A to T: this card charts permanent teeth 1 to 32 only."
      ],
      "accessibility": [
        "Each tooth is a button whose name lists the tooth, its type and every finding, so the chart reads without the colours.",
        "Surfaces are drawn facing the patient; mesial flips side at the midline so the drawing matches the mouth.",
        "The plan is a real table with a caption."
      ],
      "example": "<DentalChart teeth={{ 3: { surfaces: { O: \"caries\", M: \"caries\" } }, 19: { whole: \"rct\" } }} plan={[{ phase: 1, tooth: 3, surface: \"MO\", cdt: \"D2392\", desc: \"Resin composite, 2 surfaces, posterior\", status: \"planned\", fee: 245, insurance: 196 }]} />",
      "readme": "src/components/DentalChart/README.md",
      "storybook": "complex-specialty-dentalchart--docs"
    },
    {
      "name": "DescriptionList",
      "layer": "basic",
      "group": "Data display",
      "summary": "DescriptionList shows label and value pairs in two columns, such as Patient, Date of Birth and MRN.",
      "import": "import { DescriptionList } from 'health-components';",
      "element": {
        "tag": "co-description-list",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "ReadonlyArray<DescriptionItem>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array of [label, value] pairs. Required",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Narrower label column (120px instead of 160px)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Read-only record details in cards, drawers and confirm dialogs."
      ],
      "whenNotToUse": [
        "Editable forms: use fields."
      ],
      "accessibility": [
        "Native dl, dt, dd."
      ],
      "example": "<DescriptionList items={[[\"Patient\", \"Nora Scott\"], [\"MRN\", \"MRN-100377\"]]} />",
      "readme": "src/components/DescriptionList/README.md",
      "storybook": "basic-data-display-descriptionlist--docs"
    },
    {
      "name": "DevDrawer",
      "layer": "complex",
      "group": "Developer",
      "summary": "DevDrawer is the \"For developers\" panel every screen has: purpose and roles, API, fields, states and entry points.",
      "import": "import { DevDrawer } from 'health-components';",
      "element": {
        "tag": "co-dev-drawer",
        "events": [
          "co-close"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "screen",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Screen name; the title reads \"For developers: <screen>\". Required",
          "callback": false
        },
        {
          "name": "purpose",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Purpose and roles: what the screen does and who uses it. Required",
          "callback": false
        },
        {
          "name": "roles",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Roles and access",
          "callback": false
        },
        {
          "name": "api",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "API calls and payloads, shown in mono",
          "callback": false
        },
        {
          "name": "fields",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Fields and which are required",
          "callback": false
        },
        {
          "name": "states",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "States the screen can be in",
          "callback": false
        },
        {
          "name": "entry",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Entry points: where the screen is opened from",
          "callback": false
        },
        {
          "name": "width",
          "type": "number",
          "required": false,
          "default": "560",
          "allowedValues": null,
          "description": "Panel width in px",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the drawer is shown",
          "callback": false
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by the x button, Escape and a scrim press",
          "callback": true
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Render in place for docs: no portal, focus trap, scroll lock or Escape",
          "callback": false
        }
      ],
      "whenToUse": [
        "Every screen, opened from the \"For developers\" button in the page header."
      ],
      "whenNotToUse": [
        "User help text."
      ],
      "accessibility": [
        "As Drawer."
      ],
      "example": "<Button iconLeft=\"code\" onClick={() => setDev(true)}>For developers</Button>\n{dev && <DevDrawer screen=\"Claims\" purpose=\"...\" api=\"GET /claims?status=rejected\" onClose={() => setDev(false)} />}",
      "readme": "src/components/DevDrawer/README.md",
      "storybook": "complex-developer-devdrawer--docs"
    },
    {
      "name": "DischargeChecklist",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "DischargeChecklist tracks the tasks that must be done before a patient leaves, who owns each one, and turns on Ready for Discharge only when the required ones are done.",
      "import": "import { DischargeChecklist } from 'health-components';",
      "element": {
        "tag": "co-discharge-checklist",
        "events": [
          "co-items-change",
          "co-ready"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "DischargeItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array of { label, detail, required, done, auto, owner, by }: the starting list (uncontrolled); required",
          "callback": false
        },
        {
          "name": "itemsValue",
          "type": "DischargeItem[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "The list (controlled); pair with onItemsChange",
          "callback": false
        },
        {
          "name": "onItemsChange",
          "type": "(items: DischargeItem[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new list when a task is ticked or unticked",
          "callback": true
        },
        {
          "name": "patient",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient name",
          "callback": false
        },
        {
          "name": "edd",
          "type": "string",
          "required": false,
          "default": "'not set'",
          "allowedValues": null,
          "description": "Expected discharge",
          "callback": false
        },
        {
          "name": "user",
          "type": "string",
          "required": false,
          "default": "'You'",
          "allowedValues": null,
          "description": "Name stamped on ticks",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "onReady",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Ready for Discharge (enabled once every required task is done)",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Discharge huddles, case management, nursing discharge."
      ],
      "whenNotToUse": [
        "The patient's own instructions: AfterVisitSummary."
      ],
      "accessibility": [
        "Each task is a real checkbox with its detail as description.",
        "Progress bar has a text value."
      ],
      "example": "<DischargeChecklist patient=\"Okafor, Grace\" edd=\"Today 14:00\" items={tasks} onReady={sendToADT} />",
      "readme": "src/components/DischargeChecklist/README.md",
      "storybook": "complex-inpatient-flow-dischargechecklist--docs"
    },
    {
      "name": "DocumentViewer",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "DocumentViewer shows a scanned or outside document page by page with zoom, and lets staff highlight a line or comment on it, listing the annotations beside the page.",
      "import": "import { DocumentViewer } from 'health-components';",
      "element": {
        "tag": "co-document-viewer",
        "events": [
          "co-annotations-change",
          "co-page-change",
          "co-download"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "pages",
          "type": "DocumentPage[]",
          "required": false,
          "default": "none (empty state)",
          "allowedValues": null,
          "description": "Pages",
          "callback": false
        },
        {
          "name": "annotations",
          "type": "DocumentAnnotation[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial annotations; the viewer keeps its own copy",
          "callback": false
        },
        {
          "name": "onAnnotationsChange",
          "type": "(annotations: DocumentAnnotation[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with all annotations after one is added",
          "callback": true
        },
        {
          "name": "page",
          "type": "number",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Shown page index (controlled), from 0",
          "callback": false
        },
        {
          "name": "defaultPage",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Initial page index",
          "callback": false
        },
        {
          "name": "onPageChange",
          "type": "(page: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new page index",
          "callback": true
        },
        {
          "name": "onDownload",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Download",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card subtitle (source, received)",
          "callback": false
        },
        {
          "name": "user",
          "type": "string",
          "required": false,
          "default": "'You'",
          "allowedValues": null,
          "description": "Author name on new annotations",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "No adding annotations",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Why the document could not be opened; shows the error state",
          "callback": false
        },
        {
          "name": "maxHeight",
          "type": "number",
          "required": false,
          "default": "520",
          "allowedValues": null,
          "description": "Height of the page area in px",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Outside records, discharge summaries, faxed consult letters, prior-auth packets."
      ],
      "whenNotToUse": [
        "Incoming fax triage: FaxDocumentViewer."
      ],
      "accessibility": [
        "Page changes are announced (aria-live).",
        "Marks are focusable."
      ],
      "example": "<DocumentViewer title=\"Discharge summary\" pages={pages} annotations={notes} />",
      "readme": "src/components/DocumentViewer/README.md",
      "storybook": "complex-chart-panels-documentviewer--docs"
    },
    {
      "name": "DonutChart",
      "layer": "basic",
      "group": "Charts",
      "summary": "DonutChart shows how a total splits into up to five parts, with the total in the middle and a value legend.",
      "import": "import { DonutChart } from 'health-components';",
      "element": {
        "tag": "co-donut-chart",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "data",
          "type": "DonutChartDatum[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{label, value, color?}>; up to five parts read well",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Caption above the chart and start of the accessible summary",
          "callback": false
        },
        {
          "name": "centerValue",
          "type": "string | number",
          "required": false,
          "default": "the total",
          "allowedValues": null,
          "description": "Big number in the middle",
          "callback": false
        },
        {
          "name": "centerLabel",
          "type": "string",
          "required": false,
          "default": "\"Total\"",
          "allowedValues": null,
          "description": "Label under the middle number",
          "callback": false
        },
        {
          "name": "size",
          "type": "number",
          "required": false,
          "default": "140",
          "allowedValues": null,
          "description": "Largest diameter in px (the ring shrinks with narrow containers)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Share of a whole: claims by status, payer mix."
      ],
      "whenNotToUse": [
        "Comparing sizes precisely or more than five parts: BarChart."
      ],
      "accessibility": [
        "role img with all parts in the label; the legend prints every value and percent."
      ],
      "example": "<DonutChart title=\"Claims by status\" data={[{ label: \"Paid\", value: 412, color: \"var(--co-success)\" }]} centerLabel=\"claims\" />",
      "readme": "src/components/DonutChart/README.md",
      "storybook": "basic-charts-donutchart--docs"
    },
    {
      "name": "DoseDisplay",
      "layer": "complex",
      "group": "Clinical values",
      "summary": "DoseDisplay writes a medication dose the ISMP way: tall-man drug names, leading zero, no trailing zero, and units, mcg and mL spelled safely.",
      "import": "import { DoseDisplay } from 'health-components';",
      "element": {
        "tag": "co-dose-display",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "drug",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Drug name; tall-man lettering is applied automatically; required",
          "callback": false
        },
        {
          "name": "amount",
          "type": "number | string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Dose amount (a number, or a string such as '.5' that is parsed); required",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Dose unit: mg, mcg, g, units, mL, mEq... ('U', 'IU', 'ug', 'cc' are rewritten safely); required",
          "callback": false
        },
        {
          "name": "strength",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Product strength",
          "callback": false
        },
        {
          "name": "strengthUnit",
          "type": "string",
          "required": false,
          "default": "`unit`",
          "allowedValues": null,
          "description": "Strength unit",
          "callback": false
        },
        {
          "name": "form",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Dose form ('tablet', 'per 5 mL suspension')",
          "callback": false
        },
        {
          "name": "route",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Route ('PO', 'IV', 'subcut')",
          "callback": false
        },
        {
          "name": "frequency",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Frequency ('every 6 hours')",
          "callback": false
        },
        {
          "name": "prn",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "As needed",
          "callback": false
        },
        {
          "name": "prnReason",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "PRN reason ('itching')",
          "callback": false
        },
        {
          "name": "perKg",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Dose per kg, shown with `weightKg` as the calculation",
          "callback": false
        },
        {
          "name": "weightKg",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Weight used for the calculation, kg",
          "callback": false
        },
        {
          "name": "highAlert",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "ISMP high-alert medication: red High-alert badge",
          "callback": false
        },
        {
          "name": "lookAlike",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Look-alike drug name: amber badge",
          "callback": false
        },
        {
          "name": "layout",
          "type": "DoseDisplayLayout",
          "required": false,
          "default": "'stacked'",
          "allowedValues": [
            "inline",
            "stacked"
          ],
          "description": "'stacked' (drug above, dose and sig below) | 'inline' (one line for tables)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Medication lists, MAR rows, order review, prescription preview, discharge instructions."
      ],
      "whenNotToUse": [
        "Lab or vital values: ClinicalValue.",
        "Free-text sigs from outside sources: show verbatim and label as external."
      ],
      "accessibility": [
        "Tall-man capitals are read normally by screen readers; the visual cue is for sighted readers.",
        "Badges carry text, not colour alone."
      ],
      "example": "<DoseDisplay drug=\"hydroxyzine\" strength={25} unit=\"mg\" form=\"tablet\" amount={25} route=\"PO\" frequency=\"every 6 hours\" prn prnReason=\"itching\" lookAlike=\"hydralazine\" />",
      "readme": "src/components/DoseDisplay/README.md",
      "storybook": "complex-clinical-values-dosedisplay--docs"
    },
    {
      "name": "Drawer",
      "layer": "basic",
      "group": "Overlays",
      "summary": "Drawer slides a panel in from the right for detail and secondary forms, including the \"For developers\" panel, or up from the bottom on phones.",
      "import": "import { Drawer } from 'health-components';",
      "element": {
        "tag": "co-drawer",
        "events": [
          "co-close"
        ],
        "slots": [
          "(default)",
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the drawer is shown",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Drawer title; names the dialog. Required.",
          "callback": false
        },
        {
          "name": "side",
          "type": "DrawerSide",
          "required": false,
          "default": "'right'",
          "allowedValues": [
            "right",
            "bottom"
          ],
          "description": "'right' panel or 'bottom' sheet (phones)",
          "callback": false
        },
        {
          "name": "developer",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "The \"For developers\" panel: code icon, \"For developers: <title>\"",
          "callback": false
        },
        {
          "name": "sections",
          "type": "DrawerSection[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Developer drawer sections; replace `children` when `developer` is set",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Body",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer actions",
          "callback": false
        },
        {
          "name": "width",
          "type": "number",
          "required": false,
          "default": "560 (from CSS)",
          "allowedValues": null,
          "description": "Panel width in px",
          "callback": false
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by the x button, Escape and a scrim press",
          "callback": true
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Render in place for docs: no portal, focus trap, scroll lock or Escape",
          "callback": false
        }
      ],
      "whenToUse": [
        "Record detail while keeping the list visible (claim detail from the queue), filters, the developer panel, phone action sheets."
      ],
      "whenNotToUse": [
        "A yes or no decision: Modal."
      ],
      "accessibility": [
        "dialog with aria-modal, labelled by the title; Escape closes.",
        "The developer close button is named \"Close developer panel\", as in the screens."
      ],
      "example": "<Drawer title=\"Claim CLM-20871\" onClose={close} footer={<Button variant=\"primary\">Resubmit</Button>}>...</Drawer>\n<Drawer side=\"bottom\" title=\"Visit options\">...</Drawer>",
      "readme": "src/components/Drawer/README.md",
      "storybook": "basic-overlays-drawer--docs"
    },
    {
      "name": "DrugInteractionAlert",
      "layer": "complex",
      "group": "Medications",
      "summary": "DrugInteractionAlert (and AllergyAlert) stops an order for an interaction, duplicate or allergy and asks for an override reason or a change.",
      "import": "import { DrugInteractionAlert } from 'health-components';",
      "element": {
        "tag": "co-drug-interaction-alert",
        "events": [
          "co-reason-change",
          "co-override",
          "co-change-order"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "kind",
          "type": "DrugAlertKind",
          "required": false,
          "default": "'interaction'",
          "allowedValues": [
            "interaction",
            "duplicate",
            "allergy"
          ],
          "description": "'interaction' | 'duplicate' | 'allergy': sets the title prefix",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The drugs involved (\"Sertraline + Tramadol\"); required",
          "callback": false
        },
        {
          "name": "body",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "What the risk is; required",
          "callback": false
        },
        {
          "name": "severity",
          "type": "DrugAlertSeverity",
          "required": false,
          "default": "'moderate'",
          "allowedValues": [
            "severe",
            "moderate",
            "contraindicated"
          ],
          "description": "'contraindicated' | 'severe' | 'moderate'; contraindicated and severe are red, moderate amber",
          "callback": false
        },
        {
          "name": "source",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Knowledge base (\"First Databank\")",
          "callback": false
        },
        {
          "name": "overridable",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "false: no override, the prescriber must choose another drug",
          "callback": false
        },
        {
          "name": "reasons",
          "type": "string[]",
          "required": false,
          "default": "drugAlertOverrideReasons",
          "allowedValues": null,
          "description": "Override reasons",
          "callback": false
        },
        {
          "name": "reason",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Chosen override reason (controlled)",
          "callback": false
        },
        {
          "name": "defaultReason",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial override reason (uncontrolled)",
          "callback": false
        },
        {
          "name": "onReasonChange",
          "type": "(reason: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the override reason changes",
          "callback": true
        },
        {
          "name": "onOverride",
          "type": "(reason: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Override and Continue clicked, with the reason",
          "callback": true
        },
        {
          "name": "onChangeOrder",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Change Order clicked",
          "callback": true
        }
      ],
      "whenToUse": [
        "At order signing when a check fires."
      ],
      "whenNotToUse": [
        "General warnings: Alert."
      ],
      "accessibility": [
        "Override needs a reason; button stays disabled until chosen."
      ],
      "example": "<DrugInteractionAlert title=\"Sertraline + Tramadol\" body=\"Serotonin syndrome risk.\" severity=\"severe\" />\n<AllergyAlert title=\"Amoxicillin\" body=\"Patient allergic to penicillin (anaphylaxis).\" severity=\"contraindicated\" />",
      "readme": "src/components/DrugInteractionAlert/README.md",
      "storybook": "complex-medications-druginteractionalert--docs"
    },
    {
      "name": "DrugSearch",
      "layer": "complex",
      "group": "Medications",
      "summary": "DrugSearch finds a medication with form, RxNorm, plan coverage and DEA schedule shown in each result.",
      "import": "import { DrugSearch } from 'health-components';",
      "element": {
        "tag": "co-drug-search",
        "events": [
          "co-select",
          "co-input",
          "co-query-change",
          "co-open-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "options",
          "type": "DrugOption[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{label, form?, rxnorm?, coverage?, schedule?}>; required",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Medication\"",
          "allowedValues": null,
          "description": "Field label",
          "callback": false
        },
        {
          "name": "payer",
          "type": "string",
          "required": false,
          "default": "\"the patient's plan\"",
          "allowedValues": null,
          "description": "Payer whose formulary is shown, in the footer",
          "callback": false
        },
        {
          "name": "onSelect",
          "type": "(drug: DrugOption) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen drug",
          "callback": true
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message (as TextField)",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled open state of the list",
          "callback": false
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Example text in the empty input",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk plus aria-required",
          "callback": false
        },
        {
          "name": "query",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled query text",
          "callback": false
        },
        {
          "name": "defaultQuery",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial query (uncontrolled)",
          "callback": false
        },
        {
          "name": "onQueryChange",
          "type": "(query: string) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the query text changes",
          "callback": true
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Open on first render (uncontrolled)",
          "callback": false
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the list opens or closes",
          "callback": true
        },
        {
          "name": "limit",
          "type": "number",
          "required": false,
          "default": "8",
          "allowedValues": null,
          "description": "Maximum results shown",
          "callback": false
        },
        {
          "name": "emptyText",
          "type": "string",
          "required": false,
          "default": "\"No matches. Check the spelling or search by MRN.\"",
          "allowedValues": null,
          "description": "Text when nothing matches",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Muted hint under the field",
          "callback": false
        }
      ],
      "whenToUse": [
        "Starting a new prescription."
      ],
      "whenNotToUse": [
        "Picking from the current list: MedicationList."
      ],
      "accessibility": [
        "Combobox pattern."
      ],
      "example": "<DrugSearch payer=\"Aetna\" options={drugs} onSelect={setDrug} />",
      "readme": "src/components/DrugSearch/README.md",
      "storybook": "complex-medications-drugsearch--docs"
    },
    {
      "name": "EDTrackingBoard",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "EDTrackingBoard is the emergency department whiteboard: every patient with ESI acuity, room, chief complaint, wait against the ESI target, status, provider and nurse, last vitals and safety flags.",
      "import": "import { EDTrackingBoard } from 'health-components';",
      "element": {
        "tag": "co-ed-tracking-board",
        "events": [
          "co-filter-change",
          "co-quick-register"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patients",
          "type": "EDPatient[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patients in the department; required",
          "callback": false
        },
        {
          "name": "waitTargets",
          "type": "Partial<Record<ESILevel, number>>",
          "required": false,
          "default": "{1: 0, 2: 10, 3: 30, 4: 60, 5: 120}",
          "allowedValues": null,
          "description": "Wait targets in minutes per ESI level",
          "callback": false
        },
        {
          "name": "currentProvider",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Provider name for the My patients filter",
          "callback": false
        },
        {
          "name": "density",
          "type": "EDDensity",
          "required": false,
          "default": "'comfortable'",
          "allowedValues": [
            "compact",
            "comfortable"
          ],
          "description": "'comfortable' | 'compact' (hides the vitals column, for wall boards)",
          "callback": false
        },
        {
          "name": "filter",
          "type": "EDFilter",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "waiting",
            "all",
            "boarding",
            "mine"
          ],
          "description": "Filter (controlled): 'all' | 'waiting' | 'boarding' | 'mine'",
          "callback": false
        },
        {
          "name": "defaultFilter",
          "type": "EDFilter",
          "required": false,
          "default": "'all'",
          "allowedValues": [
            "waiting",
            "all",
            "boarding",
            "mine"
          ],
          "description": "Initial filter (uncontrolled)",
          "callback": false
        },
        {
          "name": "onFilterChange",
          "type": "(filter: EDFilter) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new filter",
          "callback": true
        },
        {
          "name": "summary",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Shows the summary tiles",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides the Quick Register action",
          "callback": false
        },
        {
          "name": "onQuickRegister",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Quick Register",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'ED Tracking Board'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "The main ED view for charge nurses, providers and techs.",
        "A wall display in the department (use density compact)."
      ],
      "whenNotToUse": [
        "One patient: PatientBanner. Inpatient bed boards: a census table."
      ],
      "accessibility": [
        "Table has a caption; rows sort by ESI then wait, so screen readers hear the sickest first.",
        "ESI tags say \"ESI 2\" in words, and the tooltip names the level.",
        "Wait over target is a text tag, not colour alone."
      ],
      "example": "<EDTrackingBoard patients={edPatients} currentProvider=\"Dr. Priya Raman\" />\n<ESIBadge level={2} showLabel />",
      "readme": "src/components/EDTrackingBoard/README.md",
      "storybook": "complex-ed-periop-edtrackingboard--docs"
    },
    {
      "name": "EligibilityResult",
      "layer": "complex",
      "group": "Revenue",
      "summary": "EligibilityResult shows the payer's 271 answer: active with benefits, inactive, an AAA error with what it means and what to do, or waiting.",
      "import": "import { EligibilityResult } from 'health-components';",
      "element": {
        "tag": "co-eligibility-result",
        "events": [
          "co-rerun",
          "co-fix-coverage",
          "co-self-pay"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "state",
          "type": "EligibilityState",
          "required": false,
          "default": "'active'",
          "allowedValues": [
            "error",
            "waiting",
            "active",
            "inactive"
          ],
          "description": "'active' | 'inactive' | 'error' | 'waiting'",
          "callback": false
        },
        {
          "name": "payer",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Payer name; required",
          "callback": false
        },
        {
          "name": "headline",
          "type": "string",
          "required": false,
          "default": "by state",
          "allowedValues": null,
          "description": "Result headline (\"Active: Aetna PPO\", \"Invalid member ID\")",
          "callback": false
        },
        {
          "name": "aaa",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "AAA reject code, shown before the headline in the error state",
          "callback": false
        },
        {
          "name": "meaning",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"What it means\" in plain words",
          "callback": false
        },
        {
          "name": "todo",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"What to do\" next",
          "callback": false
        },
        {
          "name": "benefits",
          "type": "DescriptionItem[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Benefits as Array<[label, value]> (active only)",
          "callback": false
        },
        {
          "name": "deductible",
          "type": "readonly [met: number, total: number]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Deductible [met, total] in dollars (active only)",
          "callback": false
        },
        {
          "name": "checkedAt",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "When the check ran (\"10/09/2026 9:12 AM, 612 ms\")",
          "callback": false
        },
        {
          "name": "onRerun",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Re-run",
          "callback": true
        },
        {
          "name": "onFixCoverage",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Fix Coverage Details (inactive and error)",
          "callback": true
        },
        {
          "name": "onSelfPay",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Self-pay Good Faith Estimate (inactive and error)",
          "callback": true
        }
      ],
      "whenToUse": [
        "After a 270 eligibility check; on check-in."
      ],
      "whenNotToUse": [
        "Batch results: a DataTable with StatusTag eligibility."
      ],
      "accessibility": [
        "Result headline in an Alert with role status or alert."
      ],
      "example": "<EligibilityResult state=\"error\" payer=\"Aetna\" aaa=\"72\" headline=\"Invalid member ID\"\n  meaning=\"Aetna has no member with that ID.\" todo=\"Check the card and fix the member ID, then Re-run.\" />",
      "readme": "src/components/EligibilityResult/README.md",
      "storybook": "complex-revenue-eligibilityresult--docs"
    },
    {
      "name": "EmptyState",
      "layer": "basic",
      "group": "Data display",
      "summary": "EmptyState fills a screen or card that has nothing to show, including the access-denied screen.",
      "import": "import { EmptyState } from 'health-components';",
      "element": {
        "tag": "co-empty-state",
        "events": [],
        "slots": [
          "title",
          "(default)",
          "actions"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "kind",
          "type": "EmptyStateKind",
          "required": false,
          "default": "'empty'",
          "allowedValues": [
            "error",
            "denied",
            "empty",
            "noresults"
          ],
          "description": "'empty' | 'noresults' | 'denied' | 'error'",
          "callback": false
        },
        {
          "name": "title",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Heading (h2). Required",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Body text: what to do next",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Buttons under the body",
          "callback": false
        },
        {
          "name": "icon",
          "type": "IconName",
          "required": false,
          "default": "by kind (inbox, search, lock, alert-circle)",
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Less padding, for cards and table bodies",
          "callback": false
        }
      ],
      "whenToUse": [
        "No data yet, no search results, no access, load failed."
      ],
      "whenNotToUse": [
        "A table with filters applied: use the table empty row."
      ],
      "accessibility": [
        "denied and error use role alert."
      ],
      "example": "<EmptyState kind=\"noresults\" title=\"No patients match\" actions={<Button>Clear Filters</Button>}>Try the MRN or date of birth.</EmptyState>",
      "readme": "src/components/EmptyState/README.md",
      "storybook": "basic-data-display-emptystate--docs"
    },
    {
      "name": "EPCSApproval",
      "layer": "complex",
      "group": "Medications",
      "summary": "EPCSApproval is the two-factor signing step for controlled-substance e-prescriptions: summary, PDMP check, PIN and token code.",
      "import": "import { EPCSApproval } from 'health-components';",
      "element": {
        "tag": "co-epcs-approval",
        "events": [
          "co-pin-change",
          "co-code-change",
          "co-sign"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "drug",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Drug, strength and form; required",
          "callback": false
        },
        {
          "name": "schedule",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "DEA schedule (\"C-II\"); required",
          "callback": false
        },
        {
          "name": "sig",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Directions; required",
          "callback": false
        },
        {
          "name": "qty",
          "type": "string | number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Quantity; required",
          "callback": false
        },
        {
          "name": "prescriber",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Prescriber name; required",
          "callback": false
        },
        {
          "name": "dea",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Prescriber DEA number; required",
          "callback": false
        },
        {
          "name": "pdmp",
          "type": "string",
          "required": false,
          "default": "\"Checked today 10:02 AM, no concerns\"",
          "allowedValues": null,
          "description": "PDMP check result",
          "callback": false
        },
        {
          "name": "pharmacy",
          "type": "string",
          "required": false,
          "default": "\"the pharmacy\"",
          "allowedValues": null,
          "description": "Pharmacy, in the done message",
          "callback": false
        },
        {
          "name": "audit",
          "type": "string",
          "required": false,
          "default": "\"000123\"",
          "allowedValues": null,
          "description": "Audit record number, in the done message",
          "callback": false
        },
        {
          "name": "state",
          "type": "EPCSState",
          "required": false,
          "default": "'pin'",
          "allowedValues": [
            "done",
            "pin",
            "locked"
          ],
          "description": "'pin' (waiting for factors) | 'done' (signed and sent) | 'locked' (too many failures)",
          "callback": false
        },
        {
          "name": "pin",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled, starts empty: never prefill factors)",
          "allowedValues": null,
          "description": "Signing PIN (controlled)",
          "callback": false
        },
        {
          "name": "onPinChange",
          "type": "(pin: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called as PIN digits are entered or deleted",
          "callback": true
        },
        {
          "name": "code",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled, starts empty)",
          "allowedValues": null,
          "description": "One-time token code (controlled)",
          "callback": false
        },
        {
          "name": "onCodeChange",
          "type": "(code: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called as the token code changes",
          "callback": true
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error under the PIN dots (\"Wrong PIN. 2 tries left.\")",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "(factors: EPCSFactors) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Sign and Send clicked with both factors complete",
          "callback": true
        }
      ],
      "whenToUse": [
        "Signing any C-II to C-V prescription."
      ],
      "whenNotToUse": [
        "Non-controlled prescriptions."
      ],
      "accessibility": [
        "PIN dots announce progress."
      ],
      "example": "<EPCSApproval drug=\"Oxycodone 5 mg\" schedule=\"C-II\" sig=\"...\" qty={20} prescriber=\"Tom Reyes\" dea=\"BR1234563\" />",
      "readme": "src/components/EPCSApproval/README.md",
      "storybook": "complex-medications-epcsapproval--docs"
    },
    {
      "name": "ERAPostingRow",
      "layer": "complex",
      "group": "Revenue",
      "summary": "ERAPostingRow is one ERA (835) service line to post: billed, allowed, paid, contractual and patient amounts, CARC and RARC codes, balance check and Post.",
      "import": "import { ERAPostingRow } from 'health-components';",
      "element": {
        "tag": "co-era-posting-row",
        "events": [
          "co-post"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "row",
          "type": "EraRow",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The ERA service line. Required",
          "callback": false
        },
        {
          "name": "onPost",
          "type": "(row: EraRow) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the row when Post is pressed (only enabled when balanced)",
          "callback": true
        }
      ],
      "whenToUse": [
        "Payment posting."
      ],
      "whenNotToUse": [
        "Patient payments: CopayCollector."
      ],
      "accessibility": [
        "Codes have titles with their meaning."
      ],
      "example": "<ERAPostingRow row={{ patient: \"Henna West\", cpt: \"99214\", billed: 182, allowed: 118.4, paid: 93.4, patientResp: 25, adjustments: [{ group: \"CO\", code: \"45\", amount: 63.6 }] }} />",
      "readme": "src/components/ERAPostingRow/README.md",
      "storybook": "complex-revenue-erapostingrow--docs"
    },
    {
      "name": "EyeExam",
      "layer": "complex",
      "group": "Specialty",
      "summary": "EyeExam records right eye (OD) and left eye (OS) visual acuity, intraocular pressure and refraction in one place, with flags for reduced acuity, high pressure and pressure asymmetry.",
      "import": "import { EyeExam } from 'health-components';",
      "element": {
        "tag": "co-eye-exam",
        "events": [
          "co-copy-last-exam",
          "co-finalize-rx"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "exam",
          "type": "EyeExamData",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{od, os, iopMethod, iopTime}; required",
          "callback": false
        },
        {
          "name": "refractions",
          "type": "ReadonlyArray<Refraction>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Refraction rows",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Eye exam'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Copy Last Exam and Finalize Rx",
          "callback": false
        },
        {
          "name": "onCopyLastExam",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Copy Last Exam action",
          "callback": true
        },
        {
          "name": "onFinalizeRx",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Finalize Rx action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Optometry and ophthalmology exams, diabetic eye screening, glaucoma follow-up."
      ],
      "whenNotToUse": [
        "Slit lamp and fundus findings: a structured exam note.",
        "Contact lens fitting parameters."
      ],
      "accessibility": [
        "Each eye is a row header with the abbreviation and its plain name.",
        "Flags are words and icons, not just red text.",
        "Signed lens powers read as plus or minus."
      ],
      "example": "<EyeExam exam={{ od: { vaCc: \"20/25\", iop: 16 }, os: { vaCc: \"20/30\", iop: 17 }, iopMethod: \"Goldmann\" }} refractions={[{ type: \"Manifest\", od: { sph: -2.25, cyl: -0.5, axis: 180, va: \"20/20\" }, os: { sph: -2, cyl: 0, va: \"20/20\" } }]} />",
      "readme": "src/components/EyeExam/README.md",
      "storybook": "complex-specialty-eyeexam--docs"
    },
    {
      "name": "FallRiskScore",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "FallRiskScore is the Morse Fall Scale: six items, automatic total and the risk band with the precautions it calls for.",
      "import": "import { FallRiskScore } from 'health-components';",
      "element": {
        "tag": "co-fall-risk-score",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "defaultValues",
          "type": "Record<string, number>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Option index per item (uncontrolled), keyed by item id: history, secondary, aid, iv, gait, mental",
          "callback": false
        },
        {
          "name": "values",
          "type": "Record<string, number>",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Option index per item (controlled)",
          "callback": false
        },
        {
          "name": "band",
          "type": "(total: number) => NursingScoreBand",
          "required": false,
          "default": "morseBand (0-24 low, 25-44 moderate, 45+ high)",
          "allowedValues": null,
          "description": "Cut-offs, total to band",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Morse Fall Scale'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "previous",
          "type": "NursingPreviousScore",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Last score",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(values: Record<string, number>) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with all answers after each pick",
          "callback": true
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use",
          "callback": false
        }
      ],
      "whenToUse": [
        "Adult inpatient fall screen on admission, each shift and after a change or a fall."
      ],
      "whenNotToUse": [
        "Children: use a pediatric tool (Humpty Dumpty) through ScoreForm-style items."
      ],
      "accessibility": [
        "Each item is a radiogroup; options show their points.",
        "Total and band are in a polite live region."
      ],
      "example": "<FallRiskScore defaultValues={{ history: 1, secondary: 1, aid: 1, iv: 1, gait: 2, mental: 0 }} previous={{ total: 35, when: \"yesterday 20:00\" }} />",
      "readme": "src/components/FallRiskScore/README.md",
      "storybook": "complex-inpatient-nursing-fallriskscore--docs"
    },
    {
      "name": "FaxDocumentViewer",
      "layer": "complex",
      "group": "Work queues",
      "summary": "FaxDocumentViewer shows an incoming fax page next to the indexing form: patient, document type, route, file or junk, with an AI match suggestion.",
      "import": "import { FaxDocumentViewer } from 'health-components';",
      "element": {
        "tag": "co-fax-document-viewer",
        "events": [
          "co-page-change",
          "co-file",
          "co-junk"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "from",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Sender line shown at the top of the page (\"From: Lakeview Heart (312) 555-0188\"); required",
          "callback": false
        },
        {
          "name": "pages",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Number of pages; required",
          "callback": false
        },
        {
          "name": "patients",
          "type": "ComboboxOption[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Combobox options for the patient search",
          "callback": false
        },
        {
          "name": "patientQuery",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial patient search text",
          "callback": false
        },
        {
          "name": "ai",
          "type": "FaxAISuggestion",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "{text, confidence}",
          "callback": false
        },
        {
          "name": "page",
          "type": "number",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled current page (1-based)",
          "callback": false
        },
        {
          "name": "defaultPage",
          "type": "number",
          "required": false,
          "default": "1",
          "allowedValues": null,
          "description": "Initial page (uncontrolled)",
          "callback": false
        },
        {
          "name": "onPageChange",
          "type": "(page: number) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the page changes",
          "callback": true
        },
        {
          "name": "documentTypes",
          "type": "string[]",
          "required": false,
          "default": "['Lab result', 'Referral', 'Prior auth response', 'Medical records', 'Other']",
          "allowedValues": null,
          "description": "Document type options",
          "callback": false
        },
        {
          "name": "routes",
          "type": "string[]",
          "required": false,
          "default": "['James Bell MD', 'Clinical Inbox', 'Billing']",
          "allowedValues": null,
          "description": "Route-to options",
          "callback": false
        },
        {
          "name": "onFile",
          "type": "(values: FaxIndexValues) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by File to Chart with the form values",
          "callback": true
        },
        {
          "name": "onJunk",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Mark as Junk",
          "callback": true
        }
      ],
      "whenToUse": [
        "Indexing faxes and scans to charts."
      ],
      "whenNotToUse": [
        "Sending faxes: a form."
      ],
      "accessibility": [
        "Page image has a text label; pager buttons labelled."
      ],
      "example": "<FaxDocumentViewer from=\"Quest Diagnostics\" pages={3} patients={patients} ai={{ text: \"...\", confidence: \"high\" }} />",
      "readme": "src/components/FaxDocumentViewer/README.md",
      "storybook": "complex-work-queues-faxdocumentviewer--docs"
    },
    {
      "name": "FetalMonitorStrip",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "FetalMonitorStrip is a display placeholder for the cardiotocography feed: fetal heart rate above, uterine activity below, on the standard grid, with an approximate baseline and the category the clinician assigned.",
      "import": "import { FetalMonitorStrip } from 'health-components';",
      "element": {
        "tag": "co-fetal-monitor-strip",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "fhr",
          "type": "Array<number | null>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "FHR samples in bpm, oldest first; null for signal loss",
          "callback": false
        },
        {
          "name": "toco",
          "type": "Array<number | null>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Uterine activity samples in mmHg; null for signal loss",
          "callback": false
        },
        {
          "name": "state",
          "type": "FetalMonitorState",
          "required": false,
          "default": "'live' when data exists, else 'disconnected'",
          "allowedValues": [
            "live",
            "paused",
            "disconnected"
          ],
          "description": "'live' | 'paused' | 'disconnected'",
          "callback": false
        },
        {
          "name": "category",
          "type": "FHRCategory",
          "required": false,
          "default": "none (Category not assigned)",
          "allowedValues": [
            "I",
            "II",
            "III"
          ],
          "description": "Tracing category assigned by the clinician",
          "callback": false
        },
        {
          "name": "categoryBy",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Who assigned the category and when",
          "callback": false
        },
        {
          "name": "room",
          "type": "string",
          "required": false,
          "default": "'L&D'",
          "allowedValues": null,
          "description": "Room named in the disconnected state",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Central monitoring and the labor room screen, next to the board."
      ],
      "whenNotToUse": [
        "Interpreting the tracing: the component does not classify it."
      ],
      "accessibility": [
        "The tracing has an aria-label with the approximate baseline and signal loss.",
        "States are words in tags."
      ],
      "example": "<FetalMonitorStrip fhr={feed.fhr} toco={feed.toco} category=\"I\" categoryBy=\"T. Ruiz RN 14:10\" />",
      "readme": "src/components/FetalMonitorStrip/README.md",
      "storybook": "complex-ed-periop-fetalmonitorstrip--docs"
    },
    {
      "name": "Field",
      "layer": "basic",
      "group": "Inputs",
      "summary": "Field is the labelled wrapper every form control shares: the label with its required marker, the control, then a read-only lock line and an error or helper line under it.",
      "import": "import { Field } from 'health-components';",
      "element": {
        "tag": "co-field",
        "events": [],
        "slots": [
          "label",
          "error",
          "helper",
          "lock",
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "id",
          "type": "string",
          "required": false,
          "default": "generated",
          "allowedValues": null,
          "description": "id of the control inside; the label points at it and the help, error and lock ids derive from it",
          "callback": false
        },
        {
          "name": "label",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Visible label",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk after the label (the control sets aria-required)",
          "callback": false
        },
        {
          "name": "error",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message under the control, role alert; replaces the helper",
          "callback": false
        },
        {
          "name": "helper",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Muted hint under the control",
          "callback": false
        },
        {
          "name": "lock",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Read-only lock line with a lock icon (\"Your role can view but not edit\")",
          "callback": false
        },
        {
          "name": "className",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Class on the root",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode | ((control: FieldControlProps) => ReactNode)",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "The control, or a function that receives id and aria attributes to spread on it",
          "callback": false
        }
      ],
      "whenToUse": [
        "Wrapping a control that has no CareOS component of its own (a native time input, a custom widget) so it lines up with the other fields in a form."
      ],
      "whenNotToUse": [
        "A plain text, select, date or search field: use TextField, Select, DatePicker or Combobox, which already include Field.",
        "Checkboxes and radios: they carry their own label (Checkbox, RadioGroup)."
      ],
      "accessibility": [
        "The label points at the control with `htmlFor`; pass the control's `id`, or use the function child to receive it.",
        "Error, helper and lock lines have ids linked with aria-describedby (`fieldDescribedBy` builds the value); aria-invalid is set on error.",
        "The asterisk is aria-hidden; the control carries aria-required."
      ],
      "example": "<Field label=\"Arrival Time\" required helper=\"Clinic local time\" error={errors.time}>\n  {(control) => <input type=\"time\" className=\"co-inp\" {...control} />}\n</Field>",
      "readme": "src/components/Field/README.md",
      "storybook": "basic-inputs-field--docs"
    },
    {
      "name": "FileUpload",
      "layer": "basic",
      "group": "Inputs",
      "summary": "FileUpload is a drop zone with a file list, plus a photo variant for insurance cards and ID.",
      "import": "import { FileUpload } from 'health-components';",
      "element": {
        "tag": "co-file-upload",
        "events": [
          "co-files-change",
          "co-files",
          "co-remove",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Field label above the zone",
          "callback": false
        },
        {
          "name": "accept",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "File types the picker accepts (\".pdf,.jpg,.png\")",
          "callback": false
        },
        {
          "name": "multiple",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Allows picking several files",
          "callback": false
        },
        {
          "name": "variant",
          "type": "'default' | 'photo'",
          "required": false,
          "default": "'default'",
          "allowedValues": [
            "default",
            "photo"
          ],
          "description": "'default' drop zone | 'photo' camera capture for insurance cards and ID",
          "callback": false
        },
        {
          "name": "files",
          "type": "FileUploadItem[]",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled file list: Array<{name, size?, status: uploading|done|error, progress?, error?}>",
          "callback": false
        },
        {
          "name": "defaultFiles",
          "type": "FileUploadItem[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial file list (uncontrolled)",
          "callback": false
        },
        {
          "name": "onFilesChange",
          "type": "(files: FileUploadItem[]) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with the next list when files are added or removed",
          "callback": true
        },
        {
          "name": "dragging",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Forced drag-over state for previews",
          "callback": false
        },
        {
          "name": "done",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Forced done state (photo captured) for previews",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Drag a file here or choose one'",
          "allowedValues": null,
          "description": "Zone title",
          "callback": false
        },
        {
          "name": "hint",
          "type": "string",
          "required": false,
          "default": "'PDF, JPG or PNG, up to 10 MB'",
          "allowedValues": null,
          "description": "Hint under the title",
          "callback": false
        },
        {
          "name": "doneText",
          "type": "string",
          "required": false,
          "default": "'Photo captured'",
          "allowedValues": null,
          "description": "Title in the done state",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message under the zone, role alert",
          "callback": false
        },
        {
          "name": "onFiles",
          "type": "(files: FileList) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the picked or dropped files",
          "callback": true
        },
        {
          "name": "onRemove",
          "type": "(file: FileUploadItem, index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a file row's Remove button is pressed",
          "callback": true
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Attach referral letters, insurance card photos, scanned documents, outside records."
      ],
      "whenNotToUse": [
        "Signing a document: SignaturePad."
      ],
      "accessibility": [
        "The whole zone is a label for a visually hidden file input, so keyboard and screen readers get the native picker.",
        "Each file row has a Remove button named with the file name."
      ],
      "example": "<FileUpload label=\"Referral Letter\" accept=\".pdf,.jpg,.png\" files={uploads} onFiles={upload} />\n<FileUpload variant=\"photo\" label=\"Front of Card\" />",
      "readme": "src/components/FileUpload/README.md",
      "storybook": "basic-inputs-fileupload--docs"
    },
    {
      "name": "FilterChip",
      "layer": "basic",
      "group": "Selection",
      "summary": "FilterChip toggles a quick filter above a list, such as Rejected or Needs Review, and can show a count.",
      "import": "import { FilterChip } from 'health-components';",
      "element": {
        "tag": "co-filter-chip",
        "events": [
          "co-remove",
          "co-change"
        ],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "children",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Label. Required",
          "callback": false
        },
        {
          "name": "selected",
          "type": "boolean",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "On state (controlled)",
          "callback": false
        },
        {
          "name": "defaultSelected",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial on state (uncontrolled)",
          "callback": false
        },
        {
          "name": "count",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Count after the label",
          "callback": false
        },
        {
          "name": "check",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Show the check icon when on",
          "callback": false
        },
        {
          "name": "onRemove",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Makes a removable (applied) chip with an x button",
          "callback": true
        },
        {
          "name": "removeLabel",
          "type": "string",
          "required": false,
          "default": "\"Remove filter <label>\"",
          "allowedValues": null,
          "description": "Accessible name of the remove button",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(on: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new state",
          "callback": true
        }
      ],
      "whenToUse": [
        "Quick filters over a table or queue.",
        "Removable active filters (with onRemove)."
      ],
      "whenNotToUse": [
        "Mutually exclusive views: SegmentedControl or Tabs."
      ],
      "accessibility": [
        "aria-pressed shows the state; the check icon adds a non-colour cue."
      ],
      "example": "<FilterChip selected={f.rejected} count={12} onChange={on => setF({ ...f, rejected: on })}>Rejected</FilterChip>",
      "readme": "src/components/FilterChip/README.md",
      "storybook": "basic-selection-filterchip--docs"
    },
    {
      "name": "Flowsheet",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "Flowsheet is the nurse charting grid: measures down the side, times across the top, with add column, edit in place, abnormal shading, collapsible groups and a graph view.",
      "import": "import { Flowsheet } from 'health-components';",
      "element": {
        "tag": "co-flowsheet",
        "events": [
          "co-view-change",
          "co-change",
          "co-add-column",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "rows",
          "type": "FlowsheetRow[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Measures down the side; required",
          "callback": false
        },
        {
          "name": "columns",
          "type": "FlowsheetColumn[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Charting times across the top; required",
          "callback": false
        },
        {
          "name": "nowColumn",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Id of the current column (marked with a left rule)",
          "callback": false
        },
        {
          "name": "nextTime",
          "type": "(columns: FlowsheetColumn[]) => string",
          "required": false,
          "default": "'New'",
          "allowedValues": null,
          "description": "Label for an added column, from the current columns",
          "callback": false
        },
        {
          "name": "view",
          "type": "FlowsheetView",
          "required": false,
          "default": null,
          "allowedValues": [
            "grid",
            "graph"
          ],
          "description": "Controlled view: 'grid' | 'graph'",
          "callback": false
        },
        {
          "name": "defaultView",
          "type": "FlowsheetView",
          "required": false,
          "default": "'grid'",
          "allowedValues": [
            "grid",
            "graph"
          ],
          "description": "Initial view (uncontrolled)",
          "callback": false
        },
        {
          "name": "onViewChange",
          "type": "(view: FlowsheetView) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the view changes",
          "callback": true
        },
        {
          "name": "defaultCollapsed",
          "type": "string[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initially collapsed group names",
          "callback": false
        },
        {
          "name": "defaultEditing",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Cell open for editing at first, as 'rowId|colId'",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only: no editing, no Add column",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(rowId: string, colId: string, value: string) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when a cell is saved",
          "callback": true
        },
        {
          "name": "onAddColumn",
          "type": "(column: FlowsheetColumn) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when a column is added",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Flowsheet'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient and unit line",
          "callback": false
        },
        {
          "name": "maxHeight",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Scroll height of the grid in px",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; a row's own range still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Hourly or q4h vitals, neuro checks, drips and I&O on an inpatient or ICU unit.",
        "Any repeated measure where the nurse needs to compare across time."
      ],
      "whenNotToUse": [
        "One set of vitals at a clinic visit: VitalsPanel.",
        "Lab results with reference columns: LabResultTable."
      ],
      "accessibility": [
        "Real table with caption, row headers and column headers; sticky first column.",
        "Each cell is a button named \"Edit Heart rate at 12:00, now 118 bpm\".",
        "Flags are letters plus words for screen readers; colour is never the only signal.",
        "Graph view has an aria-label listing every value."
      ],
      "example": "<Flowsheet title=\"Vitals and I&O\" columns={cols} rows={rows} nowColumn=\"c6\" nextTime={c => '16:00'} onChange={save} />",
      "readme": "src/components/Flowsheet/README.md",
      "storybook": "complex-inpatient-nursing-flowsheet--docs"
    },
    {
      "name": "GrowthChart",
      "layer": "complex",
      "group": "Specialty",
      "summary": "GrowthChart plots a child’s measurements against WHO (birth to 24 months) or CDC (2 to 20 years) percentile lines and names the percentile band of every point.",
      "import": "import { GrowthChart } from 'health-components';",
      "element": {
        "tag": "co-growth-chart",
        "events": [
          "co-standard-change"
        ],
        "slots": [
          "note"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "standard",
          "type": "GrowthStandard",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "who",
            "cdc"
          ],
          "description": "Standard shown (controlled): 'who' | 'cdc'",
          "callback": false
        },
        {
          "name": "defaultStandard",
          "type": "GrowthStandard",
          "required": false,
          "default": "'who'",
          "allowedValues": [
            "who",
            "cdc"
          ],
          "description": "First standard shown (uncontrolled)",
          "callback": false
        },
        {
          "name": "measure",
          "type": "'weight' | 'bmi' | (string & {})",
          "required": false,
          "default": "'weight'",
          "allowedValues": null,
          "description": "'weight' | 'bmi' | string: picks the built-in curve",
          "callback": false
        },
        {
          "name": "sex",
          "type": "'male' | 'female'",
          "required": false,
          "default": "'male'",
          "allowedValues": [
            "male",
            "female"
          ],
          "description": "'male' | 'female': picks the built-in curve",
          "callback": false
        },
        {
          "name": "points",
          "type": "ReadonlyArray<GrowthPoint>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array<[age, value, date?]>",
          "callback": false
        },
        {
          "name": "curves",
          "type": "GrowthCurves",
          "required": false,
          "default": "the built-in sample for standard, measure and sex",
          "allowedValues": null,
          "description": "{unit, ages, ageUnit, lines, title}",
          "callback": false
        },
        {
          "name": "onStandardChange",
          "type": "(standard: GrowthStandard) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new standard; the parent passes the matching `curves`. Without it, custom curves hide the switch",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "the curves' title",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "note",
          "type": "ReactNode",
          "required": false,
          "default": "how percentile bands are read",
          "allowedValues": null,
          "description": "Note under the table",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        },
        {
          "name": "percentiles",
          "type": "Readonly<Record<string, ReadonlyArray<number>>>",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Legacy (use `curves`): Record<percentile, value per age in `ages`>, ages in months",
          "callback": false
        },
        {
          "name": "ages",
          "type": "ReadonlyArray<number>",
          "required": false,
          "default": "[0,6,12,18,24,36]",
          "allowedValues": null,
          "description": "Legacy (use `curves`): ages in months of `percentiles`",
          "callback": false
        },
        {
          "name": "min",
          "type": "number",
          "required": false,
          "default": "from the data",
          "allowedValues": null,
          "description": "Legacy: bottom of the y axis",
          "callback": false
        },
        {
          "name": "max",
          "type": "number",
          "required": false,
          "default": "from the data",
          "allowedValues": null,
          "description": "Legacy: top of the y axis",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Legacy (use `curves.unit`): unit label of the values ('kg')",
          "callback": false
        }
      ],
      "whenToUse": [
        "Well-child visits, failure to thrive and obesity follow-up, endocrine and nutrition clinics."
      ],
      "whenNotToUse": [
        "Preterm infants before 2 years corrected: a Fenton chart.",
        "Adult weight trends: LineChart."
      ],
      "accessibility": [
        "The SVG label lists every point; each point also has a title.",
        "The band is stated in words in a badge and in the table.",
        "The 50th line is solid, others dashed, so they differ without colour."
      ],
      "example": "<GrowthChart standard=\"cdc\" measure=\"bmi\" points={[[8, 17.2, \"03/2022\"], [10, 19.8, \"03/2024\"]]} curves={cdcBmiBoys} />",
      "readme": "src/components/GrowthChart/README.md",
      "storybook": "complex-specialty-growthchart--docs"
    },
    {
      "name": "HistoryPanels",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "HistoryPanels holds past medical, surgical, family and social history in tabs, with family history as a relative-by-relative pedigree list and social history including the social needs (SDOH) screening.",
      "import": "import { HistoryPanels } from 'health-components';",
      "element": {
        "tag": "co-history-panels",
        "events": [
          "co-tab-change",
          "co-mark-reviewed",
          "co-add",
          "co-refer"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "pmh",
          "type": "HistoryMedicalItem[]",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Past medical history. undefined = not asked, [] = none",
          "callback": false
        },
        {
          "name": "psh",
          "type": "HistorySurgicalItem[]",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Surgical history. undefined = not asked, [] = none",
          "callback": false
        },
        {
          "name": "family",
          "type": "HistoryFamilyMember[]",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Family history by relative. undefined = not asked",
          "callback": false
        },
        {
          "name": "social",
          "type": "HistorySocial",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Social history. undefined = not asked",
          "callback": false
        },
        {
          "name": "tab",
          "type": "HistoryTab",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "pmh",
            "psh",
            "fam",
            "soc"
          ],
          "description": "Shown tab (controlled): 'pmh' | 'psh' | 'fam' | 'soc'",
          "callback": false
        },
        {
          "name": "defaultTab",
          "type": "HistoryTab",
          "required": false,
          "default": "'pmh'",
          "allowedValues": [
            "pmh",
            "psh",
            "fam",
            "soc"
          ],
          "description": "Initial tab",
          "callback": false
        },
        {
          "name": "onTabChange",
          "type": "(tab: HistoryTab) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the tab changes",
          "callback": true
        },
        {
          "name": "reviewed",
          "type": "string",
          "required": false,
          "default": "none ('Not reviewed this visit')",
          "allowedValues": null,
          "description": "When and by whom it was last reviewed",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "No Mark Reviewed and Add buttons",
          "callback": false
        },
        {
          "name": "onMarkReviewed",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Mark Reviewed",
          "callback": true
        },
        {
          "name": "onAdd",
          "type": "(tab: HistoryTab) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Add with the shown tab",
          "callback": true
        },
        {
          "name": "onRefer",
          "type": "(item: HistorySdohItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Refer with the SDOH domain",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'History'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Intake, annual wellness visit, new-patient history, pre-operative review."
      ],
      "whenNotToUse": [
        "Active problems: ProblemListEditor."
      ],
      "accessibility": [
        "Tabs use arrow keys.",
        "Family history is a list, one relative per item.",
        "Need found is shown with icon and words."
      ],
      "example": "<HistoryPanels pmh={pmh} psh={psh} family={family} social={social} defaultTab=\"soc\" />",
      "readme": "src/components/HistoryPanels/README.md",
      "storybook": "complex-chart-panels-historypanels--docs"
    },
    {
      "name": "ICD10Picker",
      "layer": "complex",
      "group": "Orders and notes",
      "summary": "ICD10Picker searches ICD-10-CM by code or words, shows billable codes and the provider's favourites.",
      "import": "import { ICD10Picker } from 'health-components';",
      "element": {
        "tag": "co-i-c-d10-picker",
        "events": [
          "co-select",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "options",
          "type": "ICD10Option[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{code, label, meta?}>: the codes to search. Required",
          "callback": false
        },
        {
          "name": "favorites",
          "type": "ICD10Favorite[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Array<{code, short}>: favourite codes shown as chips",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Diagnosis (ICD-10-CM)\"",
          "allowedValues": null,
          "description": "Field label",
          "callback": false
        },
        {
          "name": "onSelect",
          "type": "(option: ICD10Option) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen code (from the list or a favourite chip)",
          "callback": true
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Selected code (controlled)",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initially selected code (uncontrolled)",
          "callback": false
        },
        {
          "name": "defaultQuery",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial search text",
          "callback": false
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Open the results on first render",
          "callback": false
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "\"Code or words, such as E11.9 or diabetes\"",
          "allowedValues": null,
          "description": "Placeholder of the search input",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message under the search",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Marks the field required",
          "callback": false
        }
      ],
      "whenToUse": [
        "Diagnoses on notes, problems, orders and claims."
      ],
      "whenNotToUse": [
        "Procedures: CPTPicker."
      ],
      "accessibility": [
        "Combobox pattern."
      ],
      "example": "<ICD10Picker options={icd10} favorites={[{ code: \"E11.9\", short: \"T2DM\" }]} onSelect={addDx} />",
      "readme": "src/components/ICD10Picker/README.md",
      "storybook": "complex-orders-and-notes-icd10picker--docs"
    },
    {
      "name": "Icon",
      "layer": "basic",
      "group": "Data display",
      "summary": "Icon draws one of the inline 24px stroke icons used across CareOS, at stroke width 2 in the current text colour.",
      "import": "import { Icon } from 'health-components';",
      "element": {
        "tag": "co-icon",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "name",
          "type": "IconName",
          "required": true,
          "default": null,
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon name, one of `Icon.names`.",
          "callback": false
        },
        {
          "name": "size",
          "type": "number",
          "required": false,
          "default": "16",
          "allowedValues": null,
          "description": "Size in px",
          "callback": false
        },
        {
          "name": "strokeWidth",
          "type": "number",
          "required": false,
          "default": "2",
          "allowedValues": null,
          "description": "Stroke width",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Makes the icon meaningful to screen readers (role img). Without it the icon is decorative and hidden.",
          "callback": false
        }
      ],
      "whenToUse": [
        "Next to a label in buttons, menus, tags and banners; alone only inside IconButton."
      ],
      "whenNotToUse": [
        "Decoration in empty space; emoji."
      ],
      "accessibility": [
        "Icons that carry meaning on their own need `label`; icons beside text are hidden.",
        "Icons that carry meaning need 3:1 against their ground."
      ],
      "example": "<Icon name=\"lock\" size={14} />\n<Icon name=\"alert\" label=\"Critical\" />",
      "readme": "src/components/Icon/README.md",
      "storybook": "basic-data-display-icon--docs"
    },
    {
      "name": "IconButton",
      "layer": "basic",
      "group": "Actions",
      "summary": "IconButton is a square button that shows only an icon, with its name in aria-label.",
      "import": "import { IconButton } from 'health-components';",
      "element": {
        "tag": "co-icon-button",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "icon",
          "type": "IconName",
          "required": true,
          "default": null,
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon name (see Icon); required",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Accessible name: becomes aria-label and the hover title; required",
          "callback": false
        },
        {
          "name": "variant",
          "type": "IconButtonVariant",
          "required": false,
          "default": "'ghost'",
          "allowedValues": [
            "primary",
            "danger",
            "secondary",
            "ghost"
          ],
          "description": "'ghost' | 'secondary' | 'primary' | 'danger'",
          "callback": false
        },
        {
          "name": "size",
          "type": "IconButtonSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "lg"
          ],
          "description": "'sm' 30px, 'md' 34px, 'lg' 44px (touch)",
          "callback": false
        },
        {
          "name": "badge",
          "type": "number | string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Count bubble, read as \"N unread\"",
          "callback": false
        },
        {
          "name": "disabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables the button",
          "callback": false
        }
      ],
      "whenToUse": [
        "Close a modal or drawer, open notifications, collapse a panel, expand a table row.",
        "Toolbars where the icon is universally known (print, close, search)."
      ],
      "whenNotToUse": [
        "The action is unusual or risky: use a Button with a text label.",
        "More than three icon buttons in a row: use a KebabMenu."
      ],
      "accessibility": [
        "`label` is required. It becomes aria-label and the hover title.",
        "The badge count is read as \"N unread\".",
        "Use lg (44px) on phone screens to meet the touch target."
      ],
      "example": "<IconButton icon=\"x\" label=\"Close\" onClick={onClose} />\n<IconButton icon=\"bell\" label=\"Notifications\" badge={4} />",
      "readme": "src/components/IconButton/README.md",
      "storybook": "basic-actions-iconbutton--docs"
    },
    {
      "name": "IconRail",
      "layer": "complex",
      "group": "Navigation",
      "summary": "IconRail is the Focus Rail style's 64px slate icon rail with tooltips, leaving the most room for the chart.",
      "import": "import { IconRail } from 'health-components';",
      "element": {
        "tag": "co-icon-rail",
        "events": [
          "co-navigate"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "IconRailItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Icons and separators, in the sidebar's group order. Required.",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Label of the current item",
          "callback": false
        },
        {
          "name": "showTip",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Force one tooltip open, for docs",
          "callback": false
        },
        {
          "name": "onNavigate",
          "type": "(item: IconRailLink, event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when an item is clicked",
          "callback": true
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Rounded and bordered, for docs",
          "callback": false
        }
      ],
      "whenToUse": [
        "Focus Rail style on desktop."
      ],
      "whenNotToUse": [
        "Any place where labels must be visible for new staff: SidebarNav."
      ],
      "accessibility": [
        "Each item has aria-label; tooltips appear on focus too.",
        "Inactive icons use `nav-ink-muted` (white at 72% on slate), 8.4:1."
      ],
      "example": "<IconRail items={RAIL_ITEMS} active=\"Patients\" />",
      "readme": "src/components/IconRail/README.md",
      "storybook": "complex-navigation-iconrail--docs"
    },
    {
      "name": "IdentifierDisplay",
      "layer": "basic",
      "group": "Clinical values",
      "summary": "IdentifierDisplay shows SSN, MRN, NPI, DEA and member IDs in a monospace face, masking the sensitive ones, with reveal and copy buttons and a check-digit warning.",
      "import": "import { IdentifierDisplay } from 'health-components';",
      "element": {
        "tag": "co-identifier-display",
        "events": [
          "co-reveal"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "type",
          "type": "IdentifierType",
          "required": true,
          "default": null,
          "allowedValues": [
            "ssn",
            "mrn",
            "npi",
            "dea",
            "member",
            "other"
          ],
          "description": "'ssn' | 'mrn' | 'npi' | 'dea' | 'member' | 'other'; required",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Full value; required",
          "callback": false
        },
        {
          "name": "masked",
          "type": "boolean",
          "required": false,
          "default": "by type (SSN, DEA and member ID masked)",
          "allowedValues": null,
          "description": "Mask all but the last 4",
          "callback": false
        },
        {
          "name": "revealable",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Eye button that reveals a masked value",
          "callback": false
        },
        {
          "name": "onReveal",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called each time a masked value is revealed: log it for audit",
          "callback": true
        },
        {
          "name": "copyable",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Copy button (copies the full value without spaces)",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "the type label (SSN, MRN, NPI, DEA, Member ID)",
          "allowedValues": null,
          "description": "Label",
          "callback": false
        },
        {
          "name": "showLabel",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Shows the label",
          "callback": false
        }
      ],
      "whenToUse": [
        "Patient banner, registration, claims, provider directory, prescriptions."
      ],
      "whenNotToUse": [
        "Identifier entry: TextField with mask."
      ],
      "accessibility": [
        "Masked values are announced as \"SSN ending 6789\".",
        "Copy and reveal buttons have names that change with state."
      ],
      "example": "<IdentifierDisplay type=\"ssn\" value=\"123456789\" revealable onReveal={logAccess} />",
      "readme": "src/components/IdentifierDisplay/README.md",
      "storybook": "basic-clinical-values-identifierdisplay--docs"
    },
    {
      "name": "ImmunizationSchedule",
      "layer": "complex",
      "group": "Clinical",
      "summary": "ImmunizationSchedule is the vaccine grid by dose with Given, Due, Overdue, Declined and Later states, synced with the state registry.",
      "import": "import { ImmunizationSchedule } from 'health-components';",
      "element": {
        "tag": "co-immunization-schedule",
        "events": [
          "co-record-dose",
          "co-change",
          "co-input"
        ],
        "slots": [
          "subtitle"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "columns",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "string[]: dose ages (\"Birth\", \"2 mo\"...); required",
          "callback": false
        },
        {
          "name": "rows",
          "type": "ImmunizationRow[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{vaccine, doses: Array<{status?, date?}>}>; required",
          "callback": false
        },
        {
          "name": "synced",
          "type": "string",
          "required": false,
          "default": "subtitle; default \"today\"",
          "allowedValues": null,
          "description": "Registry sync time, in the",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "\"CDC schedule . IIS synced {synced}\"",
          "allowedValues": null,
          "description": "Replaces the subtitle",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Record Dose",
          "callback": false
        },
        {
          "name": "onRecordDose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Record Dose clicked",
          "callback": true
        }
      ],
      "whenToUse": [
        "Pediatric and adult immunization history and forecast."
      ],
      "whenNotToUse": [
        "Recording one dose: a form in a Drawer."
      ],
      "accessibility": [
        "Each cell has a word or date and an icon."
      ],
      "example": "<ImmunizationSchedule columns={[\"2 mo\", \"4 mo\", \"6 mo\"]} rows={forecast} />",
      "readme": "src/components/ImmunizationSchedule/README.md",
      "storybook": "complex-clinical-immunizationschedule--docs"
    },
    {
      "name": "InboxItem",
      "layer": "potassium 6.1 mmol",
      "group": "L (critical)",
      "summary": "InboxItem is one inbox card for a result, refill, message, co-sign, imaging or fax, with priority and inline actions.",
      "import": "import { InboxItem } from 'health-components';",
      "element": {
        "tag": "co-inbox-item",
        "events": [
          "co-action"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "item",
          "type": "InboxItemData",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{kind, patient, title, from, received, priority?, unread?, actions?: string[]}; required",
          "callback": false
        },
        {
          "name": "onAction",
          "type": "(action: string, item: InboxItemData) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the action label when an action button is pressed",
          "callback": true
        }
      ],
      "whenToUse": [
        "Inbox cards on phones and dashboards."
      ],
      "whenNotToUse": [
        "Bulk work: InboxList table."
      ],
      "accessibility": [
        "Priority in words."
      ],
      "example": "<InboxItem item={{ kind: \"refill\", patient: \"Henna West\", title: \"Metformin 500 mg\", from: \"Walgreens\", received: \"9:02 AM\", actions: [\"Approve\", \"Deny\"] }} />",
      "readme": "src/components/InboxItem/README.md",
      "storybook": "potassium-6-1-mmol-l-critical--docs"
    },
    {
      "name": "InboxList",
      "layer": "1 critical value waiting.",
      "group": null,
      "summary": "InboxList is the clinical inbox: a critical-value alert, type tabs with counts, and a selectable worklist with sign, review and assign.",
      "import": "import { InboxList } from 'health-components';",
      "element": {
        "tag": "co-inbox-list",
        "events": [
          "co-category-change",
          "co-acknowledge",
          "co-open-chart",
          "co-sign",
          "co-mark-reviewed",
          "co-assign",
          "co-row-action"
        ],
        "slots": [
          "lock-text"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "InboxListItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{id, type, patient, item, received, priority, status}>. Required",
          "callback": false
        },
        {
          "name": "categories",
          "type": "InboxListCategory[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array<{id, count, alert?}>: one pill tab each after \"All\"",
          "callback": false
        },
        {
          "name": "critical",
          "type": "InboxListCritical",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "{title, body}: critical-value alert pinned on top",
          "callback": false
        },
        {
          "name": "canSign",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the role can sign; false disables Sign Selected",
          "callback": false
        },
        {
          "name": "lockText",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Lock banner explaining what the role cannot do",
          "callback": false
        },
        {
          "name": "pageSize",
          "type": "number",
          "required": false,
          "default": "5",
          "allowedValues": null,
          "description": "Rows per page",
          "callback": false
        },
        {
          "name": "category",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected type tab (controlled)",
          "callback": false
        },
        {
          "name": "defaultCategory",
          "type": "string",
          "required": false,
          "default": "'All'",
          "allowedValues": null,
          "description": "Initially selected type tab",
          "callback": false
        },
        {
          "name": "onCategoryChange",
          "type": "(category: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new type tab",
          "callback": true
        },
        {
          "name": "onAcknowledge",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Acknowledge and Call Patient\" on the critical alert",
          "callback": true
        },
        {
          "name": "onOpenChart",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Open Chart\" on the critical alert",
          "callback": true
        },
        {
          "name": "onSign",
          "type": "(ids: DataTableRowId[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Sign Selected\" bulk action, with the selected ids",
          "callback": true
        },
        {
          "name": "onMarkReviewed",
          "type": "(ids: DataTableRowId[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Mark Reviewed\" bulk action",
          "callback": true
        },
        {
          "name": "onAssign",
          "type": "(ids: DataTableRowId[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Assign to...\" bulk action",
          "callback": true
        },
        {
          "name": "onRowAction",
          "type": "(action: 'open' | 'route' | 'pend', item: InboxListItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Row menu choice: 'open' | 'route' | 'pend'",
          "callback": true
        }
      ],
      "whenToUse": [
        "Provider and nurse inbox; task queues with the same shape."
      ],
      "whenNotToUse": [
        "Patient messaging: ChatThread."
      ],
      "accessibility": [
        "Priority shows a word and, for Critical, an icon."
      ],
      "example": "<InboxList items={inbox} categories={[{ id: \"Lab Results\", count: 3 }, { id: \"Co-sign\", count: 2, alert: true }]}\n  critical={{ title: \"1 critical value waiting\", body: \"Ralph Edwards, potassium 6.1 mmol/L\" }} canSign={role === \"provider\"} />",
      "readme": "src/components/InboxList/README.md",
      "storybook": "1-critical-value-waiting--docs"
    },
    {
      "name": "InpatientOrderEntry",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "InpatientOrderEntry writes one inpatient medication order with dose, route, frequency, duration, PRN reason and priority, shows the order sentence as it is built, and tracks pharmacist verification.",
      "import": "import { InpatientOrderEntry } from 'health-components';",
      "element": {
        "tag": "co-inpatient-order-entry",
        "events": [
          "co-change",
          "co-sign",
          "co-verify",
          "co-return",
          "co-cancel"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "order",
          "type": "InpatientOrder",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{ name, dose, unit, route, freq, prn, prnReason, maxDaily, duration, priority, weightBased, warnings: [{ tone, title, text }] }; required",
          "callback": false
        },
        {
          "name": "value",
          "type": "InpatientOrderDraft",
          "required": false,
          "default": "uncontrolled from `order`",
          "allowedValues": null,
          "description": "Frequency, PRN, PRN reason, priority and duration (controlled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(draft: InpatientOrderDraft) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new draft when the prescriber changes it",
          "callback": true
        },
        {
          "name": "status",
          "type": "OrderVerifyStatus",
          "required": false,
          "default": "'draft'",
          "allowedValues": [
            "override",
            "draft",
            "pending",
            "verified",
            "rejected"
          ],
          "description": "'draft' | 'pending' | 'verified' | 'rejected' | 'override'",
          "callback": false
        },
        {
          "name": "role",
          "type": "'prescriber' | 'pharmacist'",
          "required": false,
          "default": "'prescriber'",
          "allowedValues": [
            "prescriber",
            "pharmacist"
          ],
          "description": "'prescriber' | 'pharmacist'",
          "callback": false
        },
        {
          "name": "patient",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "verifiedBy",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Pharmacist who verified it",
          "callback": false
        },
        {
          "name": "verifiedAt",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "When it was verified",
          "callback": false
        },
        {
          "name": "pharmacist",
          "type": "string",
          "required": false,
          "default": "'pharmacy'",
          "allowedValues": null,
          "description": "Pharmacist who returned it",
          "callback": false
        },
        {
          "name": "pharmacistNote",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Why it was returned",
          "callback": false
        },
        {
          "name": "overrideBy",
          "type": "string",
          "required": false,
          "default": "'the nurse'",
          "allowedValues": null,
          "description": "Nurse who gave it before verification",
          "callback": false
        },
        {
          "name": "showErrors",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows required-field errors",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "(draft: InpatientOrderDraft, sentence: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Sign Order with the draft and the order sentence",
          "callback": true
        },
        {
          "name": "onVerify",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Verify (pharmacist)",
          "callback": true
        },
        {
          "name": "onReturn",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Return to Prescriber (pharmacist)",
          "callback": true
        },
        {
          "name": "onCancel",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Cancel",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "CPOE for inpatient medication orders, and the pharmacist verification view of the same order."
      ],
      "whenNotToUse": [
        "Outpatient prescriptions: the e-prescribing components.",
        "Order sets with many orders."
      ],
      "accessibility": [
        "Order sentence is a polite live region.",
        "Priority is a radiogroup."
      ],
      "example": "<InpatientOrderEntry patient=\"Ruiz, Carmen\" order={{ name: \"Oxycodone\", dose: 5, unit: \"mg\", route: \"PO\", freq: \"q4h\", prn: true }} />",
      "readme": "src/components/InpatientOrderEntry/README.md",
      "storybook": "complex-inpatient-flow-inpatientorderentry--docs"
    },
    {
      "name": "InsuranceCard",
      "layer": "complex",
      "group": "Revenue",
      "summary": "InsuranceCard shows the front and back of a member card with the fields billing needs and the scan state.",
      "import": "import { InsuranceCard } from 'health-components';",
      "element": {
        "tag": "co-insurance-card",
        "events": [
          "co-side-change",
          "co-scan"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "payer",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Payer name, e.g. \"Aetna\" (front)",
          "callback": false
        },
        {
          "name": "plan",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Plan name, e.g. \"Open Access PPO\" (front)",
          "callback": false
        },
        {
          "name": "member",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Member name as printed on the card (front)",
          "callback": false
        },
        {
          "name": "memberId",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Member ID (front)",
          "callback": false
        },
        {
          "name": "group",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Group number (front)",
          "callback": false
        },
        {
          "name": "copay",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Copay line, e.g. \"PCP $25 . Spec $50\" (front)",
          "callback": false
        },
        {
          "name": "rx",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Rx BIN / PCN (front)",
          "callback": false
        },
        {
          "name": "payerId",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Payer ID for electronic claims (back)",
          "callback": false
        },
        {
          "name": "claimsAddress",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Where claims go (back)",
          "callback": false
        },
        {
          "name": "phone",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Provider services phone line (back)",
          "callback": false
        },
        {
          "name": "precert",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Pre-certification rule or phone (back)",
          "callback": false
        },
        {
          "name": "side",
          "type": "InsuranceCardSide",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": [
            "front",
            "back"
          ],
          "description": "Controlled side shown: 'front' | 'back'",
          "callback": false
        },
        {
          "name": "defaultSide",
          "type": "InsuranceCardSide",
          "required": false,
          "default": "'front'",
          "allowedValues": [
            "front",
            "back"
          ],
          "description": "Initial side when uncontrolled",
          "callback": false
        },
        {
          "name": "onSideChange",
          "type": "(side: InsuranceCardSide) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the user flips the card",
          "callback": true
        },
        {
          "name": "scanned",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Scan date; shows a Scanned badge instead of the Scan Card button",
          "callback": false
        },
        {
          "name": "onScan",
          "type": "(event: MouseEvent<HTMLButtonElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Scan Card is pressed",
          "callback": true
        }
      ],
      "whenToUse": [
        "Check-in and coverage review."
      ],
      "whenNotToUse": [
        "Coverage order: CoverageStack."
      ],
      "accessibility": [
        "role group labelled with payer and side, so the typed fields stay readable by screen readers."
      ],
      "example": "<InsuranceCard payer=\"Aetna\" plan=\"Open Access PPO\" memberId=\"W123456789\" scanned=\"10/09/2026\" />",
      "readme": "src/components/InsuranceCard/README.md",
      "storybook": "complex-revenue-insurancecard--docs"
    },
    {
      "name": "InsuranceCoverageCard",
      "layer": "complex",
      "group": "Revenue",
      "summary": "InsuranceCoverageCard lists a patient's active coverages in billing order (COB), with reorder arrows, eligibility status and a suggested-order warning.",
      "import": "import { InsuranceCoverageCard } from 'health-components';",
      "element": {
        "tag": "co-insurance-coverage-card",
        "events": [
          "co-reorder",
          "co-add",
          "co-apply-suggested",
          "co-keep-order",
          "co-check-eligibility",
          "co-coverage-action"
        ],
        "slots": []
      },
      "aliases": [
        "CoverageStack"
      ],
      "props": [
        {
          "name": "coverages",
          "type": "Coverage[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Coverages in billing order (controlled): Array<{payer, plan, memberId, group?, subscriber?, status?, checked?}>",
          "callback": false
        },
        {
          "name": "defaultCoverages",
          "type": "Coverage[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial coverages in billing order (uncontrolled)",
          "callback": false
        },
        {
          "name": "onReorder",
          "type": "(coverages: Coverage[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new order after a move",
          "callback": true
        },
        {
          "name": "suggested",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Suggested order text; shows the order warning",
          "callback": false
        },
        {
          "name": "selfPay",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Self-pay warning (no active coverage)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "No arrows and no Add Coverage",
          "callback": false
        },
        {
          "name": "onAdd",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Add Coverage",
          "callback": true
        },
        {
          "name": "onApplySuggested",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Apply Suggested Order in the order warning",
          "callback": true
        },
        {
          "name": "onKeepOrder",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Keep Current Order in the order warning",
          "callback": true
        },
        {
          "name": "onCheckEligibility",
          "type": "(coverage: Coverage) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Check Eligibility on a coverage",
          "callback": true
        },
        {
          "name": "onCoverageAction",
          "type": "(action: CoverageAction, coverage: Coverage) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "An item of a coverage's More menu",
          "callback": true
        }
      ],
      "whenToUse": [
        "Insurance section of the chart; check-in coverage review."
      ],
      "whenNotToUse": [
        "Editing one coverage's fields: a form in a Drawer."
      ],
      "accessibility": [
        "Arrow buttons are named \"Move Aetna up\"; order is also written (Primary, Secondary)."
      ],
      "example": "<InsuranceCoverageCard coverages={patient.coverages} suggested=\"Medicare first, then AARP Supplement\" onReorder={saveOrder} />",
      "readme": "src/components/InsuranceCoverageCard/README.md",
      "storybook": "complex-revenue-insurancecoveragecard--docs"
    },
    {
      "name": "IntakeOutputPanel",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "IntakeOutputPanel lists intake and output entries for a shift with a running balance, totals and urine output in mL/kg/h.",
      "import": "import { IntakeOutputPanel } from 'health-components';",
      "element": {
        "tag": "co-intake-output-panel",
        "events": [
          "co-add"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "entries",
          "type": "IntakeOutputEntry[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Entries in time order (initial list; entries added here are appended)",
          "callback": false
        },
        {
          "name": "weightKg",
          "type": "number",
          "required": false,
          "default": "none (no rate)",
          "allowedValues": null,
          "description": "Weight in kg, for urine output in mL/kg/h",
          "callback": false
        },
        {
          "name": "hours",
          "type": "number",
          "required": false,
          "default": "none (no rate)",
          "allowedValues": null,
          "description": "Hours the entries cover, for mL/kg/h",
          "callback": false
        },
        {
          "name": "uoTarget",
          "type": "number",
          "required": false,
          "default": "0.5",
          "allowedValues": null,
          "description": "Urine output target in mL/kg/h",
          "callback": false
        },
        {
          "name": "inCategories",
          "type": "string[]",
          "required": false,
          "default": "['PO', 'IV', 'IV piggyback', 'Blood', 'Tube feed']",
          "allowedValues": null,
          "description": "Intake sources",
          "callback": false
        },
        {
          "name": "outCategories",
          "type": "string[]",
          "required": false,
          "default": "['Urine', 'Emesis', 'Stool', 'Drain', 'NG', 'Blood loss']",
          "allowedValues": null,
          "description": "Output sources",
          "callback": false
        },
        {
          "name": "now",
          "type": "string",
          "required": false,
          "default": "time of a new entry; default ''",
          "allowedValues": null,
          "description": "",
          "callback": false
        },
        {
          "name": "defaultAdding",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Opens the add form at first",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only: no Add entry",
          "callback": false
        },
        {
          "name": "onAdd",
          "type": "(entry: IntakeOutputEntry) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with the new entry when one is saved",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Intake and Output'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shift line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use",
          "callback": false
        }
      ],
      "whenToUse": [
        "Shift I&O on med-surg, ICU, peds, post-op and renal patients."
      ],
      "whenNotToUse": [
        "Hour-by-hour drip volumes alongside vitals: Flowsheet I&O group."
      ],
      "accessibility": [
        "Table with caption; amounts right-aligned in tabular figures.",
        "Net balance sign is a character (+ or −), not only colour."
      ],
      "example": "<IntakeOutputPanel entries={io} weightKg={82} hours={8} onAdd={save} />",
      "readme": "src/components/IntakeOutputPanel/README.md",
      "storybook": "complex-inpatient-nursing-intakeoutputpanel--docs"
    },
    {
      "name": "IsolationBadge",
      "layer": "basic",
      "group": "Inpatient flow",
      "summary": "IsolationBadge names the transmission-based precautions a patient is on, so staff put on the right protection before they enter the room.",
      "import": "import { IsolationBadge } from 'health-components';",
      "element": {
        "tag": "co-isolation-badge",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "type",
          "type": "IsolationType",
          "required": true,
          "default": null,
          "allowedValues": [
            "standard",
            "contact",
            "contact-plus",
            "droplet",
            "airborne",
            "airborne-contact",
            "neutropenic"
          ],
          "description": "'contact' | 'contact-plus' | 'droplet' | 'airborne' | 'airborne-contact' | 'neutropenic' | 'standard'; required",
          "callback": false
        },
        {
          "name": "organism",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Organism, shown in brackets ('MRSA')",
          "callback": false
        },
        {
          "name": "pending",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Rule-out: on precautions while the test is pending",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Drops the \"Isolation:\" prefix in dense rows",
          "callback": false
        },
        {
          "name": "size",
          "type": "'sm' | 'md'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        },
        {
          "name": "showStandard",
          "type": "boolean",
          "required": false,
          "default": "because it applies to everyone); default false",
          "allowedValues": null,
          "description": "Shows 'standard' (hidden by",
          "callback": false
        }
      ],
      "whenToUse": [
        "On the bed board, census rows, patient banner and door signs, wherever a person decides whether to enter a room."
      ],
      "whenNotToUse": [
        "Allergies (AllergyBadge) or code status; those are different risks.",
        "Standard precautions on every patient: it is hidden by default because it applies to everyone."
      ],
      "accessibility": [
        "The precaution is in words, never colour alone; the shield icon is decorative.",
        "The tooltip names the protection to wear."
      ],
      "example": "<IsolationBadge type=\"contact-plus\" organism=\"C. diff\" />\n<IsolationBadge type=\"airborne\" organism=\"TB\" pending compact size=\"sm\" />",
      "readme": "src/components/IsolationBadge/README.md",
      "storybook": "basic-inpatient-flow-isolationbadge--docs"
    },
    {
      "name": "KioskStep",
      "layer": "complex",
      "group": "Mobile and kiosk",
      "summary": "KioskStep is one step of front-desk tablet check-in: kiosk header with Help, step segments, big title, content and large Back and Continue buttons.",
      "import": "import { KioskStep } from 'health-components';",
      "element": {
        "tag": "co-kiosk-step",
        "events": [
          "co-back",
          "co-next",
          "co-help"
        ],
        "slots": [
          "subtitle",
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "step",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Current step, 1-based. Required",
          "callback": false
        },
        {
          "name": "total",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Number of steps. Required",
          "callback": false
        },
        {
          "name": "stepName",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Short step name in the header (\"Find appointment\"). Required",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Big heading (h1) of the step. Required",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Instruction under the heading",
          "callback": false
        },
        {
          "name": "practice",
          "type": "string",
          "required": false,
          "default": "\"Valley Family Clinic\"",
          "allowedValues": null,
          "description": "Practice name in the header",
          "callback": false
        },
        {
          "name": "nextLabel",
          "type": "string",
          "required": false,
          "default": "\"Continue\"",
          "allowedValues": null,
          "description": "Label of the main button",
          "callback": false
        },
        {
          "name": "nextDisabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables the main button until required fields are filled",
          "callback": false
        },
        {
          "name": "onBack",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Back button (shown from step 2)",
          "callback": true
        },
        {
          "name": "onNext",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Main button",
          "callback": true
        },
        {
          "name": "onHelp",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"I need help\" in the header",
          "callback": true
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Fields of the step.",
          "callback": false
        }
      ],
      "whenToUse": [
        "Self check-in tablets."
      ],
      "whenNotToUse": [
        "Patient phones: PhoneScaffold."
      ],
      "accessibility": [
        "48px controls; progress announced as Step N of 6."
      ],
      "example": "<KioskStep step={1} total={6} stepName=\"Find appointment\" title=\"Find your appointment\" onNext={find}>\n  <TextField label=\"Last name\" size=\"lg\" required />\n</KioskStep>",
      "readme": "src/components/KioskStep/README.md",
      "storybook": "complex-mobile-and-kiosk-kioskstep--docs"
    },
    {
      "name": "KPIGrid",
      "layer": "complex",
      "group": "Dashboards",
      "summary": "KPIGrid lays out StatCards in a responsive grid and can make them a single-select filter for the table below.",
      "import": "import { KPIGrid } from 'health-components';",
      "element": {
        "tag": "co-kpi-grid",
        "events": [
          "co-select"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "KPIGridItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "StatCard props[]. Required",
          "callback": false
        },
        {
          "name": "filter",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Cards become a single-select filter (toggle buttons)",
          "callback": false
        },
        {
          "name": "selected",
          "type": "string | null",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Label of the selected card, or null for none (controlled)",
          "callback": false
        },
        {
          "name": "defaultSelected",
          "type": "string | null",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initially selected label (uncontrolled)",
          "callback": false
        },
        {
          "name": "onSelect",
          "type": "(label: string | null) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(label | null) => void: selecting the selected card again clears it",
          "callback": true
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Accessible name of the filter group",
          "callback": false
        }
      ],
      "whenToUse": [
        "Top of dashboards and queues."
      ],
      "whenNotToUse": [
        "More than 6 numbers: a report."
      ],
      "accessibility": [
        "As StatCard: buttons with aria-pressed when filter is on."
      ],
      "example": "<KPIGrid filter selected={kpi} onSelect={setKpi} items={[{ label: \"Needs Review\", value: 14 }, { label: \"Pended\", value: 6 }]} />",
      "readme": "src/components/KPIGrid/README.md",
      "storybook": "complex-dashboards-kpigrid--docs"
    },
    {
      "name": "LaborDeliveryBoard",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "LaborDeliveryBoard lists every patient on labor and delivery: room, gravida and para, gestational age, last cervical exam, time since membranes ruptured, fetal heart rate and tracing category, oxytocin rate, status and care team.",
      "import": "import { LaborDeliveryBoard } from 'health-components';",
      "element": {
        "tag": "co-labor-delivery-board",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patients",
          "type": "LDPatient[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patients on the unit; required",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Labor and Delivery Board'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "L&D charge nurse and provider overview."
      ],
      "whenNotToUse": [
        "One labor: PartogramChart and FetalMonitorStrip."
      ],
      "accessibility": [
        "Tracing category is written out (\"Category II\"), not colour alone.",
        "Station uses a real minus sign so screen readers say minus."
      ],
      "example": "<LaborDeliveryBoard patients={ldPatients} />",
      "readme": "src/components/LaborDeliveryBoard/README.md",
      "storybook": "complex-ed-periop-labordeliveryboard--docs"
    },
    {
      "name": "LabResultTable",
      "layer": "complex",
      "group": "Clinical",
      "summary": "LabResultTable shows a lab panel with value, H, L and critical flags, reference range, units, trend and collection time, plus sign and route.",
      "import": "import { LabResultTable } from 'health-components';",
      "element": {
        "tag": "co-lab-result-table",
        "events": [
          "co-sign",
          "co-route",
          "co-change",
          "co-input"
        ],
        "slots": [
          "subtitle",
          "critical",
          "actions"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "rows",
          "type": "LabResultRow[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{test, loinc?, value, flag?, range, units, trend?, collected}>; required",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "\"Lab Results\"",
          "allowedValues": null,
          "description": "Card title and table caption",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title (lab, collection time, ordering provider)",
          "callback": false
        },
        {
          "name": "critical",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Critical value message, shown in a red alert above the table",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shows Sign and Notify Patient and Route to Nurse; called on Sign",
          "callback": true
        },
        {
          "name": "onRoute",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Route to Nurse clicked (shown with onSign)",
          "callback": true
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card header actions",
          "callback": false
        }
      ],
      "whenToUse": [
        "Reviewing and signing lab results."
      ],
      "whenNotToUse": [
        "Ordering labs: OrderSetPicker."
      ],
      "accessibility": [
        "Flags in words; table semantics."
      ],
      "example": "<LabResultTable title=\"Basic metabolic panel\" rows={bmp} critical=\"Potassium 6.1 mmol/L\" onSign={sign} />",
      "readme": "src/components/LabResultTable/README.md",
      "storybook": "complex-clinical-labresulttable--docs"
    },
    {
      "name": "LevelOfCareBadge",
      "layer": "basic",
      "group": "Inpatient flow",
      "summary": "LevelOfCareBadge shows how much monitoring a patient needs, from observation to ICU, and a pending change in level.",
      "import": "import { LevelOfCareBadge } from 'health-components';",
      "element": {
        "tag": "co-level-of-care-badge",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "level",
          "type": "LevelOfCare",
          "required": true,
          "default": null,
          "allowedValues": [
            "medsurg",
            "obs",
            "boarding",
            "icu",
            "stepdown",
            "tele",
            "l-d",
            "nicu",
            "psych"
          ],
          "description": "'icu' | 'stepdown' | 'tele' | 'medsurg' | 'obs' | 'boarding' | 'l-d' | 'nicu' | 'psych'; required",
          "callback": false
        },
        {
          "name": "pendingTo",
          "type": "LevelOfCare",
          "required": false,
          "default": "none",
          "allowedValues": [
            "medsurg",
            "obs",
            "boarding",
            "icu",
            "stepdown",
            "tele",
            "l-d",
            "nicu",
            "psych"
          ],
          "description": "A requested change of level, shown as \"ICU → Step-down pending\"",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Short label only (hides the pending change)",
          "callback": false
        },
        {
          "name": "size",
          "type": "'sm' | 'md'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        }
      ],
      "whenToUse": [
        "Bed board, census, ADT and transfer review, next to the patient or the unit."
      ],
      "whenNotToUse": [
        "Billing status alone; observation vs inpatient status has its own rules and is shown in ADTPanel."
      ],
      "accessibility": [
        "Full level name is in the tooltip; the arrow is read as text."
      ],
      "example": "<LevelOfCareBadge level=\"icu\" pendingTo=\"stepdown\" />",
      "readme": "src/components/LevelOfCareBadge/README.md",
      "storybook": "basic-inpatient-flow-levelofcarebadge--docs"
    },
    {
      "name": "LineChart",
      "layer": "basic",
      "group": "Charts",
      "summary": "LineChart shows a trend over time for up to two series, with an optional target band.",
      "import": "import { LineChart } from 'health-components';",
      "element": {
        "tag": "co-line-chart",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "labels",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "X-axis labels, one per value",
          "callback": false
        },
        {
          "name": "series",
          "type": "LineChartSeries[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{name, values: number[], color?}>; up to two series read well (the second is dashed)",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Caption above the chart and start of the accessible summary",
          "callback": false
        },
        {
          "name": "height",
          "type": "number",
          "required": false,
          "default": "180",
          "allowedValues": null,
          "description": "Height of the drawing in viewBox units (the chart scales with its width)",
          "callback": false
        },
        {
          "name": "min",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Bottom of the scale",
          "callback": false
        },
        {
          "name": "max",
          "type": "number",
          "required": false,
          "default": "auto (largest value)",
          "allowedValues": null,
          "description": "Top of the scale",
          "callback": false
        },
        {
          "name": "band",
          "type": "[number, number]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "[low, high] target band",
          "callback": false
        }
      ],
      "whenToUse": [
        "A1c over a year, weekly visit volume, days in A/R."
      ],
      "whenNotToUse": [
        "Categories without order: BarChart."
      ],
      "accessibility": [
        "role img with every value in the label; points are drawn as circles too."
      ],
      "example": "<LineChart title=\"A1c (%)\" labels={dates} series={[{ name: \"A1c\", values: a1c }]} band={[4, 7]} min={4} max={10} />",
      "readme": "src/components/LineChart/README.md",
      "storybook": "basic-charts-linechart--docs"
    },
    {
      "name": "ListRow",
      "layer": "basic",
      "group": "Layout",
      "summary": "ListRow is the 56px tappable row used for lists on phone and portal screens.",
      "import": "import { ListRow } from 'health-components';",
      "element": {
        "tag": "co-list-row",
        "events": [
          "co-click"
        ],
        "slots": [
          "leading",
          "trailing"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Main line",
          "callback": false
        },
        {
          "name": "meta",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Second line",
          "callback": false
        },
        {
          "name": "leading",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Before the text (Avatar, Icon)",
          "callback": false
        },
        {
          "name": "trailing",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "After the text (StatusTag, time); must not be interactive when the row is",
          "callback": false
        },
        {
          "name": "onClick",
          "type": "(event: MouseEvent<HTMLElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Makes the row a button with a chevron",
          "callback": true
        },
        {
          "name": "href",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Makes the row a link with a chevron",
          "callback": false
        },
        {
          "name": "target",
          "type": "AnchorHTMLAttributes<HTMLAnchorElement>['target']",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Link target when `href` is set",
          "callback": false
        }
      ],
      "whenToUse": [
        "Lists of patients, messages, settings on phones."
      ],
      "whenNotToUse": [
        "Desktop tables: DataTable."
      ],
      "accessibility": [
        "Whole row is one button."
      ],
      "example": "<ListRow leading={<Avatar name=\"Henna West\" size=\"sm\" />} title=\"Henna West\" meta=\"9:20 AM . Follow-Up\" onClick={open} />",
      "readme": "src/components/ListRow/README.md",
      "storybook": "basic-layout-listrow--docs"
    },
    {
      "name": "LockedField",
      "layer": "complex",
      "group": "Access",
      "summary": "LockedField is a read-only field for the View access level: value visible and copyable, lock icon and \"Your role can view but not edit\".",
      "import": "import { LockedField } from 'health-components';",
      "element": {
        "tag": "co-locked-field",
        "events": [
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; required",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Value shown, selectable and copyable; required",
          "callback": false
        },
        {
          "name": "message",
          "type": "string",
          "required": false,
          "default": "\"Your role can view but not edit\"",
          "allowedValues": null,
          "description": "Lock line under the field (name the missing permission)",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        },
        {
          "name": "size",
          "type": "TextFieldSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "lg"
          ],
          "description": "'sm' 30px | 'md' 36px | 'lg' 48px (kiosk)",
          "callback": false
        },
        {
          "name": "iconLeft",
          "type": "IconName",
          "required": false,
          "default": "none",
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon inside the input on the left",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "the mask hint",
          "allowedValues": null,
          "description": "Muted hint under the field",
          "callback": false
        },
        {
          "name": "suffix",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Unit text inside the input on the right, such as \"units\"",
          "callback": false
        }
      ],
      "whenToUse": [
        "Any field the role can read but not change."
      ],
      "whenNotToUse": [
        "Fields the role must not see: do not render (None)."
      ],
      "accessibility": [
        "aria-describedby links the lock line."
      ],
      "example": "<LockedField label=\"Member ID\" value=\"W123456789\" message=\"Needs Edit coverage\" />",
      "readme": "src/components/LockedField/README.md",
      "storybook": "complex-access-lockedfield--docs"
    },
    {
      "name": "MAR",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "MAR is the medication administration record: scheduled, PRN and continuous orders by time, with Given, Held, Refused, Late and Due states, a two-scan five rights check, a witness for high-alert drugs and co-sign.",
      "import": "import { MAR } from 'health-components';",
      "element": {
        "tag": "co-m-a-r",
        "events": [
          "co-filter-change",
          "co-record",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "rows",
          "type": "MarRow[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Orders; required",
          "callback": false
        },
        {
          "name": "times",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Column times; required",
          "callback": false
        },
        {
          "name": "nowTime",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Current column",
          "callback": false
        },
        {
          "name": "patientName",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient name for the wristband step",
          "callback": false
        },
        {
          "name": "patientBarcode",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Expected wristband code",
          "callback": false
        },
        {
          "name": "nurse",
          "type": "string",
          "required": false,
          "default": "'You'",
          "allowedValues": null,
          "description": "Who records",
          "callback": false
        },
        {
          "name": "now",
          "type": "string",
          "required": false,
          "default": "the scheduled time",
          "allowedValues": null,
          "description": "Time recorded",
          "callback": false
        },
        {
          "name": "defaultActive",
          "type": "{ row: string; time: string }",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Administer panel open at first",
          "callback": false
        },
        {
          "name": "defaultScans",
          "type": "MarScans",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Initial scan results",
          "callback": false
        },
        {
          "name": "defaultWitness",
          "type": "string",
          "required": false,
          "default": "''",
          "allowedValues": null,
          "description": "Initial witness",
          "callback": false
        },
        {
          "name": "filter",
          "type": "MarFilter",
          "required": false,
          "default": null,
          "allowedValues": [
            "all",
            "prn",
            "scheduled",
            "continuous"
          ],
          "description": "Controlled filter",
          "callback": false
        },
        {
          "name": "defaultFilter",
          "type": "MarFilter",
          "required": false,
          "default": "'all'",
          "allowedValues": [
            "all",
            "prn",
            "scheduled",
            "continuous"
          ],
          "description": "Initial filter (uncontrolled)",
          "callback": false
        },
        {
          "name": "onFilterChange",
          "type": "(filter: MarFilter) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the filter changes",
          "callback": true
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only: cells are not buttons",
          "callback": false
        },
        {
          "name": "onRecord",
          "type": "(e: MarRecordEvent) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when a dose is recorded Given, Held or Refused",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Medication Administration Record'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Inpatient medication pass on any unit.",
        "Reviewing what was given, held or refused this shift."
      ],
      "whenNotToUse": [
        "Ordering or reconciling medications: MedicationList and MedReconciliation.",
        "Outpatient prescriptions: PrescriptionForm."
      ],
      "accessibility": [
        "Table with caption; each actionable cell is a button named with drug, time and status.",
        "Scan results are announced through a live region.",
        "Disabled Given says why next to it in text.",
        "Status is a word in a pill, never colour alone."
      ],
      "example": "<MAR times={[\"08:00\",\"12:00\",\"16:00\",\"20:00\"]} nowTime=\"12:00\" patientName=\"Marcus Hill\" patientBarcode=\"MRN0048213\" rows={rows} onRecord={post} />",
      "readme": "src/components/MAR/README.md",
      "storybook": "complex-inpatient-nursing-mar--docs"
    },
    {
      "name": "MedicationList",
      "layer": "complex",
      "group": "Medications",
      "summary": "MedicationList is the Medications card with reconciliation status, Reconcile and Prescribe, made of MedicationRows.",
      "import": "import { MedicationList } from 'health-components';",
      "element": {
        "tag": "co-medication-list",
        "events": [
          "co-reconcile",
          "co-prescribe",
          "co-item-action"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "Medication[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "MedicationRow med[]; required",
          "callback": false
        },
        {
          "name": "reconciled",
          "type": "string",
          "required": false,
          "default": "none (Not reconciled this visit)",
          "allowedValues": null,
          "description": "Reconciliation date and person (\"10/09/2026 by James Bell MD\")",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Reconcile, Prescribe and the row menus",
          "callback": false
        },
        {
          "name": "onReconcile",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Reconcile clicked",
          "callback": true
        },
        {
          "name": "onPrescribe",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Prescribe clicked",
          "callback": true
        },
        {
          "name": "onItemAction",
          "type": "(action: MedicationAction, med: Medication) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "A row menu action was chosen",
          "callback": true
        }
      ],
      "whenToUse": [
        "Chart Medications; med reconciliation."
      ],
      "whenNotToUse": [
        "Pharmacy refill queue: InboxItem kind refill."
      ],
      "accessibility": [
        "List semantics."
      ],
      "example": "<MedicationList items={meds} reconciled=\"10/09/2026\" />",
      "readme": "src/components/MedicationList/README.md",
      "storybook": "complex-medications-medicationlist--docs"
    },
    {
      "name": "MedicationRow",
      "layer": "complex",
      "group": "Medications",
      "summary": "MedicationRow is one medication: name and strength, sig, quantity, refills, prescriber, pharmacy, last fill, and the DEA schedule tag for controlled drugs (C-II to C-V).",
      "import": "import { MedicationRow } from 'health-components';",
      "element": {
        "tag": "co-medication-row",
        "events": [
          "co-action"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "med",
          "type": "Medication",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{name, sig, qty, refills?, prescriber?, pharmacy?, last?, schedule?, prn?, status?, source?}; required",
          "callback": false
        },
        {
          "name": "actions",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Shows the Renew / Change Dose / Mark Not Taking / Discontinue menu",
          "callback": false
        },
        {
          "name": "onAction",
          "type": "(action: MedicationAction, med: Medication) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "A menu action was chosen",
          "callback": true
        }
      ],
      "whenToUse": [
        "Inside MedicationList, refill queues, eRx review."
      ],
      "whenNotToUse": [
        "Order entry: DrugSearch and SigBuilder."
      ],
      "accessibility": [
        "Schedule tag has a title with the full meaning."
      ],
      "example": "<ul className=\"co-list\"><MedicationRow med={{ name: \"Oxycodone 5 mg tablet\", sig: \"1 tablet by mouth every 6 hours as needed for pain\", qty: 20, refills: 0, schedule: \"C-II\" }} /></ul>",
      "readme": "src/components/MedicationRow/README.md",
      "storybook": "complex-medications-medicationrow--docs"
    },
    {
      "name": "MedReconciliation",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "MedReconciliation lines up home, inpatient and discharge medicines row by row and asks for continue, modify or stop on each, and will not sign while any row has no decision.",
      "import": "import { MedReconciliation } from 'health-components';",
      "element": {
        "tag": "co-med-reconciliation",
        "events": [
          "co-rows-change",
          "co-sign",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "rows",
          "type": "MedRecRow[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array of { home, inpatient, decision, modified, stopReason, note }; a medicine is { name, dose, unit, route, freq, prn }: the starting rows (uncontrolled); required",
          "callback": false
        },
        {
          "name": "rowsValue",
          "type": "MedRecRow[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "The rows (controlled); pair with onRowsChange",
          "callback": false
        },
        {
          "name": "onRowsChange",
          "type": "(rows: MedRecRow[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new rows when a decision changes",
          "callback": true
        },
        {
          "name": "stage",
          "type": "MedRecStage",
          "required": false,
          "default": "'discharge'",
          "allowedValues": [
            "discharge",
            "admission"
          ],
          "description": "'admission' | 'discharge'",
          "callback": false
        },
        {
          "name": "patient",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient name",
          "callback": false
        },
        {
          "name": "source",
          "type": "string",
          "required": false,
          "default": "'Patient interview and pharmacy fill history'",
          "allowedValues": null,
          "description": "Source of the home list",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Signed and view only",
          "callback": false
        },
        {
          "name": "signedBy",
          "type": "string",
          "required": false,
          "default": "'the attending'",
          "allowedValues": null,
          "description": "Who signed it, shown when readOnly",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "(rows: MedRecRow[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Sign Reconciliation with the rows (enabled once every row has a decision)",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Admission and discharge medication reconciliation, by the admitting or discharging prescriber."
      ],
      "whenNotToUse": [
        "Ordering a single new medicine: InpatientOrderEntry.",
        "Order review at transfer: OrderReconciliation."
      ],
      "accessibility": [
        "Each decision group is a radiogroup named with the medicine.",
        "Stopped medicines say \"Stopped\" in words."
      ],
      "example": "<MedReconciliation stage=\"discharge\" patient=\"Okafor, Grace\" rows={rows} />",
      "readme": "src/components/MedReconciliation/README.md",
      "storybook": "complex-inpatient-flow-medreconciliation--docs"
    },
    {
      "name": "Menu",
      "layer": "basic",
      "group": "Overlays",
      "summary": "Menu lists actions in a dropdown; KebabMenu opens one from a three-dot button and Popover holds a small form or filter set.",
      "import": "import { Menu } from 'health-components';",
      "element": {
        "tag": "co-menu",
        "events": [
          "co-item-select",
          "co-close"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "MenuItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{label, icon?, hint?, shortcut?, danger?, disabled?, active?, onSelect?} | {divider:true} | {heading}>; required",
          "callback": false
        },
        {
          "name": "align",
          "type": "MenuAlign",
          "required": false,
          "default": "'right'",
          "allowedValues": [
            "right",
            "left"
          ],
          "description": "'right' | 'left': which edge of the trigger the dropdown lines up with",
          "callback": false
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Static, in-flow menu for docs and previews",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "aria-label of the menu",
          "callback": false
        },
        {
          "name": "onItemSelect",
          "type": "(item: MenuActionItem, index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen item and its index, after the item's own onSelect (one handler for every item)",
          "callback": true
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called after an item is chosen, and on Escape or Tab inside the menu",
          "callback": true
        },
        {
          "name": "autoFocus",
          "type": "MenuFocusTarget",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Moves focus to the first or last item on mount (used by menu buttons)",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the menu",
          "callback": false
        }
      ],
      "whenToUse": [
        "Row actions in tables, overflow actions in headers, filter popovers."
      ],
      "whenNotToUse": [
        "Navigation between screens: SidebarNav or Tabs."
      ],
      "accessibility": [
        "role menu and menuitem; Escape and outside click close.",
        "Destructive items go last, after a divider."
      ],
      "example": "<KebabMenu label={\"Actions for \" + claim.id} items={[{ label: \"Open Claim\" }, { divider: true }, { label: \"Void Claim\", danger: true }]} />\n<Popover trigger=\"Filters (2)\" title=\"Filter claims\">...</Popover>",
      "readme": "src/components/Menu/README.md",
      "storybook": "basic-overlays-menu--docs"
    },
    {
      "name": "MobileHeader",
      "layer": "complex",
      "group": "Mobile and kiosk",
      "summary": "MobileHeader is the dark bar at the top of phone, portal and kiosk screens, with back, title, subtitle and one action.",
      "import": "import { MobileHeader } from 'health-components';",
      "element": {
        "tag": "co-mobile-header",
        "events": [
          "co-back"
        ],
        "slots": [
          "title",
          "subtitle",
          "action"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Screen title. Required.",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient or date line",
          "callback": false
        },
        {
          "name": "back",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Back link href; shows the chevron back link",
          "callback": false
        },
        {
          "name": "onBack",
          "type": "(event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the back link is clicked (client-side routing)",
          "callback": true
        },
        {
          "name": "action",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "One small action on the right",
          "callback": false
        },
        {
          "name": "variant",
          "type": "MobileHeaderVariant",
          "required": false,
          "default": "'phone'",
          "allowedValues": [
            "phone",
            "kiosk"
          ],
          "description": "'phone' | 'kiosk' (wider, 19px title)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Every phone, portal and kiosk screen."
      ],
      "whenNotToUse": [
        "Desktop: TopBar."
      ],
      "accessibility": [
        "Back link named \"Back\".",
        "White on `primary-strong` passes 4.5:1 in all three light styles; Dark uses `surface-alt` with `ink`."
      ],
      "example": "<MobileHeader back=\"/m/patients\" title=\"Henna West\" subtitle=\"F 38 . MRN-100231\" />",
      "readme": "src/components/MobileHeader/README.md",
      "storybook": "complex-mobile-and-kiosk-mobileheader--docs"
    },
    {
      "name": "Modal",
      "layer": "basic",
      "group": "Overlays",
      "summary": "Modal asks for input or a decision in a centered dialog: form, confirm and destructive kinds.",
      "import": "import { Modal } from 'health-components';",
      "element": {
        "tag": "co-modal",
        "events": [
          "co-primary",
          "co-close"
        ],
        "slots": [
          "title",
          "(default)",
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the dialog is shown",
          "callback": false
        },
        {
          "name": "title",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Dialog title; names the dialog. Required.",
          "callback": false
        },
        {
          "name": "kind",
          "type": "ModalKind",
          "required": false,
          "default": "'form'",
          "allowedValues": [
            "form",
            "confirm",
            "destructive"
          ],
          "description": "'form' | 'confirm' | 'destructive'; form is a dialog, the others alertdialog",
          "callback": false
        },
        {
          "name": "size",
          "type": "ModalSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "wide"
          ],
          "description": "'sm' 420px | 'md' 640px | 'wide' 980px",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Dialog body",
          "callback": false
        },
        {
          "name": "primaryLabel",
          "type": "string",
          "required": false,
          "default": "\"Save\"",
          "allowedValues": null,
          "description": "Primary button label, a verb (\"Void Claim\")",
          "callback": false
        },
        {
          "name": "cancelLabel",
          "type": "string",
          "required": false,
          "default": "\"Cancel\"",
          "allowedValues": null,
          "description": "Cancel button label",
          "callback": false
        },
        {
          "name": "onPrimary",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Primary button handler",
          "callback": true
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Cancel, the x button, Escape and (when `closeOnScrim`) a scrim press",
          "callback": true
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a spinner on the primary button",
          "callback": false
        },
        {
          "name": "primaryDisabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables the primary button",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "Cancel + primary footer; `null` removes the footer; default the two buttons",
          "allowedValues": null,
          "description": "Replaces the",
          "callback": false
        },
        {
          "name": "closeOnScrim",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Close when the scrim is pressed (set false for forms with typed input)",
          "callback": false
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Render in place for docs: no portal, focus trap, scroll lock or Escape",
          "callback": false
        }
      ],
      "whenToUse": [
        "Short focused forms (Add Appointment Type), confirms (\"Discard unsaved changes on this page?\"), destructive actions (Void Claim)."
      ],
      "whenNotToUse": [
        "Long forms or reference panels: Drawer.",
        "Multi-step flows over 3 steps: a page with Stepper."
      ],
      "accessibility": [
        "dialog (form) or alertdialog (confirm, destructive), aria-modal, labelled by the title.",
        "Escape and the x close it; scrim click closes forms only when nothing was typed (app rule).",
        "Move focus into the dialog on open and back to the trigger on close.",
        "Renders through a portal, traps Tab inside and locks page scroll. Pass `closeOnScrim={false}` for forms once something was typed."
      ],
      "example": "<Modal title=\"Void this claim?\" kind=\"destructive\" primaryLabel=\"Void Claim\" onPrimary={voidClaim} onClose={close}>\n  <DescriptionList items={[[\"Claim\", \"CLM-20871\"]]} />\n</Modal>",
      "readme": "src/components/Modal/README.md",
      "storybook": "basic-overlays-modal--docs"
    },
    {
      "name": "MoneyDisplay",
      "layer": "basic",
      "group": "Clinical values",
      "summary": "MoneyDisplay shows US dollar amounts with two decimals, grouping and tabular figures, and negative adjustments in parentheses.",
      "import": "import { MoneyDisplay } from 'health-components';",
      "element": {
        "tag": "co-money-display",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "value",
          "type": "number | null",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Amount in US dollars; null shows an en dash (no amount); required",
          "callback": false
        },
        {
          "name": "emphasis",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Bold, for balance due",
          "callback": false
        },
        {
          "name": "align",
          "type": "'start' | 'end'",
          "required": false,
          "default": "'start'",
          "allowedValues": [
            "start",
            "end"
          ],
          "description": "'start' | 'end' (right aligned for columns)",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Appended to the spoken text ('contractual adjustment')",
          "callback": false
        },
        {
          "name": "minWidth",
          "type": "number",
          "required": false,
          "default": "90",
          "allowedValues": null,
          "description": "Column width in px when `align` is 'end'",
          "callback": false
        }
      ],
      "whenToUse": [
        "Charges, payments, adjustments, balances, copays, estimates."
      ],
      "whenNotToUse": [
        "Counts or units of service: plain numbers."
      ],
      "accessibility": [
        "aria-label says \"minus\" for negatives; parentheses are not read reliably."
      ],
      "example": "<MoneyDisplay value={-45} label=\"contractual adjustment\" />",
      "readme": "src/components/MoneyDisplay/README.md",
      "storybook": "basic-clinical-values-moneydisplay--docs"
    },
    {
      "name": "NursingAssessment",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "NursingAssessment is the head-to-toe shift assessment: one row per body system with a WDL or Exception choice, finding chips and a note for exceptions.",
      "import": "import { NursingAssessment } from 'health-components';",
      "element": {
        "tag": "co-nursing-assessment",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "systems",
          "type": "NursingSystem[]",
          "required": false,
          "default": "DEFAULT_NURSING_SYSTEMS (eight systems)",
          "allowedValues": null,
          "description": "Body systems",
          "callback": false
        },
        {
          "name": "values",
          "type": "Record<string, NursingSystemValue>",
          "required": false,
          "default": "none (not assessed)",
          "allowedValues": null,
          "description": "Saved answers by system id (initial)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Signed, view only",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(id: string, value: NursingSystemValue) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with the system id and its new answer",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Head-to-toe Assessment'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shift line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Accepted for API consistency with the nursing set",
          "callback": false
        }
      ],
      "whenToUse": [
        "Admission and every-shift assessments on inpatient units."
      ],
      "whenNotToUse": [
        "Provider physical exam: use the note template.",
        "A single focused assessment such as wound or pain: WoundCareDoc, PainScale."
      ],
      "accessibility": [
        "Each system is a group with a radiogroup for WDL or Exception.",
        "Finding chips are toggle buttons with aria-pressed.",
        "Progress is text plus a ProgressBar."
      ],
      "example": "<NursingAssessment subtitle=\"Day shift, 08:20\" systems={systems} values={saved} onChange={save} />",
      "readme": "src/components/NursingAssessment/README.md",
      "storybook": "complex-inpatient-nursing-nursingassessment--docs"
    },
    {
      "name": "OncologyRegimen",
      "layer": "complex",
      "group": "Specialty",
      "summary": "OncologyRegimen tracks a chemotherapy regimen cycle by cycle, with BSA-based doses, dose reductions, pre-cycle labs against hold rules and lifetime cumulative doses.",
      "import": "import { OncologyRegimen } from 'health-components';",
      "element": {
        "tag": "co-oncology-regimen",
        "events": [
          "co-hold-cycle",
          "co-release"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "regimen",
          "type": "OncologyRegimenDef",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{name, intent, cycleDays, cycles, bsaCap?, hold, drugs}; required",
          "callback": false
        },
        {
          "name": "patient",
          "type": "OncologyPatient",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{heightCm, weightKg, bsa?, weightChange?}; required",
          "callback": false
        },
        {
          "name": "cycles",
          "type": "ReadonlyArray<RegimenCycle>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Cycles",
          "callback": false
        },
        {
          "name": "cumulative",
          "type": "ReadonlyArray<CumulativeDose>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Lifetime doses",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Hold Cycle and Release to Pharmacy",
          "callback": false
        },
        {
          "name": "onHoldCycle",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Hold Cycle action",
          "callback": true
        },
        {
          "name": "onRelease",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Release to Pharmacy action (disabled while hold criteria are met)",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Infusion center and oncology clinic, before releasing each cycle to pharmacy."
      ],
      "whenNotToUse": [
        "Oral targeted therapy refills: MedicationList.",
        "Weight-based pediatric doses: PediatricDosingCalculator."
      ],
      "accessibility": [
        "Cycles are a list with status words.",
        "The hold reason is written out, and the blocked button says why in the Alert above it.",
        "Lifetime dose meters have value text."
      ],
      "example": "<OncologyRegimen regimen={{ name: \"FOLFOX6\", cycleDays: 14, cycles: 12, hold: { anc: 1.5, plt: 75 }, drugs: [{ name: \"Oxaliplatin\", route: \"IV\", days: \"D1\", mgm2: 85 }] }} patient={{ heightCm: 172, weightKg: 70 }} cycles={[{ n: 1, date: \"08/03/2026\", status: \"given\" }]} />",
      "readme": "src/components/OncologyRegimen/README.md",
      "storybook": "complex-specialty-oncologyregimen--docs"
    },
    {
      "name": "OrderReconciliation",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "OrderReconciliation reviews every active order when a patient changes level of care, so orders that are not allowed on the new unit are stopped or changed before the transfer.",
      "import": "import { OrderReconciliation } from 'health-components';",
      "element": {
        "tag": "co-order-reconciliation",
        "events": [
          "co-orders-change",
          "co-release"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "orders",
          "type": "TransferOrder[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array of { type, name, dose, unit, detail, action, notAllowedOn: level[] }: the starting orders (uncontrolled); required",
          "callback": false
        },
        {
          "name": "ordersValue",
          "type": "TransferOrder[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "The orders (controlled); pair with onOrdersChange",
          "callback": false
        },
        {
          "name": "onOrdersChange",
          "type": "(orders: TransferOrder[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new orders when an action changes",
          "callback": true
        },
        {
          "name": "from",
          "type": "LevelOfCare",
          "required": true,
          "default": null,
          "allowedValues": [
            "medsurg",
            "obs",
            "boarding",
            "icu",
            "stepdown",
            "tele",
            "l-d",
            "nicu",
            "psych"
          ],
          "description": "Level of care the patient leaves; required",
          "callback": false
        },
        {
          "name": "to",
          "type": "LevelOfCare",
          "required": true,
          "default": null,
          "allowedValues": [
            "medsurg",
            "obs",
            "boarding",
            "icu",
            "stepdown",
            "tele",
            "l-d",
            "nicu",
            "psych"
          ],
          "description": "Level of care the patient goes to; required",
          "callback": false
        },
        {
          "name": "patient",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient name and context",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "onRelease",
          "type": "(orders: TransferOrder[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Release Orders with the orders (enabled once every order is reviewed)",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "ICU to step-down or floor, floor to ICU, and to or from procedures."
      ],
      "whenNotToUse": [
        "Home medicine decisions: MedReconciliation."
      ],
      "accessibility": [
        "Arrow between levels is also read as \"to\"."
      ],
      "example": "<OrderReconciliation from=\"icu\" to=\"medsurg\" orders={activeOrders} />",
      "readme": "src/components/OrderReconciliation/README.md",
      "storybook": "complex-inpatient-flow-orderreconciliation--docs"
    },
    {
      "name": "OrderSetPicker",
      "layer": "complex",
      "group": "Orders and notes",
      "summary": "OrderSetPicker shows order sets as tabs and lets the provider tick the labs, imaging, meds and referrals to sign together.",
      "import": "import { OrderSetPicker } from 'health-components';",
      "element": {
        "tag": "co-order-set-picker",
        "events": [
          "co-current-change",
          "co-sign"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "sets",
          "type": "OrderSet[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{name, items: Array<{name, type, detail?, default?}>}>. Required",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title (patient and service)",
          "callback": false
        },
        {
          "name": "current",
          "type": "number",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Index of the shown set (controlled)",
          "callback": false
        },
        {
          "name": "defaultCurrent",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Index of the set shown first (uncontrolled)",
          "callback": false
        },
        {
          "name": "onCurrentChange",
          "type": "(index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the index of the newly shown set",
          "callback": true
        },
        {
          "name": "onSign",
          "type": "(items: OrderSetItem[], set: OrderSet) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Sign Orders with the ticked items of the shown set",
          "callback": true
        }
      ],
      "whenToUse": [
        "Common workups: diabetes follow-up, prenatal first visit, chest pain."
      ],
      "whenNotToUse": [
        "One-off orders: DrugSearch or lab search."
      ],
      "accessibility": [
        "Checkbox list with type tags."
      ],
      "example": "<OrderSetPicker sets={orderSets} />",
      "readme": "src/components/OrderSetPicker/README.md",
      "storybook": "complex-orders-and-notes-ordersetpicker--docs"
    },
    {
      "name": "ORSchedule",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "ORSchedule lays out the day's surgical cases per operating room on a timeline, with case status, delays, the current time and room utilization; SurgeryBoard shows the same cases as a status board table.",
      "import": "import { ORSchedule } from 'health-components';",
      "element": {
        "tag": "co-or-schedule",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "rooms",
          "type": "ORRoom[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Operating rooms, top to bottom; required",
          "callback": false
        },
        {
          "name": "cases",
          "type": "ORCase[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Cases of the day; required",
          "callback": false
        },
        {
          "name": "variant",
          "type": "ORScheduleVariant",
          "required": false,
          "default": "'timeline'",
          "allowedValues": [
            "timeline",
            "board"
          ],
          "description": "'timeline' (rooms as rows, cases as blocks) | 'board' (status table)",
          "callback": false
        },
        {
          "name": "dayStart",
          "type": "string",
          "required": false,
          "default": "'07:00'",
          "allowedValues": null,
          "description": "Timeline start 'HH:MM'",
          "callback": false
        },
        {
          "name": "dayEnd",
          "type": "string",
          "required": false,
          "default": "'19:00'",
          "allowedValues": null,
          "description": "Timeline end 'HH:MM'",
          "callback": false
        },
        {
          "name": "now",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Current time 'HH:MM' for the red Now line",
          "callback": false
        },
        {
          "name": "publicView",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Board for families: shows publicId instead of names",
          "callback": false
        },
        {
          "name": "date",
          "type": "string",
          "required": false,
          "default": "'this day'",
          "allowedValues": null,
          "description": "Day shown in the empty state",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'OR Schedule' (timeline) or 'Surgery Status Board' (board)",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "OR desk and anesthesia coordinator planning.",
        "Surgery status board for staff (board variant) and families (publicView)."
      ],
      "whenNotToUse": [
        "Clinic appointments: Calendar."
      ],
      "accessibility": [
        "Timeline is a grid; each case block is focusable with a full spoken label (time, procedure, surgeon, status).",
        "Status is text inside the block and a tag on the board.",
        "Times use 24-hour HH:MM in tabular figures."
      ],
      "example": "<ORSchedule rooms={rooms} cases={cases} now=\"10:40\" />\n<SurgeryBoard rooms={rooms} cases={cases} publicView />",
      "readme": "src/components/ORSchedule/README.md",
      "storybook": "complex-ed-periop-orschedule--docs"
    },
    {
      "name": "PACUScore",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "PACUScore scores recovery with the modified Aldrete scale (activity, respiration, circulation, consciousness, oxygen saturation; 0 to 2 each, total out of 10) and shows when the patient meets phase I discharge criteria.",
      "import": "import { PACUScore } from 'health-components';",
      "element": {
        "tag": "co-pacu-score",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "values",
          "type": "AldreteValues",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Item scores (controlled)",
          "callback": false
        },
        {
          "name": "defaultValues",
          "type": "AldreteValues",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Initial item scores (uncontrolled), 0 | 1 | 2 each",
          "callback": false
        },
        {
          "name": "history",
          "type": "PACUHistoryRow[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Earlier scores by time",
          "callback": false
        },
        {
          "name": "name",
          "type": "string",
          "required": false,
          "default": "a generated unique prefix",
          "allowedValues": null,
          "description": "Radio group name prefix when several are on a page",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Locked review",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(values: AldreteValues) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with every item score when one changes",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "PACU nursing on arrival and every 15 minutes until discharge."
      ],
      "whenNotToUse": [
        "Phase II or home readiness (PADSS): a separate score."
      ],
      "accessibility": [
        "Each criterion is a fieldset with a legend; options are native radios with the score number in the label.",
        "Total and readiness are a live region."
      ],
      "example": "<PACUScore name=\"bay3\" history={earlier} onChange={saveScore} />",
      "readme": "src/components/PACUScore/README.md",
      "storybook": "complex-ed-periop-pacuscore--docs"
    },
    {
      "name": "Pagination",
      "layer": "basic",
      "group": "Data display",
      "summary": "Pagination shows the record range and lets staff change rows per page and move between pages.",
      "import": "import { Pagination } from 'health-components';",
      "element": {
        "tag": "co-pagination",
        "events": [
          "co-page",
          "co-page-size"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "total",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Total number of records. Required",
          "callback": false
        },
        {
          "name": "page",
          "type": "number",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Current page, 1-based (controlled)",
          "callback": false
        },
        {
          "name": "defaultPage",
          "type": "number",
          "required": false,
          "default": "1",
          "allowedValues": null,
          "description": "Initial page (uncontrolled)",
          "callback": false
        },
        {
          "name": "pageSize",
          "type": "number",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Rows per page (controlled)",
          "callback": false
        },
        {
          "name": "defaultPageSize",
          "type": "number",
          "required": false,
          "default": "10",
          "allowedValues": null,
          "description": "Initial rows per page (uncontrolled)",
          "callback": false
        },
        {
          "name": "pageSizes",
          "type": "readonly number[] | false",
          "required": false,
          "default": "[5, 10, 25, 50]",
          "allowedValues": null,
          "description": "Rows-per-page choices, or false to hide the selector",
          "callback": false
        },
        {
          "name": "onPage",
          "type": "(page: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new page",
          "callback": true
        },
        {
          "name": "onPageSize",
          "type": "(size: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new rows per page (the page also resets to 1)",
          "callback": true
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Pagination\"",
          "allowedValues": null,
          "description": "Accessible name of the nav landmark",
          "callback": false
        }
      ],
      "whenToUse": [
        "Under any paged table."
      ],
      "whenNotToUse": [
        "Infinite scroll on phones."
      ],
      "accessibility": [
        "nav landmark named Pagination; the page info is aria-live."
      ],
      "example": "<Pagination total={248} page={page} pageSize={size} onPage={setPage} onPageSize={setSize} />",
      "readme": "src/components/Pagination/README.md",
      "storybook": "basic-data-display-pagination--docs"
    },
    {
      "name": "PainScale",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "PainScale records pain on the 0 to 10 numeric scale, a faces scale for children, or FLACC for patients who cannot self-report, with severity band and goal check.",
      "import": "import { PainScale } from 'health-components';",
      "element": {
        "tag": "co-pain-scale",
        "events": [
          "co-mode-change",
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "modes",
          "type": "PainScaleMode[]",
          "required": false,
          "default": "['numeric', 'faces', 'flacc']",
          "allowedValues": null,
          "description": "Scales offered; one entry hides the switch",
          "callback": false
        },
        {
          "name": "mode",
          "type": "PainScaleMode",
          "required": false,
          "default": null,
          "allowedValues": [
            "numeric",
            "faces",
            "flacc"
          ],
          "description": "Controlled scale",
          "callback": false
        },
        {
          "name": "defaultMode",
          "type": "PainScaleMode",
          "required": false,
          "default": "'numeric'",
          "allowedValues": [
            "numeric",
            "faces",
            "flacc"
          ],
          "description": "Initial scale (uncontrolled)",
          "callback": false
        },
        {
          "name": "onModeChange",
          "type": "(mode: PainScaleMode) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the scale changes",
          "callback": true
        },
        {
          "name": "value",
          "type": "number | null",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Controlled numeric or faces score, 0 to 10 (null = not scored)",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial numeric or faces score, 0 to 10 (uncontrolled)",
          "callback": false
        },
        {
          "name": "defaultFlacc",
          "type": "Record<string, number>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Initial FLACC answers: option index (0 to 2) per category face, legs, activity, cry, consol",
          "callback": false
        },
        {
          "name": "goal",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient pain goal (0 to 10)",
          "callback": false
        },
        {
          "name": "reassess",
          "type": "string",
          "required": false,
          "default": "'60 min'",
          "allowedValues": null,
          "description": "Reassessment window shown when above goal",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Not selectable",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(e: PainScaleChange) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with the scale and score when a score is picked (FLACC: once all five categories are scored)",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Pain Assessment'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Accepted for API consistency with the nursing set; the pain score is never flagged",
          "callback": false
        }
      ],
      "whenToUse": [
        "Pain assessment and reassessment after PRN analgesia."
      ],
      "whenNotToUse": [
        "Neonates: use NIPS or N-PASS.",
        "Sedated ICU patients: CPOT or BPS."
      ],
      "accessibility": [
        "Every scale is a radiogroup; faces carry text, not only a drawing.",
        "Score and band in a polite live region."
      ],
      "example": "<PainScale defaultValue={7} goal={3} reassess=\"30 min\" />",
      "readme": "src/components/PainScale/README.md",
      "storybook": "complex-inpatient-nursing-painscale--docs"
    },
    {
      "name": "PartogramChart",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "PartogramChart plots cervical dilation and head descent against hours of active labor, with the WHO alert line (1 cm per hour) and action line 4 hours to its right, and an hourly row of fetal heart rate and contractions.",
      "import": "import { PartogramChart } from 'health-components';",
      "element": {
        "tag": "co-partogram-chart",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "dilation",
          "type": "PartogramPoint[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Cervical exams as [hours, cm]; required",
          "callback": false
        },
        {
          "name": "descent",
          "type": "PartogramPoint[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Head descent as [hours, fifths palpable 0 to 5]",
          "callback": false
        },
        {
          "name": "fhr",
          "type": "PartogramPoint[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Fetal heart rate as [hours, bpm]",
          "callback": false
        },
        {
          "name": "contractions",
          "type": "PartogramPoint[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Contractions as [hours, per 10 min]",
          "callback": false
        },
        {
          "name": "hours",
          "type": "number",
          "required": false,
          "default": "12",
          "allowedValues": null,
          "description": "Hours on the x axis",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "'Active phase, alert line at 1 cm per hour, action line 4 hours to the right'",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Monitoring progress of active labor."
      ],
      "whenNotToUse": [
        "Latent phase before 4 cm. Second stage pushing timing: a timer."
      ],
      "accessibility": [
        "The chart has an aria-label listing every exam; FHR and contractions are also a table.",
        "Lines are labelled Alert and Action in text, not only colour."
      ],
      "example": "<PartogramChart dilation={[[0,4],[2,6],[4,8]]} descent={[[0,4],[4,2]]} fhr={fhr} />",
      "readme": "src/components/PartogramChart/README.md",
      "storybook": "complex-ed-periop-partogramchart--docs"
    },
    {
      "name": "PatientBanner",
      "layer": "complex",
      "group": "Clinical",
      "summary": "PatientBanner identifies the patient at the top of every chart screen: name, sex, age, DOB, MRN, phone, insurance, allergies, flags and code status.",
      "import": "import { PatientBanner } from 'health-components';",
      "element": {
        "tag": "co-patient-banner",
        "events": [],
        "slots": [
          "actions"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "name",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient name. Required.",
          "callback": false
        },
        {
          "name": "sex",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Sex (\"F\"). Required.",
          "callback": false
        },
        {
          "name": "age",
          "type": "string | number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Age in years. Required.",
          "callback": false
        },
        {
          "name": "dob",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Date of birth (\"03/14/1988\"). Required.",
          "callback": false
        },
        {
          "name": "mrn",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Medical record number (\"MRN-100231\"). Required.",
          "callback": false
        },
        {
          "name": "phone",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Phone",
          "callback": false
        },
        {
          "name": "insurance",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Payer and member id (\"Aetna W123456789\")",
          "callback": false
        },
        {
          "name": "preferred",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Preferred name, shown in quotes",
          "callback": false
        },
        {
          "name": "allergies",
          "type": "string[]",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Allergies: a list, `[]` for No Known Allergies, or undefined when not reviewed",
          "callback": false
        },
        {
          "name": "flags",
          "type": "PatientFlag[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Flags such as Diabetic, Fall Risk",
          "callback": false
        },
        {
          "name": "codeStatus",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Code status (\"Full Code\", \"DNR\"); DNR, DNI and Comfort show red",
          "callback": false
        },
        {
          "name": "restricted",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Restricted (break-the-glass) chart",
          "callback": false
        },
        {
          "name": "photo",
          "type": "string",
          "required": false,
          "default": "initials",
          "allowedValues": null,
          "description": "Photo URL",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Buttons on the right",
          "callback": false
        },
        {
          "name": "variant",
          "type": "PatientBannerVariant",
          "required": false,
          "default": "'full'",
          "allowedValues": [
            "compact",
            "full",
            "mobile"
          ],
          "description": "'full' | 'compact' | 'mobile'",
          "callback": false
        },
        {
          "name": "headingLevel",
          "type": "1 | 2 | 3",
          "required": false,
          "default": "1 for full, 2 otherwise",
          "allowedValues": null,
          "description": "Heading level of the name",
          "callback": false
        }
      ],
      "whenToUse": [
        "Top of every screen about one patient."
      ],
      "whenNotToUse": [
        "Lists of patients: table rows."
      ],
      "accessibility": [
        "Region named \"Patient <name>\"; the name is the page h1 on chart screens.",
        "Allergy and code status carry icons and words, not only red and green.",
        "Two identifiers (name plus DOB or MRN) are always visible, for patient safety."
      ],
      "example": "<PatientBanner name=\"Henna West\" sex=\"F\" age={38} dob=\"03/14/1988\" mrn=\"MRN-100231\" allergies={[\"Penicillin\"]}\n  flags={[\"Diabetic\"]} codeStatus=\"Full Code\" actions={<Button variant=\"primary\">Start Visit Note</Button>} />",
      "readme": "src/components/PatientBanner/README.md",
      "storybook": "complex-clinical-patientbanner--docs"
    },
    {
      "name": "PatientTabs",
      "layer": "complex",
      "group": "Navigation",
      "summary": "PatientTabs keep several open patients as closable tabs across the top, like a browser, in the Focus Rail style.",
      "import": "import { PatientTabs } from 'health-components';",
      "element": {
        "tag": "co-patient-tabs",
        "events": [
          "co-change",
          "co-close",
          "co-add"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "tabs",
          "type": "PatientTab[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Open tabs. Required.",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Active tab id (controlled)",
          "callback": false
        },
        {
          "name": "defaultActive",
          "type": "string",
          "required": false,
          "default": "the first tab",
          "allowedValues": null,
          "description": "Initially active tab id when uncontrolled",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(id: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the newly active tab id",
          "callback": true
        },
        {
          "name": "onClose",
          "type": "(tab: PatientTab) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a tab is closed (x button or Delete key). The tab is also hidden internally",
          "callback": true
        },
        {
          "name": "onAdd",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Add (+) button handler",
          "callback": true
        },
        {
          "name": "addLabel",
          "type": "string",
          "required": false,
          "default": "\"Open another patient\"",
          "allowedValues": null,
          "description": "Accessible name of the add button",
          "callback": false
        }
      ],
      "whenToUse": [
        "Providers switching between charts during a session."
      ],
      "whenNotToUse": [
        "Phones.",
        "More than about 8 open charts: suggest closing some."
      ],
      "accessibility": [
        "tablist; each close button names the patient (\"Close Henna West\").",
        "Arrow keys, Home and End move between tabs; Delete closes the focused tab. The close buttons are pointer shortcuts outside the tab order, so the tablist holds only tabs; the add button sits after the tablist."
      ],
      "example": "<PatientTabs tabs={openCharts} active={currentId} onChange={setCurrentId} onClose={closeChart} onAdd={openSearch} />",
      "readme": "src/components/PatientTabs/README.md",
      "storybook": "complex-navigation-patienttabs--docs"
    },
    {
      "name": "PediatricDosingCalculator",
      "layer": "complex",
      "group": "Specialty",
      "summary": "PediatricDosingCalculator works out a weight-based dose in mg/kg, caps it at the maximum single and daily dose, converts it to mL, and shows the working so a second person can check it.",
      "import": "import { PediatricDosingCalculator } from 'health-components';",
      "element": {
        "tag": "co-pediatric-dosing-calculator",
        "events": [
          "co-weight-change",
          "co-drug-change",
          "co-use-in-order",
          "co-request-double-check"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "drugs",
          "type": "ReadonlyArray<PediatricDrug>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Medications to choose from; required",
          "callback": false
        },
        {
          "name": "weight",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Weight in kg typed in the field (controlled, text)",
          "callback": false
        },
        {
          "name": "defaultWeight",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "First weight in kg (uncontrolled)",
          "callback": false
        },
        {
          "name": "onWeightChange",
          "type": "(weight: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the weight text as typed",
          "callback": true
        },
        {
          "name": "drug",
          "type": "number",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected medication index (controlled)",
          "callback": false
        },
        {
          "name": "defaultDrug",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "First medication index (uncontrolled)",
          "callback": false
        },
        {
          "name": "onDrugChange",
          "type": "(index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the medication index",
          "callback": true
        },
        {
          "name": "weightDate",
          "type": "string",
          "required": false,
          "default": "none (helper asks for today's weight)",
          "allowedValues": null,
          "description": "When the weight was taken",
          "callback": false
        },
        {
          "name": "weightStale",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "How old the weight is (\"45 days\"): shows a warning",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Pediatric dose calculator'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Use in Order and Request Double Check",
          "callback": false
        },
        {
          "name": "onUseInOrder",
          "type": "(result: Exclude<PedsDoseResult, { error: string }>, drug: PediatricDrug) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Use in Order action, with the result and the medication",
          "callback": true
        },
        {
          "name": "onRequestDoubleCheck",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Request Double Check action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Pediatric prescribing, ED and urgent care, inpatient pediatric orders."
      ],
      "whenNotToUse": [
        "Infusions in mcg/kg/min: a drip calculator.",
        "Chemotherapy by body surface area: OncologyRegimen."
      ],
      "accessibility": [
        "The result is a live region so changes to weight are announced.",
        "Caps are explained in words, not just a colour.",
        "Weight has a unit suffix and an error message tied to the field."
      ],
      "example": "<PediatricDosingCalculator defaultWeight={18.4} drugs={[{ name: \"Ibuprofen\", form: \"100 mg/5 mL suspension\", mgkg: 10, perDay: 4, freq: \"every 6 hours as needed\", maxDose: 400, maxDaily: 1600, conc: 20 }]} />",
      "readme": "src/components/PediatricDosingCalculator/README.md",
      "storybook": "complex-specialty-pediatricdosingcalculator--docs"
    },
    {
      "name": "PermissionMatrix",
      "layer": "complex",
      "group": "Access",
      "summary": "PermissionMatrix is the role-by-action grid from Compare roles and Roles and Permissions, showing None, View, Edit or Approve for each role.",
      "import": "import { PermissionMatrix } from 'health-components';",
      "element": {
        "tag": "co-permission-matrix",
        "events": [
          "co-rows-change",
          "co-only-differences-change",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "roles",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Role names, one column each (1 to 3 recommended); required",
          "callback": false
        },
        {
          "name": "rows",
          "type": "PermissionRow[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Rows (controlled): Array<{module, action, levels: Record<role, none|view|edit|approve>}>",
          "callback": false
        },
        {
          "name": "defaultRows",
          "type": "PermissionRow[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial rows (uncontrolled)",
          "callback": false
        },
        {
          "name": "onRowsChange",
          "type": "(rows: PermissionRow[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with all rows after a level is edited",
          "callback": true
        },
        {
          "name": "editable",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "A select per cell instead of level tags",
          "callback": false
        },
        {
          "name": "onlyDifferences",
          "type": "boolean",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Hides rows where every role has the same level (controlled)",
          "callback": false
        },
        {
          "name": "defaultOnlyDifferences",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial \"Only show differences\" state (uncontrolled)",
          "callback": false
        },
        {
          "name": "onOnlyDifferencesChange",
          "type": "(on: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when \"Only show differences\" is switched",
          "callback": true
        },
        {
          "name": "onChange",
          "type": "(row: PermissionRow, role: string, level: PermissionLevel) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the edited row (as it was before the edit), the role and the new level",
          "callback": true
        },
        {
          "name": "caption",
          "type": "string",
          "required": false,
          "default": "\"Permissions by role\"",
          "allowedValues": null,
          "description": "Table caption for screen readers",
          "callback": false
        }
      ],
      "whenToUse": [
        "Comparing 1 to 3 roles side by side; editing a role's permissions."
      ],
      "whenNotToUse": [
        "Showing one user what they can do: PermissionState."
      ],
      "accessibility": [
        "Real table with caption, column headers per role and a row header per action.",
        "Each level has its own icon and word, so the grid reads without colour."
      ],
      "example": "<PermissionMatrix\n  roles={[\"Provider\", \"Nurse / MA\", \"Biller\"]}\n  rows={rows} onRowsChange={setRows}\n  editable onChange={(row, role, level) => savePermission(row, role, level)} />\n\n<PermissionMatrix roles={[\"Provider\", \"Biller\"]} defaultRows={rows} defaultOnlyDifferences />",
      "readme": "src/components/PermissionMatrix/README.md",
      "storybook": "complex-access-permissionmatrix--docs"
    },
    {
      "name": "PermissionState",
      "layer": "complex",
      "group": "Access",
      "summary": "PermissionState renders the four role-based states with the screens' exact wording: lock (view only), denied (no access), patient preview, and hidden.",
      "import": "import { PermissionState } from 'health-components';",
      "element": {
        "tag": "co-permission-state",
        "events": [
          "co-home",
          "co-compare-roles"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "kind",
          "type": "PermissionStateKind",
          "required": false,
          "default": "'lock'",
          "allowedValues": [
            "hidden",
            "lock",
            "denied",
            "preview"
          ],
          "description": "'lock' | 'denied' | 'preview' | 'hidden'",
          "callback": false
        },
        {
          "name": "role",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The viewer's role (\"Biller\", \"Front Desk\"). Required",
          "callback": false
        },
        {
          "name": "permission",
          "type": "string",
          "required": false,
          "default": "\"Manage claims\"",
          "allowedValues": null,
          "description": "Permission the role lacks; required for lock and denied",
          "callback": false
        },
        {
          "name": "home",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Href of the staff home: \"Back to staff app\" (preview) and \"Go to my home screen\" (denied)",
          "callback": false
        },
        {
          "name": "onHome",
          "type": "(event: MouseEvent<HTMLElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Go to my home screen\" (denied) or \"Back to staff app\" (preview) clicked",
          "callback": true
        },
        {
          "name": "onCompareRoles",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "\"Compare roles\" clicked (denied)",
          "callback": true
        }
      ],
      "whenToUse": [
        "Top of any screen the role can only view (lock), in place of a screen the role cannot open (denied), staff looking at portal screens (preview)."
      ],
      "whenNotToUse": [
        "Errors from the server: Alert error."
      ],
      "accessibility": [
        "denied is role alert; lock is role status."
      ],
      "example": "{access === \"view\" && <PermissionState kind=\"lock\" role=\"Biller\" permission=\"Edit clinical chart\" />}\n{access === \"none\" && <PermissionState kind=\"denied\" role=\"Front Desk\" permission=\"Manage claims\" />}",
      "readme": "src/components/PermissionState/README.md",
      "storybook": "complex-access-permissionstate--docs"
    },
    {
      "name": "PharmacyVerificationQueue",
      "layer": "renal function",
      "group": null,
      "summary": "PharmacyVerificationQueue is the pharmacist queue: orders on the left, the selected order on the right with weight, renal function, potassium, a weight-based dose check and interaction alerts, then Verify, Clarify or Reject.",
      "import": "import { PharmacyVerificationQueue } from 'health-components';",
      "element": {
        "tag": "co-pharmacy-verification-queue",
        "events": [
          "co-selected-change",
          "co-filter-change",
          "co-status-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "orders",
          "type": "PharmacyOrder[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial orders; the queue keeps its own copy as statuses change",
          "callback": false
        },
        {
          "name": "selected",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected order id (controlled)",
          "callback": false
        },
        {
          "name": "defaultSelected",
          "type": "string",
          "required": false,
          "default": "the first order",
          "allowedValues": null,
          "description": "Initially selected order id",
          "callback": false
        },
        {
          "name": "onSelectedChange",
          "type": "(id: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the selected order id",
          "callback": true
        },
        {
          "name": "filter",
          "type": "PharmacyQueueFilter",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "all",
            "pending",
            "clarify"
          ],
          "description": "Status filter (controlled): 'pending' | 'clarify' | 'all'",
          "callback": false
        },
        {
          "name": "defaultFilter",
          "type": "PharmacyQueueFilter",
          "required": false,
          "default": "'pending'",
          "allowedValues": [
            "all",
            "pending",
            "clarify"
          ],
          "description": "Initial status filter",
          "callback": false
        },
        {
          "name": "onFilterChange",
          "type": "(filter: PharmacyQueueFilter) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the filter changes",
          "callback": true
        },
        {
          "name": "onStatusChange",
          "type": "(id: string, status: PharmacyOrderStatus, order: PharmacyOrder) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the pharmacist verifies, asks to clarify or rejects an order",
          "callback": true
        },
        {
          "name": "user",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Pharmacist name, recorded as `by` on orders they act on",
          "callback": false
        },
        {
          "name": "oldest",
          "type": "string",
          "required": false,
          "default": "'now'",
          "allowedValues": null,
          "description": "Age of the oldest pending order ('42 min')",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Inpatient and infusion pharmacist verification; specialty pharmacy review."
      ],
      "whenNotToUse": [
        "Outpatient refill requests: InboxItem. Prescribing: SigBuilder."
      ],
      "accessibility": [
        "The list is a listbox with selected state.",
        "Dose check values read as words with their flag."
      ],
      "example": "<PharmacyVerificationQueue orders={orders} oldest=\"42 min\" />",
      "readme": "src/components/PharmacyVerificationQueue/README.md",
      "storybook": "renal-function--docs"
    },
    {
      "name": "PhoneScaffold",
      "layer": "complex",
      "group": "Mobile and kiosk",
      "summary": "PhoneScaffold is the frame for every phone and portal screen: header, scrolling body with 44px targets, optional lock banner and bottom tabs.",
      "import": "import { PhoneScaffold } from 'health-components';",
      "element": {
        "tag": "co-phone-scaffold",
        "events": [
          "co-back",
          "co-navigate"
        ],
        "slots": [
          "title",
          "subtitle",
          "action",
          "lock-text",
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Screen title. Required",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient or date line",
          "callback": false
        },
        {
          "name": "back",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Back link href",
          "callback": false
        },
        {
          "name": "onBack",
          "type": "(event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the back link is clicked (client-side routing)",
          "callback": true
        },
        {
          "name": "action",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "One small header action on the right",
          "callback": false
        },
        {
          "name": "tabs",
          "type": "BottomTabBarItem[]",
          "required": false,
          "default": "none (no tab bar)",
          "allowedValues": null,
          "description": "BottomTabBar items",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Label of the current tab",
          "callback": false
        },
        {
          "name": "onNavigate",
          "type": "(item: BottomTabBarItem, event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a tab is clicked",
          "callback": true
        },
        {
          "name": "lockText",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Read-only lock banner at the top of the body",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Body.",
          "callback": false
        }
      ],
      "whenToUse": [
        "mob-* and portal-* screens."
      ],
      "whenNotToUse": [
        "Kiosk: KioskStep."
      ],
      "accessibility": [
        "Controls inside get 44px min height."
      ],
      "example": "<PhoneScaffold title=\"Today\" subtitle=\"Thu, Oct 9\" tabs={STAFF_TABS} active=\"Home\">\n  {appointments.map(a => <AppointmentChip key={a.id} {...a} />)}\n</PhoneScaffold>",
      "readme": "src/components/PhoneScaffold/README.md",
      "storybook": "complex-mobile-and-kiosk-phonescaffold--docs"
    },
    {
      "name": "PickCard",
      "layer": "basic",
      "group": "Layout",
      "summary": "PickCard is a large selectable card for choosing one option on phones, portal and kiosk (appointment, provider, reason).",
      "import": "import { PickCard } from 'health-components';",
      "element": {
        "tag": "co-pick-card",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Main line, e.g. \"Thu 10/09 9:20 AM\"",
          "callback": false
        },
        {
          "name": "meta",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Second line (visit type, provider, place)",
          "callback": false
        },
        {
          "name": "selected",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Chosen; sets aria-pressed",
          "callback": false
        },
        {
          "name": "disabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Not available (\"Fully booked\")",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Extra content under the meta line",
          "callback": false
        }
      ],
      "whenToUse": [
        "Touch choices with two lines of detail."
      ],
      "whenNotToUse": [
        "Dense lists: RadioGroup."
      ],
      "accessibility": [
        "aria-pressed."
      ],
      "example": "<PickCard title=\"Thu 10/09 9:20 AM\" meta=\"Follow-Up with Dr. Bell\" selected onClick={pick} />",
      "readme": "src/components/PickCard/README.md",
      "storybook": "basic-layout-pickcard--docs"
    },
    {
      "name": "PinEntry",
      "layer": "basic",
      "group": "Inputs",
      "summary": "PinEntry is a 4 to 6 digit keypad with dots, for mobile sign-in and quick re-authentication.",
      "import": "import { PinEntry } from 'health-components';",
      "element": {
        "tag": "co-pin-entry",
        "events": [
          "co-change",
          "co-complete",
          "co-biometric"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "length",
          "type": "number",
          "required": false,
          "default": "4",
          "allowedValues": null,
          "description": "Number of digits, 4 to 6",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled digits entered",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial digits (uncontrolled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(pin: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the digits after every key",
          "callback": true
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Label above the dots (\"Enter your PIN\")",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message, role alert; the dots turn red",
          "callback": false
        },
        {
          "name": "biometric",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the Face ID key",
          "callback": false
        },
        {
          "name": "biometricLabel",
          "type": "string",
          "required": false,
          "default": "'Face ID'",
          "allowedValues": null,
          "description": "Text of the biometric key",
          "callback": false
        },
        {
          "name": "locked",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Locks the keypad after too many tries",
          "callback": false
        },
        {
          "name": "lockedText",
          "type": "string",
          "required": false,
          "default": "'Too many tries. Sign in with your password.'",
          "allowedValues": null,
          "description": "Text under a locked keypad",
          "callback": false
        },
        {
          "name": "onComplete",
          "type": "(pin: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the PIN when the last digit is entered",
          "callback": true
        },
        {
          "name": "onBiometric",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the biometric key is pressed",
          "callback": true
        }
      ],
      "whenToUse": [
        "Unlocking the mobile EHR, confirming an e-prescription for controlled substances (with the second factor)."
      ],
      "whenNotToUse": [
        "First sign-in: use username and password with 2FA."
      ],
      "accessibility": [
        "Dots have role status with \"N of 4 digits entered\".",
        "The delete key is named \"Delete last digit\".",
        "Keys are 56px tall, above the 44px touch minimum."
      ],
      "example": "<PinEntry length={4} label=\"Enter your PIN\" biometric onComplete={unlock} error={pinError} />",
      "readme": "src/components/PinEntry/README.md",
      "storybook": "basic-inputs-pinentry--docs"
    },
    {
      "name": "PrenatalFlowsheet",
      "layer": "complex",
      "group": "Specialty",
      "summary": "PrenatalFlowsheet tracks every prenatal visit in one table, gestational age, weight, blood pressure, urine, fundal height and fetal heart rate, with flags for hypertension, size and dates mismatch and abnormal heart rate.",
      "import": "import { PrenatalFlowsheet } from 'health-components';",
      "element": {
        "tag": "co-prenatal-flowsheet",
        "events": [
          "co-add-visit"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "header",
          "type": "PrenatalHeader",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "{edd, eddBy, gp, blood, rubella, gbs, bmi, risks}",
          "callback": false
        },
        {
          "name": "visits",
          "type": "ReadonlyArray<PrenatalVisit>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Visits, oldest first",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Prenatal flowsheet'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Add Visit",
          "callback": false
        },
        {
          "name": "onAddVisit",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Add Visit action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'pregnancy' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Obstetric and midwifery prenatal visits from the first visit to delivery."
      ],
      "whenNotToUse": [
        "Labor: a labor flowsheet and fetal monitoring strip.",
        "Postpartum visits."
      ],
      "accessibility": [
        "Gestational age has a spoken label in weeks and days.",
        "Critical rows have a red background and flags in words, never colour alone.",
        "The table scrolls sideways on small screens instead of squashing."
      ],
      "example": "<PrenatalFlowsheet header={{ edd: \"01/14/2027\", eddBy: \"8w US\", gp: \"G2 P1001\" }} visits={[{ date: \"10/09/2026\", ga: [26, 3], wt: 71.4, sbp: 118, dbp: 74, protein: \"neg\", glucose: \"neg\", fh: 26, fhr: 148 }]} />",
      "readme": "src/components/PrenatalFlowsheet/README.md",
      "storybook": "complex-specialty-prenatalflowsheet--docs"
    },
    {
      "name": "PriorAuthTimeline",
      "layer": "complex",
      "group": "Revenue",
      "summary": "PriorAuthTimeline shows a prior authorization: status, units used against approved (UnitsMeter), any alert and the status history.",
      "import": "import { PriorAuthTimeline } from 'health-components';",
      "element": {
        "tag": "co-prior-auth-timeline",
        "events": [],
        "slots": []
      },
      "aliases": [
        "PriorAuthCard"
      ],
      "props": [
        {
          "name": "authId",
          "type": "string",
          "required": false,
          "default": "\"Prior authorization\"",
          "allowedValues": null,
          "description": "Authorization number (\"PA-2026-11873\")",
          "callback": false
        },
        {
          "name": "service",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Service and code (\"Physical therapy 97110\")",
          "callback": false
        },
        {
          "name": "payer",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Payer name",
          "callback": false
        },
        {
          "name": "patient",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient name",
          "callback": false
        },
        {
          "name": "status",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "PA status word (see StatusTag kind 'pa'): 'Approved', 'Pended', 'Denied'...; required",
          "callback": false
        },
        {
          "name": "used",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Units used",
          "callback": false
        },
        {
          "name": "approved",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Units approved; shows the UnitsMeter when set",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": "\"units\"",
          "allowedValues": null,
          "description": "Unit word",
          "callback": false
        },
        {
          "name": "expires",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Validity dates (\"10/01/2026 to 12/31/2026\")",
          "callback": false
        },
        {
          "name": "events",
          "type": "TimelineItem[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Status history as Timeline items",
          "callback": false
        },
        {
          "name": "alert",
          "type": "PriorAuthAlert",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "{title, body, action?, onAction?}",
          "callback": false
        },
        {
          "name": "alertTone",
          "type": "\"warning\" | \"error\" | \"info\"",
          "required": false,
          "default": "'warning'",
          "allowedValues": [
            "info",
            "warning",
            "error"
          ],
          "description": "'warning' | 'error' | 'info'",
          "callback": false
        }
      ],
      "whenToUse": [
        "PA detail drawer or page; referral status uses the same parts."
      ],
      "whenNotToUse": [
        "The queue list: DataTable with StatusTag."
      ],
      "accessibility": [
        "Meter role with \"12 of 20 visits\" text."
      ],
      "example": "<PriorAuthTimeline authId=\"PA-2026-11873\" service=\"Physical therapy 97110\" payer=\"Aetna\" status=\"Approved\"\n  used={12} approved={20} unit=\"visits\" expires=\"10/01/2026 to 12/31/2026\" events={history} />\n<UnitsMeter used={12} approved={20} unit=\"visits\" />",
      "readme": "src/components/PriorAuthTimeline/README.md",
      "storybook": "complex-revenue-priorauthtimeline--docs"
    },
    {
      "name": "ProblemList",
      "layer": "complex",
      "group": "Clinical",
      "summary": "ProblemList is the coded problem list with ICD-10 codes, onset, chronic and HCC tags, filtered by Active, Resolved or All.",
      "import": "import { ProblemList } from 'health-components';",
      "element": {
        "tag": "co-problem-list",
        "events": [
          "co-filter-change",
          "co-add"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "ProblemItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{code, label, onset?, by?, chronic?, hcc?, status?}>; required",
          "callback": false
        },
        {
          "name": "icdOptions",
          "type": "ProblemCodeOption[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array<{code,label}> for the Add problem picker",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides the Add problem picker",
          "callback": false
        },
        {
          "name": "filter",
          "type": "ProblemFilter",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": [
            "active",
            "all",
            "resolved"
          ],
          "description": "Status filter (controlled): 'active' | 'resolved' | 'all'",
          "callback": false
        },
        {
          "name": "defaultFilter",
          "type": "ProblemFilter",
          "required": false,
          "default": "'active'",
          "allowedValues": [
            "active",
            "all",
            "resolved"
          ],
          "description": "Initial status filter (uncontrolled)",
          "callback": false
        },
        {
          "name": "onFilterChange",
          "type": "(filter: ProblemFilter) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the filter changes",
          "callback": true
        },
        {
          "name": "onAdd",
          "type": "ICD10Select",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the code picked in Add problem",
          "callback": true
        }
      ],
      "whenToUse": [
        "Chart Problems section; assessment review."
      ],
      "whenNotToUse": [
        "Encounter diagnoses on a claim: ClaimForm."
      ],
      "accessibility": [
        "Code and words both shown."
      ],
      "example": "<ProblemList items={problems} icdOptions={icd10} />",
      "readme": "src/components/ProblemList/README.md",
      "storybook": "complex-clinical-problemlist--docs"
    },
    {
      "name": "ProblemListEditor",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "ProblemListEditor records problems as SNOMED CT concepts and shows the ICD-10-CM codes the map table offers, so a person picks the billable code the note supports.",
      "import": "import { ProblemListEditor } from 'health-components';",
      "element": {
        "tag": "co-problem-list-editor",
        "events": [
          "co-items-change",
          "co-editing-change",
          "co-add"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "ProblemListEditorItem[]",
          "required": false,
          "default": "none (empty state)",
          "allowedValues": null,
          "description": "Initial problems; the editor keeps its own copy",
          "callback": false
        },
        {
          "name": "onItemsChange",
          "type": "(items: ProblemListEditorItem[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the problems after every change (code picked, status changed)",
          "callback": true
        },
        {
          "name": "editing",
          "type": "number",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Index of the problem being edited (controlled), -1 for none",
          "callback": false
        },
        {
          "name": "defaultEditing",
          "type": "number",
          "required": false,
          "default": "-1 (none)",
          "allowedValues": null,
          "description": "Index of the problem open for editing at first",
          "callback": false
        },
        {
          "name": "onEditingChange",
          "type": "(index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a problem opens or closes for editing",
          "callback": true
        },
        {
          "name": "onAdd",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Add Problem (open your SNOMED CT search)",
          "callback": true
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "No edit buttons",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Problem list upkeep, assessment and plan, risk adjustment review."
      ],
      "whenNotToUse": [
        "Read-only display: ProblemList. Claim diagnosis entry: ICD10Picker."
      ],
      "accessibility": [
        "Candidates are a fieldset of radios with a legend.",
        "Map state is in words, not only colour."
      ],
      "example": "<ProblemListEditor items={problems} />",
      "readme": "src/components/ProblemListEditor/README.md",
      "storybook": "complex-chart-panels-problemlisteditor--docs"
    },
    {
      "name": "ProcedureNote",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "ProcedureNote is a structured procedure note from a template (laceration repair, central line, lumbar puncture, cesarean delivery): procedure, indication, consent, time out, EBL, complications, specimens and the template's own fields.",
      "import": "import { ProcedureNote } from 'health-components';",
      "element": {
        "tag": "co-procedure-note",
        "events": [
          "co-sign",
          "co-save-draft",
          "co-details-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "template",
          "type": "ProcedureTemplateKey",
          "required": false,
          "default": "'laceration repair'",
          "allowedValues": [
            "laceration repair",
            "central line",
            "lumbar puncture",
            "cesarean delivery"
          ],
          "description": "'laceration repair' | 'central line' | 'lumbar puncture' | 'cesarean delivery'",
          "callback": false
        },
        {
          "name": "values",
          "type": "ProcedureNoteValues",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Note values",
          "callback": false
        },
        {
          "name": "status",
          "type": "ProcedureNoteStatus",
          "required": false,
          "default": "'draft'",
          "allowedValues": [
            "signed",
            "draft"
          ],
          "description": "'draft' (template fields editable) | 'signed' (read-only)",
          "callback": false
        },
        {
          "name": "addendum",
          "type": "{ at: string; text: string }",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Addendum under a signed note {at, text}",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "(details: Record<string, string>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Sign Note with the template field text",
          "callback": true
        },
        {
          "name": "onSaveDraft",
          "type": "(details: Record<string, string>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Save Draft with the template field text",
          "callback": true
        },
        {
          "name": "onDetailsChange",
          "type": "(details: Record<string, string>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a template field changes",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Bedside procedures in the ED, ICU and L&D; brief OR notes."
      ],
      "whenNotToUse": [
        "Full operative reports dictated by the surgeon: VisitNoteEditor."
      ],
      "accessibility": [
        "Fields are labelled text areas; signed fields are plain text with headings.",
        "Why Sign is disabled is written next to it."
      ],
      "example": "<ProcedureNote template=\"lumbar puncture\" values={lpValues} status=\"draft\" />",
      "readme": "src/components/ProcedureNote/README.md",
      "storybook": "complex-ed-periop-procedurenote--docs"
    },
    {
      "name": "ProgressBar",
      "layer": "basic",
      "group": "Data display",
      "summary": "ProgressBar shows progress of a task or how much of an allowance is used, such as PA units used 12 of 20.",
      "import": "import { ProgressBar } from 'health-components';",
      "element": {
        "tag": "co-progress-bar",
        "events": [],
        "slots": [
          "helper"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "value",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Current value. Required",
          "callback": false
        },
        {
          "name": "max",
          "type": "number",
          "required": false,
          "default": "100",
          "allowedValues": null,
          "description": "Maximum value",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label and accessible name. Required",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": "none (percent)",
          "allowedValues": null,
          "description": "Unit word: \"visits\" gives \"12 of 20 visits used\"",
          "callback": false
        },
        {
          "name": "valueText",
          "type": "string",
          "required": false,
          "default": "auto (percent, or \"12 of 20 visits used\")",
          "allowedValues": null,
          "description": "Value text shown and announced",
          "callback": false
        },
        {
          "name": "meter",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Uses role meter (an amount used of an allowance) instead of progressbar",
          "callback": false
        },
        {
          "name": "thresholds",
          "type": "readonly [warn: number, danger: number]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "[warnPct, dangerPct]: the bar turns warning and danger at these percentages",
          "callback": false
        },
        {
          "name": "tone",
          "type": "ProgressTone",
          "required": false,
          "default": "auto (from thresholds, else primary)",
          "allowedValues": [
            "success",
            "warning",
            "ai",
            "primary",
            "danger"
          ],
          "description": "'primary' | 'success' | 'warning' | 'danger' | 'ai'",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Bar only, without the header and helper",
          "callback": false
        },
        {
          "name": "size",
          "type": "'md' | 'lg'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "md",
            "lg"
          ],
          "description": "'md' 8px | 'lg' 12px bar",
          "callback": false
        },
        {
          "name": "helper",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Helper text under the bar",
          "callback": false
        }
      ],
      "whenToUse": [
        "Authorized units or visits used, upload progress, onboarding completeness."
      ],
      "whenNotToUse": [
        "Unknown duration: Spinner."
      ],
      "accessibility": [
        "aria-valuenow, valuemax and a valuetext in words.",
        "The number is always shown as text too."
      ],
      "example": "<ProgressBar label=\"PA units used\" value={12} max={20} unit=\"visits\" meter thresholds={[75, 90]} />",
      "readme": "src/components/ProgressBar/README.md",
      "storybook": "basic-data-display-progressbar--docs"
    },
    {
      "name": "ProviderDayColumns",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "ProviderDayColumns is the multi-provider day view: one column per provider, time rows, chips, blocks and free slots.",
      "import": "import { ProviderDayColumns } from 'health-components';",
      "element": {
        "tag": "co-provider-day-columns",
        "events": [
          "co-book"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "times",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Row times, e.g. ['8:00 AM', '8:20 AM']. Required",
          "callback": false
        },
        {
          "name": "providers",
          "type": "ProviderColumn[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "One column per provider. Required",
          "callback": false
        },
        {
          "name": "onBook",
          "type": "(provider: string, time: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a free slot is chosen",
          "callback": true
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "'Schedule by provider'",
          "allowedValues": null,
          "description": "Accessible name of the view",
          "callback": false
        }
      ],
      "whenToUse": [
        "Front desk view of everyone's day."
      ],
      "whenNotToUse": [
        "One provider's week: Calendar."
      ],
      "accessibility": [
        "Grid; free cells are links \"+ Book 9:40 AM\"."
      ],
      "example": "<ProviderDayColumns times={TIMES} providers={providersWithAppts} />",
      "readme": "src/components/ProviderDayColumns/README.md",
      "storybook": "complex-scheduling-providerdaycolumns--docs"
    },
    {
      "name": "PsychRatingScales",
      "layer": "complex",
      "group": "Specialty",
      "summary": "PsychRatingScales gives PHQ-9, GAD-7 and the C-SSRS screen in tabs, scores them live with the published bands, and escalates suicide risk with the actions to take.",
      "import": "import { PsychRatingScales } from 'health-components';",
      "element": {
        "tag": "co-psych-rating-scales",
        "events": [
          "co-answers-change",
          "co-tab-change",
          "co-call-crisis-team",
          "co-start-safety-plan"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "answers",
          "type": "PsychAnswers",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Answers (controlled)",
          "callback": false
        },
        {
          "name": "defaultAnswers",
          "type": "PsychAnswers",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "First answers (uncontrolled) {phq9?, gad7?, cssrs?}",
          "callback": false
        },
        {
          "name": "onAnswersChange",
          "type": "(answers: PsychAnswers) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with every answer change",
          "callback": true
        },
        {
          "name": "tab",
          "type": "PsychScaleTab",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "phq9",
            "gad7",
            "cssrs"
          ],
          "description": "Tab shown (controlled)",
          "callback": false
        },
        {
          "name": "defaultTab",
          "type": "PsychScaleTab",
          "required": false,
          "default": "'phq9'",
          "allowedValues": [
            "phq9",
            "gad7",
            "cssrs"
          ],
          "description": "First tab (uncontrolled): 'phq9' | 'gad7' | 'cssrs'",
          "callback": false
        },
        {
          "name": "onTabChange",
          "type": "(tab: PsychScaleTab) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new tab",
          "callback": true
        },
        {
          "name": "history",
          "type": "ReadonlyArray<PsychHistoryEntry>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Earlier scores, oldest first",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Rating scales'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Locks the answers",
          "callback": false
        },
        {
          "name": "onCallCrisisTeam",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Call Crisis Team action (high risk)",
          "callback": true
        },
        {
          "name": "onStartSafetyPlan",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Start Safety Plan action (moderate or high risk)",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Primary care and behavioral health screening, measurement-based care at each visit."
      ],
      "whenNotToUse": [
        "Diagnosis: a score is a screen.",
        "A full C-SSRS lifetime and since-last-visit interview."
      ],
      "accessibility": [
        "Answers are radio groups named by the question.",
        "The score and the risk level update in a live region.",
        "Risk is a word badge and an Alert with role alert at high risk."
      ],
      "example": "<PsychRatingScales defaultAnswers={{ phq9: [2, 2, 1, 2, 1, 1, 1, 0, 1] }} history={[{ date: \"08/01/2026\", phq9: 17, gad7: 13 }]} />",
      "readme": "src/components/PsychRatingScales/README.md",
      "storybook": "complex-specialty-psychratingscales--docs"
    },
    {
      "name": "PTPlanOfCare",
      "layer": "complex",
      "group": "Specialty",
      "summary": "PTPlanOfCare shows a therapy plan of care: diagnosis and certification, visits used against the authorization, functional outcome scores against their minimal important change, and short and long term goals.",
      "import": "import { PTPlanOfCare } from 'health-components';",
      "element": {
        "tag": "co-pt-plan-of-care",
        "events": [
          "co-progress-note",
          "co-send-for-certification"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "diagnosis",
          "type": "string",
          "required": false,
          "default": "'Not recorded'",
          "allowedValues": null,
          "description": "Diagnosis with code",
          "callback": false
        },
        {
          "name": "cert",
          "type": "string",
          "required": false,
          "default": "'Not recorded'",
          "allowedValues": null,
          "description": "Certification period",
          "callback": false
        },
        {
          "name": "frequency",
          "type": "string",
          "required": false,
          "default": "'Not recorded'",
          "allowedValues": null,
          "description": "Visit frequency",
          "callback": false
        },
        {
          "name": "referring",
          "type": "string",
          "required": false,
          "default": "'Not recorded'",
          "allowedValues": null,
          "description": "Referring provider",
          "callback": false
        },
        {
          "name": "auth",
          "type": "PTAuthorization",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{used, authorized, payer, expires}; required",
          "callback": false
        },
        {
          "name": "visitsSinceProgressNote",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Visits since the last progress note",
          "callback": false
        },
        {
          "name": "progressNoteDue",
          "type": "boolean",
          "required": false,
          "default": "false (due at 10 visits)",
          "allowedValues": null,
          "description": "Forces the Progress note due badge",
          "callback": false
        },
        {
          "name": "scores",
          "type": "ReadonlyArray<PTScore>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Functional outcome scores",
          "callback": false
        },
        {
          "name": "goals",
          "type": "ReadonlyArray<PTGoal>",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Goals",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Physical therapy plan of care'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Progress Note and Send for Certification",
          "callback": false
        },
        {
          "name": "onProgressNote",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Progress Note action",
          "callback": true
        },
        {
          "name": "onSendForCertification",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Send for Certification action",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Physical, occupational and speech therapy evaluations, progress notes and recertifications."
      ],
      "whenNotToUse": [
        "A single visit note: the daily note template.",
        "Authorization requests: PriorAuthCard."
      ],
      "accessibility": [
        "The authorization meter has a value text in words.",
        "Change is signed and the meaning is a word badge.",
        "Goals and scores are tables with captions."
      ],
      "example": "<PTPlanOfCare auth={{ used: 9, authorized: 12, payer: \"Aetna\" }} scores={[{ name: \"LEFS\", k: \"pts\", baseline: 32, current: 51, mcid: 9, higherBetter: true }]} goals={[]} />",
      "readme": "src/components/PTPlanOfCare/README.md",
      "storybook": "complex-specialty-ptplanofcare--docs"
    },
    {
      "name": "QualityMeasureCard",
      "layer": "complex",
      "group": "Quality and care programs",
      "summary": "QualityMeasureCard shows one quality measure: rate, target (including inverse measures), numerator and denominator, and the gap list link.",
      "import": "import { QualityMeasureCard } from 'health-components';",
      "element": {
        "tag": "co-quality-measure-card",
        "events": [
          "co-view-gaps"
        ],
        "slots": [
          "actions",
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "measure",
          "type": "QualityMeasureData",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{name, id, period, numerator, denominator, exclusions?, target, inverse?, source?}; required",
          "callback": false
        },
        {
          "name": "onViewGaps",
          "type": "(measure: QualityMeasureData) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by the \"View N patients with gaps\" link",
          "callback": true
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Header actions (one primary at most)",
          "callback": false
        },
        {
          "name": "flat",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Border instead of shadow",
          "callback": false
        },
        {
          "name": "padding",
          "type": "CardPadding",
          "required": false,
          "default": "'default'",
          "allowedValues": [
            "compact",
            "default",
            "none"
          ],
          "description": "'default' | 'compact' (10px) | 'none' (edge-to-edge tables)",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer content",
          "callback": false
        },
        {
          "name": "as",
          "type": "ElementType",
          "required": false,
          "default": "'section'",
          "allowedValues": null,
          "description": "Root tag name",
          "callback": false
        }
      ],
      "whenToUse": [
        "MIPS and payer quality dashboards."
      ],
      "whenNotToUse": [
        "Single patient: CareGapRow."
      ],
      "accessibility": [
        "Rate and counts in text."
      ],
      "example": "<QualityMeasureCard measure={{ name: \"Controlling High Blood Pressure\", id: \"CMS165\", numerator: 412, denominator: 560, target: 70 }} />",
      "readme": "src/components/QualityMeasureCard/README.md",
      "storybook": "complex-quality-and-care-programs-qualitymeasurecard--docs"
    },
    {
      "name": "QuickActions",
      "layer": "basic",
      "group": "Layout",
      "summary": "QuickActions is the 3-column grid of big icon tiles on phone and portal home screens.",
      "import": "import { QuickActions } from 'health-components';",
      "element": {
        "tag": "co-quick-actions",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "QuickActionItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{label, icon, href?, badge?, onClick?}>",
          "callback": false
        }
      ],
      "whenToUse": [
        "Phone and portal home."
      ],
      "whenNotToUse": [
        "Desktop: buttons in the page header."
      ],
      "accessibility": [
        "Links with text labels, 44px tall."
      ],
      "example": "<QuickActions items={[{ label: \"Book Visit\", icon: \"calendar\" }, { label: \"Messages\", icon: \"message\", badge: 2 }]} />",
      "readme": "src/components/QuickActions/README.md",
      "storybook": "basic-layout-quickactions--docs"
    },
    {
      "name": "Radio",
      "layer": "basic",
      "group": "Selection",
      "summary": "Radio and RadioGroup choose exactly one option from a short visible list.",
      "import": "import { Radio } from 'health-components';",
      "element": {
        "tag": "co-radio",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": [
          "label",
          "description"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; the whole row is clickable. Required",
          "callback": false
        },
        {
          "name": "description",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Help text under the label",
          "callback": false
        },
        {
          "name": "disabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables the radio",
          "callback": false
        }
      ],
      "whenToUse": [
        "Two to six options that need explanation: \"Text message\", \"Authenticator app\"."
      ],
      "whenNotToUse": [
        "Many options: Select.",
        "A compact view switch: SegmentedControl."
      ],
      "accessibility": [
        "Fieldset with legend; arrow keys move between options natively."
      ],
      "example": "<RadioGroup label=\"Visit Mode\" inline required options={[\"In person\", \"Telehealth\"]} value={mode} onChange={setMode} />",
      "readme": "src/components/Radio/README.md",
      "storybook": "basic-selection-radio--docs"
    },
    {
      "name": "RapidResponsePanel",
      "layer": "complex",
      "group": "Inpatient flow",
      "summary": "RapidResponsePanel supports a rapid response call: who called and why, vitals against calling criteria, recent labs, what has been done, outcome, and escalation to Code Blue.",
      "import": "import { RapidResponsePanel } from 'health-components';",
      "element": {
        "tag": "co-rapid-response-panel",
        "events": [
          "co-outcome-change",
          "co-escalate",
          "co-close"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "patient",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Patient ('Kowalski, Anna, 34 F'); required",
          "callback": false
        },
        {
          "name": "location",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Location; required",
          "callback": false
        },
        {
          "name": "calledBy",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Who called ('J. Patel, RN', 'Family')",
          "callback": false
        },
        {
          "name": "reason",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Why the team was called; required",
          "callback": false
        },
        {
          "name": "calledAt",
          "type": "number",
          "required": false,
          "default": "when the component mounts",
          "allowedValues": null,
          "description": "When the call was made, epoch ms",
          "callback": false
        },
        {
          "name": "now",
          "type": "number",
          "required": false,
          "default": "live",
          "allowedValues": null,
          "description": "Freezes the clock at this epoch ms (for review and tests)",
          "callback": false
        },
        {
          "name": "vitals",
          "type": "InpatientMeasureValue[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { measure, value, range, taken }",
          "callback": false
        },
        {
          "name": "labs",
          "type": "InpatientMeasureValue[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { measure, value, range, taken }",
          "callback": false
        },
        {
          "name": "interventions",
          "type": "RapidResponseIntervention[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Array of { at, text }",
          "callback": false
        },
        {
          "name": "outcome",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Starting outcome (uncontrolled); a chosen outcome closes the call and stops the clock",
          "callback": false
        },
        {
          "name": "outcomeValue",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Outcome (controlled)",
          "callback": false
        },
        {
          "name": "onOutcomeChange",
          "type": "(outcome: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen outcome",
          "callback": true
        },
        {
          "name": "onEscalate",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Escalate to Code Blue",
          "callback": true
        },
        {
          "name": "onClose",
          "type": "(outcome: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Close Call with the outcome",
          "callback": true
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Rapid response team documentation at the bedside."
      ],
      "whenNotToUse": [
        "Pulseless patient: CodeBlueTimer."
      ],
      "accessibility": [
        "Timer has role timer.",
        "Criteria are in words, not only the red tile."
      ],
      "example": "<RapidResponsePanel patient=\"Kowalski, Anna\" location=\"4 West 403A\" reason=\"SpO2 86% on 4 L\" vitals={vitals} />",
      "readme": "src/components/RapidResponsePanel/README.md",
      "storybook": "complex-inpatient-flow-rapidresponsepanel--docs"
    },
    {
      "name": "ReferenceRangeBar",
      "layer": "complex",
      "group": "Clinical values",
      "summary": "ReferenceRangeBar places a result on a bar showing the normal band and critical zones, so distance from normal reads at a glance.",
      "import": "import { ReferenceRangeBar } from 'health-components';",
      "element": {
        "tag": "co-reference-range-bar",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "value",
          "type": "number | null",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The result; required",
          "callback": false
        },
        {
          "name": "measure",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Measure key (fmt.MEASURES or the range registry)",
          "callback": false
        },
        {
          "name": "loinc",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "LOINC code; finds the measure when `measure` is absent",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": "the measure's unit",
          "allowedValues": null,
          "description": "UCUM unit code",
          "callback": false
        },
        {
          "name": "precision",
          "type": "number",
          "required": false,
          "default": "the measure's precision",
          "allowedValues": null,
          "description": "Decimals",
          "callback": false
        },
        {
          "name": "refLow",
          "type": "number",
          "required": false,
          "default": "from the registry",
          "allowedValues": null,
          "description": "Lab reference low; with `refHigh` it replaces the registry range",
          "callback": false
        },
        {
          "name": "refHigh",
          "type": "number",
          "required": false,
          "default": "from the registry",
          "allowedValues": null,
          "description": "Lab reference high",
          "callback": false
        },
        {
          "name": "critLow",
          "type": "number",
          "required": false,
          "default": "from the registry",
          "allowedValues": null,
          "description": "Critical low",
          "callback": false
        },
        {
          "name": "critHigh",
          "type": "number",
          "required": false,
          "default": "from the registry",
          "allowedValues": null,
          "description": "Critical high",
          "callback": false
        },
        {
          "name": "min",
          "type": "number",
          "required": false,
          "default": "auto (lowest edge or value, minus 12% padding)",
          "allowedValues": null,
          "description": "Bar start",
          "callback": false
        },
        {
          "name": "max",
          "type": "number",
          "required": false,
          "default": "auto (highest edge or value, plus 12% padding)",
          "allowedValues": null,
          "description": "Bar end",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "the measure label",
          "allowedValues": null,
          "description": "Label",
          "callback": false
        },
        {
          "name": "showHeader",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Header row with label and value",
          "callback": false
        },
        {
          "name": "width",
          "type": "number | string",
          "required": false,
          "default": "'100%'",
          "allowedValues": null,
          "description": "Width (px number or CSS length)",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        },
        {
          "name": "defaultRangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "context, used only when no prop, provider or global context applies; default none",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "The containing set's",
          "callback": false
        },
        {
          "name": "ageYears",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Age in years for the pediatric bands",
          "callback": false
        }
      ],
      "whenToUse": [
        "Result detail drawers, patient-facing result views, trend reviews."
      ],
      "whenNotToUse": [
        "Dense tables: use ClinicalValue with its tooltip.",
        "Results with no numeric range."
      ],
      "accessibility": [
        "The bar is role img with one sentence: name, value, unit, range and flag.",
        "Marker colour repeats the flag; the header shows the flag letter and icon."
      ],
      "example": "<ReferenceRangeBar measure=\"potassium\" value={5.4} />",
      "readme": "src/components/ReferenceRangeBar/README.md",
      "storybook": "complex-clinical-values-referencerangebar--docs"
    },
    {
      "name": "ReferralCard",
      "layer": "sent by direct message",
      "group": null,
      "summary": "ReferralCard summarizes an outgoing or incoming referral with status, reason, urgency, authorization and its status timeline.",
      "import": "import { ReferralCard } from 'health-components';",
      "element": {
        "tag": "co-referral-card",
        "events": [],
        "slots": [
          "actions",
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "referral",
          "type": "ReferralData",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{specialty, patient, to, status, reason, urgency, auth?, from, timeline?}; required",
          "callback": false
        },
        {
          "name": "actions",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Buttons under the card body",
          "callback": false
        },
        {
          "name": "flat",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Border instead of shadow",
          "callback": false
        },
        {
          "name": "padding",
          "type": "CardPadding",
          "required": false,
          "default": "'default'",
          "allowedValues": [
            "compact",
            "default",
            "none"
          ],
          "description": "'default' | 'compact' (10px) | 'none' (edge-to-edge tables)",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer content",
          "callback": false
        },
        {
          "name": "as",
          "type": "ElementType",
          "required": false,
          "default": "'section'",
          "allowedValues": null,
          "description": "Root tag name",
          "callback": false
        }
      ],
      "whenToUse": [
        "Referral detail and queues."
      ],
      "whenNotToUse": [
        "Prior auth itself: PriorAuthTimeline."
      ],
      "accessibility": [
        "Status word in a badge."
      ],
      "example": "<ReferralCard referral={ref} actions={<Button size=\"sm\">Send Records</Button>} />",
      "readme": "src/components/ReferralCard/README.md",
      "storybook": "sent-by-direct-message--docs"
    },
    {
      "name": "ResultsReview",
      "layer": "basic metabolic panel",
      "group": null,
      "summary": "ResultsReview is the inbox detail for one resulted order: values against the prior draw, then Acknowledge, Comment, Route and Notify Patient. A critical value needs the read-back recorded before Acknowledge.",
      "import": "import { ResultsReview } from 'health-components';",
      "element": {
        "tag": "co-results-review",
        "events": [
          "co-status-change",
          "co-acknowledge",
          "co-comment",
          "co-route",
          "co-notify-patient"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "result",
          "type": "ResultReviewResult",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The resulted order; required",
          "callback": false
        },
        {
          "name": "routeOptions",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "People and pools the result can be routed to",
          "callback": false
        },
        {
          "name": "user",
          "type": "string",
          "required": false,
          "default": "'You'",
          "allowedValues": null,
          "description": "Name of the signed-in user, used on new comments",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only (role cannot acknowledge)",
          "callback": false
        },
        {
          "name": "status",
          "type": "ResultReviewStatus",
          "required": false,
          "default": "uncontrolled, starting at `result.status`",
          "allowedValues": [
            "new",
            "acknowledged",
            "routed"
          ],
          "description": "Review status (controlled)",
          "callback": false
        },
        {
          "name": "onStatusChange",
          "type": "(status: ResultReviewStatus) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the status changes",
          "callback": true
        },
        {
          "name": "onAcknowledge",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the user acknowledges the result",
          "callback": true
        },
        {
          "name": "onComment",
          "type": "(comment: ResultReviewComment) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with a comment the user adds",
          "callback": true
        },
        {
          "name": "onRoute",
          "type": "(to: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the person or pool the result is routed to",
          "callback": true
        },
        {
          "name": "onNotifyPatient",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the user clicks Notify Patient",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Results inbox detail pane; covering-clinician review."
      ],
      "whenNotToUse": [
        "Trends across many draws: ResultsTrendPanel."
      ],
      "accessibility": [
        "A critical value uses role alert.",
        "Acknowledge says why it is disabled through the required checkbox next to it."
      ],
      "example": "<ResultsReview result={bmp} routeOptions={[\"Lisa Chen RN\", \"Cardiology nurse pool\"]} />",
      "readme": "src/components/ResultsReview/README.md",
      "storybook": "basic-metabolic-panel--docs"
    },
    {
      "name": "ResultsTrendPanel",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "ResultsTrendPanel shows many lab results over time, grouped by LOINC panel, as a grid of sparkline tiles or as a date-by-test table.",
      "import": "import { ResultsTrendPanel } from 'health-components';",
      "element": {
        "tag": "co-results-trend-panel",
        "events": [
          "co-view-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "groups",
          "type": "ResultsTrendGroup[]",
          "required": false,
          "default": "none (empty state)",
          "allowedValues": null,
          "description": "Groups of trended tests",
          "callback": false
        },
        {
          "name": "view",
          "type": "ResultsTrendView",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": [
            "grid",
            "table"
          ],
          "description": "Shown view (controlled): 'grid' (sparkline tiles) | 'table' (date by test)",
          "callback": false
        },
        {
          "name": "defaultView",
          "type": "ResultsTrendView",
          "required": false,
          "default": "'grid'",
          "allowedValues": [
            "grid",
            "table"
          ],
          "description": "Initial view: 'grid' | 'table'",
          "callback": false
        },
        {
          "name": "onViewChange",
          "type": "(view: ResultsTrendView) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the view changes",
          "callback": true
        },
        {
          "name": "maxColumns",
          "type": "number",
          "required": false,
          "default": "all",
          "allowedValues": null,
          "description": "Most recent dates shown as table columns",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Results Trend'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card subtitle",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Reviewing trends before a visit or a dose change: renal function on an ACE inhibitor, hemoglobin on chemotherapy, A1c over a year."
      ],
      "whenNotToUse": [
        "A single new result to sign: ResultsReview. One panel in one draw: LabResultTable."
      ],
      "accessibility": [
        "The view switch is a radio group.",
        "The table has a hidden caption, row headers per test and column-group headers per panel.",
        "Each value carries its unit and flag in its accessible name."
      ],
      "example": "<ResultsTrendPanel groups={groups} defaultView=\"table\" maxColumns={6} />",
      "readme": "src/components/ResultsTrendPanel/README.md",
      "storybook": "complex-chart-panels-resultstrendpanel--docs"
    },
    {
      "name": "RolePill",
      "layer": "complex",
      "group": "Access",
      "summary": "RolePill shows which role the screen is previewed as (\"Viewing as: Biller\") and switches it.",
      "import": "import { RolePill } from 'health-components';",
      "element": {
        "tag": "co-role-pill",
        "events": [
          "co-open-change",
          "co-change"
        ],
        "slots": []
      },
      "aliases": [
        "ViewingAs",
        "RoleSwitcher"
      ],
      "props": [
        {
          "name": "role",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Role currently previewed (controlled). Required unless `defaultRole` is set.",
          "callback": false
        },
        {
          "name": "defaultRole",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial role when uncontrolled",
          "callback": false
        },
        {
          "name": "roles",
          "type": "RoleOption[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Roles offered in the menu. Required.",
          "callback": false
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Menu open on first render",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Menu open state (controlled)",
          "callback": false
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the menu opens or closes",
          "callback": true
        },
        {
          "name": "onChange",
          "type": "(role: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen role label",
          "callback": true
        },
        {
          "name": "className",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Class on the wrapper",
          "callback": false
        }
      ],
      "whenToUse": [
        "Admins previewing what another role sees; demos."
      ],
      "whenNotToUse": [
        "Changing a user's real role: Settings, Users."
      ],
      "accessibility": [
        "Button named \"Change the role you are viewing as\", aria-haspopup menu."
      ],
      "example": "<RolePill role=\"Biller\" roles={ROLES} onChange={setPreviewRole} />",
      "readme": "src/components/RolePill/README.md",
      "storybook": "complex-access-rolepill--docs"
    },
    {
      "name": "RPMReadingChart",
      "layer": "complex",
      "group": "Quality and care programs",
      "summary": "RPMReadingChart shows remote-monitoring readings against an alert line, reading days toward 99454 and interactive minutes toward 99457.",
      "import": "import { RPMReadingChart } from 'health-components';",
      "element": {
        "tag": "co-rpm-reading-chart",
        "events": [],
        "slots": [
          "footer"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "readings",
          "type": "ReadonlyArray<RPMReading>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<[label, value]>; required",
          "callback": false
        },
        {
          "name": "metric",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Chart caption and start of its accessible summary (\"Systolic (mmHg), last 7 readings\")",
          "callback": false
        },
        {
          "name": "device",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Device and context line under the title",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "\"Remote monitoring\"",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "high",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Alert line: readings at or above it are red",
          "callback": false
        },
        {
          "name": "low",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Readings at or below it are amber",
          "callback": false
        },
        {
          "name": "max",
          "type": "number",
          "required": false,
          "default": "auto",
          "allowedValues": null,
          "description": "Top of the chart scale",
          "callback": false
        },
        {
          "name": "days",
          "type": "number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Reading days this month (16 needed for 99454); required",
          "callback": false
        },
        {
          "name": "minutes",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Interactive minutes this month (20 needed for 99457)",
          "callback": false
        },
        {
          "name": "alert",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Out-of-range note shown as a warning Alert",
          "callback": false
        },
        {
          "name": "flat",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Border instead of shadow",
          "callback": false
        },
        {
          "name": "padding",
          "type": "CardPadding",
          "required": false,
          "default": "'default'",
          "allowedValues": [
            "compact",
            "default",
            "none"
          ],
          "description": "'default' | 'compact' (10px) | 'none' (edge-to-edge tables)",
          "callback": false
        },
        {
          "name": "footer",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Footer content",
          "callback": false
        },
        {
          "name": "as",
          "type": "ElementType",
          "required": false,
          "default": "'section'",
          "allowedValues": null,
          "description": "Root tag name",
          "callback": false
        }
      ],
      "whenToUse": [
        "RPM enrollment review and monthly billing check."
      ],
      "whenNotToUse": [
        "Office vitals: VitalsPanel."
      ],
      "accessibility": [
        "Chart has full aria text."
      ],
      "example": "<RPMReadingChart device=\"BP cuff, Omron\" readings={week} high={140} days={18} minutes={14} />",
      "readme": "src/components/RPMReadingChart/README.md",
      "storybook": "complex-quality-and-care-programs-rpmreadingchart--docs"
    },
    {
      "name": "ScoreQuestionnaire",
      "layer": "complex",
      "group": "Orders and notes",
      "summary": "ScoreQuestionnaire runs GAD-7 or PHQ-9 with a live total and severity band, and flags a positive PHQ-9 item 9.",
      "import": "import { ScoreQuestionnaire } from 'health-components';",
      "element": {
        "tag": "co-score-questionnaire",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "instrument",
          "type": "ScoreInstrument",
          "required": true,
          "default": null,
          "allowedValues": [
            "GAD-7",
            "PHQ-9"
          ],
          "description": "'GAD-7' | 'PHQ-9'. Required",
          "callback": false
        },
        {
          "name": "questions",
          "type": "string[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The items, in order (string[]). Required",
          "callback": false
        },
        {
          "name": "answers",
          "type": "ScoreAnswer[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial answers, 0 to 3 per item, null for unanswered (uncontrolled)",
          "callback": false
        },
        {
          "name": "value",
          "type": "ScoreAnswer[]",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled answers",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(answers: ScoreAnswer[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with all answers after one changes",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Title after the instrument name (\"Generalized anxiety\")",
          "callback": false
        }
      ],
      "whenToUse": [
        "Behavioral health screening at intake or in the portal."
      ],
      "whenNotToUse": [
        "Unscored forms: a normal form."
      ],
      "accessibility": [
        "Each item is a radiogroup; score is aria-live."
      ],
      "example": "<ScoreQuestionnaire instrument=\"PHQ-9\" questions={PHQ9_ITEMS} answers={saved} />",
      "readme": "src/components/ScoreQuestionnaire/README.md",
      "storybook": "complex-orders-and-notes-scorequestionnaire--docs"
    },
    {
      "name": "SectionNav",
      "layer": "basic",
      "group": "Navigation",
      "summary": "SectionNav is the left list of sections inside a record, such as the 20 sections of a patient chart.",
      "import": "import { SectionNav } from 'health-components';",
      "element": {
        "tag": "co-section-nav",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "SectionNavItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Sections, in the same order for every record. Required.",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Label of the current section",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Section menu\"",
          "allowedValues": null,
          "description": "Landmark name",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(label: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the clicked section label. Items without `href` do not navigate",
          "callback": true
        }
      ],
      "whenToUse": [
        "Records with many sections that are separate pages."
      ],
      "whenNotToUse": [
        "Two to six views: Tabs."
      ],
      "accessibility": [
        "nav landmark \"Section menu\", aria-current=\"page\" on the active link."
      ],
      "example": "<SectionNav items={CHART_SECTIONS} active=\"Medications\" onChange={goSection} />",
      "readme": "src/components/SectionNav/README.md",
      "storybook": "basic-navigation-sectionnav--docs"
    },
    {
      "name": "SegmentedControl",
      "layer": "basic",
      "group": "Selection",
      "summary": "SegmentedControl switches between two to five views or values in one compact bar.",
      "import": "import { SegmentedControl } from 'health-components';",
      "element": {
        "tag": "co-segmented-control",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "options",
          "type": "ReadonlyArray<string | SegmentedOption>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Two to five options: strings or `{value, label, count?, disabled?}`. Required",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "first option",
          "allowedValues": null,
          "description": "Selected value (controlled)",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "first option",
          "allowedValues": null,
          "description": "Initially selected value (uncontrolled)",
          "callback": false
        },
        {
          "name": "size",
          "type": "'sm' | 'md'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Accessible name of the group (aria-label)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(value: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the newly selected value",
          "callback": true
        }
      ],
      "whenToUse": [
        "View switches: Upcoming, Past; Day, Week, Month; Comfortable, Compact."
      ],
      "whenNotToUse": [
        "More than five options or long labels: Tabs or Select."
      ],
      "accessibility": [
        "radiogroup with radio buttons and aria-checked."
      ],
      "example": "<SegmentedControl label=\"Calendar view\" options={[\"Day\", \"Week\", \"Month\"]} value={view} onChange={setView} />",
      "readme": "src/components/SegmentedControl/README.md",
      "storybook": "basic-selection-segmentedcontrol--docs"
    },
    {
      "name": "Select",
      "layer": "basic",
      "group": "Inputs",
      "summary": "Select picks one value from a short fixed list, such as Provider, Location or Status filters.",
      "import": "import { Select } from 'health-components';",
      "element": {
        "tag": "co-select",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; required",
          "callback": false
        },
        {
          "name": "options",
          "type": "Array<string | SelectOption>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<string | {value, label}>; required",
          "callback": false
        },
        {
          "name": "placeholder",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Text of a first empty option (\"Choose one\")",
          "callback": false
        },
        {
          "name": "size",
          "type": "'sm' | 'md'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message (as TextField)",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Muted hint under the field (as TextField)",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk plus aria-required (as TextField)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Read-only lock state: the select is disabled and a lock line explains why",
          "callback": false
        },
        {
          "name": "lockMessage",
          "type": "string",
          "required": false,
          "default": "'Your role can view but not edit'",
          "allowedValues": null,
          "description": "Lock line text when readOnly",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Up to about 15 known options."
      ],
      "whenNotToUse": [
        "Long or searchable lists (patients, codes, payers): Combobox.",
        "Two to four options shown at once: SegmentedControl or RadioGroup."
      ],
      "accessibility": [
        "Native select keeps platform keyboard and screen reader behaviour."
      ],
      "example": "<Select label=\"Provider\" options={[\"All\", ...providers]} value={provider} onChange={e => setProvider(e.target.value)} />",
      "readme": "src/components/Select/README.md",
      "storybook": "basic-inputs-select--docs"
    },
    {
      "name": "SettingRow",
      "layer": "basic",
      "group": "Layout",
      "summary": "SettingRow is the two-column settings row: label and help on the left, control on the right.",
      "import": "import { SettingRow } from 'health-components';",
      "element": {
        "tag": "co-setting-row",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Setting name, left column",
          "callback": false
        },
        {
          "name": "help",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Explanation under the label",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The control, right column. Give it its own accessible label.",
          "callback": false
        }
      ],
      "whenToUse": [
        "Settings pages."
      ],
      "whenNotToUse": [
        "Data entry forms: fields in a grid."
      ],
      "accessibility": [
        "Label the control itself too."
      ],
      "example": "<SettingRow label=\"Density\" help=\"Compact fits more rows.\"><SegmentedControl options={[\"Comfortable\", \"Compact\"]} /></SettingRow>",
      "readme": "src/components/SettingRow/README.md",
      "storybook": "basic-layout-settingrow--docs"
    },
    {
      "name": "ShiftHandoff",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "ShiftHandoff is the SBAR nurse-to-nurse report: Situation, Background, Assessment with formatted values, Recommendation, what is due next, and the receiving nurse accepting it.",
      "import": "import { ShiftHandoff } from 'health-components';",
      "element": {
        "tag": "co-shift-handoff",
        "events": [
          "co-acknowledge"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "situation",
          "type": "HandoffSection",
          "required": false,
          "default": "none (shows Not filled in)",
          "allowedValues": null,
          "description": "S: Situation",
          "callback": false
        },
        {
          "name": "background",
          "type": "HandoffSection",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "B: Background",
          "callback": false
        },
        {
          "name": "assessment",
          "type": "HandoffSection",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "A: Assessment",
          "callback": false
        },
        {
          "name": "recommendation",
          "type": "HandoffSection",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "R: Recommendation",
          "callback": false
        },
        {
          "name": "pending",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "What is due in the next 4 hours",
          "callback": false
        },
        {
          "name": "flags",
          "type": "HandoffFlag[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Header flags",
          "callback": false
        },
        {
          "name": "from",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Giving nurse",
          "callback": false
        },
        {
          "name": "to",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Receiving nurse",
          "callback": false
        },
        {
          "name": "acknowledged",
          "type": "boolean",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Controlled accepted state",
          "callback": false
        },
        {
          "name": "defaultAcknowledged",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial accepted state (uncontrolled)",
          "callback": false
        },
        {
          "name": "ackTime",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "When it was accepted ('19:12')",
          "callback": false
        },
        {
          "name": "onAcknowledge",
          "type": "() => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the receiving nurse accepts",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Shift Handoff (SBAR)'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Unit line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; a value's own range still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Shift change, transfer between units, handoff to rapid response."
      ],
      "whenNotToUse": [
        "Provider sign-out with a task list: use the I-PASS pattern."
      ],
      "accessibility": [
        "Each section has a visible heading; the S, B, A, R letters are decorative.",
        "Values carry their flags in words."
      ],
      "example": "<ShiftHandoff from=\"L. Chen RN\" to=\"J. Ortiz RN\" situation={{ text: \"...\" }} assessment={{ values: [...] }} />",
      "readme": "src/components/ShiftHandoff/README.md",
      "storybook": "complex-inpatient-nursing-shifthandoff--docs"
    },
    {
      "name": "SidebarNav",
      "layer": "complex",
      "group": "Navigation",
      "summary": "SidebarNav is the Clinical Sidebar style's grouped left navigation, 240px wide, collapsing to a 64px icon strip.",
      "import": "import { SidebarNav } from 'health-components';",
      "element": {
        "tag": "co-sidebar-nav",
        "events": [
          "co-collapse",
          "co-navigate"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "groups",
          "type": "SidebarNavGroup[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Groups in a fixed order; only the items change per role. Required.",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Label of the current item",
          "callback": false
        },
        {
          "name": "collapsed",
          "type": "boolean",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Collapsed to the 64px icon strip (controlled)",
          "callback": false
        },
        {
          "name": "defaultCollapsed",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initially collapsed when uncontrolled",
          "callback": false
        },
        {
          "name": "product",
          "type": "string",
          "required": false,
          "default": "\"CareOS\"",
          "allowedValues": null,
          "description": "Product name next to the logo mark",
          "callback": false
        },
        {
          "name": "onCollapse",
          "type": "(collapsed: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new collapsed state",
          "callback": true
        },
        {
          "name": "onNavigate",
          "type": "(item: SidebarNavItem, event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when an item is clicked",
          "callback": true
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Bordered, for docs",
          "callback": false
        }
      ],
      "whenToUse": [
        "Clinical Sidebar style on desktop."
      ],
      "whenNotToUse": [
        "Phones: BottomTabBar.",
        "Focus Rail and Command Bar styles."
      ],
      "accessibility": [
        "nav \"Main\"; aria-current=\"page\".",
        "Collapse button says \"Collapse sidebar\" or \"Expand sidebar\" and has aria-expanded.",
        "Items the role cannot use at all are removed (none level), not shown disabled."
      ],
      "example": "<SidebarNav groups={NAV_GROUPS_FOR_ROLE} active=\"Schedule\" collapsed={prefs.collapsed} onCollapse={saveCollapsed} />",
      "readme": "src/components/SidebarNav/README.md",
      "storybook": "complex-navigation-sidebarnav--docs"
    },
    {
      "name": "SigBuilder",
      "layer": "complex",
      "group": "Medications",
      "summary": "SigBuilder builds the directions from dose, route, frequency and duration and shows the plain-language sig the patient will read.",
      "import": "import { SigBuilder } from 'health-components';",
      "element": {
        "tag": "co-sig-builder",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "value",
          "type": "Sig",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "{dose, route, freq, duration?, prn?, qty, refills, schedule?}. Controlled when `onChange` is set; without\n`onChange` it seeds the fields, as the design system README uses it",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "Sig",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Initial sig (uncontrolled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(sig: Sig) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the whole sig on every edit",
          "callback": true
        },
        {
          "name": "routes",
          "type": "string[]",
          "required": false,
          "default": "by mouth, under the tongue, topically, inhaled, by injection",
          "allowedValues": null,
          "description": "Route choices",
          "callback": false
        },
        {
          "name": "frequencies",
          "type": "string[]",
          "required": false,
          "default": "once daily ... at bedtime",
          "allowedValues": null,
          "description": "Frequency choices, spelled out",
          "callback": false
        }
      ],
      "whenToUse": [
        "Every new prescription."
      ],
      "whenNotToUse": [
        "Free-text only sigs."
      ],
      "accessibility": [
        "Preview is text, read by screen readers."
      ],
      "example": "<SigBuilder value={{ dose: \"1 tablet\", route: \"by mouth\", freq: \"twice daily\", qty: 60, refills: 3 }} />",
      "readme": "src/components/SigBuilder/README.md",
      "storybook": "complex-medications-sigbuilder--docs"
    },
    {
      "name": "SignaturePad",
      "layer": "basic",
      "group": "Inputs",
      "summary": "SignaturePad captures a patient or provider signature on consent forms, check-in and note signing.",
      "import": "import { SignaturePad } from 'health-components';",
      "element": {
        "tag": "co-signature-pad",
        "events": [
          "co-signed-change",
          "co-sign",
          "co-clear"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Signature\"",
          "allowedValues": null,
          "description": "Label above the pad",
          "callback": false
        },
        {
          "name": "name",
          "type": "string",
          "required": false,
          "default": "\"patient\"",
          "allowedValues": null,
          "description": "Signer's name, drawn as the signature and used in the pad's accessible name",
          "callback": false
        },
        {
          "name": "signed",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled signed state",
          "callback": false
        },
        {
          "name": "defaultSigned",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial signed state (uncontrolled)",
          "callback": false
        },
        {
          "name": "onSignedChange",
          "type": "(signed: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the signed state changes (sign or clear)",
          "callback": true
        },
        {
          "name": "when",
          "type": "string",
          "required": false,
          "default": "the time the pad was signed",
          "allowedValues": null,
          "description": "Time stamp shown after signing (\"10/09/2026 10:42 AM\")",
          "callback": false
        },
        {
          "name": "compact",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shorter pad (90px)",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk after the label",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message under the pad, role alert",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the signer taps to sign",
          "callback": true
        },
        {
          "name": "onClear",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the signature is cleared",
          "callback": true
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Consent to treat, HIPAA acknowledgement, financial policy, proxy access."
      ],
      "whenNotToUse": [
        "Provider note signing that uses a PIN or password: PinEntry."
      ],
      "accessibility": [
        "The pad is a button named \"Tap to sign as Henna West\", so it works without drawing."
      ],
      "example": "<SignaturePad label=\"Patient Signature\" name={patient.name} required onSign={recordConsent} />",
      "readme": "src/components/SignaturePad/README.md",
      "storybook": "basic-inputs-signaturepad--docs"
    },
    {
      "name": "Skeleton",
      "layer": "basic",
      "group": "Data display",
      "summary": "Skeleton shows grey placeholder shapes while content loads.",
      "import": "import { Skeleton } from 'health-components';",
      "element": {
        "tag": "co-skeleton",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "variant",
          "type": "SkeletonVariant",
          "required": false,
          "default": "'text'",
          "allowedValues": [
            "card",
            "text",
            "row",
            "avatar"
          ],
          "description": "'text' | 'row' | 'card' | 'avatar'",
          "callback": false
        },
        {
          "name": "lines",
          "type": "number",
          "required": false,
          "default": "1",
          "allowedValues": null,
          "description": "Text lines (variant text); the last line is shorter",
          "callback": false
        },
        {
          "name": "rows",
          "type": "number",
          "required": false,
          "default": "3",
          "allowedValues": null,
          "description": "Table rows (variant row)",
          "callback": false
        },
        {
          "name": "width",
          "type": "CSSProperties['width']",
          "required": false,
          "default": "'100%'",
          "allowedValues": null,
          "description": "CSS width of text lines",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Loading\" (\"Loading rows\" for variant row)",
          "allowedValues": null,
          "description": "Accessible name (aria-label)",
          "callback": false
        }
      ],
      "whenToUse": [
        "Loads over about 300ms where the layout is known: table rows, cards, KPI values."
      ],
      "whenNotToUse": [
        "Actions that run after a click: Button loading."
      ],
      "accessibility": [
        "aria-busy with a label; the pulse stops under prefers-reduced-motion."
      ],
      "example": "{loading ? <Skeleton variant=\"row\" rows={5} /> : <PatientRows />}",
      "readme": "src/components/Skeleton/README.md",
      "storybook": "basic-data-display-skeleton--docs"
    },
    {
      "name": "SOAPSection",
      "layer": "complex",
      "group": "Orders and notes",
      "summary": "SOAPSection is one note section with AI draft, smart-phrase insert, required tag and error, or custom content.",
      "import": "import { SOAPSection } from 'health-components';",
      "element": {
        "tag": "co-soap-section",
        "events": [
          "co-change",
          "co-accept-a-i",
          "co-insert-macro",
          "co-input"
        ],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Section title (\"Subtitle\", \"Plan\"); also names the textarea. Required",
          "callback": false
        },
        {
          "name": "text",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial section text (uncontrolled)",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled section text",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(text: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new text (typing, smart phrase, accepted AI draft)",
          "callback": true
        },
        {
          "name": "ai",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "AI Scribe draft shown above the textarea with Accept and Edit",
          "callback": false
        },
        {
          "name": "onAcceptAI",
          "type": "(draft: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called after the AI draft is accepted into the text",
          "callback": true
        },
        {
          "name": "macros",
          "type": "string[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Smart phrases offered in the Insert popover (string[])",
          "callback": false
        },
        {
          "name": "onInsertMacro",
          "type": "(macro: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the smart phrase inserted into the text",
          "callback": true
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the Required tag and marks the textarea required",
          "callback": false
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message under the textarea",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Read-only lock state of the textarea",
          "callback": false
        },
        {
          "name": "rows",
          "type": "number",
          "required": false,
          "default": "3",
          "allowedValues": null,
          "description": "Textarea rows",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Custom content that replaces the textarea, such as a ScoreQuestionnaire",
          "callback": false
        }
      ],
      "whenToUse": [
        "Inside VisitNoteEditor or a custom note layout."
      ],
      "whenNotToUse": [
        "Short single fields: TextField."
      ],
      "accessibility": [
        "Textarea named by the section title."
      ],
      "example": "<SOAPSection title=\"Plan\" macros={[\".diabetesplan\", \".followup3m\"]} required />",
      "readme": "src/components/SOAPSection/README.md",
      "storybook": "complex-orders-and-notes-soapsection--docs"
    },
    {
      "name": "Sparkline",
      "layer": "basic",
      "group": "Charts",
      "summary": "Sparkline is a tiny trend line for a vital sign or lab value, with the last point marked.",
      "import": "import { Sparkline } from 'health-components';",
      "element": {
        "tag": "co-sparkline",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "values",
          "type": "number[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "number[]; at least two values, otherwise nothing renders",
          "callback": false
        },
        {
          "name": "width",
          "type": "number",
          "required": false,
          "default": "72",
          "allowedValues": null,
          "description": "Width in px",
          "callback": false
        },
        {
          "name": "height",
          "type": "number",
          "required": false,
          "default": "22",
          "allowedValues": null,
          "description": "Height in px",
          "callback": false
        },
        {
          "name": "color",
          "type": "string",
          "required": false,
          "default": "var(--co-primary)",
          "allowedValues": null,
          "description": "CSS colour, use a token (`var(--co-danger)` for a flagged value)",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Trend\"",
          "allowedValues": null,
          "description": "Start of the accessible name, followed by the values",
          "callback": false
        }
      ],
      "whenToUse": [
        "Inline trend next to a value."
      ],
      "whenNotToUse": [
        "Any chart that needs axes: LineChart."
      ],
      "accessibility": [
        "role img with all values in the label."
      ],
      "example": "<Sparkline values={[7.9, 7.4, 7.1, 6.8]} />",
      "readme": "src/components/Sparkline/README.md",
      "storybook": "basic-charts-sparkline--docs"
    },
    {
      "name": "Spinner",
      "layer": "basic",
      "group": "Feedback",
      "summary": "Spinner shows that something is loading when the wait is short or its length is unknown.",
      "import": "import { Spinner } from 'health-components';",
      "element": {
        "tag": "co-spinner",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "size",
          "type": "'sm' | 'lg'",
          "required": false,
          "default": "'sm'",
          "allowedValues": [
            "sm",
            "lg"
          ],
          "description": "'sm' | 'lg'",
          "callback": false
        },
        {
          "name": "tone",
          "type": "'primary' | 'ai'",
          "required": false,
          "default": "'primary'",
          "allowedValues": [
            "ai",
            "primary"
          ],
          "description": "'primary' | 'ai'",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Loading\"",
          "allowedValues": null,
          "description": "Accessible name announced by screen readers",
          "callback": false
        }
      ],
      "whenToUse": [
        "Inside buttons (Button loading) and for waits under a few seconds."
      ],
      "whenNotToUse": [
        "Known layouts that load: Skeleton. Long jobs: ProgressBar."
      ],
      "accessibility": [
        "role status with a label; slows under prefers-reduced-motion."
      ],
      "example": "<Spinner label=\"Checking coverage\" />  <Spinner size=\"lg\" tone=\"ai\" />",
      "readme": "src/components/Spinner/README.md",
      "storybook": "basic-feedback-spinner--docs"
    },
    {
      "name": "SplitButton",
      "layer": "basic",
      "group": "Actions",
      "summary": "SplitButton pairs a main action with a menu of related ones, such as Submit Claim with Submit and Print.",
      "import": "import { SplitButton } from 'health-components';",
      "element": {
        "tag": "co-split-button",
        "events": [
          "co-click",
          "co-open-change",
          "co-item-select"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Main action label (\"Submit Claim\"); required",
          "callback": false
        },
        {
          "name": "onClick",
          "type": "(event: MouseEvent<HTMLButtonElement | HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Runs the main action",
          "callback": true
        },
        {
          "name": "items",
          "type": "MenuItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Related actions in the menu: Array<{label, hint?, icon?, danger?, disabled?, onSelect?}>; required",
          "callback": false
        },
        {
          "name": "variant",
          "type": "'primary' | 'secondary'",
          "required": false,
          "default": "'primary'",
          "allowedValues": [
            "primary",
            "secondary"
          ],
          "description": "'primary' | 'secondary'",
          "callback": false
        },
        {
          "name": "size",
          "type": "'sm' | 'md'",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md"
          ],
          "description": "'sm' | 'md'",
          "callback": false
        },
        {
          "name": "menuLabel",
          "type": "string",
          "required": false,
          "default": "\"More options\"",
          "allowedValues": null,
          "description": "aria-label of the arrow button",
          "callback": false
        },
        {
          "name": "defaultOpen",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Open on first render (uncontrolled)",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled open state of the menu",
          "callback": false
        },
        {
          "name": "onOpenChange",
          "type": "(open: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the menu opens or closes",
          "callback": true
        },
        {
          "name": "onItemSelect",
          "type": "(item: MenuActionItem, index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the chosen item and its index, after the item's own onSelect (one handler for every item)",
          "callback": true
        },
        {
          "name": "disabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables both halves",
          "callback": false
        },
        {
          "name": "align",
          "type": "MenuAlign",
          "required": false,
          "default": "'right'",
          "allowedValues": [
            "right",
            "left"
          ],
          "description": "'right' | 'left': menu alignment",
          "callback": false
        },
        {
          "name": "className",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Class on the wrapper",
          "callback": false
        }
      ],
      "whenToUse": [
        "One action is clearly the default and two to five variations exist: Submit Claim, Submit and Print, Save as Draft."
      ],
      "whenNotToUse": [
        "The options are equally likely: use separate buttons.",
        "The menu holds unrelated actions: use a KebabMenu."
      ],
      "accessibility": [
        "The arrow is its own button with aria-haspopup=\"menu\" and aria-expanded.",
        "Escape closes the menu."
      ],
      "example": "<SplitButton label=\"Submit Claim\" onClick={submit}\n  items={[{ label: \"Submit and Print CMS-1500\", onSelect: submitPrint }, { label: \"Save as Draft\", onSelect: saveDraft }]} />",
      "readme": "src/components/SplitButton/README.md",
      "storybook": "basic-actions-splitbutton--docs"
    },
    {
      "name": "SplitPaneChartLayout",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "SplitPaneChartLayout is the three-pane chart workspace: a resizable left section nav, the note in the middle and a resizable right context panel that can close.",
      "import": "import { SplitPaneChartLayout } from 'health-components';",
      "element": {
        "tag": "co-split-pane-chart-layout",
        "events": [
          "co-left-width-change",
          "co-right-width-change",
          "co-left-collapsed-change",
          "co-right-open-change"
        ],
        "slots": [
          "nav",
          "(default)",
          "context"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "nav",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Left pane: chart section navigation",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Middle pane: the note",
          "callback": false
        },
        {
          "name": "context",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Right pane: context (results, CDS cards)",
          "callback": false
        },
        {
          "name": "rightTitle",
          "type": "string",
          "required": false,
          "default": "'Context'",
          "allowedValues": null,
          "description": "Right pane title",
          "callback": false
        },
        {
          "name": "mainLabel",
          "type": "string",
          "required": false,
          "default": "'Note'",
          "allowedValues": null,
          "description": "Accessible name of the middle pane",
          "callback": false
        },
        {
          "name": "leftWidth",
          "type": "number",
          "required": false,
          "default": "220",
          "allowedValues": null,
          "description": "Initial left pane width in px (160 to 360)",
          "callback": false
        },
        {
          "name": "rightWidth",
          "type": "number",
          "required": false,
          "default": "300",
          "allowedValues": null,
          "description": "Initial right pane width in px (240 to 520)",
          "callback": false
        },
        {
          "name": "onLeftWidthChange",
          "type": "(width: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the left width after a resize",
          "callback": true
        },
        {
          "name": "onRightWidthChange",
          "type": "(width: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the right width after a resize",
          "callback": true
        },
        {
          "name": "leftCollapsed",
          "type": "boolean",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Left pane collapsed to a rail (controlled)",
          "callback": false
        },
        {
          "name": "defaultLeftCollapsed",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Left pane starts collapsed",
          "callback": false
        },
        {
          "name": "onLeftCollapsedChange",
          "type": "(collapsed: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the left pane collapses or expands",
          "callback": true
        },
        {
          "name": "rightOpen",
          "type": "boolean",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Right pane open (controlled)",
          "callback": false
        },
        {
          "name": "defaultRightOpen",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Right pane starts open",
          "callback": false
        },
        {
          "name": "onRightOpenChange",
          "type": "(open: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the right pane opens or closes",
          "callback": true
        },
        {
          "name": "height",
          "type": "number",
          "required": false,
          "default": "420",
          "allowedValues": null,
          "description": "Layout height in px",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Writing a note while looking at results, medications or a CDS card."
      ],
      "whenNotToUse": [
        "Phone width: panes stack. Simple pages: use the page layout."
      ],
      "accessibility": [
        "Dividers are role separator with aria-valuenow and keyboard resizing.",
        "Each pane is a landmark: nav, main, aside."
      ],
      "example": "<SplitPaneChartLayout nav={<SectionNav />} context={<ResultsTrendPanel groups={g} />} rightTitle=\"Results\">{note}</SplitPaneChartLayout>",
      "readme": "src/components/SplitPaneChartLayout/README.md",
      "storybook": "complex-chart-panels-splitpanechartlayout--docs"
    },
    {
      "name": "StatCard",
      "layer": "basic",
      "group": "Data display",
      "summary": "StatCard shows one number with its label and context, and can act as a filter button.",
      "import": "import { StatCard } from 'health-components';",
      "element": {
        "tag": "co-stat-card",
        "events": [
          "co-click"
        ],
        "slots": [
          "value",
          "sub"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Label, shown uppercase. Required",
          "callback": false
        },
        {
          "name": "value",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The number. Required",
          "callback": false
        },
        {
          "name": "sub",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Context line: what the number counts and over what period",
          "callback": false
        },
        {
          "name": "trend",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Trend text, such as \"1.4 pts\"",
          "callback": false
        },
        {
          "name": "trendDir",
          "type": "'up' | 'down'",
          "required": false,
          "default": "'up'",
          "allowedValues": [
            "up",
            "down"
          ],
          "description": "'up' | 'down': arrow before the trend",
          "callback": false
        },
        {
          "name": "trendGood",
          "type": "boolean",
          "required": false,
          "default": "none (neutral)",
          "allowedValues": null,
          "description": "true colours the trend green, false red",
          "callback": false
        },
        {
          "name": "selected",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Selected filter state (with onClick)",
          "callback": false
        },
        {
          "name": "onClick",
          "type": "(event: MouseEvent<HTMLButtonElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Makes the card a toggle button (aria-pressed)",
          "callback": true
        },
        {
          "name": "meter",
          "type": "StatCardMeter",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "`{value, max, tone?}` usage meter under the value",
          "callback": false
        },
        {
          "name": "loading",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows a skeleton instead of the value",
          "callback": false
        }
      ],
      "whenToUse": [
        "Top of dashboards and queues: Claims to Work 42, Denial Rate 6.2%."
      ],
      "whenNotToUse": [
        "Numbers without a comparison or meaning."
      ],
      "accessibility": [
        "Selectable cards are buttons with aria-pressed.",
        "Trend direction is an arrow character as well as a colour.",
        "Say what the number counts and over what period in the sub line."
      ],
      "example": "<StatCard label=\"Claims to Work\" value={42} sub=\"9 over 30 days\" selected={kpi === \"work\"} onClick={() => setKpi(\"work\")} />",
      "readme": "src/components/StatCard/README.md",
      "storybook": "basic-data-display-statcard--docs"
    },
    {
      "name": "Stepper",
      "layer": "basic",
      "group": "Navigation",
      "summary": "Stepper shows progress through a multi-step flow, such as the 7-step Add Patient form, as a numbered bar, a vertical list or thin segments.",
      "import": "import { Stepper } from 'health-components';",
      "element": {
        "tag": "co-stepper",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "steps",
          "type": "StepperStep[]",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Steps in order; may be empty for `segments` with `count`.",
          "callback": false
        },
        {
          "name": "current",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Current step, 0-based",
          "callback": false
        },
        {
          "name": "variant",
          "type": "StepperVariant",
          "required": false,
          "default": "'bar'",
          "allowedValues": [
            "bar",
            "vertical",
            "segments"
          ],
          "description": "'bar' numbered horizontal | 'vertical' side panels | 'segments' thin bars (phones, kiosk)",
          "callback": false
        },
        {
          "name": "count",
          "type": "number",
          "required": false,
          "default": "4",
          "allowedValues": null,
          "description": "Number of segments when `steps` is empty",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Steps\" (\"Progress\" for segments)",
          "allowedValues": null,
          "description": "Accessible name",
          "callback": false
        }
      ],
      "whenToUse": [
        "Flows of 3 to 8 steps: Add Patient, check-in, new prior auth."
      ],
      "whenNotToUse": [
        "Two steps: just two screens."
      ],
      "accessibility": [
        "Ordered list with aria-current=\"step\"; state words are in screen-reader text.",
        "Segments use role progressbar with \"Step 2 of 5\"."
      ],
      "example": "<Stepper steps={[\"Demographics\", \"Contact\", \"Insurance\"]} current={1} />\n<Stepper variant=\"segments\" count={6} current={0} />",
      "readme": "src/components/Stepper/README.md",
      "storybook": "basic-navigation-stepper--docs"
    },
    {
      "name": "StepperForm",
      "layer": "complex",
      "group": "Forms",
      "summary": "StepperForm runs a multi-step form such as the 7-step Add Patient, with the step bar, an error summary and Back, Next and Save buttons.",
      "import": "import { StepperForm } from 'health-components';",
      "element": {
        "tag": "co-stepper-form",
        "events": [
          "co-step",
          "co-finish",
          "co-cancel",
          "co-save-draft"
        ],
        "slots": [
          "error-summary"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Card title and accessible name of the step bar (\"Add Patient\"); required",
          "callback": false
        },
        {
          "name": "steps",
          "type": "StepperFormStep[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{label, content: node, error?}>; required",
          "callback": false
        },
        {
          "name": "current",
          "type": "number",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Current step, 0-based (controlled)",
          "callback": false
        },
        {
          "name": "defaultCurrent",
          "type": "number",
          "required": false,
          "default": "0",
          "allowedValues": null,
          "description": "Initial step, 0-based (uncontrolled)",
          "callback": false
        },
        {
          "name": "finishLabel",
          "type": "string",
          "required": false,
          "default": "\"Save\"",
          "allowedValues": null,
          "description": "Label of the finish button on the last step",
          "callback": false
        },
        {
          "name": "errorSummary",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error summary shown in an Alert above the fields",
          "callback": false
        },
        {
          "name": "saving",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Finish button shows a spinner",
          "callback": false
        },
        {
          "name": "onStep",
          "type": "(index: number) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new step index on Next and Back",
          "callback": true
        },
        {
          "name": "onFinish",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Finish button on the last step",
          "callback": true
        },
        {
          "name": "onCancel",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Cancel button",
          "callback": true
        },
        {
          "name": "onSaveDraft",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shows a Save Draft button that calls this",
          "callback": true
        }
      ],
      "whenToUse": [
        "Forms with 3 to 8 sections that must be done in order."
      ],
      "whenNotToUse": [
        "Edits to one section of an existing record: a Card with Save."
      ],
      "accessibility": [
        "Step text \"Step 4 of 7 . Guarantor\" in the card subtitle.",
        "Next button names the next step."
      ],
      "example": "<StepperForm title=\"Add Patient\" finishLabel=\"Save Patient\" onFinish={save}\n  steps={[{ label: \"Demographics\", content: <DemographicsFields/> }, { label: \"Insurance\", content: <InsuranceFields/>, error: true }]} />",
      "readme": "src/components/StepperForm/README.md",
      "storybook": "complex-forms-stepperform--docs"
    },
    {
      "name": "StructuredDataGrid",
      "layer": "complex",
      "group": "Chart panels",
      "summary": "StructuredDataGrid is a spreadsheet-like flowsheet for entering many numbers at once, with checks that block impossible values and warn on out-of-range ones.",
      "import": "import { StructuredDataGrid } from 'health-components';",
      "element": {
        "tag": "co-structured-data-grid",
        "events": [
          "co-save",
          "co-rows-change",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "columns",
          "type": "StructuredDataGridColumn[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Columns; required",
          "callback": false
        },
        {
          "name": "rows",
          "type": "StructuredDataGridRow[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initial rows; the grid keeps its own copy as the user types",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card title, also the grid's accessible name",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card subtitle",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Whole grid read only",
          "callback": false
        },
        {
          "name": "onSave",
          "type": "(rows: StructuredDataGridRow[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the rows when Save passes the checks",
          "callback": true
        },
        {
          "name": "onRowsChange",
          "type": "(rows: StructuredDataGridRow[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the rows after every edit",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Nursing flowsheets, intake and output, dialysis runs, infusion vitals, ICU hourly charting."
      ],
      "whenNotToUse": [
        "One set of vitals: VitalsPanel. Free text: SOAPSection."
      ],
      "accessibility": [
        "role grid with a label per cell (column, row and unit).",
        "Errors use role alert; aria-invalid on the input.",
        "Enter and Down move down a column."
      ],
      "example": "<StructuredDataGrid title=\"ICU hourly vitals\" columns={cols} rows={rows} onSave={save} />",
      "readme": "src/components/StructuredDataGrid/README.md",
      "storybook": "complex-chart-panels-structureddatagrid--docs"
    },
    {
      "name": "StyleChooser",
      "layer": "basic",
      "group": "Layout",
      "summary": "StyleChooser picks the practice style (Classic, Clinical Sidebar, Focus Rail, Command Bar) with Preview and Apply to practice.",
      "import": "import { StyleChooser } from 'health-components';",
      "element": {
        "tag": "co-style-chooser",
        "events": [
          "co-change",
          "co-apply"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "styles",
          "type": "StyleChooserOption[]",
          "required": false,
          "default": "the five CareOS themes",
          "allowedValues": null,
          "description": "Array<{id, name, who, swatch?, current?}>",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Previewed style id (controlled)",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "'classic'",
          "allowedValues": null,
          "description": "Initially previewed style id (uncontrolled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(id: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the style id when Preview is chosen",
          "callback": true
        },
        {
          "name": "canApply",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Enables \"Apply to practice\" (admins only)",
          "callback": false
        },
        {
          "name": "onApply",
          "type": "(id: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the style id when \"Apply to practice\" is chosen",
          "callback": true
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"App style\"",
          "allowedValues": null,
          "description": "Accessible name of the radio group",
          "callback": false
        }
      ],
      "whenToUse": [
        "Settings, Appearance."
      ],
      "whenNotToUse": [
        "Per-user theme switches elsewhere."
      ],
      "accessibility": [
        "Preview buttons carry radio semantics."
      ],
      "example": "<StyleChooser canApply={isAdmin} value={previewed} onChange={setPreviewed} onApply={savePracticeStyle} />\n<StyleChooser canApply={isAdmin} styles={STYLES} defaultValue=\"classic\" />",
      "readme": "src/components/StyleChooser/README.md",
      "storybook": "basic-layout-stylechooser--docs"
    },
    {
      "name": "SuccessDialog",
      "layer": "basic",
      "group": "Feedback",
      "summary": "SuccessDialog confirms a major completed task with a green check, an \"... Successfully\" title and an Okay button.",
      "import": "import { SuccessDialog } from 'health-components';",
      "element": {
        "tag": "co-success-dialog",
        "events": [
          "co-okay",
          "co-secondary",
          "co-close"
        ],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "title",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "\"... Successfully\" title, such as \"Electronic Claim Submitted Successfully\". Required.",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Body: what happens next",
          "callback": false
        },
        {
          "name": "okayLabel",
          "type": "string",
          "required": false,
          "default": "\"Okay\"",
          "allowedValues": null,
          "description": "Okay button label",
          "callback": false
        },
        {
          "name": "onOkay",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Okay handler",
          "callback": true
        },
        {
          "name": "secondary",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Secondary button label, such as \"Add Another Patient\"",
          "callback": false
        },
        {
          "name": "onSecondary",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Secondary button handler",
          "callback": true
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "true",
          "allowedValues": null,
          "description": "Whether the dialog is shown",
          "callback": false
        },
        {
          "name": "onClose",
          "type": "() => void",
          "required": false,
          "default": "`onOkay`",
          "allowedValues": null,
          "description": "Called on Escape",
          "callback": true
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Render in place for docs",
          "callback": false
        }
      ],
      "whenToUse": [
        "End of a multi-step flow: claim submitted, patient added, ERA posted, check-in complete."
      ],
      "whenNotToUse": [
        "Small saves: Toast."
      ],
      "accessibility": [
        "alertdialog; Okay gets focus.",
        "The check is white on `success` (an icon, 3:1 rule)."
      ],
      "example": "<SuccessDialog title=\"Electronic Claim Submitted Successfully\" onOkay={close}>The 277CA usually arrives within 24 hours.</SuccessDialog>",
      "readme": "src/components/SuccessDialog/README.md",
      "storybook": "basic-feedback-successdialog--docs"
    },
    {
      "name": "SuperbillTable",
      "layer": "complex",
      "group": "Revenue",
      "summary": "SuperbillTable is the tick-box fee sheet grouped by visit type with fees and a running total.",
      "import": "import { SuperbillTable } from 'health-components';",
      "element": {
        "tag": "co-superbill-table",
        "events": [
          "co-selected-change",
          "co-print",
          "co-send"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "groups",
          "type": "SuperbillGroup[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Fee sheet sections. Required",
          "callback": false
        },
        {
          "name": "selected",
          "type": "string[]",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled selected codes",
          "callback": false
        },
        {
          "name": "defaultSelected",
          "type": "string[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initially selected codes when uncontrolled",
          "callback": false
        },
        {
          "name": "onSelectedChange",
          "type": "(codes: string[]) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with the new list of selected codes",
          "callback": true
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title (patient, date, specialty)",
          "callback": false
        },
        {
          "name": "onPrint",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Print is pressed",
          "callback": true
        },
        {
          "name": "onSend",
          "type": "(codes: string[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the selected codes when Send to Billing is pressed",
          "callback": true
        }
      ],
      "whenToUse": [
        "Paper-style coding at checkout in small practices."
      ],
      "whenNotToUse": [
        "Full claim edit: ClaimForm."
      ],
      "accessibility": [
        "Real checkboxes with labels."
      ],
      "example": "<SuperbillTable groups={feeSheet} defaultSelected={[\"99214\"]} onSend={sendToBilling} />",
      "readme": "src/components/SuperbillTable/README.md",
      "storybook": "complex-revenue-superbilltable--docs"
    },
    {
      "name": "SurgicalSafetyChecklist",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "SurgicalSafetyChecklist runs the WHO Surgical Safety Checklist in its three phases, Sign In, Time Out and Sign Out, each confirmed by the team before the next unlocks.",
      "import": "import { SurgicalSafetyChecklist } from 'health-components';",
      "element": {
        "tag": "co-surgical-safety-checklist",
        "events": [
          "co-checked-change",
          "co-confirm",
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "checked",
          "type": "Record<string, boolean>",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Checked items (controlled), keyed phase + index ('signin0')",
          "callback": false
        },
        {
          "name": "defaultChecked",
          "type": "Record<string, boolean>",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Initially checked items (uncontrolled), keyed phase + index ('signin0')",
          "callback": false
        },
        {
          "name": "onCheckedChange",
          "type": "(checked: Record<string, boolean>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with every checked item when one changes",
          "callback": true
        },
        {
          "name": "confirmed",
          "type": "SafetyConfirmations",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Phases already confirmed, with their time 'HH:MM' (initial state)",
          "callback": false
        },
        {
          "name": "clock",
          "type": "string",
          "required": false,
          "default": "the device clock",
          "allowedValues": null,
          "description": "Time 'HH:MM' stamped on a new confirmation",
          "callback": false
        },
        {
          "name": "mismatch",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Site or procedure mismatch: shows a red stop alert",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Review only: nothing can be checked or confirmed",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "'WHO checklist, adapted. Each phase is confirmed aloud by the team.'",
          "allowedValues": null,
          "description": "Line under the title",
          "callback": false
        },
        {
          "name": "onConfirm",
          "type": "(phase: SafetyPhase, time: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when the team confirms a phase, with the time stamped",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "In the OR on the room display or the circulator's workstation."
      ],
      "whenNotToUse": [
        "Pre-op nursing assessment: a form."
      ],
      "accessibility": [
        "Each phase is a labelled section; locked phases say Locked in text.",
        "Confirm stays disabled with a help line until every item is checked."
      ],
      "example": "<SurgicalSafetyChecklist confirmed={{ signin: \"07:41\" }} clock={nowHHMM} onConfirm={logPhase} />",
      "readme": "src/components/SurgicalSafetyChecklist/README.md",
      "storybook": "complex-ed-periop-surgicalsafetychecklist--docs"
    },
    {
      "name": "Switch",
      "layer": "basic",
      "group": "Selection",
      "summary": "Switch turns a setting on or off immediately, such as \"Sidebar starts collapsed\" or \"Allow online booking\".",
      "import": "import { Switch } from 'health-components';",
      "element": {
        "tag": "co-switch",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": [
          "label",
          "description"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "ReactNode",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label. Required",
          "callback": false
        },
        {
          "name": "checked",
          "type": "boolean",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "On state (controlled)",
          "callback": false
        },
        {
          "name": "defaultChecked",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial on state (uncontrolled)",
          "callback": false
        },
        {
          "name": "description",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Help text under the label",
          "callback": false
        },
        {
          "name": "row",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Settings-row layout with a top border and 56px height",
          "callback": false
        },
        {
          "name": "disabled",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Disables the switch",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(on: boolean) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new state",
          "callback": true
        },
        {
          "name": "className",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Class on the wrapping row.",
          "callback": false
        }
      ],
      "whenToUse": [
        "Settings that apply straight away."
      ],
      "whenNotToUse": [
        "A choice that only applies after Save in a form: Checkbox."
      ],
      "accessibility": [
        "role switch with aria-checked; labelled by its text.",
        "The on state is green AND the knob moves right, so colour is not the only cue."
      ],
      "example": "<Switch label=\"Sidebar starts collapsed\" description=\"Clinical Sidebar only.\" checked={collapsed} onChange={setCollapsed} />",
      "readme": "src/components/Switch/README.md",
      "storybook": "basic-selection-switch--docs"
    },
    {
      "name": "Tabs",
      "layer": "basic",
      "group": "Navigation",
      "summary": "Tabs switch between views of the same record or list: line tabs under a header, or pill tabs, both with optional counts.",
      "import": "import { Tabs } from 'health-components';",
      "element": {
        "tag": "co-tabs",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "TabItem[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The tabs. Required.",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Selected tab id (controlled)",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "the first tab",
          "allowedValues": null,
          "description": "Initially selected tab id",
          "callback": false
        },
        {
          "name": "variant",
          "type": "TabsVariant",
          "required": false,
          "default": "'line'",
          "allowedValues": [
            "pill",
            "line"
          ],
          "description": "'line' under page or card titles, 'pill' inside cards and toolbars",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "aria-label of the tablist",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(id: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the new tab id",
          "callback": true
        }
      ],
      "whenToUse": [
        "Views of one thing: claim Overview, Lines, History; queue All, Mine, Overdue."
      ],
      "whenNotToUse": [
        "Moving through steps: Stepper.",
        "Separate screens in a chart: SectionNav."
      ],
      "accessibility": [
        "tablist, tab, aria-selected; arrow keys move between tabs (roving tabindex).",
        "Home and End jump to the first and last tab; disabled tabs are skipped. Give items a `panelId` to set aria-controls; each tab's id is `<id>-<item.id>` for the panel's aria-labelledby."
      ],
      "example": "<Tabs items={[{ id: \"o\", label: \"Overview\" }, { id: \"l\", label: \"Lines\", count: 3 }]} value={tab} onChange={setTab} />",
      "readme": "src/components/Tabs/README.md",
      "storybook": "basic-navigation-tabs--docs"
    },
    {
      "name": "TaskCard",
      "layer": "complex",
      "group": "Work queues",
      "summary": "TaskCard is one staff task with done check, patient, due date, overdue tag, category and owner.",
      "import": "import { TaskCard } from 'health-components';",
      "element": {
        "tag": "co-task-card",
        "events": [
          "co-done-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "task",
          "type": "TaskCardData",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "{title, patient?, due?, overdue?, done?, tag?, owner}; required",
          "callback": false
        },
        {
          "name": "done",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled, starts at `task.done`)",
          "allowedValues": null,
          "description": "Controlled done state",
          "callback": false
        },
        {
          "name": "onDoneChange",
          "type": "(done: boolean, task: TaskCardData) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the done check changes",
          "callback": true
        }
      ],
      "whenToUse": [
        "Task boards and home dashboards."
      ],
      "whenNotToUse": [
        "Clinical results: InboxItem."
      ],
      "accessibility": [
        "Checkbox named after the task."
      ],
      "example": "<TaskCard task={{ title: \"Call back about MRI auth\", patient: \"Ralph Edwards\", due: \"Today 3 PM\", owner: \"Sam Patel\", tag: \"Prior Auth\" }} />",
      "readme": "src/components/TaskCard/README.md",
      "storybook": "complex-work-queues-taskcard--docs"
    },
    {
      "name": "TelehealthCallFrame",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "TelehealthCallFrame is the video visit frame: waiting room, live call, weak connection, controls and the consent and billing note.",
      "import": "import { TelehealthCallFrame } from 'health-components';",
      "element": {
        "tag": "co-telehealth-call-frame",
        "events": [
          "co-muted-change",
          "co-camera-off-change",
          "co-chat",
          "co-admit",
          "co-end"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "remote",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Remote participant, e.g. \"Nora Scott\". Required",
          "callback": false
        },
        {
          "name": "state",
          "type": "TelehealthCallState",
          "required": false,
          "default": "'live'",
          "allowedValues": [
            "waiting",
            "live",
            "poor"
          ],
          "description": "'waiting' (waiting room, Admit Patient) | 'live' (End Visit) | 'poor' (weak connection)",
          "callback": false
        },
        {
          "name": "elapsed",
          "type": "string",
          "required": false,
          "default": "\"00:00\"",
          "allowedValues": null,
          "description": "Elapsed call time",
          "callback": false
        },
        {
          "name": "consent",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the consent, location and billing note",
          "callback": false
        },
        {
          "name": "location",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient location for the visit",
          "callback": false
        },
        {
          "name": "pos",
          "type": "string",
          "required": false,
          "default": "\"10\"",
          "allowedValues": null,
          "description": "Place of service code for the billing note",
          "callback": false
        },
        {
          "name": "muted",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled microphone muted state",
          "callback": false
        },
        {
          "name": "defaultMuted",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial muted state when uncontrolled",
          "callback": false
        },
        {
          "name": "onMutedChange",
          "type": "(muted: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when Mute is toggled",
          "callback": true
        },
        {
          "name": "cameraOff",
          "type": "boolean",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled camera off state",
          "callback": false
        },
        {
          "name": "defaultCameraOff",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initial camera off state when uncontrolled",
          "callback": false
        },
        {
          "name": "onCameraOffChange",
          "type": "(cameraOff: boolean) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called when the camera button is toggled",
          "callback": true
        },
        {
          "name": "onChat",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Chat is pressed",
          "callback": true
        },
        {
          "name": "onAdmit",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Admit Patient is pressed (waiting state)",
          "callback": true
        },
        {
          "name": "onEnd",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when End Visit is pressed (live and poor states)",
          "callback": true
        }
      ],
      "whenToUse": [
        "Provider and patient video visits."
      ],
      "whenNotToUse": [
        "Phone-only visits."
      ],
      "accessibility": [
        "Controls are labelled icon buttons, 44px."
      ],
      "example": "<TelehealthCallFrame remote=\"Nora Scott\" state=\"live\" elapsed=\"12:41\" consent location=\"Home, Chicago IL\" />",
      "readme": "src/components/TelehealthCallFrame/README.md",
      "storybook": "complex-scheduling-telehealthcallframe--docs"
    },
    {
      "name": "TextArea",
      "layer": "basic",
      "group": "Inputs",
      "summary": "TextArea takes multi-line text such as a reason for visit, a denial note or a message to the patient.",
      "import": "import { TextArea } from 'health-components';",
      "element": {
        "tag": "co-text-area",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; required",
          "callback": false
        },
        {
          "name": "rows",
          "type": "number",
          "required": false,
          "default": "3",
          "allowedValues": null,
          "description": "Visible rows",
          "callback": false
        },
        {
          "name": "maxLength",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Maximum characters; shows a live \"n / max\" counter",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled value",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial value (uncontrolled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(value: string, event: ChangeEvent<HTMLTextAreaElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the value and the change event",
          "callback": true
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message (as TextField)",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Muted hint under the field (as TextField)",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk plus aria-required (as TextField)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Read-only lock state (as TextField)",
          "callback": false
        },
        {
          "name": "lockMessage",
          "type": "string",
          "required": false,
          "default": "'Your role can view but not edit'",
          "allowedValues": null,
          "description": "Lock line text when readOnly",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Notes, reasons, appeal letters, messages."
      ],
      "whenNotToUse": [
        "Structured clinical data that should be coded (diagnoses, allergies): use Combobox."
      ],
      "accessibility": [
        "The counter is aria-live polite so typing is not interrupted."
      ],
      "example": "<TextArea label=\"Reason for Visit\" required maxLength={500} value={reason} onChange={setReason} />",
      "readme": "src/components/TextArea/README.md",
      "storybook": "basic-inputs-textarea--docs"
    },
    {
      "name": "TextField",
      "layer": "basic",
      "group": "Inputs",
      "summary": "TextField is a labelled one-line input with masks for phone, SSN, NPI, ZIP and EIN, plus error, helper, required and read-only lock states.",
      "import": "import { TextField } from 'health-components';",
      "element": {
        "tag": "co-text-field",
        "events": [
          "co-change",
          "co-input"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Visible label; required",
          "callback": false
        },
        {
          "name": "mask",
          "type": "MaskKind",
          "required": false,
          "default": "none",
          "allowedValues": [
            "ssn",
            "npi",
            "phone",
            "date",
            "zip",
            "ein"
          ],
          "description": "'phone' | 'ssn' | 'npi' | 'zip' | 'ein' | 'date'",
          "callback": false
        },
        {
          "name": "value",
          "type": "string",
          "required": false,
          "default": "undefined (uncontrolled)",
          "allowedValues": null,
          "description": "Controlled value",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string",
          "required": false,
          "default": "\"\"",
          "allowedValues": null,
          "description": "Initial value (uncontrolled), formatted with the mask",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(value: string, event: ChangeEvent<HTMLInputElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the (masked) value and the change event",
          "callback": true
        },
        {
          "name": "error",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Error message: red border, message under the field with role alert, aria-invalid",
          "callback": false
        },
        {
          "name": "helper",
          "type": "string",
          "required": false,
          "default": "the mask hint",
          "allowedValues": null,
          "description": "Muted hint under the field",
          "callback": false
        },
        {
          "name": "required",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Red asterisk plus aria-required",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Read-only lock state: grey fill, lock icon and lock message",
          "callback": false
        },
        {
          "name": "lockMessage",
          "type": "string",
          "required": false,
          "default": "'Your role can view but not edit'",
          "allowedValues": null,
          "description": "Lock line text when readOnly",
          "callback": false
        },
        {
          "name": "size",
          "type": "TextFieldSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "lg"
          ],
          "description": "'sm' 30px | 'md' 36px | 'lg' 48px (kiosk)",
          "callback": false
        },
        {
          "name": "iconLeft",
          "type": "IconName",
          "required": false,
          "default": "none",
          "allowedValues": [
            "sort",
            "info",
            "lock",
            "alert",
            "paid",
            "pill",
            "x",
            "check",
            "chevron-down",
            "chevron-up",
            "chevron-right",
            "chevron-left",
            "search",
            "plus",
            "minus",
            "more",
            "more-h",
            "calendar",
            "clock",
            "video",
            "user",
            "users",
            "bell",
            "alert-circle",
            "upload",
            "download",
            "home",
            "message",
            "settings",
            "file",
            "dollar",
            "heart",
            "grid",
            "menu",
            "sparkle",
            "card",
            "eye",
            "sort-up",
            "sort-down",
            "flask",
            "chart",
            "shield",
            "code",
            "phone",
            "send",
            "mic",
            "camera",
            "unpaid",
            "collapse",
            "expand",
            "inbox",
            "building",
            "trash"
          ],
          "description": "Icon inside the input on the left",
          "callback": false
        },
        {
          "name": "suffix",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Unit text inside the input on the right, such as \"units\"",
          "callback": false
        },
        {
          "name": "style",
          "type": "CSSProperties",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Inline style of the root",
          "callback": false
        }
      ],
      "whenToUse": [
        "Short free text and identifiers: name, phone, member ID, NPI, policy number."
      ],
      "whenNotToUse": [
        "Choosing from a known list: Select or Combobox.",
        "Dates: DatePicker.",
        "More than one line: TextArea."
      ],
      "accessibility": [
        "Every field has a visible label; placeholder is an example, never the label.",
        "Error and helper text are linked with aria-describedby; aria-invalid is set on error.",
        "A mask only arranges digits into the pattern. It proves the shape, not that the NPI or ZIP is real; check those on save and say so in the error (\"This NPI is not in NPPES\").",
        "Input borders use `border`, which is below 3:1 on `surface` in every light style (source value kept). The label and the field fill carry the boundary; see README, Accessibility."
      ],
      "example": "<TextField label=\"Mobile Phone\" mask=\"phone\" required value={phone} onChange={setPhone} error={errors.phone} />\n<TextField label=\"Member ID\" value={memberId} readOnly={access === \"view\"} />",
      "readme": "src/components/TextField/README.md",
      "storybook": "basic-inputs-textfield--docs"
    },
    {
      "name": "Timeline",
      "layer": "basic",
      "group": "Data display",
      "summary": "Timeline lists the steps of a prior authorization, referral or claim in order, with done, current, pending and failed states.",
      "import": "import { Timeline } from 'health-components';",
      "element": {
        "tag": "co-timeline",
        "events": [],
        "slots": []
      },
      "aliases": [
        "PATimeline"
      ],
      "props": [
        {
          "name": "items",
          "type": "ReadonlyArray<TimelineItem>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Steps in order. Required",
          "callback": false
        }
      ],
      "whenToUse": [
        "Status history: PA Submitted, In Review, Pended, Approved."
      ],
      "whenNotToUse": [
        "Free-form activity feeds with many actors: a table."
      ],
      "accessibility": [
        "Ordered list; the current step has aria-current=\"step\".",
        "Each state also has a different icon or fill."
      ],
      "example": "<Timeline items={[{ title: \"Submitted\", time: \"10/01/2026\", by: \"Sam Patel\", status: \"done\", tag: \"Submitted\" }, { title: \"In Review\", status: \"current\" }]} />",
      "readme": "src/components/Timeline/README.md",
      "storybook": "basic-data-display-timeline--docs"
    },
    {
      "name": "TimeSlotPicker",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "TimeSlotPicker shows open times as a grid of slots, with booked, held, available and selected states, and an optional day strip.",
      "import": "import { TimeSlotPicker } from 'health-components';",
      "element": {
        "tag": "co-time-slot-picker",
        "events": [
          "co-change",
          "co-day-change"
        ],
        "slots": []
      },
      "aliases": [
        "SlotPicker"
      ],
      "props": [
        {
          "name": "slots",
          "type": "TimeSlot[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{time, state: available|booked|held|blocked}>",
          "callback": false
        },
        {
          "name": "days",
          "type": "TimeSlotDay[]",
          "required": false,
          "default": "none (no day strip)",
          "allowedValues": null,
          "description": "Array<{id, weekday, date, disabled?}>",
          "callback": false
        },
        {
          "name": "value",
          "type": "string | null",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Selected time (controlled)",
          "callback": false
        },
        {
          "name": "defaultValue",
          "type": "string | null",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Initially selected time (uncontrolled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(time: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(time) => void, called when a slot is chosen",
          "callback": true
        },
        {
          "name": "day",
          "type": "string",
          "required": false,
          "default": "undefined",
          "allowedValues": null,
          "description": "Selected day id (controlled)",
          "callback": false
        },
        {
          "name": "defaultDay",
          "type": "string",
          "required": false,
          "default": "the first day",
          "allowedValues": null,
          "description": "Initially selected day id (uncontrolled)",
          "callback": false
        },
        {
          "name": "onDayChange",
          "type": "(day: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "(dayId) => void, called when a day is chosen",
          "callback": true
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "\"Available times\" (not shown)",
          "allowedValues": null,
          "description": "Group label shown above the grid, e.g. provider and visit length",
          "callback": false
        }
      ],
      "whenToUse": [
        "Booking, rescheduling, patient self-booking."
      ],
      "whenNotToUse": [
        "Free-form time entry for a past encounter: TextField with a time mask."
      ],
      "accessibility": [
        "Slots are a radiogroup; each label includes its state.",
        "Booked differs by fill, strike and disabled state, not colour alone."
      ],
      "example": "<TimeSlotPicker label=\"Priya Shah MD . Follow-Up 20 min\" slots={slots} days={days} onChange={setTime} />",
      "readme": "src/components/TimeSlotPicker/README.md",
      "storybook": "complex-scheduling-timeslotpicker--docs"
    },
    {
      "name": "Toast",
      "layer": "basic",
      "group": "Feedback",
      "summary": "Toast confirms a finished action at the bottom of the screen for about 2.8 seconds, in the \"... Successfully\" voice.",
      "import": "import { Toast } from 'health-components';",
      "element": {
        "tag": "co-toast",
        "events": [
          "co-action",
          "co-dismiss"
        ],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "message",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Message in the \"... Successfully\" voice (\"Draft Saved Successfully\"). Falls back to `children`.",
          "callback": false
        },
        {
          "name": "tone",
          "type": "ToastTone",
          "required": false,
          "default": "'neutral'",
          "allowedValues": [
            "success",
            "error",
            "neutral"
          ],
          "description": "'neutral' | 'success' | 'error'",
          "callback": false
        },
        {
          "name": "action",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "One text action, such as \"Undo\"",
          "callback": false
        },
        {
          "name": "onAction",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Action handler",
          "callback": true
        },
        {
          "name": "onDismiss",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shows a Dismiss (x) button that calls this",
          "callback": true
        },
        {
          "name": "inline",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Static, rendered in place (previews, docs, and inside ToastProvider); otherwise fixed at the bottom through a portal",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactNode",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Message content when `message` is not set",
          "callback": false
        }
      ],
      "whenToUse": [
        "Background confirmation that needs no action."
      ],
      "whenNotToUse": [
        "Errors the user must fix: field error or Alert.",
        "Big completions (claim submitted): SuccessDialog."
      ],
      "accessibility": [
        "role status with aria-live polite; errors role alert.",
        "Do not auto-hide a toast that holds an action in under 5 seconds."
      ],
      "example": "{toast && <Toast tone=\"success\" message=\"Draft Saved Successfully\" />}  // hide after 2800 ms",
      "readme": "src/components/Toast/README.md",
      "storybook": "basic-feedback-toast--docs"
    },
    {
      "name": "Tooltip",
      "layer": "basic",
      "group": "Overlays",
      "summary": "Tooltip shows a short label for an icon or truncated text on hover and keyboard focus.",
      "import": "import { Tooltip } from 'health-components';",
      "element": {
        "tag": "co-tooltip",
        "events": [],
        "slots": [
          "(default)"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Tooltip text; required",
          "callback": false
        },
        {
          "name": "children",
          "type": "ReactElement<{ 'aria-describedby'?: string }>",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "One focusable element (Button, IconButton, link); required",
          "callback": false
        },
        {
          "name": "placement",
          "type": "TooltipPlacement",
          "required": false,
          "default": "'top'",
          "allowedValues": [
            "right",
            "bottom",
            "top"
          ],
          "description": "'top' | 'bottom' | 'right'",
          "callback": false
        },
        {
          "name": "open",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Keeps the tooltip shown (docs, onboarding)",
          "callback": false
        },
        {
          "name": "id",
          "type": "string",
          "required": false,
          "default": "generated",
          "allowedValues": null,
          "description": "id of the tooltip element",
          "callback": false
        },
        {
          "name": "className",
          "type": "string",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Class on the wrapper",
          "callback": false
        }
      ],
      "whenToUse": [
        "Naming icon-only controls, explaining an abbreviation (POS, DOS)."
      ],
      "whenNotToUse": [
        "Anything the user must read to finish the task."
      ],
      "accessibility": [
        "Shown on focus as well as hover; linked with aria-describedby.",
        "Text is `toast-ink` on `toast-bg`."
      ],
      "example": "<Tooltip label=\"Print chart\"><IconButton icon=\"file\" label=\"Print chart\" /></Tooltip>",
      "readme": "src/components/Tooltip/README.md",
      "storybook": "basic-overlays-tooltip--docs"
    },
    {
      "name": "TopBar",
      "layer": "complex",
      "group": "Navigation",
      "summary": "TopBar is the 52px app header in all four styles: Classic navy bar with module links, patient search (Sidebar), patient tabs (Rail) or the Jump to anything bar (Command), then Viewing as, notifications and the account.",
      "import": "import { TopBar } from 'health-components';",
      "element": {
        "tag": "co-top-bar",
        "events": [
          "co-role-change",
          "co-open-palette",
          "co-open-modules",
          "co-navigate",
          "co-search-change",
          "co-quick-add",
          "co-notifications",
          "co-account"
        ],
        "slots": [
          "tabs"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "variant",
          "type": "TopBarVariant",
          "required": false,
          "default": "'classic'",
          "allowedValues": [
            "classic",
            "sidebar",
            "rail",
            "command"
          ],
          "description": "'classic' navy bar with module links | 'sidebar' patient search | 'rail' patient tabs | 'command' Jump to anything bar",
          "callback": false
        },
        {
          "name": "role",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Previewed role; shows RolePill when set",
          "callback": false
        },
        {
          "name": "roles",
          "type": "RoleOption[]",
          "required": false,
          "default": "none (the current role only)",
          "allowedValues": null,
          "description": "RolePill roles",
          "callback": false
        },
        {
          "name": "onRoleChange",
          "type": "(role: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the role chosen in RolePill",
          "callback": true
        },
        {
          "name": "notifications",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Unread notification count",
          "callback": false
        },
        {
          "name": "quickAdd",
          "type": "string",
          "required": false,
          "default": "\"New\"",
          "allowedValues": null,
          "description": "Quick add button label (not in classic)",
          "callback": false
        },
        {
          "name": "product",
          "type": "string",
          "required": false,
          "default": "\"CareOS\"",
          "allowedValues": null,
          "description": "Product name",
          "callback": false
        },
        {
          "name": "user",
          "type": "string",
          "required": false,
          "default": "\"Jordan Lee\"",
          "allowedValues": null,
          "description": "Signed-in user, shown as initials",
          "callback": false
        },
        {
          "name": "tabs",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Rail only: the PatientTabs",
          "callback": false
        },
        {
          "name": "module",
          "type": "string",
          "required": false,
          "default": "\"Modules\"",
          "allowedValues": null,
          "description": "Command only: current module",
          "callback": false
        },
        {
          "name": "onOpenPalette",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Command only: opens the CommandPalette",
          "callback": true
        },
        {
          "name": "onOpenModules",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Command only: opens the module switcher",
          "callback": true
        },
        {
          "name": "links",
          "type": "string[]",
          "required": false,
          "default": "Home, Schedule, Patients, Billing, Reports, Settings",
          "allowedValues": null,
          "description": "Classic only: module links",
          "callback": false
        },
        {
          "name": "active",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Classic only: current module link",
          "callback": false
        },
        {
          "name": "onNavigate",
          "type": "(link: string, event: MouseEvent<HTMLAnchorElement>) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Classic only: called when a module link is clicked",
          "callback": true
        },
        {
          "name": "linkHref",
          "type": "(link: string) => string",
          "required": false,
          "default": "none (links call onNavigate)",
          "allowedValues": null,
          "description": "Classic only: URL of each module link, for real navigation",
          "callback": false
        },
        {
          "name": "onSearchChange",
          "type": "(query: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Sidebar only: called as the patient search text changes",
          "callback": true
        },
        {
          "name": "onQuickAdd",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Quick add handler",
          "callback": true
        },
        {
          "name": "onNotifications",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Notifications button handler",
          "callback": true
        },
        {
          "name": "onAccount",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Account button handler",
          "callback": true
        }
      ],
      "whenToUse": [
        "Top of every desktop staff screen."
      ],
      "whenNotToUse": [
        "Phone, portal and kiosk screens: MobileHeader."
      ],
      "accessibility": [
        "header landmark; search input labelled \"Search patients by name, MRN or DOB\"; account button \"Account menu\"."
      ],
      "example": "<TopBar variant={uiStyle} role={previewRole} roles={ROLES} notifications={unread} />  // uiStyle: classic | sidebar | rail | command",
      "readme": "src/components/TopBar/README.md",
      "storybook": "complex-navigation-topbar--docs"
    },
    {
      "name": "TriageForm",
      "layer": "complex",
      "group": "ED & periop",
      "summary": "TriageForm records the chief complaint, arrival mode and triage vitals, and suggests an Emergency Severity Index (ESI v4) level that the nurse confirms or overrides.",
      "import": "import { TriageForm } from 'health-components';",
      "element": {
        "tag": "co-triage-form",
        "events": [
          "co-submit",
          "co-save-draft"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "defaultValues",
          "type": "TriageValues",
          "required": false,
          "default": "{}",
          "allowedValues": null,
          "description": "Initial answers (the form is uncontrolled)",
          "callback": false
        },
        {
          "name": "isolation",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Positive isolation screen name, shown as a warning",
          "callback": false
        },
        {
          "name": "showErrors",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Marks a missing chief complaint",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Signed triage: every field locked, no actions",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Card subtitle (patient, arrival time)",
          "callback": false
        },
        {
          "name": "onSubmit",
          "type": "(values: TriageSubmitValues) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Complete Triage with the values and the final ESI",
          "callback": true
        },
        {
          "name": "onSaveDraft",
          "type": "(values: TriageSubmitValues) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called by Save Draft",
          "callback": true
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'ed' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        }
      ],
      "whenToUse": [
        "Triage at the ED front door or in a triage room."
      ],
      "whenNotToUse": [
        "Repeat vitals in a room: VitalsPanel. Pediatric triage with PAT: extend the danger-zone limits first."
      ],
      "accessibility": [
        "Each vital input has a visible label and unit; its flag reads out next to it.",
        "The ESI result is a polite live region.",
        "Decision points are checkboxes with plain descriptions."
      ],
      "example": "<TriageForm onSubmit={saveTriage} defaultValues={{ complaint: \"Chest pressure\", arrival: \"EMS ground\" }} />",
      "readme": "src/components/TriageForm/README.md",
      "storybook": "complex-ed-periop-triageform--docs"
    },
    {
      "name": "UnitToggle",
      "layer": "complex",
      "group": "Clinical values",
      "summary": "UnitToggle shows a stored measurement in the unit the reader picks (lb or kg, in or cm, °F or °C, mg/dL or mmol/L), converting value and range with exact factors.",
      "import": "import { UnitToggle } from 'health-components';",
      "element": {
        "tag": "co-unit-toggle",
        "events": [
          "co-change"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "kind",
          "type": "UnitToggleKind",
          "required": true,
          "default": null,
          "allowedValues": [
            "weight",
            "height",
            "temp",
            "glucose",
            "creatinine",
            "a1c"
          ],
          "description": "Measure family: 'weight' | 'height' | 'temp' | 'glucose' | 'creatinine' | 'a1c'; required",
          "callback": false
        },
        {
          "name": "value",
          "type": "number | null",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Stored value, in `unit`; required",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "UCUM code of the stored value ('kg', '[lb_av]', 'Cel', 'mg/dL'...); required",
          "callback": false
        },
        {
          "name": "defaultUnit",
          "type": "string",
          "required": false,
          "default": "`unit`",
          "allowedValues": null,
          "description": "Unit shown first (uncontrolled)",
          "callback": false
        },
        {
          "name": "displayUnit",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Unit shown (controlled)",
          "callback": false
        },
        {
          "name": "onChange",
          "type": "(unit: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the UCUM code the reader picks",
          "callback": true
        },
        {
          "name": "showStored",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows \"Stored as ...\" under the converted value",
          "callback": false
        },
        {
          "name": "label",
          "type": "string",
          "required": false,
          "default": "the measure label",
          "allowedValues": null,
          "description": "Label",
          "callback": false
        },
        {
          "name": "size",
          "type": "ClinicalValueSize",
          "required": false,
          "default": "'md'",
          "allowedValues": [
            "sm",
            "md",
            "lg"
          ],
          "description": "'sm' | 'md' | 'lg'",
          "callback": false
        },
        {
          "name": "measure",
          "type": "string",
          "required": false,
          "default": "`kind`",
          "allowedValues": null,
          "description": "Measure key when it differs from `kind`",
          "callback": false
        },
        {
          "name": "showMeta",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Shows the range and meta line (in the measure's own unit only)",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "the global context, else 'outpatient'",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use; the lab range on a result still wins",
          "callback": false
        },
        {
          "name": "defaultRangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "context, used only when no prop, provider or global context applies; default none",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "The containing set's",
          "callback": false
        },
        {
          "name": "ageYears",
          "type": "number",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Age in years for the pediatric bands",
          "callback": false
        }
      ],
      "whenToUse": [
        "Weight, height and temperature where staff and patients use different units.",
        "Glucose, creatinine and A1c for clinicians trained on SI units."
      ],
      "whenNotToUse": [
        "Data entry: the input stores one canonical unit; use TextField with a unit suffix.",
        "Doses: never convert a dose for display."
      ],
      "accessibility": [
        "Unit buttons are a labelled group of toggle buttons with aria-pressed.",
        "The converted value keeps its flag and range."
      ],
      "example": "<UnitToggle kind=\"weight\" value={36.3} unit=\"kg\" defaultUnit=\"[lb_av]\" showStored />",
      "readme": "src/components/UnitToggle/README.md",
      "storybook": "complex-clinical-values-unittoggle--docs"
    },
    {
      "name": "VisitNoteEditor",
      "layer": "subjective",
      "group": null,
      "summary": "VisitNoteEditor is the section-by-section visit note with AI Scribe drafts and ICD-10 and CPT search, from Draft to Signed.",
      "import": "import { VisitNoteEditor } from 'health-components';",
      "element": {
        "tag": "co-visit-note-editor",
        "events": [
          "co-diagnoses-change",
          "co-procedures-change",
          "co-sign",
          "co-ai-draft",
          "co-save-draft",
          "co-section-change"
        ],
        "slots": []
      },
      "aliases": [
        "VisitNote"
      ],
      "props": [
        {
          "name": "sections",
          "type": "VisitNoteSection[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Array<{id, title, text?, ai?, required?, error?, rows?}>; required",
          "callback": false
        },
        {
          "name": "diagnoses",
          "type": "VisitNoteCode[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Diagnoses on the note (controlled)",
          "callback": false
        },
        {
          "name": "defaultDiagnoses",
          "type": "VisitNoteCode[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial diagnoses (uncontrolled)",
          "callback": false
        },
        {
          "name": "onDiagnosesChange",
          "type": "(codes: VisitNoteCode[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a diagnosis is added or removed",
          "callback": true
        },
        {
          "name": "procedures",
          "type": "VisitNoteCode[]",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Procedures on the note (controlled)",
          "callback": false
        },
        {
          "name": "defaultProcedures",
          "type": "VisitNoteCode[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Initial procedures (uncontrolled)",
          "callback": false
        },
        {
          "name": "onProceduresChange",
          "type": "(codes: VisitNoteCode[]) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when a procedure is added or removed",
          "callback": true
        },
        {
          "name": "icdOptions",
          "type": "VisitNoteCode[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "ICD-10 search options: Array<{code, label}>",
          "callback": false
        },
        {
          "name": "cptOptions",
          "type": "VisitNoteCode[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "CPT search options: Array<{code, label}>",
          "callback": false
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "\"Visit Note\"",
          "allowedValues": null,
          "description": "Heading",
          "callback": false
        },
        {
          "name": "meta",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Date, place and template line (\"10/09/2026 10:30 AM . Main Street Clinic . Primary Care SOAP\")",
          "callback": false
        },
        {
          "name": "signed",
          "type": "boolean",
          "required": false,
          "default": "uncontrolled",
          "allowedValues": null,
          "description": "Signed and locked (controlled)",
          "callback": false
        },
        {
          "name": "defaultSigned",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Initially signed (uncontrolled)",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Lock banner for roles without Edit clinical chart",
          "callback": false
        },
        {
          "name": "lockText",
          "type": "string",
          "required": false,
          "default": "\"Your role can view this note but not edit it.\"",
          "allowedValues": null,
          "description": "Lock banner text when readOnly",
          "callback": false
        },
        {
          "name": "onSign",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Sign Note",
          "callback": true
        },
        {
          "name": "onAiDraft",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Shows Draft with AI Scribe, which calls this",
          "callback": true
        },
        {
          "name": "onSaveDraft",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Save Draft",
          "callback": true
        },
        {
          "name": "onSectionChange",
          "type": "(id: string, text: string) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called with the section id and its new text as the user types or accepts an AI draft",
          "callback": true
        }
      ],
      "whenToUse": [
        "Writing and signing a visit note."
      ],
      "whenNotToUse": [
        "Viewing an old signed note in a list: the Encounters table."
      ],
      "accessibility": [
        "Each section textarea is named by its title.",
        "AI text is never saved without Accept."
      ],
      "example": "<VisitNoteEditor meta=\"10/09/2026 10:30 AM . Primary Care SOAP\" icdOptions={ICD10} cptOptions={CPT}\n  sections={[{ id: \"s\", title: \"Subjective\", required: true }, { id: \"a\", title: \"Assessment and Plan\", ai: draftText }]}\n  onSign={signNote} onAiDraft={runScribe} />",
      "readme": "src/components/VisitNoteEditor/README.md",
      "storybook": "subjective--docs"
    },
    {
      "name": "VitalSign",
      "layer": "complex",
      "group": "Clinical",
      "summary": "VitalSign is one vital tile: label, value, unit, High or Low flag (critical shaded), trend sparkline and time taken.",
      "import": "import { VitalSign } from 'health-components';",
      "element": {
        "tag": "co-vital-sign",
        "events": [],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "label",
          "type": "string",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Vital name (\"Blood pressure\"); required",
          "callback": false
        },
        {
          "name": "value",
          "type": "string | number",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "Reading (\"152/94\"); required",
          "callback": false
        },
        {
          "name": "unit",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Unit (\"mmHg\")",
          "callback": false
        },
        {
          "name": "flag",
          "type": "ResultFlag",
          "required": false,
          "default": "none",
          "allowedValues": [
            "L",
            "H",
            "LL",
            "HH"
          ],
          "description": "'H' | 'L' | 'HH' | 'LL'; critical flags shade the tile",
          "callback": false
        },
        {
          "name": "trend",
          "type": "number[]",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "number[]: earlier readings, oldest first, drawn as a sparkline",
          "callback": false
        },
        {
          "name": "taken",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Time taken or a note (\"10:12 AM\", \"52nd percentile\")",
          "callback": false
        }
      ],
      "whenToUse": [
        "Vitals panels and rooming."
      ],
      "whenNotToUse": [
        "Lab values: LabResultTable."
      ],
      "accessibility": [
        "Flag has a word and arrow, not only colour."
      ],
      "example": "<VitalSign label=\"Blood pressure\" value=\"152/94\" unit=\"mmHg\" flag=\"H\" trend={[132, 138, 145, 152]} taken=\"10:12 AM\" />",
      "readme": "src/components/VitalSign/README.md",
      "storybook": "complex-clinical-vitalsign--docs"
    },
    {
      "name": "VitalsPanel",
      "layer": "complex",
      "group": "Clinical",
      "summary": "VitalsPanel groups VitalSign tiles in a Card with Enter Vitals.",
      "import": "import { VitalsPanel } from 'health-components';",
      "element": {
        "tag": "co-vitals-panel",
        "events": [
          "co-enter-vitals"
        ],
        "slots": [
          "subtitle"
        ]
      },
      "aliases": [],
      "props": [
        {
          "name": "items",
          "type": "VitalSignProps[]",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "VitalSign props[]; required",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "ReactNode",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Line under the title (\"entered by Lisa Chen RN, 10:12 AM\")",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "Hides Enter Vitals",
          "callback": false
        },
        {
          "name": "onEnterVitals",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Enter Vitals clicked",
          "callback": true
        }
      ],
      "whenToUse": [
        "Chart summary, rooming."
      ],
      "whenNotToUse": [
        "Long-term graphs: LineChart."
      ],
      "accessibility": [
        "Grid of tiles in reading order."
      ],
      "example": "<VitalsPanel subtitle=\"Entered by Lisa Chen RN, 10:12 AM\" items={vitals} />",
      "readme": "src/components/VitalsPanel/README.md",
      "storybook": "complex-clinical-vitalspanel--docs"
    },
    {
      "name": "WaitlistRow",
      "layer": "complex",
      "group": "Scheduling",
      "summary": "WaitlistRow is one waitlisted patient with wanted window, priority, a matched opening and Offer Slot.",
      "import": "import { WaitlistRow } from 'health-components';",
      "element": {
        "tag": "co-waitlist-row",
        "events": [
          "co-offer",
          "co-text",
          "co-edit",
          "co-remove"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "item",
          "type": "WaitlistItem",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The waitlist entry. Required",
          "callback": false
        },
        {
          "name": "onOffer",
          "type": "(item: WaitlistItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called when Offer Slot is pressed (enabled only with a match)",
          "callback": true
        },
        {
          "name": "onText",
          "type": "(item: WaitlistItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Row menu: Text Patient",
          "callback": true
        },
        {
          "name": "onEdit",
          "type": "(item: WaitlistItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Row menu: Edit Preferences",
          "callback": true
        },
        {
          "name": "onRemove",
          "type": "(item: WaitlistItem) => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Row menu: Remove from Waitlist",
          "callback": true
        }
      ],
      "whenToUse": [
        "Filling cancellations."
      ],
      "whenNotToUse": [
        "Recalls: CareGapRow."
      ],
      "accessibility": [
        "Actions named with the patient."
      ],
      "example": "<WaitlistRow item={{ patient: \"Kristin Watson\", type: \"Annual Wellness\", provider: \"Any\", window: \"mornings this week\", since: \"09/30\", match: \"Thu 10/09 9:40 AM\" }} />",
      "readme": "src/components/WaitlistRow/README.md",
      "storybook": "complex-scheduling-waitlistrow--docs"
    },
    {
      "name": "WoundCareDoc",
      "layer": "complex",
      "group": "Inpatient nursing",
      "summary": "WoundCareDoc documents one wound: site, stage and cause, length, width and depth in cm with computed area and change since first measure, tissue mix, exudate, treatment and the measurement history.",
      "import": "import { WoundCareDoc } from 'health-components';",
      "element": {
        "tag": "co-wound-care-doc",
        "events": [
          "co-save",
          "co-add-photo"
        ],
        "slots": []
      },
      "aliases": [],
      "props": [
        {
          "name": "wound",
          "type": "Wound",
          "required": true,
          "default": null,
          "allowedValues": null,
          "description": "The wound; required",
          "callback": false
        },
        {
          "name": "history",
          "type": "WoundHistoryEntry[]",
          "required": false,
          "default": "[]",
          "allowedValues": null,
          "description": "Measurement history, oldest first",
          "callback": false
        },
        {
          "name": "readOnly",
          "type": "boolean",
          "required": false,
          "default": "false",
          "allowedValues": null,
          "description": "View only",
          "callback": false
        },
        {
          "name": "onSave",
          "type": "(current: WoundMeasure) => void",
          "required": false,
          "default": null,
          "allowedValues": null,
          "description": "Called with the current assessment on Save wound assessment",
          "callback": true
        },
        {
          "name": "onAddPhoto",
          "type": "() => void",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Called on Add photo",
          "callback": true
        },
        {
          "name": "title",
          "type": "string",
          "required": false,
          "default": "'Wound Care'",
          "allowedValues": null,
          "description": "Card title",
          "callback": false
        },
        {
          "name": "subtitle",
          "type": "string",
          "required": false,
          "default": "none",
          "allowedValues": null,
          "description": "Patient line",
          "callback": false
        },
        {
          "name": "rangeContext",
          "type": "RangeContextId",
          "required": false,
          "default": "'inpatient' when no global context is set",
          "allowedValues": [
            "outpatient",
            "inpatient",
            "ed",
            "pediatric",
            "pregnancy"
          ],
          "description": "Which shared reference range flags use",
          "callback": false
        }
      ],
      "whenToUse": [
        "Pressure injuries, surgical wounds, diabetic foot ulcers, venous ulcers."
      ],
      "whenNotToUse": [
        "Risk only, no wound: BradenScore.",
        "Body location picking: BodyMap."
      ],
      "accessibility": [
        "Inputs are labelled with their unit.",
        "Tissue bar has an aria-label listing each tissue and percent.",
        "Area change has a sign character, not only colour."
      ],
      "example": "<WoundCareDoc wound={sacrum} history={measurements} onSave={save} />",
      "readme": "src/components/WoundCareDoc/README.md",
      "storybook": "complex-inpatient-nursing-woundcaredoc--docs"
    }
  ]
}
