@atomic-ehr/codegen 0.0.9 → 0.0.10-canary.20260330084405.5054c4a

package/dist/index.d.ts

@@ -42,16 +42,16 @@ interface Quantity extends Element {
 interface Age extends Quantity {
 }
 
-interface Coding extends Element {
-    code?: string;
+interface Coding<T extends string = string> extends Element {
+    code?: T;
     display?: string;
     system?: string;
     userSelected?: boolean;
     version?: string;
 }
 
-interface CodeableConcept extends Element {
-    coding?: Coding[];
+interface CodeableConcept<T extends string = string> extends Element {
+    coding?: Coding<T>[];
     text?: string;
 }
 
@@ -59,7 +59,7 @@ interface Identifier extends Element {
     assigner?: Reference<"Organization">;
     period?: Period;
     system?: string;
-    type?: CodeableConcept;
+    type?: CodeableConcept<("DL" | "PPN" | "BRN" | "MR" | "MCN" | "EN" | "TAX" | "NIIP" | "PRN" | "MD" | "DR" | "ACSN" | "UDI" | "SNO" | "SB" | "PLAC" | "FILL" | "JHN" | string)>;
     use?: ("usual" | "official" | "temp" | "secondary" | "old");
     value?: string;
 }
@@ -83,7 +83,7 @@ interface Attachment extends Element {
     creation?: string;
     data?: string;
     hash?: string;
-    language?: string;
+    language?: ("ar" | "bn" | "cs" | "da" | "de" | "de-AT" | "de-CH" | "de-DE" | "el" | "en" | "en-AU" | "en-CA" | "en-GB" | "en-IN" | "en-NZ" | "en-SG" | "en-US" | "es" | "es-AR" | "es-ES" | "es-UY" | "fi" | "fr" | "fr-BE" | "fr-CH" | "fr-FR" | "fy" | "fy-NL" | "hi" | "hr" | "it" | "it-CH" | "it-IT" | "ja" | "ko" | "nl" | "nl-BE" | "nl-NL" | "no" | "no-NO" | "pa" | "pl" | "pt" | "pt-BR" | "ru" | "ru-RU" | "sr" | "sr-RS" | "sv" | "sv-SE" | "te" | "zh" | "zh-CN" | "zh-HK" | "zh-SG" | "zh-TW" | string);
     size?: number;
     title?: string;
     url?: string;
@@ -124,13 +124,13 @@ interface Resource {
     resourceType: "CodeSystem" | "DomainResource" | "Resource" | "StructureDefinition" | "ValueSet";
     id?: string;
     implicitRules?: string;
-    language?: string;
+    language?: ("ar" | "bn" | "cs" | "da" | "de" | "de-AT" | "de-CH" | "de-DE" | "el" | "en" | "en-AU" | "en-CA" | "en-GB" | "en-IN" | "en-NZ" | "en-SG" | "en-US" | "es" | "es-AR" | "es-ES" | "es-UY" | "fi" | "fr" | "fr-BE" | "fr-CH" | "fr-FR" | "fy" | "fy-NL" | "hi" | "hr" | "it" | "it-CH" | "it-IT" | "ja" | "ko" | "nl" | "nl-BE" | "nl-NL" | "no" | "no-NO" | "pa" | "pl" | "pt" | "pt-BR" | "ru" | "ru-RU" | "sr" | "sr-RS" | "sv" | "sv-SE" | "te" | "zh" | "zh-CN" | "zh-HK" | "zh-SG" | "zh-TW" | string);
     meta?: Meta;
 }
 
-interface DomainResource extends Resource {
+interface DomainResource<T extends Resource = Resource> extends Resource {
     resourceType: "CodeSystem" | "DomainResource" | "StructureDefinition" | "ValueSet";
-    contained?: Resource[];
+    contained?: T[];
     extension?: Extension[];
     modifierExtension?: Extension[];
     text?: Narrative;
@@ -142,7 +142,7 @@ interface Range extends Element {
 }
 
 interface UsageContext extends Element {
-    code: Coding;
+    code: Coding<("gender" | "age" | "focus" | "user" | "workflow" | "task" | "venue" | "species" | "program" | string)>;
     valueCodeableConcept?: CodeableConcept;
     valueQuantity?: Quantity;
     valueRange?: Range;
@@ -158,8 +158,8 @@ interface CodeSystemConcept extends BackboneElement {
     property?: CodeSystemConceptProperty[];
 }
 interface CodeSystemConceptDesignation extends BackboneElement {
-    language?: string;
-    use?: Coding;
+    language?: ("ar" | "bn" | "cs" | "da" | "de" | "de-AT" | "de-CH" | "de-DE" | "el" | "en" | "en-AU" | "en-CA" | "en-GB" | "en-IN" | "en-NZ" | "en-SG" | "en-US" | "es" | "es-AR" | "es-ES" | "es-UY" | "fi" | "fr" | "fr-BE" | "fr-CH" | "fr-FR" | "fy" | "fy-NL" | "hi" | "hr" | "it" | "it-CH" | "it-IT" | "ja" | "ko" | "nl" | "nl-BE" | "nl-NL" | "no" | "no-NO" | "pa" | "pl" | "pt" | "pt-BR" | "ru" | "ru-RU" | "sr" | "sr-RS" | "sv" | "sv-SE" | "te" | "zh" | "zh-CN" | "zh-HK" | "zh-SG" | "zh-TW" | string);
+    use?: Coding<("900000000000003001" | "900000000000013009" | string)>;
     value: string;
 }
 interface CodeSystemConceptProperty extends BackboneElement {
@@ -226,13 +226,30 @@ interface Count extends Quantity {
 interface Duration extends Quantity {
 }
 
+interface DataRequirementCodeFilter extends Element {
+    code?: Coding[];
+    path?: string;
+    searchParam?: string;
+    valueSet?: string;
+}
+interface DataRequirementDateFilter extends Element {
+    path?: string;
+    searchParam?: string;
+    valueDateTime?: string;
+    valueDuration?: Duration;
+    valuePeriod?: Period;
+}
+interface DataRequirementSort extends Element {
+    direction: ("ascending" | "descending");
+    path: string;
+}
 interface DataRequirement extends Element {
-    codeFilter?: Element[];
-    dateFilter?: Element[];
+    codeFilter?: DataRequirementCodeFilter[];
+    dateFilter?: DataRequirementDateFilter[];
     limit?: number;
     mustSupport?: string[];
     profile?: string[];
-    sort?: Element[];
+    sort?: DataRequirementSort[];
     subjectCodeableConcept?: CodeableConcept;
     subjectReference?: Reference<"Group">;
     type: string;
@@ -246,17 +263,44 @@ interface Ratio extends Element {
     numerator?: Quantity;
 }
 
+interface TimingRepeat extends Element {
+    boundsDuration?: Duration;
+    boundsPeriod?: Period;
+    boundsRange?: Range;
+    count?: number;
+    countMax?: number;
+    dayOfWeek?: ("mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun")[];
+    duration?: number;
+    durationMax?: number;
+    durationUnit?: ("s" | "min" | "h" | "d" | "wk" | "mo" | "a");
+    frequency?: number;
+    frequencyMax?: number;
+    offset?: number;
+    period?: number;
+    periodMax?: number;
+    periodUnit?: ("s" | "min" | "h" | "d" | "wk" | "mo" | "a");
+    timeOfDay?: string[];
+    when?: ("MORN" | "MORN.early" | "MORN.late" | "NOON" | "AFT" | "AFT.early" | "AFT.late" | "EVE" | "EVE.early" | "EVE.late" | "NIGHT" | "PHS" | "HS" | "WAKE" | "C" | "CM" | "CD" | "CV" | "AC" | "ACM" | "ACD" | "ACV" | "PC" | "PCM" | "PCD" | "PCV")[];
+}
 interface Timing extends BackboneElement {
-    code?: CodeableConcept;
+    code?: CodeableConcept<("BID" | "TID" | "QID" | "AM" | "PM" | "QD" | "QOD" | "Q1H" | "Q2H" | "Q3H" | "Q4H" | "Q6H" | "Q8H" | "BED" | "WK" | "MO" | string)>;
     event?: string[];
-    repeat?: Element;
+    repeat?: TimingRepeat;
 }
 
+interface DosageDoseAndRate extends Element {
+    doseQuantity?: Quantity;
+    doseRange?: Range;
+    rateQuantity?: Quantity;
+    rateRange?: Range;
+    rateRatio?: Ratio;
+    type?: CodeableConcept;
+}
 interface Dosage extends BackboneElement {
     additionalInstruction?: CodeableConcept[];
     asNeededBoolean?: boolean;
     asNeededCodeableConcept?: CodeableConcept;
-    doseAndRate?: Element[];
+    doseAndRate?: DosageDoseAndRate[];
     maxDosePerAdministration?: Quantity;
     maxDosePerLifetime?: Quantity;
     maxDosePerPeriod?: Ratio;
@@ -272,7 +316,7 @@ interface Dosage extends BackboneElement {
 interface Expression extends Element {
     description?: string;
     expression?: string;
-    language: string;
+    language: ("text/cql" | "text/fhirpath" | "application/x-fhir-query" | string);
     name?: string;
     reference?: string;
 }
@@ -327,7 +371,7 @@ interface Signature extends Element {
     onBehalfOf?: Reference<"Device" | "Organization" | "Patient" | "Practitioner" | "PractitionerRole" | "RelatedPerson">;
     sigFormat?: string;
     targetFormat?: string;
-    type: Coding[];
+    type: Coding<("1.2.840.10065.1.12.1.1" | "1.2.840.10065.1.12.1.2" | "1.2.840.10065.1.12.1.3" | "1.2.840.10065.1.12.1.4" | "1.2.840.10065.1.12.1.5" | "1.2.840.10065.1.12.1.6" | "1.2.840.10065.1.12.1.7" | "1.2.840.10065.1.12.1.8" | "1.2.840.10065.1.12.1.9" | "1.2.840.10065.1.12.1.10" | "1.2.840.10065.1.12.1.11" | "1.2.840.10065.1.12.1.12" | "1.2.840.10065.1.12.1.13" | "1.2.840.10065.1.12.1.14" | "1.2.840.10065.1.12.1.15" | "1.2.840.10065.1.12.1.16" | "1.2.840.10065.1.12.1.17" | "1.2.840.10065.1.12.1.18" | string)>[];
     when: string;
     who: Reference<"Device" | "Organization" | "Patient" | "Practitioner" | "PractitionerRole" | "RelatedPerson">;
 }
@@ -343,14 +387,109 @@ interface TriggerDefinition extends Element {
     type: ("named-event" | "periodic" | "data-changed" | "data-added" | "data-modified" | "data-removed" | "data-accessed" | "data-access-ended");
 }
 
+interface ElementDefinitionBase extends Element {
+    max: string;
+    min: number;
+    path: string;
+}
+interface ElementDefinitionBinding extends Element {
+    description?: string;
+    strength: ("required" | "extensible" | "preferred" | "example");
+    valueSet?: string;
+}
+interface ElementDefinitionConstraint extends Element {
+    expression?: string;
+    human: string;
+    key: string;
+    requirements?: string;
+    severity: ("error" | "warning");
+    source?: string;
+    xpath?: string;
+}
+interface ElementDefinitionExample extends Element {
+    label: string;
+    valueAddress?: Address;
+    valueAge?: Age;
+    valueAnnotation?: Annotation;
+    valueAttachment?: Attachment;
+    valueBase64Binary?: string;
+    valueBoolean?: boolean;
+    valueCanonical?: string;
+    valueCode?: string;
+    valueCodeableConcept?: CodeableConcept;
+    valueCoding?: Coding;
+    valueContactDetail?: ContactDetail;
+    valueContactPoint?: ContactPoint;
+    valueContributor?: Contributor;
+    valueCount?: Count;
+    valueDataRequirement?: DataRequirement;
+    valueDate?: string;
+    valueDateTime?: string;
+    valueDecimal?: number;
+    valueDistance?: Distance;
+    valueDosage?: Dosage;
+    valueDuration?: Duration;
+    valueExpression?: Expression;
+    valueHumanName?: HumanName;
+    valueId?: string;
+    valueIdentifier?: Identifier;
+    valueInstant?: string;
+    valueInteger?: number;
+    valueMarkdown?: string;
+    valueMeta?: Meta;
+    valueMoney?: Money;
+    valueOid?: string;
+    valueParameterDefinition?: ParameterDefinition;
+    valuePeriod?: Period;
+    valuePositiveInt?: number;
+    valueQuantity?: Quantity;
+    valueRange?: Range;
+    valueRatio?: Ratio;
+    valueReference?: Reference;
+    valueRelatedArtifact?: RelatedArtifact;
+    valueSampledData?: SampledData;
+    valueSignature?: Signature;
+    valueString?: string;
+    valueTime?: string;
+    valueTiming?: Timing;
+    valueTriggerDefinition?: TriggerDefinition;
+    valueUnsignedInt?: number;
+    valueUri?: string;
+    valueUrl?: string;
+    valueUsageContext?: UsageContext;
+    valueUuid?: string;
+}
+interface ElementDefinitionMapping extends Element {
+    comment?: string;
+    identity: string;
+    language?: string;
+    map: string;
+}
+interface ElementDefinitionSlicing extends Element {
+    description?: string;
+    discriminator?: ElementDefinitionSlicingDiscriminator[];
+    ordered?: boolean;
+    rules: ("closed" | "open" | "openAtEnd");
+}
+interface ElementDefinitionSlicingDiscriminator extends Element {
+    path: string;
+    type: ("value" | "exists" | "pattern" | "type" | "profile");
+}
+interface ElementDefinitionType extends Element {
+    aggregation?: ("contained" | "referenced" | "bundled")[];
+    code: string;
+    profile?: string[];
+    targetProfile?: string[];
+    versioning?: ("either" | "independent" | "specific");
+}
 interface ElementDefinition extends BackboneElement {
     alias?: string[];
-    base?: Element;
-    binding?: Element;
+    base?: ElementDefinitionBase;
+    binding?: ElementDefinitionBinding;
     code?: Coding[];
     comment?: string;
     condition?: string[];
-    constraint?: Element[];
+    constraint?: ElementDefinitionConstraint[];
     contentReference?: string;
     defaultValueAddress?: Address;
     defaultValueAge?: Age;
@@ -403,7 +542,7 @@ interface ElementDefinition extends BackboneElement {
     defaultValueUsageContext?: UsageContext;
     defaultValueUuid?: string;
     definition?: string;
-    example?: Element[];
+    example?: ElementDefinitionExample[];
     fixedAddress?: Address;
     fixedAge?: Age;
     fixedAnnotation?: Annotation;
@@ -458,7 +597,7 @@ interface ElementDefinition extends BackboneElement {
     isModifierReason?: string;
     isSummary?: boolean;
     label?: string;
-    mapping?: Element[];
+    mapping?: ElementDefinitionMapping[];
     max?: string;
     maxLength?: number;
     maxValueDate?: string;
@@ -539,8 +678,8 @@ interface ElementDefinition extends BackboneElement {
     short?: string;
     sliceIsConstraining?: boolean;
     sliceName?: string;
-    slicing?: Element;
-    type?: Element[];
+    slicing?: ElementDefinitionSlicing;
+    type?: ElementDefinitionType[];
 }
 
 interface StructureDefinitionContext extends BackboneElement {
@@ -575,7 +714,7 @@ interface StructureDefinition extends DomainResource {
     fhirVersion?: ("0.01" | "0.05" | "0.06" | "0.11" | "0.0.80" | "0.0.81" | "0.0.82" | "0.4.0" | "0.5.0" | "1.0.0" | "1.0.1" | "1.0.2" | "1.1.0" | "1.4.0" | "1.6.0" | "1.8.0" | "3.0.0" | "3.0.1" | "3.3.0" | "3.5.0" | "4.0.0" | "4.0.1");
     identifier?: Identifier[];
     jurisdiction?: CodeableConcept[];
-    keyword?: Coding[];
+    keyword?: Coding<("fhir-structure" | "custom-resource" | "dam" | "wire-format" | "archetype" | "template" | string)>[];
     kind: ("primitive-type" | "complex-type" | "resource" | "logical");
     mapping?: StructureDefinitionMapping[];
     name: string;
@@ -609,8 +748,8 @@ interface ValueSetComposeIncludeConcept extends BackboneElement {
     display?: string;
 }
 interface ValueSetComposeIncludeConceptDesignation extends BackboneElement {
-    language?: string;
-    use?: Coding;
+    language?: ("ar" | "bn" | "cs" | "da" | "de" | "de-AT" | "de-CH" | "de-DE" | "el" | "en" | "en-AU" | "en-CA" | "en-GB" | "en-IN" | "en-NZ" | "en-SG" | "en-US" | "es" | "es-AR" | "es-ES" | "es-UY" | "fi" | "fr" | "fr-BE" | "fr-CH" | "fr-FR" | "fy" | "fy-NL" | "hi" | "hr" | "it" | "it-CH" | "it-IT" | "ja" | "ko" | "nl" | "nl-BE" | "nl-NL" | "no" | "no-NO" | "pa" | "pl" | "pt" | "pt-BR" | "ru" | "ru-RU" | "sr" | "sr-RS" | "sv" | "sv-SE" | "te" | "zh" | "zh-CN" | "zh-HK" | "zh-SG" | "zh-TW" | string);
+    use?: Coding<("900000000000003001" | "900000000000013009" | string)>;
     value: string;
 }
 interface ValueSetComposeIncludeFilter extends BackboneElement {
@@ -668,42 +807,6 @@ interface ValueSet extends DomainResource {
     version?: string;
 }
 
-type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR" | "SILENT";
-type LogEntry<T extends string = string> = {
-    level: LogLevel;
-    tag?: T;
-    message: string;
-    suppressed: boolean;
-    prefix: string;
-    timestamp: number;
-};
-type Log<T extends string = string> = {
-    warn: TaggedLogFn<T>;
-    dryWarn: TaggedLogFn<T>;
-    info: TaggedLogFn<T>;
-    error: TaggedLogFn<T>;
-    debug: TaggedLogFn<T>;
-};
-type LogManager<T extends string = string> = Log<T> & {
-    fork(prefix: string, opts?: Partial<LoggerOptions<T>>): LogManager<T>;
-    as<Narrower extends string>(): LogManager<Narrower>;
-    tagCounts(): Readonly<Record<string, number>>;
-    printTagSummary(): void;
-    buffer(): readonly LogEntry<T>[];
-    bufferClear(): void;
-};
-type TaggedLogFn<T extends string> = (...args: [string] | [T, string]) => void;
-type LoggerOptions<T extends string> = {
-    prefix?: string;
-    suppressTags?: T[];
-    level?: LogLevel;
-};
-
-type CodegenTag = "#binding" | "#largeValueSet" | "#fieldTypeNotFound" | "#skipCanonical" | "#duplicateSchema" | "#duplicateCanonical" | "#resolveBase";
-type CodegenLog = Log<CodegenTag>;
-type CodegenLogManager = LogManager<CodegenTag>;
-declare const mkCodegenLogger: (opts?: LoggerOptions<CodegenTag>) => LogManager<CodegenTag>;
-
 /**
  * A code generation friendly representation of FHIR StructureDefinition and
  * FHIR Schema designed to simplify SDK resource classes/types generation.
@@ -726,28 +829,94 @@ type RichStructureDefinition = Omit<StructureDefinition, "url"> & {
     package_version: PkgVersion;
     url: CanonicalUrl;
 };
-type RichFHIRSchema = Omit<FS.FHIRSchema, "package_meta" | "base" | "name" | "url"> & {
+type FHIRSchemaKind = "primitive-type" | "complex-type" | "resource" | "logical";
+type RichFHIRSchemaBase = Omit<FS.FHIRSchema, "package_meta" | "base" | "name" | "url" | "derivation" | "kind"> & {
     package_meta: PackageMeta;
     name: Name;
     url: CanonicalUrl;
     base: CanonicalUrl;
+    kind: FHIRSchemaKind;
+};
+type RichProfileFHIRSchema = RichFHIRSchemaBase & {
+    derivation: "constraint";
+};
+type RichPrimitiveFHIRSchema = RichFHIRSchemaBase & {
+    derivation: "specialization";
+    kind: "primitive-type";
+};
+type RichComplexTypeFHIRSchema = RichFHIRSchemaBase & {
+    derivation: "specialization";
+    kind: "complex-type";
 };
+type RichResourceFHIRSchema = RichFHIRSchemaBase & {
+    derivation: "specialization";
+    kind: "resource";
+};
+type RichLogicalFHIRSchema = RichFHIRSchemaBase & {
+    derivation: "specialization";
+    kind: "logical";
+};
+type RichSpecializationFHIRSchema = RichPrimitiveFHIRSchema | RichComplexTypeFHIRSchema | RichResourceFHIRSchema | RichLogicalFHIRSchema;
+type RichFHIRSchema = RichProfileFHIRSchema | RichSpecializationFHIRSchema;
 type RichValueSet = Omit<ValueSet, "name" | "url"> & {
     package_meta: PackageMeta;
     name: Name;
     url: CanonicalUrl;
 };
 
+type CollisionResolution = {
+    package: string;
+    canonical: string;
+};
+type ResolveCollisionsConf = Record<string, CollisionResolution>;
 type IrConf = {
     treeShake?: TreeShakeConf;
     promoteLogical?: LogicalPromotionConf;
+    resolveCollisions?: ResolveCollisionsConf;
 };
 type LogicalPromotionConf = Record<PkgName$1, CanonicalUrl[]>;
 type TreeShakeConf = Record<string, Record<string, TreeShakeRule>>;
 type TreeShakeRule = {
     ignoreFields?: string[];
     selectFields?: string[];
+    ignoreExtensions?: string[];
+};
+
+type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR" | "SILENT";
+type LogEntry<T extends string = string> = {
+    level: LogLevel;
+    tag?: T;
+    message: string;
+    suppressed: boolean;
+    prefix: string;
+    timestamp: number;
+};
+type Log<T extends string = string> = {
+    warn: TaggedLogFn<T>;
+    dryWarn: TaggedLogFn<T>;
+    info: TaggedLogFn<T>;
+    error: TaggedLogFn<T>;
+    debug: TaggedLogFn<T>;
 };
+type LogManager<T extends string = string> = Log<T> & {
+    fork(prefix: string, opts?: Partial<LoggerOptions<T>>): LogManager<T>;
+    as<Narrower extends string>(): LogManager<Narrower>;
+    tagCounts(): Readonly<Record<string, number>>;
+    printTagSummary(): void;
+    buffer(): readonly LogEntry<T>[];
+    bufferClear(): void;
+};
+type TaggedLogFn<T extends string> = (...args: [string] | [T, string]) => void;
+type LoggerOptions<T extends string> = {
+    prefix?: string;
+    suppressTags?: T[];
+    level?: LogLevel;
+};
+
+type CodegenTag = "#binding" | "#largeValueSet" | "#fieldTypeNotFound" | "#skipCanonical" | "#duplicateSchema" | "#duplicateCanonical" | "#resolveBase" | "#resolveCollisionMiss";
+type CodegenLog = Log<CodegenTag>;
+type CodegenLogManager = LogManager<CodegenTag>;
+declare const mkCodegenLogger: (opts?: LoggerOptions<CodegenTag>) => LogManager<CodegenTag>;
 
 type Register = {
     testAppendFs(fs: FHIRSchema): void;
@@ -912,8 +1081,7 @@ interface APIBuilderOptions {
     outputDir: string;
     cleanOutput: boolean;
     throwException: boolean;
-    treeShake: TreeShakeConf | undefined;
-    promoteLogical: LogicalPromotionConf | undefined;
+    typeSchema?: IrConf;
     /** Custom FHIR package registry URL (default: https://fs.get-ig.org/pkgs/) */
     registry: string | undefined;
     /** Drop the canonical manager cache */