vite-plugin-swagger-typescript-api-transform 0.0.1

package/dist/types-CpgPraRT.d.ts

@@ -0,0 +1,69 @@
+//#region src/types.d.ts
+/**
+ * HTTP 客户端类型
+ */
+type HttpClientType = 'fetch' | 'axios';
+/**
+ * 合并后的配置选项类型
+ */
+interface MergedOptions {
+  rootDir?: string;
+  outputDir: string;
+  generateClient: boolean;
+  httpClient: HttpClientType;
+  baseURL?: string;
+  watch: boolean;
+  moduleNameFormat: 'kebab' | 'camel' | 'pascal';
+  apiClassName?: string;
+}
+/**
+ * 插件配置选项
+ */
+interface Options {
+  /**
+   * 扫描的根目录
+   * 默认值：process.cwd()（当前工作目录）
+   */
+  rootDir?: string;
+  /**
+   * 生成的 API 代码输出目录（相对于项目根目录）
+   * 默认值：'src/api'
+   */
+  outputDir?: string;
+  /**
+   * 是否生成请求函数
+   * 默认值：true
+   */
+  generateClient?: boolean;
+  /**
+   * HTTP 客户端类型
+   * 默认值：'axios'
+   */
+  httpClient?: 'axios' | 'fetch';
+  /**
+   * API 基础 URL
+   * 默认值：''
+   */
+  baseURL?: string;
+  /**
+   * 是否在开发模式下监听文件变化并重新生成
+   * 默认值：true
+   */
+  watch?: boolean;
+  /**
+   * 包含的 yaml 文件匹配模式
+   * 默认值：匹配所有 yaml 文件夹下的 .yaml 和 .yml 文件
+   */
+  include?: string[];
+  /**
+   * 排除的文件匹配模式
+   * 默认值：[]
+   */
+  exclude?: string[];
+  /**
+   * 生成的模块名称格式
+   * 默认值：'kebab'（短横线命名）
+   */
+  moduleNameFormat?: 'kebab' | 'camel' | 'pascal';
+} //#endregion
+export { HttpClientType, MergedOptions, Options };

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+import { HttpClientType, MergedOptions, Options } from "./types-CpgPraRT.js";
+export { HttpClientType, MergedOptions, Options };

package/dist/utils-BypLbD1p.js

@@ -0,0 +1,112 @@
+import path from "node:path";
+import fs from "node:fs";
+import _ from "lodash-es";
+
+//#region src/utils.ts
+/**
+* 安全读取目录内容
+* 如果目录不存在或读取失败，返回空数组
+*
+* @param dir - 要读取的目录路径
+* @returns 目录中的文件和子目录列表
+*/
+function safeReaddir(dir) {
+	try {
+		return fs.readdirSync(dir, { withFileTypes: true });
+	} catch {
+		return [];
+	}
+}
+/**
+* 递归查找项目中所有名为 "yaml" 的目录
+*
+* @param rootDir - 搜索的根目录
+* @returns 所有名为 "yaml" 的目录路径数组
+*
+* @example
+* // 假设项目结构如下：
+* // project/
+* //   yaml/
+* //   src/
+* //     yaml/
+* // findYamlDirectories('/project') => ['/project/yaml', '/project/src/yaml']
+*/
+function findYamlDirectories(rootDir) {
+	const walk = (dir) => {
+		const entries = safeReaddir(dir);
+		const yamlDirs = _(entries).filter("isDirectory").filter({ name: "yaml" }).map((entry) => path.join(dir, entry.name)).value();
+		const subDirs = _(entries).filter("isDirectory").reject({ name: "yaml" }).map((entry) => walk(path.join(dir, entry.name))).flatten().value();
+		return [...yamlDirs, ...subDirs];
+	};
+	return walk(rootDir);
+}
+/**
+* 递归查找目录中的所有 YAML 文件（.yaml 和 .yml）
+*
+* @param dir - 要搜索的目录
+* @returns 所有 YAML 文件的完整路径数组
+*
+* @example
+* // 查找 yaml 目录下的所有 yaml 文件
+* findYamlFiles('/project/yaml') => ['/project/yaml/user.yaml', '/project/yaml/order.yml']
+*/
+function findYamlFiles(dir) {
+	const walk = (currentDir) => {
+		const entries = safeReaddir(currentDir);
+		const files = _(entries).filter("isFile").filter((entry) => /\.ya?ml$/i.test(entry.name)).map((entry) => path.join(currentDir, entry.name)).value();
+		const subDirFiles = _(entries).filter("isDirectory").map((entry) => walk(path.join(currentDir, entry.name))).flatten().value();
+		return [...files, ...subDirFiles];
+	};
+	return walk(dir);
+}
+/**
+* 将文件名转换为指定的命名格式
+*
+* @param name - 原始文件名（不含扩展名）
+* @param format - 目标命名格式
+* @returns 转换后的模块名称
+*
+* @example
+* formatModuleName('user-profile', 'kebab') => 'user-profile'
+* formatModuleName('user-profile', 'camel') => 'userProfile'
+* formatModuleName('user-profile', 'pascal') => 'UserProfile'
+*/
+function formatModuleName(name, format) {
+	const kebabName = name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[_\s]+/g, "-").toLowerCase();
+	if (format === "kebab") return kebabName;
+	const camelName = kebabName.split("-").map((word, index) => {
+		if (index === 0 && format === "camel") return word;
+		return word.charAt(0).toUpperCase() + word.slice(1);
+	}).join("");
+	return camelName;
+}
+/**
+* 确保目录存在，如果不存在则创建
+*
+* @param dir - 目录路径
+*/
+function ensureDir(dir) {
+	if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+}
+/**
+* 判断文件是否存在
+*
+* @param filePath - 文件路径
+* @returns 文件是否存在
+*/
+function fileExists(filePath) {
+	return fs.existsSync(filePath);
+}
+/**
+* 获取相对于项目根目录的相对路径
+*
+* @param filePath - 文件绝对路径
+* @param rootDir - 项目根目录
+* @returns 相对路径
+*/
+function getRelativePath(filePath, rootDir) {
+	return path.relative(rootDir, filePath);
+}
+
+//#endregion
+export { ensureDir, fileExists, findYamlDirectories, findYamlFiles, formatModuleName, getRelativePath, safeReaddir };

package/dist/utils.d.ts

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+
+//#region src/utils.d.ts
+/**
+* 安全读取目录内容
+* 如果目录不存在或读取失败，返回空数组
+*
+* @param dir - 要读取的目录路径
+* @returns 目录中的文件和子目录列表
+*/
+
+/**
+ * 安全读取目录内容
+ * 如果目录不存在或读取失败，返回空数组
+ *
+ * @param dir - 要读取的目录路径
+ * @returns 目录中的文件和子目录列表
+ */
+declare function safeReaddir(dir: string): fs.Dirent[];
+/**
+ * 递归查找项目中所有名为 "yaml" 的目录
+ *
+ * @param rootDir - 搜索的根目录
+ * @returns 所有名为 "yaml" 的目录路径数组
+ *
+ * @example
+ * // 假设项目结构如下：
+ * // project/
+ * //   yaml/
+ * //   src/
+ * //     yaml/
+ * // findYamlDirectories('/project') => ['/project/yaml', '/project/src/yaml']
+ */
+declare function findYamlDirectories(rootDir: string): string[];
+/**
+ * 递归查找目录中的所有 YAML 文件（.yaml 和 .yml）
+ *
+ * @param dir - 要搜索的目录
+ * @returns 所有 YAML 文件的完整路径数组
+ *
+ * @example
+ * // 查找 yaml 目录下的所有 yaml 文件
+ * findYamlFiles('/project/yaml') => ['/project/yaml/user.yaml', '/project/yaml/order.yml']
+ */
+declare function findYamlFiles(dir: string): string[];
+/**
+ * 将文件名转换为指定的命名格式
+ *
+ * @param name - 原始文件名（不含扩展名）
+ * @param format - 目标命名格式
+ * @returns 转换后的模块名称
+ *
+ * @example
+ * formatModuleName('user-profile', 'kebab') => 'user-profile'
+ * formatModuleName('user-profile', 'camel') => 'userProfile'
+ * formatModuleName('user-profile', 'pascal') => 'UserProfile'
+ */
+declare function formatModuleName(name: string, format: 'kebab' | 'camel' | 'pascal'): string;
+/**
+ * 确保目录存在，如果不存在则创建
+ *
+ * @param dir - 目录路径
+ */
+declare function ensureDir(dir: string): void;
+/**
+ * 判断文件是否存在
+ *
+ * @param filePath - 文件路径
+ * @returns 文件是否存在
+ */
+declare function fileExists(filePath: string): boolean;
+/**
+ * 获取相对于项目根目录的相对路径
+ *
+ * @param filePath - 文件绝对路径
+ * @param rootDir - 项目根目录
+ * @returns 相对路径
+ */
+declare function getRelativePath(filePath: string, rootDir: string): string; //#endregion
+export { ensureDir, fileExists, findYamlDirectories, findYamlFiles, formatModuleName, getRelativePath, safeReaddir };

package/dist/utils.js

@@ -0,0 +1,3 @@
+import { ensureDir, fileExists, findYamlDirectories, findYamlFiles, formatModuleName, getRelativePath, safeReaddir } from "./utils-BypLbD1p.js";
+
+export { ensureDir, fileExists, findYamlDirectories, findYamlFiles, formatModuleName, getRelativePath, safeReaddir };

package/dist/vite-BKknryyS.js

@@ -0,0 +1,8 @@
+import { unpluginFactory } from "./src-DPpaOQvV.js";
+import { createVitePlugin } from "unplugin";
+
+//#region src/vite.ts
+var vite_default = createVitePlugin(unpluginFactory);
+
+//#endregion
+export { vite_default };

package/dist/vite.d.ts

@@ -0,0 +1,8 @@
+import { Options } from "./types-CpgPraRT.js";
+import * as vite8 from "vite";
+
+//#region src/vite.d.ts
+declare const _default: (options?: Options | undefined) => vite8.Plugin<any> | vite8.Plugin<any>[];
+
+//#endregion
+export { _default as default };

package/dist/vite.js

@@ -0,0 +1,5 @@
+import "./src-DPpaOQvV.js";
+import "./utils-BypLbD1p.js";
+import { vite_default } from "./vite-BKknryyS.js";
+
+export { vite_default as default };

package/dist/webpack-9obP3bLC.js

@@ -0,0 +1,8 @@
+import { unpluginFactory } from "./src-DPpaOQvV.js";
+import { createWebpackPlugin } from "unplugin";
+
+//#region src/webpack.ts
+var webpack_default = createWebpackPlugin(unpluginFactory);
+
+//#endregion
+export { webpack_default };

package/dist/webpack.d.ts

@@ -0,0 +1,8 @@
+import { Options } from "./types-CpgPraRT.js";
+import * as webpack3 from "webpack";
+
+//#region src/webpack.d.ts
+declare const _default: (options?: Options | undefined) => webpack3.WebpackPluginInstance;
+
+//#endregion
+export { _default as default };

package/dist/webpack.js

@@ -0,0 +1,5 @@
+import "./src-DPpaOQvV.js";
+import "./utils-BypLbD1p.js";
+import { webpack_default } from "./webpack-9obP3bLC.js";
+
+export { webpack_default as default };

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "vite-plugin-swagger-typescript-api-transform",
+  "type": "module",
+  "version": "0.0.1",
+  "packageManager": "pnpm@10.11.0",
+  "description": "",
+  "license": "MIT",
+  "homepage": "https://github.com/antfu/unplugin-starter#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/antfu/unplugin-starter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/antfu/unplugin-starter/issues"
+  },
+  "keywords": [
+    "unplugin",
+    "vite",
+    "webpack",
+    "rollup",
+    "transform"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./astro": "./dist/astro.js",
+    "./esbuild": "./dist/esbuild.js",
+    "./farm": "./dist/farm.js",
+    "./nuxt": "./dist/nuxt.js",
+    "./rollup": "./dist/rollup.js",
+    "./rspack": "./dist/rspack.js",
+    "./types": "./dist/types.js",
+    "./vite": "./dist/vite.js",
+    "./webpack": "./dist/webpack.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*",
+        "./*"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown -w",
+    "lint": "eslint .",
+    "play": "npm -C playground run dev",
+    "prepublishOnly": "npm run build",
+    "release": "bumpp && pnpm publish",
+    "start": "tsx src/index.ts",
+    "test": "vitest"
+  },
+  "peerDependencies": {
+    "@farmfe/core": ">=1",
+    "@nuxt/kit": "^3",
+    "@nuxt/schema": "^3",
+    "esbuild": "*",
+    "rollup": "^3",
+    "vite": ">=3",
+    "webpack": "^4 || ^5"
+  },
+  "peerDependenciesMeta": {
+    "@farmfe/core": {
+      "optional": true
+    },
+    "@nuxt/kit": {
+      "optional": true
+    },
+    "@nuxt/schema": {
+      "optional": true
+    },
+    "esbuild": {
+      "optional": true
+    },
+    "rollup": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "webpack": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "lodash-es": "^4.18.1",
+    "unplugin": "^2.3.4"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^4.13.2",
+    "@nuxt/kit": "^3.17.4",
+    "@nuxt/schema": "^3.17.4",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^22.15.21",
+    "bumpp": "^10.1.1",
+    "eslint": "^9.27.0",
+    "nodemon": "^3.1.10",
+    "rollup": "^4.41.0",
+    "swagger-typescript-api": "^13.6.7",
+    "tsdown": "^0.12.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vite": "^6.3.5",
+    "vitest": "^3.1.4",
+    "webpack": "^5.99.9"
+  }
+}