fhir-data-utils-ts 0.6.18 → 0.6.20

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.6.20 - 2026-10-12
+
+- Export the deduplicated official LOINC Document Ontology subject-matter-
+  domain catalogue supplied from the LOINC Knowledge Base for human-health
+  selectors. Keep it explicitly separate from veterinary service types.
+
+## 0.6.19 - 2026-10-12
+
+- Add the official `HealthcareService.appointmentRequired` flat claim and
+  R4/R5 materialization round trip. Availability remains authoritative in the
+  associated Schedule and Slot resources and is not duplicated on the service.
+
 ## 0.6.18 - 2026-10-08
 
 - Add the canonical Immunization series-dose claim, its FHIR R4 round trip,

package/dist/claims/healthcare-service-claims.d.ts

@@ -8,6 +8,7 @@ import type { ClaimSpec } from './claim-types.js';
  */
 export declare const HealthcareServiceClaim: Readonly<{
     readonly Active: "HealthcareService.active";
+    readonly AppointmentRequired: "HealthcareService.appointment-required";
     readonly Characteristic: "HealthcareService.characteristic";
     readonly CoverageArea: "HealthcareService.coverage-area";
     readonly Endpoint: "HealthcareService.endpoint";

package/dist/claims/healthcare-service-claims.js

@@ -9,6 +9,7 @@ import { defineFlatSearchParameter } from '../search-parameters.js';
  */
 export const HealthcareServiceClaim = Object.freeze({
     Active: 'HealthcareService.active',
+    AppointmentRequired: 'HealthcareService.appointment-required',
     Characteristic: 'HealthcareService.characteristic',
     CoverageArea: 'HealthcareService.coverage-area',
     Endpoint: 'HealthcareService.endpoint',
@@ -39,6 +40,7 @@ export const HealthcareServiceR4SearchParameterCatalog = Object.freeze([
 ]);
 export const HealthcareServiceClaimSpecs = Object.freeze([
     { key: HealthcareServiceClaim.Active, meaning: 'Whether the service is active.', example: 'true' },
+    { key: HealthcareServiceClaim.AppointmentRequired, meaning: 'Whether an appointment is required before receiving the service.', example: 'true' },
     { key: HealthcareServiceClaim.Characteristic, meaning: 'Repeatable service characteristic tokens as CSV.', example: 'https://example.org/CodeSystem/service-characteristic|24-hours' },
     { key: HealthcareServiceClaim.CoverageArea, meaning: 'Repeatable intended coverage Location references as CSV.', example: 'Location/british-columbia' },
     { key: HealthcareServiceClaim.Endpoint, meaning: 'Repeatable technical Endpoint references as CSV.', example: 'Endpoint/emergency-group-inbox' },

package/dist/converters/convert-healthcare-service.js

@@ -23,6 +23,9 @@ export function healthcareServiceFlatToFhirR4(claims) {
         active: claims[HealthcareServiceClaim.Active] === undefined
             ? undefined
             : claims[HealthcareServiceClaim.Active] === 'true',
+        appointmentRequired: claims[HealthcareServiceClaim.AppointmentRequired] === undefined
+            ? undefined
+            : claims[HealthcareServiceClaim.AppointmentRequired] === 'true',
         providedBy: claims[HealthcareServiceClaim.Organization]
             ? { reference: claims[HealthcareServiceClaim.Organization] }
             : undefined,
@@ -42,6 +45,9 @@ export function healthcareServiceFlatToFhirR4(claims) {
 export function healthcareServiceFhirR4ToFlat(resource) {
     return {
         [HealthcareServiceClaim.Active]: resource.active === undefined ? undefined : String(resource.active),
+        [HealthcareServiceClaim.AppointmentRequired]: resource.appointmentRequired === undefined
+            ? undefined
+            : String(resource.appointmentRequired),
         [HealthcareServiceClaim.Characteristic]: conceptsToCsv(resource.characteristic),
         [HealthcareServiceClaim.CoverageArea]: referenceListToCsv(resource.coverageArea),
         [HealthcareServiceClaim.Endpoint]: referenceListToCsv(resource.endpoint),

package/dist/data/index.d.ts

@@ -6,3 +6,4 @@ export * from './health-credential-qr.data.js';
 export * from './ips-clinical-artifact-schemas.data.js';
 export * from './clinical-document-encounter-journey.data.js';
 export * from './communication-request-form-schema.data.js';
+export * from './loinc-subject-matter-domain.data.js';

package/dist/data/index.js

@@ -6,3 +6,4 @@ export * from './health-credential-qr.data.js';
 export * from './ips-clinical-artifact-schemas.data.js';
 export * from './clinical-document-encounter-journey.data.js';
 export * from './communication-request-form-schema.data.js';
+export * from './loinc-subject-matter-domain.data.js';

package/dist/data/loinc-subject-matter-domain.data.d.ts

@@ -0,0 +1,684 @@
+/** Official LOINC Document Ontology Subject matter domain coding system. */
+export declare const LoincSubjectMatterDomainSystem: "http://loinc.org";
+/**
+ * Deduplicated LOINC Subject matter domain catalogue supplied from the LOINC
+ * Knowledge Base export. These codes classify human-health document subject
+ * domains. They are not veterinary service types.
+ */
+export declare const LoincSubjectMatterDomain: readonly [Readonly<{
+    system: "http://loinc.org";
+    code: "LP263512-8";
+    display: "Addiction medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172912-0";
+    display: "Addiction psychiatry";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172915-3";
+    display: "Aerospace medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP345051-9";
+    display: "Allergy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172918-7";
+    display: "Anesthesiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172981-5";
+    display: "Pain medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP248728-0";
+    display: "Sleep medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172919-5";
+    display: "Audiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP439903-8";
+    display: "Child life";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172923-7";
+    display: "Chiropractic medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172933-6";
+    display: "Critical care medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172934-4";
+    display: "Dentistry";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172935-1";
+    display: "Dermatology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172987-2";
+    display: "Pediatric dermatology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172940-1";
+    display: "Emergency medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172957-5";
+    display: "Medical toxicology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173027-6";
+    display: "Sports medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP183499-5";
+    display: "Trauma";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP265794-0";
+    display: "Polytrauma";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173035-9";
+    display: "Undersea and hyperbaric medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172942-7";
+    display: "Ethics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172943-5";
+    display: "Family medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172913-8";
+    display: "Adolescent medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172947-6";
+    display: "Geriatric medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172894-0";
+    display: "Forensic medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172946-8";
+    display: "General medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP433455-5";
+    display: "Hospitalist";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP431539-8";
+    display: "Hospice care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP345043-6";
+    display: "Immunology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP342846-5";
+    display: "Integrative medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172911-2";
+    display: "Acupuncture";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172952-6";
+    display: "Internal medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172921-1";
+    display: "Cardiovascular disease";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172927-8";
+    display: "Clinical cardiac electrophysiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP269425-7";
+    display: "Heart failure";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172953-4";
+    display: "Interventional cardiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP269424-0";
+    display: "Transplant cardiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172941-9";
+    display: "Endocrinology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172938-5";
+    display: "Diabetology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172945-0";
+    display: "Gastroenterology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172950-0";
+    display: "Hepatology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP175685-9";
+    display: "Hematology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP417851-5";
+    display: "Bone Marrow Transplant";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172951-8";
+    display: "Infectious disease";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP183500-0";
+    display: "HIV";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP175686-7";
+    display: "Medical Oncology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172962-5";
+    display: "Nephrology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP263511-0";
+    display: "Dialysis";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP418387-9";
+    display: "Therapeutic apheresis";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173015-1";
+    display: "Pulmonary disease";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173023-5";
+    display: "Rheumatology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP417852-3";
+    display: "Solid organ transplant";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP439901-2";
+    display: "Vascular Access";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172956-7";
+    display: "Medical genetics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172926-0";
+    display: "Clinical biochemical genetics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172929-4";
+    display: "Clinical genetics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP268361-5";
+    display: "Pharmacogenomics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172958-3";
+    display: "Mental health";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP345044-4";
+    display: "Eating disorders";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173011-0";
+    display: "Psychiatry";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172922-9";
+    display: "Child and adolescent psychiatry";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173012-8";
+    display: "Psychology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP248501-1";
+    display: "Child and adolescent psychology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP248729-8";
+    display: "Neuropsychology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172960-9";
+    display: "Multi-specialty program";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP345048-5";
+    display: "Aerodigestive medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP263714-0";
+    display: "Brain injury";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP420041-8";
+    display: "Breastfeeding";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP345049-3";
+    display: "Cleft and Craniofacial";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP417672-5";
+    display: "Medical Aid in Dying";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172897-3";
+    display: "Multidisciplinary";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172963-3";
+    display: "Neurological surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP345042-8";
+    display: "Spinal surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172964-1";
+    display: "Neurology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172931-0";
+    display: "Clinical neurophysiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP248726-4";
+    display: "Epilepsy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172898-1";
+    display: "Neurology w special qualifications in child neuro";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173038-3";
+    display: "Vascular neurology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172968-2";
+    display: "Nuclear medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172899-9";
+    display: "Nutrition and dietetics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP269243-4";
+    display: "Obesity medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172971-6";
+    display: "Obstetrics and gynecology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP221284-5";
+    display: "Gynecology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP202989-2";
+    display: "Gynecologic oncology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172955-9";
+    display: "Maternal and fetal medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP221283-7";
+    display: "Obstetrics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173020-1";
+    display: "Reproductive endocrinology and infertility";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172973-2";
+    display: "Occupational therapy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172901-3";
+    display: "Oncology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172991-4";
+    display: "Pediatric hematology-oncology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173016-9";
+    display: "Radiation oncology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP207940-0";
+    display: "Surgical oncology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172974-0";
+    display: "Ophthalmology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172975-7";
+    display: "Optometry";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172902-1";
+    display: "Oral and maxillofacial surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP434806-8";
+    display: "Orthopaedic surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173029-2";
+    display: "Surgery of the hand";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP434870-4";
+    display: "Orthopaedic";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172979-9";
+    display: "Orthotics prosthetics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP434767-2";
+    display: "Osteopathic medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172980-7";
+    display: "Otolaryngology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172994-8";
+    display: "Pediatric otolaryngology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172982-3";
+    display: "Palliative care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172983-1";
+    display: "Pastoral care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172984-9";
+    display: "Pathology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP208907-8";
+    display: "Anatomic pathology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP208906-0";
+    display: "Clinical pathology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172920-3";
+    display: "Blood banking and transfusion medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP208902-9";
+    display: "Chemical pathology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP208903-7";
+    display: "Pathology – Medical microbiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173002-9";
+    display: "Pediatrics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172937-7";
+    display: "Developmental-behavioral pediatrics";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172961-7";
+    display: "Neonatal perinatal medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP192135-4";
+    display: "Birth defects";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172985-6";
+    display: "Pediatric cardiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172986-4";
+    display: "Pediatric critical care medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172989-8";
+    display: "Pediatric endocrinology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172990-6";
+    display: "Pediatric gastroenterology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173000-3";
+    display: "Pediatric transplant hepatology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172992-2";
+    display: "Pediatric infectious diseases";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172993-0";
+    display: "Pediatric nephrology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172995-5";
+    display: "Pediatric pulmonology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172997-1";
+    display: "Pediatric rehabilitation medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172998-9";
+    display: "Pediatric rheumatology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172999-7";
+    display: "Pediatric surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173003-7";
+    display: "Pharmacology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP220238-2";
+    display: "Clinical pharmacology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP447710-7";
+    display: "Clinical pharmacy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173004-5";
+    display: "Physical medicine and rehabilitation";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172954-2";
+    display: "Kinesiotherapy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173026-8";
+    display: "Spinal cord injury medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173040-9";
+    display: "Vocational rehabilitation";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173005-2";
+    display: "Physical therapy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173006-0";
+    display: "Plastic surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP268363-1";
+    display: "Burn management";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173008-6";
+    display: "Podiatry";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP433456-3";
+    display: "Chiropody";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173009-4";
+    display: "Preventive medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172972-4";
+    display: "Occupational medicine";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173010-2";
+    display: "Primary care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP448682-7";
+    display: "Preventive care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173014-4";
+    display: "Public health";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP204156-6";
+    display: "Community health care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP267441-6";
+    display: "Environmental health";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173018-5";
+    display: "Radiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172896-5";
+    display: "Interventional radiology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP448142-2";
+    display: "Social Care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173019-3";
+    display: "Recreational therapy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173021-9";
+    display: "Research";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173022-7";
+    display: "Respiratory therapy";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173025-0";
+    display: "Speech-language pathology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173028-4";
+    display: "Surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP248500-3";
+    display: "Bariatric surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP172932-8";
+    display: "Colon and rectal surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173030-0";
+    display: "Surgical critical care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173031-8";
+    display: "Thoracic and cardiac surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP207300-7";
+    display: "Cardiac surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173033-4";
+    display: "Transplant surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP434807-6";
+    display: "Trauma Surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173039-1";
+    display: "Vascular surgery";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP269976-9";
+    display: "Thromboembolism";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173034-2";
+    display: "Tumor board";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173036-7";
+    display: "Urology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP173001-1";
+    display: "Pediatric urology";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP248732-2";
+    display: "Womens health";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP185997-6";
+    display: "Wound care management";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP412351-1";
+    display: "Wound, Ostomy, and Continence Care";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP448293-3";
+    display: "Rapid response";
+}>, Readonly<{
+    system: "http://loinc.org";
+    code: "LP450620-2";
+    display: "Hemodynamic";
+}>];

package/dist/data/loinc-subject-matter-domain.data.js

@@ -0,0 +1,179 @@
+// Copyright 2026 Connecting Solution & Applications Ltd under the Apache License, Version 2.0.
+/** Official LOINC Document Ontology Subject matter domain coding system. */
+export const LoincSubjectMatterDomainSystem = 'http://loinc.org';
+/**
+ * Deduplicated LOINC Subject matter domain catalogue supplied from the LOINC
+ * Knowledge Base export. These codes classify human-health document subject
+ * domains. They are not veterinary service types.
+ */
+export const LoincSubjectMatterDomain = Object.freeze([
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP263512-8", display: "Addiction medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172912-0", display: "Addiction psychiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172915-3", display: "Aerospace medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345051-9", display: "Allergy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172918-7", display: "Anesthesiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172981-5", display: "Pain medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248728-0", display: "Sleep medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172919-5", display: "Audiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP439903-8", display: "Child life" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172923-7", display: "Chiropractic medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172933-6", display: "Critical care medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172934-4", display: "Dentistry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172935-1", display: "Dermatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172987-2", display: "Pediatric dermatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172940-1", display: "Emergency medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172957-5", display: "Medical toxicology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173027-6", display: "Sports medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP183499-5", display: "Trauma" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP265794-0", display: "Polytrauma" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173035-9", display: "Undersea and hyperbaric medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172942-7", display: "Ethics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172943-5", display: "Family medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172913-8", display: "Adolescent medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172947-6", display: "Geriatric medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172894-0", display: "Forensic medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172946-8", display: "General medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP433455-5", display: "Hospitalist" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP431539-8", display: "Hospice care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345043-6", display: "Immunology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP342846-5", display: "Integrative medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172911-2", display: "Acupuncture" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172952-6", display: "Internal medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172921-1", display: "Cardiovascular disease" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172927-8", display: "Clinical cardiac electrophysiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269425-7", display: "Heart failure" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172953-4", display: "Interventional cardiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269424-0", display: "Transplant cardiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172941-9", display: "Endocrinology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172938-5", display: "Diabetology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172945-0", display: "Gastroenterology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172950-0", display: "Hepatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP175685-9", display: "Hematology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP417851-5", display: "Bone Marrow Transplant" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172951-8", display: "Infectious disease" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP183500-0", display: "HIV" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP175686-7", display: "Medical Oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172962-5", display: "Nephrology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP263511-0", display: "Dialysis" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP418387-9", display: "Therapeutic apheresis" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173015-1", display: "Pulmonary disease" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173023-5", display: "Rheumatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP417852-3", display: "Solid organ transplant" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP439901-2", display: "Vascular Access" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172956-7", display: "Medical genetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172926-0", display: "Clinical biochemical genetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172929-4", display: "Clinical genetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP268361-5", display: "Pharmacogenomics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172958-3", display: "Mental health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345044-4", display: "Eating disorders" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173011-0", display: "Psychiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172922-9", display: "Child and adolescent psychiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173012-8", display: "Psychology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248501-1", display: "Child and adolescent psychology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248729-8", display: "Neuropsychology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172960-9", display: "Multi-specialty program" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345048-5", display: "Aerodigestive medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP263714-0", display: "Brain injury" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP420041-8", display: "Breastfeeding" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345049-3", display: "Cleft and Craniofacial" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP417672-5", display: "Medical Aid in Dying" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172897-3", display: "Multidisciplinary" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172963-3", display: "Neurological surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP345042-8", display: "Spinal surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172964-1", display: "Neurology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172931-0", display: "Clinical neurophysiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248726-4", display: "Epilepsy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172898-1", display: "Neurology w special qualifications in child neuro" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173038-3", display: "Vascular neurology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172968-2", display: "Nuclear medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172899-9", display: "Nutrition and dietetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269243-4", display: "Obesity medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172971-6", display: "Obstetrics and gynecology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP221284-5", display: "Gynecology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP202989-2", display: "Gynecologic oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172955-9", display: "Maternal and fetal medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP221283-7", display: "Obstetrics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173020-1", display: "Reproductive endocrinology and infertility" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172973-2", display: "Occupational therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172901-3", display: "Oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172991-4", display: "Pediatric hematology-oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173016-9", display: "Radiation oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP207940-0", display: "Surgical oncology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172974-0", display: "Ophthalmology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172975-7", display: "Optometry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172902-1", display: "Oral and maxillofacial surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434806-8", display: "Orthopaedic surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173029-2", display: "Surgery of the hand" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434870-4", display: "Orthopaedic" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172979-9", display: "Orthotics prosthetics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434767-2", display: "Osteopathic medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172980-7", display: "Otolaryngology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172994-8", display: "Pediatric otolaryngology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172982-3", display: "Palliative care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172983-1", display: "Pastoral care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172984-9", display: "Pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208907-8", display: "Anatomic pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208906-0", display: "Clinical pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172920-3", display: "Blood banking and transfusion medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208902-9", display: "Chemical pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP208903-7", display: "Pathology – Medical microbiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173002-9", display: "Pediatrics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172937-7", display: "Developmental-behavioral pediatrics" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172961-7", display: "Neonatal perinatal medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP192135-4", display: "Birth defects" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172985-6", display: "Pediatric cardiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172986-4", display: "Pediatric critical care medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172989-8", display: "Pediatric endocrinology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172990-6", display: "Pediatric gastroenterology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173000-3", display: "Pediatric transplant hepatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172992-2", display: "Pediatric infectious diseases" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172993-0", display: "Pediatric nephrology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172995-5", display: "Pediatric pulmonology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172997-1", display: "Pediatric rehabilitation medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172998-9", display: "Pediatric rheumatology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172999-7", display: "Pediatric surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173003-7", display: "Pharmacology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP220238-2", display: "Clinical pharmacology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP447710-7", display: "Clinical pharmacy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173004-5", display: "Physical medicine and rehabilitation" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172954-2", display: "Kinesiotherapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173026-8", display: "Spinal cord injury medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173040-9", display: "Vocational rehabilitation" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173005-2", display: "Physical therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173006-0", display: "Plastic surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP268363-1", display: "Burn management" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173008-6", display: "Podiatry" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP433456-3", display: "Chiropody" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173009-4", display: "Preventive medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172972-4", display: "Occupational medicine" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173010-2", display: "Primary care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP448682-7", display: "Preventive care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173014-4", display: "Public health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP204156-6", display: "Community health care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP267441-6", display: "Environmental health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173018-5", display: "Radiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172896-5", display: "Interventional radiology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP448142-2", display: "Social Care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173019-3", display: "Recreational therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173021-9", display: "Research" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173022-7", display: "Respiratory therapy" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173025-0", display: "Speech-language pathology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173028-4", display: "Surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248500-3", display: "Bariatric surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP172932-8", display: "Colon and rectal surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173030-0", display: "Surgical critical care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173031-8", display: "Thoracic and cardiac surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP207300-7", display: "Cardiac surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173033-4", display: "Transplant surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP434807-6", display: "Trauma Surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173039-1", display: "Vascular surgery" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP269976-9", display: "Thromboembolism" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173034-2", display: "Tumor board" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173036-7", display: "Urology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP173001-1", display: "Pediatric urology" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP248732-2", display: "Womens health" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP185997-6", display: "Wound care management" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP412351-1", display: "Wound, Ostomy, and Continence Care" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP448293-3", display: "Rapid response" }),
+    Object.freeze({ system: LoincSubjectMatterDomainSystem, code: "LP450620-2", display: "Hemodynamic" }),
+]);

package/docs/HEALTHCARE_SERVICE_DEPARTMENT_CATALOG.md

@@ -18,6 +18,12 @@ donation independently. Each service can own different Location references and
 be the actor of a different Schedule; Slot duration and availability follow
 that Schedule rather than the department.
 
+`HealthcareService.appointmentRequired` states whether a person or animal must
+have an appointment before receiving the service. It does not describe when
+the service is available. Operational availability remains authoritative in
+the service's `Schedule` and its `Slot` resources; clients must not copy those
+intervals into a second service-level availability model.
+
 `buildServiceScheduleFlatGraph(...)` implements that boundary. It emits one
 independent claims-first `Schedule` plus independent `Slot` rows. A 15-minute
 blood-donation interval and a one-hour plasma-donation interval are represented
@@ -143,6 +149,9 @@ Repeatable coding identities remain complete `system|code` tokens; labels are
 resolved by the terminology service and are not trusted storage identity.
 `HealthcareService.comment` and R5 `Organization.description` are governed
 materialization claims, but are not falsely advertised as R4 SearchParameters.
+The same applies to `HealthcareService.appointmentRequired`: it is an official
+R4/R5 element and a governed materialization claim, not a resource-specific R4
+SearchParameter.
 
 `materializeClaimsFirstResourceToFhirR5(...)` accepts only minimal resource
 identity plus `resource.meta.claims`. It rejects nested native FHIR fields and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fhir-data-utils-ts",
-  "version": "0.6.18",
+  "version": "0.6.20",
   "description": "FHIR-version-neutral flat-claim and SearchParameter data utilities",
   "license": "Apache-2.0",
   "type": "module",