@urbicon-ui/docs-gen 6.1.4

package/dist/parsers/SvelteDocsParser.js

@@ -0,0 +1,141 @@
+import * as fs from 'node:fs/promises';
+import { isValidSvelteDocsConfig, mergeWithSvelteDocsDefaults } from '../types';
+/**
+ * Simplified parser for docs.svelte files
+ * Focuses exclusively on extracting the exported docsConfig.
+ * Section parsing has been removed intentionally to reduce complexity.
+ */
+export class SvelteDocsParser {
+    /**
+     * Parse a docs.svelte file for a component
+     * @param componentName Name of the component
+     * @param docsFilePath Optional path to the docs file (if not provided, returns defaults)
+     */
+    async parseDocsFile(componentName, docsFilePath) {
+        console.log(`📄 SvelteDocsParser: Parsing docs for ${componentName}`);
+        // If no docs file provided, return defaults immediately
+        if (!docsFilePath) {
+            console.log(`📄 SvelteDocsParser: No docs file provided for ${componentName} - using defaults`);
+            return {
+                docsConfig: mergeWithSvelteDocsDefaults({}),
+                sections: [],
+                exists: false,
+                errors: [],
+                warnings: []
+            };
+        }
+        console.log(`📄 SvelteDocsParser: Using docs file: ${docsFilePath}`);
+        try {
+            // Read the file content
+            const content = await fs.readFile(docsFilePath, 'utf-8');
+            console.log(`📄 SvelteDocsParser: Found docs.svelte, content length: ${content.length}`);
+            // Extract docsConfig from content
+            const docsConfig = this.extractDocsConfig(content);
+            console.log(`📄 SvelteDocsParser: Extracted docsConfig:`, docsConfig);
+            // Validate the configuration
+            const validation = this.validateConfig(docsConfig);
+            return {
+                docsConfig: mergeWithSvelteDocsDefaults(docsConfig),
+                sections: [], // Section parsing intentionally removed
+                exists: true,
+                errors: validation.errors,
+                warnings: validation.warnings
+            };
+        }
+        catch (error) {
+            console.error(`📄 SvelteDocsParser: Error parsing ${docsFilePath}:`, error);
+            return {
+                docsConfig: mergeWithSvelteDocsDefaults({}),
+                sections: [],
+                exists: true, // File exists but has parsing errors
+                errors: [
+                    `Failed to parse docs.svelte: ${error instanceof Error ? error.message : String(error)}`
+                ],
+                warnings: []
+            };
+        }
+    }
+    // ==========================================
+    // DOCS CONFIG EXTRACTION
+    // ==========================================
+    /**
+     * Extract export const docsConfig from script block using regex
+     * Simplified approach focused on modern Svelte 5 syntax only
+     */
+    extractDocsConfig(content) {
+        console.log(`🔍 SvelteDocsParser: Extracting docsConfig from content`);
+        try {
+            // Find export const docsConfig = { ... }; pattern
+            const typedPattern = /export\s+const\s+docsConfig\s*:\s*SvelteDocsConfig\s*=\s*({[\s\S]*?});/;
+            const untypedPattern = /export\s+const\s+docsConfig\s*=\s*({[\s\S]*?});/;
+            const match = content.match(typedPattern) || content.match(untypedPattern);
+            if (!match) {
+                console.log(`🔍 SvelteDocsParser: No docsConfig export found`);
+                return {};
+            }
+            const configString = match[1];
+            console.log(`🔍 SvelteDocsParser: Found config string (first 200 chars):`, `${configString.substring(0, 200)}...`);
+            // Parse the object literal
+            const config = this.parseConfigObject(configString);
+            return config;
+        }
+        catch (error) {
+            console.warn(`🔍 SvelteDocsParser: Failed to extract docsConfig:`, error);
+            return {};
+        }
+    }
+    /**
+     * Parse config object string into SvelteDocsConfig
+     * Uses eval for object literals (safe in build context)
+     */
+    parseConfigObject(configString) {
+        try {
+            // Use eval directly since we're in a controlled build environment
+            // and the content comes from our own source files
+            console.log(`🔍 SvelteDocsParser: Parsing config object with eval`);
+            // biome-ignore lint/security/noGlobalEval: build-time parse of our own doc-config object literals, never runtime or user input (see above).
+            return eval(`(${configString})`);
+        }
+        catch (evalError) {
+            console.error(`🔍 SvelteDocsParser: Failed to parse config object:`, evalError);
+            console.error(`🔍 SvelteDocsParser: Config string was:`, configString.substring(0, 300));
+            return {};
+        }
+    }
+    // ==========================================
+    // VALIDATION
+    // ==========================================
+    /**
+     * Validate docs configuration
+     */
+    validateConfig(config) {
+        const errors = [];
+        const warnings = [];
+        const suggestions = [];
+        if (!isValidSvelteDocsConfig(config)) {
+            errors.push('Invalid docs configuration structure');
+        }
+        // Check for common issues
+        if (config.generation?.playground?.featured &&
+            config.generation.playground.featured.length === 0) {
+            warnings.push('Playground featured array is empty - consider removing or adding props');
+        }
+        if (config.generation?.variants?.exclude && config.generation.variants.exclude.length > 5) {
+            warnings.push('Many variants excluded - consider reviewing variant design');
+        }
+        // Suggestions for better docs
+        if (!config.meta?.description) {
+            suggestions.push('Consider adding a component description for better documentation');
+        }
+        if (config.llm?.include === undefined) {
+            suggestions.push('Consider explicitly setting llm.include to control LLM documentation generation');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            suggestions
+        };
+    }
+}
+//# sourceMappingURL=SvelteDocsParser.js.map

package/dist/parsers/SvelteDocsParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SvelteDocsParser.js","sourceRoot":"","sources":["../../src/parsers/SvelteDocsParser.ts"],"names":[],"mappings":"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"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,2 @@
+export { type SvelteDocsParseResult, SvelteDocsParser } from './SvelteDocsParser';
+//# sourceMappingURL=index.d.ts.map

package/dist/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/parsers/index.js

@@ -0,0 +1,6 @@
+// packages/docs-gen/src/parsers/index.ts
+// ==========================================
+// PARSERS - MAIN EXPORTS
+// ==========================================
+export { SvelteDocsParser } from './SvelteDocsParser';
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,6CAA6C;AAC7C,yBAAyB;AACzB,6CAA6C;AAE7C,OAAO,EAA8B,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/schema/ConfigurationBuilder.d.ts

@@ -0,0 +1,55 @@
+import type { ConfigValidationResult, GeneratorConfig, GeneratorConfigBuilder, PackageConfig, TypeScriptConfig } from '../types';
+/**
+ * Builder for creating and validating documentation configurations
+ */
+export declare class DocsConfigurationBuilder implements GeneratorConfigBuilder {
+    private config;
+    constructor(baseConfig?: Partial<GeneratorConfig>);
+    addPackage(packageConfig: PackageConfig): GeneratorConfigBuilder;
+    setTypeScript(tsConfig: TypeScriptConfig): GeneratorConfigBuilder;
+    setSchema(schemaConfig: Partial<GeneratorConfig['input']['schema']>): GeneratorConfigBuilder;
+    setExtraction(extractionConfig: Partial<GeneratorConfig['processing']['extraction']>): GeneratorConfigBuilder;
+    setEnrichment(enrichmentConfig: Partial<GeneratorConfig['processing']['enrichment']>): GeneratorConfigBuilder;
+    setValidation(validationConfig: Partial<GeneratorConfig['processing']['validation']>): GeneratorConfigBuilder;
+    enableParallel(parallelConfig?: Partial<GeneratorConfig['processing']['parallel']>): GeneratorConfigBuilder;
+    setLLMOutput(llmConfig: Partial<GeneratorConfig['output']['llm']>): GeneratorConfigBuilder;
+    setAPIOutput(apiConfig: Partial<GeneratorConfig['output']['api']>): GeneratorConfigBuilder;
+    enableWatch(watchConfig?: Partial<GeneratorConfig['watch']>): GeneratorConfigBuilder;
+    enableDebug(debugConfig?: Partial<GeneratorConfig['debug']>): GeneratorConfigBuilder;
+    validate(): ConfigValidationResult;
+    build(): GeneratorConfig;
+    /**
+     * Reset to default configuration
+     */
+    reset(): GeneratorConfigBuilder;
+}
+export declare class ConfigurationFactory {
+    /**
+     * Create Blocks-specific configuration
+     */
+    static blocks(): GeneratorConfig;
+    /**
+     * Create Docs-specific configuration
+     */
+    static docs(): GeneratorConfig;
+    /**
+     * Create Table-specific configuration
+     */
+    static table(): GeneratorConfig;
+    /**
+     * Create Auth-specific configuration
+     */
+    static auth(): GeneratorConfig;
+    /**
+     * Create single package configuration
+     */
+    static singlePackage(packagePath: string, packageName: string): GeneratorConfig;
+    /**
+     * Load configuration from file
+     */
+    static fromFile(configPath: string): Promise<GeneratorConfig>;
+    private static loadJSONConfig;
+    private static loadESModuleConfig;
+    private static validateAndBuildConfig;
+}
+//# sourceMappingURL=ConfigurationBuilder.d.ts.map

package/dist/schema/ConfigurationBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationBuilder.d.ts","sourceRoot":"","sources":["../../src/schema/ConfigurationBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAsFlB;;GAEG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE,OAAO,CAAC,MAAM,CAAkB;gBAEpB,UAAU,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAajD,UAAU,CAAC,aAAa,EAAE,aAAa,GAAG,sBAAsB;IAKhE,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,sBAAsB;IAKjE,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,sBAAsB;IAY5F,aAAa,CACX,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,GACrE,sBAAsB;IAQzB,aAAa,CACX,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,GACrE,sBAAsB;IAQzB,aAAa,CACX,gBAAgB,EAAE,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,YAAY,CAAC,CAAC,GACrE,sBAAsB;IAQzB,cAAc,CACZ,cAAc,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,CAAC,GAClE,sBAAsB;IAczB,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,sBAAsB;IAQ1F,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,sBAAsB;IAY1F,WAAW,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,sBAAsB;IAUpF,WAAW,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,sBAAsB;IAgBpF,QAAQ,IAAI,sBAAsB;IAiClC,KAAK,IAAI,eAAe;IAoBxB;;OAEG;IACH,KAAK,IAAI,sBAAsB;CAIhC;AAOD,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,eAAe;IA2BhC;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,eAAe;IA0B9B;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,eAAe;IAyB/B;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,eAAe;IAuB9B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe;IAc/E;;OAEG;WACU,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;mBAmC9C,cAAc;mBAOd,kBAAkB;IAcvC,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAoDtC"}

package/dist/schema/ConfigurationBuilder.js

@@ -0,0 +1,447 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+// ==========================================
+// DEFAULT CONFIGURATION FACTORY
+// ==========================================
+/**
+ * Creates a complete default configuration
+ */
+function createDefaultConfig() {
+    return {
+        input: {
+            packages: [],
+            schema: {
+                version: '2.0.0',
+                strict: true
+            }
+        },
+        processing: {
+            extraction: {
+                typescript: {
+                    extractJSDoc: true,
+                    extractTypeReferences: true,
+                    extractDefaultValues: true,
+                    resolveTypeAliases: true
+                },
+                variants: {
+                    frameworks: ['tailwind-variants'],
+                    extractDefaults: true
+                },
+                documentation: {
+                    validateSchema: true,
+                    allowPartialDocs: false
+                },
+                inheritance: {
+                    resolveExternalTypes: true,
+                    includeHTMLAttributes: true,
+                    maxDepth: 5
+                }
+            },
+            enrichment: {
+                crossReferences: {
+                    enabled: true,
+                    includeExternal: true
+                },
+                metadata: {
+                    extractStats: true,
+                    calculateComplexity: true
+                }
+            },
+            validation: {
+                rules: [],
+                schema: {
+                    enabled: true,
+                    failOnError: false
+                },
+                examples: {
+                    syntax: true
+                },
+                components: {}
+            }
+        },
+        output: {
+            llm: {
+                enabled: true,
+                // Write into a directory by default to enable per-component files
+                outputPath: './generated/llm',
+                format: 'markdown'
+            },
+            api: {
+                enabled: true,
+                outputPath: './src/lib/generated/api-props.ts',
+                format: 'typescript'
+            },
+            shared: {
+                clean: true,
+                createDirectories: true,
+                overwrite: true,
+                backup: {
+                    enabled: false
+                }
+            }
+        }
+    };
+}
+/**
+ * Builder for creating and validating documentation configurations
+ */
+export class DocsConfigurationBuilder {
+    config;
+    constructor(baseConfig) {
+        this.config = createDefaultConfig();
+        // If a baseConfig is provided, merge it with the defaults
+        if (baseConfig) {
+            this.config = JSON.parse(JSON.stringify({ ...this.config, ...baseConfig }));
+        }
+    }
+    // ==========================================
+    // INPUT CONFIGURATION
+    // ==========================================
+    addPackage(packageConfig) {
+        this.config.input.packages.push(packageConfig);
+        return this;
+    }
+    setTypeScript(tsConfig) {
+        this.config.input.typescript = tsConfig;
+        return this;
+    }
+    setSchema(schemaConfig) {
+        this.config.input.schema = {
+            ...this.config.input.schema,
+            ...schemaConfig
+        };
+        return this;
+    }
+    // ==========================================
+    // PROCESSING CONFIGURATION
+    // ==========================================
+    setExtraction(extractionConfig) {
+        this.config.processing.extraction = {
+            ...this.config.processing.extraction,
+            ...extractionConfig
+        };
+        return this;
+    }
+    setEnrichment(enrichmentConfig) {
+        this.config.processing.enrichment = {
+            ...this.config.processing.enrichment,
+            ...enrichmentConfig
+        };
+        return this;
+    }
+    setValidation(validationConfig) {
+        this.config.processing.validation = {
+            ...this.config.processing.validation,
+            ...validationConfig
+        };
+        return this;
+    }
+    enableParallel(parallelConfig) {
+        this.config.processing.parallel = {
+            enabled: true,
+            maxConcurrency: 4,
+            strategy: 'auto',
+            ...parallelConfig
+        };
+        return this;
+    }
+    // ==========================================
+    // OUTPUT CONFIGURATION
+    // ==========================================
+    setLLMOutput(llmConfig) {
+        this.config.output.llm = {
+            ...this.config.output.llm,
+            ...llmConfig
+        };
+        return this;
+    }
+    setAPIOutput(apiConfig) {
+        this.config.output.api = {
+            ...this.config.output.api,
+            ...apiConfig
+        };
+        return this;
+    }
+    // ==========================================
+    // ADDITIONAL FEATURES
+    // ==========================================
+    enableWatch(watchConfig) {
+        this.config.watch = {
+            enabled: true,
+            debounce: 1000,
+            events: ['add', 'change', 'unlink'],
+            ...watchConfig
+        };
+        return this;
+    }
+    enableDebug(debugConfig) {
+        this.config.debug = {
+            enabled: true,
+            level: 'info',
+            output: {
+                console: true
+            },
+            ...debugConfig
+        };
+        return this;
+    }
+    // ==========================================
+    // BUILD & VALIDATE
+    // ==========================================
+    validate() {
+        const errors = [];
+        const warnings = [];
+        // Basic validation
+        if (!this.config.input.packages.length) {
+            errors.push({
+                path: 'input.packages',
+                message: 'At least one package must be configured'
+            });
+        }
+        if (!this.config.output.llm.outputPath && this.config.output.llm.enabled) {
+            errors.push({
+                path: 'output.llm.outputPath',
+                message: 'LLM output path is required when LLM output is enabled'
+            });
+        }
+        if (!this.config.output.api.outputPath && this.config.output.api.enabled) {
+            errors.push({
+                path: 'output.api.outputPath',
+                message: 'API output path is required when API output is enabled'
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    build() {
+        const validation = this.validate();
+        if (!validation.valid) {
+            throw new Error(`Configuration validation failed: ${validation.errors.map((e) => e.message).join(', ')}`);
+        }
+        if (validation.warnings && validation.warnings.length > 0) {
+            console.warn('Configuration warnings:', validation.warnings.map((w) => w.message));
+        }
+        // No type cast needed anymore
+        return this.config;
+    }
+    /**
+     * Reset to default configuration
+     */
+    reset() {
+        this.config = createDefaultConfig();
+        return this;
+    }
+}
+// ==========================================
+// CONFIGURATION FACTORY - Preset configurations
+// ==========================================
+// biome-ignore lint/complexity/noStaticOnlyClass: intentional namespace grouping of config factories.
+export class ConfigurationFactory {
+    /**
+     * Create Blocks-specific configuration
+     */
+    static blocks() {
+        return new DocsConfigurationBuilder()
+            .addPackage({
+            name: '@urbicon-ui/blocks',
+            path: '../blocks',
+            glob: {
+                components: 'src/lib/{primitives,components}/**/index.ts',
+                variants: 'src/lib/{primitives,components}/**/*.variants.ts',
+                documentation: 'src/lib/{primitives,components}/**/docs.svelte'
+            }
+        })
+            .setLLMOutput({
+            enabled: true,
+            // New static layout under blocks with grouping
+            outputPath: '../../apps/docs/static/blocks',
+            format: 'text'
+        })
+            .setAPIOutput({
+            enabled: true,
+            // Directory mode; will write per-component api.ts under group folder (components/primitives)
+            outputPath: '../../apps/docs/src/routes/blocks',
+            format: 'typescript'
+        })
+            .build();
+    }
+    /**
+     * Create Docs-specific configuration
+     */
+    static docs() {
+        return new DocsConfigurationBuilder()
+            .addPackage({
+            name: '@urbicon-ui/docs',
+            path: '../docs',
+            glob: {
+                components: 'src/lib/components/**/index.ts',
+                variants: 'src/lib/components/**/*.variants.ts',
+                documentation: 'src/lib/components/**/docs.svelte'
+            }
+        })
+            .setLLMOutput({
+            enabled: true,
+            // Write under SvelteKit static path, mirroring routes hierarchy
+            outputPath: '../../apps/docs/static/docs',
+            format: 'text'
+        })
+            .setAPIOutput({
+            enabled: true,
+            outputPath: '../../apps/docs/src/routes/docs',
+            format: 'typescript'
+        })
+            .build();
+    }
+    /**
+     * Create Table-specific configuration
+     */
+    static table() {
+        return new DocsConfigurationBuilder()
+            .addPackage({
+            name: '@urbicon-ui/table',
+            path: '../table',
+            glob: {
+                components: 'src/lib/core/table/index.ts',
+                documentation: 'src/lib/core/table/docs.svelte'
+            }
+        })
+            .setLLMOutput({
+            enabled: true,
+            // Write under SvelteKit static path, mirroring routes hierarchy
+            outputPath: '../../apps/docs/static/table',
+            format: 'text'
+        })
+            .setAPIOutput({
+            enabled: true,
+            outputPath: '../../apps/docs/src/routes/table',
+            format: 'typescript'
+        })
+            .build();
+    }
+    /**
+     * Create Auth-specific configuration
+     */
+    static auth() {
+        return new DocsConfigurationBuilder()
+            .addPackage({
+            name: '@urbicon-ui/auth',
+            path: '../auth',
+            glob: {
+                components: 'src/lib/client/components/*/index.ts'
+            }
+        })
+            .setLLMOutput({
+            enabled: true,
+            outputPath: '../../apps/docs/static/auth',
+            format: 'text'
+        })
+            .setAPIOutput({
+            enabled: true,
+            outputPath: '../../apps/docs/src/routes/auth',
+            format: 'typescript'
+        })
+            .build();
+    }
+    /**
+     * Create single package configuration
+     */
+    static singlePackage(packagePath, packageName) {
+        return new DocsConfigurationBuilder()
+            .addPackage({
+            name: packageName,
+            path: packagePath,
+            glob: {
+                components: 'src/components/*/index.ts',
+                variants: 'src/components/*/*.variants.ts',
+                documentation: 'src/components/*/docs.ts'
+            }
+        })
+            .build();
+    }
+    /**
+     * Load configuration from file
+     */
+    static async fromFile(configPath) {
+        try {
+            const absolutePath = path.resolve(configPath);
+            // Check if file exists
+            await fs.access(absolutePath);
+            console.log(`📋 Loading configuration from: ${absolutePath}`);
+            // Determine file type and load accordingly
+            const ext = path.extname(absolutePath).toLowerCase();
+            switch (ext) {
+                case '.json':
+                    return ConfigurationFactory.loadJSONConfig(absolutePath);
+                case '.js':
+                case '.mjs':
+                case '.ts':
+                    return ConfigurationFactory.loadESModuleConfig(absolutePath);
+                default:
+                    throw new Error(`Unsupported config file type: ${ext}. Supported: .json, .js, .mjs, .ts`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('ENOENT')) {
+                throw new Error(`Configuration file not found: ${configPath}`, { cause: error });
+            }
+            throw new Error(`Failed to load configuration from ${configPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    static async loadJSONConfig(filePath) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const configData = JSON.parse(content);
+        return ConfigurationFactory.validateAndBuildConfig(configData, filePath);
+    }
+    static async loadESModuleConfig(filePath) {
+        // Use dynamic import to load ES modules
+        const configModule = await import(fileURLToPath(filePath));
+        const configData = configModule.default || configModule.config;
+        if (!configData) {
+            throw new Error(`Configuration file must export a default config or named 'config' export: ${filePath}`);
+        }
+        return ConfigurationFactory.validateAndBuildConfig(configData, filePath);
+    }
+    static validateAndBuildConfig(configData, filePath) {
+        // Create builder and populate with loaded data
+        const builder = new DocsConfigurationBuilder();
+        // Apply loaded configuration data
+        if (configData.input?.packages) {
+            configData.input.packages.forEach((pkg) => {
+                builder.addPackage(pkg);
+            });
+        }
+        if (configData.input?.typescript) {
+            builder.setTypeScript(configData.input.typescript);
+        }
+        if (configData.processing?.extraction) {
+            builder.setExtraction(configData.processing.extraction);
+        }
+        if (configData.processing?.enrichment) {
+            builder.setEnrichment(configData.processing.enrichment);
+        }
+        if (configData.processing?.validation) {
+            builder.setValidation(configData.processing.validation);
+        }
+        if (configData.output?.llm) {
+            builder.setLLMOutput(configData.output.llm);
+        }
+        if (configData.output?.api) {
+            builder.setAPIOutput(configData.output.api);
+        }
+        if (configData.watch) {
+            builder.enableWatch(configData.watch);
+        }
+        if (configData.debug) {
+            builder.enableDebug(configData.debug);
+        }
+        // Build and validate
+        const config = builder.build();
+        console.log(`✅ Configuration loaded successfully from ${filePath}`);
+        return config;
+    }
+}
+//# sourceMappingURL=ConfigurationBuilder.js.map