context-mapper-mcp 1.0.1 → 1.1.0

package/dist/generators/cli/executor.d.ts

@@ -0,0 +1,95 @@
+/**
+ * CLI Executor
+ * Handles Java detection and CLI process execution
+ */
+/**
+ * Java version info
+ */
+export interface JavaInfo {
+    available: boolean;
+    version?: string;
+    majorVersion?: number;
+    compatible?: boolean;
+    path?: string;
+    error?: string;
+}
+/**
+ * CLI execution result
+ */
+export interface CLIExecutionResult {
+    success: boolean;
+    exitCode?: number;
+    stdout: string;
+    stderr: string;
+    error?: string;
+    timedOut?: boolean;
+}
+/**
+ * CLI command options
+ */
+export interface CLICommandOptions {
+    /** Working directory */
+    cwd?: string;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Environment variables to add */
+    env?: Record<string, string>;
+}
+/**
+ * Check Java availability and version
+ */
+export declare function checkJava(): Promise<JavaInfo>;
+/**
+ * CLI Executor class
+ */
+export declare class CLIExecutor {
+    private cliPath;
+    /**
+     * Ensure CLI is available, downloading if necessary
+     */
+    ensureCLI(): Promise<string>;
+    /**
+     * Execute a CLI command
+     * @param args Command arguments (without the CLI path)
+     * @param options Execution options
+     */
+    execute(args: string[], options?: CLICommandOptions): Promise<CLIExecutionResult>;
+    /**
+     * Generate artifacts using the CLI
+     * @param inputPath Path to the CML file
+     * @param generatorName Name of the generator (e.g., 'context-map', 'mdsl', 'generic')
+     * @param outputDir Output directory
+     * @param extraArgs Additional arguments
+     */
+    generate(inputPath: string, generatorName: string, outputDir: string, extraArgs?: string[], options?: CLICommandOptions): Promise<CLIExecutionResult>;
+    /**
+     * Get CLI version
+     */
+    getVersion(): Promise<string | null>;
+    /**
+     * Validate a CML file using the CLI
+     */
+    validate(inputPath: string): Promise<CLIExecutionResult>;
+}
+/**
+ * Get the CLI executor instance
+ */
+export declare function getCLIExecutor(): CLIExecutor;
+/**
+ * Full CLI status check
+ */
+export interface CLIStatus {
+    javaAvailable: boolean;
+    javaVersion?: string;
+    javaCompatible: boolean;
+    cliInstalled: boolean;
+    cliVersion?: string;
+    cliPath?: string;
+    ready: boolean;
+    issues: string[];
+}
+/**
+ * Get comprehensive CLI status
+ */
+export declare function getCLIStatus(): Promise<CLIStatus>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/generators/cli/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/generators/cli/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAcD;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,CAwEnD;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAuB;IAEtC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAWlC;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsG3F;;;;;;OAMG;IACG,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,EAAO,EACxB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,kBAAkB,CAAC;IAY9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU1C;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAG/D;AAKD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAiCvD"}

package/dist/generators/cli/executor.js

@@ -0,0 +1,277 @@
+/**
+ * CLI Executor
+ * Handles Java detection and CLI process execution
+ */
+import { spawn } from 'child_process';
+import { stat } from 'fs/promises';
+import { getCLIConfig, getJavaExecutablePath, MIN_JAVA_VERSION, DEFAULT_CLI_TIMEOUT, isWindows, } from './config.js';
+import { getCLIManager } from './manager.js';
+/**
+ * Check if a file exists
+ */
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check Java availability and version
+ */
+export async function checkJava() {
+    const javaPath = getJavaExecutablePath();
+    return new Promise((resolve) => {
+        const process = spawn(javaPath, ['-version'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        process.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        process.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        process.on('error', (error) => {
+            resolve({
+                available: false,
+                error: `Java not found: ${error.message}`,
+            });
+        });
+        process.on('close', (code) => {
+            if (code !== 0) {
+                resolve({
+                    available: false,
+                    error: `Java version check failed with code ${code}`,
+                });
+                return;
+            }
+            // Java outputs version to stderr
+            const output = stderr || stdout;
+            // Parse version from output like:
+            // java version "17.0.1" or openjdk version "17.0.1"
+            const versionMatch = output.match(/version "(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+            if (!versionMatch) {
+                resolve({
+                    available: true,
+                    path: javaPath,
+                    error: 'Could not parse Java version',
+                });
+                return;
+            }
+            const majorVersion = parseInt(versionMatch[1], 10);
+            const version = versionMatch[0].replace('version ', '').replace(/"/g, '');
+            resolve({
+                available: true,
+                version,
+                majorVersion,
+                compatible: majorVersion >= MIN_JAVA_VERSION,
+                path: javaPath,
+            });
+        });
+        // Timeout for Java check
+        setTimeout(() => {
+            process.kill();
+            resolve({
+                available: false,
+                error: 'Java version check timed out',
+            });
+        }, 10000);
+    });
+}
+/**
+ * CLI Executor class
+ */
+export class CLIExecutor {
+    cliPath = null;
+    /**
+     * Ensure CLI is available, downloading if necessary
+     */
+    async ensureCLI() {
+        if (this.cliPath && await exists(this.cliPath)) {
+            return this.cliPath;
+        }
+        const manager = getCLIManager();
+        const { path } = await manager.ensureCLI();
+        this.cliPath = path;
+        return path;
+    }
+    /**
+     * Execute a CLI command
+     * @param args Command arguments (without the CLI path)
+     * @param options Execution options
+     */
+    async execute(args, options = {}) {
+        const config = getCLIConfig();
+        const timeout = options.timeout ?? config.timeout ?? DEFAULT_CLI_TIMEOUT;
+        const cwd = options.cwd ?? process.cwd();
+        // Ensure CLI is available
+        let cliPath;
+        try {
+            cliPath = await this.ensureCLI();
+        }
+        catch (error) {
+            return {
+                success: false,
+                stdout: '',
+                stderr: '',
+                error: error instanceof Error ? error.message : 'Failed to ensure CLI availability',
+            };
+        }
+        // Build environment
+        const env = {
+            ...process.env,
+            ...options.env,
+        };
+        // Add JAVA_HOME if configured
+        if (config.javaHome) {
+            env.JAVA_HOME = config.javaHome;
+        }
+        return new Promise((resolve) => {
+            let timedOut = false;
+            // On Windows, use cmd.exe to run batch file
+            const spawnCommand = isWindows() ? 'cmd.exe' : cliPath;
+            const spawnArgs = isWindows() ? ['/c', cliPath, ...args] : args;
+            const proc = spawn(spawnCommand, spawnArgs, {
+                cwd,
+                env,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            proc.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('error', (error) => {
+                resolve({
+                    success: false,
+                    stdout,
+                    stderr,
+                    error: `Process error: ${error.message}`,
+                });
+            });
+            proc.on('close', (code) => {
+                if (timedOut) {
+                    resolve({
+                        success: false,
+                        exitCode: code ?? undefined,
+                        stdout,
+                        stderr,
+                        error: `Command timed out after ${timeout}ms`,
+                        timedOut: true,
+                    });
+                }
+                else {
+                    resolve({
+                        success: code === 0,
+                        exitCode: code ?? undefined,
+                        stdout,
+                        stderr,
+                        error: code !== 0 ? `Command exited with code ${code}` : undefined,
+                    });
+                }
+            });
+            // Set timeout
+            const timeoutId = setTimeout(() => {
+                timedOut = true;
+                proc.kill('SIGTERM');
+                // Force kill after 5 seconds if still running
+                setTimeout(() => {
+                    if (!proc.killed) {
+                        proc.kill('SIGKILL');
+                    }
+                }, 5000);
+            }, timeout);
+            // Clear timeout on process end
+            proc.on('close', () => {
+                clearTimeout(timeoutId);
+            });
+        });
+    }
+    /**
+     * Generate artifacts using the CLI
+     * @param inputPath Path to the CML file
+     * @param generatorName Name of the generator (e.g., 'context-map', 'mdsl', 'generic')
+     * @param outputDir Output directory
+     * @param extraArgs Additional arguments
+     */
+    async generate(inputPath, generatorName, outputDir, extraArgs = [], options = {}) {
+        const args = [
+            'generate',
+            '-i', inputPath,
+            '-g', generatorName,
+            '-o', outputDir,
+            ...extraArgs,
+        ];
+        return this.execute(args, options);
+    }
+    /**
+     * Get CLI version
+     */
+    async getVersion() {
+        const result = await this.execute(['--version']);
+        if (result.success) {
+            // Parse version from output
+            const versionMatch = result.stdout.match(/(\d+\.\d+\.\d+)/);
+            return versionMatch ? versionMatch[1] : null;
+        }
+        return null;
+    }
+    /**
+     * Validate a CML file using the CLI
+     */
+    async validate(inputPath) {
+        return this.execute(['validate', '-i', inputPath]);
+    }
+}
+// Singleton instance
+let executorInstance = null;
+/**
+ * Get the CLI executor instance
+ */
+export function getCLIExecutor() {
+    if (!executorInstance) {
+        executorInstance = new CLIExecutor();
+    }
+    return executorInstance;
+}
+/**
+ * Get comprehensive CLI status
+ */
+export async function getCLIStatus() {
+    const issues = [];
+    const javaInfo = await checkJava();
+    const manager = getCLIManager();
+    const cliVerify = await manager.verify();
+    // Check Java
+    const javaAvailable = javaInfo.available;
+    const javaCompatible = javaInfo.compatible ?? false;
+    if (!javaAvailable) {
+        issues.push('Java runtime not found. Install JDK 17+ from https://adoptium.net');
+    }
+    else if (!javaCompatible) {
+        issues.push(`Java ${MIN_JAVA_VERSION}+ required, found ${javaInfo.version}`);
+    }
+    // Check CLI
+    const cliInstalled = cliVerify.installed;
+    if (!cliInstalled) {
+        issues.push('CLI not installed. Run cml_download_cli to install.');
+    }
+    return {
+        javaAvailable,
+        javaVersion: javaInfo.version,
+        javaCompatible,
+        cliInstalled,
+        cliVersion: cliVerify.version,
+        cliPath: cliVerify.path,
+        ready: javaAvailable && javaCompatible && cliInstalled,
+        issues,
+    };
+}
+//# sourceMappingURL=executor.js.map

package/dist/generators/cli/executor.js.map

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

package/dist/generators/cli/generic.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Generic Freemarker CLI Generator
+ * Generates outputs from Freemarker templates using the Context Mapper CLI
+ */
+import type { CMLModel } from '../../model/types.js';
+import type { IGenerator, GeneratorResult, GeneratorOptions, GenericGeneratorOptions } from '../interfaces.js';
+/**
+ * Generic Freemarker Generator
+ * Uses CLI to generate outputs from custom Freemarker templates
+ */
+export declare class GenericFreemarkerGenerator implements IGenerator {
+    name: string;
+    description: string;
+    requiresCLI: boolean;
+    outputFormats: string[];
+    generate(model: CMLModel, options?: GenericGeneratorOptions): Promise<GeneratorResult>;
+    /**
+     * Find generated files in the output directory
+     * Uses the template name to infer expected output extension
+     */
+    private findGeneratedFiles;
+    /**
+     * Get expected output extension from template filename
+     * Templates are named like "Name.ext.ftl" where ext is the output extension
+     */
+    private getExpectedExtension;
+    /**
+     * Get format string from file extension
+     */
+    private getFormatFromExtension;
+}
+/**
+ * Bundled Template Generator
+ * Pre-configured generator for bundled templates
+ */
+export declare class BundledTemplateGenerator implements IGenerator {
+    name: string;
+    description: string;
+    requiresCLI: boolean;
+    outputFormats: string[];
+    private templateName;
+    private genericGenerator;
+    constructor(name: string, description: string, templateName: string, outputFormat: string);
+    generate(model: CMLModel, options?: GeneratorOptions): Promise<GeneratorResult>;
+}
+/**
+ * Create the Generic Freemarker generator
+ */
+export declare function createGenericFreemarkerGenerator(): IGenerator;
+/**
+ * Create generators for bundled templates
+ */
+export declare function createBundledTemplateGenerators(): IGenerator[];
+//# sourceMappingURL=generic.d.ts.map

package/dist/generators/cli/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../../src/generators/cli/generic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EAExB,MAAM,kBAAkB,CAAC;AA2B1B;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,UAAU;IAC3D,IAAI,SAAwB;IAC5B,WAAW,SAAuD;IAClE,WAAW,UAAQ;IACnB,aAAa,WAAS;IAEhB,QAAQ,CACZ,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,eAAe,CAAC;IAmH3B;;;OAGG;YACW,kBAAkB;IAkChC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAoB/B;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,UAAU;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,UAAQ;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAA6B;gBAGnD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM;IAShB,QAAQ,CACZ,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC;CA0B5B;AAED;;GAEG;AACH,wBAAgB,gCAAgC,IAAI,UAAU,CAE7D;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,UAAU,EAAE,CA2B9D"}

package/dist/generators/cli/generic.js

@@ -0,0 +1,224 @@
+/**
+ * Generic Freemarker CLI Generator
+ * Generates outputs from Freemarker templates using the Context Mapper CLI
+ */
+import { readdir, readFile, stat, access } from 'fs/promises';
+import { join, basename, extname } from 'path';
+import { constants } from 'fs';
+import { createSuccessResult, createErrorResult, cliNotFoundError, javaNotFoundError, javaVersionError, executionTimeoutError, templateNotFoundError, } from '../interfaces.js';
+import { serializeCML } from '../../model/writer.js';
+import { withTempFiles } from '../../utils/temp-files.js';
+import { getCLIExecutor, getCLIStatus } from './executor.js';
+import { getCLIConfig, getBundledTemplate } from './config.js';
+/**
+ * Check if a file exists and is accessible
+ */
+async function fileExists(path) {
+    try {
+        await access(path, constants.R_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Generic Freemarker Generator
+ * Uses CLI to generate outputs from custom Freemarker templates
+ */
+export class GenericFreemarkerGenerator {
+    name = 'generic-freemarker';
+    description = 'Generate outputs from custom Freemarker templates';
+    requiresCLI = true;
+    outputFormats = ['*']; // Depends on template
+    async generate(model, options) {
+        if (!options?.templatePath) {
+            return createErrorResult('TEMPLATE_NOT_FOUND', 'templatePath is required', 'Provide the path to a Freemarker (.ftl) template file');
+        }
+        // Check if template exists
+        if (!(await fileExists(options.templatePath))) {
+            return templateNotFoundError(options.templatePath);
+        }
+        // Check prerequisites
+        const status = await getCLIStatus();
+        if (!status.javaAvailable) {
+            return javaNotFoundError();
+        }
+        if (!status.javaCompatible) {
+            return javaVersionError(status.javaVersion || 'unknown');
+        }
+        if (!status.cliInstalled) {
+            return cliNotFoundError();
+        }
+        // Use temp files with automatic cleanup
+        return withTempFiles(async (tempContext) => {
+            try {
+                // Serialize model to CML
+                const cmlContent = serializeCML(model);
+                const tempDir = await tempContext.createDir();
+                const cmlPath = await tempContext.createCMLFile(cmlContent, tempDir);
+                // Determine output directory
+                const config = getCLIConfig();
+                const outputDir = options?.outputDir ?? config.outputDir;
+                // Build extra arguments
+                const extraArgs = [
+                    '-t', options.templatePath,
+                ];
+                // Optional output file name
+                if (options.outputFileName) {
+                    extraArgs.push('-f', options.outputFileName);
+                }
+                // Execute CLI
+                const executor = getCLIExecutor();
+                const result = await executor.generate(cmlPath, 'generic', outputDir, extraArgs, { timeout: options?.timeout });
+                if (result.timedOut) {
+                    return executionTimeoutError(options?.timeout ?? config.timeout);
+                }
+                if (!result.success) {
+                    return createErrorResult('EXECUTION_FAILED', result.error || 'CLI execution failed', 'Check the template syntax and CML model for errors', result.stderr);
+                }
+                // Find generated files
+                const generatedFiles = await this.findGeneratedFiles(outputDir, options.templatePath);
+                if (generatedFiles.length === 0) {
+                    return createErrorResult('OUTPUT_NOT_FOUND', 'No output files were generated', 'Check the template for errors or ensure the model has content to process');
+                }
+                // Read file contents for output
+                const outputs = await Promise.all(generatedFiles.map(async (filePath) => {
+                    const content = await readFile(filePath, 'utf-8');
+                    const format = this.getFormatFromExtension(filePath);
+                    return {
+                        type: 'file',
+                        path: filePath,
+                        content,
+                        format,
+                        description: `Generated from template: ${basename(filePath)}`,
+                    };
+                }));
+                // Include any warnings from stderr
+                const warnings = result.stderr
+                    ? result.stderr.split('\n').filter((line) => line.trim().length > 0)
+                    : undefined;
+                return createSuccessResult(outputs, warnings);
+            }
+            catch (error) {
+                return createErrorResult('INTERNAL_ERROR', error instanceof Error ? error.message : 'Unknown error during generation');
+            }
+        });
+    }
+    /**
+     * Find generated files in the output directory
+     * Uses the template name to infer expected output extension
+     */
+    async findGeneratedFiles(outputDir, templatePath) {
+        const files = [];
+        // Get expected extension from template name (e.g., "GlossaryTemplate.md.ftl" -> ".md")
+        const templateBase = basename(templatePath);
+        const expectedExt = this.getExpectedExtension(templateBase);
+        try {
+            const entries = await readdir(outputDir);
+            for (const entry of entries) {
+                // Match files with expected extension or any recently created files
+                const entryPath = join(outputDir, entry);
+                const entryStat = await stat(entryPath);
+                if (entryStat.isFile()) {
+                    if (expectedExt && entry.endsWith(expectedExt)) {
+                        files.push(entryPath);
+                    }
+                    else if (!expectedExt && !entry.endsWith('.cml')) {
+                        // If we can't determine extension, include non-CML files
+                        files.push(entryPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory may not exist
+        }
+        return files;
+    }
+    /**
+     * Get expected output extension from template filename
+     * Templates are named like "Name.ext.ftl" where ext is the output extension
+     */
+    getExpectedExtension(templateName) {
+        // Remove .ftl extension
+        const withoutFtl = templateName.replace(/\.ftl$/i, '');
+        const ext = extname(withoutFtl);
+        return ext || null;
+    }
+    /**
+     * Get format string from file extension
+     */
+    getFormatFromExtension(filePath) {
+        const ext = extname(filePath).toLowerCase();
+        switch (ext) {
+            case '.md':
+                return 'markdown';
+            case '.jdl':
+                return 'jdl';
+            case '.json':
+                return 'json';
+            case '.yaml':
+            case '.yml':
+                return 'yaml';
+            case '.xml':
+                return 'xml';
+            case '.html':
+                return 'html';
+            default:
+                return ext.replace('.', '') || 'text';
+        }
+    }
+}
+/**
+ * Bundled Template Generator
+ * Pre-configured generator for bundled templates
+ */
+export class BundledTemplateGenerator {
+    name;
+    description;
+    requiresCLI = true;
+    outputFormats;
+    templateName;
+    genericGenerator;
+    constructor(name, description, templateName, outputFormat) {
+        this.name = name;
+        this.description = description;
+        this.templateName = templateName;
+        this.outputFormats = [outputFormat];
+        this.genericGenerator = new GenericFreemarkerGenerator();
+    }
+    async generate(model, options) {
+        const templateInfo = getBundledTemplate(this.templateName);
+        if (!templateInfo) {
+            return createErrorResult('TEMPLATE_NOT_FOUND', `Bundled template '${this.templateName}' not found`, 'This is an internal error - the bundled templates may not be installed correctly');
+        }
+        // Check if template file exists
+        if (!(await fileExists(templateInfo.path))) {
+            return createErrorResult('TEMPLATE_NOT_FOUND', `Bundled template file not found: ${templateInfo.path}`, 'Reinstall the package to restore bundled templates');
+        }
+        // Use the generic generator with the bundled template
+        return this.genericGenerator.generate(model, {
+            ...options,
+            templatePath: templateInfo.path,
+        });
+    }
+}
+/**
+ * Create the Generic Freemarker generator
+ */
+export function createGenericFreemarkerGenerator() {
+    return new GenericFreemarkerGenerator();
+}
+/**
+ * Create generators for bundled templates
+ */
+export function createBundledTemplateGenerators() {
+    return [
+        new BundledTemplateGenerator('glossary', 'Generate ubiquitous language glossary from domain model', 'glossary', 'markdown'),
+        new BundledTemplateGenerator('jhipster-microservices', 'Generate JHipster JDL for microservices architecture', 'jhipster-microservices', 'jdl'),
+        new BundledTemplateGenerator('jhipster-monolith', 'Generate JHipster JDL for monolithic application', 'jhipster-monolith', 'jdl'),
+        new BundledTemplateGenerator('full-report', 'Generate comprehensive domain documentation', 'full-report', 'markdown'),
+    ];
+}
+//# sourceMappingURL=generic.js.map