gdc-common-utils-ts 2.3.7 → 2.3.9

package/dist/constants/healthcare.d.ts

@@ -1724,6 +1724,8 @@ export declare const HealthcareActorRoles: Readonly<{
     readonly MidwiferyProfessional: "ISCO-08|2222";
     readonly Paramedic: "ISCO-08|2240";
     readonly Veterinarian: "ISCO-08|2250";
+    /** Administrative health occupation; it does not imply clinical authority. */
+    readonly MedicalSecretary: "ISCO-08|3344";
 }>;
 export declare const HealthcareActorRoleCodes: Readonly<{
     readonly Controller: "1120";
@@ -1744,6 +1746,7 @@ export declare const HealthcareActorRoleCodes: Readonly<{
     readonly MidwiferyProfessional: "2222";
     readonly Paramedic: "2240";
     readonly Veterinarian: "2250";
+    readonly MedicalSecretary: "3344";
 }>;
 export declare const HealthcareRolesByFamily: Readonly<{
     readonly professionalOccupationIsco08: Readonly<Record<string, Readonly<{
@@ -1776,15 +1779,15 @@ export declare const HealthcareRolesByFamily: Readonly<{
 }>;
 export declare const HealthcareAllRolesByClaim: Readonly<Record<string, HealthcareActorRoleDescriptor>>;
 export declare const HealthcareProfessionalRoleCodesBySector: Readonly<{
-    readonly "health-care": readonly ("1120" | "221" | "2211" | "2212" | "2221" | "2222" | "2240")[];
-    readonly "health-research": readonly ("1120" | "221" | "2211" | "2212")[];
+    readonly "health-care": readonly ("1120" | "221" | "2211" | "2212" | "2221" | "2222" | "2240" | "3344")[];
+    readonly "health-research": readonly ("1120" | "221" | "2211" | "2212" | "3344")[];
     readonly "health-tech": readonly "1120"[];
     readonly "health-insurance": readonly "1120"[];
     readonly "animal-care": readonly ("1120" | "2250")[];
     readonly "animal-research": readonly ("1120" | "2250")[];
     readonly "animal-insurance": readonly "1120"[];
     readonly "animal-tech": readonly "1120"[];
-    readonly "onehealth-research": readonly ("1120" | "221" | "2211" | "2212" | "2250")[];
+    readonly "onehealth-research": readonly ("1120" | "221" | "2211" | "2212" | "2250" | "3344")[];
     readonly "onehealth-tech": readonly "1120"[];
 }>;
 export declare const HealthcareProfessionalRolesBySector: Readonly<{

package/dist/constants/healthcare.js

@@ -356,6 +356,8 @@ export const HealthcareActorRoles = Object.freeze({
     MidwiferyProfessional: 'ISCO-08|2222',
     Paramedic: 'ISCO-08|2240',
     Veterinarian: 'ISCO-08|2250',
+    /** Administrative health occupation; it does not imply clinical authority. */
+    MedicalSecretary: 'ISCO-08|3344',
 });
 export const HealthcareActorRoleCodes = Object.freeze({
     Controller: '1120',
@@ -376,6 +378,7 @@ export const HealthcareActorRoleCodes = Object.freeze({
     MidwiferyProfessional: '2222',
     Paramedic: '2240',
     Veterinarian: '2250',
+    MedicalSecretary: '3344',
 });
 function buildProfessionalIscoRoles() {
     const entries = [
@@ -467,6 +470,17 @@ function buildProfessionalIscoRoles() {
                 titleEn: 'Veterinarian',
             }),
         ],
+        [
+            HealthcareActorRoleCodes.MedicalSecretary,
+            Object.freeze({
+                family: HealthcareRoleFamilies.ProfessionalOccupationIsco08,
+                codingSystem: ISCO08_CODING_SYSTEM,
+                code: HealthcareActorRoleCodes.MedicalSecretary,
+                claim: HealthcareActorRoles.MedicalSecretary,
+                i18nKey: `${ISCO08_I18N_NAMESPACE}.${HealthcareActorRoleCodes.MedicalSecretary}`,
+                titleEn: 'Medical secretary',
+            }),
+        ],
     ];
     return Object.freeze(Object.fromEntries(entries));
 }
@@ -523,12 +537,14 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.NursingProfessional,
         HealthcareActorRoleCodes.MidwiferyProfessional,
         HealthcareActorRoleCodes.Paramedic,
+        HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.HealthResearch]: Object.freeze([
         HealthcareActorRoleCodes.Controller,
         HealthcareActorRoleCodes.MedicalDoctors,
         HealthcareActorRoleCodes.GeneralistMedicalPractitioner,
         HealthcareActorRoleCodes.SpecialistMedicalPractitioner,
+        HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.HealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),
     [DataspaceSectors.HealthInsurance]: Object.freeze([HealthcareActorRoleCodes.Controller]),
@@ -548,6 +564,7 @@ export const HealthcareProfessionalRoleCodesBySector = Object.freeze({
         HealthcareActorRoleCodes.GeneralistMedicalPractitioner,
         HealthcareActorRoleCodes.SpecialistMedicalPractitioner,
         HealthcareActorRoleCodes.Veterinarian,
+        HealthcareActorRoleCodes.MedicalSecretary,
     ]),
     [DataspaceSectors.OneHealthTech]: Object.freeze([HealthcareActorRoleCodes.Controller]),
 });

package/dist/convert/convert-allergy-intolerance.js

@@ -14,7 +14,19 @@ export function allergyIntoleranceFlatToFhirR4(claims) {
         resourceType: 'AllergyIntolerance',
         identifier: claims[AllergyIntoleranceClaim.Identifier] ? [{ value: claims[AllergyIntoleranceClaim.Identifier] }] : undefined,
         patient: { reference: patient },
-        code: claims[AllergyIntoleranceClaim.Code] ? { coding: codingFromValue(claims[AllergyIntoleranceClaim.Code]) } : undefined,
+        code: claims[AllergyIntoleranceClaim.Code]
+            ? {
+                coding: codingFromValue(claims[AllergyIntoleranceClaim.Code])?.map((coding) => ({
+                    ...coding,
+                    ...(claims[AllergyIntoleranceClaim.CodeDisplay]
+                        ? { display: claims[AllergyIntoleranceClaim.CodeDisplay] }
+                        : {}),
+                })),
+                ...(claims[AllergyIntoleranceClaim.CodeText]
+                    ? { text: claims[AllergyIntoleranceClaim.CodeText] }
+                    : {}),
+            }
+            : undefined,
         clinicalStatus: claims[AllergyIntoleranceClaim.ClinicalStatus] ? { coding: [{ code: claims[AllergyIntoleranceClaim.ClinicalStatus] }] } : undefined,
         verificationStatus: claims[AllergyIntoleranceClaim.VerificationStatus] ? { coding: [{ code: claims[AllergyIntoleranceClaim.VerificationStatus] }] } : undefined,
         category: claims[AllergyIntoleranceClaim.Category] ? [claims[AllergyIntoleranceClaim.Category]] : undefined,
@@ -31,6 +43,8 @@ export function allergyIntoleranceFhirR4ToFlat(resource) {
         [AllergyIntoleranceClaim.Subject]: subject,
         [AllergyIntoleranceClaim.Patient]: subject,
         [AllergyIntoleranceClaim.Code]: codingToValue(code?.coding?.[0]) || code?.text,
+        [AllergyIntoleranceClaim.CodeText]: code?.text,
+        [AllergyIntoleranceClaim.CodeDisplay]: code?.coding?.[0]?.display,
         [AllergyIntoleranceClaim.ClinicalStatus]: resource.clinicalStatus?.coding?.[0]?.code,
         [AllergyIntoleranceClaim.VerificationStatus]: resource.verificationStatus?.coding?.[0]?.code,
         [AllergyIntoleranceClaim.Category]: resource.category?.[0],

package/dist/convert/convert-condition.js

@@ -8,7 +8,19 @@ export function conditionFlatToFhirR4(claims) {
         resourceType: 'Condition',
         identifier: claims[ConditionClaim.Identifier] ? [{ value: claims[ConditionClaim.Identifier] }] : undefined,
         subject: { reference: subject },
-        code: claims[ConditionClaim.Code] ? { coding: codingFromValue(claims[ConditionClaim.Code]) } : undefined,
+        code: claims[ConditionClaim.Code]
+            ? {
+                coding: codingFromValue(claims[ConditionClaim.Code])?.map((coding) => ({
+                    ...coding,
+                    ...(claims[ConditionClaim.CodeDisplay]
+                        ? { display: claims[ConditionClaim.CodeDisplay] }
+                        : {}),
+                })),
+                ...(claims[ConditionClaim.CodeText]
+                    ? { text: claims[ConditionClaim.CodeText] }
+                    : {}),
+            }
+            : undefined,
         clinicalStatus: claims[ConditionClaim.ClinicalStatus] ? { coding: [{ code: claims[ConditionClaim.ClinicalStatus] }] } : undefined,
         verificationStatus: claims[ConditionClaim.VerificationStatus] ? { coding: [{ code: claims[ConditionClaim.VerificationStatus] }] } : undefined,
     };
@@ -19,6 +31,8 @@ export function conditionFhirR4ToFlat(resource) {
         [ConditionClaim.Identifier]: resource.identifier?.[0]?.value,
         [ConditionClaim.Subject]: resource.subject?.reference,
         [ConditionClaim.Code]: codingToValue(code?.coding?.[0]) || code?.text,
+        [ConditionClaim.CodeText]: code?.text,
+        [ConditionClaim.CodeDisplay]: code?.coding?.[0]?.display,
         [ConditionClaim.ClinicalStatus]: resource.clinicalStatus?.coding?.[0]?.code,
         [ConditionClaim.VerificationStatus]: resource.verificationStatus?.coding?.[0]?.code,
     };

package/dist/convert/convert-diagnostic-report.js

@@ -9,7 +9,13 @@ export function diagnosticReportFlatToFhirR4(claims) {
         identifier: claims[DiagnosticReportClaim.Identifier] ? [{ value: claims[DiagnosticReportClaim.Identifier] }] : undefined,
         status: claims[DiagnosticReportClaim.Status],
         category: claims[DiagnosticReportClaim.Category] ? [{ coding: codingFromValue(claims[DiagnosticReportClaim.Category]) }] : undefined,
-        code: claims[DiagnosticReportClaim.Code] ? { coding: codingFromValue(claims[DiagnosticReportClaim.Code]) } : undefined,
+        code: claims[DiagnosticReportClaim.Code] ? {
+            coding: codingFromValue(claims[DiagnosticReportClaim.Code])?.map((coding) => ({
+                ...coding,
+                ...(claims[DiagnosticReportClaim.CodeDisplay] ? { display: claims[DiagnosticReportClaim.CodeDisplay] } : {}),
+            })),
+            ...(claims[DiagnosticReportClaim.CodeText] ? { text: claims[DiagnosticReportClaim.CodeText] } : {}),
+        } : undefined,
         subject: subject ? { reference: subject } : undefined,
         encounter: claims[DiagnosticReportClaim.Encounter] ? { reference: claims[DiagnosticReportClaim.Encounter] } : undefined,
         effectiveDateTime: claims[DiagnosticReportClaim.Date],
@@ -37,6 +43,8 @@ export function diagnosticReportFhirR4ToFlat(resource) {
         [DiagnosticReportClaim.BasedOn]: referenceListToCsv(resource.basedOn),
         [DiagnosticReportClaim.Category]: codingToValue(resource.category?.[0]?.coding?.[0]),
         [DiagnosticReportClaim.Code]: codingToValue(resource.code?.coding?.[0]),
+        [DiagnosticReportClaim.CodeText]: resource.code?.text,
+        [DiagnosticReportClaim.CodeDisplay]: resource.code?.coding?.[0]?.display,
         [DiagnosticReportClaim.Date]: resource.effectiveDateTime || resource.issued,
         [DiagnosticReportClaim.Encounter]: referenceToValue(resource.encounter),
         [DiagnosticReportClaim.Identifier]: resource.identifier?.[0]?.value,

package/dist/convert/convert-flag.js

@@ -9,7 +9,13 @@ export function flagFlatToFhirR4(claims) {
         identifier: claims[FlagClaim.Identifier] ? [{ value: claims[FlagClaim.Identifier] }] : undefined,
         status: claims[FlagClaim.Status],
         category: claims[FlagClaim.Category] ? { coding: codingFromValue(claims[FlagClaim.Category]) } : undefined,
-        code: claims[FlagClaim.Code] ? { coding: codingFromValue(claims[FlagClaim.Code]) } : undefined,
+        code: claims[FlagClaim.Code] ? {
+            coding: codingFromValue(claims[FlagClaim.Code])?.map((coding) => ({
+                ...coding,
+                ...(claims[FlagClaim.CodeDisplay] ? { display: claims[FlagClaim.CodeDisplay] } : {}),
+            })),
+            ...(claims[FlagClaim.CodeText] ? { text: claims[FlagClaim.CodeText] } : {}),
+        } : undefined,
         subject: subject ? { reference: subject } : undefined,
         author: claims[FlagClaim.Author] ? { reference: claims[FlagClaim.Author] } : undefined,
         encounter: claims[FlagClaim.Encounter] ? { reference: claims[FlagClaim.Encounter] } : undefined,
@@ -28,6 +34,8 @@ export function flagFhirR4ToFlat(resource) {
         [FlagClaim.Status]: resource.status,
         [FlagClaim.Category]: codingToValue(resource.category?.coding?.[0]),
         [FlagClaim.Code]: codingToValue(resource.code?.coding?.[0]),
+        [FlagClaim.CodeText]: resource.code?.text,
+        [FlagClaim.CodeDisplay]: resource.code?.coding?.[0]?.display,
         [FlagClaim.PeriodStart]: period?.start,
         [FlagClaim.PeriodEnd]: period?.end,
     };

package/dist/convert/convert-medication-statement.js

@@ -29,7 +29,13 @@ export function medicationStatementFlatToFhirR4(claims) {
         subject: { reference: subject },
         effectiveDateTime,
         medicationCodeableConcept: claims[MedicationStatementClaim.Code]
-            ? { coding: codingFromValue(claims[MedicationStatementClaim.Code]) }
+            ? {
+                coding: codingFromValue(claims[MedicationStatementClaim.Code])?.map((coding) => ({
+                    ...coding,
+                    ...(claims[MedicationStatementClaim.CodeDisplay] ? { display: claims[MedicationStatementClaim.CodeDisplay] } : {}),
+                })),
+                ...(medicationText ? { text: medicationText } : {}),
+            }
             : (!hasContainedMedication && medicationText ? { text: medicationText } : undefined),
         medicationReference: hasContainedMedication ? { reference: `#${containedMedicationId}` } : undefined,
         contained: containedMedication ? [containedMedication] : undefined,
@@ -46,8 +52,9 @@ export function medicationStatementFhirR4ToFlat(resource) {
     const containedMedicationIdentifier = containedMedication?.identifier?.[0]?.value;
     const containedMedicationText = containedMedication?.code?.text;
     const batch = containedMedication?.batch;
-    const medicationCode = codingToValue(resource.medicationCodeableConcept?.coding?.[0]);
-    const medicationText = containedMedicationText || resource.medicationCodeableConcept?.text || undefined;
+    const medicationConcept = resource.medicationCodeableConcept;
+    const medicationCode = codingToValue(medicationConcept?.coding?.[0]);
+    const medicationText = containedMedicationText || medicationConcept?.text || undefined;
     return {
         [MedicationStatementClaim.Identifier]: resource.identifier?.[0]?.value,
         [MedicationStatementClaim.Subject]: resource.subject?.reference,
@@ -55,6 +62,7 @@ export function medicationStatementFhirR4ToFlat(resource) {
         [MedicationStatementClaim.Effective]: resource.effectiveDateTime,
         [MedicationStatementClaim.Code]: medicationCode,
         [MedicationStatementClaim.MedicationText]: medicationText,
+        [MedicationStatementClaim.CodeDisplay]: medicationConcept?.coding?.[0]?.display,
         [MedicationStatementClaim.Note]: resource.note?.[0]?.text,
         [MedicationStatementClaim.DosageInstruction]: resource.dosage?.[0]?.text,
         [MedicationStatementClaim.MedicationIdentifier]: containedMedicationIdentifier,

package/dist/models/interoperable-claims/allergy-intolerance-claims.d.ts

@@ -8,6 +8,12 @@ export declare const AllergyIntoleranceClaim: {
      */
     readonly Patient: "AllergyIntolerance.patient";
     readonly Code: "AllergyIntolerance.code";
+    /** Local-language label projected to FHIR `AllergyIntolerance.code.text`. */
+    readonly CodeText: "AllergyIntolerance.code-text";
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    readonly CodeTextLocal: "AllergyIntolerance.code-text";
+    /** English/international terminology label projected to `code.coding.display`. */
+    readonly CodeDisplay: "AllergyIntolerance.code-display";
     readonly ClinicalStatus: "AllergyIntolerance.clinical-status";
     readonly VerificationStatus: "AllergyIntolerance.verification-status";
     readonly Category: "AllergyIntolerance.category";
@@ -37,6 +43,8 @@ export declare enum AllergyIntoleranceClaimsFhirApi {
     Subject = "org.hl7.fhir.api.AllergyIntolerance.subject",
     Patient = "org.hl7.fhir.api.AllergyIntolerance.patient",
     Code = "org.hl7.fhir.api.AllergyIntolerance.code",
+    CodeText = "org.hl7.fhir.api.AllergyIntolerance.code-text",
+    CodeDisplay = "org.hl7.fhir.api.AllergyIntolerance.code-display",
     ClinicalStatus = "org.hl7.fhir.api.AllergyIntolerance.clinical-status",
     VerificationStatus = "org.hl7.fhir.api.AllergyIntolerance.verification-status",
     Category = "org.hl7.fhir.api.AllergyIntolerance.category",
@@ -49,6 +57,8 @@ export declare const AllergyIntoleranceSearchParamNames: {
     readonly Subject: "subject";
     readonly Patient: "patient";
     readonly Code: "code";
+    readonly CodeText: "code-text";
+    readonly CodeDisplay: "code-display";
     readonly ClinicalStatus: "clinical-status";
     readonly VerificationStatus: "verification-status";
     readonly Category: "category";
@@ -63,6 +73,8 @@ export declare const AllergyIntoleranceClaimsFhirApiMap: {
     "org.hl7.fhir.api.AllergyIntolerance.subject": StringConstructor;
     "org.hl7.fhir.api.AllergyIntolerance.patient": StringConstructor;
     "org.hl7.fhir.api.AllergyIntolerance.code": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.code-text": StringConstructor;
+    "org.hl7.fhir.api.AllergyIntolerance.code-display": StringConstructor;
     "org.hl7.fhir.api.AllergyIntolerance.clinical-status": StringConstructor;
     "org.hl7.fhir.api.AllergyIntolerance.verification-status": StringConstructor;
     "org.hl7.fhir.api.AllergyIntolerance.category": StringConstructor;

package/dist/models/interoperable-claims/allergy-intolerance-claims.js

@@ -10,6 +10,12 @@ export const AllergyIntoleranceClaim = {
      */
     Patient: 'AllergyIntolerance.patient',
     Code: 'AllergyIntolerance.code',
+    /** Local-language label projected to FHIR `AllergyIntolerance.code.text`. */
+    CodeText: 'AllergyIntolerance.code-text',
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    CodeTextLocal: 'AllergyIntolerance.code-text',
+    /** English/international terminology label projected to `code.coding.display`. */
+    CodeDisplay: 'AllergyIntolerance.code-display',
     ClinicalStatus: 'AllergyIntolerance.clinical-status',
     VerificationStatus: 'AllergyIntolerance.verification-status',
     Category: 'AllergyIntolerance.category',
@@ -39,6 +45,8 @@ export var AllergyIntoleranceClaimsFhirApi;
     AllergyIntoleranceClaimsFhirApi["Subject"] = "org.hl7.fhir.api.AllergyIntolerance.subject";
     AllergyIntoleranceClaimsFhirApi["Patient"] = "org.hl7.fhir.api.AllergyIntolerance.patient";
     AllergyIntoleranceClaimsFhirApi["Code"] = "org.hl7.fhir.api.AllergyIntolerance.code";
+    AllergyIntoleranceClaimsFhirApi["CodeText"] = "org.hl7.fhir.api.AllergyIntolerance.code-text";
+    AllergyIntoleranceClaimsFhirApi["CodeDisplay"] = "org.hl7.fhir.api.AllergyIntolerance.code-display";
     AllergyIntoleranceClaimsFhirApi["ClinicalStatus"] = "org.hl7.fhir.api.AllergyIntolerance.clinical-status";
     AllergyIntoleranceClaimsFhirApi["VerificationStatus"] = "org.hl7.fhir.api.AllergyIntolerance.verification-status";
     AllergyIntoleranceClaimsFhirApi["Category"] = "org.hl7.fhir.api.AllergyIntolerance.category";
@@ -51,6 +59,8 @@ export const AllergyIntoleranceSearchParamNames = {
     Subject: 'subject',
     Patient: 'patient',
     Code: 'code',
+    CodeText: 'code-text',
+    CodeDisplay: 'code-display',
     ClinicalStatus: 'clinical-status',
     VerificationStatus: 'verification-status',
     Category: 'category',
@@ -63,6 +73,8 @@ export const AllergyIntoleranceSearchParamToClaimKey = {
     [AllergyIntoleranceSearchParamNames.Subject]: AllergyIntoleranceClaimsFhirApi.Subject,
     [AllergyIntoleranceSearchParamNames.Patient]: AllergyIntoleranceClaimsFhirApi.Patient,
     [AllergyIntoleranceSearchParamNames.Code]: AllergyIntoleranceClaimsFhirApi.Code,
+    [AllergyIntoleranceSearchParamNames.CodeText]: AllergyIntoleranceClaimsFhirApi.CodeText,
+    [AllergyIntoleranceSearchParamNames.CodeDisplay]: AllergyIntoleranceClaimsFhirApi.CodeDisplay,
     [AllergyIntoleranceSearchParamNames.ClinicalStatus]: AllergyIntoleranceClaimsFhirApi.ClinicalStatus,
     [AllergyIntoleranceSearchParamNames.VerificationStatus]: AllergyIntoleranceClaimsFhirApi.VerificationStatus,
     [AllergyIntoleranceSearchParamNames.Category]: AllergyIntoleranceClaimsFhirApi.Category,
@@ -75,6 +87,8 @@ export const AllergyIntoleranceClaimsFhirApiMap = {
     [AllergyIntoleranceClaimsFhirApi.Subject]: String,
     [AllergyIntoleranceClaimsFhirApi.Patient]: String,
     [AllergyIntoleranceClaimsFhirApi.Code]: String,
+    [AllergyIntoleranceClaimsFhirApi.CodeText]: String,
+    [AllergyIntoleranceClaimsFhirApi.CodeDisplay]: String,
     [AllergyIntoleranceClaimsFhirApi.ClinicalStatus]: String,
     [AllergyIntoleranceClaimsFhirApi.VerificationStatus]: String,
     [AllergyIntoleranceClaimsFhirApi.Category]: String,
@@ -92,6 +106,8 @@ export const AllergyIntoleranceClaimSpecs = [
     { key: AllergyIntoleranceClaim.Subject, meaning: 'Canonical subject reference (maps to FHIR AllergyIntolerance.patient.reference).', example: 'urn:uuid:<UUID-V4>' },
     { key: AllergyIntoleranceClaim.Patient, meaning: 'Deprecated alias of subject for compatibility.', example: 'urn:uuid:<UUID-V4>' },
     { key: AllergyIntoleranceClaim.Code, meaning: 'Allergy or intolerance code.', example: 'http://snomed.info/sct|227493005' },
+    { key: AllergyIntoleranceClaim.CodeText, meaning: 'Local-language allergy label matching the resource language.', example: 'Penicilina' },
+    { key: AllergyIntoleranceClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Penicillin' },
     { key: AllergyIntoleranceClaim.ClinicalStatus, meaning: 'Clinical status code.', example: 'active' },
     { key: AllergyIntoleranceClaim.VerificationStatus, meaning: 'Verification status code.', example: 'confirmed' },
     { key: AllergyIntoleranceClaim.Category, meaning: 'Category value.', example: 'food' },

package/dist/models/interoperable-claims/condition-claims.d.ts

@@ -6,6 +6,12 @@ export declare const ConditionClaim: {
     readonly VerificationStatus: "Condition.verification-status";
     readonly Category: "Condition.category";
     readonly Code: "Condition.code";
+    /** Local-language label projected to FHIR `Condition.code.text`. */
+    readonly CodeText: "Condition.code-text";
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    readonly CodeTextLocal: "Condition.code-text";
+    /** English/international terminology label projected to `code.coding.display`. */
+    readonly CodeDisplay: "Condition.code-display";
     /**
      * Canonical CSV/list of related contained resource references or identifiers.
      */
@@ -34,6 +40,8 @@ export declare enum ConditionClaimsFhirApi {
     VerificationStatus = "org.hl7.fhir.api.Condition.verification-status",
     Category = "org.hl7.fhir.api.Condition.category",
     Code = "org.hl7.fhir.api.Condition.code",
+    CodeText = "org.hl7.fhir.api.Condition.code-text",
+    CodeDisplay = "org.hl7.fhir.api.Condition.code-display",
     Severity = "org.hl7.fhir.api.Condition.severity",
     OnsetDateTime = "org.hl7.fhir.api.Condition.onset-datetime",
     Recorder = "org.hl7.fhir.api.Condition.recorder"
@@ -45,6 +53,8 @@ export declare const ConditionSearchParamNames: {
     readonly VerificationStatus: "verification-status";
     readonly Category: "category";
     readonly Code: "code";
+    readonly CodeText: "code-text";
+    readonly CodeDisplay: "code-display";
     readonly Severity: "severity";
     readonly OnsetDateTime: "onset-datetime";
     readonly Recorder: "recorder";
@@ -58,6 +68,8 @@ export declare const ConditionClaimsFhirApiMap: {
     "org.hl7.fhir.api.Condition.verification-status": StringConstructor;
     "org.hl7.fhir.api.Condition.category": StringConstructor;
     "org.hl7.fhir.api.Condition.code": StringConstructor;
+    "org.hl7.fhir.api.Condition.code-text": StringConstructor;
+    "org.hl7.fhir.api.Condition.code-display": StringConstructor;
     "org.hl7.fhir.api.Condition.severity": StringConstructor;
     "org.hl7.fhir.api.Condition.onset-datetime": StringConstructor;
     "org.hl7.fhir.api.Condition.recorder": StringConstructor;

package/dist/models/interoperable-claims/condition-claims.js

@@ -8,6 +8,12 @@ export const ConditionClaim = {
     VerificationStatus: 'Condition.verification-status',
     Category: 'Condition.category',
     Code: 'Condition.code',
+    /** Local-language label projected to FHIR `Condition.code.text`. */
+    CodeText: 'Condition.code-text',
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    CodeTextLocal: 'Condition.code-text',
+    /** English/international terminology label projected to `code.coding.display`. */
+    CodeDisplay: 'Condition.code-display',
     /**
      * Canonical CSV/list of related contained resource references or identifiers.
      */
@@ -36,6 +42,8 @@ export var ConditionClaimsFhirApi;
     ConditionClaimsFhirApi["VerificationStatus"] = "org.hl7.fhir.api.Condition.verification-status";
     ConditionClaimsFhirApi["Category"] = "org.hl7.fhir.api.Condition.category";
     ConditionClaimsFhirApi["Code"] = "org.hl7.fhir.api.Condition.code";
+    ConditionClaimsFhirApi["CodeText"] = "org.hl7.fhir.api.Condition.code-text";
+    ConditionClaimsFhirApi["CodeDisplay"] = "org.hl7.fhir.api.Condition.code-display";
     ConditionClaimsFhirApi["Severity"] = "org.hl7.fhir.api.Condition.severity";
     ConditionClaimsFhirApi["OnsetDateTime"] = "org.hl7.fhir.api.Condition.onset-datetime";
     ConditionClaimsFhirApi["Recorder"] = "org.hl7.fhir.api.Condition.recorder";
@@ -47,6 +55,8 @@ export const ConditionSearchParamNames = {
     VerificationStatus: 'verification-status',
     Category: 'category',
     Code: 'code',
+    CodeText: 'code-text',
+    CodeDisplay: 'code-display',
     Severity: 'severity',
     OnsetDateTime: 'onset-datetime',
     Recorder: 'recorder',
@@ -58,6 +68,8 @@ export const ConditionSearchParamToClaimKey = {
     [ConditionSearchParamNames.VerificationStatus]: ConditionClaimsFhirApi.VerificationStatus,
     [ConditionSearchParamNames.Category]: ConditionClaimsFhirApi.Category,
     [ConditionSearchParamNames.Code]: ConditionClaimsFhirApi.Code,
+    [ConditionSearchParamNames.CodeText]: ConditionClaimsFhirApi.CodeText,
+    [ConditionSearchParamNames.CodeDisplay]: ConditionClaimsFhirApi.CodeDisplay,
     [ConditionSearchParamNames.Severity]: ConditionClaimsFhirApi.Severity,
     [ConditionSearchParamNames.OnsetDateTime]: ConditionClaimsFhirApi.OnsetDateTime,
     [ConditionSearchParamNames.Recorder]: ConditionClaimsFhirApi.Recorder,
@@ -69,6 +81,8 @@ export const ConditionClaimsFhirApiMap = {
     [ConditionClaimsFhirApi.VerificationStatus]: String,
     [ConditionClaimsFhirApi.Category]: String,
     [ConditionClaimsFhirApi.Code]: String,
+    [ConditionClaimsFhirApi.CodeText]: String,
+    [ConditionClaimsFhirApi.CodeDisplay]: String,
     [ConditionClaimsFhirApi.Severity]: String,
     [ConditionClaimsFhirApi.OnsetDateTime]: String,
     [ConditionClaimsFhirApi.Recorder]: String,
@@ -80,6 +94,8 @@ export const ConditionClaimSpecs = [
     { key: ConditionClaim.VerificationStatus, meaning: 'Verification status code.', example: 'confirmed' },
     { key: ConditionClaim.Category, meaning: 'Condition category code.', example: 'problem-list-item' },
     { key: ConditionClaim.Code, meaning: 'Condition code.', example: 'http://snomed.info/sct|44054006' },
+    { key: ConditionClaim.CodeText, meaning: 'Local-language condition label matching the resource language.', example: 'Diabetes mellitus tipo 2' },
+    { key: ConditionClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Type 2 diabetes mellitus' },
     { key: ConditionClaim.Severity, meaning: 'Condition severity code.', example: 'http://snomed.info/sct|24484000' },
     { key: ConditionClaim.OnsetDateTime, meaning: 'Onset date/time.', example: '2026-01-03T09:30:00Z' },
     { key: ConditionClaim.Recorder, meaning: 'Recorder reference.', example: 'Practitioner/prac-2' },

package/dist/models/interoperable-claims/diagnostic-report-claims.d.ts

@@ -3,6 +3,9 @@ export declare const DiagnosticReportClaim: {
     readonly BasedOn: "DiagnosticReport.based-on";
     readonly Category: "DiagnosticReport.category";
     readonly Code: "DiagnosticReport.code";
+    readonly CodeText: "DiagnosticReport.code-text";
+    readonly CodeTextLocal: "DiagnosticReport.code-text";
+    readonly CodeDisplay: "DiagnosticReport.code-display";
     readonly Date: "DiagnosticReport.date";
     readonly Encounter: "DiagnosticReport.encounter";
     readonly Identifier: "DiagnosticReport.identifier";

package/dist/models/interoperable-claims/diagnostic-report-claims.js

@@ -4,6 +4,9 @@ export const DiagnosticReportClaim = {
     BasedOn: 'DiagnosticReport.based-on',
     Category: 'DiagnosticReport.category',
     Code: 'DiagnosticReport.code',
+    CodeText: 'DiagnosticReport.code-text',
+    CodeTextLocal: 'DiagnosticReport.code-text',
+    CodeDisplay: 'DiagnosticReport.code-display',
     Date: 'DiagnosticReport.date',
     Encounter: 'DiagnosticReport.encounter',
     Identifier: 'DiagnosticReport.identifier',
@@ -35,6 +38,8 @@ export const DiagnosticReportClaimSpecs = [
     { key: DiagnosticReportClaim.BasedOn, meaning: 'Request or order that originated the report.', example: 'ServiceRequest/sr-1' },
     { key: DiagnosticReportClaim.Category, meaning: 'Diagnostic service section/category.', example: 'http://terminology.hl7.org/CodeSystem/v2-0074|LAB' },
     { key: DiagnosticReportClaim.Code, meaning: 'Main diagnostic report code.', example: 'http://loinc.org|58410-2' },
+    { key: DiagnosticReportClaim.CodeText, meaning: 'Local-language report name matching resource language.', example: 'Hemograma completo' },
+    { key: DiagnosticReportClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Complete blood count panel' },
     { key: DiagnosticReportClaim.Date, meaning: 'Report issuance date/time.', example: '2026-06-12T10:00:00Z' },
     { key: DiagnosticReportClaim.Encounter, meaning: 'Encounter reference.', example: 'Encounter/enc-1' },
     { key: DiagnosticReportClaim.Identifier, meaning: 'Business identifier for the report.', example: 'diag-report-001' },

package/dist/models/interoperable-claims/flag-claims.d.ts

@@ -9,6 +9,9 @@ export declare const FlagClaim: {
     readonly Status: "Flag.status";
     readonly Category: "Flag.category";
     readonly Code: "Flag.code";
+    readonly CodeText: "Flag.code-text";
+    readonly CodeTextLocal: "Flag.code-text";
+    readonly CodeDisplay: "Flag.code-display";
     readonly PeriodStart: "Flag.period-start";
     readonly PeriodEnd: "Flag.period-end";
 };

package/dist/models/interoperable-claims/flag-claims.js

@@ -10,6 +10,9 @@ export const FlagClaim = {
     Status: 'Flag.status',
     Category: 'Flag.category',
     Code: 'Flag.code',
+    CodeText: 'Flag.code-text',
+    CodeTextLocal: 'Flag.code-text',
+    CodeDisplay: 'Flag.code-display',
     PeriodStart: 'Flag.period-start',
     PeriodEnd: 'Flag.period-end',
 };
@@ -23,6 +26,8 @@ export const FlagClaimSpecs = [
     { key: FlagClaim.Status, meaning: 'Flag status.', example: 'active' },
     { key: FlagClaim.Category, meaning: 'Flag category token.', example: 'http://terminology.hl7.org/CodeSystem/flag-category|safety' },
     { key: FlagClaim.Code, meaning: 'Flag code token.', example: 'http://loinc.org|104605-1' },
+    { key: FlagClaim.CodeText, meaning: 'Local-language alert name matching resource language.', example: 'Dieta sin marisco' },
+    { key: FlagClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Shellfish free diet' },
     { key: FlagClaim.PeriodStart, meaning: 'Flag period start.', example: '2026-06-01T10:00:00Z' },
     { key: FlagClaim.PeriodEnd, meaning: 'Flag period end.', example: '2026-07-01T10:00:00Z' },
 ];

package/dist/models/interoperable-claims/medication-statement-claims.d.ts

@@ -14,6 +14,8 @@ export declare const MedicationStatementClaim: {
     readonly PartOf: "MedicationStatement.part-of";
     readonly Source: "MedicationStatement.source";
     readonly MedicationText: "MedicationStatement.medication-text";
+    /** English/international display for the coded medication. */
+    readonly CodeDisplay: "MedicationStatement.code-display";
     readonly UserSelected: "MedicationStatement.user-selected";
     /**
      * Free-text clinical note.

package/dist/models/interoperable-claims/medication-statement-claims.js

@@ -16,6 +16,8 @@ export const MedicationStatementClaim = {
     PartOf: 'MedicationStatement.part-of',
     Source: 'MedicationStatement.source',
     MedicationText: 'MedicationStatement.medication-text',
+    /** English/international display for the coded medication. */
+    CodeDisplay: 'MedicationStatement.code-display',
     UserSelected: 'MedicationStatement.user-selected',
     /**
      * Free-text clinical note.

package/dist/utils/allergy-intolerance-entry-editor.d.ts

@@ -20,6 +20,14 @@ export declare class AllergyIntoleranceEntryEditor extends ClinicalResourceEntry
     setCode(code?: string | null): this;
     /** Reads the coded allergy substance. */
     getCode(): string | undefined;
+    /** Writes the local-language allergy name projected to FHIR `code.text`. */
+    setCodeTextLocal(text?: string | null): this;
+    /** Reads the local-language allergy name. */
+    getCodeTextLocal(): string | undefined;
+    /** Writes the English/international terminology display. */
+    setCodeDisplay(display?: string | null): this;
+    /** Reads the English/international terminology display. */
+    getCodeDisplay(): string | undefined;
     /** Writes the clinical status. */
     setClinicalStatus(status?: string | null): this;
     /** Reads the clinical status. */

package/dist/utils/allergy-intolerance-entry-editor.js

@@ -23,6 +23,14 @@ export class AllergyIntoleranceEntryEditor extends ClinicalResourceEntryEditor {
     setCode(code) { return this.setScalarClaim(AllergyIntoleranceClaim.Code, code); }
     /** Reads the coded allergy substance. */
     getCode() { return this.getScalarClaim(AllergyIntoleranceClaim.Code); }
+    /** Writes the local-language allergy name projected to FHIR `code.text`. */
+    setCodeTextLocal(text) { return this.setScalarClaim(AllergyIntoleranceClaim.CodeText, text); }
+    /** Reads the local-language allergy name. */
+    getCodeTextLocal() { return this.getScalarClaim(AllergyIntoleranceClaim.CodeText); }
+    /** Writes the English/international terminology display. */
+    setCodeDisplay(display) { return this.setScalarClaim(AllergyIntoleranceClaim.CodeDisplay, display); }
+    /** Reads the English/international terminology display. */
+    getCodeDisplay() { return this.getScalarClaim(AllergyIntoleranceClaim.CodeDisplay); }
     /** Writes the clinical status. */
     setClinicalStatus(status) { return this.setScalarClaim(AllergyIntoleranceClaim.ClinicalStatus, status); }
     /** Reads the clinical status. */

package/dist/utils/bundle-document-builder.js

@@ -334,6 +334,11 @@ export function convertClaimsToFhirResource(claims, version = 'r4') {
     void version;
     const flatClaims = claimsToFlatStrings(claims);
     const resourceType = detectClaimsResourceType(claims);
+    const resource = convertClaimsToFhirResourceByType(flatClaims, resourceType);
+    const language = resourceType ? asTrimmedString(claims[`${resourceType}.language`]) : '';
+    return language ? { ...resource, language } : resource;
+}
+function convertClaimsToFhirResourceByType(flatClaims, resourceType) {
     switch (resourceType) {
         case ResourceTypesFhirR4.MedicationStatement:
             return medicationStatementFlatToFhirR4(flatClaims);

package/dist/utils/clinical-resource-converters.js

@@ -92,6 +92,13 @@ export const clinicalImpressionFhirToFlat = clinicalImpressionFhirR4ToFlat;
  * generic structural flattening.
  */
 export function convertFhirResourceToClaims(resource, context = 'org.hl7.fhir.r4') {
+    const claims = convertFhirResourceToClaimsByType(resource, context);
+    const language = typeof resource.language === 'string' ? resource.language.trim() : '';
+    return language
+        ? { ...claims, [`${resource.resourceType}.language`]: language }
+        : claims;
+}
+function convertFhirResourceToClaimsByType(resource, context) {
     switch (resource.resourceType) {
         case 'MedicationStatement':
             return medicationStatementFhirR4ToFlat(resource);

package/dist/utils/clinical-resource-view.d.ts

@@ -24,6 +24,24 @@ export type ClinicalResourceCardView = Readonly<{
     fullUrl?: string;
     actorsCount: number;
 }>;
+export type ClinicalTerminologyTranslationInput = Readonly<{
+    resourceType: string;
+    system?: string;
+    code: string;
+    token: string;
+    locale: string;
+}>;
+export type ClinicalResourceDisplayOptions = Readonly<{
+    /** UI language requested by the current user, for example `es` or `es-ES`. */
+    locale?: string;
+    /**
+     * Product terminology lookup keyed by canonical `system|code`.
+     *
+     * Return `undefined` when the product has no translation so the shared
+     * reader can fall back to the international `Coding.display`.
+     */
+    translateCode?: (input: ClinicalTerminologyTranslationInput) => string | undefined;
+}>;
 export type ClinicalResourceExpandedView = Readonly<{
     common: ClinicalResourceCommonView;
     xhtml?: string;
@@ -74,19 +92,19 @@ export type ClinicalResourceBundleLike = Readonly<{
 /**
  * Maps one bundle entry to a UI-friendly common clinical view contract.
  */
-export declare function toClinicalResourceCommonView(entry: ClinicalResourceEntryLike): ClinicalResourceCommonView;
+export declare function toClinicalResourceCommonView(entry: ClinicalResourceEntryLike, options?: ClinicalResourceDisplayOptions): ClinicalResourceCommonView;
 /**
  * Maps all entries from a Bundle into common clinical views.
  */
-export declare function toClinicalResourceCommonViews(bundle: ClinicalResourceBundleLike): ClinicalResourceCommonView[];
+export declare function toClinicalResourceCommonViews(bundle: ClinicalResourceBundleLike, options?: ClinicalResourceDisplayOptions): ClinicalResourceCommonView[];
 /**
  * Maps one bundle entry to a minimal card view for section counters/list cards.
  */
-export declare function toClinicalResourceCardView(entry: ClinicalResourceEntryLike): ClinicalResourceCardView;
+export declare function toClinicalResourceCardView(entry: ClinicalResourceEntryLike, options?: ClinicalResourceDisplayOptions): ClinicalResourceCardView;
 /**
  * Maps all entries from a Bundle into minimal card views.
  */
-export declare function toClinicalResourceCardViews(bundle: ClinicalResourceBundleLike): ClinicalResourceCardView[];
+export declare function toClinicalResourceCardViews(bundle: ClinicalResourceBundleLike, options?: ClinicalResourceDisplayOptions): ClinicalResourceCardView[];
 /**
  * Maps one bundle entry to an expanded view that includes XHTML and notes array.
  */