@mieweb/ui 0.11.0-dev.31 → 0.11.0-dev.33

package/dist/esheet.js

@@ -1,15 +1,15 @@
 import './chunk-GADJASST.js';
 import { parseEncounterMdy, DEFAULT_ENCOUNTER_VISIT_DEFINITION, createEncounterFormDefinition, ENCOUNTER_DOCUMENT_FIELD_ID, encounterDocumentResponse, createEncounterSnapshot, updateEncounterDocumentBody, getEncounterSectionFieldId, getEncounterMdyFields, getEncounterSectionFieldIds, getEncounterDocumentBody, renderEncounterMdy, validateEncounterVitals, validateEncounterPlan, validateEncounterConditions, validAssessmentItem, isEncounterDate, validateEncounterAllergyValue, validateEncounterMedicationValue, validateEncounterAssessment, validateEncounterResponses, getEncounterFieldId, validateEncounterDefinition } from './chunk-QNJEDBIN.js';
 export { DEFAULT_ENCOUNTER_VISIT_DEFINITION, ENCOUNTER_DOCUMENT_FIELD_ID, EXAMPLE_ENCOUNTER_VISIT_RESPONSES, createEncounterFormDefinition, createEncounterMdy, createEncounterSnapshot, encounterDocumentResponse, getEncounterConcerns, getEncounterDocumentBody, getEncounterFieldId, getEncounterMdyFields, getEncounterSectionFieldId, getEncounterSectionFieldIds, parseEncounterAssessment, parseEncounterConditions, parseEncounterMdy, parseEncounterPlan, parseEncounterVitals, refreshEncounterMdyLinks, renderEncounterMdy, updateEncounterDocumentBody, validAssessmentItem, validateEncounterAllergyValue, validateEncounterAssessment, validateEncounterConditions, validateEncounterDefinition, validateEncounterMedicationValue, validateEncounterPlan, validateEncounterResponses, validateEncounterVitals } from './chunk-QNJEDBIN.js';
-import { useCodeLookupConfig, CodeLookupContext, Assessment, ConditionEditor, ALLERGY_TYPE_LABELS, lookupToMedicationFields, doseFormToQuantityUnit, DateRangePicker, parseSig, normalizeConditionCodingSystem, MedicationReconciliation, AllergyManager } from './chunk-DG3CXR24.js';
+import { useCodeLookupConfig, CodeLookupContext, Assessment, ConditionEditor, ALLERGY_TYPE_LABELS, lookupToMedicationFields, doseFormToQuantityUnit, DateRangePicker, parseSig, normalizeConditionCodingSystem, MedicationReconciliation, AllergyManager } from './chunk-PYAK7XXD.js';
 import { ProblemList, currentAssertion } from './chunk-KSQQBFDQ.js';
 import './chunk-YFWDS6MX.js';
 import { ButtonGroup } from './chunk-BBLEGF5L.js';
 import { RadioGroup, Radio } from './chunk-EPSB4WTL.js';
 import { Label } from './chunk-I3WGZPI6.js';
 import { DateInput } from './chunk-I6Y2KLTZ.js';
-import { TextAreaRich, Textarea } from './chunk-L52HKEUD.js';
-import './chunk-JN2CL7MK.js';
+import { TextAreaRich, Textarea } from './chunk-NAQMIFUF.js';
+import './chunk-WEGKY2LY.js';
 import { MessagesProvider, useMessages } from './chunk-5YOT4DVH.js';
 import './chunk-OQWZYKJM.js';
 import { Select } from './chunk-VCI2Y7ST.js';
@@ -19,9 +19,10 @@ import './chunk-QYSUYB3S.js';
 import { Checkbox } from './chunk-753Z3NXL.js';
 import './chunk-TWQSMUE6.js';
 import './chunk-6NZXWKUE.js';
-import { RequiredMark, Input } from './chunk-3IMM2PM4.js';
+import { Input, RequiredMark } from './chunk-3IMM2PM4.js';
 import './chunk-YUMOM3KE.js';
 import './chunk-HNXLLDPN.js';
+import './chunk-HTZ27DGZ.js';
 import './chunk-4SMSH4OY.js';
 import { useEscapeKey } from './chunk-T4ME7QCT.js';
 import './chunk-62ZOA6PX.js';
@@ -45,7 +46,8 @@ import { EsheetRenderer } from '@esheet/renderer';
 export { EsheetRenderer } from '@esheet/renderer';
 import DOMPurify from 'dompurify';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { getFieldComponent, SectionField, registerFieldComponents, registerCustomFieldTypes } from '@esheet/fields';
+import { getFieldComponent, registerCustomFieldTypes, SectionField, registerFieldComponents } from '@esheet/fields';
+import { stringify } from 'yaml';
 export { EsheetBuilder } from '@esheet/builder';
 
 var HEADINGS = "h1,h2,h3,h4,h5,h6";
@@ -258,6 +260,31 @@ function EncounterMdyView({ source }) {
     }
   );
 }
+var EsheetSectionContext = React11.createContext(false);
+function EsheetSectionField(props) {
+  const inDocument = React11.useContext(EsheetSectionContext);
+  const { field, isPreview, isRequired, isSoftRequired, nestedChildren } = props;
+  const def = field.definition;
+  if (!inDocument || !isPreview) return /* @__PURE__ */ jsx(SectionField, { ...props });
+  const title = def.title || "Section";
+  return /* @__PURE__ */ jsxs("div", { className: "section-field-preview grid gap-1.5", children: [
+    /* @__PURE__ */ jsx("h3", { className: "text-foreground m-0 flex items-center gap-2 text-sm font-medium", children: /* @__PURE__ */ jsxs("span", { className: "min-w-0 break-words", children: [
+      title,
+      (isRequired || isSoftRequired) && /* @__PURE__ */ jsx(
+        RequiredMark,
+        {
+          variant: isSoftRequired && !isRequired ? "warning" : void 0
+        }
+      )
+    ] }) }),
+    nestedChildren
+  ] });
+}
+function registerEsheetSectionFieldType() {
+  const section = getFieldComponent("section");
+  if (section === void 0 || section === SectionField)
+    registerFieldComponents({ section: EsheetSectionField });
+}
 var measurements = [
   { key: "pulse", label: "Pulse", unit: "bpm" },
   { key: "respiratoryRate", label: "Respiratory rate", unit: "/min" },
@@ -1167,27 +1194,29 @@ function EncounterAssessmentField({
   ) });
 }
 
-// src/components/EncounterVisit/narrativeFindings.ts
-var FINDINGS_ATTRIBUTE = "encounterNarrativeFindings";
-var FINDINGS_TEXT_ATTRIBUTE = "encounterNarrativeFindingsText";
-var HTML_ATTRIBUTE = "encounterNarrativeHtml";
-var TEXT_ATTRIBUTE = "encounterNarrativeText";
+// src/esheet-fields/narrativeFindings.ts
+var NARRATIVE_ATTRIBUTES = {
+  html: "narrativeHtml",
+  text: "narrativeText",
+  findings: "narrativeFindings",
+  findingsText: "narrativeFindingsText"
+};
 function escapedTextHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/\n/g, "<br>");
 }
 function hasNarrativeTagsOnly(html) {
   return !html.replace(/<\/?(?:p|div|strong|b|em|i|u|ul|ol|li)\s*>|<br\s*\/?>/gi, "").includes("<");
 }
-function appendedRichAttributes(response, answer, finding) {
+function appendedRichAttributes(response, answer, finding, attributes) {
   const previous = response?.answer ?? "";
-  const html = response?.attributes?.[HTML_ATTRIBUTE];
-  if (answer === previous || response?.attributes?.[TEXT_ATTRIBUTE] !== previous || typeof html !== "string" || !hasNarrativeTagsOnly(html))
+  const html = response?.attributes?.[attributes.html];
+  if (answer === previous || response?.attributes?.[attributes.text] !== previous || typeof html !== "string" || !hasNarrativeTagsOnly(html))
     return {};
   const aligned = previous.endsWith("\n") ? html.replace(/<br\s*\/?>((?:<\/(?:p|div|ul|ol|li)\s*>|\s)*)$/i, "$1") : html;
   const next = `${previous.trim() ? aligned : ""}<p>${escapedTextHtml(finding.text)}${finding.text.endsWith("\n") ? "<br>" : ""}</p>`;
-  return { [HTML_ATTRIBUTE]: next, [TEXT_ATTRIBUTE]: answer };
+  return { [attributes.html]: next, [attributes.text]: answer };
 }
-function validEncounterNarrativeFindings(value) {
+function validNarrativeFindings(value) {
   if (!Array.isArray(value)) return [];
   const ids = /* @__PURE__ */ new Set();
   return value.flatMap((finding) => {
@@ -1212,7 +1241,7 @@ function validEncounterNarrativeFindings(value) {
     ];
   });
 }
-function hasEncounterNarrativeFindingText(answer, text) {
+function hasNarrativeFindingText(answer, text) {
   const normalize = (value) => value.replace(/\r\n?/g, "\n").trim();
   return `
 ${normalize(answer)}
@@ -1220,46 +1249,39 @@ ${normalize(answer)}
 ${normalize(text)}
 `);
 }
-function getEncounterNarrativeFindings(response) {
+function getNarrativeFindings(response, attributes = NARRATIVE_ATTRIBUTES) {
   const answer = response?.answer ?? "";
-  if (response?.attributes?.[FINDINGS_TEXT_ATTRIBUTE] !== answer) return [];
-  const selected = response.attributes[FINDINGS_ATTRIBUTE];
+  if (response?.attributes?.[attributes.findingsText] !== answer) return [];
+  const selected = response.attributes[attributes.findings];
   if (typeof selected !== "string") return [];
   try {
-    return validEncounterNarrativeFindings(JSON.parse(selected)).filter(
-      (finding) => hasEncounterNarrativeFindingText(answer, finding.text)
+    return validNarrativeFindings(JSON.parse(selected)).filter(
+      (finding) => hasNarrativeFindingText(answer, finding.text)
     );
   } catch {
     return [];
   }
 }
-function applyEncounterNarrativeFinding(response, finding) {
-  const validated = validEncounterNarrativeFindings([finding])[0];
+function applyNarrativeFinding(response, finding, attributes = NARRATIVE_ATTRIBUTES) {
+  const validated = validNarrativeFindings([finding])[0];
   if (!validated) return response ?? {};
-  const selected = getEncounterNarrativeFindings(response);
+  const selected = getNarrativeFindings(response, attributes);
   if (selected.some((item) => item.id === validated.id)) return response ?? {};
   const previousAnswer = response?.answer ?? "";
-  const answer = hasEncounterNarrativeFindingText(
-    previousAnswer,
-    validated.text
-  ) ? previousAnswer : `${previousAnswer.trim() ? `${previousAnswer}${previousAnswer.endsWith("\n") ? "" : "\n"}` : ""}${validated.text}`;
+  const answer = hasNarrativeFindingText(previousAnswer, validated.text) ? previousAnswer : `${previousAnswer.trim() ? `${previousAnswer}${previousAnswer.endsWith("\n") ? "" : "\n"}` : ""}${validated.text}`;
   return {
     ...response,
     answer,
     _ai: false,
     attributes: {
       ...response?.attributes,
-      ...appendedRichAttributes(response, answer, validated),
-      [FINDINGS_ATTRIBUTE]: JSON.stringify([...selected, validated]),
-      [FINDINGS_TEXT_ATTRIBUTE]: answer
+      ...appendedRichAttributes(response, answer, validated, attributes),
+      [attributes.findings]: JSON.stringify([...selected, validated]),
+      [attributes.findingsText]: answer
     }
   };
 }
-var HTML_ATTRIBUTE2 = "encounterNarrativeHtml";
-var TEXT_ATTRIBUTE2 = "encounterNarrativeText";
-var FINDINGS_ATTRIBUTE2 = "encounterNarrativeFindings";
-var FINDINGS_TEXT_ATTRIBUTE2 = "encounterNarrativeFindingsText";
-function sanitizeEncounterNarrativeHtml(html) {
+function sanitizeNarrativeHtml(html) {
   return DOMPurify.sanitize(html, {
     ALLOWED_TAGS: [
       "p",
@@ -1286,9 +1308,9 @@ function sanitizeEncounterNarrativeHtml(html) {
 function textToHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/\n/g, "<br>");
 }
-function encounterNarrativeText(html) {
+function narrativeText(html) {
   const documentBody = document.createElement("div");
-  documentBody.innerHTML = sanitizeEncounterNarrativeHtml(html);
+  documentBody.innerHTML = sanitizeNarrativeHtml(html);
   let text = "";
   const lineBreak = () => {
     if (text && !text.endsWith("\n")) text += "\n";
@@ -1326,12 +1348,12 @@ function encounterNarrativeText(html) {
   documentBody.childNodes.forEach(visit);
   return text.replace(/\u00a0/g, " ").replace(/\n$/, "");
 }
-function responseHtml(response) {
+function responseHtml(response, attributes) {
   const answer = response?.answer ?? "";
-  const attributes = response?.attributes;
-  if (typeof window !== "undefined" && attributes?.[TEXT_ATTRIBUTE2] === answer && typeof attributes[HTML_ATTRIBUTE2] === "string") {
-    const html = sanitizeEncounterNarrativeHtml(attributes[HTML_ATTRIBUTE2]);
-    if (encounterNarrativeText(html) === answer) return html;
+  const responseAttributes = response?.attributes;
+  if (typeof window !== "undefined" && responseAttributes?.[attributes.text] === answer && typeof responseAttributes[attributes.html] === "string") {
+    const html = sanitizeNarrativeHtml(responseAttributes[attributes.html]);
+    if (narrativeText(html) === answer) return html;
   }
   return textToHtml(answer);
 }
@@ -1348,7 +1370,7 @@ function findingShortcuts(findings) {
   }
   return shortcuts;
 }
-function EncounterNarrativeField({
+function EsheetNarrativeField({
   field,
   response,
   isPreview,
@@ -1356,7 +1378,11 @@ function EncounterNarrativeField({
   isReadOnly,
   isRequired,
   isSoftRequired,
-  onResponse
+  onResponse,
+  attributes = NARRATIVE_ATTRIBUTES,
+  findingsKey = "narrativeFindings",
+  hideLabelKey = "narrativeHideLabel",
+  slot = "esheet-narrative"
 }) {
   const m = useMessages();
   const editorRef = React11.useRef(null);
@@ -1366,9 +1392,12 @@ function EncounterNarrativeField({
   const definition = field.definition;
   const question = definition.question || m("Narrative");
   const readOnly = !isPreview || !isEnabled || isReadOnly;
-  const html = React11.useMemo(() => responseHtml(response), [response]);
-  const findings = validEncounterNarrativeFindings(
-    definition._sourceData?.encounterFindings
+  const html = React11.useMemo(
+    () => responseHtml(response, attributes),
+    [response, attributes]
+  );
+  const findings = validNarrativeFindings(
+    definition._sourceData?.[findingsKey]
   );
   const shortcuts = findingShortcuts(findings);
   const macros = findings.length ? [
@@ -1384,18 +1413,23 @@ function EncounterNarrativeField({
     }
   ] : void 0;
   const publish = (value, previous, selected) => {
-    const sanitized = sanitizeEncounterNarrativeHtml(value);
-    const answer = encounterNarrativeText(sanitized);
-    const attributes = {
+    const sanitized = sanitizeNarrativeHtml(value);
+    const answer = narrativeText(sanitized);
+    const nextAttributes = {
       ...previous?.attributes,
-      [HTML_ATTRIBUTE2]: sanitized,
-      [TEXT_ATTRIBUTE2]: answer,
-      ...selected.length || previous?.attributes?.[FINDINGS_ATTRIBUTE2] !== void 0 ? {
-        [FINDINGS_ATTRIBUTE2]: JSON.stringify(selected),
-        [FINDINGS_TEXT_ATTRIBUTE2]: answer
+      [attributes.html]: sanitized,
+      [attributes.text]: answer,
+      ...selected.length || previous?.attributes?.[attributes.findings] !== void 0 ? {
+        [attributes.findings]: JSON.stringify(selected),
+        [attributes.findingsText]: answer
       } : {}
     };
-    const next = { ...previous, answer, _ai: false, attributes };
+    const next = {
+      ...previous,
+      answer,
+      _ai: false,
+      attributes: nextAttributes
+    };
     delete next.selected;
     responseRef.current = next;
     onResponse(next);
@@ -1409,12 +1443,12 @@ function EncounterNarrativeField({
       String(isRequired || isSoftRequired)
     );
   }, [isRequired, isSoftRequired, labelId, readOnly]);
-  return /* @__PURE__ */ jsxs("div", { "data-slot": "encounter-narrative", className: "min-w-0", children: [
+  return /* @__PURE__ */ jsxs("div", { "data-slot": slot, className: "min-w-0", children: [
     /* @__PURE__ */ jsxs(
       "div",
       {
         id: labelId,
-        className: definition._sourceData?.encounterHideLabel ? "sr-only" : "text-muted-foreground text-sm font-medium",
+        className: definition._sourceData?.[hideLabelKey] ? "sr-only" : "text-muted-foreground text-sm font-medium",
         children: [
           question,
           definition.unit && ` (${definition.unit})`,
@@ -1429,14 +1463,14 @@ function EncounterNarrativeField({
         value: html,
         onChange: (value) => {
           if (readOnly) return;
-          const sanitized = sanitizeEncounterNarrativeHtml(value);
-          const answer = encounterNarrativeText(sanitized);
+          const sanitized = sanitizeNarrativeHtml(value);
+          const answer = narrativeText(sanitized);
           const previous = responseRef.current;
           publish(
             sanitized,
             previous,
-            getEncounterNarrativeFindings(previous).filter(
-              (finding) => hasEncounterNarrativeFindingText(answer, finding.text)
+            getNarrativeFindings(previous, attributes).filter(
+              (finding) => hasNarrativeFindingText(answer, finding.text)
             )
           );
         },
@@ -1444,14 +1478,11 @@ function EncounterNarrativeField({
           const finding = findings.find((item) => item.id === macro.id);
           if (!finding || readOnly) return true;
           const previous = responseRef.current;
-          const next = applyEncounterNarrativeFinding(previous, finding);
+          const next = applyNarrativeFinding(previous, finding, attributes);
           if (next === previous) return true;
           const answer = previous?.answer ?? "";
-          const nextHtml = hasEncounterNarrativeFindingText(
-            answer,
-            finding.text
-          ) ? responseHtml(previous) : `${answer.trim() ? responseHtml(previous) : ""}<p>${textToHtml(finding.text)}</p>`;
-          publish(nextHtml, previous, getEncounterNarrativeFindings(next));
+          const nextHtml = hasNarrativeFindingText(answer, finding.text) ? responseHtml(previous, attributes) : `${answer.trim() ? responseHtml(previous, attributes) : ""}<p>${textToHtml(finding.text)}</p>`;
+          publish(nextHtml, previous, getNarrativeFindings(next, attributes));
           return true;
         },
         "aria-label": question,
@@ -1489,12 +1520,53 @@ function EncounterNarrativeField({
           showToolbar: m("Show toolbar"),
           hideToolbar: m("Hide toolbar")
         },
-        sanitizeHtml: sanitizeEncounterNarrativeHtml,
+        sanitizeHtml: sanitizeNarrativeHtml,
         className: "mt-1"
       }
     )
   ] });
 }
+function registerEsheetNarrativeFieldType() {
+  if (getFieldComponent("esheetNarrative")) return;
+  registerCustomFieldTypes({
+    esheetNarrative: {
+      label: "Narrative",
+      category: "rich",
+      answerType: "text",
+      hasOptions: false,
+      hasMatrix: false,
+      defaultProps: { question: "Narrative" },
+      component: EsheetNarrativeField
+    }
+  });
+}
+
+// src/components/EncounterVisit/narrativeFindings.ts
+var ENCOUNTER_NARRATIVE_ATTRIBUTES = {
+  html: "encounterNarrativeHtml",
+  text: "encounterNarrativeText",
+  findings: "encounterNarrativeFindings",
+  findingsText: "encounterNarrativeFindingsText"
+};
+function applyEncounterNarrativeFinding(response, finding) {
+  return applyNarrativeFinding(
+    response,
+    finding,
+    ENCOUNTER_NARRATIVE_ATTRIBUTES
+  );
+}
+function EncounterNarrativeField(props) {
+  return /* @__PURE__ */ jsx(
+    EsheetNarrativeField,
+    {
+      ...props,
+      attributes: ENCOUNTER_NARRATIVE_ATTRIBUTES,
+      findingsKey: "encounterFindings",
+      hideLabelKey: "encounterHideLabel",
+      slot: "encounter-narrative"
+    }
+  );
+}
 function readValue(answer) {
   if (!answer) return { value: { medications: [] } };
   try {
@@ -2610,32 +2682,10 @@ function EncounterPlanField({
     !readOnly && requireCoding && !codeLookup && /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-sm", children: m("Coded order search is unavailable.") })
   ] });
 }
-var EncounterSectionContext = React11.createContext(false);
-function EncounterSectionField(props) {
-  const inEncounter = React11.useContext(EncounterSectionContext);
-  const { field, isPreview, isRequired, isSoftRequired, nestedChildren } = props;
-  const def = field.definition;
-  if (!inEncounter || !isPreview) return /* @__PURE__ */ jsx(SectionField, { ...props });
-  const title = def.title || "Section";
-  return /* @__PURE__ */ jsxs("div", { className: "section-field-preview grid gap-1.5", children: [
-    /* @__PURE__ */ jsx("h3", { className: "text-foreground m-0 flex items-center gap-2 text-sm font-medium", children: /* @__PURE__ */ jsxs("span", { className: "min-w-0 break-words", children: [
-      title,
-      (isRequired || isSoftRequired) && /* @__PURE__ */ jsx(
-        RequiredMark,
-        {
-          variant: isSoftRequired && !isRequired ? "warning" : void 0
-        }
-      )
-    ] }) }),
-    nestedChildren
-  ] });
-}
 
 // src/components/EncounterVisit/fields.ts
 function registerEncounterFieldTypes() {
-  const section = getFieldComponent("section");
-  if (section === void 0 || section === SectionField)
-    registerFieldComponents({ section: EncounterSectionField });
+  registerEsheetSectionFieldType();
   const clinicalFields = {
     encounterMedications: {
       label: "Encounter medications",
@@ -4056,7 +4106,7 @@ var EncounterVisitSession = React11.forwardRef(function EncounterVisitSession2({
                         }
                       )
                     ] }),
-                    /* @__PURE__ */ jsx(EncounterSectionContext.Provider, { value: true, children: /* @__PURE__ */ jsx(
+                    /* @__PURE__ */ jsx(EsheetSectionContext.Provider, { value: true, children: /* @__PURE__ */ jsx(
                       EsheetRenderer,
                       {
                         ref: renderer,
@@ -4114,6 +4164,434 @@ var EncounterVisitSession = React11.forwardRef(function EncounterVisitSession2({
     }
   );
 });
+function getRichTextEsheetFieldId(sectionId) {
+  return `richtext:${encodeURIComponent(sectionId)}:value`;
+}
+function getRichTextEsheetSectionFieldId(sectionId) {
+  return `richtext:${encodeURIComponent(sectionId)}:section`;
+}
+function nonempty(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function invalid(message) {
+  throw new Error(`Invalid RichTextEsheet definition: ${message}`);
+}
+function validateRichTextEsheetDefinition(definition) {
+  if (!definition || typeof definition !== "object")
+    invalid("expected an object");
+  if (!nonempty(definition.id) || !nonempty(definition.title))
+    invalid("id and title must be nonempty strings");
+  if (!Array.isArray(definition.sections) || definition.sections.length === 0)
+    invalid("at least one section is required");
+  const sectionIds = /* @__PURE__ */ new Set();
+  for (const section of definition.sections) {
+    if (!section || typeof section !== "object")
+      invalid("expected a section object");
+    if (!nonempty(section.id) || !nonempty(section.title))
+      invalid("each section requires an id and title");
+    if (sectionIds.has(section.id))
+      invalid(`duplicate section id ${section.id}`);
+    sectionIds.add(section.id);
+    if (section.description !== void 0 && typeof section.description !== "string")
+      invalid(`invalid description in ${section.id}`);
+    if (section.required !== void 0 && typeof section.required !== "boolean")
+      invalid(`required must be boolean in ${section.id}`);
+    if (section.fieldType !== void 0 && !nonempty(section.fieldType))
+      invalid(`fieldType must be a nonempty string in ${section.id}`);
+    if (section.findings === void 0) continue;
+    if (!Array.isArray(section.findings))
+      invalid(`findings must be an array in ${section.id}`);
+    const findingIds = /* @__PURE__ */ new Set();
+    for (const finding of section.findings) {
+      if (!finding || typeof finding !== "object" || !nonempty(finding.id) || !nonempty(finding.label) || !nonempty(finding.text))
+        invalid(`findings require id, label and text in ${section.id}`);
+      if (findingIds.has(finding.id))
+        invalid(`duplicate finding id ${finding.id} in ${section.id}`);
+      findingIds.add(finding.id);
+    }
+  }
+}
+function partyFindings(parties) {
+  return (parties ?? []).map((party) => ({
+    // Content-derived identity: editing or reordering a party yields a new
+    // macro id, so the updated text stays insertable after an earlier
+    // version was applied (selection dedupe is by id).
+    id: `party:${encodeURIComponent(party.role)}:${encodeURIComponent(
+      party.name
+    )}:${encodeURIComponent(party.detail ?? "")}`,
+    label: `${party.role}: ${party.name}`,
+    text: party.detail ? `${party.name} (${party.detail})` : party.name
+  }));
+}
+function createRichTextEsheetFormDefinition(definition, parties) {
+  validateRichTextEsheetDefinition(definition);
+  const partyMacros = partyFindings(parties);
+  return {
+    id: definition.id,
+    title: definition.title,
+    pages: [
+      {
+        id: `${definition.id}:document`,
+        title: definition.title,
+        fields: definition.sections.map((section) => {
+          const fields = [];
+          if (section.description) {
+            fields.push({
+              id: `${getRichTextEsheetSectionFieldId(section.id)}:description`,
+              fieldType: "display",
+              content: section.description,
+              width: "full"
+            });
+          }
+          const fieldType = section.fieldType ?? "esheetNarrative";
+          fields.push({
+            id: getRichTextEsheetFieldId(section.id),
+            fieldType,
+            question: section.title,
+            required: section.required,
+            width: "full",
+            // Keyed off the resolved type: an explicit 'esheetNarrative'
+            // override keeps its findings, macros and hidden label.
+            _sourceData: fieldType === "esheetNarrative" ? {
+              narrativeHideLabel: true,
+              narrativeFindings: [
+                ...section.findings ?? [],
+                ...partyMacros
+              ]
+            } : void 0
+          });
+          return {
+            id: getRichTextEsheetSectionFieldId(section.id),
+            fieldType: "section",
+            title: section.title,
+            sectionCollapse: "expanded",
+            width: "full",
+            fields
+          };
+        })
+      }
+    ]
+  };
+}
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasValue(value) {
+  if (typeof value === "string") return value.trim().length > 0;
+  if (typeof value === "number" || typeof value === "boolean") return true;
+  if (Array.isArray(value)) return value.some(hasValue);
+  if (record(value)) return Object.values(value).some(hasValue);
+  return false;
+}
+function valueText(value) {
+  if (typeof value === "string") return value.trim();
+  if (typeof value === "number" || typeof value === "boolean")
+    return String(value);
+  if (Array.isArray(value))
+    return value.map(valueText).filter(Boolean).join(", ");
+  return "";
+}
+function selectedText(selected) {
+  if (Array.isArray(selected))
+    return selected.map(selectedText).filter(Boolean).join(", ");
+  if (!record(selected)) return "";
+  if ("value" in selected) {
+    if (!hasValue(selected.value)) return "";
+    const text = valueText(selected.value);
+    const label = typeof selected.label === "string" ? selected.label.trim() : "";
+    return label && label !== text ? `${label}: ${text}` : text;
+  }
+  return Object.values(selected).map(selectedText).filter(Boolean).join(", ");
+}
+function sectionText(responses, sectionId) {
+  const response = responses[getRichTextEsheetFieldId(sectionId)];
+  return valueText(response?.answer) || selectedText(response?.selected);
+}
+function markdownText(value) {
+  return value.replace(/&/g, "&amp;").replace(/[\\[\]`*_~<>]/g, "\\$&");
+}
+function markdownHeading(value) {
+  return markdownText(value).replace(/\r?\n/g, " \xB7 ");
+}
+function markdownBody(value) {
+  return value.split(/\r?\n/).map(
+    (line) => markdownText(line.trim()).replace(/^([#+-])/, "\\$1").replace(/^(\d+)([.)])/, "$1\\$2")
+  ).filter(Boolean).join("\n\n");
+}
+function createRichTextEsheetSnapshot(definition, responses, parties) {
+  validateRichTextEsheetDefinition(definition);
+  const documentedSections = definition.sections.filter((section) => sectionText(responses, section.id).length > 0).map((section) => section.id);
+  const errors = definition.sections.filter(
+    (section) => section.required && !documentedSections.includes(section.id)
+  ).map((section) => ({
+    sectionId: section.id,
+    message: `${section.title} is required.`
+  }));
+  const frontMatter = {
+    richTextEsheet: { id: definition.id, title: definition.title },
+    ...parties?.length ? { parties } : {}
+  };
+  const body = definition.sections.filter((section) => documentedSections.includes(section.id)).map(
+    (section) => `## ${markdownHeading(section.title)}
+
+${markdownBody(
+      sectionText(responses, section.id)
+    )}`
+  ).join("\n\n");
+  const mdy = `---
+${stringify(frontMatter)}---
+
+# ${markdownHeading(
+    definition.title
+  )}
+${body ? `
+${body}
+` : ""}`;
+  return { definition, responses, documentedSections, errors, mdy };
+}
+var RichTextEsheet = React11.forwardRef(function RichTextEsheet2({ messages, ...props }, ref) {
+  return /* @__PURE__ */ jsx(MessagesProvider, { messages, children: /* @__PURE__ */ jsx(RichTextEsheetSession, { ...props, ref }, props.definition.id) });
+});
+function ensureFields2() {
+  registerEsheetSectionFieldType();
+  registerEsheetNarrativeFieldType();
+}
+var esheetDefaultsSettled2 = false;
+var RichTextEsheetSession = React11.forwardRef(function RichTextEsheetSession2({
+  definition,
+  parties,
+  initialResponses,
+  onChange,
+  onSubmit,
+  readOnly = false,
+  className,
+  ...props
+}, ref) {
+  ensureFields2();
+  const [fieldsSettled, setFieldsSettled] = React11.useState(
+    () => esheetDefaultsSettled2
+  );
+  React11.useLayoutEffect(() => {
+    if (!esheetDefaultsSettled2) {
+      esheetDefaultsSettled2 = true;
+      ensureFields2();
+    }
+    setFieldsSettled(true);
+  }, []);
+  const m = useMessages();
+  const configJson = JSON.stringify({ definition, parties });
+  const stable = React11.useMemo(
+    () => JSON.parse(configJson),
+    [configJson]
+  );
+  const form = React11.useMemo(
+    () => createRichTextEsheetFormDefinition(stable.definition, stable.parties),
+    [stable]
+  );
+  const [initialSeed] = React11.useState(() => initialResponses ?? {});
+  const [snapshot, setSnapshot] = React11.useState(
+    () => createRichTextEsheetSnapshot(stable.definition, initialSeed, stable.parties)
+  );
+  const [showErrors, setShowErrors] = React11.useState(false);
+  const [saving, setSaving] = React11.useState(false);
+  const submissionPending = React11.useRef(false);
+  const [saveMessage, setSaveMessage] = React11.useState("");
+  const renderer = React11.useRef(null);
+  const root = React11.useRef(null);
+  const unsubscribe = React11.useRef(null);
+  const responses = React11.useRef(initialSeed);
+  const latest = React11.useRef({ stable, onChange, onSubmit, readOnly, m });
+  latest.current = { stable, onChange, onSubmit, readOnly, m };
+  const rendererInput = React11.useMemo(
+    () => ({ definition: form, responses: responses.current }),
+    [form]
+  );
+  const currentSnapshot = React11.useCallback(() => {
+    const { stable: stable2 } = latest.current;
+    return createRichTextEsheetSnapshot(
+      stable2.definition,
+      renderer.current?.getRawResponse() ?? responses.current,
+      stable2.parties
+    );
+  }, []);
+  const focusSection = React11.useCallback((sectionId) => {
+    const fieldId = getRichTextEsheetSectionFieldId(sectionId);
+    const section = Array.from(
+      root.current?.querySelectorAll("[data-field-id]") ?? []
+    ).find((element) => element.dataset.fieldId === fieldId);
+    if (!section) return;
+    section.tabIndex = -1;
+    section.focus({ preventScroll: true });
+    section.scrollIntoView?.({ block: "start", behavior: "auto" });
+  }, []);
+  React11.useImperativeHandle(
+    ref,
+    () => ({ getSnapshot: currentSnapshot, focusSection }),
+    [currentSnapshot, focusSection]
+  );
+  const handleReady = React11.useCallback(() => {
+    const store = renderer.current?.getFormStore();
+    if (!store) return;
+    unsubscribe.current?.();
+    const publish = () => {
+      responses.current = store.getState().responses;
+      const next = currentSnapshot();
+      setSnapshot(next);
+      latest.current.onChange?.(next);
+    };
+    unsubscribe.current = store.subscribe((state, previous) => {
+      if (state.responses !== previous.responses) {
+        setSaveMessage("");
+        publish();
+      }
+    });
+    publish();
+  }, [currentSnapshot]);
+  React11.useLayoutEffect(() => {
+    unsubscribe.current?.();
+    unsubscribe.current = null;
+  }, [rendererInput]);
+  React11.useEffect(() => () => unsubscribe.current?.(), []);
+  const submit = async () => {
+    const context = latest.current;
+    if (!context.onSubmit || context.readOnly || saving || submissionPending.current)
+      return;
+    submissionPending.current = true;
+    try {
+      const next = currentSnapshot();
+      setShowErrors(true);
+      if (next.errors.length > 0) {
+        setSnapshot(next);
+        setSaveMessage(m("Resolve the highlighted sections before saving."));
+        focusSection(next.errors[0].sectionId);
+        return;
+      }
+      renderer.current?.getFormStore().getState().setReadOnly(true);
+      setSaving(true);
+      setSaveMessage("");
+      try {
+        await context.onSubmit(next);
+        setSaveMessage(latest.current.m("Document saved."));
+      } catch (error) {
+        setSaveMessage(
+          error instanceof Error ? error.message : latest.current.m(
+            "Unable to save this document. Your draft is still here."
+          )
+        );
+      } finally {
+        renderer.current?.getFormStore().getState().setReadOnly(latest.current.readOnly);
+        setSaving(false);
+      }
+    } finally {
+      submissionPending.current = false;
+    }
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...props,
+      ref: root,
+      "data-slot": "richtext-esheet",
+      className: cn(
+        "richtext-esheet bg-background text-foreground min-w-0",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsxs("header", { className: "flex flex-wrap items-start justify-between gap-2 px-2 pt-3 pb-2 sm:px-3", children: [
+          /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+            /* @__PURE__ */ jsx("h2", { className: "text-lg font-semibold", children: m(stable.definition.title) }),
+            stable.parties && stable.parties.length > 0 && /* @__PURE__ */ jsx("dl", { className: "mt-1 space-y-0.5 text-sm", children: stable.parties.map((party, index) => /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-x-1.5", children: [
+              /* @__PURE__ */ jsx("dt", { className: "text-muted-foreground", children: m(party.role) }),
+              /* @__PURE__ */ jsxs("dd", { dir: "auto", className: "break-words", children: [
+                party.name,
+                party.detail && /* @__PURE__ */ jsxs("span", { className: "text-muted-foreground", children: [
+                  " ",
+                  "(",
+                  party.detail,
+                  ")"
+                ] })
+              ] })
+            ] }, index)) })
+          ] }),
+          /* @__PURE__ */ jsx("p", { className: "text-muted-foreground text-xs", children: /* @__PURE__ */ jsx("bdi", { children: m("{count} of {total} sections documented", {
+            count: snapshot.documentedSections.length,
+            total: stable.definition.sections.length
+          }) }) })
+        ] }),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            "data-slot": "richtext-esheet-document",
+            className: "min-w-0 px-2 pt-2 pb-4 sm:px-3",
+            children: [
+              showErrors && snapshot.errors.length > 0 && /* @__PURE__ */ jsxs(
+                "div",
+                {
+                  role: "alert",
+                  className: "border-destructive/40 bg-destructive/5 mb-4 rounded-lg border p-3 text-sm",
+                  children: [
+                    /* @__PURE__ */ jsx("p", { className: "font-semibold", children: m("Sections need attention") }),
+                    /* @__PURE__ */ jsx("ul", { className: "mt-2 space-y-1", children: snapshot.errors.map((issue) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        type: "button",
+                        className: "text-destructive min-h-11 text-start underline underline-offset-2",
+                        onClick: () => focusSection(issue.sectionId),
+                        children: m("{section} is required.", {
+                          section: stable.definition.sections.find(
+                            (section) => section.id === issue.sectionId
+                          )?.title ?? issue.sectionId
+                        })
+                      }
+                    ) }, issue.sectionId)) })
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsx(EsheetSectionContext.Provider, { value: true, children: /* @__PURE__ */ jsx(
+                EsheetRenderer,
+                {
+                  ref: renderer,
+                  formDataInput: rendererInput.definition,
+                  initialResponses: rendererInput.responses,
+                  onReady: handleReady,
+                  strict: true,
+                  readOnly: readOnly || saving,
+                  fitToContainer: true,
+                  topNavigation: false,
+                  bottomNavigation: false,
+                  className: "richtext-esheet-renderer"
+                },
+                fieldsSettled ? "settled" : "priming"
+              ) })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs("footer", { className: "bg-background sticky bottom-0 z-10 flex flex-wrap items-center justify-between gap-2 px-2 pt-2 pb-[max(0.5rem,env(safe-area-inset-bottom))] sm:px-3", children: [
+          /* @__PURE__ */ jsx(
+            "p",
+            {
+              role: "status",
+              "aria-live": "polite",
+              className: "text-muted-foreground min-w-0 text-sm",
+              children: saveMessage || (readOnly ? m("Read-only document") : "")
+            }
+          ),
+          onSubmit && /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              className: "min-h-11",
+              disabled: readOnly || saving,
+              leftIcon: /* @__PURE__ */ jsx(Save, { size: 16, "aria-hidden": "true" }),
+              onClick: () => void submit(),
+              children: m(saving ? "Saving\u2026" : "Save document")
+            }
+          )
+        ] })
+      ]
+    }
+  );
+});
 function parseValue(answer) {
   if (!answer) return { medications: [] };
   try {
@@ -4252,6 +4730,6 @@ function registerMieEsheetFields(options) {
   registerAllergyListFieldType({ codeLookup: options?.codeLookup });
 }
 
-export { AllergyListField, ENCOUNTER_VISIT_SYSTEM_PROMPT, ENCOUNTER_VISIT_TOOL_DEFINITIONS, EncounterAllergyField, EncounterAssessmentField, EncounterConditionsField, EncounterMedicationField, EncounterNarrativeField, EncounterPlanField, EncounterVisit, EncounterVitalsField, MedicationListField, createEncounterVisitTools, executeEncounterVisitToolCall, registerAllergyListFieldType, registerEncounterFieldTypes, registerMedicationListFieldType, registerMieEsheetFields };
+export { AllergyListField, ENCOUNTER_VISIT_SYSTEM_PROMPT, ENCOUNTER_VISIT_TOOL_DEFINITIONS, EncounterAllergyField, EncounterAssessmentField, EncounterConditionsField, EncounterMedicationField, EncounterNarrativeField, EncounterPlanField, EncounterVisit, EncounterVitalsField, EsheetNarrativeField, EsheetSectionContext, EsheetSectionField, MedicationListField, NARRATIVE_ATTRIBUTES, RichTextEsheet, applyNarrativeFinding, createEncounterVisitTools, createRichTextEsheetFormDefinition, createRichTextEsheetSnapshot, executeEncounterVisitToolCall, getNarrativeFindings, getRichTextEsheetFieldId, getRichTextEsheetSectionFieldId, hasNarrativeFindingText, narrativeText, partyFindings, registerAllergyListFieldType, registerEncounterFieldTypes, registerEsheetNarrativeFieldType, registerEsheetSectionFieldType, registerMedicationListFieldType, registerMieEsheetFields, sanitizeNarrativeHtml, validNarrativeFindings, validateRichTextEsheetDefinition };
 //# sourceMappingURL=esheet.js.map
 //# sourceMappingURL=esheet.js.map