@imranq2/fhirpatientsummary 1.0.30 → 1.0.31

package/dist/index.cjs

@@ -1435,7 +1435,8 @@ var PatientTemplate = class _PatientTemplate {
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     const combinedPatient = this.combinePatients(resources);
-    return `<div>
+    let html = `<p>This section merges all Patient resources into a single combined patient record, preferring non-empty values for each field.</p>`;
+    html += `<div>
       <ul>
         <li><strong>Name(s):</strong>${this.renderNames(combinedPatient)}</li>
         <li><strong>Gender:</strong>${combinedPatient.gender ? this.capitalize(combinedPatient.gender) : ""}</li>
@@ -1447,6 +1448,7 @@ var PatientTemplate = class _PatientTemplate {
         <li><strong>Language(s):</strong>${this.renderCommunication(templateUtilities, combinedPatient)}</li>
       </ul>
     </div>`;
+    return html;
   }
   /**
    * Combines multiple patient resources into a single patient object
@@ -1771,7 +1773,9 @@ var AllergyIntoleranceTemplate = class _AllergyIntoleranceTemplate {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes all AllergyIntolerance resources, with no additional filtering, sorted as provided.</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -1853,7 +1857,8 @@ var AllergyIntoleranceTemplate = class _AllergyIntoleranceTemplate {
       const dateB = b.onsetDateTime;
       return dateA && dateB ? new Date(dateB).getTime() - new Date(dateA).getTime() : 0;
     });
-    let html = "";
+    let html = `<p>This list includes all AllergyIntolerance resources, with no additional filtering, sorted as provided.</p>
+`;
     html += `
       <div class="ActiveAllergies">
         <h3>Active</h3>
@@ -1979,7 +1984,8 @@ var MedicationSummaryTemplate = class _MedicationSummaryTemplate {
     let isSummaryCreated = false;
     const currentDate = now || /* @__PURE__ */ new Date();
     const twoYearsAgo = new Date(currentDate.getFullYear(), currentDate.getMonth() - 24, currentDate.getDate());
-    let html = `
+    let html = "<p>This list includes all the medications that were ordered for the patient, the medications they filled from the pharmacy and the medications they reported, filtered to past 2 years and sorted by start date.</p>";
+    html += `
         <div>
             <table>
             <thead>
@@ -2305,6 +2311,7 @@ var ImmunizationsTemplate = class _ImmunizationsTemplate {
     let isSummaryCreated = false;
     let html = `
       <div>
+      <p>This list includes all vaccinations, sorted by occurrence date (most recent first).</p>
         <table>
           <thead>
             <tr>
@@ -2387,7 +2394,7 @@ var ImmunizationsTemplate = class _ImmunizationsTemplate {
       for (const resourceItem of immunizations) {
         const imm = resourceItem;
         html += `
-          <tr id="${templateUtilities.narrativeLinkId(imm)}">
+          <tr>
             <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(imm.vaccineCode))}</td>
             <td>${templateUtilities.codeableConceptCoding(imm.vaccineCode)}</td>
             <td>${imm.status || ""}</td>
@@ -2427,7 +2434,8 @@ var ProblemListTemplate = class _ProblemListTemplate {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = ``;
+    let html = `<p>This list includes patient problems, sorted by recorded date (most recent first)</p>
+`;
     const activeConditions = resources.map((entry) => entry) || [];
     activeConditions.sort((a, b) => {
       if (!a.recordedDate && b.recordedDate) return -1;
@@ -2457,7 +2465,7 @@ var ProblemListTemplate = class _ProblemListTemplate {
         continue;
       }
       seenCodeAndSystems.add(codeAndSystem);
-      html += `<tr id="${templateUtilities.narrativeLinkId(cond)}">
+      html += `<tr>
           <td class="Name">${conditionDisplay}</td>
           <td class="CodeSystem">${codeAndSystem}</td>
           <td class="OnsetDate">${templateUtilities.renderDate(cond.onsetDateTime)}</td>
@@ -2491,7 +2499,9 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes the latest vital signs, sorted by effective date (most recent first).</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -2564,7 +2574,9 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
       const dateB = b.effectiveDateTime || b.effectivePeriod?.start;
       return dateA && dateB ? new Date(dateB).getTime() - new Date(dateA).getTime() : 0;
     });
-    let html = `
+    let html = `<p>This list includes the latest vital signs, sorted by effective date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -2582,7 +2594,7 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
         <tbody>`;
     for (const obs of observations) {
       html += `
-          <tr id="${templateUtilities.narrativeLinkId(obs)}">
+          <tr>
             <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(obs.code, "display"))}</td>
             <td>${templateUtilities.codeableConceptCoding(obs.code)}</td>
             <td>${templateUtilities.extractObservationValue(obs)}</td>
@@ -2620,7 +2632,7 @@ var MedicalDevicesTemplate = class _MedicalDevicesTemplate {
    */
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = `
+    let html = `<p>This list includes all DeviceUseStatement resources, sorted by recorded date (most recent first).</p>
       <table>
         <thead>
           <tr>
@@ -2638,7 +2650,7 @@ var MedicalDevicesTemplate = class _MedicalDevicesTemplate {
     });
     for (const dus of deviceStatements) {
       html += `
-        <tr id="${templateUtilities.narrativeLinkId(dus)}">
+        <tr>
           <td>${templateUtilities.renderTextAsHtml(templateUtilities.renderDevice(dus.device))}</td>
           <td>${templateUtilities.renderTextAsHtml(dus.status || "")}</td>
           <td>${templateUtilities.renderNotes(dus.note, timezone)}</td>
@@ -2999,11 +3011,12 @@ var DiagnosticResultsTemplate = class _DiagnosticResultsTemplate {
         }
       }
     }
-    let html = `
-      <div>`;
+    let html = `<p>This section includes Observations from the last 2 years (one per lab name, using code mapping) and DiagnosticReports with status 'final' issued in the last 2 years. Both are sorted by date (most recent first). Older results are counted and noted below the tables.</p>
+`;
     let observationhtml = `
       <div>
         <h3>Observations</h3>
+      ${html}
         <table>
           <thead>
             <tr>
@@ -3019,6 +3032,7 @@ var DiagnosticResultsTemplate = class _DiagnosticResultsTemplate {
     let diagnosticReporthtml = `
       <div>
         <h3>Diagnostic Reports</h3>
+        ${html}
         <table>
           <thead>
             <tr>
@@ -3189,7 +3203,8 @@ var DiagnosticResultsTemplate = class _DiagnosticResultsTemplate {
     const currentDate = now || /* @__PURE__ */ new Date();
     const twoYearsAgo = new Date(currentDate);
     twoYearsAgo.setFullYear(currentDate.getFullYear() - 2);
-    let html = "";
+    let html = `<p>This section includes Observations from the last 2 years (one per lab name, using code mapping) and DiagnosticReports with status 'final' issued in the last 2 years. Both are sorted by date (most recent first). Older results are counted and noted below the tables.</p>
+`;
     let skippedObservations = 0;
     let skippedDiagnosticReports = 0;
     for (const resourceItem of resources) {
@@ -3451,7 +3466,9 @@ var HistoryOfProceduresTemplate = class _HistoryOfProceduresTemplate {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes all Procedure resources, sorted by performed date (most recent first).</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -3512,7 +3529,9 @@ var HistoryOfProceduresTemplate = class _HistoryOfProceduresTemplate {
    */
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = `
+    let html = `<p>This list includes all Procedure resources, sorted by performed date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -3527,12 +3546,12 @@ var HistoryOfProceduresTemplate = class _HistoryOfProceduresTemplate {
     for (const resourceItem of resources) {
       const proc = resourceItem;
       html += `
-        <tr id="${templateUtilities.narrativeLinkId(proc)}">
+        <tr>
           <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(proc.code, "display"))}</td>
-           <td>${templateUtilities.codeableConceptCoding(proc.code)}</td>
+          <td>${templateUtilities.codeableConceptCoding(proc.code)}</td>
           <td>${templateUtilities.renderNotes(proc.note, timezone)}</td>
-          <td>${proc.performedDateTime ? templateUtilities.renderTime(proc.performedDateTime, timezone) : proc.performedPeriod ? templateUtilities.renderPeriod(proc.performedPeriod, timezone) : ""}</td>
-            <td>${templateUtilities.getOwnerTag(proc)}</td>
+          <td>${templateUtilities.renderTime(proc.performedDateTime || proc.performedPeriod?.start, timezone)}</td>
+          <td>${templateUtilities.getOwnerTag(proc)}</td>
         </tr>`;
     }
     html += `
@@ -3567,7 +3586,9 @@ var SocialHistoryTemplate = class _SocialHistoryTemplate {
       const dateB = b.effectiveDateTime || b.effectivePeriod?.start;
       return dateA && dateB ? new Date(dateB).getTime() - new Date(dateA).getTime() : 0;
     });
-    let html = `
+    let html = `<p>This list includes all information about the patient's social history, sorted by effective date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -3583,7 +3604,7 @@ var SocialHistoryTemplate = class _SocialHistoryTemplate {
         <tbody>`;
     for (const obs of observations) {
       html += `
-          <tr id="${templateUtilities.narrativeLinkId(obs)}">
+          <tr>
             <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(obs.code))}</td>
             <td>${templateUtilities.codeableConceptCoding(obs.code)}</td>
             <td>${templateUtilities.extractObservationValue(obs)}</td>
@@ -3611,7 +3632,8 @@ var PastHistoryOfIllnessTemplate = class {
    */
   generateNarrative(resources, timezone, now) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = ``;
+    let html = `<p>This list includes past problems for the patient with a recorded date within the last 5 years, sorted by recorded date (most recent first).</p>
+`;
     const resolvedConditions = resources.map((entry) => entry) || [];
     const currentDate = now || /* @__PURE__ */ new Date();
     const fiveYearsAgo = new Date(currentDate);
@@ -3648,7 +3670,7 @@ var PastHistoryOfIllnessTemplate = class {
       const conditionCode = templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(cond.code));
       if (!addedConditionCodes.has(conditionCode)) {
         addedConditionCodes.add(conditionCode);
-        html += `<tr id="${templateUtilities.narrativeLinkId(cond)}">
+        html += `<tr>
             <td class="Name">${conditionCode}</td>
             <td class="CodeSystem">${templateUtilities.codeableConceptCoding(cond.code)}</td>
             <td class="OnsetDate">${templateUtilities.renderDate(cond.onsetDateTime)}</td>
@@ -3684,7 +3706,9 @@ var PlanOfCareTemplate = class {
       const endB = b.period?.end ? new Date(b.period?.end).getTime() : 0;
       return endB - endA;
     });
-    let html = `
+    let html = `<p>This list includes all CarePlan resources, sorted by planned end date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -3722,7 +3746,9 @@ var PlanOfCareTemplate = class {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes all CarePlan resources, sorted by planned end date (most recent first).</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -3784,7 +3810,7 @@ var FunctionalStatusTemplate = class _FunctionalStatusTemplate {
    */
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = "";
+    let html = `<p>This section summarizes key observations and assessments related to the person's functional status and ability to perform daily activities.</p>`;
     let functionalObservations = resources.filter((r) => r.resourceType === "Observation").filter((r) => {
       const hasFunctionalLoinc = r.code?.coding?.some(
         (c) => c.system?.toLowerCase().includes("loinc") && c.code === "47420-5"
@@ -3908,7 +3934,8 @@ var PregnancyTemplate = class _PregnancyTemplate {
     if (!pregnancyStatusObs && !eddObs && historyObs.length === 0 && conditions.length === 0) {
       return `<p>No history of pregnancy found.</p>`;
     }
-    let html = `
+    let html = `<p>This list includes Observation and Condition resources relevant to pregnancy, sorted by date (most recent first).</p>`;
+    html += `
             <table>
               <thead>
                 <tr>
@@ -4013,8 +4040,9 @@ var AdvanceDirectivesTemplate = class _AdvanceDirectivesTemplate {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = `
-      <table>
+    let html = `<p>This list includes all Consent resources, sorted by date (most recent first).</p>
+`;
+    html += `<table>
         <thead>
           <tr>
             <th>Scope</th>
@@ -4027,7 +4055,7 @@ var AdvanceDirectivesTemplate = class _AdvanceDirectivesTemplate {
     for (const resourceItem of resources) {
       const consent = resourceItem;
       html += `
-        <tr id="${templateUtilities.narrativeLinkId(consent)}">
+        <tr>
           <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(consent.scope, "display"))}</td>
           <td>${consent.status || ""}</td>
           <td>${consent.provision?.action ? templateUtilities.concatCodeableConcept(consent.provision.action) : ""}</td>

package/dist/index.js

@@ -1407,7 +1407,8 @@ var PatientTemplate = class _PatientTemplate {
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     const combinedPatient = this.combinePatients(resources);
-    return `<div>
+    let html = `<p>This section merges all Patient resources into a single combined patient record, preferring non-empty values for each field.</p>`;
+    html += `<div>
       <ul>
         <li><strong>Name(s):</strong>${this.renderNames(combinedPatient)}</li>
         <li><strong>Gender:</strong>${combinedPatient.gender ? this.capitalize(combinedPatient.gender) : ""}</li>
@@ -1419,6 +1420,7 @@ var PatientTemplate = class _PatientTemplate {
         <li><strong>Language(s):</strong>${this.renderCommunication(templateUtilities, combinedPatient)}</li>
       </ul>
     </div>`;
+    return html;
   }
   /**
    * Combines multiple patient resources into a single patient object
@@ -1743,7 +1745,9 @@ var AllergyIntoleranceTemplate = class _AllergyIntoleranceTemplate {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes all AllergyIntolerance resources, with no additional filtering, sorted as provided.</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -1825,7 +1829,8 @@ var AllergyIntoleranceTemplate = class _AllergyIntoleranceTemplate {
       const dateB = b.onsetDateTime;
       return dateA && dateB ? new Date(dateB).getTime() - new Date(dateA).getTime() : 0;
     });
-    let html = "";
+    let html = `<p>This list includes all AllergyIntolerance resources, with no additional filtering, sorted as provided.</p>
+`;
     html += `
       <div class="ActiveAllergies">
         <h3>Active</h3>
@@ -1951,7 +1956,8 @@ var MedicationSummaryTemplate = class _MedicationSummaryTemplate {
     let isSummaryCreated = false;
     const currentDate = now || /* @__PURE__ */ new Date();
     const twoYearsAgo = new Date(currentDate.getFullYear(), currentDate.getMonth() - 24, currentDate.getDate());
-    let html = `
+    let html = "<p>This list includes all the medications that were ordered for the patient, the medications they filled from the pharmacy and the medications they reported, filtered to past 2 years and sorted by start date.</p>";
+    html += `
         <div>
             <table>
             <thead>
@@ -2277,6 +2283,7 @@ var ImmunizationsTemplate = class _ImmunizationsTemplate {
     let isSummaryCreated = false;
     let html = `
       <div>
+      <p>This list includes all vaccinations, sorted by occurrence date (most recent first).</p>
         <table>
           <thead>
             <tr>
@@ -2359,7 +2366,7 @@ var ImmunizationsTemplate = class _ImmunizationsTemplate {
       for (const resourceItem of immunizations) {
         const imm = resourceItem;
         html += `
-          <tr id="${templateUtilities.narrativeLinkId(imm)}">
+          <tr>
             <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(imm.vaccineCode))}</td>
             <td>${templateUtilities.codeableConceptCoding(imm.vaccineCode)}</td>
             <td>${imm.status || ""}</td>
@@ -2399,7 +2406,8 @@ var ProblemListTemplate = class _ProblemListTemplate {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = ``;
+    let html = `<p>This list includes patient problems, sorted by recorded date (most recent first)</p>
+`;
     const activeConditions = resources.map((entry) => entry) || [];
     activeConditions.sort((a, b) => {
       if (!a.recordedDate && b.recordedDate) return -1;
@@ -2429,7 +2437,7 @@ var ProblemListTemplate = class _ProblemListTemplate {
         continue;
       }
       seenCodeAndSystems.add(codeAndSystem);
-      html += `<tr id="${templateUtilities.narrativeLinkId(cond)}">
+      html += `<tr>
           <td class="Name">${conditionDisplay}</td>
           <td class="CodeSystem">${codeAndSystem}</td>
           <td class="OnsetDate">${templateUtilities.renderDate(cond.onsetDateTime)}</td>
@@ -2463,7 +2471,9 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes the latest vital signs, sorted by effective date (most recent first).</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -2536,7 +2546,9 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
       const dateB = b.effectiveDateTime || b.effectivePeriod?.start;
       return dateA && dateB ? new Date(dateB).getTime() - new Date(dateA).getTime() : 0;
     });
-    let html = `
+    let html = `<p>This list includes the latest vital signs, sorted by effective date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -2554,7 +2566,7 @@ var VitalSignsTemplate = class _VitalSignsTemplate {
         <tbody>`;
     for (const obs of observations) {
       html += `
-          <tr id="${templateUtilities.narrativeLinkId(obs)}">
+          <tr>
             <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(obs.code, "display"))}</td>
             <td>${templateUtilities.codeableConceptCoding(obs.code)}</td>
             <td>${templateUtilities.extractObservationValue(obs)}</td>
@@ -2592,7 +2604,7 @@ var MedicalDevicesTemplate = class _MedicalDevicesTemplate {
    */
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = `
+    let html = `<p>This list includes all DeviceUseStatement resources, sorted by recorded date (most recent first).</p>
       <table>
         <thead>
           <tr>
@@ -2610,7 +2622,7 @@ var MedicalDevicesTemplate = class _MedicalDevicesTemplate {
     });
     for (const dus of deviceStatements) {
       html += `
-        <tr id="${templateUtilities.narrativeLinkId(dus)}">
+        <tr>
           <td>${templateUtilities.renderTextAsHtml(templateUtilities.renderDevice(dus.device))}</td>
           <td>${templateUtilities.renderTextAsHtml(dus.status || "")}</td>
           <td>${templateUtilities.renderNotes(dus.note, timezone)}</td>
@@ -2971,11 +2983,12 @@ var DiagnosticResultsTemplate = class _DiagnosticResultsTemplate {
         }
       }
     }
-    let html = `
-      <div>`;
+    let html = `<p>This section includes Observations from the last 2 years (one per lab name, using code mapping) and DiagnosticReports with status 'final' issued in the last 2 years. Both are sorted by date (most recent first). Older results are counted and noted below the tables.</p>
+`;
     let observationhtml = `
       <div>
         <h3>Observations</h3>
+      ${html}
         <table>
           <thead>
             <tr>
@@ -2991,6 +3004,7 @@ var DiagnosticResultsTemplate = class _DiagnosticResultsTemplate {
     let diagnosticReporthtml = `
       <div>
         <h3>Diagnostic Reports</h3>
+        ${html}
         <table>
           <thead>
             <tr>
@@ -3161,7 +3175,8 @@ var DiagnosticResultsTemplate = class _DiagnosticResultsTemplate {
     const currentDate = now || /* @__PURE__ */ new Date();
     const twoYearsAgo = new Date(currentDate);
     twoYearsAgo.setFullYear(currentDate.getFullYear() - 2);
-    let html = "";
+    let html = `<p>This section includes Observations from the last 2 years (one per lab name, using code mapping) and DiagnosticReports with status 'final' issued in the last 2 years. Both are sorted by date (most recent first). Older results are counted and noted below the tables.</p>
+`;
     let skippedObservations = 0;
     let skippedDiagnosticReports = 0;
     for (const resourceItem of resources) {
@@ -3423,7 +3438,9 @@ var HistoryOfProceduresTemplate = class _HistoryOfProceduresTemplate {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes all Procedure resources, sorted by performed date (most recent first).</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -3484,7 +3501,9 @@ var HistoryOfProceduresTemplate = class _HistoryOfProceduresTemplate {
    */
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = `
+    let html = `<p>This list includes all Procedure resources, sorted by performed date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -3499,12 +3518,12 @@ var HistoryOfProceduresTemplate = class _HistoryOfProceduresTemplate {
     for (const resourceItem of resources) {
       const proc = resourceItem;
       html += `
-        <tr id="${templateUtilities.narrativeLinkId(proc)}">
+        <tr>
           <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(proc.code, "display"))}</td>
-           <td>${templateUtilities.codeableConceptCoding(proc.code)}</td>
+          <td>${templateUtilities.codeableConceptCoding(proc.code)}</td>
           <td>${templateUtilities.renderNotes(proc.note, timezone)}</td>
-          <td>${proc.performedDateTime ? templateUtilities.renderTime(proc.performedDateTime, timezone) : proc.performedPeriod ? templateUtilities.renderPeriod(proc.performedPeriod, timezone) : ""}</td>
-            <td>${templateUtilities.getOwnerTag(proc)}</td>
+          <td>${templateUtilities.renderTime(proc.performedDateTime || proc.performedPeriod?.start, timezone)}</td>
+          <td>${templateUtilities.getOwnerTag(proc)}</td>
         </tr>`;
     }
     html += `
@@ -3539,7 +3558,9 @@ var SocialHistoryTemplate = class _SocialHistoryTemplate {
       const dateB = b.effectiveDateTime || b.effectivePeriod?.start;
       return dateA && dateB ? new Date(dateB).getTime() - new Date(dateA).getTime() : 0;
     });
-    let html = `
+    let html = `<p>This list includes all information about the patient's social history, sorted by effective date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -3555,7 +3576,7 @@ var SocialHistoryTemplate = class _SocialHistoryTemplate {
         <tbody>`;
     for (const obs of observations) {
       html += `
-          <tr id="${templateUtilities.narrativeLinkId(obs)}">
+          <tr>
             <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(obs.code))}</td>
             <td>${templateUtilities.codeableConceptCoding(obs.code)}</td>
             <td>${templateUtilities.extractObservationValue(obs)}</td>
@@ -3583,7 +3604,8 @@ var PastHistoryOfIllnessTemplate = class {
    */
   generateNarrative(resources, timezone, now) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = ``;
+    let html = `<p>This list includes past problems for the patient with a recorded date within the last 5 years, sorted by recorded date (most recent first).</p>
+`;
     const resolvedConditions = resources.map((entry) => entry) || [];
     const currentDate = now || /* @__PURE__ */ new Date();
     const fiveYearsAgo = new Date(currentDate);
@@ -3620,7 +3642,7 @@ var PastHistoryOfIllnessTemplate = class {
       const conditionCode = templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(cond.code));
       if (!addedConditionCodes.has(conditionCode)) {
         addedConditionCodes.add(conditionCode);
-        html += `<tr id="${templateUtilities.narrativeLinkId(cond)}">
+        html += `<tr>
             <td class="Name">${conditionCode}</td>
             <td class="CodeSystem">${templateUtilities.codeableConceptCoding(cond.code)}</td>
             <td class="OnsetDate">${templateUtilities.renderDate(cond.onsetDateTime)}</td>
@@ -3656,7 +3678,9 @@ var PlanOfCareTemplate = class {
       const endB = b.period?.end ? new Date(b.period?.end).getTime() : 0;
       return endB - endA;
     });
-    let html = `
+    let html = `<p>This list includes all CarePlan resources, sorted by planned end date (most recent first).</p>
+`;
+    html += `
       <table>
         <thead>
           <tr>
@@ -3694,7 +3718,9 @@ var PlanOfCareTemplate = class {
   generateSummaryNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
     let isSummaryCreated = false;
-    let html = `
+    let html = `<p>This list includes all CarePlan resources, sorted by planned end date (most recent first).</p>
+`;
+    html += `
       <div>
         <table>
           <thead>
@@ -3756,7 +3782,7 @@ var FunctionalStatusTemplate = class _FunctionalStatusTemplate {
    */
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = "";
+    let html = `<p>This section summarizes key observations and assessments related to the person's functional status and ability to perform daily activities.</p>`;
     let functionalObservations = resources.filter((r) => r.resourceType === "Observation").filter((r) => {
       const hasFunctionalLoinc = r.code?.coding?.some(
         (c) => c.system?.toLowerCase().includes("loinc") && c.code === "47420-5"
@@ -3880,7 +3906,8 @@ var PregnancyTemplate = class _PregnancyTemplate {
     if (!pregnancyStatusObs && !eddObs && historyObs.length === 0 && conditions.length === 0) {
       return `<p>No history of pregnancy found.</p>`;
     }
-    let html = `
+    let html = `<p>This list includes Observation and Condition resources relevant to pregnancy, sorted by date (most recent first).</p>`;
+    html += `
             <table>
               <thead>
                 <tr>
@@ -3985,8 +4012,9 @@ var AdvanceDirectivesTemplate = class _AdvanceDirectivesTemplate {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   static generateStaticNarrative(resources, timezone) {
     const templateUtilities = new TemplateUtilities(resources);
-    let html = `
-      <table>
+    let html = `<p>This list includes all Consent resources, sorted by date (most recent first).</p>
+`;
+    html += `<table>
         <thead>
           <tr>
             <th>Scope</th>
@@ -3999,7 +4027,7 @@ var AdvanceDirectivesTemplate = class _AdvanceDirectivesTemplate {
     for (const resourceItem of resources) {
       const consent = resourceItem;
       html += `
-        <tr id="${templateUtilities.narrativeLinkId(consent)}">
+        <tr>
           <td>${templateUtilities.renderTextAsHtml(templateUtilities.codeableConceptDisplay(consent.scope, "display"))}</td>
           <td>${consent.status || ""}</td>
           <td>${consent.provision?.action ? templateUtilities.concatCodeableConcept(consent.provision.action) : ""}</td>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imranq2/fhirpatientsummary",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "A template for creating npm packages using TypeScript and VSCode",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",