babelfhir-ts 1.1.4 → 1.2.0

package/README.md

@@ -35,38 +35,104 @@ Every pull request runs two independent CI pipelines that validate generated cod
 4. Generates `empty()` and `random()` test resources for every profile
 5. Validates those resources against two external FHIR validators
 
-### Tested Implementation Guides
+### Tested Implementation Guides (28 packages)
 
-| Implementation Guide | Package | Profiles |
+| Category | Implementation Guide | Package |
 |---|---|---|
-| US Core | `hl7.fhir.us.core@8.0.0` | Patient, Condition, Observation, Encounter, … |
-| ISiK Basis (Germany) | `de.gematik.isik-basismodul@4.0.3` | ISiKPatient, ISiKDiagnose, … |
-| IPS (International Patient Summary) | `hl7.fhir.uv.ips@2.0.0` | Composition, MedicationStatement, … |
-| SMART App Launch | `hl7.fhir.uv.smart-app-launch@2.2.0` | WellKnown endpoints |
-| CH Core (Switzerland) | `ch.fhir.ig.ch-core@5.0.0` | CHCorePatient, CHCoreEncounter, … |
-| DaVinci PAS | `hl7.fhir.us.davinci-pas@2.0.1` | PASClaim, PASClaimResponse, … |
+| US | US Core | `hl7.fhir.us.core@8.0.0` |
+| US | QI-Core | `hl7.fhir.us.qicore@6.0.0` |
+| US | mCODE | `hl7.fhir.us.mcode@4.0.0` |
+| US | SDOH Clinical Care | `hl7.fhir.us.sdoh-clinicalcare@2.2.0` |
+| US | NDH (National Directory) | `hl7.fhir.us.ndh@1.0.0` |
+| US | CARIN BB | `hl7.fhir.us.carin-bb@2.1.0` |
+| US | CQF Measures | `hl7.fhir.us.cqfmeasures@4.0.0` |
+| US | Physical Activity | `hl7.fhir.us.physical-activity@1.0.0` |
+| DaVinci | PAS | `hl7.fhir.us.davinci-pas@2.0.1` |
+| DaVinci | CDex | `hl7.fhir.us.davinci-cdex@2.1.0` |
+| DaVinci | PDex | `hl7.fhir.us.davinci-pdex@2.1.0` |
+| DaVinci | DTR | `hl7.fhir.us.davinci-dtr@2.1.0` |
+| DaVinci | Alerts | `hl7.fhir.us.davinci-alerts@1.0.0` |
+| DaVinci | DEQM | `hl7.fhir.us.davinci-deqm@4.0.0` |
+| DaVinci | Drug Formulary | `hl7.fhir.us.davinci-drug-formulary@2.1.0` |
+| Universal | IPS | `hl7.fhir.uv.ips@2.0.0` |
+| Universal | SMART App Launch | `hl7.fhir.uv.smart-app-launch@2.2.0` |
+| Universal | SDC (Structured Data Capture) | `hl7.fhir.uv.sdc@3.0.0` |
+| Universal | Genomics Reporting | `hl7.fhir.uv.genomics-reporting@3.0.0` |
+| Universal | CPG (Clinical Practice Guidelines) | `hl7.fhir.uv.cpg@2.0.0` |
+| DE | ISiK Basis | `de.gematik.isik-basismodul@4.0.3` |
+| DE | ISiK Medikation | `de.gematik.isik-medikation@4.0.1` |
+| DE | KBV eRezept | `kbv.ita.erp@1.1.1` |
+| DE | DE Basisprofil | `de.basisprofil.r4@1.5.0` |
+| CH | CH Core (Switzerland) | `ch.fhir.ig.ch-core@5.0.0` |
+| AU | AU Core (Australia) | `hl7.fhir.au.core@1.0.0` |
+| IHE | PIXm | `ihe.iti.pixm@3.0.4` |
+| IHE | MHD | `ihe.iti.mhd@4.2.2` |
 
 ### Validation with Firely .NET SDK
 
-The first pipeline validates generated resources using the [Firely .NET SDK validator](https://docs.fire.ly/projects/Firely-NET-SDK/) (v3.1.0). Results are published as live badges:
-
-![US Core 8.0.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-us-core.json)
-![ISiK Basis 4.0.3](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-isik-basis.json)
-![IPS 2.0.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-ips.json)
-![SMART 2.2.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-smart.json)
-![CH Core 5.0.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-ch-core.json)
-![DaVinci PAS 2.0.1](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-pas.json)
+The first pipeline validates generated resources using the [Firely .NET SDK validator](https://docs.fire.ly/projects/Firely-NET-SDK/) (Firely.Fhir.Validation.R4 v3.1.1). Results are published as live badges:
+
+![US Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-us-core.json)
+![QI-Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-qicore.json)
+![mCODE](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-mcode.json)
+![SDOH](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-sdoh.json)
+![NDH](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-ndh.json)
+![CARIN BB](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-carin-bb.json)
+![CQF Measures](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-cqfmeasures.json)
+![Physical Activity](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-physical-activity.json)
+![DaVinci PAS](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-pas.json)
+![DaVinci CDex](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-cdex.json)
+![DaVinci PDex](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-pdex.json)
+![DaVinci DTR](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-dtr.json)
+![DaVinci Alerts](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-alerts.json)
+![DaVinci DEQM](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-deqm.json)
+![DaVinci Drug Formulary](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-davinci-drug-formulary.json)
+![IPS](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-ips.json)
+![SMART](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-smart.json)
+![SDC](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-sdc.json)
+![Genomics Reporting](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-genomics-reporting.json)
+![CPG](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-cpg.json)
+![ISiK Basis](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-isik-basis.json)
+![ISiK Medikation](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-isik-medikation.json)
+![KBV eRezept](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-kbv-erp.json)
+![DE Basisprofil](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-de-basisprofil.json)
+![CH Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-ch-core.json)
+![AU Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-au-core.json)
+![PIXm](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-pixm.json)
+![MHD](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-mhd.json)
 
 ### Validation with HL7 Java Validator
 
-The second pipeline validates using the [official HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) (v6.9.1), the reference implementation for FHIR conformance checking:
-
-![US Core 8.0.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-us-core.json)
-![ISiK Basis 4.0.3](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-isik-basis.json)
-![IPS 2.0.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-ips.json)
-![SMART 2.2.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-smart.json)
-![CH Core 5.0.0](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-ch-core.json)
-![DaVinci PAS 2.0.1](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-pas.json)
+The second pipeline validates using the [official HL7 FHIR Validator](https://confluence.hl7.org/display/FHIR/Using+the+FHIR+Validator) (v6.9.4), the reference implementation for FHIR conformance checking:
+
+![US Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-us-core.json)
+![QI-Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-qicore.json)
+![mCODE](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-mcode.json)
+![SDOH](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-sdoh.json)
+![NDH](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-ndh.json)
+![CARIN BB](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-carin-bb.json)
+![CQF Measures](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-cqfmeasures.json)
+![Physical Activity](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-physical-activity.json)
+![DaVinci PAS](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-pas.json)
+![DaVinci CDex](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-cdex.json)
+![DaVinci PDex](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-pdex.json)
+![DaVinci DTR](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-dtr.json)
+![DaVinci Alerts](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-alerts.json)
+![DaVinci DEQM](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-deqm.json)
+![DaVinci Drug Formulary](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-davinci-drug-formulary.json)
+![IPS](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-ips.json)
+![SMART](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-smart.json)
+![SDC](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-sdc.json)
+![Genomics Reporting](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-genomics-reporting.json)
+![CPG](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-cpg.json)
+![ISiK Basis](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-isik-basis.json)
+![ISiK Medikation](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-isik-medikation.json)
+![KBV eRezept](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-kbv-erp.json)
+![DE Basisprofil](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-de-basisprofil.json)
+![CH Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-ch-core.json)
+![AU Core](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-au-core.json)
+![PIXm](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-pixm.json)
+![MHD](https://img.shields.io/endpoint?url=https://max-health-inc.github.io/BabelFHIR-TS/badges/badge-hl7-mhd.json)
 
 > Terminology validation requires a tx server. The pipeline uses `--tx-server https://tx.fhir.org/r4` during generation to expand ValueSets and produce valid codes.
 
@@ -194,4 +260,4 @@ For security issues, please see [SECURITY.md](SECURITY.md) for our security poli
 - [GitHub repository](https://github.com/Max-Health-Inc/BabelFHIR-TS)
 - [Validation report](https://max-health-inc.github.io/BabelFHIR-TS/)
 - [Issue tracker](https://github.com/Max-Health-Inc/BabelFHIR-TS/issues)
-- [Changelog](CHANGELOG.md)
+- [Changelog / Releases](https://github.com/Max-Health-Inc/BabelFHIR-TS/releases)

package/out/fhir-r4.d.ts

@@ -673,4 +673,8 @@ declare module 'fhir/r4' {
   export type VisionPrescription = fhir4.VisionPrescription;
   export type VisionPrescriptionLensSpecification = fhir4.VisionPrescriptionLensSpecification;
   export type VisionPrescriptionLensSpecificationPrism = fhir4.VisionPrescriptionLensSpecificationPrism;
+  /** Constraint profile on Quantity — missing from @types/fhir */
+  export type MoneyQuantity = fhir4.Quantity;
+  /** Constraint profile on Quantity — missing from @types/fhir */
+  export type SimpleQuantity = fhir4.Quantity;
 }

package/out/fhir-r4b.d.ts

@@ -693,4 +693,8 @@ declare module 'fhir/r4b' {
   export type VisionPrescription = fhir4b.VisionPrescription;
   export type VisionPrescriptionLensSpecification = fhir4b.VisionPrescriptionLensSpecification;
   export type VisionPrescriptionLensSpecificationPrism = fhir4b.VisionPrescriptionLensSpecificationPrism;
+  /** Constraint profile on Quantity — missing from @types/fhir */
+  export type MoneyQuantity = fhir4b.Quantity;
+  /** Constraint profile on Quantity — missing from @types/fhir */
+  export type SimpleQuantity = fhir4b.Quantity;
 }

package/out/src/generator/core/constants.js

@@ -81,7 +81,7 @@ export const DEFAULT_COUNTRY = 'XX';
 export const DEFAULT_BASE64 = 'ZXhhbXBsZQ=='; // "example"
 export const DEFAULT_BASE64_HELLO = 'SGVsbG8gV29ybGQ='; // "Hello World"
 export const DEFAULT_CONTENT_TYPE = 'application/pdf';
-export const EXAMPLE_ID_SYSTEM = 'https://acme.org/ids';
+export const EXAMPLE_ID_SYSTEM = 'https://babelfhir.dev/ids';
 // ─── Resource status defaults (data-driven map) ─────────────────────────────
 // ─── Preferred code values ───────────────────────────────────────────────────
 //
@@ -150,7 +150,11 @@ export const VALUESET_DEFAULTS = {
     'http://hl7.org/fhir/uv/ips/ValueSet/results-status-uv-ips': { code: 'final' },
     'http://hl7.org/fhir/uv/ips/ValueSet/imaging-study-status-uv-ips': { code: 'available' },
     'http://hl7.org/fhir/us/davinci-hrex/ValueSet/hrex-task-status': { code: 'requested' },
+    'http://hl7.org/fhir/us/physical-activity/ValueSet/pa-task-status': { code: 'requested' },
     'http://fhir.de/ValueSet/EncounterStatusDe': { code: 'finished' },
+    // ── Narrative status ValueSets ─────────────────────────────────────────
+    'http://hl7.org/fhir/ValueSet/narrative-status': { code: 'generated' },
+    'http://hl7.org/fhir/us/core/ValueSet/us-core-narrative-status': { code: 'generated' },
     // ── CodeableConcept clinical status (required binding) ────────────────────
     'http://hl7.org/fhir/ValueSet/condition-clinical': { system: TS.CONDITION_CLINICAL, code: 'active' },
     'http://hl7.org/fhir/ValueSet/condition-ver-status': { system: TS.CONDITION_VER_STATUS, code: 'confirmed' },
@@ -169,6 +173,28 @@ export const VALUESET_DEFAULTS = {
     'http://hl7.org/fhir/ValueSet/subscriber-relationship': { system: TS.SUBSCRIBER_REL, code: 'self' },
     'http://hl7.org/fhir/ValueSet/c80-doc-typecodes': { system: TS.LOINC, code: '34133-9', display: 'Summary of episode note' },
     'http://hl7.org/fhir/ValueSet/document-classcodes': { system: TS.LOINC, code: '34133-9' },
+    // ── Additional status ValueSets for specific resource types ───────────────
+    'http://hl7.org/fhir/ValueSet/clinicalimpression-status': { code: 'completed' },
+    'http://hl7.org/fhir/ValueSet/verificationresult-status': { code: 'attested' },
+    'http://hl7.org/fhir/ValueSet/list-status': { code: 'current' },
+    'http://hl7.org/fhir/ValueSet/consent-state-codes': { code: 'active' },
+    'http://hl7.org/fhir/ValueSet/publication-status': { code: 'active' },
+    // ── Group type ValueSet (code type, required binding) ───────────────────────
+    'http://hl7.org/fhir/ValueSet/group-type': { code: 'person' },
+    // ── Consent ValueSets (code type, required binding) ────────────────────────
+    'http://hl7.org/fhir/ValueSet/consent-provision-type': { code: 'permit' },
+    'http://hl7.org/fhir/ValueSet/consent-data-meaning': { code: 'instance' },
+    // ── Code fields for definition resources (PlanDefinition, ActivityDefinition) ─
+    'http://hl7.org/fhir/ValueSet/action-condition-kind': { code: 'applicability' },
+    'http://hl7.org/fhir/ValueSet/action-relationship-type': { code: 'before-start' },
+    'http://hl7.org/fhir/ValueSet/action-participant-type': { code: 'practitioner' },
+    'http://hl7.org/fhir/ValueSet/request-resource-types': { code: 'Task' },
+    'http://hl7.org/fhir/ValueSet/resource-types': { code: 'Patient' },
+    'http://hl7.org/fhir/ValueSet/FHIR-version': { code: '4.0.1' },
+    // ── Claim/EoB ValueSets (CARIN BB) ────────────────────────────────────────
+    'http://hl7.org/fhir/ValueSet/claim-type': { system: 'http://terminology.hl7.org/CodeSystem/claim-type', code: 'institutional' },
+    'http://hl7.org/fhir/ValueSet/process-priority': { code: 'normal' },
+    'http://hl7.org/fhir/ValueSet/remittance-outcome': { code: 'complete' },
 };
 /**
  * Look up a safe default for a given ValueSet binding URI.
@@ -255,18 +281,61 @@ const procedure = (mp) => `{ resourceType: 'Procedure', id: randomId()${mp}, sta
 const device = (mp) => `{ resourceType: 'Device', id: randomId()${mp}, type: { coding: [{ system: '${TS.SNOMED}', code: '49062001', display: 'Device' }] } }`;
 const claimResponse = (mp) => `{ resourceType: 'ClaimResponse', id: randomId()${mp}, status: 'active', type: { coding: [{ system: '${TS.CLAIM_TYPE}', code: 'professional' }] }, use: 'preauthorization', patient: { reference: 'Patient/' + randomId() }, created: new Date().toISOString().split('T')[0], insurer: { reference: 'Organization/' + randomId() }, outcome: 'complete' }`;
 const claim = (mp) => `{ resourceType: 'Claim', id: randomId()${mp}, status: 'active', type: { coding: [{ system: '${TS.CLAIM_TYPE}', code: 'professional' }] }, use: 'preauthorization', patient: { reference: 'Patient/' + randomId() }, created: new Date().toISOString().split('T')[0], provider: { reference: 'Practitioner/' + randomId() }, priority: { coding: [{ system: '${TS.PROCESS_PRIORITY}', code: 'normal' }] }, insurance: [{ sequence: 1, focal: true, coverage: { reference: 'Coverage/' + randomId() } }] }`;
+/**
+ * Placeholder values for Composition fields that profiles may require (min >= 1)
+ * but the base skeleton does not include.
+ */
+const COMPOSITION_FIELD_PLACEHOLDERS = {
+    identifier: `identifier: { value: 'example-id', system: 'urn:ietf:rfc:3986' }`,
+    language: `language: 'en'`,
+    confidentiality: `confidentiality: 'N'`,
+    category: `category: [{ coding: [{ system: '${TS.LOINC}', code: '11503-0' }] }]`,
+    encounter: `encounter: { reference: 'Encounter/' + randomId() }`,
+    custodian: `custodian: { reference: 'Organization/' + randomId() }`,
+    attester: `attester: [{ mode: 'professional', party: { reference: 'Practitioner/' + randomId() } }]`,
+    event: `event: [{ period: { start: '2024-01-01' } }]`,
+    relatesTo: `relatesTo: [{ code: 'replaces', targetReference: { reference: 'Composition/' + randomId() } }]`,
+};
 export function compositionSkeleton(metaProfile, opts = {}) {
     const loincCode = opts.loincCode ?? '60591-5';
     const textStatus = opts.textStatus ?? 'generated';
     const sectionExpr = opts.sections && opts.sections.length > 0
         ? opts.sections.map(s => `{ title: '${s.title}', code: { coding: [{ system: '${TS.LOINC}', code: '${s.loincCode}' }] }, text: { status: 'generated', div: '<div xmlns="http://www.w3.org/1999/xhtml">${s.title}</div>' }, emptyReason: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/list-empty-reason', code: 'unavailable', display: 'Unavailable' }] } }`).join(', ')
         : `{ title: 'Section', text: { status: 'generated', div: '<div xmlns="http://www.w3.org/1999/xhtml">Content</div>' } }`;
-    return `{ resourceType: 'Composition', id: 'comp-' + randomId()${metaProfile}, text: { status: '${textStatus}', div: '<div xmlns="http://www.w3.org/1999/xhtml">Composition Narrative</div>' }, status: 'final', type: { coding: [{ system: '${TS.LOINC}', code: '${loincCode}' }], text: '${loincCode}' }, subject: { reference: 'Patient/' + randomId(), display: 'Example Patient' }, date: new Date().toISOString(), author: [{ reference: 'Practitioner/' + randomId(), display: 'Example Practitioner' }], title: 'Document Title', section: [${sectionExpr}] }`;
+    // Build extra fields required by the Composition profile but not in the base skeleton
+    const extraFields = (opts.requiredFields ?? [])
+        .map(f => COMPOSITION_FIELD_PLACEHOLDERS[f])
+        .filter(Boolean)
+        .join(', ');
+    const extraExpr = extraFields ? `, ${extraFields}` : '';
+    // Build primitive extensions (e.g., _confidentiality with required extension)
+    const primExtParts = [];
+    for (const pe of (opts.primitiveExtensions ?? [])) {
+        // Default to valueCodeableConcept with data-absent-reason (always valid, avoids example URL bans)
+        const valueExpr = pe.valueType === 'string'
+            ? `valueString: 'placeholder'`
+            : `valueCodeableConcept: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/data-absent-reason', code: 'unknown' }] }`;
+        primExtParts.push(`'_${pe.field}': { extension: [{ url: '${pe.url}', ${valueExpr} }] }`);
+    }
+    const primExtExpr = primExtParts.length > 0 ? `, ${primExtParts.join(', ')}` : '';
+    return `{ resourceType: 'Composition', id: 'comp-' + randomId()${metaProfile}${extraExpr}${primExtExpr}, text: { status: '${textStatus}', div: '<div xmlns="http://www.w3.org/1999/xhtml">Composition Narrative</div>' }, status: 'final', type: { coding: [{ system: '${TS.LOINC}', code: '${loincCode}' }], text: '${loincCode}' }, subject: { reference: 'Patient/' + randomId(), display: 'Example Patient' }, date: new Date().toISOString(), author: [{ reference: 'Practitioner/' + randomId(), display: 'Example Practitioner' }], title: 'Document Title', section: [${sectionExpr}] }`;
 }
 /**
  * Registry of resource skeletons indexed by resource type.
  * Used for inline resource generation (Bundle entry.resource, slice fallbacks).
  */
+const group = (mp) => {
+    // Profile-specific code: pdex-member-match-group requires code from PDexMultiMemberMatchResultVS
+    const code = mp.includes('pdex-member-match-group')
+        ? `code: { coding: [{ system: 'http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMultiMemberMatchResultCS', code: 'match' }] }, `
+        : '';
+    return `{ resourceType: 'Group', id: randomId()${mp}, type: 'person', actual: true, ${code}}`;
+};
+const coverage = (mp) => `{ resourceType: 'Coverage', id: randomId()${mp}, status: 'active', subscriberId: randomId(), beneficiary: { reference: 'Patient/' + randomId() }, relationship: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/subscriber-relationship', code: 'self' }] }, payor: [{ reference: 'Organization/' + randomId() }] }`;
+const consent = (mp) => `{ resourceType: 'Consent', id: randomId()${mp}, status: 'active', scope: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/consentscope', code: 'patient-privacy' }] }, category: [{ coding: [{ system: '${TS.ACT_CODE}', code: 'IDSCL' }] }], patient: { reference: 'Patient/' + randomId() }, performer: [{ reference: 'Organization/' + randomId() }], sourceReference: { reference: 'DocumentReference/' + randomId() }, policy: [{ uri: 'http://example.org/policy' }], provision: { type: 'permit', period: { start: '2024-01-01T00:00:00.000Z', end: '2025-01-01T00:00:00.000Z' }, actor: [{ role: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/provenance-participant-type', code: 'performer' }] }, reference: { reference: 'Organization/' + randomId() } }, { role: { coding: [{ system: 'http://terminology.hl7.org/CodeSystem/v3-ParticipationType', code: 'IRCP' }] }, reference: { reference: 'Organization/' + randomId() } }], action: [{ coding: [{ system: 'http://terminology.hl7.org/CodeSystem/consentaction', code: 'disclose' }] }] } }`;
+const list = (mp) => `{ resourceType: 'List', id: randomId()${mp}, status: 'current', mode: 'working', code: { coding: [{ system: '${TS.LOINC}', code: '57024-2' }] }, subject: { reference: 'Patient/' + randomId() }, date: new Date().toISOString() }`;
+const documentReference = (mp) => `{ resourceType: 'DocumentReference', id: randomId()${mp}, status: 'current', content: [{ attachment: { contentType: 'text/plain', url: 'https://babelfhir.dev/' + randomId() } }] }`;
+const binary = (mp) => `{ resourceType: 'Binary', id: randomId()${mp}, contentType: 'application/pdf', data: '${DEFAULT_BASE64}' }`;
 export const RESOURCE_SKELETONS = {
     Patient: patient,
     Practitioner: practitioner,
@@ -280,6 +349,12 @@ export const RESOURCE_SKELETONS = {
     Device: device,
     ClaimResponse: claimResponse,
     Claim: claim,
+    Group: group,
+    Coverage: coverage,
+    Consent: consent,
+    List: list,
+    DocumentReference: documentReference,
+    Binary: binary,
 };
 /**
  * Build a Bundle entry object expression from a skeleton.

package/out/src/generator/core/sdDiagnostics.js

@@ -0,0 +1,108 @@
+/**
+ * StructureDefinition Quality Diagnostics
+ *
+ * Collects structured diagnostics about SD quality issues discovered
+ * during code generation. Unlike log messages (which are transient),
+ * diagnostics are accumulated and emitted as a machine-readable report.
+ *
+ * This turns BabelFHIR-TS into a **profile validator** — not just a
+ * resource validator. When a profile has a structural flaw (unmatchable
+ * discriminator, missing snapshot, unresolvable type), we flag the
+ * *profile*, not the resources that happen to be validated against it.
+ */
+// ── Collector ────────────────────────────────────────────────────────────────
+const diagnostics = [];
+const knownProfiles = new Set();
+/** Reset all collected diagnostics (call before a new generation run). */
+export function resetDiagnostics() {
+    diagnostics.length = 0;
+    knownProfiles.clear();
+}
+/** Register a profile as processed (even if no diagnostics are emitted for it). */
+export function registerProfile(profileUrl, profileName) {
+    knownProfiles.add(profileUrl || profileName);
+}
+/** Record a diagnostic. */
+export function addDiagnostic(d) {
+    diagnostics.push(d);
+    knownProfiles.add(d.profileUrl || d.profileName);
+}
+/** Get all collected diagnostics. */
+export function getDiagnostics() {
+    return diagnostics;
+}
+/** Build the final quality report. */
+export function buildQualityReport() {
+    const profiles = {};
+    const affectedUrls = new Set();
+    for (const d of diagnostics) {
+        const key = d.profileUrl || d.profileName;
+        affectedUrls.add(key);
+        if (!profiles[key]) {
+            profiles[key] = {
+                profileUrl: d.profileUrl,
+                profileName: d.profileName,
+                diagnostics: [],
+            };
+        }
+        profiles[key].diagnostics.push({
+            severity: d.severity,
+            category: d.category,
+            elementPath: d.elementPath,
+            message: d.message,
+            impact: d.impact,
+        });
+    }
+    return {
+        generated: new Date().toISOString(),
+        summary: {
+            errors: diagnostics.filter(d => d.severity === 'error').length,
+            warnings: diagnostics.filter(d => d.severity === 'warning').length,
+            info: diagnostics.filter(d => d.severity === 'info').length,
+            profilesAffected: affectedUrls.size,
+            profilesClean: knownProfiles.size - affectedUrls.size,
+        },
+        profiles,
+    };
+}
+/** Format the report as a human-readable CLI summary. */
+export function formatReportSummary(report) {
+    const { summary } = report;
+    const total = summary.errors + summary.warnings + summary.info;
+    if (total === 0) {
+        return `\n✅ SD Quality: ${summary.profilesClean} profiles analyzed, no issues detected.\n`;
+    }
+    const lines = [];
+    lines.push('');
+    lines.push(`🔍 SD Quality Report: ${total} issue(s) across ${summary.profilesAffected} profile(s)`);
+    if (summary.errors > 0)
+        lines.push(`   ❌ ${summary.errors} error(s) — structural flaws that will cause validator false positives`);
+    if (summary.warnings > 0)
+        lines.push(`   ⚠️  ${summary.warnings} warning(s) — constraints that cannot be fully evaluated`);
+    if (summary.info > 0)
+        lines.push(`   ℹ️  ${summary.info} info — limitations noted`);
+    lines.push(`   ✅ ${summary.profilesClean} profile(s) are clean`);
+    lines.push('');
+    // Group by category for a compact view
+    const byCat = new Map();
+    for (const d of diagnostics) {
+        if (!byCat.has(d.category))
+            byCat.set(d.category, []);
+        byCat.get(d.category).push(d);
+    }
+    const catLabels = {
+        discriminator: 'Discriminator defects',
+        snapshot: 'Missing/incomplete snapshots',
+        type: 'Unresolvable element types',
+        constraint: 'Unevaluable FHIRPath constraints',
+        binding: 'Unresolvable ValueSet bindings',
+        'profile-ref': 'Profile reference failures',
+        structure: 'Structural issues',
+    };
+    for (const [cat, items] of byCat) {
+        const profiles = new Set(items.map(d => d.profileName));
+        lines.push(`   ${catLabels[cat]}: ${items.length} (${profiles.size} profile(s))`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}

package/out/src/generator/core/utils.js

@@ -17,7 +17,7 @@ export function stripVersionFromCanonicalUrl(url) {
 export function writeInterfaceAndValidatorToFile(outputDir, interfaceName, interfaceContent, validateFunctionContent) {
     const filePath = path.join(outputDir, `${interfaceName}.ts`);
     const content = `${interfaceContent}\n\n${validateFunctionContent}`;
-    fs.writeFileSync(filePath, content, "utf-8");
+    caseAwareWriteFile(filePath, content);
 }
 export function extractFieldsFromInterface(interfaceDecl) {
     return interfaceDecl.getProperties().map((property) => {
@@ -188,9 +188,29 @@ export function ensureDirectoryExists(dirPath) {
 }
 /**
  * Writes content to a file at the specified path.
+ * On case-insensitive filesystems (Windows/macOS), removes any existing file
+ * whose name differs only in casing to prevent TS1261 errors.
  */
 export function writeToFile(filePath, content) {
-    fs.writeFileSync(filePath, content, "utf-8");
+    caseAwareWriteFile(filePath, content);
+}
+/**
+ * Writes a file, first removing any existing file with the same case-insensitive
+ * name but different casing. Prevents TS1261/TS1149 on case-insensitive filesystems.
+ */
+function caseAwareWriteFile(filePath, content) {
+    const dir = path.dirname(filePath);
+    const filename = path.basename(filePath);
+    if (fs.existsSync(dir)) {
+        const filenameLower = filename.toLowerCase();
+        for (const entry of fs.readdirSync(dir)) {
+            if (entry.toLowerCase() === filenameLower && entry !== filename) {
+                fs.unlinkSync(path.join(dir, entry));
+                break;
+            }
+        }
+    }
+    fs.writeFileSync(filePath, content, 'utf-8');
 }
 /**
  * Extracts the base resource name from a baseDefinition URL.