wormajs 0.2.4 → 0.2.6

package/dist/core/parser/templateParser/index.js

@@ -47,7 +47,7 @@ const helper_1 = require("../../../helper");
 const document_1 = require("../../../helper/document");
 const openapi_1 = require("../../../utils/openapi");
 const helper_2 = require("./helper");
-/** M2-B4: 轻量并发 limiter，无额外依赖 */
+/** M2-B4: lightweight concurrency limiter, no extra dependencies */
 async function pMap(items, fn, concurrency) {
     const results = Array.from({ length: items.length });
     let idx = 0;
@@ -60,22 +60,22 @@ async function pMap(items, fn, concurrency) {
     await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker()));
     return results;
 }
-/** 根据 CPU 核数自动计算合理并发上限 */
+/** Automatically compute a reasonable concurrency limit based on CPU core count */
 function autoConcurrency() {
     const cpuCount = Math.max(1, (0, node_os_1.cpus)().length);
     return Math.min(64, Math.max(8, cpuCount * 4));
 }
 class TemplateParser {
-    constructor() {
-        this.name = 'templateParser';
-        this.schemasMap = new Map();
-        this.operationIdSet = new Set();
-        this.pathMap = [];
-        this.refNameMap = new Map();
-        /** M1-A4: 用 Map 索引替代 tagedApis.find() 线性查找，O(n·t) → O(n+t) */
-        this.tagMap = new Map();
-        this.openApiHelper = new document_1.OpenApiHelper();
-    }
+    name = 'templateParser';
+    schemasMap = new Map();
+    operationIdSet = new Set();
+    pathMap = [];
+    refNameMap = new Map();
+    /** M1-A4: replaced tagedApis.find() linear lookup with a Map index, O(n·t) → O(n+t) */
+    tagMap = new Map();
+    document;
+    options;
+    openApiHelper = new document_1.OpenApiHelper();
     async parse(document, options) {
         this.document = document;
         this.options = options;
@@ -173,7 +173,7 @@ class TemplateParser {
         });
         templateData.components = [...new Set(this.schemasMap.values())];
         templateData.componentNames = [...this.schemasMap.keys()];
-        // 按名称字典序排序，确保输出顺序确定性（避免并发场景下 Map 插入顺序漂移）
+        // sort by name lexicographically to ensure deterministic output order (avoid Map insertion-order drift under concurrency)
         const sorted = [...this.schemasMap.entries()].sort(([a], [b]) => a.localeCompare(b));
         templateData.componentNames = sorted.map(([k]) => k);
         templateData.components = sorted.map(([, v]) => v);
@@ -301,7 +301,7 @@ class TemplateParser {
         let tagApis = this.tagMap.get(api.tag);
         if (!tagApis) {
             tagApis = {
-                tagName: api.tag,
+                tag: api.tag,
                 apis: [],
             };
             this.tagMap.set(api.tag, tagApis);

package/dist/core/workerPool/poolManager.js

@@ -8,15 +8,15 @@ exports.PoolManager = void 0;
  */
 const WorkerPool_1 = require("../../core/WorkerPool");
 class PoolManager {
+    static instance;
+    pools = new Map();
     static getInstance() {
         if (!PoolManager.instance) {
             PoolManager.instance = new PoolManager();
         }
         return PoolManager.instance;
     }
-    constructor() {
-        this.pools = new Map();
-    }
+    constructor() { }
     get(options) {
         const { key, workerScript, sharedContext, poolSize, idleTimeout } = options;
         let pool = this.pools.get(key);

package/dist/functions/wormaJson.js

@@ -77,10 +77,10 @@ function computePerTagHashes(allApis, tagedApis) {
     const allHashes = [];
     if (tagedApis) {
         // P2: Use pre-grouped tagedApis to avoid O(n) re-grouping loop
-        for (const { tagName, apis: groupApis } of tagedApis) {
+        for (const { tag, apis: groupApis } of tagedApis) {
             const hashes = groupApis.map(computeApiHash).sort();
             allHashes.push(...hashes);
-            tags[tagName] = (0, node_crypto_1.createHash)('sha256').update(hashes.join('')).digest('hex').slice(0, 16);
+            tags[tag] = (0, node_crypto_1.createHash)('sha256').update(hashes.join('')).digest('hex').slice(0, 16);
         }
     }
     else {

package/dist/helper/PluginDriver.js

@@ -12,6 +12,8 @@ const CTX = Object.freeze({});
  * - Provides three execution strategies: parallelEach, seqEach (chaining), pipe (content transform).
  */
 class PluginDriver {
+    plugins;
+    reporter;
     constructor(plugins = [], opts) {
         this.plugins = plugins.filter(Boolean);
         this.reporter = opts?.reporter ?? (() => progress_1.noopReportProgress);

package/dist/helper/comment.js

@@ -2,26 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.commentHelper = exports.CommentHelper = void 0;
 class CommentHelper {
-    constructor() {
-        this.type = 'line';
-        this.comment = '';
-        this.transformMap = {
-            '[deprecated]': '@deprecated',
-            '[required]': '[required]',
-            '[title]': (text) => {
-                const [, nextText = ''] = /\[title\](.*)/.exec(text) ?? [];
-                return `${nextText.trim()}\n---`;
-            },
-            '[cycle]': (text) => {
-                const [, nextText = ''] = /\[cycle\](.*)/.exec(text) ?? [];
-                return `${nextText.trim()}\n---`;
-            },
-            '[summary]': (text) => {
-                const [, nextText = ''] = /\[summary\](.*)/.exec(text) ?? [];
-                return `${nextText.trim()}\n---`;
-            },
-        };
-    }
+    type = 'line';
+    comment = '';
+    transformMap = {
+        '[deprecated]': '@deprecated',
+        '[required]': '[required]',
+        '[title]': (text) => {
+            const [, nextText = ''] = /\[title\](.*)/.exec(text) ?? [];
+            return `${nextText.trim()}\n---`;
+        },
+        '[cycle]': (text) => {
+            const [, nextText = ''] = /\[cycle\](.*)/.exec(text) ?? [];
+            return `${nextText.trim()}\n---`;
+        },
+        '[summary]': (text) => {
+            const [, nextText = ''] = /\[summary\](.*)/.exec(text) ?? [];
+            return `${nextText.trim()}\n---`;
+        },
+    };
     static load(options) {
         return new CommentHelper().load(options);
     }

package/dist/helper/config/ConfigHelper.js

@@ -6,9 +6,8 @@ const helper_1 = require("../../helper");
 const ConfigManager_1 = require("./ConfigManager");
 const GeneratorHelper_1 = require("./GeneratorHelper");
 class ConfigHelper {
-    constructor() {
-        this.configManager = new ConfigManager_1.ConfigManager();
-    }
+    configManager = new ConfigManager_1.ConfigManager();
+    projectPath;
     async load(config, projectPath = process.cwd(), tracker) {
         this.projectPath = projectPath;
         await this.configManager.load(config, projectPath, tracker);

package/dist/helper/config/ConfigManager.js

@@ -10,47 +10,49 @@ const GeneratorHelper_1 = require("../../helper/config/GeneratorHelper");
 const logger_1 = require("../../helper/logger");
 const zType_1 = require("./zType");
 class ConfigManager {
+    config;
+    readConfig;
+    defaultConfig = Object.freeze({
+        generator: [],
+    });
+    defaultGeneratorConfig = GeneratorHelper_1.generatorHelper.getDefaultConfig();
     constructor() {
-        this.defaultConfig = Object.freeze({
-            generator: [],
-        });
-        this.defaultGeneratorConfig = GeneratorHelper_1.generatorHelper.getDefaultConfig();
         this.config = this.defaultConfig;
     }
     /**
-     * 加载并验证配置
+     * Load and validate the configuration
      */
     async load(config, projectPath = process.cwd(), tracker) {
-        // 处理配置
+        // process config
         const userConfig = await this.handleConfig(config, projectPath, tracker);
-        // 验证配置
+        // validate config
         const validatedConfig = this.validateConfig(userConfig);
-        // 更新配置
+        // update config
         this.config = validatedConfig;
         this.readConfig = Object.freeze(this.config);
         logger_1.logger.debug('Configuration loaded successfully', this.config);
     }
     /**
-     * 获取完整配置
+     * Get the full configuration
      */
     getConfig() {
         return this.readConfig;
     }
     /**
-     * 更新配置
+     * Update configuration
      */
     async update(partialConfig) {
         await this.load({ ...this.config, ...partialConfig });
     }
     async handleConfig(config, projectPath = process.cwd(), tracker) {
-        // 合并配置
+        // merge config
         const userConfig = this.mergeConfig(this.defaultConfig, config);
-        // 处理插件的config配置
+        // process plugin config configurations
         userConfig.generator = await Promise.all(userConfig.generator.map(item => (0, prepareConfig_1.default)(item, projectPath, tracker)));
         return userConfig;
     }
     /**
-     * 验证配置
+     * Validate configuration
      */
     validateConfig(config) {
         let result = config;
@@ -64,7 +66,7 @@ class ConfigManager {
         return result;
     }
     /**
-     * 合并配置（浅拷贝）
+     * Merge configuration (shallow copy)
      */
     mergeConfig(defaultConfig, userConfig) {
         const result = { ...defaultConfig, ...userConfig };

package/dist/helper/config/GeneratorHelper.js

@@ -15,19 +15,21 @@ const helper_2 = require("../../helper");
 const progress_1 = require("../../helper/progress");
 const zType_1 = require("./zType");
 class GeneratorHelper {
-    constructor() {
-        /**
-         * Default configuration values
-         */
-        this.defaultConfig = Object.freeze({
-            input: '',
-            output: '',
-            responseMediaType: 'application/json',
-            bodyMediaType: 'application/json',
-            type: constant_1.ConfigTypeEnum.AUTO,
-            defaultRequire: false,
-        });
-    }
+    static instance;
+    config;
+    readConfig;
+    pluginDriver;
+    /**
+     * Default configuration values
+     */
+    defaultConfig = Object.freeze({
+        input: '',
+        output: '',
+        responseMediaType: 'application/json',
+        bodyMediaType: 'application/json',
+        type: constant_1.ConfigTypeEnum.AUTO,
+        defaultRequire: false,
+    });
     static getInstance() {
         if (!GeneratorHelper.instance) {
             GeneratorHelper.instance = new GeneratorHelper();

package/dist/helper/config/zType.js

@@ -5,7 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.zConfig = exports.zGeneratorConfig = exports._zGeneratorConfig = exports.zApiPlugin = exports.zFetchOptions = exports.zHandleApi = exports.zApiDescriptor = exports.zTemplateResult = exports.zTemplateType = exports.zConfigType = void 0;
 const node_path_1 = __importDefault(require("node:path"));
-const v3_1 = require("zod/v3"); // v4版本不稳定，暂时使用v3
+const v3_1 = require("zod/v3"); // v4 is unstable, temporarily using v3
 /**
  * Find the corresponding input attribute value
  */

package/dist/helper/document/index.js

@@ -4,7 +4,7 @@ exports.openApiHelper = exports.OpenApiHelper = exports.supportedApiMethods = vo
 const type_1 = require("../../type");
 const utils_1 = require("../../utils");
 /**
- * 支持的API方法列表
+ * List of supported API methods
  * @see https://github.com/alovajs/alova/blob/main/packages/alova/typings/index.d.ts#L640
  */
 exports.supportedApiMethods = [
@@ -17,9 +17,8 @@ exports.supportedApiMethods = [
     type_1.HttpMethod.OPTIONS,
 ];
 class OpenApiHelper {
-    constructor() {
-        this.usedRefsCache = new Set();
-    }
+    document;
+    usedRefsCache = new Set();
     load(document) {
         this.document = document;
         // reset cache when document changes
@@ -54,12 +53,12 @@ class OpenApiHelper {
         return apiMethods;
     }
     /**
-     * 将 ApiMethods 数组写回到 openapi document 的 paths 中。
-     * 仅更新传入的 url+method 对应的 operationObject，保留其它未涉及的内容。
+     * Write the ApiMethods array back into the openapi document's paths.
+     * Only updates the operationObject for the passed url+method, keeping the rest untouched.
      */
     saveApiMethods(apiMethods) {
         this.document.paths = {};
-        // 构建 url -> { method -> operationObject } 映射，后写入覆盖前者
+        // build a url -> { method -> operationObject } map; later writes overwrite earlier ones
         const grouped = {};
         for (const item of apiMethods || []) {
             if (!item || !item.url || !item.method || !item.operationObject) {
@@ -67,7 +66,7 @@ class OpenApiHelper {
             }
             const method = String(item.method).toLowerCase();
             if (!exports.supportedApiMethods.includes(method)) {
-                // 跳过不支持的 http 方法
+                // skip unsupported http methods
                 continue;
             }
             if (!grouped[item.url]) {
@@ -75,7 +74,7 @@ class OpenApiHelper {
             }
             grouped[item.url][method] = item.operationObject;
         }
-        // 将分组后的方法写回到 document.paths
+        // write the grouped methods back into document.paths
         for (const [url, methodsMap] of Object.entries(grouped)) {
             const pathInfo = (this.document.paths?.[url] || {});
             for (const [method, operationObject] of Object.entries(methodsMap)) {
@@ -85,13 +84,13 @@ class OpenApiHelper {
                 this.document.paths[url] = pathInfo;
             }
         }
-        // 更新后清除引用缓存，确保后续计算的使用引用为最新
+        // clear the reference cache after updating, ensuring subsequent used-reference computations are up to date
         this.usedRefsCache.clear();
         return this;
     }
     /**
-     * 判断某个引用是否在文档中被使用
-     * @param ref ReferenceObject 或其 `$ref` 路径字符串
+     * Check whether a reference is used in the document
+     * @param ref ReferenceObject or its `$ref` path string
      */
     isReferenceUsed(ref) {
         const refPath = typeof ref === 'string' ? ref : ref.$ref;
@@ -99,7 +98,7 @@ class OpenApiHelper {
         return usedSet.has(refPath);
     }
     /**
-     * 预计算并返回已使用的 `$ref` 集合，仅从 paths 可达
+     * Precompute and return the set of used `$ref`s, reachable only from paths
      */
     getUsedReferenceSet() {
         if (this.usedRefsCache.size > 0) {
@@ -146,7 +145,7 @@ class OpenApiHelper {
         return used;
     }
     /**
-     * 过滤掉未使用的引用，返回仍被使用的引用列表
+     * Filter out unused references and return the list of still-used references
      */
     filterUsedReferences(refs) {
         const usedSet = this.getUsedReferenceSet();

package/dist/helper/logger/index.js

@@ -4,13 +4,11 @@ exports.logger = void 0;
 const config_1 = require("../../config");
 const DEFAULT_CONFIG = (0, config_1.getGlobalConfig)();
 class Logger {
-    constructor() {
-        this.options = {
-            level: 'info',
-            timestamp: true,
-            colors: true,
-        };
-    }
+    options = {
+        level: 'info',
+        timestamp: true,
+        colors: true,
+    };
     configure(options) {
         this.options = { ...this.options, ...options };
         return this;
@@ -68,7 +66,7 @@ class Logger {
         return new DEFAULT_CONFIG.Error(this.errorMsg(error));
     }
 }
-// 导出单例实例
+// export the singleton instance
 exports.logger = new Logger().configure({
     level: 'info',
     timestamp: true,

package/dist/helper/progress.js

@@ -22,10 +22,12 @@ exports.GeneratorStage = {
     SKIPPED: 'skipped',
 };
 class ProgressTracker {
+    snapshot = {};
+    dirty = false;
+    timer = null;
+    listener;
+    interval;
     constructor(listener, interval = 500) {
-        this.snapshot = {};
-        this.dirty = false;
-        this.timer = null;
         this.listener = listener;
         this.interval = interval;
     }

package/dist/helper/template/index.js

@@ -11,13 +11,13 @@ const constant_1 = require("../../constant");
 const wormaJson_1 = require("../../functions/wormaJson");
 const logger_1 = require("../../helper/logger");
 const utils_1 = require("../../utils");
-/** M1-A2: Handlebars 实例缓存 —— 同 templatePath 复用编译好的 partials 和 helpers */
+/** M1-A2: Handlebars instance cache — reuse compiled partials and helpers for the same templatePath */
 const hbsInstanceCache = new Map();
 const templateCompileCache = new Map();
 function cacheKey(projectPath, output) {
     return `${projectPath}::${output}`;
 }
-/** 模块类型目录名（与 config.type 不同：commonjs -> common） */
+/** module-type directory name (differs from config.type: commonjs -> common) */
 exports.MODULE_TYPES = [constant_1.ModuleTypeDir.TYPESCRIPT, constant_1.ModuleTypeDir.MODULE, constant_1.ModuleTypeDir.COMMON];
 // ---- helpers ----
 const TEMPLATE_EXTENSIONS = [
@@ -62,6 +62,10 @@ function joinPath(...parts) {
     return p ? normalizeSlashes(p) : p;
 }
 class TemplateHelper {
+    static instance;
+    /** Runtime cache of parsed template data, keyed by `${projectPath}::${output}`. Flushed to disk via flushAllData. */
+    static _cacheData = new Map();
+    config;
     // ============ hasTagTemplates / instance ============
     static async hasTagTemplates(templatePath, type) {
         try {
@@ -93,7 +97,7 @@ class TemplateHelper {
     static getModuleType(type) {
         return constant_1.MODULE_TYPE_TO_KIND[type] ?? constant_1.ModuleKind.ES_MODULE;
     }
-    // ============ 缓存 ============
+    // ============ cache ============
     static async readData(projectPath, output) {
         const key = cacheKey(projectPath, output);
         const cached = TemplateHelper._cacheData.get(key);
@@ -144,7 +148,7 @@ class TemplateHelper {
                 await promises_1.default.unlink(p);
         }));
     }
-    // ============ 模板解析 ============
+    // ============ template resolution ============
     async resolveTemplateFiles(templatePath) {
         const absolute = node_path_1.default.isAbsolute(templatePath) ? templatePath : node_path_1.default.resolve(process.cwd(), templatePath);
         if (!(await (0, utils_1.existsPromise)(absolute)))
@@ -235,7 +239,7 @@ class TemplateHelper {
             insideTagDir,
         };
     }
-    // ============ 渲染 & 输出 ============
+    // ============ render & output ============
     async renderTemplate(templateFilePath, data) {
         const p = node_path_1.default.isAbsolute(this.config.templatePath)
             ? node_path_1.default.join(this.config.templatePath, `${templateFilePath}${constant_1.FileExtension.HANDLEBARS}`)
@@ -254,7 +258,7 @@ class TemplateHelper {
         }
         return template(data);
     }
-    /** M1-A2: 清除 Handlebars 编译和实例缓存（供测试与 watch 模式使用） */
+    /** M1-A2: clear Handlebars compile and instance caches (used by tests and watch mode) */
     static clearTemplateCache() {
         hbsInstanceCache.clear();
         templateCompileCache.clear();
@@ -352,10 +356,10 @@ class TemplateHelper {
         });
         const { changedTags, beforeFileWrite, writeConcurrency = 32, formatFile = true } = options ?? {};
         const hbs = await this.createHbs();
-        const tags = data.tagedApis?.map(item => item.tagName) || [];
+        const tags = data.tagedApis?.map(item => item.tag) || [];
         const apis = data.allApis || [];
         const tagApisMap = new Map();
-        data.tagedApis?.forEach(item => tagApisMap.set(item.tagName, item));
+        data.tagedApis?.forEach(item => tagApisMap.set(item.tag, item));
         // Collect all file paths for codeGenerated notification
         const allFilePaths = [];
         // --- Phase 1: Per-tag streaming (render → collect → batch write) ---
@@ -457,7 +461,7 @@ class TemplateHelper {
     }
     async renderOne(hbs, tf, data, outputDir, placeholders) {
         const renderData = data.config ? { ...data.config, ...data } : data;
-        const content = await this.renderTemplateFromPath(hbs, tf.absolutePath, renderData);
+        const content = await this.renderTemplateFromPath(hbs, tf.absolutePath, { ...renderData, noOverwrite: tf.isNoOverwrite });
         let relPath = tf.relativePath;
         if (placeholders?.tag)
             relPath = relPath.replace(constant_1.TemplatePlaceholder.TAG, placeholders.tag);
@@ -470,6 +474,4 @@ class TemplateHelper {
     }
 }
 exports.TemplateHelper = TemplateHelper;
-/** Runtime cache of parsed template data, keyed by `${projectPath}::${output}`. Flushed to disk via flushAllData. */
-TemplateHelper._cacheData = new Map();
 exports.templateHelper = TemplateHelper.getInstance();

package/dist/plugins/presets/aiDoc.js

@@ -54,7 +54,7 @@ function aiDoc(config) {
                     ...group,
                     apis: group.apis.map(api => ({
                         ...api,
-                        ...(isGlobals ? {} : { fileLocation: `${outputRel.replace(/\\/g, '/')}/${group.tagName}` }),
+                        ...(isGlobals ? {} : { fileLocation: `${outputRel.replace(/\\/g, '/')}/${group.tag}` }),
                     })),
                 })),
             };

package/dist/plugins/presets/apifox.js

@@ -18,10 +18,10 @@ function apifox({ projectId, locale = 'zh-CN', apifoxVersion = '2024-03-28', sco
         branchId,
         moduleId,
     };
-    // 根据不同的 scope 类型设置相应的参数
+    // set the corresponding params based on the scope type
     switch (scopeType) {
         case 'ALL':
-            // 导出全部不需要额外参数
+            // exporting all does not require extra params
             break;
         case 'SELECTED_ENDPOINTS':
             body.scope.selectedEndpointIds = selectedEndpointIds;

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

@@ -128,6 +128,9 @@ function applyToSchemaField(schema, config) {
 function payloadModifierApiDescriptor(apiDescriptor, config) {
     if (!apiDescriptor)
         return null;
+    // API path filter: if path does not match, return as-is and this config does not apply
+    if (!(0, utils_1.isMatch)(apiDescriptor.url, config.path))
+        return apiDescriptor;
     const newDescriptor = { ...apiDescriptor };
     const { scope } = config;
     switch (scope) {

package/dist/plugins/presets/rename.js

@@ -241,6 +241,11 @@ function transformRefNameMap(refNameMap, config, apiDescriptor) {
 function renameApiDescriptor(apiDescriptor, config) {
     if (!apiDescriptor)
         return apiDescriptor;
+    // API path filter: when `path` is set and the url does not match, this config
+    // is a no-op and the descriptor is returned unchanged (same reference).
+    if (config.path && !(0, utils_1.isMatch)(apiDescriptor.url, config.path)) {
+        return apiDescriptor;
+    }
     const newDescriptor = { ...apiDescriptor };
     const scope = config.scope || constant_1.RenameScope.URL;
     switch (scope) {

package/dist/readConfig.js

@@ -36,20 +36,20 @@ async function readConfig(projectPath = process.cwd()) {
         }
         return config;
     }
-    // 获取用户已安装的依赖
+    // get the dependencies installed by the user
     const userDependencies = await (0, utils_1.getUserInstalledDependencies)(projectPath);
-    // 始终将 worma 自身作为外部依赖，防止 esbuild 打包 worma 源码进入临时文件
-    // 否则 __dirname 会指向用户项目目录，导致预设模板路径解析失败
-    // monorepo 子包可能不直接依赖 wormajs，但 config 文件会 import from 'wormajs'
+    // always treat worma itself as an external dependency to prevent esbuild from bundling worma source into the temp file
+    // otherwise __dirname would point to the user project directory, causing preset template path resolution to fail
+    // monorepo sub-packages may not directly depend on wormajs, but the config file imports from 'wormajs'
     const allExternals = [...new Set([...userDependencies, 'worma', 'wormajs/plugin'])];
     const configTmpFileName = `worma_tmp_${Date.now()}.cjs`;
-    // 使用绝对路径：esbuild 写入相对 outfile 时按 cwd 解析，
-    // 而 require() 解析相对路径时基于调用模块所在目录，二者不一致会导致 require 失败。
-    // 绝对路径可保证写入与 require 指向同一文件。
+    // use an absolute path: esbuild resolves relative outfile against cwd,
+    // while require() resolves relative paths against the calling module's directory, and the mismatch would cause require to fail.
+    // an absolute path ensures writing and require point to the same file.
     const outfile = node_path_1.default.resolve(projectPath, configTmpFileName);
     await esbuild_1.default.build({
         entryPoints: [configFile],
-        // 排除用户已安装的依赖，避免打包进最终文件
+        // exclude dependencies installed by the user to avoid bundling them into the final file
         external: allExternals,
         bundle: true,
         format: 'cjs',
@@ -57,7 +57,7 @@ async function readConfig(projectPath = process.cwd()) {
         outfile,
         logLevel: 'silent',
     });
-    // try/finally 保证临时文件在任何情况下（require 抛错）都被清理
+    // try/finally ensures the temp file is cleaned up in all cases (including require errors)
     let module;
     try {
         // eslint-disable-next-line ts/no-require-imports