@tronsfey/openapi2cli 1.0.10

package/dist/analyzer/schema-analyzer.js

@@ -0,0 +1,329 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeSchema = analyzeSchema;
+const lodash_1 = __importDefault(require("lodash"));
+const pinyin_pro_1 = require("pinyin-pro");
+const auth_provider_1 = require("../auth/auth-provider");
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/** True if the string contains at least one CJK unified ideograph. */
+const CJK_RE = /[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/;
+/**
+ * Convert CJK characters in a string to their pinyin romanization.
+ * Non-CJK characters are left unchanged. Tone marks are stripped.
+ * e.g. "创建用户" → "chuang jian yong hu"
+ *      "getUserList" → "getUserList"  (no-op)
+ */
+function cjkToLatin(s) {
+    if (!CJK_RE.test(s))
+        return s;
+    return (0, pinyin_pro_1.pinyin)(s, { toneType: 'none', separator: ' ' });
+}
+function analyzeSchema(api, cliName) {
+    const warnings = [];
+    const { groups, flatCommands } = buildGroups(api, warnings);
+    const { authConfig, allAuthSchemes } = (0, auth_provider_1.extractAuthConfig)(api, cliName);
+    const baseUrl = extractBaseUrl(api);
+    return {
+        name: cliName,
+        description: api.info.description ?? `CLI for ${api.info.title}`,
+        version: api.info.version,
+        baseUrl,
+        groups,
+        flatCommands,
+        globalOptions: buildGlobalOptions(),
+        authConfig,
+        allAuthSchemes,
+        warnings,
+    };
+}
+function buildGroups(api, warnings) {
+    const groupMap = new Map();
+    const flatCommands = [];
+    // Seed from top-level tags (preserves defined order and descriptions)
+    for (const tag of api.tags ?? []) {
+        const converted = cjkToLatin(tag.name);
+        if (CJK_RE.test(tag.name)) {
+            const kebab = lodash_1.default.kebabCase(converted);
+            warnings.push(`[WARN] Tag "${tag.name}" 包含CJK字符，已自动转换为拼音: "${kebab}"`);
+        }
+        groupMap.set(tag.name, {
+            name: lodash_1.default.kebabCase(converted),
+            description: tag.description ?? tag.name,
+            subcommands: [],
+        });
+    }
+    // Walk every path and method
+    for (const [pathStr, pathItem] of Object.entries(api.paths ?? {})) {
+        if (!pathItem)
+            continue;
+        const pathLevelParams = (pathItem.parameters ?? []);
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            // x-cli-ignore: true → skip this operation entirely
+            if (operation['x-cli-ignore'] === true)
+                continue;
+            const subcommand = buildSubCommand(method, pathStr, operation, pathLevelParams, warnings);
+            const tags = operation.tags && operation.tags.length > 0 ? operation.tags : [];
+            if (tags.length === 0) {
+                flatCommands.push(subcommand);
+            }
+            else {
+                for (const tag of tags) {
+                    if (!groupMap.has(tag)) {
+                        const converted = cjkToLatin(tag);
+                        if (CJK_RE.test(tag)) {
+                            const kebab = lodash_1.default.kebabCase(converted);
+                            warnings.push(`[WARN] Tag "${tag}" 包含CJK字符，已自动转换为拼音: "${kebab}"`);
+                        }
+                        groupMap.set(tag, {
+                            name: lodash_1.default.kebabCase(converted),
+                            description: tag,
+                            subcommands: [],
+                        });
+                    }
+                    groupMap.get(tag).subcommands.push(subcommand);
+                }
+            }
+        }
+    }
+    const groups = Array.from(groupMap.values()).filter((g) => g.subcommands.length > 0);
+    return { groups, flatCommands };
+}
+function buildSubCommand(method, pathStr, operation, pathLevelParams, warnings) {
+    const name = operationToCommandName(operation, method, pathStr, warnings);
+    const opParams = (operation.parameters ?? []);
+    const mergedParams = mergeParameters(pathLevelParams, opParams);
+    const parameters = mergedParams.map(mapParameter);
+    const requestBody = operation.requestBody
+        ? mapRequestBody(operation.requestBody)
+        : undefined;
+    const options = buildOptions(parameters, requestBody);
+    const responses = buildResponses(operation.responses ?? {});
+    const securitySchemes = (operation.security ?? []).flatMap((s) => Object.keys(s));
+    // x-cli-aliases extension: ["ls", "list"]
+    const xAliases = operation['x-cli-aliases'];
+    const aliases = Array.isArray(xAliases) ? xAliases.map(String) : [];
+    // SSE detection: any 2xx response with text/event-stream content type
+    const streaming = detectStreaming(operation.responses ?? {});
+    return {
+        name,
+        description: operation.summary ?? operation.description ?? `${method.toUpperCase()} ${pathStr}`,
+        method,
+        path: pathStr,
+        parameters,
+        requestBody,
+        responses,
+        options,
+        securitySchemes,
+        aliases,
+        streaming,
+    };
+}
+function operationToCommandName(operation, method, pathStr, warnings) {
+    // x-cli-name extension takes highest priority
+    const xCliName = operation['x-cli-name'];
+    if (typeof xCliName === 'string' && xCliName) {
+        return lodash_1.default.kebabCase(cjkToLatin(xCliName));
+    }
+    if (operation.operationId) {
+        const hasCJK = CJK_RE.test(operation.operationId);
+        const converted = cjkToLatin(operation.operationId);
+        const name = lodash_1.default.kebabCase(converted);
+        if (hasCJK) {
+            warnings.push(`[WARN] operationId "${operation.operationId}" 包含CJK字符，已自动转换为拼音: "${name}"`);
+        }
+        return name;
+    }
+    // No operationId → path segments + method joined with underscores
+    const segments = pathStr
+        .split('/')
+        .filter((s) => s)
+        .map((seg) => {
+        const raw = seg.startsWith('{') && seg.endsWith('}') ? seg.slice(1, -1) : seg;
+        return lodash_1.default.snakeCase(cjkToLatin(raw));
+    });
+    const name = [...segments, method].join('_');
+    warnings.push(`[WARN] ${method.toUpperCase()} ${pathStr} 缺少 operationId，已使用路径+方法自动生成命令名: "${name}"`);
+    return name;
+}
+function mergeParameters(pathLevel, opLevel) {
+    const map = new Map();
+    for (const p of pathLevel)
+        map.set(`${p.in}:${p.name}`, p);
+    for (const p of opLevel)
+        map.set(`${p.in}:${p.name}`, p); // operation wins
+    return Array.from(map.values());
+}
+function mapParameter(p) {
+    const schema = (p.schema ?? {});
+    return {
+        name: p.name,
+        in: p.in,
+        description: p.description ?? p.name,
+        required: p.required ?? false,
+        schema: {
+            type: schema.type ?? 'string',
+            enum: schema.enum,
+            default: schema.default,
+        },
+    };
+}
+function mapRequestBody(rb) {
+    const contentType = Object.keys(rb.content ?? {})[0] ?? 'application/json';
+    const schema = rb.content?.[contentType]?.schema ?? {};
+    const requiredFields = schema.required ?? [];
+    const properties = (schema.properties ?? {});
+    const fields = Object.entries(properties).map(([name, prop]) => ({
+        name,
+        // Commander stores opts as camelCase of the kebab-case flag name
+        optKey: lodash_1.default.camelCase(lodash_1.default.kebabCase(name)),
+        type: prop.type ?? 'string',
+        required: requiredFields.includes(name),
+        description: prop.description ?? name,
+        enum: prop.enum,
+    }));
+    return {
+        description: rb.description ?? 'Request body',
+        required: rb.required ?? false,
+        contentType,
+        schema: schema,
+        fields,
+    };
+}
+/** Returns 'sse' when any 2xx response declares a text/event-stream content type. */
+function detectStreaming(rawResponses) {
+    for (const [code, response] of Object.entries(rawResponses)) {
+        if (!code.startsWith('2'))
+            continue;
+        const r = response;
+        if (r.content && 'text/event-stream' in r.content)
+            return 'sse';
+    }
+    return undefined;
+}
+function buildOptions(parameters, requestBody) {
+    const options = parameters.map((p) => ({
+        name: lodash_1.default.kebabCase(p.name),
+        description: `[${p.in}] (${p.schema.type}) ${p.description}`,
+        required: p.required,
+        type: oasTypeToTS(p.schema.type),
+        defaultValue: p.schema.default,
+        enum: p.schema.enum,
+    }));
+    if (requestBody) {
+        if (requestBody.fields.length > 0) {
+            // Generate one flag per body field for ergonomic UX
+            for (const f of requestBody.fields) {
+                options.push({
+                    name: lodash_1.default.kebabCase(f.name),
+                    description: `[body] (${f.type}) ${f.description}${f.enum ? ` (choices: ${f.enum.join('|')})` : ''}`,
+                    required: f.required && requestBody.required,
+                    type: oasTypeToTS(f.type),
+                    enum: f.enum,
+                });
+            }
+            // Always provide --data as an optional raw-JSON override
+            options.push({
+                name: 'data',
+                description: 'Override entire request body (JSON string or @filename)',
+                required: false,
+                type: 'string',
+            });
+        }
+        else {
+            // No schema fields known — fall back to raw --data
+            options.push({
+                name: 'data',
+                description: `${requestBody.description} (JSON string or @filename)`,
+                required: requestBody.required,
+                type: 'string',
+            });
+        }
+    }
+    return options;
+}
+function oasTypeToTS(oasType) {
+    if (oasType === 'integer' || oasType === 'number')
+        return 'number';
+    if (oasType === 'boolean')
+        return 'boolean';
+    return 'string';
+}
+function buildResponses(rawResponses) {
+    const result = {};
+    for (const [code, response] of Object.entries(rawResponses)) {
+        const r = response;
+        const contentType = r.content ? Object.keys(r.content)[0] : undefined;
+        let fields = [];
+        if (contentType) {
+            const schema = r.content?.[contentType]?.schema;
+            if (schema) {
+                const target = schema.type === 'array' ? (schema.items ?? {}) : schema;
+                const properties = (target.properties ?? {});
+                fields = Object.entries(properties).map(([name, prop]) => ({
+                    name,
+                    type: prop.type ?? 'string',
+                    description: prop.description ?? name,
+                }));
+            }
+        }
+        result[code] = {
+            statusCode: code,
+            description: r.description,
+            contentType,
+            fields,
+            isArray: contentType
+                ? r.content?.[contentType]?.schema?.type === 'array'
+                : false,
+        };
+    }
+    return result;
+}
+function extractBaseUrl(api) {
+    const server = api.servers?.[0];
+    if (!server)
+        return 'http://localhost';
+    return server.url;
+}
+function buildGlobalOptions() {
+    return [
+        {
+            name: 'endpoint',
+            description: 'Override the base API URL',
+            required: false,
+            type: 'string',
+        },
+        {
+            name: 'format',
+            description: 'Output format',
+            required: false,
+            type: 'string',
+            defaultValue: 'json',
+            enum: ['json', 'yaml', 'table'],
+        },
+        {
+            name: 'query',
+            description: 'JMESPath expression to filter the response',
+            required: false,
+            type: 'string',
+        },
+        {
+            name: 'all-pages',
+            description: 'Auto-follow Link rel="next" headers to collect all pages',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            name: 'verbose',
+            description: 'Enable verbose request/response logging',
+            required: false,
+            type: 'boolean',
+        },
+    ];
+}
+//# sourceMappingURL=schema-analyzer.js.map

package/dist/analyzer/schema-analyzer.js.map

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

package/dist/auth/auth-provider.d.ts

@@ -0,0 +1,22 @@
+import { OpenAPIV3 } from 'openapi-types';
+import { AuthConfig } from '../types/index';
+/**
+ * Inspects the securitySchemes block and returns the primary auth configuration.
+ *
+ * Precedence (first match wins):
+ *   bearer with x-cli-token-url  → dynamic (custom token provider)
+ *   oauth2 clientCredentials      → oauth2-cc
+ *   bearer                        → bearer
+ *   apiKey                        → apiKey
+ *   basic                         → basic
+ *   oauth2 (other flows)          → bearer (treat access token as bearer)
+ *   none                          → none
+ *
+ * All env var names are prefixed with the CLI name in SCREAMING_SNAKE_CASE so
+ * multiple generated CLIs can coexist in the same shell environment.
+ */
+export declare function extractAuthConfig(api: OpenAPIV3.Document, cliName: string): {
+    authConfig: AuthConfig;
+    allAuthSchemes: string[];
+};
+//# sourceMappingURL=auth-provider.d.ts.map

package/dist/auth/auth-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-provider.d.ts","sourceRoot":"","sources":["../../src/auth/auth-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAe,MAAM,gBAAgB,CAAC;AAWzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,SAAS,CAAC,QAAQ,EACvB,OAAO,EAAE,MAAM,GACd;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAqFtD"}

package/dist/auth/auth-provider.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAuthConfig = extractAuthConfig;
+const lodash_1 = __importDefault(require("lodash"));
+/**
+ * Derives an environment variable name from the CLI name and a suffix.
+ * e.g.  cliName="my-service" + suffix="TOKEN"  → "MY_SERVICE_TOKEN"
+ *       cliName="petstore-v2" + suffix="API_KEY" → "PETSTORE_V2_API_KEY"
+ */
+function makeEnvVar(cliName, suffix) {
+    return `${lodash_1.default.snakeCase(cliName).toUpperCase()}_${suffix}`;
+}
+/**
+ * Inspects the securitySchemes block and returns the primary auth configuration.
+ *
+ * Precedence (first match wins):
+ *   bearer with x-cli-token-url  → dynamic (custom token provider)
+ *   oauth2 clientCredentials      → oauth2-cc
+ *   bearer                        → bearer
+ *   apiKey                        → apiKey
+ *   basic                         → basic
+ *   oauth2 (other flows)          → bearer (treat access token as bearer)
+ *   none                          → none
+ *
+ * All env var names are prefixed with the CLI name in SCREAMING_SNAKE_CASE so
+ * multiple generated CLIs can coexist in the same shell environment.
+ */
+function extractAuthConfig(api, cliName) {
+    const schemes = (api.components?.securitySchemes ?? {});
+    const allAuthSchemes = Object.keys(schemes);
+    let authConfig = { type: 'none', envVar: '' };
+    for (const scheme of Object.values(schemes)) {
+        const ext = scheme;
+        // ── dynamic (bearer + x-cli-token-url extension) ─────────────────────────
+        if (scheme.type === 'http' &&
+            scheme.scheme === 'bearer' &&
+            typeof ext['x-cli-token-url'] === 'string') {
+            const rawEnvVars = ext['x-cli-token-env-vars'];
+            const tokenEnvVars = Array.isArray(rawEnvVars)
+                ? rawEnvVars.map((v) => ({
+                    name: String(v.name),
+                    env: String(v.env),
+                }))
+                : [];
+            authConfig = {
+                type: 'dynamic',
+                envVar: '',
+                tokenUrl: ext['x-cli-token-url'],
+                tokenEnvVars,
+            };
+            break;
+        }
+        // ── oauth2 client credentials ─────────────────────────────────────────────
+        if (scheme.type === 'oauth2') {
+            const oauth2 = scheme;
+            const ccFlow = oauth2.flows.clientCredentials;
+            if (ccFlow) {
+                authConfig = {
+                    type: 'oauth2-cc',
+                    envVar: '',
+                    tokenUrl: ccFlow.tokenUrl,
+                    clientIdEnvVar: makeEnvVar(cliName, 'CLIENT_ID'),
+                    clientSecretEnvVar: makeEnvVar(cliName, 'CLIENT_SECRET'),
+                    scopesEnvVar: makeEnvVar(cliName, 'SCOPES'),
+                };
+                break;
+            }
+            // Other OAuth2 flows — treat resulting access token as bearer
+            authConfig = { type: 'bearer', envVar: makeEnvVar(cliName, 'TOKEN') };
+            break;
+        }
+        // ── bearer ────────────────────────────────────────────────────────────────
+        if (scheme.type === 'http' &&
+            scheme.scheme === 'bearer') {
+            authConfig = { type: 'bearer', envVar: makeEnvVar(cliName, 'TOKEN') };
+            break;
+        }
+        // ── apiKey ────────────────────────────────────────────────────────────────
+        if (scheme.type === 'apiKey') {
+            const ks = scheme;
+            authConfig = {
+                type: 'apiKey',
+                headerName: ks.name,
+                envVar: makeEnvVar(cliName, 'API_KEY'),
+            };
+            break;
+        }
+        // ── basic ─────────────────────────────────────────────────────────────────
+        if (scheme.type === 'http' &&
+            scheme.scheme === 'basic') {
+            authConfig = { type: 'basic', envVar: makeEnvVar(cliName, 'CREDENTIALS') };
+            break;
+        }
+    }
+    return { authConfig, allAuthSchemes };
+}
+//# sourceMappingURL=auth-provider.js.map

package/dist/auth/auth-provider.js.map

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

package/dist/generator/command-generator.d.ts

@@ -0,0 +1,3 @@
+import { CommandStructure, GeneratedFile } from '../types/index';
+export declare function generateProject(structure: CommandStructure): Promise<GeneratedFile[]>;
+//# sourceMappingURL=command-generator.d.ts.map

package/dist/generator/command-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-generator.d.ts","sourceRoot":"","sources":["../../src/generator/command-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGjE,wBAAsB,eAAe,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkE3F"}

package/dist/generator/command-generator.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateProject = generateProject;
+const path = __importStar(require("path"));
+const template_engine_1 = require("./template-engine");
+async function generateProject(structure) {
+    const files = [];
+    // 1. package.json for the generated CLI
+    files.push({
+        relativePath: 'package.json',
+        content: await (0, template_engine_1.renderTemplate)('package.json.hbs', { structure }),
+    });
+    // 2. tsconfig.json
+    files.push({
+        relativePath: 'tsconfig.json',
+        content: await (0, template_engine_1.renderTemplate)('tsconfig.json.hbs', { structure }),
+    });
+    // 3. Main entry: src/index.ts
+    files.push({
+        relativePath: path.join('src', 'index.ts'),
+        content: await (0, template_engine_1.renderTemplate)('index.ts.hbs', { structure }),
+    });
+    // 4. One command file per group: src/commands/<group-name>.ts
+    for (const group of structure.groups) {
+        files.push({
+            relativePath: path.join('src', 'commands', `${group.name}.ts`),
+            content: await (0, template_engine_1.renderTemplate)('command.ts.hbs', { structure, group }),
+        });
+    }
+    // 4b. Flat commands (untagged operations): src/flat-commands.ts
+    if (structure.flatCommands.length > 0) {
+        files.push({
+            relativePath: path.join('src', 'flat-commands.ts'),
+            content: await (0, template_engine_1.renderTemplate)('flat-commands.ts.hbs', { structure, flatCommands: structure.flatCommands }),
+        });
+    }
+    // 5. Shared API client: src/lib/api-client.ts
+    files.push({
+        relativePath: path.join('src', 'lib', 'api-client.ts'),
+        content: await (0, template_engine_1.renderTemplate)('api-client.ts.hbs', { structure }),
+    });
+    // 6. README (English default + Chinese)
+    files.push({
+        relativePath: 'README.md',
+        content: await (0, template_engine_1.renderTemplate)('README.md.hbs', { structure }),
+    });
+    files.push({
+        relativePath: 'README.zh.md',
+        content: await (0, template_engine_1.renderTemplate)('README.zh.md.hbs', { structure }),
+    });
+    // 7. SKILL.md — Claude Code skill descriptor
+    files.push({
+        relativePath: 'SKILL.md',
+        content: await (0, template_engine_1.renderTemplate)('SKILL.md.hbs', { structure }),
+    });
+    // 8. bin shebang wrapper
+    files.push({
+        relativePath: path.join('bin', structure.name),
+        content: `#!/usr/bin/env node\nrequire('../dist/index.js');\n`,
+    });
+    return files;
+}
+//# sourceMappingURL=command-generator.js.map

package/dist/generator/command-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-generator.js","sourceRoot":"","sources":["../../src/generator/command-generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,0CAkEC;AAtED,2CAA6B;AAE7B,uDAAmD;AAE5C,KAAK,UAAU,eAAe,CAAC,SAA2B;IAC/D,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,wCAAwC;IACxC,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,cAAc;QAC5B,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,eAAe;QAC7B,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,CAAC;KAClE,CAAC,CAAC;IAEH,8BAA8B;IAC9B,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC;QAC1C,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,cAAc,EAAE,EAAE,SAAS,EAAE,CAAC;KAC7D,CAAC,CAAC;IAEH,8DAA8D;IAC9D,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC;YACT,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,CAAC;YAC9D,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC;YACT,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,kBAAkB,CAAC;YAClD,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC;SAC3G,CAAC,CAAC;IACL,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC;QACtD,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,CAAC;KAClE,CAAC,CAAC;IAEH,wCAAwC;IACxC,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,WAAW;QACzB,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,eAAe,EAAE,EAAE,SAAS,EAAE,CAAC;KAC9D,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,cAAc;QAC5B,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,6CAA6C;IAC7C,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,UAAU;QACxB,OAAO,EAAE,MAAM,IAAA,gCAAc,EAAC,cAAc,EAAE,EAAE,SAAS,EAAE,CAAC;KAC7D,CAAC,CAAC;IAEH,yBAAyB;IACzB,KAAK,CAAC,IAAI,CAAC;QACT,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC;QAC9C,OAAO,EAAE,qDAAqD;KAC/D,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/generator/template-engine.d.ts

@@ -0,0 +1,2 @@
+export declare function renderTemplate(templateName: string, context: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=template-engine.d.ts.map

package/dist/generator/template-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/generator/template-engine.ts"],"names":[],"mappings":"AAYA,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CAKjB"}