chore: merge main to release (#546)

* build(deps-dev): bump @types/node from 24.8.0 to 24.9.1

Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 24.8.0 to 24.9.1.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

---
updated-dependencies:
- dependency-name: "@types/node"
  dependency-version: 24.9.1
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* feat: 以 cli 方式使用时添加交互行为 & 新增 defineConfig 定义配置 (#543)

* feat: 以 cli 方式使用时，如果有一个以上的配置项，则通过可交互的形式让用户自己选择要生成的 service

* feat: 新增 defineConfig 函数，为定义配置时提供 ts 类型提示

* docs: 更新文档-关于 defineConfig & options.describe

* docs: 更新文档-关于代码贡献

* docs: create changelog

* docs: update changelog

---------

Co-authored-by: 故城 <[email protected]>

* chore: clean code

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Utopia <[email protected]>

Author: 3 people

.changeset/soft-goats-shake.md

@@ -0,0 +1,5 @@
+---
+"openapi-ts-request": Minor
+---
+
+feat: 以 cli 方式使用时添加交互行为 & 新增 defineConfig 定义配置

README-en_US.md

@@ -45,21 +45,20 @@ create `openapi-ts-request.config.ts` file in the project root directory
 > the config file also supports **_.openapi-ts-request.ts_**, **_openapi-ts-request.config.cjs_** format, reference [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig?tab=readme-ov-file#cosmiconfig)
 
 ```ts
-import type { GenerateServiceProps } from 'openapi-ts-request';
+import { defineConfig } from 'openapi-ts-request';
 
-export default {
-  // schemaPath: './openapi.json', // local openapi file
-  // serversPath: './src/apis', // interface storage path
+export default defineConfig({
   schemaPath: 'http://petstore.swagger.io/v2/swagger.json',
-} as GenerateServiceProps;
+  serversPath: './src/apis',
+});
 ```
 
 support passing in array config for generate
 
 ```ts
-import type { GenerateServiceProps } from 'openapi-ts-request';
+import { defineConfig } from 'openapi-ts-request';
 
-export default [
+export default defineConfig([
   {
     schemaPath: 'http://app.swagger.io/v2/swagger.json',
     serversPath: './src/apis/app',
@@ -68,7 +67,7 @@ export default [
     schemaPath: 'http://auth.swagger.io/v2/swagger.json',
     serversPath: './src/apis/auth',
   },
-] as GenerateServiceProps[];
+]);
 ```
 
 add the command in `script` of `package.json`: `"openapi": "openapi-ts",`
@@ -229,6 +228,7 @@ openapi -i ./spec.json -o ./apis
 | serversPath | no | string | './src/apis' | the folder path for the run results |
 | requestLibPath | no | string | 'axios' | custom request lib path, for example: '@/request', 'node-fetch' |
 | full | no | boolean | true | full replacement |
+| describe | no | string | - | description information, which will be used when using cli interactive operation mode |
 | enableLogging | no | boolean | false | open the log |
 | priorityRule | no | string | 'include' | priority rule, include/exclude/both |
 | filterCaseInsensitive | no | boolean | false | whether to perform a case-insensitive match with includeTags, includePaths, excludeTags, excludePaths filters |
@@ -345,7 +345,8 @@ export default {
 4. make sure your code passes all test cases (new functional test cases need to be added for new features)：`pnpm test:unit`
 5. create a changeset file using the command：`pnpm changeset`
 6. submit your changes using commit (must follow commitlint specification)
-7. submit Pull Request
+7. If documents are involved, please update README.md, READMD-en_US.md, and agents.md simultaneousl
+8. submit Pull Request
 
 ## Thanks
 

README.md

@@ -45,19 +45,20 @@ pnpm i openapi-ts-request -D
 > 配置文件还支持 **_.openapi-ts-request.ts_**, **_openapi-ts-request.config.cjs_** 等格式，参考 [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig?tab=readme-ov-file#cosmiconfig)
 
 ```ts
-import type { GenerateServiceProps } from 'openapi-ts-request';
+import { defineConfig } from 'openapi-ts-request';
 
-export default {
+export default defineConfig({
   schemaPath: 'http://petstore.swagger.io/v2/swagger.json',
-} as GenerateServiceProps;
+  serversPath: './src/apis',
+});
 ```
 
 支持传入数组配置进行生成
 
 ```ts
-import type { GenerateServiceProps } from 'openapi-ts-request';
+import { defineConfig } from 'openapi-ts-request';
 
-export default [
+export default defineConfig([
   {
     schemaPath: 'http://app.swagger.io/v2/swagger.json',
     serversPath: './src/apis/app',
@@ -66,7 +67,7 @@ export default [
     schemaPath: 'http://auth.swagger.io/v2/swagger.json',
     serversPath: './src/apis/auth',
   },
-] as GenerateServiceProps[];
+]);
 ```
 
 在 `package.json` 的 `script` 中添加命令: `"openapi": "openapi-ts",`
@@ -227,6 +228,7 @@ openapi --i ./spec.json --o ./apis
 | serversPath | 否 | string | './src/apis' | 运行结果文件夹路径 |
 | requestLibPath | 否 | string | 'axios' | 自定义请求方法路径，例如：'@/request'、'node-fetch' |
 | full | 否 | boolean | true | 是否全量替换 |
+| describe | 否 | string | - | 描述信息，在用 cli 可交互运行方式时会用到 |
 | enableLogging | 否 | boolean | false | 是否开启日志 |
 | priorityRule | 否 | string | 'include' | 模式规则，可选include/exclude/both |
 | filterCaseInsensitive | 否 | boolean | false | 执行 includeTags、includePaths、excludeTags、excludePaths 过滤时是否忽略大小写 |
@@ -266,6 +268,8 @@ openapi --i ./spec.json --o ./apis
 | customTemplates | {<br>[TypescriptFileType.serviceController]?: <T, U>(item: T, context: U) => string;<br>} | 自定义模板，详情请看源码 |
 | customRenderTemplateData | {<br>[TypescriptFileType]?: (list: any[], context: {fileName: string, params: Record<string, unknown>}) => any[]<br>} | 自定义文件生成时的 list 参数处理，支持对不同文件类型进行精细化控制 |
 
+[hooks 示例](https://github.com/openapi-ui/openapi-ts-request/blob/main/agents.md#-advanced-customization-hooks)
+
 ## Apifox-Config
 
 | 属性 | 类型 | 说明 | 必填 |
@@ -343,7 +347,8 @@ export default {
 4. 确保你的代码可以通过所有测试用例(新增功能需要添加新的功能测试用例)：`pnpm test:unit`
 5. 创建 changeset 文件通过命令：`pnpm changeset`
 6. 使用 commit 提交你的修改(需遵循 commitlint 规范)
-7. 发起 Pull Request
+7. 如果涉及文档，请同步更新 README.md、READMD-en_US.md、agents.md
+8. 发起 Pull Request
 
 ## 感谢
 

agents.md

@@ -102,6 +102,7 @@ else if (isNodeProject) {
 | `namespace` | string | `"API"` | TypeScript namespace | Custom namespace |
 | `templatesFolder` | string | - | Custom template directory | Custom templates |
 | `apifoxConfig` | object | - | Apifox-specific configuration | Apifox integration |
+| `describe` | string | - | description information | Using cli interactive operation mode |
 
 ### 3. Feature Requirements Mapping
 

openapi-ts-request.config.ts

@@ -1,8 +1,14 @@
-import { type GenerateServiceProps } from './src/index';
+import { defineConfig } from './src/index';
 
-export default [
+export default defineConfig([
   {
     schemaPath: 'http://petstore.swagger.io/v2/swagger.json',
     serversPath: './apis/app',
+    describe: 'Petstore API-1',
   },
-] as GenerateServiceProps[];
+  {
+    schemaPath: 'http://petstore.swagger.io/v2/swagger.json',
+    serversPath: './apis/app2',
+    describe: 'Petstore API-2',
+  },
+]);

package.json

@@ -35,6 +35,7 @@
     "openapi-ts-request": "openapi-ts"
   },
   "dependencies": {
+    "@clack/prompts": "^0.11.0",
     "@prettier/sync": "^0.6.1",
     "@trivago/prettier-plugin-sort-imports": "^5.2.1",
     "axios": "^1.7.2",