@specverse/engine-realize 3.5.3

package/dist/engines/engine-registry.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Template Engine Registry
+ *
+ * Manages multiple template engines and provides a unified
+ * interface for rendering templates.
+ */
+import type { TemplateEngine, CodeTemplate, TemplateContext } from '../types/index.js';
+/**
+ * Engine registry configuration
+ */
+export interface EngineRegistryConfig {
+    /** Base directory for resolving template paths */
+    baseDir?: string;
+    /** Enable caching of loaded modules */
+    enableCache?: boolean;
+    /** Custom engine implementations */
+    customEngines?: Map<string, TemplateEngine>;
+}
+/**
+ * Engine not found error
+ */
+export declare class EngineNotFoundError extends Error {
+    engineType: string;
+    constructor(engineType: string);
+}
+/**
+ * Template engine registry
+ */
+export declare class TemplateEngineRegistry {
+    private engines;
+    private config;
+    constructor(config?: EngineRegistryConfig);
+    /**
+     * Register default built-in engines
+     */
+    private registerDefaultEngines;
+    /**
+     * Register a template engine
+     */
+    register(type: string, engine: TemplateEngine): void;
+    /**
+     * Get a template engine by type
+     */
+    get(type: string): TemplateEngine;
+    /**
+     * Check if an engine type is registered
+     */
+    has(type: string): boolean;
+    /**
+     * Get all registered engine types
+     */
+    getRegisteredTypes(): string[];
+    /**
+     * Render a template using the appropriate engine
+     */
+    render(template: CodeTemplate, context: TemplateContext, options?: {
+        basePath?: string;
+    }): Promise<string>;
+    /**
+     * Render multiple templates in parallel
+     */
+    renderMany(templates: Array<{
+        template: CodeTemplate;
+        context: TemplateContext;
+    }>): Promise<string[]>;
+    /**
+     * Clear all engine caches
+     */
+    clearCaches(): void;
+    /**
+     * Get statistics about registered engines
+     */
+    getStats(): {
+        registeredEngines: string[];
+        engineStats: Record<string, any>;
+    };
+}
+/**
+ * Create a default template engine registry
+ */
+export declare function createDefaultRegistry(config?: EngineRegistryConfig): TemplateEngineRegistry;
+/**
+ * Get the global template engine registry
+ */
+export declare function getGlobalRegistry(): TemplateEngineRegistry;
+/**
+ * Set the global template engine registry
+ */
+export declare function setGlobalRegistry(registry: TemplateEngineRegistry): void;
+/**
+ * Reset the global registry to null
+ */
+export declare function resetGlobalRegistry(): void;
+//# sourceMappingURL=engine-registry.d.ts.map

package/dist/engines/engine-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-registry.d.ts","sourceRoot":"","sources":["../../src/engines/engine-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,oCAAoC;IACpC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IACzB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAItC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,GAAE,oBAAyB;IAc7C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAa9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAIpD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAQjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,OAAO,CAAC,MAAM,CAAC;IAiBlB;;OAEG;IACG,UAAU,CACd,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,eAAe,CAAA;KAAE,CAAC,GACrE,OAAO,CAAC,MAAM,EAAE,CAAC;IAOpB;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,QAAQ,IAAI;QACV,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC;CAgBF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,sBAAsB,CAE3F;AAOD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,sBAAsB,CAK1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/engines/engine-registry.js

@@ -0,0 +1,163 @@
+/**
+ * Template Engine Registry
+ *
+ * Manages multiple template engines and provides a unified
+ * interface for rendering templates.
+ */
+import { TypeScriptTemplateEngine } from './typescript-engine.js';
+/**
+ * Engine not found error
+ */
+export class EngineNotFoundError extends Error {
+    engineType;
+    constructor(engineType) {
+        super(`Template engine "${engineType}" not found in registry`);
+        this.engineType = engineType;
+        this.name = 'EngineNotFoundError';
+    }
+}
+/**
+ * Template engine registry
+ */
+export class TemplateEngineRegistry {
+    engines = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = config;
+        // Register built-in engines
+        this.registerDefaultEngines();
+        // Register custom engines if provided
+        if (config.customEngines) {
+            for (const [type, engine] of config.customEngines.entries()) {
+                this.register(type, engine);
+            }
+        }
+    }
+    /**
+     * Register default built-in engines
+     */
+    registerDefaultEngines() {
+        // Register TypeScript engine
+        const tsEngine = new TypeScriptTemplateEngine({
+            baseDir: this.config.baseDir,
+            enableCache: this.config.enableCache
+        });
+        this.register('typescript', tsEngine);
+        // Handlebars and AI engines will be registered in future phases
+        // this.register('handlebars', new HandlebarsTemplateEngine(...));
+        // this.register('ai', new AITemplateEngine(...));
+    }
+    /**
+     * Register a template engine
+     */
+    register(type, engine) {
+        this.engines.set(type, engine);
+    }
+    /**
+     * Get a template engine by type
+     */
+    get(type) {
+        const engine = this.engines.get(type);
+        if (!engine) {
+            throw new EngineNotFoundError(type);
+        }
+        return engine;
+    }
+    /**
+     * Check if an engine type is registered
+     */
+    has(type) {
+        return this.engines.has(type);
+    }
+    /**
+     * Get all registered engine types
+     */
+    getRegisteredTypes() {
+        return Array.from(this.engines.keys());
+    }
+    /**
+     * Render a template using the appropriate engine
+     */
+    async render(template, context, options) {
+        const engine = this.get(template.engine);
+        // If basePath is provided and engine is TypeScript, temporarily override baseDir
+        if (options?.basePath && 'baseDir' in engine) {
+            const originalBaseDir = engine.baseDir;
+            engine.baseDir = options.basePath;
+            try {
+                return await engine.render(template, context);
+            }
+            finally {
+                engine.baseDir = originalBaseDir;
+            }
+        }
+        return await engine.render(template, context);
+    }
+    /**
+     * Render multiple templates in parallel
+     */
+    async renderMany(templates) {
+        const promises = templates.map(({ template, context }) => this.render(template, context));
+        return await Promise.all(promises);
+    }
+    /**
+     * Clear all engine caches
+     */
+    clearCaches() {
+        for (const engine of this.engines.values()) {
+            if ('clearCache' in engine && typeof engine.clearCache === 'function') {
+                engine.clearCache();
+            }
+        }
+    }
+    /**
+     * Get statistics about registered engines
+     */
+    getStats() {
+        const engineStats = {};
+        for (const [type, engine] of this.engines.entries()) {
+            if ('getCacheStats' in engine && typeof engine.getCacheStats === 'function') {
+                engineStats[type] = engine.getCacheStats();
+            }
+            else {
+                engineStats[type] = { cached: false };
+            }
+        }
+        return {
+            registeredEngines: this.getRegisteredTypes(),
+            engineStats
+        };
+    }
+}
+/**
+ * Create a default template engine registry
+ */
+export function createDefaultRegistry(config) {
+    return new TemplateEngineRegistry(config);
+}
+/**
+ * Global singleton registry (lazy-initialized)
+ */
+let globalRegistry = null;
+/**
+ * Get the global template engine registry
+ */
+export function getGlobalRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = createDefaultRegistry();
+    }
+    return globalRegistry;
+}
+/**
+ * Set the global template engine registry
+ */
+export function setGlobalRegistry(registry) {
+    globalRegistry = registry;
+}
+/**
+ * Reset the global registry to null
+ */
+export function resetGlobalRegistry() {
+    globalRegistry = null;
+}
+//# sourceMappingURL=engine-registry.js.map

package/dist/engines/engine-registry.js.map

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

package/dist/engines/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SpecVerse Template Engines
+ *
+ * Template engines for generating code from implementation types.
+ */
+export { TypeScriptTemplateEngine, TemplateEngineError, type GeneratorFunction, type ValidatorFunction, type PostProcessorFunction } from './typescript-engine.js';
+export { TemplateEngineRegistry, EngineNotFoundError, createDefaultRegistry, getGlobalRegistry, setGlobalRegistry, resetGlobalRegistry, type EngineRegistryConfig } from './engine-registry.js';
+export { CodeGenerator, createCodeGenerator, type GeneratedOutput, type CodeGenerationOptions } from './code-generator.js';
+export type { TemplateEngine, CodeTemplate, TemplateContext, ValidationResult } from '../types/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC"}

package/dist/engines/index.js

@@ -0,0 +1,12 @@
+/**
+ * SpecVerse Template Engines
+ *
+ * Template engines for generating code from implementation types.
+ */
+// TypeScript template engine
+export { TypeScriptTemplateEngine, TemplateEngineError } from './typescript-engine.js';
+// Engine registry
+export { TemplateEngineRegistry, EngineNotFoundError, createDefaultRegistry, getGlobalRegistry, setGlobalRegistry, resetGlobalRegistry } from './engine-registry.js';
+// Code generator
+export { CodeGenerator, createCodeGenerator } from './code-generator.js';
+//# sourceMappingURL=index.js.map

package/dist/engines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engines/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6BAA6B;AAC7B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EAIpB,MAAM,wBAAwB,CAAC;AAEhC,kBAAkB;AAClB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EAEpB,MAAM,sBAAsB,CAAC;AAE9B,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,mBAAmB,EAGpB,MAAM,qBAAqB,CAAC"}

package/dist/engines/typescript-engine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * TypeScript Template Engine
+ *
+ * Executes TypeScript generator functions to produce code.
+ * This is the primary template engine for Phase 1.
+ */
+import type { TemplateEngine, CodeTemplate, TemplateContext, ValidationResult } from '../types/index.js';
+/**
+ * Generator function signature
+ */
+export type GeneratorFunction = (context: TemplateContext) => string | Promise<string>;
+/**
+ * Validator function signature
+ */
+export type ValidatorFunction = (code: string, context: TemplateContext) => ValidationResult | Promise<ValidationResult>;
+/**
+ * Post-processor function signature
+ */
+export type PostProcessorFunction = (code: string, context: TemplateContext) => string | Promise<string>;
+/**
+ * Template engine error
+ */
+export declare class TemplateEngineError extends Error {
+    templateName?: string | undefined;
+    cause?: Error | undefined;
+    constructor(message: string, templateName?: string | undefined, cause?: Error | undefined);
+}
+/**
+ * TypeScript template engine implementation
+ */
+export declare class TypeScriptTemplateEngine implements TemplateEngine {
+    private generatorCache;
+    private validatorCache;
+    private postProcessorCache;
+    private baseDir;
+    private tsxRegistered;
+    constructor(options?: {
+        baseDir?: string;
+        enableCache?: boolean;
+    });
+    /**
+     * Register tsx to enable TypeScript imports (lazy-loaded)
+     */
+    private ensureTsxRegistered;
+    /**
+     * Render a template with the given context
+     */
+    render(template: CodeTemplate, context: TemplateContext): Promise<string>;
+    /**
+     * Load a generator function from a file path
+     */
+    private loadGenerator;
+    /**
+     * Load a validator function from a file path
+     */
+    private loadValidator;
+    /**
+     * Load a post-processor function from a file path
+     */
+    private loadPostProcessor;
+    /**
+     * Clear all caches
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        generators: number;
+        validators: number;
+        postProcessors: number;
+    };
+}
+//# sourceMappingURL=typescript-engine.d.ts.map

package/dist/engines/typescript-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-engine.d.ts","sourceRoot":"","sources":["../../src/engines/typescript-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,KACrB,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,KACrB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9B;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAGnC,YAAY,CAAC,EAAE,MAAM;IACrB,KAAK,CAAC,EAAE,KAAK;gBAFpB,OAAO,EAAE,MAAM,EACR,YAAY,CAAC,EAAE,MAAM,YAAA,EACrB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,kBAAkB,CAAiD;IAC3E,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAkB;gBAE3B,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO;IAIrE;;OAEG;YACW,mBAAmB;IA0CjC;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IA6D/E;;OAEG;YACW,aAAa;IA0F3B;;OAEG;YACW,aAAa;IAsC3B;;OAEG;YACW,iBAAiB;IAsC/B;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,aAAa,IAAI;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB;CAOF"}

package/dist/engines/typescript-engine.js

@@ -0,0 +1,288 @@
+/**
+ * TypeScript Template Engine
+ *
+ * Executes TypeScript generator functions to produce code.
+ * This is the primary template engine for Phase 1.
+ */
+import { pathToFileURL, fileURLToPath } from 'url';
+import path from 'path';
+import { existsSync } from 'fs';
+/**
+ * Template engine error
+ */
+export class TemplateEngineError extends Error {
+    templateName;
+    cause;
+    constructor(message, templateName, cause) {
+        super(message);
+        this.templateName = templateName;
+        this.cause = cause;
+        this.name = 'TemplateEngineError';
+    }
+}
+/**
+ * TypeScript template engine implementation
+ */
+export class TypeScriptTemplateEngine {
+    generatorCache = new Map();
+    validatorCache = new Map();
+    postProcessorCache = new Map();
+    baseDir;
+    tsxRegistered = false;
+    constructor(options = {}) {
+        this.baseDir = options.baseDir || process.cwd();
+    }
+    /**
+     * Register tsx to enable TypeScript imports (lazy-loaded)
+     */
+    async ensureTsxRegistered() {
+        if (!this.tsxRegistered) {
+            try {
+                // Find tsx — search multiple locations
+                const __filename = fileURLToPath(import.meta.url);
+                const __dirname = path.dirname(__filename);
+                const tsxSubpath = 'tsx/dist/esm/api/index.mjs';
+                const candidates = [
+                    path.resolve(__dirname, '../../..', 'node_modules', tsxSubpath), // Package root
+                    path.resolve(__dirname, '../../../..', 'node_modules', tsxSubpath), // Workspace root
+                    path.resolve(__dirname, '../../../../..', 'node_modules', tsxSubpath), // Parent workspace
+                    path.join(process.cwd(), 'node_modules', tsxSubpath), // CWD
+                ];
+                // Also try global npm location
+                try {
+                    const { execSync } = await import('child_process');
+                    const globalPrefix = execSync('npm prefix -g', { encoding: 'utf8' }).trim();
+                    candidates.push(path.join(globalPrefix, 'lib/node_modules', tsxSubpath));
+                }
+                catch { /* no global npm */ }
+                let tsxPath = null;
+                const { existsSync } = await import('fs');
+                for (const candidate of candidates) {
+                    if (existsSync(candidate)) {
+                        tsxPath = candidate;
+                        break;
+                    }
+                }
+                if (!tsxPath)
+                    throw new Error('tsx not found in any location');
+                const tsx = await import(pathToFileURL(tsxPath).href);
+                // Register tsx with options to allow node_modules processing
+                tsx.register({
+                    namespace: Math.random().toString(),
+                    onImport: () => { }
+                });
+                this.tsxRegistered = true;
+            }
+            catch (error) {
+                // tsx not available, .ts imports will fail
+                console.warn('tsx not available, TypeScript template files may not load');
+            }
+        }
+    }
+    /**
+     * Render a template with the given context
+     */
+    async render(template, context) {
+        // Validate template
+        if (template.engine !== 'typescript') {
+            throw new TemplateEngineError(`TypeScript engine cannot render template with engine type "${template.engine}"`);
+        }
+        if (!template.generator) {
+            throw new TemplateEngineError('TypeScript template requires "generator" path to be specified');
+        }
+        try {
+            // Load and execute generator
+            const generator = await this.loadGenerator(template.generator);
+            let code = await generator(context);
+            // Run validators if specified
+            if (template.validators && template.validators.length > 0) {
+                for (const validatorPath of template.validators) {
+                    const validator = await this.loadValidator(validatorPath);
+                    const result = await validator(code, context);
+                    if (!result.valid) {
+                        throw new TemplateEngineError(`Validation failed:\n${(result.errors || []).map(e => `  - ${e}`).join('\n')}`, template.generator);
+                    }
+                    // Log warnings if any
+                    if (result.warnings && result.warnings.length > 0) {
+                        console.warn(`Validation warnings:\n${result.warnings.map(w => `  - ${w}`).join('\n')}`);
+                    }
+                }
+            }
+            // Run post-processors if specified
+            if (template.postProcessors && template.postProcessors.length > 0) {
+                for (const processorPath of template.postProcessors) {
+                    const processor = await this.loadPostProcessor(processorPath);
+                    code = await processor(code, context);
+                }
+            }
+            return code;
+        }
+        catch (error) {
+            if (error instanceof TemplateEngineError) {
+                throw error;
+            }
+            throw new TemplateEngineError(`Failed to render template: ${error instanceof Error ? error.message : String(error)}`, template.generator, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Load a generator function from a file path
+     */
+    async loadGenerator(generatorPath) {
+        // Check cache
+        if (this.generatorCache.has(generatorPath)) {
+            return this.generatorCache.get(generatorPath);
+        }
+        try {
+            // Resolve path
+            let fullPath = path.isAbsolute(generatorPath)
+                ? generatorPath
+                : path.join(this.baseDir, generatorPath);
+            const DEBUG = process.env.SPECVERSE_DEBUG === 'true';
+            if (DEBUG) {
+                console.log(`[typescript-engine] Loading generator:`);
+                console.log(`  generatorPath: ${generatorPath}`);
+                console.log(`  baseDir: ${this.baseDir}`);
+                console.log(`  fullPath: ${fullPath}`);
+            }
+            let module;
+            // If path is a TypeScript file in libs/, try to load compiled JS from dist/libs/ first
+            if (fullPath.includes('/libs/') && (fullPath.endsWith('.ts') || fullPath.endsWith('.tsx'))) {
+                const jsPath = fullPath.replace('/libs/', '/dist/libs/').replace(/\.tsx?$/, '.js');
+                if (DEBUG)
+                    console.log(`[typescript-engine] Checking for compiled JS: ${jsPath}`);
+                if (existsSync(jsPath)) {
+                    if (DEBUG)
+                        console.log(`[typescript-engine] ✅ Using compiled JS instead of TS`);
+                    fullPath = jsPath;
+                }
+                else {
+                    if (DEBUG)
+                        console.log(`[typescript-engine] ❌ Compiled JS not found, will use TS (may fail in node_modules)`);
+                }
+            }
+            else {
+                if (DEBUG)
+                    console.log(`[typescript-engine] Skipping JS check (not a libs/ TypeScript file)`);
+            }
+            // Try using tsx.tsImport for TypeScript files (bypasses node_modules restriction)
+            if (fullPath.endsWith('.ts') || fullPath.endsWith('.tsx')) {
+                try {
+                    const __filename = fileURLToPath(import.meta.url);
+                    const __dirname = path.dirname(__filename);
+                    const packageRoot = path.resolve(__dirname, '../../..');
+                    const tsxPath = path.join(packageRoot, 'node_modules/tsx/dist/esm/api/index.mjs');
+                    const tsx = await import(pathToFileURL(tsxPath).href);
+                    // Use tsImport to load TypeScript files from node_modules
+                    if (tsx.tsImport) {
+                        module = await tsx.tsImport(fullPath, import.meta.url);
+                    }
+                    else {
+                        // Fallback to regular import for tsx versions without tsImport
+                        await this.ensureTsxRegistered();
+                        const fileUrl = pathToFileURL(fullPath).href;
+                        module = await import(fileUrl);
+                    }
+                }
+                catch (tsxError) {
+                    // If tsx fails, try regular import
+                    await this.ensureTsxRegistered();
+                    const fileUrl = pathToFileURL(fullPath).href;
+                    module = await import(fileUrl);
+                }
+            }
+            else {
+                // Regular JavaScript file
+                const fileUrl = pathToFileURL(fullPath).href;
+                module = await import(fileUrl);
+            }
+            // Get the generator function (default export or named export)
+            const generator = module.default || module.generate || module.generator;
+            if (typeof generator !== 'function') {
+                throw new Error(`Generator module must export a function as default export or named "generate" or "generator"`);
+            }
+            // Cache it
+            this.generatorCache.set(generatorPath, generator);
+            return generator;
+        }
+        catch (error) {
+            throw new TemplateEngineError(`Failed to load generator from "${generatorPath}": ${error instanceof Error ? error.message : String(error)}`, generatorPath, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Load a validator function from a file path
+     */
+    async loadValidator(validatorPath) {
+        // Check cache
+        if (this.validatorCache.has(validatorPath)) {
+            return this.validatorCache.get(validatorPath);
+        }
+        try {
+            // Resolve path
+            const fullPath = path.isAbsolute(validatorPath)
+                ? validatorPath
+                : path.join(this.baseDir, validatorPath);
+            // Import the module
+            const fileUrl = pathToFileURL(fullPath).href;
+            const module = await import(fileUrl);
+            // Get the validator function
+            const validator = module.default || module.validate || module.validator;
+            if (typeof validator !== 'function') {
+                throw new Error(`Validator module must export a function as default export or named "validate" or "validator"`);
+            }
+            // Cache it
+            this.validatorCache.set(validatorPath, validator);
+            return validator;
+        }
+        catch (error) {
+            throw new TemplateEngineError(`Failed to load validator from "${validatorPath}": ${error instanceof Error ? error.message : String(error)}`, validatorPath, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Load a post-processor function from a file path
+     */
+    async loadPostProcessor(processorPath) {
+        // Check cache
+        if (this.postProcessorCache.has(processorPath)) {
+            return this.postProcessorCache.get(processorPath);
+        }
+        try {
+            // Resolve path
+            const fullPath = path.isAbsolute(processorPath)
+                ? processorPath
+                : path.join(this.baseDir, processorPath);
+            // Import the module
+            const fileUrl = pathToFileURL(fullPath).href;
+            const module = await import(fileUrl);
+            // Get the processor function
+            const processor = module.default || module.process || module.postProcess;
+            if (typeof processor !== 'function') {
+                throw new Error(`Post-processor module must export a function as default export or named "process" or "postProcess"`);
+            }
+            // Cache it
+            this.postProcessorCache.set(processorPath, processor);
+            return processor;
+        }
+        catch (error) {
+            throw new TemplateEngineError(`Failed to load post-processor from "${processorPath}": ${error instanceof Error ? error.message : String(error)}`, processorPath, error instanceof Error ? error : undefined);
+        }
+    }
+    /**
+     * Clear all caches
+     */
+    clearCache() {
+        this.generatorCache.clear();
+        this.validatorCache.clear();
+        this.postProcessorCache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            generators: this.generatorCache.size,
+            validators: this.validatorCache.size,
+            postProcessors: this.postProcessorCache.size
+        };
+    }
+}
+//# sourceMappingURL=typescript-engine.js.map