@meng-xi/vite-plugin 0.1.3 → 0.1.5

package/dist/plugins/generateRouter/index.cjs

@@ -1,4 +1,4 @@
-"use strict";const factory_index=require("../../factory/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),common_format_index=require("../../common/format/index.cjs"),f=require("path"),s=require("fs");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs"),require("crypto"),require("node:path");class R extends factory_index.BasePlugin{projectRoot=process.cwd();tabBarPages=new Set;watcher=null;getDefaultOptions(){return{pagesJsonPath:"src/pages.json",outputPath:"src/router.config.ts",outputFormat:"ts",nameStrategy:"camelCase",includeSubPackages:!0,watch:!0,exportTypes:!0,preserveRouteChanges:!0,metaMapping:{navigationBarTitleText:"title",requireAuth:"requireAuth"}}}validateOptions(){if(this.validator.field("pagesJsonPath").string().field("outputPath").string().field("outputFormat").enum(["ts","js"]).field("nameStrategy").enum(["path","camelCase","pascalCase","custom"]).validate(),this.options.nameStrategy==="custom"&&!this.options.customNameGenerator)throw new Error("\u5F53 nameStrategy \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customNameGenerator")}getPluginName(){return"generate-router"}generateRouteName(e){switch(this.options.nameStrategy){case"path":return e.replace(/\//g,"_").replace(/^_/,"");case"camelCase":return common_format_index.toCamelCase(e);case"pascalCase":return common_format_index.toPascalCase(e);case"custom":return this.options.customNameGenerator(e);default:return common_format_index.toCamelCase(e)}}extractMeta(e,u){const t={},a=e.style||{},r=this.options.metaMapping||{};for(const[o,n]of Object.entries(r))a[o]!==void 0&&(t[n]=a[o]);return this.tabBarPages.has(u)&&(t.isTab=!0),t}parsePageToRoute(e,u=""){const t=u?`/${u}/${e.path}`:`/${e.path}`,a=this.generateRouteName(t),r=this.extractMeta(e,t.replace(/^\//,"")),o={path:t,name:a};return Object.keys(r).length>0&&(o.meta=r),o}parsePagesJson(e){const u=[];if(!e.pages||!Array.isArray(e.pages)||e.pages.length===0)return this.logger.warn("pages.json \u4E2D\u6CA1\u6709\u6709\u6548\u7684\u9875\u9762\u914D\u7F6E"),u;if(this.tabBarPages.clear(),e.tabBar?.list)for(const t of e.tabBar.list)this.tabBarPages.add(t.pagePath);for(const t of e.pages)u.push(this.parsePageToRoute(t));if(this.options.includeSubPackages&&e.subPackages){for(const t of e.subPackages)if(t.pages&&Array.isArray(t.pages))for(const a of t.pages)u.push(this.parsePageToRoute(a,t.root))}return u}generateTypeDefinitions(){return!this.options.exportTypes||this.options.outputFormat==="js"?"":`
+"use strict";const factory_index=require("../../factory/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),m=require("path"),n=require("fs");require("../../logger/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs");function u(i,e=/[/-]/){return i.replace(/^\/+/,"").split(e).filter(Boolean).map((t,s)=>s===0?t.toLowerCase():t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()).join("")}function R(i,e=/[/-]/){return i.replace(/^\/+/,"").split(e).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1).toLowerCase()).join("")}function P(i){return i.replace(/\/\/.*$/gm,"").replace(/\/\*[\s\S]*?\*\//g,"")}class d extends factory_index.BasePlugin{projectRoot=process.cwd();tabBarPages=new Set;watcher=null;getDefaultOptions(){return{pagesJsonPath:"src/pages.json",outputPath:"src/router.config.ts",outputFormat:"ts",nameStrategy:"camelCase",includeSubPackages:!0,watch:!0,exportTypes:!0,preserveRouteChanges:!0,metaMapping:{navigationBarTitleText:"title",requireAuth:"requireAuth"}}}validateOptions(){if(this.validator.field("pagesJsonPath").string().field("outputPath").string().field("outputFormat").enum(["ts","js"]).field("nameStrategy").enum(["path","camelCase","pascalCase","custom"]).validate(),this.options.nameStrategy==="custom"&&!this.options.customNameGenerator)throw new Error("\u5F53 nameStrategy \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customNameGenerator")}getPluginName(){return"generate-router"}generateRouteName(e){switch(this.options.nameStrategy){case"path":return e.replace(/\//g,"_").replace(/^_/,"");case"camelCase":return u(e);case"pascalCase":return R(e);case"custom":return this.options.customNameGenerator(e);default:return u(e)}}extractMeta(e,t){const s={},a=e.style||{},r=this.options.metaMapping||{};for(const[o,c]of Object.entries(r))a[o]!==void 0&&(s[c]=a[o]);return this.tabBarPages.has(t)&&(s.isTab=!0),s}parsePageToRoute(e,t=""){const s=t?`/${t}/${e.path}`:`/${e.path}`,a=this.generateRouteName(s),r=this.extractMeta(e,s.replace(/^\//,"")),o={path:s,name:a};return Object.keys(r).length>0&&(o.meta=r),o}parsePagesJson(e){const t=[];if(!e.pages||!Array.isArray(e.pages)||e.pages.length===0)return this.logger.warn("pages.json \u4E2D\u6CA1\u6709\u6709\u6548\u7684\u9875\u9762\u914D\u7F6E"),t;if(this.tabBarPages.clear(),e.tabBar?.list)for(const s of e.tabBar.list)this.tabBarPages.add(s.pagePath);for(const s of e.pages)t.push(this.parsePageToRoute(s));if(this.options.includeSubPackages&&e.subPackages){for(const s of e.subPackages)if(s.pages&&Array.isArray(s.pages))for(const a of s.pages)t.push(this.parsePageToRoute(a,s.root))}return t}generateTypeDefinitions(){return!this.options.exportTypes||this.options.outputFormat==="js"?"":`
 /**
  * \u8DEF\u7531\u5143\u4FE1\u606F
  */
@@ -24,12 +24,12 @@ export interface RouteConfig {
 	/** \u8DEF\u7531\u5143\u4FE1\u606F */
 	meta?: RouteMeta
 }
-`}generateFileContent(e){const u=this.generateTypeDefinitions(),t=this.options.outputFormat==="ts",a=JSON.stringify(e,null,"	").replace(/"(\w+)":/g,"$1:").replace(/: "([^"]+)"/g,": '$1'");return`${u}
+`}generateFileContent(e){const t=this.generateTypeDefinitions(),s=this.options.outputFormat==="ts",a=JSON.stringify(e,null,"	").replace(/"(\w+)":/g,"$1:").replace(/: "([^"]+)"/g,": '$1'");return`${t}
 /**
  * \u8DEF\u7531\u914D\u7F6E\u5217\u8868
  * @description \u7531 pages.json \u81EA\u52A8\u751F\u6210
  */
-export const routes${t?": RouteConfig[]":""} = ${a}
+export const routes${s?": RouteConfig[]":""} = ${a}
 
 export default routes
-`}async readPagesJson(){const e=f.resolve(this.projectRoot,this.options.pagesJsonPath);if(!s.existsSync(e))return this.logger.warn(`pages.json \u6587\u4EF6\u4E0D\u5B58\u5728: ${e}`),null;try{const u=await common_fs_index.readFileContent(e),t=common_format_index.stripJsonComments(u);return JSON.parse(t)}catch(u){return this.logger.error(`\u89E3\u6790 pages.json \u5931\u8D25: ${u.message}`),null}}extractExistingRoutes(e){const u=new Map,t=e.match(/export const routes[^=]*=\s*(\[[\s\S]*?\](?=\s*\n|\s*$|\s*\/\/))/);if(!t)return u;try{let a=t[1].replace(/(\w+)(?=\s*:)/g,'"$1"').replace(/'([^']*)'/g,'"$1"').replace(/,\s*([\]\}])/g,"$1");const r=JSON.parse(a);for(const o of r)o.path&&u.set(o.path,o)}catch{this.logger.warn("\u89E3\u6790\u73B0\u6709 routes \u914D\u7F6E\u5931\u8D25\uFF0C\u5C06\u5B8C\u5168\u91CD\u65B0\u751F\u6210")}return u}mergeRoutes(e,u){return e.map(t=>{const a=u.get(t.path);if(!a)return t;const r={};return t.meta&&Object.assign(r,t.meta),a.meta&&Object.assign(r,a.meta),{...a,path:t.path,meta:Object.keys(r).length>0?r:void 0}})}async generateRouterConfig(){const e=await this.readPagesJson();if(!e)return;let u=this.parsePagesJson(e);const t=f.resolve(this.projectRoot,this.options.outputPath);if(this.options.preserveRouteChanges&&s.existsSync(t))try{const r=await common_fs_index.readFileContent(t),o=this.extractExistingRoutes(r);o.size>0&&(u=this.mergeRoutes(u,o),this.logger.info("\u5DF2\u5408\u5E76\u7528\u6237\u5BF9\u8DEF\u7531\u914D\u7F6E\u7684\u4FEE\u6539"))}catch{}const a=this.generateFileContent(u);await common_fs_index.writeFileContent(t,a),this.logger.success(`\u8DEF\u7531\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210: ${t}`),this.logger.info(`\u5171\u751F\u6210 ${u.length} \u6761\u8DEF\u7531\u914D\u7F6E`)}startWatching(){if(!this.options.watch)return;const e=f.resolve(this.projectRoot,this.options.pagesJsonPath);s.existsSync(e)&&(this.watcher=s.watch(e,async u=>{u==="change"&&(this.logger.info("\u68C0\u6D4B\u5230 pages.json \u53D8\u5316\uFF0C\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E..."),await this.safeExecute(()=>this.generateRouterConfig(),"\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E"))}),this.logger.info(`\u6B63\u5728\u76D1\u542C pages.json \u53D8\u5316: ${e}`))}stopWatching(){this.watcher&&(this.watcher.close(),this.watcher=null)}addPluginHooks(e){e.configResolved=async u=>{this.projectRoot=u.root,await this.safeExecute(()=>this.generateRouterConfig(),"\u751F\u6210\u8DEF\u7531\u914D\u7F6E"),u.command==="serve"&&this.startWatching()}}destroy(){super.destroy(),this.stopWatching()}}const generateRouter=factory_index.createPluginFactory(R);exports.generateRouter=generateRouter;
+`}async readPagesJson(){const e=m.resolve(this.projectRoot,this.options.pagesJsonPath);if(!n.existsSync(e))return this.logger.warn(`pages.json \u6587\u4EF6\u4E0D\u5B58\u5728: ${e}`),null;try{const t=await n.promises.readFile(e,"utf-8"),s=P(t);return JSON.parse(s)}catch(t){return this.logger.error(`\u89E3\u6790 pages.json \u5931\u8D25: ${t.message}`),null}}extractExistingRoutes(e){const t=new Map,s=e.match(/export const routes[^=]*=\s*(\[[\s\S]*?\](?=\s*\n|\s*$|\s*\/\/))/);if(!s)return t;try{let a=s[1].replace(/(\w+)(?=\s*:)/g,'"$1"').replace(/'([^']*)'/g,'"$1"').replace(/,\s*([\]\}])/g,"$1");const r=JSON.parse(a);for(const o of r)o.path&&t.set(o.path,o)}catch{this.logger.warn("\u89E3\u6790\u73B0\u6709 routes \u914D\u7F6E\u5931\u8D25\uFF0C\u5C06\u5B8C\u5168\u91CD\u65B0\u751F\u6210")}return t}mergeRoutes(e,t){return e.map(s=>{const a=t.get(s.path);if(!a)return s;const r={};return s.meta&&Object.assign(r,s.meta),a.meta&&Object.assign(r,a.meta),{...a,path:s.path,meta:Object.keys(r).length>0?r:void 0}})}async generateRouterConfig(){const e=await this.readPagesJson();if(!e)return;let t=this.parsePagesJson(e);const s=m.resolve(this.projectRoot,this.options.outputPath);if(this.options.preserveRouteChanges&&n.existsSync(s))try{const r=await n.promises.readFile(s,"utf-8"),o=this.extractExistingRoutes(r);o.size>0&&(t=this.mergeRoutes(t,o),this.logger.info("\u5DF2\u5408\u5E76\u7528\u6237\u5BF9\u8DEF\u7531\u914D\u7F6E\u7684\u4FEE\u6539"))}catch{}const a=this.generateFileContent(t);await common_fs_index.writeFileContent(s,a),this.logger.success(`\u8DEF\u7531\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210: ${s}`),this.logger.info(`\u5171\u751F\u6210 ${t.length} \u6761\u8DEF\u7531\u914D\u7F6E`)}startWatching(){if(!this.options.watch)return;const e=m.resolve(this.projectRoot,this.options.pagesJsonPath);n.existsSync(e)&&(this.watcher=n.watch(e,async t=>{t==="change"&&(this.logger.info("\u68C0\u6D4B\u5230 pages.json \u53D8\u5316\uFF0C\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E..."),await this.safeExecute(()=>this.generateRouterConfig(),"\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E"))}),this.logger.info(`\u6B63\u5728\u76D1\u542C pages.json \u53D8\u5316: ${e}`))}stopWatching(){this.watcher&&(this.watcher.close(),this.watcher=null)}addPluginHooks(e){e.configResolved=async t=>{this.projectRoot=t.root,await this.safeExecute(()=>this.generateRouterConfig(),"\u751F\u6210\u8DEF\u7531\u914D\u7F6E"),t.command==="serve"&&this.startWatching()}}destroy(){super.destroy(),this.stopWatching()}}const generateRouter=factory_index.createPluginFactory(d);exports.generateRouter=generateRouter;

package/dist/plugins/generateRouter/index.d.cts

@@ -1,41 +1,51 @@
 import { BasePluginOptions, PluginFactory } from '../../factory/index.cjs';
 import 'vite';
-import '../../shared/vite-plugin.CLr0ttuO.cjs';
+import '../../shared/vite-plugin.B8FuZce1.cjs';
 import '../../shared/vite-plugin.DRRlWY8P.cjs';
 
 /**
  * 路由元信息
+ *
+ * @interface RouteMeta
+ * @description 路由附加的元数据，用于页面导航守卫、标题设置等场景。
+ * 支持通过索引签名扩展自定义字段。
  */
 interface RouteMeta {
-    /** 页面标题 */
+    /** 页面标题，对应 pages.json 中的 navigationBarTitleText */
     title?: string;
-    /** 是否为TabBar页面 */
+    /** 是否为 TabBar 页面，由插件自动从 tabBar 配置推断 */
     isTab?: boolean;
-    /** 是否需要登录 */
+    /** 是否需要登录才能访问 */
     requireAuth?: boolean;
     /** 自定义扩展字段 */
     [key: string]: unknown;
 }
 /**
  * 路由配置项
+ *
+ * @interface RouteConfig
+ * @description 单条路由的完整配置，包含路径、名称和元信息。
  */
 interface RouteConfig {
-    /** 路由路径 */
+    /** 路由路径，以 `/` 开头 */
     path: string;
-    /** 路由名称（用于命名路由导航） */
+    /** 路由名称（用于命名路由导航），根据 nameStrategy 自动生成 */
     name?: string;
     /** 路由元信息 */
     meta?: RouteMeta;
 }
 /**
  * uni-app pages.json 中的页面配置项
+ *
+ * @interface UniAppPageConfig
+ * @description 对应 pages.json 中 `pages` 数组里的单个页面对象。
  */
 interface UniAppPageConfig {
-    /** 页面路径 */
+    /** 页面路径，相对于 pages.json 所在目录 */
     path: string;
-    /** 页面样式 */
+    /** 页面样式配置 */
     style?: {
-        /** 导航栏标题 */
+        /** 导航栏标题文本 */
         navigationBarTitleText?: string;
         /** 是否需要登录 */
         requireAuth?: boolean;
@@ -47,15 +57,18 @@ interface UniAppPageConfig {
 }
 /**
  * uni-app pages.json 中的 tabBar 配置
+ *
+ * @interface UniAppTabBarConfig
+ * @description 对应 pages.json 中的 `tabBar` 字段，定义底部标签栏的页面列表和图标。
  */
 interface UniAppTabBarConfig {
-    /** tabBar 列表 */
+    /** tabBar 页面列表 */
     list?: Array<{
         /** 页面路径 */
         pagePath: string;
-        /** 文字 */
+        /** 标签文字 */
         text?: string;
-        /** 图标路径 */
+        /** 未选中图标路径 */
         iconPath?: string;
         /** 选中图标路径 */
         selectedIconPath?: string;
@@ -65,32 +78,66 @@ interface UniAppTabBarConfig {
 }
 /**
  * uni-app pages.json 结构
+ *
+ * @interface UniAppPagesJson
+ * @description 完整的 pages.json 文件结构，包含主包页面、子包、tabBar 和全局样式。
  */
 interface UniAppPagesJson {
-    /** 页面列表 */
+    /** 主包页面列表 */
     pages: UniAppPageConfig[];
-    /** 子包 */
+    /** 子包（分包）配置列表 */
     subPackages?: Array<{
+        /** 子包根路径 */
         root: string;
+        /** 子包页面列表 */
         pages: UniAppPageConfig[];
     }>;
     /** tabBar 配置 */
     tabBar?: UniAppTabBarConfig;
-    /** 全局样式 */
+    /** 全局样式配置 */
     globalStyle?: Record<string, unknown>;
     /** 其他属性 */
     [key: string]: unknown;
 }
 /**
  * 输出文件格式类型
+ *
+ * @description 支持的输出文件格式：
+ * - `ts`: TypeScript 文件
+ * - `js`: JavaScript 文件
  */
 type OutputFormat = 'ts' | 'js';
 /**
  * 路由名称生成策略
+ *
+ * @description 定义路由名称的生成方式：
+ * - `path`: 使用原始路径（斜杠替换为下划线）
+ * - `camelCase`: 驼峰命名（默认）
+ * - `pascalCase`: 帕斯卡命名
+ * - `custom`: 自定义生成函数
  */
 type NameStrategy = 'path' | 'camelCase' | 'pascalCase' | 'custom';
 /**
  * 生成路由配置插件选项
+ *
+ * @interface GenerateRouterOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * generateRouter({
+ *   pagesJsonPath: 'src/pages.json',
+ *   outputPath: 'src/router.config.ts',
+ *   outputFormat: 'ts',
+ *   nameStrategy: 'camelCase',
+ *   includeSubPackages: true,
+ *   watch: true,
+ *   metaMapping: {
+ *     navigationBarTitleText: 'title',
+ *     requireAuth: 'requireAuth'
+ *   }
+ * })
+ * ```
  */
 interface GenerateRouterOptions extends BasePluginOptions {
     /**

package/dist/plugins/generateRouter/index.d.mts

@@ -1,41 +1,51 @@
 import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
 import 'vite';
-import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.B8FuZce1.mjs';
 import '../../shared/vite-plugin.DRRlWY8P.mjs';
 
 /**
  * 路由元信息
+ *
+ * @interface RouteMeta
+ * @description 路由附加的元数据，用于页面导航守卫、标题设置等场景。
+ * 支持通过索引签名扩展自定义字段。
  */
 interface RouteMeta {
-    /** 页面标题 */
+    /** 页面标题，对应 pages.json 中的 navigationBarTitleText */
     title?: string;
-    /** 是否为TabBar页面 */
+    /** 是否为 TabBar 页面，由插件自动从 tabBar 配置推断 */
     isTab?: boolean;
-    /** 是否需要登录 */
+    /** 是否需要登录才能访问 */
     requireAuth?: boolean;
     /** 自定义扩展字段 */
     [key: string]: unknown;
 }
 /**
  * 路由配置项
+ *
+ * @interface RouteConfig
+ * @description 单条路由的完整配置，包含路径、名称和元信息。
  */
 interface RouteConfig {
-    /** 路由路径 */
+    /** 路由路径，以 `/` 开头 */
     path: string;
-    /** 路由名称（用于命名路由导航） */
+    /** 路由名称（用于命名路由导航），根据 nameStrategy 自动生成 */
     name?: string;
     /** 路由元信息 */
     meta?: RouteMeta;
 }
 /**
  * uni-app pages.json 中的页面配置项
+ *
+ * @interface UniAppPageConfig
+ * @description 对应 pages.json 中 `pages` 数组里的单个页面对象。
  */
 interface UniAppPageConfig {
-    /** 页面路径 */
+    /** 页面路径，相对于 pages.json 所在目录 */
     path: string;
-    /** 页面样式 */
+    /** 页面样式配置 */
     style?: {
-        /** 导航栏标题 */
+        /** 导航栏标题文本 */
         navigationBarTitleText?: string;
         /** 是否需要登录 */
         requireAuth?: boolean;
@@ -47,15 +57,18 @@ interface UniAppPageConfig {
 }
 /**
  * uni-app pages.json 中的 tabBar 配置
+ *
+ * @interface UniAppTabBarConfig
+ * @description 对应 pages.json 中的 `tabBar` 字段，定义底部标签栏的页面列表和图标。
  */
 interface UniAppTabBarConfig {
-    /** tabBar 列表 */
+    /** tabBar 页面列表 */
     list?: Array<{
         /** 页面路径 */
         pagePath: string;
-        /** 文字 */
+        /** 标签文字 */
         text?: string;
-        /** 图标路径 */
+        /** 未选中图标路径 */
         iconPath?: string;
         /** 选中图标路径 */
         selectedIconPath?: string;
@@ -65,32 +78,66 @@ interface UniAppTabBarConfig {
 }
 /**
  * uni-app pages.json 结构
+ *
+ * @interface UniAppPagesJson
+ * @description 完整的 pages.json 文件结构，包含主包页面、子包、tabBar 和全局样式。
  */
 interface UniAppPagesJson {
-    /** 页面列表 */
+    /** 主包页面列表 */
     pages: UniAppPageConfig[];
-    /** 子包 */
+    /** 子包（分包）配置列表 */
     subPackages?: Array<{
+        /** 子包根路径 */
         root: string;
+        /** 子包页面列表 */
         pages: UniAppPageConfig[];
     }>;
     /** tabBar 配置 */
     tabBar?: UniAppTabBarConfig;
-    /** 全局样式 */
+    /** 全局样式配置 */
     globalStyle?: Record<string, unknown>;
     /** 其他属性 */
     [key: string]: unknown;
 }
 /**
  * 输出文件格式类型
+ *
+ * @description 支持的输出文件格式：
+ * - `ts`: TypeScript 文件
+ * - `js`: JavaScript 文件
  */
 type OutputFormat = 'ts' | 'js';
 /**
  * 路由名称生成策略
+ *
+ * @description 定义路由名称的生成方式：
+ * - `path`: 使用原始路径（斜杠替换为下划线）
+ * - `camelCase`: 驼峰命名（默认）
+ * - `pascalCase`: 帕斯卡命名
+ * - `custom`: 自定义生成函数
  */
 type NameStrategy = 'path' | 'camelCase' | 'pascalCase' | 'custom';
 /**
  * 生成路由配置插件选项
+ *
+ * @interface GenerateRouterOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * generateRouter({
+ *   pagesJsonPath: 'src/pages.json',
+ *   outputPath: 'src/router.config.ts',
+ *   outputFormat: 'ts',
+ *   nameStrategy: 'camelCase',
+ *   includeSubPackages: true,
+ *   watch: true,
+ *   metaMapping: {
+ *     navigationBarTitleText: 'title',
+ *     requireAuth: 'requireAuth'
+ *   }
+ * })
+ * ```
  */
 interface GenerateRouterOptions extends BasePluginOptions {
     /**

package/dist/plugins/generateRouter/index.d.ts

@@ -1,41 +1,51 @@
 import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
 import 'vite';
-import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.B8FuZce1.js';
 import '../../shared/vite-plugin.DRRlWY8P.js';
 
 /**
  * 路由元信息
+ *
+ * @interface RouteMeta
+ * @description 路由附加的元数据，用于页面导航守卫、标题设置等场景。
+ * 支持通过索引签名扩展自定义字段。
  */
 interface RouteMeta {
-    /** 页面标题 */
+    /** 页面标题，对应 pages.json 中的 navigationBarTitleText */
     title?: string;
-    /** 是否为TabBar页面 */
+    /** 是否为 TabBar 页面，由插件自动从 tabBar 配置推断 */
     isTab?: boolean;
-    /** 是否需要登录 */
+    /** 是否需要登录才能访问 */
     requireAuth?: boolean;
     /** 自定义扩展字段 */
     [key: string]: unknown;
 }
 /**
  * 路由配置项
+ *
+ * @interface RouteConfig
+ * @description 单条路由的完整配置，包含路径、名称和元信息。
  */
 interface RouteConfig {
-    /** 路由路径 */
+    /** 路由路径，以 `/` 开头 */
     path: string;
-    /** 路由名称（用于命名路由导航） */
+    /** 路由名称（用于命名路由导航），根据 nameStrategy 自动生成 */
     name?: string;
     /** 路由元信息 */
     meta?: RouteMeta;
 }
 /**
  * uni-app pages.json 中的页面配置项
+ *
+ * @interface UniAppPageConfig
+ * @description 对应 pages.json 中 `pages` 数组里的单个页面对象。
  */
 interface UniAppPageConfig {
-    /** 页面路径 */
+    /** 页面路径，相对于 pages.json 所在目录 */
     path: string;
-    /** 页面样式 */
+    /** 页面样式配置 */
     style?: {
-        /** 导航栏标题 */
+        /** 导航栏标题文本 */
         navigationBarTitleText?: string;
         /** 是否需要登录 */
         requireAuth?: boolean;
@@ -47,15 +57,18 @@ interface UniAppPageConfig {
 }
 /**
  * uni-app pages.json 中的 tabBar 配置
+ *
+ * @interface UniAppTabBarConfig
+ * @description 对应 pages.json 中的 `tabBar` 字段，定义底部标签栏的页面列表和图标。
  */
 interface UniAppTabBarConfig {
-    /** tabBar 列表 */
+    /** tabBar 页面列表 */
     list?: Array<{
         /** 页面路径 */
         pagePath: string;
-        /** 文字 */
+        /** 标签文字 */
         text?: string;
-        /** 图标路径 */
+        /** 未选中图标路径 */
         iconPath?: string;
         /** 选中图标路径 */
         selectedIconPath?: string;
@@ -65,32 +78,66 @@ interface UniAppTabBarConfig {
 }
 /**
  * uni-app pages.json 结构
+ *
+ * @interface UniAppPagesJson
+ * @description 完整的 pages.json 文件结构，包含主包页面、子包、tabBar 和全局样式。
  */
 interface UniAppPagesJson {
-    /** 页面列表 */
+    /** 主包页面列表 */
     pages: UniAppPageConfig[];
-    /** 子包 */
+    /** 子包（分包）配置列表 */
     subPackages?: Array<{
+        /** 子包根路径 */
         root: string;
+        /** 子包页面列表 */
         pages: UniAppPageConfig[];
     }>;
     /** tabBar 配置 */
     tabBar?: UniAppTabBarConfig;
-    /** 全局样式 */
+    /** 全局样式配置 */
     globalStyle?: Record<string, unknown>;
     /** 其他属性 */
     [key: string]: unknown;
 }
 /**
  * 输出文件格式类型
+ *
+ * @description 支持的输出文件格式：
+ * - `ts`: TypeScript 文件
+ * - `js`: JavaScript 文件
  */
 type OutputFormat = 'ts' | 'js';
 /**
  * 路由名称生成策略
+ *
+ * @description 定义路由名称的生成方式：
+ * - `path`: 使用原始路径（斜杠替换为下划线）
+ * - `camelCase`: 驼峰命名（默认）
+ * - `pascalCase`: 帕斯卡命名
+ * - `custom`: 自定义生成函数
  */
 type NameStrategy = 'path' | 'camelCase' | 'pascalCase' | 'custom';
 /**
  * 生成路由配置插件选项
+ *
+ * @interface GenerateRouterOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * generateRouter({
+ *   pagesJsonPath: 'src/pages.json',
+ *   outputPath: 'src/router.config.ts',
+ *   outputFormat: 'ts',
+ *   nameStrategy: 'camelCase',
+ *   includeSubPackages: true,
+ *   watch: true,
+ *   metaMapping: {
+ *     navigationBarTitleText: 'title',
+ *     requireAuth: 'requireAuth'
+ *   }
+ * })
+ * ```
  */
 interface GenerateRouterOptions extends BasePluginOptions {
     /**

package/dist/plugins/generateRouter/index.mjs

@@ -1,4 +1,4 @@
-import{createPluginFactory as p,BasePlugin as h}from"../../factory/index.mjs";import{readFileContent as i,writeFileContent as l}from"../../common/fs/index.mjs";import{toCamelCase as g,toPascalCase as F,stripJsonComments as m}from"../../common/format/index.mjs";import{resolve as r}from"path";import{existsSync as n,watch as f}from"fs";import"../../logger/index.mjs";import"../../common/object/index.mjs";import"../../shared/vite-plugin.DcExl6jd.mjs";import"crypto";import"node:path";class E extends h{projectRoot=process.cwd();tabBarPages=new Set;watcher=null;getDefaultOptions(){return{pagesJsonPath:"src/pages.json",outputPath:"src/router.config.ts",outputFormat:"ts",nameStrategy:"camelCase",includeSubPackages:!0,watch:!0,exportTypes:!0,preserveRouteChanges:!0,metaMapping:{navigationBarTitleText:"title",requireAuth:"requireAuth"}}}validateOptions(){if(this.validator.field("pagesJsonPath").string().field("outputPath").string().field("outputFormat").enum(["ts","js"]).field("nameStrategy").enum(["path","camelCase","pascalCase","custom"]).validate(),this.options.nameStrategy==="custom"&&!this.options.customNameGenerator)throw new Error("\u5F53 nameStrategy \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customNameGenerator")}getPluginName(){return"generate-router"}generateRouteName(t){switch(this.options.nameStrategy){case"path":return t.replace(/\//g,"_").replace(/^_/,"");case"camelCase":return g(t);case"pascalCase":return F(t);case"custom":return this.options.customNameGenerator(t);default:return g(t)}}extractMeta(t,u){const e={},s=t.style||{},a=this.options.metaMapping||{};for(const[o,c]of Object.entries(a))s[o]!==void 0&&(e[c]=s[o]);return this.tabBarPages.has(u)&&(e.isTab=!0),e}parsePageToRoute(t,u=""){const e=u?`/${u}/${t.path}`:`/${t.path}`,s=this.generateRouteName(e),a=this.extractMeta(t,e.replace(/^\//,"")),o={path:e,name:s};return Object.keys(a).length>0&&(o.meta=a),o}parsePagesJson(t){const u=[];if(!t.pages||!Array.isArray(t.pages)||t.pages.length===0)return this.logger.warn("pages.json \u4E2D\u6CA1\u6709\u6709\u6548\u7684\u9875\u9762\u914D\u7F6E"),u;if(this.tabBarPages.clear(),t.tabBar?.list)for(const e of t.tabBar.list)this.tabBarPages.add(e.pagePath);for(const e of t.pages)u.push(this.parsePageToRoute(e));if(this.options.includeSubPackages&&t.subPackages){for(const e of t.subPackages)if(e.pages&&Array.isArray(e.pages))for(const s of e.pages)u.push(this.parsePageToRoute(s,e.root))}return u}generateTypeDefinitions(){return!this.options.exportTypes||this.options.outputFormat==="js"?"":`
+import{createPluginFactory as h,BasePlugin as l}from"../../factory/index.mjs";import{writeFileContent as F}from"../../common/fs/index.mjs";import{resolve as n}from"path";import{existsSync as i,promises as c,watch as f}from"fs";import"../../logger/index.mjs";import"../../shared/vite-plugin.DcExl6jd.mjs";function p(o,t=/[/-]/){return o.replace(/^\/+/,"").split(t).filter(Boolean).map((e,u)=>u===0?e.toLowerCase():e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join("")}function m(o,t=/[/-]/){return o.replace(/^\/+/,"").split(t).filter(Boolean).map(e=>e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()).join("")}function E(o){return o.replace(/\/\/.*$/gm,"").replace(/\/\*[\s\S]*?\*\//g,"")}class D extends l{projectRoot=process.cwd();tabBarPages=new Set;watcher=null;getDefaultOptions(){return{pagesJsonPath:"src/pages.json",outputPath:"src/router.config.ts",outputFormat:"ts",nameStrategy:"camelCase",includeSubPackages:!0,watch:!0,exportTypes:!0,preserveRouteChanges:!0,metaMapping:{navigationBarTitleText:"title",requireAuth:"requireAuth"}}}validateOptions(){if(this.validator.field("pagesJsonPath").string().field("outputPath").string().field("outputFormat").enum(["ts","js"]).field("nameStrategy").enum(["path","camelCase","pascalCase","custom"]).validate(),this.options.nameStrategy==="custom"&&!this.options.customNameGenerator)throw new Error("\u5F53 nameStrategy \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customNameGenerator")}getPluginName(){return"generate-router"}generateRouteName(t){switch(this.options.nameStrategy){case"path":return t.replace(/\//g,"_").replace(/^_/,"");case"camelCase":return p(t);case"pascalCase":return m(t);case"custom":return this.options.customNameGenerator(t);default:return p(t)}}extractMeta(t,e){const u={},s=t.style||{},a=this.options.metaMapping||{};for(const[r,g]of Object.entries(a))s[r]!==void 0&&(u[g]=s[r]);return this.tabBarPages.has(e)&&(u.isTab=!0),u}parsePageToRoute(t,e=""){const u=e?`/${e}/${t.path}`:`/${t.path}`,s=this.generateRouteName(u),a=this.extractMeta(t,u.replace(/^\//,"")),r={path:u,name:s};return Object.keys(a).length>0&&(r.meta=a),r}parsePagesJson(t){const e=[];if(!t.pages||!Array.isArray(t.pages)||t.pages.length===0)return this.logger.warn("pages.json \u4E2D\u6CA1\u6709\u6709\u6548\u7684\u9875\u9762\u914D\u7F6E"),e;if(this.tabBarPages.clear(),t.tabBar?.list)for(const u of t.tabBar.list)this.tabBarPages.add(u.pagePath);for(const u of t.pages)e.push(this.parsePageToRoute(u));if(this.options.includeSubPackages&&t.subPackages){for(const u of t.subPackages)if(u.pages&&Array.isArray(u.pages))for(const s of u.pages)e.push(this.parsePageToRoute(s,u.root))}return e}generateTypeDefinitions(){return!this.options.exportTypes||this.options.outputFormat==="js"?"":`
 /**
  * \u8DEF\u7531\u5143\u4FE1\u606F
  */
@@ -24,12 +24,12 @@ export interface RouteConfig {
 	/** \u8DEF\u7531\u5143\u4FE1\u606F */
 	meta?: RouteMeta
 }
-`}generateFileContent(t){const u=this.generateTypeDefinitions(),e=this.options.outputFormat==="ts",s=JSON.stringify(t,null,"	").replace(/"(\w+)":/g,"$1:").replace(/: "([^"]+)"/g,": '$1'");return`${u}
+`}generateFileContent(t){const e=this.generateTypeDefinitions(),u=this.options.outputFormat==="ts",s=JSON.stringify(t,null,"	").replace(/"(\w+)":/g,"$1:").replace(/: "([^"]+)"/g,": '$1'");return`${e}
 /**
  * \u8DEF\u7531\u914D\u7F6E\u5217\u8868
  * @description \u7531 pages.json \u81EA\u52A8\u751F\u6210
  */
-export const routes${e?": RouteConfig[]":""} = ${s}
+export const routes${u?": RouteConfig[]":""} = ${s}
 
 export default routes
-`}async readPagesJson(){const t=r(this.projectRoot,this.options.pagesJsonPath);if(!n(t))return this.logger.warn(`pages.json \u6587\u4EF6\u4E0D\u5B58\u5728: ${t}`),null;try{const u=await i(t),e=m(u);return JSON.parse(e)}catch(u){return this.logger.error(`\u89E3\u6790 pages.json \u5931\u8D25: ${u.message}`),null}}extractExistingRoutes(t){const u=new Map,e=t.match(/export const routes[^=]*=\s*(\[[\s\S]*?\](?=\s*\n|\s*$|\s*\/\/))/);if(!e)return u;try{let s=e[1].replace(/(\w+)(?=\s*:)/g,'"$1"').replace(/'([^']*)'/g,'"$1"').replace(/,\s*([\]\}])/g,"$1");const a=JSON.parse(s);for(const o of a)o.path&&u.set(o.path,o)}catch{this.logger.warn("\u89E3\u6790\u73B0\u6709 routes \u914D\u7F6E\u5931\u8D25\uFF0C\u5C06\u5B8C\u5168\u91CD\u65B0\u751F\u6210")}return u}mergeRoutes(t,u){return t.map(e=>{const s=u.get(e.path);if(!s)return e;const a={};return e.meta&&Object.assign(a,e.meta),s.meta&&Object.assign(a,s.meta),{...s,path:e.path,meta:Object.keys(a).length>0?a:void 0}})}async generateRouterConfig(){const t=await this.readPagesJson();if(!t)return;let u=this.parsePagesJson(t);const e=r(this.projectRoot,this.options.outputPath);if(this.options.preserveRouteChanges&&n(e))try{const a=await i(e),o=this.extractExistingRoutes(a);o.size>0&&(u=this.mergeRoutes(u,o),this.logger.info("\u5DF2\u5408\u5E76\u7528\u6237\u5BF9\u8DEF\u7531\u914D\u7F6E\u7684\u4FEE\u6539"))}catch{}const s=this.generateFileContent(u);await l(e,s),this.logger.success(`\u8DEF\u7531\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210: ${e}`),this.logger.info(`\u5171\u751F\u6210 ${u.length} \u6761\u8DEF\u7531\u914D\u7F6E`)}startWatching(){if(!this.options.watch)return;const t=r(this.projectRoot,this.options.pagesJsonPath);n(t)&&(this.watcher=f(t,async u=>{u==="change"&&(this.logger.info("\u68C0\u6D4B\u5230 pages.json \u53D8\u5316\uFF0C\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E..."),await this.safeExecute(()=>this.generateRouterConfig(),"\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E"))}),this.logger.info(`\u6B63\u5728\u76D1\u542C pages.json \u53D8\u5316: ${t}`))}stopWatching(){this.watcher&&(this.watcher.close(),this.watcher=null)}addPluginHooks(t){t.configResolved=async u=>{this.projectRoot=u.root,await this.safeExecute(()=>this.generateRouterConfig(),"\u751F\u6210\u8DEF\u7531\u914D\u7F6E"),u.command==="serve"&&this.startWatching()}}destroy(){super.destroy(),this.stopWatching()}}const D=p(E);export{D as generateRouter};
+`}async readPagesJson(){const t=n(this.projectRoot,this.options.pagesJsonPath);if(!i(t))return this.logger.warn(`pages.json \u6587\u4EF6\u4E0D\u5B58\u5728: ${t}`),null;try{const e=await c.readFile(t,"utf-8"),u=E(e);return JSON.parse(u)}catch(e){return this.logger.error(`\u89E3\u6790 pages.json \u5931\u8D25: ${e.message}`),null}}extractExistingRoutes(t){const e=new Map,u=t.match(/export const routes[^=]*=\s*(\[[\s\S]*?\](?=\s*\n|\s*$|\s*\/\/))/);if(!u)return e;try{let s=u[1].replace(/(\w+)(?=\s*:)/g,'"$1"').replace(/'([^']*)'/g,'"$1"').replace(/,\s*([\]\}])/g,"$1");const a=JSON.parse(s);for(const r of a)r.path&&e.set(r.path,r)}catch{this.logger.warn("\u89E3\u6790\u73B0\u6709 routes \u914D\u7F6E\u5931\u8D25\uFF0C\u5C06\u5B8C\u5168\u91CD\u65B0\u751F\u6210")}return e}mergeRoutes(t,e){return t.map(u=>{const s=e.get(u.path);if(!s)return u;const a={};return u.meta&&Object.assign(a,u.meta),s.meta&&Object.assign(a,s.meta),{...s,path:u.path,meta:Object.keys(a).length>0?a:void 0}})}async generateRouterConfig(){const t=await this.readPagesJson();if(!t)return;let e=this.parsePagesJson(t);const u=n(this.projectRoot,this.options.outputPath);if(this.options.preserveRouteChanges&&i(u))try{const a=await c.readFile(u,"utf-8"),r=this.extractExistingRoutes(a);r.size>0&&(e=this.mergeRoutes(e,r),this.logger.info("\u5DF2\u5408\u5E76\u7528\u6237\u5BF9\u8DEF\u7531\u914D\u7F6E\u7684\u4FEE\u6539"))}catch{}const s=this.generateFileContent(e);await F(u,s),this.logger.success(`\u8DEF\u7531\u914D\u7F6E\u6587\u4EF6\u5DF2\u751F\u6210: ${u}`),this.logger.info(`\u5171\u751F\u6210 ${e.length} \u6761\u8DEF\u7531\u914D\u7F6E`)}startWatching(){if(!this.options.watch)return;const t=n(this.projectRoot,this.options.pagesJsonPath);i(t)&&(this.watcher=f(t,async e=>{e==="change"&&(this.logger.info("\u68C0\u6D4B\u5230 pages.json \u53D8\u5316\uFF0C\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E..."),await this.safeExecute(()=>this.generateRouterConfig(),"\u91CD\u65B0\u751F\u6210\u8DEF\u7531\u914D\u7F6E"))}),this.logger.info(`\u6B63\u5728\u76D1\u542C pages.json \u53D8\u5316: ${t}`))}stopWatching(){this.watcher&&(this.watcher.close(),this.watcher=null)}addPluginHooks(t){t.configResolved=async e=>{this.projectRoot=e.root,await this.safeExecute(()=>this.generateRouterConfig(),"\u751F\u6210\u8DEF\u7531\u914D\u7F6E"),e.command==="serve"&&this.startWatching()}}destroy(){super.destroy(),this.stopWatching()}}const C=h(D);export{C as generateRouter};

package/dist/plugins/generateVersion/index.cjs

@@ -1 +1 @@
-"use strict";const factory_index=require("../../factory/index.cjs"),common_format_index=require("../../common/format/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),f$1=require("path");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs"),require("crypto"),require("node:path"),require("fs");class f extends factory_index.BasePlugin{version="";buildTime=new Date;getDefaultOptions(){return{format:"timestamp",semverBase:"1.0.0",outputType:"file",outputFile:"version.json",defineName:"__APP_VERSION__",hashLength:8,prefix:"",suffix:""}}validateOptions(){if(this.validator.field("format").enum(["timestamp","date","datetime","semver","hash","custom"]).field("outputType").enum(["file","define","both"]).field("hashLength").number().minValue(1).maxValue(32).validate(),this.options.format==="custom"&&!this.options.customFormat)throw new Error("\u5F53 format \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customFormat")}getPluginName(){return"generate-version"}generateVersion(){const e=common_format_index.getDateFormatParams(this.buildTime),t=common_format_index.generateRandomHash(this.options.hashLength);let i;switch(this.options.format){case"timestamp":i=`${e.YYYY}${e.MM}${e.DD}${e.HH}${e.mm}${e.ss}`;break;case"date":i=`${e.YYYY}.${e.MM}.${e.DD}`;break;case"datetime":i=`${e.YYYY}.${e.MM}.${e.DD}.${e.HH}${e.mm}${e.ss}`;break;case"semver":i=this.options.semverBase||"1.0.0";break;case"hash":i=t;break;case"custom":i=this.parseCustomFormat({...e,hash:t});break;default:i=e.timestamp}const s=this.options.prefix||"",o=this.options.suffix||"";return`${s}${i}${o}`}parseCustomFormat(e){const t={...e};if(this.options.semverBase){const[i,s,o]=this.options.semverBase.split(".");t.major=i||"1",t.minor=s||"0",t.patch=o||"0"}return common_format_index.parseTemplate(this.options.customFormat||"",t)}generateVersionInfo(){return{version:this.version,buildTime:this.buildTime.toISOString(),timestamp:this.buildTime.getTime(),format:this.options.format,...this.options.extra}}async writeVersionFile(e){const t=f$1.join(e,this.options.outputFile||"version.json"),i=this.generateVersionInfo();await common_fs_index.writeFileContent(t,JSON.stringify(i,null,2)),this.logger.success(`\u7248\u672C\u6587\u4EF6\u5DF2\u751F\u6210: ${t}`)}addPluginHooks(e){e.configResolved=()=>{this.buildTime=new Date,this.version=this.generateVersion(),this.logger.info(`\u751F\u6210\u7248\u672C\u53F7: ${this.version}`)},(this.options.outputType==="define"||this.options.outputType==="both")&&(e.config=()=>{this.version||(this.buildTime=new Date,this.version=this.generateVersion());const t=this.options.defineName||"__APP_VERSION__";return this.logger.info(`\u6CE8\u5165\u5168\u5C40\u53D8\u91CF: ${t} = "${this.version}"`),{define:{[t]:JSON.stringify(this.version),[`${t}_INFO`]:JSON.stringify(this.generateVersionInfo())}}}),(this.options.outputType==="file"||this.options.outputType==="both")&&(e.writeBundle=async()=>{this.viteConfig&&await this.safeExecute(async()=>{const t=this.viteConfig.build.outDir;await this.writeVersionFile(t)},"\u5199\u5165\u7248\u672C\u6587\u4EF6")})}}const generateVersion=factory_index.createPluginFactory(f);exports.generateVersion=generateVersion;
+"use strict";const factory_index=require("../../factory/index.cjs"),common_format_index=require("../../common/format/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),m=require("path"),crypto=require("crypto");require("../../logger/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs"),require("fs");function f(o=8){const e=Math.max(1,Math.min(64,o));return crypto.randomBytes(Math.ceil(e/2)).toString("hex").slice(0,e)}function c(o,e){let t=o;for(const[i,s]of Object.entries(e))t=t.replace(new RegExp(`\\{${i}\\}`,"g"),s);return t}class g extends factory_index.BasePlugin{version="";buildTime=new Date;getDefaultOptions(){return{format:"timestamp",semverBase:"1.0.0",outputType:"file",outputFile:"version.json",defineName:"__APP_VERSION__",hashLength:8,prefix:"",suffix:""}}validateOptions(){if(this.validator.field("format").enum(["timestamp","date","datetime","semver","hash","custom"]).field("outputType").enum(["file","define","both"]).field("hashLength").number().minValue(1).maxValue(32).validate(),this.options.format==="custom"&&!this.options.customFormat)throw new Error("\u5F53 format \u4E3A custom \u65F6\uFF0C\u5FC5\u987B\u63D0\u4F9B customFormat")}getPluginName(){return"generate-version"}generateVersion(){const e=common_format_index.getDateFormatParams(this.buildTime),t=f(this.options.hashLength);let i;switch(this.options.format){case"timestamp":i=`${e.YYYY}${e.MM}${e.DD}${e.HH}${e.mm}${e.ss}`;break;case"date":i=`${e.YYYY}.${e.MM}.${e.DD}`;break;case"datetime":i=`${e.YYYY}.${e.MM}.${e.DD}.${e.HH}${e.mm}${e.ss}`;break;case"semver":i=this.options.semverBase||"1.0.0";break;case"hash":i=t;break;case"custom":i=this.parseCustomFormat({...e,hash:t});break;default:i=e.timestamp}const s=this.options.prefix||"",n=this.options.suffix||"";return`${s}${i}${n}`}parseCustomFormat(e){const t={...e};if(this.options.semverBase){const[i,s,n]=this.options.semverBase.split(".");t.major=i||"1",t.minor=s||"0",t.patch=n||"0"}return c(this.options.customFormat||"",t)}generateVersionInfo(){return{version:this.version,buildTime:this.buildTime.toISOString(),timestamp:this.buildTime.getTime(),format:this.options.format,...this.options.extra}}async writeVersionFile(e){const t=m.join(e,this.options.outputFile||"version.json"),i=this.generateVersionInfo();await common_fs_index.writeFileContent(t,JSON.stringify(i,null,2)),this.logger.success(`\u7248\u672C\u6587\u4EF6\u5DF2\u751F\u6210: ${t}`)}addPluginHooks(e){e.configResolved=()=>{this.buildTime=new Date,this.version=this.generateVersion(),this.logger.info(`\u751F\u6210\u7248\u672C\u53F7: ${this.version}`)},(this.options.outputType==="define"||this.options.outputType==="both")&&(e.config=()=>{this.version||(this.buildTime=new Date,this.version=this.generateVersion());const t=this.options.defineName||"__APP_VERSION__";return this.logger.info(`\u6CE8\u5165\u5168\u5C40\u53D8\u91CF: ${t} = "${this.version}"`),{define:{[t]:JSON.stringify(this.version),[`${t}_INFO`]:JSON.stringify(this.generateVersionInfo())}}}),(this.options.outputType==="file"||this.options.outputType==="both")&&(e.writeBundle=async()=>{this.viteConfig&&await this.safeExecute(async()=>{const t=this.viteConfig.build.outDir;await this.writeVersionFile(t)},"\u5199\u5165\u7248\u672C\u6587\u4EF6")})}}const generateVersion=factory_index.createPluginFactory(g);exports.generateVersion=generateVersion;

package/dist/plugins/generateVersion/index.d.cts

@@ -1,6 +1,6 @@
 import { BasePluginOptions, PluginFactory } from '../../factory/index.cjs';
 import 'vite';
-import '../../shared/vite-plugin.CLr0ttuO.cjs';
+import '../../shared/vite-plugin.B8FuZce1.cjs';
 import '../../shared/vite-plugin.DRRlWY8P.cjs';
 
 /**
@@ -46,6 +46,18 @@ interface VersionInfo {
  * 自动生成版本号插件的配置选项接口
  *
  * @interface GenerateVersionOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * generateVersion({
+ *   format: 'semver',
+ *   semverBase: '2.0.0',
+ *   outputType: 'both',
+ *   prefix: 'v',
+ *   extra: { environment: 'production' }
+ * })
+ * ```
  */
 interface GenerateVersionOptions extends BasePluginOptions {
     /**

package/dist/plugins/generateVersion/index.d.mts

@@ -1,6 +1,6 @@
 import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
 import 'vite';
-import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.B8FuZce1.mjs';
 import '../../shared/vite-plugin.DRRlWY8P.mjs';
 
 /**
@@ -46,6 +46,18 @@ interface VersionInfo {
  * 自动生成版本号插件的配置选项接口
  *
  * @interface GenerateVersionOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * generateVersion({
+ *   format: 'semver',
+ *   semverBase: '2.0.0',
+ *   outputType: 'both',
+ *   prefix: 'v',
+ *   extra: { environment: 'production' }
+ * })
+ * ```
  */
 interface GenerateVersionOptions extends BasePluginOptions {
     /**

package/dist/plugins/generateVersion/index.d.ts

@@ -1,6 +1,6 @@
 import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
 import 'vite';
-import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.B8FuZce1.js';
 import '../../shared/vite-plugin.DRRlWY8P.js';
 
 /**
@@ -46,6 +46,18 @@ interface VersionInfo {
  * 自动生成版本号插件的配置选项接口
  *
  * @interface GenerateVersionOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * generateVersion({
+ *   format: 'semver',
+ *   semverBase: '2.0.0',
+ *   outputType: 'both',
+ *   prefix: 'v',
+ *   extra: { environment: 'production' }
+ * })
+ * ```
  */
 interface GenerateVersionOptions extends BasePluginOptions {
     /**