wormajs 0.0.2-beta.3 → 0.1.0

package/dist/constant.js

@@ -26,6 +26,7 @@ var PlatformTypeEnum;
 (function (PlatformTypeEnum) {
     PlatformTypeEnum["SWAGGER"] = "swagger";
     PlatformTypeEnum["KNIFE4J"] = "knife4j";
+    PlatformTypeEnum["FASTAPI"] = "fastapi";
     PlatformTypeEnum["YAPI"] = "yapi";
 })(PlatformTypeEnum || (exports.PlatformTypeEnum = PlatformTypeEnum = {}));
 /** 模块体系类型 */
@@ -77,6 +78,7 @@ var RenameScope;
     RenameScope["DATA"] = "data";
     RenameScope["RESPONSE"] = "response";
     RenameScope["REF_NAME"] = "refName";
+    RenameScope["NAME"] = "name";
 })(RenameScope || (exports.RenameScope = RenameScope = {}));
 /** 过滤 scope 类型 */
 var FilterScope;
@@ -102,7 +104,10 @@ var PluginName;
     PluginName["IMPORT_TYPE"] = "importType";
     PluginName["AI_DOC"] = "aiDoc";
     PluginName["APIFOX"] = "apifox";
-    PluginName["PLATFORM"] = "platform";
+    PluginName["SWAGGER"] = "swagger";
+    PluginName["KNIFE4J"] = "knife4j";
+    PluginName["FASTAPI"] = "fastapi";
+    PluginName["YAPI"] = "yapi";
     PluginName["TEMPLATE_ALOVA"] = "templateAlova";
     PluginName["TEMPLATE_ALOVA_GLOBALS"] = "templateAlovaGlobals";
     PluginName["TEMPLATE_AXIOS"] = "templateAxios";

package/dist/plugins/index.js

@@ -14,14 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ky = exports.config = exports.axios = exports.alovaGlobals = exports.alova = void 0;
+exports.ky = exports.config = exports.axios = exports.alovaGlobals = exports.alova = exports.yapi = exports.swagger = exports.knife4j = exports.fastapi = void 0;
 __exportStar(require("./createPlugin"), exports);
 __exportStar(require("./presets/aiDoc"), exports);
 __exportStar(require("./presets/apifox"), exports);
 __exportStar(require("./presets/filterApi"), exports);
 __exportStar(require("./presets/importType"), exports);
 __exportStar(require("./presets/payloadModifier"), exports);
-__exportStar(require("./presets/platform"), exports);
+var platform_1 = require("./presets/platform");
+Object.defineProperty(exports, "fastapi", { enumerable: true, get: function () { return platform_1.fastapi; } });
+Object.defineProperty(exports, "knife4j", { enumerable: true, get: function () { return platform_1.knife4j; } });
+Object.defineProperty(exports, "swagger", { enumerable: true, get: function () { return platform_1.swagger; } });
+Object.defineProperty(exports, "yapi", { enumerable: true, get: function () { return platform_1.yapi; } });
 __exportStar(require("./presets/rename"), exports);
 __exportStar(require("./presets/tagModifier"), exports);
 // Template preset plugins

package/dist/plugins/presets/platform/fastapi.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fastapi = void 0;
+const constant_1 = require("../../../constant");
+const shared_1 = require("./shared");
+/**
+ * FastAPI platform plugin.
+ *
+ * Pass the base URL of your FastAPI app; the plugin will try `/openapi.json`
+ * first, then fall back to the bare base URL.
+ *
+ * @param input - base URL string, or an array of base URLs
+ *
+ * @example
+ * ```ts
+ * plugins: [fastapi('http://fastapi-example.dokkuapp.com'), alovaGlobals()]
+ * ```
+ */
+exports.fastapi = (0, shared_1.defineUrlPlatformPlugin)(constant_1.PluginName.FASTAPI, base => [
+    `${base}/openapi.json`,
+    base,
+]);

package/dist/plugins/presets/platform/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yapi = exports.swagger = exports.withCookie = exports.normalizeBase = exports.defineUrlPlatformPlugin = exports.knife4j = exports.fastapi = void 0;
+var fastapi_1 = require("./fastapi");
+Object.defineProperty(exports, "fastapi", { enumerable: true, get: function () { return fastapi_1.fastapi; } });
+var knife4j_1 = require("./knife4j");
+Object.defineProperty(exports, "knife4j", { enumerable: true, get: function () { return knife4j_1.knife4j; } });
+var shared_1 = require("./shared");
+Object.defineProperty(exports, "defineUrlPlatformPlugin", { enumerable: true, get: function () { return shared_1.defineUrlPlatformPlugin; } });
+Object.defineProperty(exports, "normalizeBase", { enumerable: true, get: function () { return shared_1.normalizeBase; } });
+Object.defineProperty(exports, "withCookie", { enumerable: true, get: function () { return shared_1.withCookie; } });
+var swagger_1 = require("./swagger");
+Object.defineProperty(exports, "swagger", { enumerable: true, get: function () { return swagger_1.swagger; } });
+var yapi_1 = require("./yapi");
+Object.defineProperty(exports, "yapi", { enumerable: true, get: function () { return yapi_1.yapi; } });

package/dist/plugins/presets/platform/knife4j.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.knife4j = void 0;
+const constant_1 = require("../../../constant");
+const shared_1 = require("./shared");
+/**
+ * Knife4j platform plugin.
+ *
+ * Pass the base URL of your Knife4j instance; the plugin will try the OAS3
+ * endpoint (springdoc) first, then the Swagger2 endpoint (springfox), then the
+ * bare base URL.
+ *
+ * @param input - base URL string, or an array of base URLs
+ *
+ * @example
+ * ```ts
+ * plugins: [knife4j('https://openapi3.demo.knife4jnext.com'), alovaGlobals()]
+ * ```
+ */
+exports.knife4j = (0, shared_1.defineUrlPlatformPlugin)(constant_1.PluginName.KNIFE4J, base => [
+    `${base}/v3/api-docs`,
+    `${base}/v2/api-docs`,
+    base,
+]);

package/dist/plugins/presets/platform/shared.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeBase = normalizeBase;
+exports.defineUrlPlatformPlugin = defineUrlPlatformPlugin;
+exports.withCookie = withCookie;
+/** Remove trailing slashes from a base URL */
+function normalizeBase(baseUrl) {
+    while (baseUrl.endsWith('/')) {
+        baseUrl = baseUrl.slice(0, -1);
+    }
+    return baseUrl;
+}
+/**
+ * Factory for "URL-constructing" platform plugins.
+ *
+ * Unlike the old `platform()` helper, the platform base URL(s) are supplied as
+ * the plugin's own argument (e.g. `swagger('https://petstore.swagger.io')`)
+ * rather than being read from `config.input`. The plugin writes the resolved
+ * candidate URLs into `config.input` inside its `config` hook, so downstream
+ * fetching (which tries each URL in order and keeps the first success) works
+ * unchanged.
+ */
+function defineUrlPlatformPlugin(name, buildUrls) {
+    return (input) => {
+        const inputs = Array.isArray(input) ? [...new Set(input)] : [input];
+        return {
+            name,
+            config({ config }) {
+                config.input = inputs.flatMap(url => buildUrls(normalizeBase(String(url))));
+                return config;
+            },
+        };
+    };
+}
+/** Merge a cookie into config.fetchOptions.headers */
+function withCookie(config, cookie) {
+    config.fetchOptions = {
+        ...config.fetchOptions,
+        headers: {
+            ...config.fetchOptions?.headers,
+            cookie,
+        },
+    };
+    return config;
+}

package/dist/plugins/presets/platform/swagger.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swagger = void 0;
+const constant_1 = require("../../../constant");
+const shared_1 = require("./shared");
+/**
+ * Swagger platform plugin.
+ *
+ * Pass the base URL of your Swagger UI / server; the plugin will try several
+ * common OpenAPI document endpoints (OAS3 first, then Swagger2, then the bare
+ * base URL) and let the framework pick the first one that responds.
+ *
+ * @param input - base URL string, or an array of base URLs
+ *
+ * @example
+ * ```ts
+ * import { swagger, alovaGlobals } from 'wormajs/plugin';
+ *
+ * defineConfig({
+ *   generator: [{
+ *     plugins: [swagger('https://petstore3.swagger.io'), alovaGlobals()],
+ *     output: './src/api',
+ *   }]
+ * });
+ * ```
+ */
+exports.swagger = (0, shared_1.defineUrlPlatformPlugin)(constant_1.PluginName.SWAGGER, base => [
+    `${base}/openapi.json`,
+    `${base}/v2/swagger.json`,
+    `${base}/api/v3/openapi.json`,
+    base,
+]);

package/dist/plugins/presets/platform/yapi.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.yapi = yapi;
+const constant_1 = require("../../../constant");
+const shared_1 = require("./shared");
+/**
+ * YApi platform plugin.
+ *
+ * YApi projects are private, so the OpenAPI document must be exported through
+ * YApi's own export endpoint, authenticated with your login cookie. The plugin
+ * builds the export URL from the server base URL (`url`) plus the required
+ * `pid` and the optional `type` / `status` / `isWiki` query params (which
+ * default to `OpenAPIV2`, `all`, and `true` respectively).
+ *
+ * `url`, `pid` and `cookie` are required — the plugin throws a clear error when
+ * any is missing.
+ *
+ * @param options - `{ url, pid, cookie?, type?, status?, isWiki?, timeout? }`
+ *
+ * @example
+ * ```ts
+ * import { yapi, alovaGlobals } from 'wormajs/plugin';
+ *
+ * defineConfig({
+ *   generator: [{
+ *     plugins: [
+ *       yapi({
+ *         url: 'https://yapi.xxx.com',
+ *         pid: 123,
+ *         cookie: '_yapi_token=xxx; _yapi_uid=yyy',
+ *       }),
+ *       alovaGlobals(),
+ *     ],
+ *     output: './src/api',
+ *   }]
+ * });
+ * ```
+ */
+function yapi(options) {
+    return {
+        name: constant_1.PluginName.YAPI,
+        async config({ config }) {
+            const baseUrl = options.url;
+            if (!baseUrl) {
+                throw new Error('[yapi] `url` is required — the YApi server base URL '
+                    + '(e.g. yapi({ url: "https://yapi.xxx.com", pid: 123, cookie: "..." })).');
+            }
+            const pid = options.pid;
+            if (pid == null) {
+                throw new Error('[yapi] `pid` is required — the YApi project id used to build the export URL '
+                    + '(e.g. yapi({ url: "https://yapi.xxx.com", pid: 123, cookie: "..." })).');
+            }
+            const cookie = options.cookie ?? config.fetchOptions?.headers?.cookie;
+            if (!cookie) {
+                throw new Error('[yapi] `cookie` is required. YApi projects are private, so the export '
+                    + 'endpoint needs your login cookie to fetch the OpenAPI document.\n'
+                    + '  e.g. yapi({ url: "https://yapi.xxx.com", pid: 123, cookie: "_yapi_token=xxx; ..." })');
+            }
+            const type = options.type ?? 'OpenAPIV2';
+            const status = options.status ?? 'all';
+            const isWiki = options.isWiki ?? true;
+            const base = (0, shared_1.normalizeBase)(baseUrl);
+            config.input = `${base}/api/plugin/exportSwagger`
+                + `?type=${encodeURIComponent(type)}`
+                + `&pid=${encodeURIComponent(String(pid))}`
+                + `&status=${encodeURIComponent(status)}`
+                + `&isWiki=${isWiki}`;
+            (0, shared_1.withCookie)(config, cookie);
+            if (options.timeout != null) {
+                config.fetchOptions = { ...config.fetchOptions, timeout: options.timeout };
+            }
+            return config;
+        },
+    };
+}

package/dist/plugins/presets/rename.js

@@ -27,8 +27,12 @@ function toPascalCase(str) {
  * Applies renaming rules to the specified value
  * @returns The renamed value, or original value if not matched
  */
-function applyRenameRule(value, config, apiDescriptor) {
-    if (!(0, utils_1.isMatch)(value, config.match)) {
+function applyRenameRule(value, config, apiDescriptor, level = 0) {
+    // Skip non-string values (e.g. a missing or empty operationId) to avoid runtime errors
+    if (typeof value !== 'string') {
+        return value;
+    }
+    if (!(0, utils_1.isMatch)(value, config.match, level)) {
         return value;
     }
     if (config.transform) {
@@ -38,7 +42,7 @@ function applyRenameRule(value, config, apiDescriptor) {
         return value;
     }
     if (config.style === 'kebabCase' && config.scope === 'refName') {
-        throw new Error(`Invalid rename style: ${config.style}、${config.scope}`);
+        throw new Error(`Invalid rename style: ${config.style}, ${config.scope}`);
     }
     switch (config.style) {
         case 'camelCase':
@@ -53,6 +57,59 @@ function applyRenameRule(value, config, apiDescriptor) {
             throw new Error(`Invalid rename style: ${config.style}`);
     }
 }
+/**
+ * Validates that no duplicate names exist after renaming.
+ * Throws an error with details if duplicates are found within the same scope.
+ *
+ * @param names the renamed names to check for duplicates
+ * @param scopeLabel used to identify the scope in the error message
+ * @param apiDescriptor the API descriptor the names belong to
+ * @param originalNames optional, the original keys before renaming (same order
+ *   as `names`). When provided, the error message also lists which original keys
+ *   were mapped to each duplicated name, making the conflict easier to locate.
+ */
+function assertNoDuplicates(names, scopeLabel, apiDescriptor, originalNames) {
+    if (!names || names.length === 0)
+        return;
+    const counts = new Map();
+    for (const name of names) {
+        counts.set(name, (counts.get(name) ?? 0) + 1);
+    }
+    const duplicates = [...counts.entries()]
+        .filter(([, count]) => count > 1)
+        .map(([name]) => name);
+    if (duplicates.length === 0)
+        return;
+    // When original keys are available, group them by the duplicated (renamed) name
+    // so users can see exactly which keys collided.
+    let detail = '';
+    if (originalNames && originalNames.length === names.length) {
+        const grouped = new Map();
+        for (let i = 0; i < names.length; i++) {
+            if (duplicates.includes(names[i])) {
+                const list = grouped.get(names[i]) ?? [];
+                list.push(originalNames[i]);
+                grouped.set(names[i], list);
+            }
+        }
+        detail = [...grouped.entries()]
+            .map(([renamed, originals]) => `    ${renamed} <- [${originals.join(', ')}]`)
+            .join('\n');
+    }
+    else {
+        detail = `    ${duplicates.join(', ')}`;
+    }
+    const method = apiDescriptor.method ? String(apiDescriptor.method).toUpperCase() : '';
+    const url = apiDescriptor.url ?? '';
+    throw new Error(`[rename] Duplicate names found after renaming (scope=${scopeLabel}):\n`
+        + `  Conflicting (renamed) keys and their original keys:\n`
+        + `${detail}\n`
+        + `  Reason: different original names were mapped to the same name after `
+        + `match/transform/style processing, which would cause naming conflicts or `
+        + `missing references in the generated code.\n`
+        + `  Please adjust the rename config to avoid mapping multiple names to the same result.\n`
+        + `  API: ${method} ${url}`);
+}
 /**
  * renames URL path by processing each segment individually
  * while keeping path parameter placeholders
@@ -65,27 +122,72 @@ function renameUrl(url, config, apiDescriptor) {
         if ((segment.startsWith('{') && segment.endsWith('}')) || !segment) {
             return segment;
         }
-        return applyRenameRule(segment, config, apiDescriptor);
+        return applyRenameRule(segment, config, apiDescriptor, 0);
     })
         .join('/')
         .replace(/^\/{2,}/g, '/');
 }
 /**
- * Transforms object properties using the renaming rules
+ * Recursively processes a schema (supports nested objects and arrays),
+ * applying property renaming to nested objects.
+ * @param schema current schema
+ * @param level current nesting level (starts from 0)
+ * @param scopeLabel used to identify the scope in duplicate-name errors
+ */
+function transformSchema(schema, config, apiDescriptor, level, scopeLabel) {
+    if (!schema || typeof schema !== 'object')
+        return schema;
+    // Nested object: recursively process its properties
+    if ('properties' in schema && schema.properties) {
+        return transformProperties(schema, config, apiDescriptor, level, scopeLabel);
+    }
+    // Array: recursively process items (supports a single schema or an array of schemas)
+    if (schema.items && typeof schema.items === 'object') {
+        if (Array.isArray(schema.items)) {
+            return {
+                ...schema,
+                items: schema.items.map((item) => transformSchema(item, config, apiDescriptor, level, scopeLabel)),
+            };
+        }
+        return {
+            ...schema,
+            items: transformSchema(schema.items, config, apiDescriptor, level, scopeLabel),
+        };
+    }
+    return schema;
+}
+/**
+ * Transforms object properties using the renaming rules (supports deep recursive renaming)
+ * @param level current nesting level (starts from 0), passed through to the match function
+ * @param scopeLabel used to identify the scope in duplicate-name errors
  */
-function transformProperties(obj, config, apiDescriptor) {
-    if (!obj || typeof obj !== 'object' || !('properties' in obj)) {
+function transformProperties(obj, config, apiDescriptor, level = 0, scopeLabel = config.scope ?? 'data') {
+    if (!obj || typeof obj !== 'object' || !('properties' in obj) || !obj.properties) {
         return obj;
     }
-    const properties = { ...obj.properties };
+    const properties = obj.properties;
     const newProperties = {};
+    const newKeys = [];
+    // Record the oldKey -> newKey mapping, used to keep the same-level required array in sync
+    const keyMap = new Map();
     for (const key in properties) {
-        const newKey = applyRenameRule(key, config, apiDescriptor);
-        newProperties[newKey] = properties[key];
+        const newKey = applyRenameRule(key, config, apiDescriptor, level);
+        newKeys.push(newKey);
+        keyMap.set(key, newKey);
+        newProperties[newKey] = transformSchema(properties[key], config, apiDescriptor, level + 1, scopeLabel);
+    }
+    // Duplicate property names within the same object level would overwrite each other, so report an error
+    assertNoDuplicates(newKeys, scopeLabel, apiDescriptor, Object.keys(properties));
+    // Keep the required array of the current level in sync with the renamed property names;
+    // otherwise the generator would crash during normalization because required references a non-existent property
+    let newRequired = obj.required;
+    if (Array.isArray(newRequired)) {
+        newRequired = newRequired.map((r) => keyMap.get(r) ?? r);
     }
     return {
         ...obj,
         properties: newProperties,
+        ...(newRequired !== obj.required ? { required: newRequired } : {}),
     };
 }
 /**
@@ -99,7 +201,7 @@ function transformParameters(parameters, type, config, apiDescriptor) {
         if (param.in === type) {
             return {
                 ...param,
-                name: applyRenameRule(param.name, config, apiDescriptor),
+                name: applyRenameRule(param.name, config, apiDescriptor, 0),
             };
         }
         return param;
@@ -110,10 +212,14 @@ function transformRefNameMap(refNameMap, config, apiDescriptor) {
         return refNameMap;
     }
     const newRefNameMap = {};
+    const newValues = [];
     for (const key in refNameMap) {
-        const newValue = applyRenameRule(refNameMap[key], config, apiDescriptor);
+        const newValue = applyRenameRule(refNameMap[key], config, apiDescriptor, 0);
+        newValues.push(newValue);
         newRefNameMap[key] = newValue;
     }
+    // Different $refs mapping to the same type name would generate duplicate interfaces, so report an error
+    assertNoDuplicates(newValues, 'refName', apiDescriptor, Object.keys(refNameMap));
     return newRefNameMap;
 }
 /**
@@ -125,6 +231,7 @@ function transformRefNameMap(refNameMap, config, apiDescriptor) {
  * - pathParams: Renames path parameters and their placeholders in URL
  * - data: Renames request body properties
  * - response: Renames response body properties
+ * - name: Renames the generated API function name (operationId)
  */
 function renameApiDescriptor(apiDescriptor, config) {
     if (!apiDescriptor)
@@ -134,33 +241,49 @@ function renameApiDescriptor(apiDescriptor, config) {
     switch (scope) {
         case constant_1.RenameScope.PARAMS:
             if (newDescriptor.parameters) {
+                const originalParams = newDescriptor.parameters.filter(p => p.in === constant_1.ParameterIn.QUERY).map(p => p.name);
                 newDescriptor.parameters = transformParameters(newDescriptor.parameters, constant_1.ParameterIn.QUERY, config, apiDescriptor);
+                // Duplicate query parameter names would be indistinguishable when calling the API, so report an error
+                assertNoDuplicates(newDescriptor.parameters.filter(p => p.in === constant_1.ParameterIn.QUERY).map(p => p.name), 'params', apiDescriptor, originalParams);
             }
             break;
         case constant_1.RenameScope.PATH_PARAMS:
             if (newDescriptor.parameters) {
+                const originalParams = newDescriptor.parameters.filter(p => p.in === constant_1.ParameterIn.PATH).map(p => p.name);
                 newDescriptor.parameters = transformParameters(newDescriptor.parameters, constant_1.ParameterIn.PATH, config, apiDescriptor);
-            }
-            if (newDescriptor.url) {
-                newDescriptor.url = newDescriptor.url.replace(/\{([^}]+)\}/g, (match, paramName) => {
-                    const newName = applyRenameRule(paramName, config, apiDescriptor);
-                    return `{${newName}}`;
-                });
+                if (newDescriptor.url) {
+                    newDescriptor.url = newDescriptor.url.replace(/\{([^}]+)\}/g, (match, paramName) => {
+                        const newName = applyRenameRule(paramName, config, apiDescriptor, 0);
+                        return `{${newName}}`;
+                    });
+                }
+                // Duplicate path parameter names would make URL placeholders no longer match the parameters, so report an error
+                assertNoDuplicates((newDescriptor.parameters ?? []).filter(p => p.in === constant_1.ParameterIn.PATH).map(p => p.name), 'pathParams', apiDescriptor, originalParams);
             }
             break;
         case constant_1.RenameScope.DATA:
             if (newDescriptor.requestBody) {
-                newDescriptor.requestBody = transformProperties(newDescriptor.requestBody, config, apiDescriptor);
+                newDescriptor.requestBody = transformProperties(newDescriptor.requestBody, config, apiDescriptor, 0, 'data');
             }
             break;
         case constant_1.RenameScope.RESPONSE:
             if (newDescriptor.responses) {
-                newDescriptor.responses = transformProperties(newDescriptor.responses, config, apiDescriptor);
+                newDescriptor.responses = transformProperties(newDescriptor.responses, config, apiDescriptor, 0, 'response');
             }
             break;
         case constant_1.RenameScope.URL:
             if (newDescriptor.url) {
+                const originalUrlNames = newDescriptor.url
+                    .split('/')
+                    .filter(Boolean)
+                    .map(segment => (segment.startsWith('{') && segment.endsWith('}') ? segment.slice(1, -1) : segment));
                 newDescriptor.url = renameUrl(newDescriptor.url, config, apiDescriptor);
+                // Duplicate path segments would make the URL unable to distinguish different resources, so report an error
+                const urlNames = newDescriptor.url
+                    .split('/')
+                    .filter(Boolean)
+                    .map(segment => (segment.startsWith('{') && segment.endsWith('}') ? segment.slice(1, -1) : segment));
+                assertNoDuplicates(urlNames, 'url', apiDescriptor, originalUrlNames);
             }
             break;
         case constant_1.RenameScope.REF_NAME:
@@ -168,6 +291,11 @@ function renameApiDescriptor(apiDescriptor, config) {
                 newDescriptor.refNameMap = transformRefNameMap(newDescriptor.refNameMap, config, apiDescriptor);
             }
             break;
+        case constant_1.RenameScope.NAME:
+            if (newDescriptor.operationId != null) {
+                newDescriptor.operationId = applyRenameRule(newDescriptor.operationId, config, apiDescriptor, 0);
+            }
+            break;
         default:
             // No action needed, keep original descriptor
             break;
@@ -185,7 +313,7 @@ function rename(config) {
             throw new Error('at least one of `style` or `transform` is required');
         }
         if (conf.style === 'kebabCase' && conf.scope === 'refName') {
-            throw new Error(`Invalid rename style: ${conf.style}、${conf.scope}`);
+            throw new Error(`Invalid rename style: ${conf.style}, ${conf.scope}`);
         }
     }
     return {

package/dist/plugins/presets/utils.js

@@ -4,23 +4,24 @@ exports.extend = extend;
 exports.isMatch = isMatch;
 const prepareConfig_1 = require("../../functions/prepareConfig");
 /**
- * 扩展生成器配置：
- * 根据传入的 newConfig（对象或函数）与基础 config 生成合并后的配置。
- * 当未提供 newConfig 时，直接回退到原始 config。
- * @param config 基础配置
- * @param newConfig 需要扩展的配置或用于生成扩展配置的函数
- * @returns 合并且标准化后的配置
+ * Extends the generator configuration:
+ * merges the provided newConfig (object or function) with the base config to produce the merged config.
+ * When newConfig is not provided, falls back to the original config.
+ * @param config base configuration
+ * @param newConfig config to merge, or a function that produces the merged config
+ * @returns the merged and normalized configuration
  */
 function extend(config, newConfig) {
-    // 根据 newConfig 类型计算扩展配置：函数则调用生成配置，否则直接使用对象；未提供则回退到原始 config
+    // Compute the extension config based on newConfig's type: call it if it's a function,
+    // otherwise use it directly; fall back to the original config if not provided
     const pluginExtendsConfig = typeof newConfig === 'function' ? newConfig(config) : (newConfig ?? config);
-    // 使用 extendsConfig 进行配置合并与标准化，确保最终结构满足生成器需求
+    // Use extendsConfig to merge and normalize, ensuring the final structure meets the generator's requirements
     return (0, prepareConfig_1.extendsConfig)(config, pluginExtendsConfig);
 }
 /**
  * Tests if value matches the specified rule
  */
-function isMatch(value, match) {
+function isMatch(value, match, level = 0) {
     if (!match)
         return true;
     if (typeof match === 'string') {
@@ -30,7 +31,7 @@ function isMatch(value, match) {
         return match.test(value);
     }
     if (typeof match === 'function') {
-        return match(value);
+        return match(value, level);
     }
     return false;
 }

package/dist/template/index.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPresetTemplatePath = getPresetTemplatePath;
-exports.registerProcessTypeHelper = registerProcessTypeHelper;
 exports.config = config;
 exports.alovaGlobals = alovaGlobals;
 exports.alova = alova;
@@ -21,27 +20,6 @@ function getPresetTemplatePath(presetName) {
     // 编译后在 dist/template/presets 目录
     return node_path_1.default.join(__dirname, 'presets', presetName);
 }
-/**
- * Register processType helper on an hbs instance.
- *
- * Scans the type string for every PascalCase identifier that is in componentNames
- * (and not already prefixed with "ComponentTypes.") and prefixes it.
- * Works uniformly for top-level names, generics, object literals, and arrays.
- */
-function registerProcessTypeHelper(hbs) {
-    hbs.registerHelper('processType', (_typeStr, _componentNames) => {
-        const typeStr = _typeStr;
-        const componentNames = _componentNames;
-        if (!typeStr || !Array.isArray(componentNames) || componentNames.length === 0) {
-            return new hbs.SafeString(typeStr || 'unknown');
-        }
-        const componentSet = new Set(componentNames);
-        const result = typeStr.replace(/(?<!ComponentTypes\.)(\b[A-Z]\w*\b)/g, (match) => {
-            return componentSet.has(match) ? `ComponentTypes.${match}` : match;
-        });
-        return new hbs.SafeString(result);
-    });
-}
 // ========== Template Preset Plugins ==========
 /**
  * worma.config 模板预设 - plugin mode
@@ -100,9 +78,6 @@ function alova(opts) {
         getTemplate() {
             return { path: getPresetTemplatePath(constant_1.PresetTemplateName.ALOVA) };
         },
-        onHandlebarsCreated({ hbs }) {
-            registerProcessTypeHelper(hbs);
-        },
         beforeCodeGenerate({ data }) {
             data.config = {
                 ...data.config,
@@ -122,9 +97,6 @@ function axios(opts) {
         getTemplate() {
             return { path: getPresetTemplatePath(constant_1.PresetTemplateName.AXIOS) };
         },
-        onHandlebarsCreated({ hbs }) {
-            registerProcessTypeHelper(hbs);
-        },
         beforeCodeGenerate({ data }) {
             data.config = {
                 ...data.config,
@@ -144,9 +116,6 @@ function fetch(opts) {
         getTemplate() {
             return { path: getPresetTemplatePath(constant_1.PresetTemplateName.FETCH) };
         },
-        onHandlebarsCreated({ hbs }) {
-            registerProcessTypeHelper(hbs);
-        },
         beforeCodeGenerate({ data }) {
             data.config = {
                 ...data.config,
@@ -166,9 +135,6 @@ function ky(opts) {
         getTemplate() {
             return { path: getPresetTemplatePath(constant_1.PresetTemplateName.KY) };
         },
-        onHandlebarsCreated({ hbs }) {
-            registerProcessTypeHelper(hbs);
-        },
         beforeCodeGenerate({ data }) {
             data.config = {
                 ...data.config,

package/dist/template/presets/alova/partials/dts-extra-config.handlebars

@@ -1,8 +1,8 @@
 {{#or pathParameters queryParameters requestBody}}
 type {{{name}}}ExtraConfig = {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}params: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}data: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}params: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}data: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 };
 {{/or}}

package/dist/template/presets/alova/partials/dts-fn-declare.handlebars

@@ -1 +1 @@
-export declare function {{{name}}}<Config extends Alova2MethodConfig<{{processType response @root.componentNames}}> & {{{name}}}ExtraConfig>(config: Config): Alova2Method<ExtractResponded<Config, '{{{name}}}', {{processType response @root.componentNames}}>>;
+export declare function {{{name}}}<Config extends Alova2MethodConfig<{{addNamespace response @root.componentNames}}> & {{{name}}}ExtraConfig>(config: Config): Alova2Method<ExtractResponded<Config, '{{{name}}}', {{addNamespace response @root.componentNames}}>>;

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

@@ -12,15 +12,15 @@ import type * as ComponentTypes from '../components';
 {{#each apis}}
 
 interface {{{name}}}ExtraConfig {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}params: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}data: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}params: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}data: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 }
 {{> api-jsdoc}}
-export function {{{name}}}<Config extends Alova2MethodConfig<{{processType response @root.componentNames}}> & {{{name}}}ExtraConfig>(config: Config): Alova2Method<ExtractResponded<Config, '{{{name}}}', {{processType response @root.componentNames}}>> {
+export function {{{name}}}<Config extends Alova2MethodConfig<{{addNamespace response @root.componentNames}}> & {{{name}}}ExtraConfig>(config: Config): Alova2Method<ExtractResponded<Config, '{{{name}}}', {{addNamespace response @root.componentNames}}>> {
   const { url, data, mergedConfig } = buildPayload('{{{path}}}', {{{tag}}}DefaultConfig, {{{name}}}.name, config);
-  return alovaInstance.Request<ExtractResponded<Config, '{{{name}}}', {{processType response @root.componentNames}}>>({
+  return alovaInstance.Request<ExtractResponded<Config, '{{{name}}}', {{addNamespace response @root.componentNames}}>>({
     ...mergedConfig,
     url,
     data,

package/dist/template/presets/axios/partials/dts-types.handlebars

@@ -1,7 +1,7 @@
-type {{{name}}}Response = {{processType response @root.componentNames}};
+type {{{name}}}Response = {{addNamespace response @root.componentNames}};
 type {{{name}}}ExtraConfig = Omit<AxiosRequestConfig, 'data' | 'params'> & {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}params: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}data: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}params: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}data: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 };

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

@@ -9,11 +9,11 @@ import { {{{tagName}}}DefaultConfig } from '.';
 
 {{#each tagedApis}}
 {{#each apis}}
-type {{{name}}}Response = {{processType response @root.componentNames}};
+type {{{name}}}Response = {{addNamespace response @root.componentNames}};
 type {{{name}}}ExtraConfig = Omit<AxiosRequestConfig, 'data' | 'params'> & {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}params: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}data: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}params: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}data: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 };
 {{> api-jsdoc}}

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

@@ -1,5 +1,5 @@
 const { defineConfig } = require('wormajs');
-const { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } = require('wormajs/plugin');
+const { swagger, 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 'wormajs';
-import { platform, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } from 'wormajs/plugin';
+import { swagger, aiDoc{{#if templateImport}}, {{{templateImport}}}{{/if}} } from 'wormajs/plugin';
 
 // For more config detailed visit:
 // https://github.com/alovajs/devtools

package/dist/template/presets/config/partials/generator-content.handlebars

@@ -1,45 +1,45 @@
-generator: [
-  {
-    /**
-      * file input. support:
-      * 1. openapi json file url
-      * 2. local file
-      * 3. string array — each URL will be tried in order, first success wins
-      */
-    input: 'http://localhost:3000',
-
-    /**
-      * output path of interface file and type file.
-      * Multiple generators cannot have the same address, otherwise the generated code will overwrite each other.
-      */
-    output: 'src/api',
-
-    /**
-      * platform plugin: auto-resolves OpenAPI file URLs from platform type.
-      * Uses config.input as base URL to construct candidate OpenAPI endpoints.
-      */
-    plugins: [platform('swagger'), aiDoc({ installSkill: true }), {{{templateCall}}}],
-
-    /**
-      * the mediaType of the generated response data. default is `application/json`
-      */
-    // responseMediaType: 'application/json',
-
-    /**
-      * the bodyMediaType of the generated request body data. default is `application/json`
-      */
-    // bodyMediaType: 'application/json',
-
-    /**
-      * type of generated code. The options are `auto/ts/typescript/module/commonjs`
-      */
-    // type: 'auto',
-
-    /**
-      * filter or convert the generated api information, return an apiDescriptor, if this function is not specified, the apiDescriptor object is not converted
-      */
-    // handleApi: apiDescriptor => {
-    //  return apiDescriptor;
-    // }
-  }
-]
+generator: [
+  {
+    /**
+      * file input. support:
+      * 1. openapi json file url
+      * 2. local file
+      * 3. string array — each URL will be tried in order, first success wins
+      */
+    // input: 'http://localhost:3000',
+
+    /**
+      * output path of interface file and type file.
+      * Multiple generators cannot have the same address, otherwise the generated code will overwrite each other.
+      */
+    output: 'src/api',
+
+    /**
+      * swagger platform plugin: auto-resolves OpenAPI file URLs from the base URL.
+      * The base URL is passed as the plugin argument (not config.input).
+      */
+    plugins: [swagger('http://localhost:3000'), aiDoc({ installSkill: true }), {{{templateCall}}}],
+
+    /**
+      * the mediaType of the generated response data. default is `application/json`
+      */
+    // responseMediaType: 'application/json',
+
+    /**
+      * the bodyMediaType of the generated request body data. default is `application/json`
+      */
+    // bodyMediaType: 'application/json',
+
+    /**
+      * type of generated code. The options are `auto/ts/typescript/module/commonjs`
+      */
+    // type: 'auto',
+
+    /**
+      * filter or convert the generated api information, return an apiDescriptor, if this function is not specified, the apiDescriptor object is not converted
+      */
+    // handleApi: apiDescriptor => {
+    //  return apiDescriptor;
+    // }
+  }
+]

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

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

package/dist/template/presets/fetch/partials/dts-types.handlebars

@@ -1,7 +1,7 @@
-type {{{name}}}Response = {{processType response @root.componentNames}};
+type {{{name}}}Response = {{addNamespace response @root.componentNames}};
 type {{{name}}}ExtraConfig = Omit<RequestInit, 'body'> & {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}params?: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}body?: {{processType requestBody @root.componentNames}} | BodyInit;
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}params?: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}body?: {{addNamespace requestBody @root.componentNames}} | BodyInit;
   {{/if}}
 };

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

@@ -8,11 +8,11 @@ import { {{{tagName}}}DefaultConfig } from '.';
 
 {{#each tagedApis}}
 {{#each apis}}
-type {{{name}}}Response = {{processType response @root.componentNames}};
+type {{{name}}}Response = {{addNamespace response @root.componentNames}};
 type {{{name}}}ExtraConfig = Omit<RequestInit, 'body'> & {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}params?: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}body?: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}params?: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}body?: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 };
 {{> api-jsdoc}}

package/dist/template/presets/ky/partials/dts-types.handlebars

@@ -1,9 +1,9 @@
-type {{{name}}}Response = {{processType response @root.componentNames}};
+type {{{name}}}Response = {{addNamespace response @root.componentNames}};
 {{#or pathParameters queryParameters requestBody}}
 type {{{name}}}ExtraConfig = Options & {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}searchParams: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}json: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}searchParams: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}json: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 };
 {{/or}}

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

@@ -9,11 +9,11 @@ import { {{{tagName}}}DefaultConfig } from '.';
 
 {{#each tagedApis}}
 {{#each apis}}
-type {{{name}}}Response = {{processType response @root.componentNames}};
+type {{{name}}}Response = {{addNamespace response @root.componentNames}};
 type {{{name}}}ExtraConfig = Options & {
-  {{#if pathParameters}}pathParams: {{processType pathParameters @root.componentNames}};
-  {{/if}}{{#if queryParameters}}searchParams: {{processType queryParameters @root.componentNames}};
-  {{/if}}{{#if requestBody}}json: {{processType requestBody @root.componentNames}};
+  {{#if pathParameters}}pathParams: {{addNamespace pathParameters @root.componentNames}};
+  {{/if}}{{#if queryParameters}}searchParams: {{addNamespace queryParameters @root.componentNames}};
+  {{/if}}{{#if requestBody}}json: {{addNamespace requestBody @root.componentNames}};
   {{/if}}
 };
 {{> api-jsdoc}}

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/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"}
+{"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/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/plugins/presets/platform/fastapi.ts","../src/plugins/presets/platform/index.ts","../src/plugins/presets/platform/knife4j.ts","../src/plugins/presets/platform/shared.ts","../src/plugins/presets/platform/swagger.ts","../src/plugins/presets/platform/yapi.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/template.js

@@ -76,6 +76,29 @@ function registerCommonHelpers(hbs) {
             return text;
         return text.split('\n').map(line => line.replace(/^\* ?/, '')).join('\n');
     });
+    /**
+     * Scan the type string for every PascalCase identifier that is in componentNames
+     * (and not already prefixed with `${importName}.`) and prefix it.
+     * Works uniformly for top-level names, generics, object literals, and arrays.
+     *
+     * @param typeStr       The type expression to process.
+     * @param componentNames The list of component schema names to prefix.
+     * @param importName     The imported namespace name to prefix with. Defaults to "ComponentTypes".
+     */
+    hbs.registerHelper('addNamespace', (typeStr, componentNames, importName) => {
+        const type = typeStr;
+        const names = componentNames;
+        const importPrefix = (typeof importName === 'string' && importName.length > 0) ? importName : 'ComponentTypes';
+        if (!type || !Array.isArray(names) || names.length === 0) {
+            return new hbs.SafeString(type || 'unknown');
+        }
+        const nameSet = new Set(names);
+        const escapedPrefix = importPrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const result = type.replace(new RegExp(`(?<!${escapedPrefix}\\.)(\\b[A-Z]\\w*\\b)`, 'g'), (match) => {
+            return nameSet.has(match) ? `${importPrefix}.${match}` : match;
+        });
+        return new hbs.SafeString(result);
+    });
 }
 /**
  * Pass in text content and generate a custom file in the specified directory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wormajs",
-  "version": "0.0.2-beta.3",
+  "version": "0.1.0",
   "description": "A modern OpenAPI code generator - Generate type-safe API clients from OpenAPI specs",
   "author": "worma",
   "license": "MIT",

package/typings/plugins.d.ts

@@ -597,33 +597,106 @@ export interface ModifierConfig<T extends Schema> {
 export type PayloadModifierConfig = ModifierConfig<Schema>;
 export declare function payloadModifier(configs: PayloadModifierConfig[]): ApiPlugin;
 /**
- * Supported platform types
+ * FastAPI platform plugin.
+ *
+ * Pass the base URL of your FastAPI app; the plugin will try `/openapi.json`
+ * first, then fall back to the bare base URL.
+ *
+ * @param input - base URL string, or an array of base URLs
+ *
+ * @example
+ * ```ts
+ * plugins: [fastapi('http://fastapi-example.dokkuapp.com'), alovaGlobals()]
+ * ```
  */
-export type PlatformType = "swagger" | "knife4j" | "fastapi" | "yapi";
+export declare const fastapi: (input: string | string[]) => ApiPlugin;
 /**
- * Platform plugin for auto-resolving OpenAPI file URLs.
+ * Knife4j platform plugin.
  *
- * Pass a platform type (e.g., `'swagger'`) and the plugin will use `config.input`
- * as the base URL to generate candidate OpenAPI file URLs. The framework will try
- * each URL in order and use the first successful response.
+ * Pass the base URL of your Knife4j instance; the plugin will try the OAS3
+ * endpoint (springdoc) first, then the Swagger2 endpoint (springfox), then the
+ * bare base URL.
  *
- * @param platformType - The platform type: 'swagger' | 'knife4j' | 'fastapi' | 'yapi'
- * @returns ApiPlugin
+ * @param input - base URL string, or an array of base URLs
  *
  * @example
  * ```ts
- * import { platform, alovaGlobals } from 'wormajs/plugin';
+ * plugins: [knife4j('https://openapi3.demo.knife4jnext.com'), alovaGlobals()]
+ * ```
+ */
+export declare const knife4j: (input: string | string[]) => ApiPlugin;
+/**
+ * Swagger platform plugin.
+ *
+ * Pass the base URL of your Swagger UI / server; the plugin will try several
+ * common OpenAPI document endpoints (OAS3 first, then Swagger2, then the bare
+ * base URL) and let the framework pick the first one that responds.
+ *
+ * @param input - base URL string, or an array of base URLs
+ *
+ * @example
+ * ```ts
+ * import { swagger, alovaGlobals } from 'wormajs/plugin';
  *
  * defineConfig({
  *   generator: [{
- *     input: 'https://petstore3.swagger.io',
- *     plugins: [platform('swagger'), alovaGlobals()],
+ *     plugins: [swagger('https://petstore3.swagger.io'), alovaGlobals()],
  *     output: './src/api',
  *   }]
  * });
  * ```
  */
-export declare function platform(platformType: PlatformType): ApiPlugin;
+export declare const swagger: (input: string | string[]) => ApiPlugin;
+export interface YapiOptions {
+	/** YApi 服务基础地址，例如 `https://yapi.xxx.com` */
+	url: string;
+	/** 项目 ID，必填，用于拼装导出地址 */
+	pid: string | number;
+	/** OpenAPI 类型，默认 `OpenAPIV2` */
+	type?: string;
+	/** 接口状态，默认 `all` */
+	status?: string;
+	/** 是否包含 wiki，默认 `true` */
+	isWiki?: boolean;
+	/** 登录 cookie。也可通过 fetchOptions.headers.cookie 传入 */
+	cookie?: string;
+	/** 额外的 fetch 超时（毫秒） */
+	timeout?: number;
+}
+/**
+ * YApi platform plugin.
+ *
+ * YApi projects are private, so the OpenAPI document must be exported through
+ * YApi's own export endpoint, authenticated with your login cookie. The plugin
+ * builds the export URL from the server base URL (`url`) plus the required
+ * `pid` and the optional `type` / `status` / `isWiki` query params (which
+ * default to `OpenAPIV2`, `all`, and `true` respectively).
+ *
+ * `url`, `pid` and `cookie` are required — the plugin throws a clear error when
+ * any is missing.
+ *
+ * @param options - `{ url, pid, cookie?, type?, status?, isWiki?, timeout? }`
+ *
+ * @example
+ * ```ts
+ * import { yapi, alovaGlobals } from 'wormajs/plugin';
+ *
+ * defineConfig({
+ *   generator: [{
+ *     plugins: [
+ *       yapi({
+ *         url: 'https://yapi.xxx.com',
+ *         pid: 123,
+ *         cookie: '_yapi_token=xxx; _yapi_uid=yyy',
+ *       }),
+ *       alovaGlobals(),
+ *     ],
+ *     output: './src/api',
+ *   }]
+ * });
+ * ```
+ */
+export declare function yapi(options: YapiOptions): ApiPlugin;
 /**
  * Rename style options
  */
@@ -635,7 +708,7 @@ export interface RenameConfig {
 	/**
 	 * Target scope for renaming, defaults to 'url'
 	 */
-	scope?: "url" | "params" | "pathParams" | "data" | "response" | "refName";
+	scope?: "url" | "params" | "pathParams" | "data" | "response" | "refName" | "name";
 	/**
 	 * Matching rule for selective renaming:
 	 * - string: target contains this string
@@ -643,7 +716,7 @@ export interface RenameConfig {
 	 * - function: custom matching logic
 	 * If not specified, all targets will be processed
 	 */
-	match?: string | RegExp | ((key: string) => boolean);
+	match?: string | RegExp | ((key: string, level?: number) => boolean);
 	/**
 	 * Naming style to apply
 	 */

package/dist/plugins/presets/platform.js

@@ -1,73 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.platform = platform;
-const constant_1 = require("../../constant");
-/**
- * Generate OpenAPI file URLs based on platform type.
- * For Swagger and Knife4j, generates multiple URLs covering both OAS3 and Swagger2 endpoints.
- */
-function resolvePlatformUrls(baseUrl, platformType) {
-    // Normalize: remove trailing slash
-    const base = baseUrl.replace(/\/+$/, '');
-    switch (platformType) {
-        case 'swagger':
-            // Try OAS3 first, then Swagger2, then generic openapi.json
-            return [
-                `${base}/openapi.json`,
-                `${base}/v2/swagger.json`,
-                `${base}/api/v3/openapi.json`,
-                baseUrl,
-            ];
-        case 'knife4j':
-            // Try OAS3 first (springdoc), then Swagger2 (springfox)
-            return [
-                `${base}/v3/api-docs`,
-                `${base}/v2/api-docs`,
-                baseUrl,
-            ];
-        case 'fastapi':
-            return [`${base}/openapi.json`, baseUrl];
-        case 'yapi':
-            // YApi requires pid and token in URL, use input as-is
-            return [baseUrl];
-    }
-}
-/**
- * Platform plugin for auto-resolving OpenAPI file URLs.
- *
- * Pass a platform type (e.g., `'swagger'`) and the plugin will use `config.input`
- * as the base URL to generate candidate OpenAPI file URLs. The framework will try
- * each URL in order and use the first successful response.
- *
- * @param platformType - The platform type: 'swagger' | 'knife4j' | 'fastapi' | 'yapi'
- * @returns ApiPlugin
- *
- * @example
- * ```ts
- * import { platform, alovaGlobals } from 'wormajs/plugin';
- *
- * defineConfig({
- *   generator: [{
- *     input: 'https://petstore3.swagger.io',
- *     plugins: [platform('swagger'), alovaGlobals()],
- *     output: './src/api',
- *   }]
- * });
- * ```
- */
-function platform(platformType) {
-    return {
-        name: constant_1.PluginName.PLATFORM,
-        config({ config }) {
-            const raw = config.input;
-            if (!raw)
-                return config;
-            // Normalize to an array of base URLs, deduplicate
-            const inputs = Array.isArray(raw) ? [...new Set(raw)] : [raw];
-            // For each input, generate platform URLs, then flatten
-            config.input = inputs.flatMap(url => resolvePlatformUrls(url, platformType));
-            return config;
-        },
-    };
-}
-exports.default = platform;