wormajs 0.0.1 → 0.0.2-beta.1

package/README.md

@@ -1,49 +1,96 @@
-# Worma - A modern OpenAPI code generator
-
-<p align="center">
-<img width="200px" src="https://alova.js.org/img/logo-text-vertical.svg" />
-</p>
-
-<p align="center"><b>Workflow-Streamlined next-generation request tools.<br />Extremely improve your API using efficiency and save brainpower Just one step</b></p>
-
----
-
-## Usage
-
-This is a more modern openAPI generating solution for alova.js.
-
-Please to [worma documentation](https://alova.js.org/api/worma) for more details.
-
-## Join the community
-
-- [Follow us on X to get the latest updates](https://x.com/alovajs)
-
-- [Join the Discord](https://discord.gg/S47QGJgkVb)
-
-- [Join the WeChat group](https://alova.js.org/img/wechat_qrcode.jpg)
-
-## We need your support
-
-If you like alova, we are very grateful for giving us a star in the upper right corner, which is a recognition and encouragement for our work.
-
-## Welcome to contribute
-
-We are honored to receive active participation from developers around the world in Issues and Discussions.
-
-We hope to make alova a common project for everyone who is willing to participate, rather than the alova team. We encourage everyone to become a contributor to the alova community with an open and inclusive attitude. Even if you are a junior developer, as long as your ideas meet the development guidelines of alova, please participate generously.
-
-Effective contributions will win you a certain reputation in the Alova community. Before contributing, please be sure to read the [Contribution Guide](https://github.com/alovajs/alova/blob/main/CONTRIBUTING.md) in detail to ensure your contribution is effective.
-
-## Changelog
-
-[Link](https://github.com/alovajs/alova/releases)
-
-## Contributors
-
-<a href="https://github.com/alovajs/alova/graphs/contributors">
-<img src="https://contrib.rocks/image?repo=alovajs/alova&max=30&columns=10" />
-</a>
-
-## LICENSE
-
-[MIT](https://en.wikipedia.org/wiki/MIT_License)
+# worma - A Universal OpenAPI Code Generator
+
+<p align="center">
+<img width="200px" src="https://alova.js.org/img/logo-text-vertical.svg" />
+</p>
+
+<p align="center"><b>One OpenAPI spec. Code for developers, knowledge for AI.<br />Generate API calling functions, TypeScript types, documentation, and AI Skills in a single command.</b></p>
+
+---
+
+## What is worma?
+
+worma is a universal OpenAPI code generator that works with any backend language and any frontend request library. Provide an OpenAPI spec, and worma generates:
+
+- **API calling functions** — ready to import and use in your project
+- **TypeScript type definitions** — full type safety for request/response
+- **In-editor documentation** — hover docs, sidebar API explorer via VSCode extension
+- **AI Skills** — structured API knowledge for coding agents (Cursor, Copilot, etc.)
+
+## Installation
+
+```bash
+npm i wormajs -D
+```
+
+## Quick Start
+
+```bash
+# Initialize configuration
+npx worma init
+
+# Generate API code
+npx worma gen
+```
+
+## Templates
+
+worma ships with pre-built templates for popular request libraries:
+
+| Template       | Library      | Notes                                 |
+| -------------- | ------------ | ------------------------------------- |
+| `alova`        | alova@3      | Functional, tree-shakeable            |
+| `alovaGlobals` | alova@3      | Global `Apis.xxx`, migration-friendly |
+| `axios`        | axios        | Most popular HTTP client              |
+| `fetch`        | native fetch | Zero dependencies                     |
+| `ky`           | ky           | Lightweight fetch wrapper             |
+
+Custom Handlebars templates are also supported.
+
+## Plugins
+
+Built-in plugins include: `aiDoc`, `apifox`, `filterApi`, `importType`, `payloadModifier`, `platform`, `rename`, `tagModifier`.
+
+## Documentation
+
+Please refer to the [worma documentation](https://worma.js.org) for full details.
+
+## Migration from @alova/wormhole
+
+```bash
+npx skills add alovajs/skills --skill worma-guidelines
+```
+
+Then ask your coding agent: "Please migrate this project from @alova/wormhole to worma."
+
+## Join the community
+
+- [Follow us on X to get the latest updates](https://x.com/alovajs)
+- [Join the Discord](https://discord.gg/S47QGJgkVb)
+- [Join the WeChat group](https://alova.js.org/img/wechat_qrcode.jpg)
+
+## We need your support
+
+If you like worma, please give us a star! It's a recognition and encouragement for our work.
+
+## Welcome to contribute
+
+We are honored to receive active participation from developers around the world in Issues and Discussions.
+
+We hope to make worma a common project for everyone who is willing to participate. We encourage everyone to become a contributor to the worma community with an open and inclusive attitude. Even if you are a junior developer, as long as your ideas meet the development guidelines, please participate generously.
+
+Effective contributions will win you a certain reputation in the worma community. Before contributing, please be sure to read the [Contribution Guide](https://github.com/alovajs/alova/blob/main/CONTRIBUTING.md) in detail.
+
+## Changelog
+
+[Link](https://github.com/alovajs/alova/releases)
+
+## Contributors
+
+<a href="https://github.com/alovajs/alova/graphs/contributors">
+<img src="https://contrib.rocks/image?repo=alovajs/alova&max=30&columns=10" />
+</a>
+
+## LICENSE
+
+[MIT](https://en.wikipedia.org/wiki/MIT_License)

package/dist/core/loader/astLoader/generates/group.js

@@ -20,7 +20,12 @@ function groupTypeGenerator(ast, ctx) {
         // In UNION (|), INTERSECTION members do NOT need parens because `&` already binds tighter
         const memberTsStr = (0, utils_1.getValue)(nextValue, ctx.options);
         const producesUnionLike = item.type === type_1.ASTType.UNION || item.type === type_1.ASTType.ENUM;
-        const needsParens = ast.type === type_1.ASTType.INTERSECTION && producesUnionLike;
+        let needsParens = ast.type === type_1.ASTType.INTERSECTION && producesUnionLike;
+        // In UNION (|), wrap block-like members that contain const discriminators
+        // (key:"value" literal properties) so discriminated union branches are clearly
+        // delimited (see issue #824).
+        if (!needsParens && ast.type === type_1.ASTType.UNION && /\w+:"[^"]*"/.test(memberTsStr))
+            needsParens = true;
         groups.push(needsParens ? `(${memberTsStr})` : memberTsStr);
     });
     switch (ast.type) {

package/dist/core/loader/astLoader/generates/interface.js

@@ -36,7 +36,11 @@ function normalInterfaceGenerator(ast, ctx) {
         ctx.pathKey = keyName;
         const nextResult = ctx.next(param.ast, ctx.options);
         const value = (0, utils_1.getValue)(nextResult, ctx.options);
-        `${nextResult.comment ?? ''}${keyName}${optionalFlag}: ${value}`.split('\n').forEach(line => lines.push(`  ${line}`));
+        // Literal (const) properties are rendered without a space after the colon
+        // so the generated property keeps the form key:"value" (see issue #824).
+        const sep = param.ast.type === type_1.ASTType.LITERAL ? ':' : ': ';
+        const propLine = `${nextResult.comment ?? ''}${keyName}${optionalFlag}${sep}${value}`;
+        propLine.split('\n').forEach(line => lines.push(`  ${line}`));
     });
     if (ast.addParams) {
         ctx.pathKey = '[key: string]';

package/dist/core/loader/astLoader/normalize/rules/mergeAnyOf.js

@@ -1,6 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = mergeAnyOf;
+/**
+ * 检测两个 schema 在某个共享属性上是否构成判别式。
+ * 当不同分支对同一字段使用不同的 const 或 enum 时，合并这些分支会
+ * 丢掉判别信息，因此应保留为独立的联合分支。
+ */
+function hasDiscriminatorConflict(a, b) {
+    const aProps = (a.properties ?? {});
+    const bProps = (b.properties ?? {});
+    for (const key of Object.keys(aProps)) {
+        if (!(key in bProps)) {
+            continue;
+        }
+        const ap = aProps[key];
+        const bp = bProps[key];
+        // 不同的 const 值 → 判别式
+        if (ap.const !== undefined && bp.const !== undefined && ap.const !== bp.const) {
+            return true;
+        }
+        // 一个 const、一个 enum → 判别式
+        if ((ap.const !== undefined && bp.enum) || (bp.const !== undefined && ap.enum)) {
+            return true;
+        }
+        // 不同的 enum 值 → 判别式
+        if (ap.enum && bp.enum) {
+            const aKey = JSON.stringify([...ap.enum].sort());
+            const bKey = JSON.stringify([...bp.enum].sort());
+            if (aKey !== bKey) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * 组内任意两个分支存在判别式冲突即视为有冲突。
+ */
+function groupHasDiscriminatorConflict(group) {
+    for (let i = 0; i < group.length; i++) {
+        for (let j = i + 1; j < group.length; j++) {
+            if (hasDiscriminatorConflict(group[i], group[j])) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
 function mergeAnyOf(schema) {
     if (!schema.anyOf || schema.anyOf.length < 2) {
         return;
@@ -17,26 +63,30 @@ function mergeAnyOf(schema) {
     for (const group of typeMap.values()) {
         if (group.length === 1) {
             mergedAnyOf.push(group[0]);
+            continue;
         }
-        else {
-            const merged = { type: group[0].type };
-            for (const sub of group) {
-                for (const [key, value] of Object.entries(sub)) {
-                    if (key === 'type')
-                        continue;
-                    if (merged[key] === undefined) {
-                        merged[key] = value;
-                    }
-                    else if (Array.isArray(merged[key]) && Array.isArray(value)) {
-                        merged[key] = Array.from(new Set([...merged[key], ...value]));
-                    }
-                    else if (typeof merged[key] === 'object' && typeof value === 'object') {
-                        merged[key] = { ...merged[key], ...value };
-                    }
+        // 组内分支之间只要存在判别式冲突，就保留原始分支不做合并
+        if (groupHasDiscriminatorConflict(group)) {
+            mergedAnyOf.push(...group);
+            continue;
+        }
+        const merged = { type: group[0].type };
+        for (const sub of group) {
+            for (const [key, value] of Object.entries(sub)) {
+                if (key === 'type')
+                    continue;
+                if (merged[key] === undefined) {
+                    merged[key] = value;
+                }
+                else if (Array.isArray(merged[key]) && Array.isArray(value)) {
+                    merged[key] = Array.from(new Set([...merged[key], ...value]));
+                }
+                else if (typeof merged[key] === 'object' && typeof value === 'object') {
+                    merged[key] = { ...merged[key], ...value };
                 }
             }
-            mergedAnyOf.push(merged);
         }
+        mergedAnyOf.push(merged);
     }
     if (mergedAnyOf.length === schema.anyOf.length && mergedAnyOf.every((s, i) => s === schema.anyOf[i])) {
         return;

package/dist/core/loader/astLoader/parsers/const.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constTypeParser = constTypeParser;
+const type_1 = require("../../../../type");
+const utils_1 = require("./utils");
+/**
+ * 将带有 const 关键字的 JSON Schema 解析为字面量 AST 节点。
+ * 例如：
+ *   { "type": "string", "const": "email" }   -> "email"
+ *   { "type": "number", "const": 1 }          -> 1
+ *   { "const": true }                         -> true
+ *   { "const": "authorization_code" }         -> "authorization_code"
+ *
+ * 参考：JSON Schema draft-04+ 允许 `const` 与 `type` 同时出现，
+ * 表示该字段必须等于 `const` 的值，对应到 TypeScript 即字面量类型。
+ */
+function constTypeParser(schema, ctx) {
+    const result = {
+        ...(0, utils_1.initAST)(schema, ctx),
+        type: type_1.ASTType.LITERAL,
+        params: schema.const,
+    };
+    return result;
+}
+exports.default = {
+    type: 'const',
+    parse: constTypeParser,
+};

package/dist/core/loader/astLoader/parsers/forward/const.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 带有 const 关键字的 schema 优先路由到 const 解析器，
+ * 即使 schema 同时声明了 type（如 `{ "type": "string", "const": "email" }`），
+ * 也能正确产出字面量类型。
+ */
+exports.default = {
+    is(schema) {
+        return schema && schema.const !== undefined && schema.const !== null;
+    },
+    to: 'const',
+};

package/dist/core/loader/astLoader/parsers/forward/index.js

@@ -6,11 +6,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.forwarders = void 0;
 exports.forward = forward;
 const array_1 = __importDefault(require("./array"));
+const const_1 = __importDefault(require("./const"));
 const enum_1 = __importDefault(require("./enum"));
 const group_1 = __importDefault(require("./group"));
 const object_1 = __importDefault(require("./object"));
 const tuple_1 = __importDefault(require("./tuple"));
-exports.forwarders = [object_1.default, enum_1.default, tuple_1.default, array_1.default, group_1.default];
+exports.forwarders = [
+    object_1.default,
+    enum_1.default,
+    tuple_1.default,
+    array_1.default,
+    const_1.default,
+    group_1.default,
+];
 function forward(schema) {
     for (const forwarder of exports.forwarders) {
         if (forwarder.is(schema)) {

package/dist/core/loader/astLoader/parsers/index.js

@@ -20,6 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.astParse = astParse;
 const type_1 = require("../../../../type");
 const array_1 = __importDefault(require("./array"));
+const const_1 = __importDefault(require("./const"));
 const enum_1 = __importDefault(require("./enum"));
 const group_1 = __importDefault(require("./group"));
 const object_1 = __importDefault(require("./object"));
@@ -33,7 +34,7 @@ function astParse(schema, options) {
         const value = (0, utils_1.parse)(schema, {
             type: (0, utils_1.getParserSchemaType)(schema),
             ctx,
-            parsers: [array_1.default, object_1.default, enum_1.default, simple_1.default, reference_1.default, tuple_1.default, group_1.default],
+            parsers: [array_1.default, object_1.default, enum_1.default, const_1.default, simple_1.default, reference_1.default, tuple_1.default, group_1.default],
         });
         if (!value) {
             return {

package/dist/core/parser/openApiParser/helper.js

@@ -9,6 +9,7 @@ const node_fs_1 = require("node:fs");
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
+const swagger2openapi_1 = __importDefault(require("swagger2openapi"));
 const poolManager_1 = require("../../../core/workerPool/poolManager");
 const helper_1 = require("../../../helper");
 const utils_1 = require("../../../utils");
@@ -16,28 +17,48 @@ const supportedExtname = ['json', 'yaml'];
 function isSwagger2(data) {
     return !!data?.swagger;
 }
-/** 9.3.4: Run CPU-heavy Swagger2→OpenAPI3 conversion via PoolManager */
+/** Main-thread Swagger2→OpenAPI3 conversion — used as a fallback when the worker pool is unavailable. */
+function convertSwagger2OnMainThread(data) {
+    return swagger2openapi_1.default
+        .convertObj(data, { warnOnly: true })
+        .then(result => result.openapi);
+}
+/**
+ * 9.3.4: Run CPU-heavy Swagger2→OpenAPI3 conversion via PoolManager (worker thread).
+ * If the worker pool cannot be created or fails at runtime (e.g. test/CI environments
+ * where the `.ts` worker cannot be loaded as a worker, or worker_threads is unavailable),
+ * gracefully fall back to the main-thread conversion so generation still succeeds.
+ */
 function convertSwagger2Async(data) {
-    return new Promise((resolve, reject) => {
-        // Resolve worker path: .js for production, .ts for vitest/dev
-        // In mocked filesystem envs, existsSync may return false — fall back to trying both paths
-        const jsPath = node_path_1.default.resolve(__dirname, '../../workerPool/swagger2Worker.js');
-        const tsPath = node_path_1.default.resolve(__dirname, '../../workerPool/swagger2Worker.ts');
-        const workerScript = (0, node_fs_1.existsSync)(jsPath) ? jsPath : tsPath;
-        const pool = poolManager_1.PoolManager.getInstance().get({
+    // Resolve worker path: .js for production, .ts for vitest/dev
+    // In mocked filesystem envs, existsSync may return false — fall back to trying both paths
+    const jsPath = node_path_1.default.resolve(__dirname, '../../workerPool/swagger2Worker.js');
+    const tsPath = node_path_1.default.resolve(__dirname, '../../workerPool/swagger2Worker.ts');
+    const workerScript = (0, node_fs_1.existsSync)(jsPath) ? jsPath : tsPath;
+    let pool;
+    try {
+        pool = poolManager_1.PoolManager.getInstance().get({
             key: 'swagger2Worker',
             workerScript,
             sharedContext: {},
             poolSize: 1,
         });
+    }
+    catch {
+        return convertSwagger2OnMainThread(data);
+    }
+    return new Promise((resolve, reject) => {
         pool.processBatch([data]).then((results) => {
             if (results.length > 0 && results[0].openapi) {
                 resolve(results[0].openapi);
             }
             else {
-                reject(new Error('Empty result from swagger2 conversion'));
+                convertSwagger2OnMainThread(data).then(resolve, reject);
             }
-        }).catch(reject);
+        }).catch(() => {
+            // Worker failed (script load error, thread crash, etc.) — fall back to main thread
+            convertSwagger2OnMainThread(data).then(resolve, reject);
+        });
     });
 }
 // Parse local openapi files

package/dist/plugins/presets/platform.js

@@ -44,7 +44,7 @@ function resolvePlatformUrls(baseUrl, platformType) {
  *
  * @example
  * ```ts
- * import { platform, alovaGlobals } from 'worma/plugin';
+ * import { platform, alovaGlobals } from 'wormajs/plugin';
  *
  * defineConfig({
  *   generator: [{

package/dist/readConfig.js

@@ -41,9 +41,9 @@ async function readConfig(projectPath = process.cwd()) {
     const userDependencies = await (0, utils_1.getUserInstalledDependencies)(projectPath);
     // 始终将 worma 自身作为外部依赖，防止 esbuild 打包 worma 源码进入临时文件
     // 否则 __dirname 会指向用户项目目录，导致预设模板路径解析失败
-    // monorepo 子包可能不直接依赖 worma，但 config 文件会 import from 'worma'
-    const allExternals = [...new Set([...userDependencies, 'worma', 'worma/plugin'])];
-    const configTmpFileName = `alova_tmp_${Date.now()}.cjs`;
+    // monorepo 子包可能不直接依赖 wormajs，但 config 文件会 import from 'wormajs'
+    const allExternals = [...new Set([...userDependencies, 'worma', 'wormajs/plugin'])];
+    const configTmpFileName = `worma_tmp_${Date.now()}.cjs`;
     // 使用绝对路径：esbuild 写入相对 outfile 时按 cwd 解析，
     // 而 require() 解析相对路径时基于调用模块所在目录，二者不一致会导致 require 失败。
     // 绝对路径可保证写入与 require 指向同一文件。

package/dist/template/presets/alova/common/helper.cjs.handlebars

@@ -4,9 +4,11 @@ function buildPayload(url, defaultConfig, apiName, config) {
 }
 
 /**
- * @param {Record<string, any>} _ - tagged api map (unused at runtime)
- * @param {Record<string, any>} configMap - default config per api name
- * @returns {Record<string, any>}
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
  */
 const setMethodDefaultConfig = (_, configMap) => configMap;
 

package/dist/template/presets/alova/common/services/{tag}.d.cts.handlebars

@@ -1,8 +1,8 @@
-import type { Alova2Method, Alova2MethodConfig } from '../typed';
+import type { Alova2Method, Alova2MethodConfig } from '../typed.d.cts';
 {{#each tagedApis}}
 import type { {{{tagName}}}DefaultConfig } from '.';
 {{/each}}
-import type * as ComponentTypes from '../components';
+import type * as ComponentTypes from '../components.d.cts';
 
 {{#each tagedApis}}
 {{> extract-responded}}

package/dist/template/presets/alova/module/helper.js.handlebars

@@ -4,8 +4,10 @@ export function buildPayload(url, defaultConfig, apiName, config) {
 }
 
 /**
- * @param {Record<string, any>} _ - tagged api map (unused at runtime)
- * @param {Record<string, any>} configMap - default config per api name
- * @returns {Record<string, any>}
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
  */
 export const setMethodDefaultConfig = (_, configMap) => configMap;

package/dist/template/presets/alova/partials/typed-body.handlebars

@@ -1,4 +1,4 @@
-import type { alovaInstance } from './index';
+import type { alovaInstance } from './index{{#if (eq type "commonjs")}}.cjs{{/if}}';
 import type { Alova, AlovaGenerics, AlovaMethodCreateConfig, Method } from 'alova';
 
 type CollapsedAlova = typeof alovaInstance;

package/dist/template/presets/alova-globals/common/apiDefinitions.cjs.handlebars

@@ -1,12 +1,12 @@
-{{> comment}}
-{{#if config.useImportType}}/// <reference types='./globals.d.ts' />{{else}}/// <reference types='./globals.d.ts' />{{/if}}
-
-const apiDefinitions = {
-{{#each tagedApis}}
-  {{#apis}}
-  '{{{tag}}}.{{{name}}}': ['{{method}}', '{{{path}}}'],
-  {{/apis}}
-{{/each}}
-};
-
-module.exports = apiDefinitions;
+{{> comment}}
+{{#if config.useImportType}}/// <reference types='./globals.d.cts' />{{else}}/// <reference types='./globals.d.cts' />{{/if}}
+
+const apiDefinitions = {
+{{#each tagedApis}}
+  {{#apis}}
+  '{{{tag}}}.{{{name}}}': ['{{method}}', '{{{path}}}'],
+  {{/apis}}
+{{/each}}
+};
+
+module.exports = apiDefinitions;

package/dist/template/presets/alova-globals/partials/globals-d-ts.handlebars

@@ -1,6 +1,6 @@
 import type { Alova, AlovaMethodCreateConfig, AlovaGenerics, Method } from 'alova';
-import type { alovaInstance, $$userConfigMap } from './index';
-import type apiDefinitions from './apiDefinitions';
+import type { alovaInstance, $$userConfigMap } from './index{{#if (eq type "commonjs")}}.cjs{{/if}}';
+import type apiDefinitions from './apiDefinitions{{#if (eq type "commonjs")}}.cjs{{/if}}';
 
 type CollapsedAlova = typeof alovaInstance;
 type UserMethodConfigMap = typeof $$userConfigMap;

package/dist/template/presets/axios/common/helper.cjs.handlebars

@@ -22,6 +22,13 @@ function buildPayload(url, defaultConfig, apiName, config) {
   return { url: resolvedUrl, mergedConfig };
 }
 
+/**
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
+ */
 const setDefaultConfig = (_, configMap) => configMap;
 
 module.exports = { buildPayload, setDefaultConfig };

package/dist/template/presets/axios/common/services/{tag}.d.cts.handlebars

@@ -1,5 +1,5 @@
 import type { AxiosRequestConfig } from 'axios';
-import type * as ComponentTypes from '../components';
+import type * as ComponentTypes from '../components.d.cts';
 
 {{#each tagedApis}}
 {{#each apis}}

package/dist/template/presets/axios/module/helper.js.handlebars

@@ -22,4 +22,11 @@ export function buildPayload(url, defaultConfig, apiName, config) {
   return { url: resolvedUrl, mergedConfig };
 }
 
+/**
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
+ */
 export const setDefaultConfig = (_, configMap) => configMap;

package/dist/template/presets/axios/typescript/services/{tag}.ts.handlebars

@@ -24,7 +24,7 @@ export function {{{name}}}(config: {{{name}}}ExtraConfig): Promise<{{{name}}}Res
     url,
     ...mergedConfig,{{#if (eq response "Blob")}}
     responseType: 'blob',{{/if}}
-  }){{#if (eq response "Blob")}}.then((data: any) => data instanceof Blob ? data : new Blob([data])){{/if}} as Promise<{{{name}}}Response>;
+  }){{#if (eq response "Blob")}}.then((data: any) => data instanceof Blob ? data : new Blob([data])){{/if}};
 }
 
 {{/each}}

package/dist/template/presets/config/common/worma.config.js.handlebars

@@ -1,5 +1,5 @@
-const { defineConfig } = require('worma');
-const { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } = require('worma/plugin');
+const { defineConfig } = require('wormajs');
+const { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } = require('wormajs/plugin');
 
 // For more config detailed visit:
 // https://github.com/alovajs/devtools

package/dist/template/presets/config/module/worma.config.js.handlebars

@@ -1,5 +1,5 @@
-import { defineConfig } from 'worma';
-import { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } from 'worma/plugin';
+import { defineConfig } from 'wormajs';
+import { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } from 'wormajs/plugin';
 
 // For more config detailed visit:
 // https://github.com/alovajs/devtools

package/dist/template/presets/config/typescript/worma.config.ts.handlebars

@@ -1,5 +1,5 @@
-import { defineConfig } from 'worma';
-import { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } from 'worma/plugin';
+import { defineConfig } from 'wormajs';
+import { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } from 'wormajs/plugin';
 
 // For more config detailed visit:
 // https://github.com/alovajs/devtools

package/dist/template/presets/fetch/common/helper.cjs.handlebars

@@ -22,6 +22,13 @@ function buildPayload(url, defaultConfig, apiName, config) {
   return { url: resolvedUrl, mergedConfig };
 }
 
+/**
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
+ */
 const setDefaultConfig = (_, configMap) => configMap;
 
 module.exports = { buildPayload, setDefaultConfig };

package/dist/template/presets/fetch/common/services/{tag}.d.cts.handlebars

@@ -1,4 +1,4 @@
-import type * as ComponentTypes from '../components';
+import type * as ComponentTypes from '../components.d.cts';
 
 {{#each tagedApis}}
 {{#each apis}}

package/dist/template/presets/fetch/module/helper.js.handlebars

@@ -22,4 +22,11 @@ export function buildPayload(url, defaultConfig, apiName, config) {
   return { url: resolvedUrl, mergedConfig };
 }
 
+/**
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
+ */
 export const setDefaultConfig = (_, configMap) => configMap;

package/dist/template/presets/ky/module/#index.js.handlebars

@@ -1,14 +1,14 @@
-{{> comment}}
-import ky from 'ky';
-
-export const kyInstance = ky.create({
-  prefix: '{{{baseUrl}}}/',
-  hooks: {
-    beforeRequest: [
-      _state => { },
-    ],
-    afterResponse: [
-      _state => { },
-    ],
-  },
-});
+{{> comment}}
+import ky from 'ky';
+
+export const kyInstance = ky.create({
+  prefix: '{{{baseUrl}}}/',
+  hooks: {
+    beforeRequest: [
+      _state => { },
+    ],
+    afterResponse: [
+      _state => { },
+    ],
+  },
+});

package/dist/template/presets/ky/module/helper.js.handlebars

@@ -24,4 +24,11 @@ export function buildPayload(url, defaultConfig, apiName, config) {
   return { url: resolvedUrl, mergedConfig };
 }
 
+/**
+ * @template {Record<string, (config: any) => any>} TagedMap
+ * @template \{{ [K in keyof TagedMap]?: Partial<Parameters<TagedMap[K]>[0]> }} ConfigMap
+ * @param {TagedMap} _ - tagged api map (unused at runtime)
+ * @param {ConfigMap} configMap - default config per api name
+ * @returns {ConfigMap}
+ */
 export const setDefaultConfig = (_, configMap) => configMap;

package/dist/template/presets/ky/typescript/#index.ts.handlebars

@@ -1,14 +1,14 @@
-{{> comment}}
-import ky from 'ky';
-
-export const kyInstance = ky.create({
-  prefix: '{{{baseUrl}}}/',
-  hooks: {
-    beforeRequest: [
-      _state => { },
-    ],
-    afterResponse: [
-      _state => { },
-    ],
-  },
-});
+{{> comment}}
+import ky from 'ky';
+
+export const kyInstance = ky.create({
+  prefix: '{{{baseUrl}}}/',
+  hooks: {
+    beforeRequest: [
+      _state => { },
+    ],
+    afterResponse: [
+      _state => { },
+    ],
+  },
+});

package/dist/tsconfig.build.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/config.ts","../src/constant.ts","../src/createConfig.ts","../src/defineConfig.ts","../src/generate.ts","../src/index.ts","../src/readConfig.ts","../src/resolveWorkspaces.ts","../src/bin/actions.ts","../src/bin/cli.ts","../src/bin/progressRenderer.ts","../src/bin/renderer.ts","../src/bin/theme.ts","../src/core/WorkerPool.ts","../src/core/loader/index.ts","../src/core/loader/astLoader/helper.ts","../src/core/loader/astLoader/index.ts","../src/core/loader/astLoader/generates/array.ts","../src/core/loader/astLoader/generates/enum.ts","../src/core/loader/astLoader/generates/group.ts","../src/core/loader/astLoader/generates/index.ts","../src/core/loader/astLoader/generates/interface.ts","../src/core/loader/astLoader/generates/simple.ts","../src/core/loader/astLoader/generates/tuple.ts","../src/core/loader/astLoader/generates/type.ts","../src/core/loader/astLoader/generates/utils.ts","../src/core/loader/astLoader/normalize/index.ts","../src/core/loader/astLoader/normalize/normalizer.ts","../src/core/loader/astLoader/normalize/rules/convertTypeArray.ts","../src/core/loader/astLoader/normalize/rules/handleEmptyType.ts","../src/core/loader/astLoader/normalize/rules/inferType.ts","../src/core/loader/astLoader/normalize/rules/mergeAnyOf.ts","../src/core/loader/astLoader/normalize/rules/normalizeCombiningKeywords.ts","../src/core/loader/astLoader/normalize/rules/normalizeEnum.ts","../src/core/loader/astLoader/normalize/rules/normalizeNullType.ts","../src/core/loader/astLoader/normalize/rules/removeRedundantKeywords.ts","../src/core/loader/astLoader/normalize/rules/simplifySingleType.ts","../src/core/loader/astLoader/normalize/rules/validateSchema.ts","../src/core/loader/astLoader/parsers/array.ts","../src/core/loader/astLoader/parsers/enum.ts","../src/core/loader/astLoader/parsers/group.ts","../src/core/loader/astLoader/parsers/index.ts","../src/core/loader/astLoader/parsers/object.ts","../src/core/loader/astLoader/parsers/reference.ts","../src/core/loader/astLoader/parsers/simple.ts","../src/core/loader/astLoader/parsers/tuple.ts","../src/core/loader/astLoader/parsers/type.ts","../src/core/loader/astLoader/parsers/utils.ts","../src/core/loader/astLoader/parsers/forward/array.ts","../src/core/loader/astLoader/parsers/forward/enum.ts","../src/core/loader/astLoader/parsers/forward/group.ts","../src/core/loader/astLoader/parsers/forward/index.ts","../src/core/loader/astLoader/parsers/forward/object.ts","../src/core/loader/astLoader/parsers/forward/tuple.ts","../src/core/loader/astLoader/parsers/forward/type.ts","../src/core/loader/callingCodeLoader/helper.ts","../src/core/loader/callingCodeLoader/index.ts","../src/core/loader/schemaLoader/index.ts","../src/core/loader/standardLoader/helper.ts","../src/core/loader/standardLoader/index.ts","../src/core/loader/standardLoader/standards.ts","../src/core/parser/index.ts","../src/core/parser/openApiParser/helper.ts","../src/core/parser/openApiParser/index.ts","../src/core/parser/templateParser/helper.ts","../src/core/parser/templateParser/index.ts","../src/core/workerPool/index.ts","../src/core/workerPool/poolManager.ts","../src/core/workerPool/swagger2Worker.ts","../src/core/workerPool/worker.ts","../src/functions/getAutoTemplateType.ts","../src/functions/getFrameworkTag.ts","../src/functions/prepareConfig.ts","../src/functions/readWormaRc.ts","../src/functions/wormaJson.ts","../src/helper/PluginDriver.ts","../src/helper/comment.ts","../src/helper/index.ts","../src/helper/progress.ts","../src/helper/config/ConfigHelper.ts","../src/helper/config/ConfigManager.ts","../src/helper/config/GeneratorHelper.ts","../src/helper/config/index.ts","../src/helper/config/type.ts","../src/helper/config/zType.ts","../src/helper/document/index.ts","../src/helper/logger/index.ts","../src/helper/template/index.ts","../src/plugins/createPlugin.ts","../src/plugins/index.ts","../src/plugins/presets/aiDoc.ts","../src/plugins/presets/apifox.ts","../src/plugins/presets/filterApi.ts","../src/plugins/presets/importType.ts","../src/plugins/presets/platform.ts","../src/plugins/presets/rename.ts","../src/plugins/presets/tagModifier.ts","../src/plugins/presets/utils.ts","../src/plugins/presets/payloadModifier/hepler.ts","../src/plugins/presets/payloadModifier/index.ts","../src/plugins/presets/payloadModifier/type.ts","../src/template/index.ts","../src/type/api.ts","../src/type/ast.ts","../src/type/base.ts","../src/type/index.ts","../src/type/lib.ts","../src/type/openapi.ts","../src/utils/base.ts","../src/utils/format.ts","../src/utils/index.ts","../src/utils/openapi.ts","../src/utils/readPackageJson.ts","../src/utils/template.ts"],"version":"5.9.3"}
+{"root":["../src/config.ts","../src/constant.ts","../src/createConfig.ts","../src/defineConfig.ts","../src/generate.ts","../src/index.ts","../src/readConfig.ts","../src/resolveWorkspaces.ts","../src/bin/actions.ts","../src/bin/cli.ts","../src/bin/progressRenderer.ts","../src/bin/renderer.ts","../src/bin/theme.ts","../src/core/WorkerPool.ts","../src/core/loader/index.ts","../src/core/loader/astLoader/helper.ts","../src/core/loader/astLoader/index.ts","../src/core/loader/astLoader/generates/array.ts","../src/core/loader/astLoader/generates/enum.ts","../src/core/loader/astLoader/generates/group.ts","../src/core/loader/astLoader/generates/index.ts","../src/core/loader/astLoader/generates/interface.ts","../src/core/loader/astLoader/generates/simple.ts","../src/core/loader/astLoader/generates/tuple.ts","../src/core/loader/astLoader/generates/type.ts","../src/core/loader/astLoader/generates/utils.ts","../src/core/loader/astLoader/normalize/index.ts","../src/core/loader/astLoader/normalize/normalizer.ts","../src/core/loader/astLoader/normalize/rules/convertTypeArray.ts","../src/core/loader/astLoader/normalize/rules/handleEmptyType.ts","../src/core/loader/astLoader/normalize/rules/inferType.ts","../src/core/loader/astLoader/normalize/rules/mergeAnyOf.ts","../src/core/loader/astLoader/normalize/rules/normalizeCombiningKeywords.ts","../src/core/loader/astLoader/normalize/rules/normalizeEnum.ts","../src/core/loader/astLoader/normalize/rules/normalizeNullType.ts","../src/core/loader/astLoader/normalize/rules/removeRedundantKeywords.ts","../src/core/loader/astLoader/normalize/rules/simplifySingleType.ts","../src/core/loader/astLoader/normalize/rules/validateSchema.ts","../src/core/loader/astLoader/parsers/array.ts","../src/core/loader/astLoader/parsers/const.ts","../src/core/loader/astLoader/parsers/enum.ts","../src/core/loader/astLoader/parsers/group.ts","../src/core/loader/astLoader/parsers/index.ts","../src/core/loader/astLoader/parsers/object.ts","../src/core/loader/astLoader/parsers/reference.ts","../src/core/loader/astLoader/parsers/simple.ts","../src/core/loader/astLoader/parsers/tuple.ts","../src/core/loader/astLoader/parsers/type.ts","../src/core/loader/astLoader/parsers/utils.ts","../src/core/loader/astLoader/parsers/forward/array.ts","../src/core/loader/astLoader/parsers/forward/const.ts","../src/core/loader/astLoader/parsers/forward/enum.ts","../src/core/loader/astLoader/parsers/forward/group.ts","../src/core/loader/astLoader/parsers/forward/index.ts","../src/core/loader/astLoader/parsers/forward/object.ts","../src/core/loader/astLoader/parsers/forward/tuple.ts","../src/core/loader/astLoader/parsers/forward/type.ts","../src/core/loader/callingCodeLoader/helper.ts","../src/core/loader/callingCodeLoader/index.ts","../src/core/loader/schemaLoader/index.ts","../src/core/loader/standardLoader/helper.ts","../src/core/loader/standardLoader/index.ts","../src/core/loader/standardLoader/standards.ts","../src/core/parser/index.ts","../src/core/parser/openApiParser/helper.ts","../src/core/parser/openApiParser/index.ts","../src/core/parser/templateParser/helper.ts","../src/core/parser/templateParser/index.ts","../src/core/workerPool/index.ts","../src/core/workerPool/poolManager.ts","../src/core/workerPool/swagger2Worker.ts","../src/core/workerPool/worker.ts","../src/functions/getAutoTemplateType.ts","../src/functions/getFrameworkTag.ts","../src/functions/prepareConfig.ts","../src/functions/readWormaRc.ts","../src/functions/wormaJson.ts","../src/helper/PluginDriver.ts","../src/helper/comment.ts","../src/helper/index.ts","../src/helper/progress.ts","../src/helper/config/ConfigHelper.ts","../src/helper/config/ConfigManager.ts","../src/helper/config/GeneratorHelper.ts","../src/helper/config/index.ts","../src/helper/config/type.ts","../src/helper/config/zType.ts","../src/helper/document/index.ts","../src/helper/logger/index.ts","../src/helper/template/index.ts","../src/plugins/createPlugin.ts","../src/plugins/index.ts","../src/plugins/presets/aiDoc.ts","../src/plugins/presets/apifox.ts","../src/plugins/presets/filterApi.ts","../src/plugins/presets/importType.ts","../src/plugins/presets/platform.ts","../src/plugins/presets/rename.ts","../src/plugins/presets/tagModifier.ts","../src/plugins/presets/utils.ts","../src/plugins/presets/payloadModifier/hepler.ts","../src/plugins/presets/payloadModifier/index.ts","../src/plugins/presets/payloadModifier/type.ts","../src/template/index.ts","../src/type/api.ts","../src/type/ast.ts","../src/type/base.ts","../src/type/index.ts","../src/type/lib.ts","../src/type/openapi.ts","../src/utils/base.ts","../src/utils/format.ts","../src/utils/index.ts","../src/utils/openapi.ts","../src/utils/readPackageJson.ts","../src/utils/template.ts"],"version":"5.9.3"}

package/dist/utils/base.js

@@ -118,13 +118,13 @@ async function resolveConfigFile(projectPath) {
     for (const ext of extensions) {
         const configFile = node_path_1.default.join(projectPath, `worma.config.${ext}`);
         if (await existsPromise(configFile)) {
-            return configFile;
+            return configFile.replace(/\\/g, '/');
         }
     }
     // Fallback to .wormarc if no worma.config.* found
     const rcFile = node_path_1.default.join(projectPath, '.wormarc');
     if (await existsPromise(rcFile)) {
-        return rcFile;
+        return rcFile.replace(/\\/g, '/');
     }
     return null;
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "wormajs",
-  "version": "0.0.1",
+  "version": "0.0.2-beta.1",
   "description": "A modern OpenAPI code generator - Generate type-safe API clients from OpenAPI specs",
-  "author": "alova",
+  "author": "worma",
   "license": "MIT",
   "homepage": "https://github.com/alovajs/devtools",
   "repository": {
@@ -37,7 +37,8 @@
   "main": "./dist/index.js",
   "types": "./typings/index.d.ts",
   "bin": {
-    "worma": "dist/bin/cli.js"
+    "worma": "dist/bin/cli.js",
+    "wormajs": "dist/bin/cli.js"
   },
   "files": [
     "dist",

package/typings/plugins.d.ts

@@ -604,7 +604,7 @@ export type PlatformType = "swagger" | "knife4j" | "fastapi" | "yapi";
  *
  * @example
  * ```ts
- * import { platform, alovaGlobals } from 'worma/plugin';
+ * import { platform, alovaGlobals } from 'wormajs/plugin';
  *
  * defineConfig({
  *   generator: [{