@atomic-ehr/codegen 0.0.4 → 0.0.5-canary.20251229160950.1f6114f

package/dist/index.d.ts

@@ -12,11 +12,13 @@ declare enum LogLevel {
     ERROR = 3,
     SILENT = 4
 }
+type LogLevelString = keyof typeof LogLevel;
 interface LogOptions {
     prefix?: string;
     timestamp?: boolean;
-    verbose?: boolean;
     suppressLoggingLevel?: LogLevel[] | "all";
+    /** Minimum log level to display. Messages below this level are suppressed. Default: INFO */
+    level?: LogLevel;
 }
 /**
  * Simple code generation logger with pretty colors and clean formatting
@@ -25,6 +27,10 @@ declare class CodegenLogger {
     private options;
     private dryWarnSet;
     constructor(options?: LogOptions);
+    /**
+     * Check if a message at the given level should be logged
+     */
+    private shouldLog;
     private static consoleLevelsMap;
     private formatMessage;
     private isSuppressed;
@@ -47,7 +53,7 @@ declare class CodegenLogger {
      */
     info(message: string): void;
     /**
-     * Debug message (only shows in verbose mode)
+     * Debug message (only shows when log level is DEBUG or verbose is true)
      */
     debug(message: string): void;
     /**
@@ -74,6 +80,8 @@ declare class CodegenLogger {
      * Update options
      */
     configure(options: Partial<LogOptions>): void;
+    getLevel(): LogLevel;
+    setLevel(level: LogLevel): void;
 }
 
 interface Element {
@@ -126,6 +134,10 @@ type Name = string & {
 type CanonicalUrl = string & {
     readonly __brand: unique symbol;
 };
+interface PackageMeta {
+    name: string;
+    version: string;
+}
 type IdentifierBase = {
     name: Name;
     url: CanonicalUrl;
@@ -289,10 +301,38 @@ interface BindingTypeSchema {
 }
 type Field = RegularField | ChoiceFieldDeclaration | ChoiceFieldInstance;
 
-type TypeSchemaShakeRule = {
+type TreeShake = Record<string, Record<string, TreeShakeRule>>;
+type TreeShakeRule = {
     ignoreFields?: string[];
+    selectFields?: string[];
+};
+
+type FileSystemWriterOptions = {
+    outputDir: string;
+    inMemoryOnly?: boolean;
+    logger?: CodegenLogger;
+    resolveAssets?: (fn: string) => string;
+};
+type WriterOptions = FileSystemWriterOptions & {
+    tabSize: number;
+    withDebugComment?: boolean;
+    commentLinePrefix: string;
+    generateProfile?: boolean;
+};
+
+type CSharpGeneratorOptions = WriterOptions & {
+    outputDir: string;
+    staticSourceDir?: string;
+    rootNamespace: string;
 };
-type TreeShake = Record<string, Record<string, TypeSchemaShakeRule>>;
+
+type StringFormatKey = "snake_case" | "PascalCase" | "camelCase";
+interface PythonGeneratorOptions extends WriterOptions {
+    allowExtraFields?: boolean;
+    staticDir?: string;
+    rootPackageName: string;
+    fieldFormat: StringFormatKey;
+}
 
 /**
  * New Config Schema for High-Level API
@@ -415,6 +455,8 @@ interface Config {
     typeSchema?: TypeSchemaConfig;
     packages?: string[];
     files?: string[];
+    /** Custom FHIR package registry URL (default: https://fs.get-ig.org/pkgs/) */
+    registry?: string;
     $schema?: string;
 }
 /**
@@ -513,16 +555,54 @@ declare function isConfig(obj: unknown): obj is Config;
  */
 declare function defineConfig(config: Config): Config;
 
-type FileSystemWriterOptions = {
-    outputDir: string;
-    inMemoryOnly?: boolean;
-    logger?: CodegenLogger;
+type NameTransformation = {
+    pattern: RegExp | string;
+    format: string;
 };
-type WriterOptions = FileSystemWriterOptions & {
-    tabSize: number;
-    withDebugComment?: boolean;
-    commentLinePrefix: string;
-    generateProfile?: boolean;
+type DistinctNameConfigurationType<T> = {
+    common: T;
+    enumValue: T;
+    type: T;
+    field: T;
+};
+
+type FilterType = {
+    whitelist?: (string | RegExp)[];
+    blacklist?: (string | RegExp)[];
+};
+type HookType = {
+    cmd: string;
+    args?: string[];
+};
+declare const PRIMITIVE_TYPES: readonly ["boolean", "instant", "time", "date", "dateTime", "decimal", "integer", "unsignedInt", "positiveInt", "integer64", "base64Binary", "uri", "url", "canonical", "oid", "uuid", "string", "code", "markdown", "id", "xhtml"];
+type PrimitiveType = (typeof PRIMITIVE_TYPES)[number];
+type Rendering = {
+    source: string;
+    fileNameFormat: string;
+    path: string;
+    filter?: FilterType;
+    properties?: Record<string, any>;
+};
+
+type FileBasedMustacheGeneratorOptions = {
+    debug: "OFF" | "FORMATTED" | "COMPACT";
+    meta: {
+        timestamp?: string;
+        generator?: string;
+    };
+    renderings: {
+        utility: Rendering[];
+        resource: Rendering[];
+        complexType: Rendering[];
+    };
+    keywords: string[];
+    primitiveTypeMap: Partial<Record<PrimitiveType, string>>;
+    nameTransformations: DistinctNameConfigurationType<NameTransformation[]>;
+    unsaveCharacterPattern: string | RegExp;
+    shouldRunHooks: boolean;
+    hooks: {
+        afterGenerate?: HookType[];
+    };
 };
 
 type TypeScriptOptions = {
@@ -547,7 +627,6 @@ type TypeScriptOptions = {
  */
 interface APIBuilderOptions {
     outputDir?: string;
-    verbose?: boolean;
     overwrite?: boolean;
     cache?: boolean;
     cleanOutput?: boolean;
@@ -558,21 +637,28 @@ interface APIBuilderOptions {
     throwException?: boolean;
     exportTypeTree?: string;
     treeShake?: TreeShake;
+    /** Log level for the logger. Default: INFO */
+    logLevel?: LogLevel;
+    /** Custom FHIR package registry URL (default: https://fs.get-ig.org/pkgs/) */
+    registry?: string;
 }
 /**
  * Progress callback for long-running operations
  */
 type ProgressCallback = (phase: string, current: number, total: number, message?: string) => void;
-/**
- * Generation result information
- */
-interface GenerationResult {
+type GenerationReport = {
     success: boolean;
     outputDir: string;
-    filesGenerated: string[];
+    filesGenerated: Record<string, string>;
     errors: string[];
     warnings: string[];
     duration: number;
+};
+declare const prettyReport: (report: GenerationReport) => string;
+interface LocalStructureDefinitionConfig {
+    package: PackageMeta;
+    path: string;
+    dependencies?: PackageMeta[];
 }
 /**
  * High-Level API Builder class
@@ -586,14 +672,25 @@ declare class APIBuilder {
     private generators;
     private logger;
     private packages;
+    private localStructurePackages;
+    private localTgzArchives;
     progressCallback: any;
     private typeSchemaConfig?;
     constructor(options?: APIBuilderOptions);
     fromPackage(packageName: string, version?: string): APIBuilder;
     fromPackageRef(packageRef: string): APIBuilder;
+    /**
+     * Set a custom FHIR package registry URL
+     * @param url The registry URL (default: https://fs.get-ig.org/pkgs/)
+     */
+    registry(url: string): APIBuilder;
+    localStructureDefinitions(config: LocalStructureDefinitionConfig): APIBuilder;
+    localTgzPackage(archivePath: string): APIBuilder;
     fromSchemas(schemas: TypeSchema[]): APIBuilder;
     typescript(userOpts: Partial<TypeScriptOptions>): this;
-    csharp(namespace: string, staticSourceDir?: string | undefined): APIBuilder;
+    python(userOptions: Partial<PythonGeneratorOptions>): APIBuilder;
+    mustache(templatePath: string, userOpts: Partial<FileSystemWriterOptions & FileBasedMustacheGeneratorOptions>): this;
+    csharp(userOptions: Partial<CSharpGeneratorOptions>): APIBuilder;
     /**
      * Set a progress callback for monitoring generation
      */
@@ -602,13 +699,13 @@ declare class APIBuilder {
      * Set the output directory for all generators
      */
     outputTo(directory: string): APIBuilder;
-    verbose(enabled?: boolean): APIBuilder;
+    setLogLevel(level: LogLevel | LogLevelString): APIBuilder;
     throwException(enabled?: boolean): APIBuilder;
     cleanOutput(enabled?: boolean): APIBuilder;
     writeTypeTree(filename: string): this;
     treeShake(tree: TreeShake): this;
     writeTypeSchemas(target: string): this;
-    generate(): Promise<GenerationResult>;
+    generate(): Promise<GenerationReport>;
     /**
      * Clear all configuration and start fresh
      */
@@ -624,10 +721,4 @@ declare class APIBuilder {
     private executeGenerators;
 }
 
-type CSharpGeneratorOptions = WriterOptions & {
-    outputDir: string;
-    staticSourceDir?: string;
-    targetNamespace: string;
-};
-
-export { APIBuilder, type APIBuilderOptions, CONFIG_FILE_NAMES, type CSharpGeneratorOptions, type Config, ConfigLoader, type ConfigValidationError, type ConfigValidationResult, ConfigValidator, DEFAULT_CONFIG, type TypeSchemaConfig, type TypeScriptGeneratorConfig, type TypeScriptOptions, configLoader, defineConfig, isConfig, loadConfig };
+export { APIBuilder, type APIBuilderOptions, CONFIG_FILE_NAMES, type CSharpGeneratorOptions, type Config, ConfigLoader, type ConfigValidationError, type ConfigValidationResult, ConfigValidator, DEFAULT_CONFIG, type LocalStructureDefinitionConfig, LogLevel, type TypeSchemaConfig, type TypeScriptGeneratorConfig, type TypeScriptOptions, configLoader, defineConfig, isConfig, loadConfig, prettyReport };