@kattebak/openapi-generator-ts 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kattebak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,189 @@
+# @kattebak/openapi-generator-ts
+
+A TypeScript port of the excellent [OpenAPI Generator](https://openapi-generator.tech/) project.
+
+## Acknowledgments
+
+This project stands on the shoulders of giants. The original [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator) is a remarkable open-source project that has generated API clients, server stubs, and documentation for countless developers worldwide. We are deeply grateful to the OpenAPI Generator community for their years of work building and maintaining such a comprehensive and well-designed tool.
+
+## Motivation
+
+While the original OpenAPI Generator is feature-complete and battle-tested, it requires a Java Virtual Machine (JVM) to run. This can be inconvenient in certain scenarios:
+
+- **CI/CD pipelines** where adding a JVM dependency increases container image sizes and build times
+- **Node.js-only environments** where maintaining a Java installation adds operational complexity
+- **Quick local generation** where startup time matters
+
+This TypeScript port provides a native Node.js alternative that:
+
+- Eliminates the JVM dependency entirely
+- Offers faster startup times for small to medium specs
+- Integrates seamlessly into JavaScript/TypeScript toolchains
+- Uses the same Mustache-compatible templates as the original
+
+**Note:** This is not a replacement for the original. If you need the full feature set, extensive generator library, or battle-tested stability, use the original [OpenAPI Generator](https://openapi-generator.tech/). This port focuses on common use cases with a subset of generators.
+
+## Installation
+
+```bash
+npm install @kattebak/openapi-generator-ts
+```
+
+Or run directly with npx:
+
+```bash
+npx @kattebak/openapi-generator-ts generate -i api.yaml -g typescript-fetch -o ./generated
+```
+
+## Usage
+
+### CLI
+
+```bash
+# List available generators
+openapi-generator list
+
+# Validate an OpenAPI specification
+openapi-generator validate -i openapi.yaml
+
+# Generate client code
+openapi-generator generate -i openapi.yaml -g typescript-fetch -o ./output
+
+# Generate with additional properties
+openapi-generator generate -i openapi.yaml -g python -o ./output \
+  --additional-properties packageName=my_api,packageVersion=1.0.0
+```
+
+### Programmatic API
+
+```typescript
+import { generate, parseSpec } from '@kattebak/openapi-generator-ts';
+
+// Parse and validate a spec
+const { document } = await parseSpec('./openapi.yaml');
+
+// Generate code
+await generate({
+  inputSpec: './openapi.yaml',
+  generatorName: 'typescript-fetch',
+  outputDir: './generated',
+  additionalProperties: {
+    npmName: '@myorg/api-client',
+    npmVersion: '1.0.0',
+  },
+});
+```
+
+## Available Generators
+
+| Generator | Language | Description |
+|-----------|----------|-------------|
+| `typescript-fetch` | TypeScript | Client using the Fetch API |
+| `python` | Python | Python client with urllib3 |
+| `go` | Go | Go client with net/http |
+| `php` | PHP | PHP client (guzzle or psr-18) |
+
+## Configuration
+
+### Generator Options
+
+Each generator supports additional properties that can be passed via `--additional-properties` or the programmatic API:
+
+**typescript-fetch:**
+- `npmName` - NPM package name
+- `npmVersion` - NPM package version
+- `supportsES6` - Generate ES6 code (default: true)
+
+**python:**
+- `packageName` - Python package name
+- `packageVersion` - Package version
+- `packageUrl` - Package URL for setup.py
+
+**go:**
+- `packageName` - Go package name
+- `packageVersion` - Package version
+- `isGoSubmodule` - Generate as Go submodule
+
+**php:**
+- `packageName` - Composer package name
+- `invokerPackage` - Root namespace
+- `composerVendorName` - Composer vendor name
+
+## Templates
+
+This generator uses Handlebars templates that are largely compatible with the original Mustache templates. Custom templates can be provided via the `--template-dir` option.
+
+### Syncing Templates from Original
+
+Templates are synced from the original OpenAPI Generator repository. The sync script does a shallow clone and automatically converts Mustache syntax to Handlebars-compatible format:
+
+```bash
+# Sync templates for all generators
+npm run sync-templates
+
+# Sync specific generators only
+./scripts/sync-templates.sh -g typescript-fetch,python
+
+# Clean existing templates and re-sync
+npm run sync-templates:clean
+
+# Preview what would be synced (dry run)
+./scripts/sync-templates.sh --dry-run
+```
+
+The sync script handles:
+- Shallow cloning of the original repository (cached in `.template-cache/`)
+- Removing Mustache delimiter changes (`{{=<% %>=}}`)
+- Converting lambda syntax (`{{#lambda.func}}` to `{{#func}}`)
+
+## Comparing Output to Original
+
+To verify this port generates compatible output, you can compare against the original Java OpenAPI Generator:
+
+```bash
+# Generate with original (using Docker, no Java needed)
+docker run --rm -v $(pwd):/local openapitools/openapi-generator-cli generate \
+  -i /local/samples/petstore.yaml \
+  -g typescript-fetch \
+  -o /local/tmp/original-output
+
+# Generate with this port
+cd samples && make typescript-fetch
+
+# Compare
+diff -r tmp/original-output samples/build/typescript-fetch
+```
+
+For detailed comparison methodology and debugging tips, see [AGENTS.md](./AGENTS.md#comparing-output-against-original-java-generator).
+
+## Requirements
+
+- Node.js >= 22.0.0
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Sync templates from original OpenAPI Generator
+npm run sync-templates
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+Apache-2.0 - Same as the original OpenAPI Generator.
+
+## See Also
+
+- [OpenAPI Generator](https://openapi-generator.tech/) - The original Java implementation
+- [OpenAPI Specification](https://spec.openapis.org/oas/latest.html) - The OpenAPI Specification

package/dist/cli/commands/generate.d.ts

@@ -0,0 +1,23 @@
+export interface GenerateOptions {
+    inputSpec: string;
+    generatorName: string;
+    outputDir: string;
+    templateDir?: string;
+    library?: string;
+    packageName?: string;
+    apiPackage?: string;
+    modelPackage?: string;
+    generateModels?: boolean;
+    generateApis?: boolean;
+    generateSupportingFiles?: boolean;
+    skipOverwrite?: boolean;
+    minimalUpdate?: boolean;
+    dryRun?: boolean;
+    additionalProperties?: Record<string, string>;
+    typeMappings?: Record<string, string>;
+    importMappings?: Record<string, string>;
+    verbose?: boolean;
+    debug?: boolean;
+}
+export declare function generateCommand(options: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmI7E"}

package/dist/cli/commands/generate.js

@@ -0,0 +1,116 @@
+import { createDefaultConfig } from "../../core/config.js";
+import { createGenerator } from "../../core/generator.js";
+import { getGenerator, getGeneratorAdditionalProperties, hasGenerator, listGenerators, } from "../../generators/index.js";
+export async function generateCommand(options) {
+    const startTime = Date.now();
+    // Check if generator exists
+    if (!hasGenerator(options.generatorName)) {
+        console.error(`Unknown generator: ${options.generatorName}`);
+        console.log("\nAvailable generators:");
+        for (const gen of listGenerators()) {
+            console.log(`  - ${gen}`);
+        }
+        process.exit(1);
+    }
+    // Get generator metadata
+    const metadata = getGenerator(options.generatorName);
+    if (!metadata) {
+        console.error(`Could not load generator: ${options.generatorName}`);
+        process.exit(1);
+    }
+    // Create config
+    const config = createDefaultConfig({
+        inputSpec: options.inputSpec,
+        generatorName: options.generatorName,
+        outputDir: options.outputDir,
+        templateDir: options.templateDir,
+        library: options.library,
+        packageName: options.packageName,
+        apiPackage: options.apiPackage,
+        modelPackage: options.modelPackage,
+        generateModels: options.generateModels,
+        generateApis: options.generateApis,
+        generateSupportingFiles: options.generateSupportingFiles,
+        skipOverwrite: options.skipOverwrite,
+        minimalUpdate: options.minimalUpdate,
+        dryRun: options.dryRun,
+        additionalProperties: options.additionalProperties,
+        typeMappings: options.typeMappings,
+        importMappings: options.importMappings,
+        verbose: options.verbose,
+        debug: options.debug,
+        validateSpec: true,
+    });
+    // Get generator specific additional properties and merge them
+    const generatorProps = getGeneratorAdditionalProperties(options.generatorName, config);
+    // Merge generator properties into additionalProperties
+    config.additionalProperties = {
+        ...generatorProps,
+        ...config.additionalProperties,
+    };
+    // Update top-level config properties if provided by generator defaults
+    if (generatorProps.packageName && !config.packageName) {
+        config.packageName = generatorProps.packageName;
+    }
+    if (generatorProps.apiPackage && !config.apiPackage) {
+        config.apiPackage = generatorProps.apiPackage;
+    }
+    if (generatorProps.modelPackage && !config.modelPackage) {
+        config.modelPackage = generatorProps.modelPackage;
+    }
+    if (options.verbose) {
+        console.log("OpenAPI Generator");
+        console.log("=================");
+        console.log(`Generator: ${options.generatorName}`);
+        console.log(`Input: ${options.inputSpec}`);
+        console.log(`Output: ${options.outputDir}`);
+        if (options.templateDir) {
+            console.log(`Templates: ${options.templateDir}`);
+        }
+        if (options.library) {
+            console.log(`Library: ${options.library}`);
+        }
+        console.log("");
+    }
+    // Create and run generator
+    const generator = createGenerator(config, metadata);
+    try {
+        const result = await generator.generate();
+        const elapsed = Date.now() - startTime;
+        // Summary
+        const writtenFiles = result.files.filter((f) => !f.skipped);
+        const skippedFiles = result.files.filter((f) => f.skipped);
+        if (options.verbose || options.dryRun) {
+            console.log("");
+            console.log("Generation Summary");
+            console.log("------------------");
+            console.log(`Models: ${result.models.size}`);
+            console.log(`API Tags: ${result.operations.size}`);
+            console.log(`Files written: ${writtenFiles.length}`);
+            console.log(`Files skipped: ${skippedFiles.length}`);
+            console.log(`Time: ${elapsed}ms`);
+            if (result.warnings.length > 0) {
+                console.log("");
+                console.log("Warnings:");
+                for (const warning of result.warnings) {
+                    console.log(`  - ${warning}`);
+                }
+            }
+        }
+        else {
+            console.log(`Generated ${writtenFiles.length} files in ${options.outputDir} (${elapsed}ms)`);
+        }
+        if (options.dryRun) {
+            console.log("");
+            console.log("(Dry run - no files were actually written)");
+        }
+    }
+    catch (error) {
+        console.error("Generation failed:", error instanceof Error ? error.message : error);
+        if (options.debug) {
+            console.error(error);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/commands/generate.js.map

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

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,2 @@
+export declare function listCommand(): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,IAAI,IAAI,CAuBlC"}

package/dist/cli/commands/list.js

@@ -0,0 +1,26 @@
+/**
+ * List command handler
+ */
+import { getGenerator, listGenerators } from "../../generators/index.js";
+export function listCommand() {
+    console.log("Available generators:");
+    console.log("");
+    const generators = listGenerators();
+    for (const name of generators) {
+        const metadata = getGenerator(name);
+        if (metadata) {
+            console.log(`  ${name}`);
+            if (metadata.description) {
+                console.log(`    ${metadata.description}`);
+            }
+            console.log(`    Type: ${metadata.type}`);
+            console.log(`    Language: ${metadata.language}`);
+            if (metadata.libraries && metadata.libraries.length > 0) {
+                console.log(`    Libraries: ${metadata.libraries.join(", ")}`);
+            }
+            console.log("");
+        }
+    }
+    console.log(`Total: ${generators.length} generators available`);
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEzE,MAAM,UAAU,WAAW;IAC1B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACzB,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;YAClD,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,OAAO,CAAC,GAAG,CAAC,kBAAkB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,UAAU,UAAU,CAAC,MAAM,uBAAuB,CAAC,CAAC;AACjE,CAAC"}

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,6 @@
+export interface ValidateOptions {
+    inputSpec: string;
+    strict?: boolean;
+}
+export declare function validateCommand(options: ValidateOptions): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF7E"}

package/dist/cli/commands/validate.js

@@ -0,0 +1,80 @@
+/**
+ * Validate command handler
+ */
+import { getInfo, getPaths, getSchemas, parseSpec, } from "../../parser/openapi-parser.js";
+export async function validateCommand(options) {
+    console.log(`Validating: ${options.inputSpec}`);
+    console.log("");
+    try {
+        const spec = await parseSpec(options.inputSpec, {
+            validate: true,
+            dereference: false, // Don't dereference for validation
+        });
+        const info = getInfo(spec.document);
+        const schemas = getSchemas(spec.document);
+        const paths = getPaths(spec.document);
+        console.log("Validation successful!");
+        console.log("");
+        console.log("Specification Details:");
+        console.log(`  Title: ${info.title}`);
+        console.log(`  Version: ${info.version}`);
+        console.log(`  OpenAPI Version: ${spec.version}`);
+        if (info.description) {
+            console.log(`  Description: ${info.description.substring(0, 100)}...`);
+        }
+        console.log("");
+        console.log("Statistics:");
+        console.log(`  Schemas: ${Object.keys(schemas).length}`);
+        console.log(`  Paths: ${Object.keys(paths).length}`);
+        // Count operations
+        let operationCount = 0;
+        const methods = [
+            "get",
+            "post",
+            "put",
+            "delete",
+            "patch",
+            "options",
+            "head",
+            "trace",
+        ];
+        for (const pathItem of Object.values(paths)) {
+            if (!pathItem)
+                continue;
+            for (const method of methods) {
+                if (pathItem[method]) {
+                    operationCount++;
+                }
+            }
+        }
+        console.log(`  Operations: ${operationCount}`);
+        if (options.strict) {
+            // Additional strict checks could go here
+            console.log("");
+            console.log("Strict validation passed.");
+        }
+    }
+    catch (error) {
+        console.error("Validation failed!");
+        console.error("");
+        if (error instanceof Error) {
+            console.error("Error:", error.message);
+            // Try to provide more context for common errors
+            if (error.message.includes("$ref")) {
+                console.error("");
+                console.error("Hint: This appears to be a reference error. Check that all $ref");
+                console.error("      references point to valid schema definitions.");
+            }
+            if (error.message.includes("required")) {
+                console.error("");
+                console.error("Hint: A required field is missing. Check the OpenAPI specification");
+                console.error('      for required fields like "info", "paths", etc.');
+            }
+        }
+        else {
+            console.error("Error:", error);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACN,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,GACT,MAAM,gCAAgC,CAAC;AAOxC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB;IAC7D,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE;YAC/C,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,KAAK,EAAE,mCAAmC;SACvD,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEtC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAErD,mBAAmB;QACnB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG;YACf,KAAK;YACL,MAAM;YACN,KAAK;YACL,QAAQ;YACR,OAAO;YACP,SAAS;YACT,MAAM;YACN,OAAO;SACP,CAAC;QACF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC9B,IAAK,QAAoC,CAAC,MAAM,CAAC,EAAE,CAAC;oBACnD,cAAc,EAAE,CAAC;gBAClB,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,cAAc,EAAE,CAAC,CAAC;QAE/C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,yCAAyC;YACzC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAElB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAEvC,gDAAgD;YAChD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,KAAK,CACZ,iEAAiE,CACjE,CAAC;gBACF,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,CAAC,KAAK,CACZ,oEAAoE,CACpE,CAAC;gBACF,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;YACvE,CAAC;QACF,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;AACF,CAAC"}

package/dist/cli/convert-template.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Mustache to Handlebars Template Converter
+ *
+ * Converts OpenAPI Generator Mustache templates to Handlebars-compatible format.
+ *
+ * Handlebars is largely compatible with Mustache, but there are a few key differences:
+ *
+ * 1. Delimiter changes ({{=<% %>=}}) are NOT supported in Handlebars
+ *    - These are converted to helper calls or removed
+ *
+ * 2. The {{#lambda.xxx}}...{{/lambda.xxx}} pattern becomes {{#xxx}}...{{/xxx}}
+ *    - Lambda helpers are registered in the engine adapter
+ *
+ * 3. Array index access like foo.0.bar needs bracket notation: foo.[0].bar
+ *    - Handlebars requires this for numeric keys
+ *
+ * Most other Mustache syntax works identically in Handlebars:
+ * - {{var}} - escaped output
+ * - {{{var}}} - unescaped output
+ * - {{#section}}...{{/section}} - block sections
+ * - {{^inverted}}...{{/inverted}} - inverted sections
+ * - {{>partial}} - partials
+ * - {{!comment}} - comments
+ */
+/**
+ * Convert a Mustache template to Handlebars-compatible format
+ * Uses simple regex-based transformations for reliability
+ */
+export declare function convertTemplate(content: string): string;
+//# sourceMappingURL=convert-template.d.ts.map

package/dist/cli/convert-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-template.d.ts","sourceRoot":"","sources":["../../src/cli/convert-template.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyMvD"}