@meng-xi/vite-plugin 0.0.3 → 0.0.5

package/dist/common/index.d.ts

@@ -47,6 +47,17 @@ interface CopyResult {
     executionTime: number;
 }
 
+/**
+ * 文件/目录条目信息
+ */
+interface FileEntry {
+    /** 完整路径 */
+    path: string;
+    /** 是否为文件 */
+    isFile: boolean;
+    /** 是否为目录 */
+    isDirectory: boolean;
+}
 /**
  * 检查源文件是否存在
  * @param sourcePath 源文件路径
@@ -60,12 +71,12 @@ declare function checkSourceExists(sourcePath: string): Promise<void>;
  */
 declare function ensureTargetDir(targetPath: string): Promise<void>;
 /**
- * 读取目录内容
+ * 读取目录内容（优化版：一次性获取文件类型信息）
  * @param dirPath 目录路径
  * @param recursive 是否递归读取
- * @returns 文件和目录列表
+ * @returns 文件和目录条目列表
  */
-declare function readDirRecursive(dirPath: string, recursive: boolean): Promise<string[]>;
+declare function readDirRecursive(dirPath: string, recursive: boolean): Promise<FileEntry[]>;
 /**
  * 检查文件是否需要更新
  * @param sourceFile 源文件路径
@@ -74,7 +85,39 @@ declare function readDirRecursive(dirPath: string, recursive: boolean): Promise<
  */
 declare function shouldUpdateFile(sourceFile: string, targetFile: string): Promise<boolean>;
 /**
- * 执行文件复制操作
+ * 检查文件是否存在
+ * @param filePath 文件路径
+ * @returns 是否存在
+ *
+ * @example
+ * ```typescript
+ * if (await fileExists('/path/to/file')) {
+ *   console.log('文件存在')
+ * }
+ * ```
+ */
+declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * 带并发限制的批量执行
+ *
+ * @param items 待处理项
+ * @param handler 处理函数
+ * @param concurrency 并发数
+ * @returns 处理结果数组，顺序与输入项对应
+ *
+ * @example
+ * ```typescript
+ * const urls = ['url1', 'url2', 'url3', 'url4', 'url5']
+ * const results = await runWithConcurrency(
+ *   urls,
+ *   async (url) => fetch(url),
+ *   3 // 最多同时处理3个请求
+ * )
+ * ```
+ */
+declare function runWithConcurrency<T, R>(items: T[], handler: (item: T) => Promise<R>, concurrency: number): Promise<R[]>;
+/**
+ * 执行文件复制操作（优化版：并行IO）
  * @param sourcePath 源文件或目录路径
  * @param targetPath 目标文件或目录路径
  * @param options 复制选项
@@ -97,13 +140,171 @@ declare function writeFileContent(filePath: string, content: string): Promise<vo
  */
 declare function readFileSync(filePath: string): string;
 
+/**
+ * 数字补零格式化
+ *
+ * @param num 要格式化的数字
+ * @param length 目标长度
+ * @returns 补零后的字符串
+ *
+ * @example
+ * ```typescript
+ * padNumber(5, 2)  // '05'
+ * padNumber(12, 3) // '012'
+ * padNumber(123, 2) // '123'
+ * ```
+ */
+declare function padNumber(num: number, length?: number): string;
+/**
+ * 生成随机哈希字符串
+ *
+ * @param length 哈希长度，范围 1-64
+ * @returns 随机哈希字符串
+ *
+ * @example
+ * ```typescript
+ * generateRandomHash(8)  // 'a1b2c3d4'
+ * generateRandomHash(16) // 'a1b2c3d4e5f6g7h8'
+ * ```
+ */
+declare function generateRandomHash(length?: number): string;
+/**
+ * 日期格式化选项
+ */
+interface DateFormatOptions {
+    /** 四位年份 */
+    YYYY: string;
+    /** 两位年份 */
+    YY: string;
+    /** 两位月份 */
+    MM: string;
+    /** 两位日期 */
+    DD: string;
+    /** 两位小时（24小时制） */
+    HH: string;
+    /** 两位分钟 */
+    mm: string;
+    /** 两位秒数 */
+    ss: string;
+    /** 三位毫秒 */
+    SSS: string;
+    /** 时间戳（毫秒） */
+    timestamp: string;
+}
+/**
+ * 获取日期格式化参数
+ *
+ * @param date 日期对象
+ * @returns 日期格式化参数对象
+ *
+ * @example
+ * ```typescript
+ * const params = getDateFormatParams(new Date())
+ * // { YYYY: '2026', MM: '02', DD: '03', HH: '15', mm: '30', ss: '00', ... }
+ * ```
+ */
+declare function getDateFormatParams(date?: Date): DateFormatOptions;
+/**
+ * 格式化日期
+ *
+ * @param date 日期对象
+ * @param format 格式模板
+ * @returns 格式化后的日期字符串
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date(), '{YYYY}-{MM}-{DD}')         // '2026-02-03'
+ * formatDate(new Date(), '{YYYY}{MM}{DD}{HH}{mm}{ss}') // '20260203153000'
+ * formatDate(new Date(), '{YYYY}.{MM}.{DD}')         // '2026.02.03'
+ * ```
+ */
+declare function formatDate(date: Date, format: string): string;
+/**
+ * 解析模板字符串，替换占位符
+ *
+ * @param template 模板字符串
+ * @param values 占位符值映射
+ * @returns 替换后的字符串
+ *
+ * @example
+ * ```typescript
+ * parseTemplate('{name}-{version}', { name: 'app', version: '1.0.0' })
+ * // 'app-1.0.0'
+ * ```
+ */
+declare function parseTemplate(template: string, values: Record<string, string>): string;
+/**
+ * 将字符串转换为驼峰命名（camelCase）
+ *
+ * @param str 输入字符串
+ * @param separators 分隔符正则，默认为斜杠和横线
+ * @returns 驼峰命名字符串
+ *
+ * @example
+ * ```typescript
+ * toCamelCase('pages/user/profile')  // 'pagesUserProfile'
+ * toCamelCase('user-profile-page')   // 'userProfilePage'
+ * toCamelCase('/pages/index')        // 'pagesIndex'
+ * ```
+ */
+declare function toCamelCase(str: string, separators?: RegExp): string;
+/**
+ * 将字符串转换为帕斯卡命名（PascalCase）
+ *
+ * @param str 输入字符串
+ * @param separators 分隔符正则，默认为斜杠和横线
+ * @returns 帕斯卡命名字符串
+ *
+ * @example
+ * ```typescript
+ * toPascalCase('pages/user/profile')  // 'PagesUserProfile'
+ * toPascalCase('user-profile-page')   // 'UserProfilePage'
+ * toPascalCase('/pages/index')        // 'PagesIndex'
+ * ```
+ */
+declare function toPascalCase(str: string, separators?: RegExp): string;
+/**
+ * 移除 JSON 字符串中的注释
+ *
+ * @param jsonString 包含注释的 JSON 字符串
+ * @returns 移除注释后的 JSON 字符串
+ *
+ * @example
+ * ```typescript
+ * stripJsonComments('{\n  // comment\n  "name": "test"\n}')
+ * // '{\n  "name": "test"\n}'
+ * ```
+ */
+declare function stripJsonComments(jsonString: string): string;
+
 /**
  * 深度合并对象
  *
- * @param target 目标对象
+ * @description 将多个源对象深度合并到一个新对象中。
+ * - undefined 值会被跳过，不会覆盖已有值
+ * - 嵌套对象会递归合并
+ * - 数组会直接覆盖，不会合并
+ * - null 值会覆盖已有值
+ *
  * @param sources 源对象列表
  * @returns 合并后的对象
+ *
+ * @example
+ * ```typescript
+ * // 基本合并
+ * deepMerge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * // undefined 不覆盖
+ * deepMerge({ a: 1 }, { a: undefined }) // { a: 1 }
+ *
+ * // 嵌套对象合并
+ * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+ *
+ * // 数组覆盖
+ * deepMerge({ a: [1, 2] }, { a: [3, 4] }) // { a: [3, 4] }
+ * ```
  */
 declare function deepMerge<T extends Record<string, any>>(...sources: Partial<T>[]): T;
 
-export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, readDirRecursive, readFileSync, shouldUpdateFile, writeFileContent };
+export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent };
+export type { DateFormatOptions };

package/dist/common/index.mjs

@@ -1 +1 @@
-export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,r as readDirRecursive,b as readFileSync,s as shouldUpdateFile,w as writeFileContent}from"../shared/vite-plugin.BZqhBDYR.mjs";export{V as Validator,d as deepMerge}from"../shared/vite-plugin.DSRKYuae.mjs";import"fs";import"path";
+export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,f as fileExists,b as formatDate,g as generateRandomHash,d as getDateFormatParams,p as padNumber,h as parseTemplate,r as readDirRecursive,i as readFileSync,j as runWithConcurrency,s as shouldUpdateFile,k as stripJsonComments,t as toCamelCase,l as toPascalCase,w as writeFileContent}from"../shared/vite-plugin.YvjM8LxW.mjs";export{V as Validator,d as deepMerge}from"../shared/vite-plugin.B88RyRN8.mjs";import"fs";import"path";import"crypto";

package/dist/factory/index.cjs

@@ -1 +1 @@
-"use strict";const index=require("../shared/vite-plugin.BT1oHRKK.cjs");require("../logger/index.cjs"),require("fs"),require("path"),require("../shared/vite-plugin.BTKhc7n7.cjs"),exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory;
+"use strict";const index=require("../shared/vite-plugin.DqWt65U-.cjs");require("../logger/index.cjs"),require("fs"),require("path"),require("crypto"),require("../shared/vite-plugin.IGZeStMa.cjs"),exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory;

package/dist/factory/index.mjs

@@ -1 +1 @@
-export{B as BasePlugin,c as createPluginFactory}from"../shared/vite-plugin.ClHiVXD6.mjs";import"../logger/index.mjs";import"fs";import"path";import"../shared/vite-plugin.DSRKYuae.mjs";
+export{B as BasePlugin,c as createPluginFactory}from"../shared/vite-plugin.C7isVPKg.mjs";import"../logger/index.mjs";import"fs";import"path";import"crypto";import"../shared/vite-plugin.B88RyRN8.mjs";

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const index=require("./shared/vite-plugin.DrSzERYS.cjs"),validation=require("./shared/vite-plugin.BTKhc7n7.cjs"),index$1=require("./shared/vite-plugin.BT1oHRKK.cjs"),logger_index=require("./logger/index.cjs"),index$2=require("./shared/vite-plugin.Bn8mcCzy.cjs");require("fs"),require("path"),exports.checkSourceExists=index.checkSourceExists,exports.copySourceToTarget=index.copySourceToTarget,exports.ensureTargetDir=index.ensureTargetDir,exports.readDirRecursive=index.readDirRecursive,exports.readFileSync=index.readFileSync,exports.shouldUpdateFile=index.shouldUpdateFile,exports.writeFileContent=index.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge,exports.BasePlugin=index$1.BasePlugin,exports.createPluginFactory=index$1.createPluginFactory,exports.Logger=logger_index.Logger,exports.copyFile=index$2.copyFile,exports.injectIco=index$2.injectIco;
+"use strict";const format=require("./shared/vite-plugin.BZsetDCm.cjs"),validation=require("./shared/vite-plugin.IGZeStMa.cjs"),index=require("./shared/vite-plugin.DqWt65U-.cjs"),logger_index=require("./logger/index.cjs"),index$1=require("./shared/vite-plugin.CgnG5_UX.cjs");require("fs"),require("path"),require("crypto"),exports.checkSourceExists=format.checkSourceExists,exports.copySourceToTarget=format.copySourceToTarget,exports.ensureTargetDir=format.ensureTargetDir,exports.fileExists=format.fileExists,exports.formatDate=format.formatDate,exports.generateRandomHash=format.generateRandomHash,exports.getDateFormatParams=format.getDateFormatParams,exports.padNumber=format.padNumber,exports.parseTemplate=format.parseTemplate,exports.readDirRecursive=format.readDirRecursive,exports.readFileSync=format.readFileSync,exports.runWithConcurrency=format.runWithConcurrency,exports.shouldUpdateFile=format.shouldUpdateFile,exports.stripJsonComments=format.stripJsonComments,exports.toCamelCase=format.toCamelCase,exports.toPascalCase=format.toPascalCase,exports.writeFileContent=format.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge,exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory,exports.Logger=logger_index.Logger,exports.copyFile=index$1.copyFile,exports.generateRouter=index$1.generateRouter,exports.generateVersion=index$1.generateVersion,exports.injectIco=index$1.injectIco;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, readDirRecursive, readFileSync, shouldUpdateFile, writeFileContent } from './common/index.cjs';
+export { DateFormatOptions, checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent } from './common/index.cjs';
 export { V as Validator } from './shared/vite-plugin.CiHfwMiN.cjs';
 export { BasePlugin, createPluginFactory } from './factory/index.cjs';
 export { L as Logger, P as PluginLogger } from './shared/vite-plugin.B3PARlU9.cjs';
-export { copyFile, injectIco } from './plugins/index.cjs';
+export { copyFile, generateRouter, generateVersion, injectIco } from './plugins/index.cjs';
 import 'vite';
 import './shared/vite-plugin.UkE7CdSe.cjs';

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, readDirRecursive, readFileSync, shouldUpdateFile, writeFileContent } from './common/index.mjs';
+export { DateFormatOptions, checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent } from './common/index.mjs';
 export { V as Validator } from './shared/vite-plugin.CiHfwMiN.mjs';
 export { BasePlugin, createPluginFactory } from './factory/index.mjs';
 export { L as Logger, P as PluginLogger } from './shared/vite-plugin.B3PARlU9.mjs';
-export { copyFile, injectIco } from './plugins/index.mjs';
+export { copyFile, generateRouter, generateVersion, injectIco } from './plugins/index.mjs';
 import 'vite';
 import './shared/vite-plugin.UkE7CdSe.mjs';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, readDirRecursive, readFileSync, shouldUpdateFile, writeFileContent } from './common/index.js';
+export { DateFormatOptions, checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent } from './common/index.js';
 export { V as Validator } from './shared/vite-plugin.CiHfwMiN.js';
 export { BasePlugin, createPluginFactory } from './factory/index.js';
 export { L as Logger, P as PluginLogger } from './shared/vite-plugin.B3PARlU9.js';
-export { copyFile, injectIco } from './plugins/index.js';
+export { copyFile, generateRouter, generateVersion, injectIco } from './plugins/index.js';
 import 'vite';
 import './shared/vite-plugin.UkE7CdSe.js';

package/dist/index.mjs

@@ -1 +1 @@
-export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,r as readDirRecursive,b as readFileSync,s as shouldUpdateFile,w as writeFileContent}from"./shared/vite-plugin.BZqhBDYR.mjs";export{V as Validator,d as deepMerge}from"./shared/vite-plugin.DSRKYuae.mjs";export{B as BasePlugin,c as createPluginFactory}from"./shared/vite-plugin.ClHiVXD6.mjs";export{Logger}from"./logger/index.mjs";export{c as copyFile,i as injectIco}from"./shared/vite-plugin.CY2ydccp.mjs";import"fs";import"path";
+export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,f as fileExists,b as formatDate,g as generateRandomHash,d as getDateFormatParams,p as padNumber,h as parseTemplate,r as readDirRecursive,i as readFileSync,j as runWithConcurrency,s as shouldUpdateFile,k as stripJsonComments,t as toCamelCase,l as toPascalCase,w as writeFileContent}from"./shared/vite-plugin.YvjM8LxW.mjs";export{V as Validator,d as deepMerge}from"./shared/vite-plugin.B88RyRN8.mjs";export{B as BasePlugin,c as createPluginFactory}from"./shared/vite-plugin.C7isVPKg.mjs";export{Logger}from"./logger/index.mjs";export{c as copyFile,g as generateRouter,a as generateVersion,i as injectIco}from"./shared/vite-plugin.CS9a5kjK.mjs";import"fs";import"path";import"crypto";

package/dist/logger/index.cjs

@@ -1 +1 @@
-"use strict";class Logger{static instance=null;libName="@meng-xi/vite-plugin";pluginConfigs=new Map;logTypes={info:{method:console.log,icon:"",color:"",reset:""},success:{method:console.log,icon:"\u2705",color:"\x1B[32m",reset:"\x1B[0m"},warn:{method:console.warn,icon:"\u26A0\uFE0F",color:"\x1B[33m",reset:"\x1B[0m"},error:{method:console.error,icon:"\u274C",color:"\x1B[31m",reset:"\x1B[0m"}};constructor(){}static getInstance(){return Logger.instance||(Logger.instance=new Logger),Logger.instance}static create(n){const e=Logger.getInstance();return e.registerPlugin(n.name,n.enabled??!0),e}registerPlugin(n,e){this.pluginConfigs.set(n,e)}formatPrefix(n){let e=`[${this.libName}:${n}]`;return e=`[${new Date().toLocaleString()}] ${e}`,e}isPluginEnabled(n){return this.pluginConfigs.get(n)??!0}log(n,e,t,i){if(!this.isPluginEnabled(n))return;const l=this.formatPrefix(n),u=this.logTypes[e],{method:s,icon:c,color:r,reset:o}=u,a=c?`${c} ${l}`:l;s("=================================="),i!=null?s(r+a+o,r+t+o,i):s(r+a+o,r+t+o),s("==================================")}createPluginLogger(n){return{success:(e,t)=>this.log(n,"success",e,t),info:(e,t)=>this.log(n,"info",e,t),warn:(e,t)=>this.log(n,"warn",e,t),error:(e,t)=>this.log(n,"error",e,t)}}}exports.Logger=Logger;
+"use strict";class Logger{static instance=null;libName="@meng-xi/vite-plugin";pluginConfigs=new Map;logTypes={info:{method:console.log,icon:"\u2139\uFE0F",color:"\x1B[36m",reset:"\x1B[0m"},success:{method:console.log,icon:"\u2705",color:"\x1B[32m",reset:"\x1B[0m"},warn:{method:console.warn,icon:"\u26A0\uFE0F",color:"\x1B[33m",reset:"\x1B[0m"},error:{method:console.error,icon:"\u274C",color:"\x1B[31m",reset:"\x1B[0m"}};constructor(){}static getInstance(){return Logger.instance||(Logger.instance=new Logger),Logger.instance}static create(e){const n=Logger.getInstance();return n.registerPlugin(e.name,e.enabled??!0),n}registerPlugin(e,n){this.pluginConfigs.set(e,n)}formatPrefix(e){return`[${this.libName}:${e}]`}isPluginEnabled(e){return this.pluginConfigs.get(e)??!0}log(e,n,t,r){if(!this.isPluginEnabled(e))return;const l=this.formatPrefix(e),u=this.logTypes[n],{method:i,icon:a,color:s,reset:o}=u,c=`${a} ${l}`;r!=null?i(s+c+o,s+t+o,r):i(s+c+o,s+t+o)}createPluginLogger(e){return{success:(n,t)=>this.log(e,"success",n,t),info:(n,t)=>this.log(e,"info",n,t),warn:(n,t)=>this.log(e,"warn",n,t),error:(n,t)=>this.log(e,"error",n,t)}}}exports.Logger=Logger;

package/dist/logger/index.mjs

@@ -1 +1 @@
-class s{static instance=null;libName="@meng-xi/vite-plugin";pluginConfigs=new Map;logTypes={info:{method:console.log,icon:"",color:"",reset:""},success:{method:console.log,icon:"\u2705",color:"\x1B[32m",reset:"\x1B[0m"},warn:{method:console.warn,icon:"\u26A0\uFE0F",color:"\x1B[33m",reset:"\x1B[0m"},error:{method:console.error,icon:"\u274C",color:"\x1B[31m",reset:"\x1B[0m"}};constructor(){}static getInstance(){return s.instance||(s.instance=new s),s.instance}static create(n){const e=s.getInstance();return e.registerPlugin(n.name,n.enabled??!0),e}registerPlugin(n,e){this.pluginConfigs.set(n,e)}formatPrefix(n){let e=`[${this.libName}:${n}]`;return e=`[${new Date().toLocaleString()}] ${e}`,e}isPluginEnabled(n){return this.pluginConfigs.get(n)??!0}log(n,e,t,l){if(!this.isPluginEnabled(n))return;const c=this.formatPrefix(n),g=this.logTypes[e],{method:o,icon:a,color:r,reset:i}=g,u=a?`${a} ${c}`:c;o("=================================="),l!=null?o(r+u+i,r+t+i,l):o(r+u+i,r+t+i),o("==================================")}createPluginLogger(n){return{success:(e,t)=>this.log(n,"success",e,t),info:(e,t)=>this.log(n,"info",e,t),warn:(e,t)=>this.log(n,"warn",e,t),error:(e,t)=>this.log(n,"error",e,t)}}}export{s as Logger};
+class o{static instance=null;libName="@meng-xi/vite-plugin";pluginConfigs=new Map;logTypes={info:{method:console.log,icon:"\u2139\uFE0F",color:"\x1B[36m",reset:"\x1B[0m"},success:{method:console.log,icon:"\u2705",color:"\x1B[32m",reset:"\x1B[0m"},warn:{method:console.warn,icon:"\u26A0\uFE0F",color:"\x1B[33m",reset:"\x1B[0m"},error:{method:console.error,icon:"\u274C",color:"\x1B[31m",reset:"\x1B[0m"}};constructor(){}static getInstance(){return o.instance||(o.instance=new o),o.instance}static create(e){const n=o.getInstance();return n.registerPlugin(e.name,e.enabled??!0),n}registerPlugin(e,n){this.pluginConfigs.set(e,n)}formatPrefix(e){return`[${this.libName}:${e}]`}isPluginEnabled(e){return this.pluginConfigs.get(e)??!0}log(e,n,t,i){if(!this.isPluginEnabled(e))return;const u=this.formatPrefix(e),a=this.logTypes[n],{method:l,icon:g,color:r,reset:s}=a,c=`${g} ${u}`;i!=null?l(r+c+s,r+t+s,i):l(r+c+s,r+t+s)}createPluginLogger(e){return{success:(n,t)=>this.log(e,"success",n,t),info:(n,t)=>this.log(e,"info",n,t),warn:(n,t)=>this.log(e,"warn",n,t),error:(n,t)=>this.log(e,"error",n,t)}}}export{o as Logger};

package/dist/plugins/index.cjs

@@ -1 +1 @@
-"use strict";const index=require("../shared/vite-plugin.Bn8mcCzy.cjs");require("../shared/vite-plugin.BT1oHRKK.cjs"),require("../logger/index.cjs"),require("fs"),require("path"),require("../shared/vite-plugin.BTKhc7n7.cjs"),require("../shared/vite-plugin.DrSzERYS.cjs"),exports.copyFile=index.copyFile,exports.injectIco=index.injectIco;
+"use strict";const index=require("../shared/vite-plugin.CgnG5_UX.cjs");require("../shared/vite-plugin.DqWt65U-.cjs"),require("../logger/index.cjs"),require("fs"),require("path"),require("crypto"),require("../shared/vite-plugin.IGZeStMa.cjs"),require("../shared/vite-plugin.BZsetDCm.cjs"),exports.copyFile=index.copyFile,exports.generateRouter=index.generateRouter,exports.generateVersion=index.generateVersion,exports.injectIco=index.injectIco;

package/dist/plugins/index.d.cts

@@ -72,6 +72,301 @@ interface CopyFileOptions extends BasePluginOptions {
  */
 declare const copyFile: PluginFactory<CopyFileOptions, CopyFileOptions>;
 
+/**
+ * 输出文件格式类型
+ */
+type OutputFormat = 'ts' | 'js';
+/**
+ * 路由名称生成策略
+ */
+type NameStrategy = 'path' | 'camelCase' | 'pascalCase' | 'custom';
+/**
+ * 生成路由配置插件选项
+ */
+interface GenerateRouterOptions extends BasePluginOptions {
+    /**
+     * pages.json 文件路径（相对于项目根目录）
+     *
+     * @default 'src/pages.json'
+     */
+    pagesJsonPath?: string;
+    /**
+     * 输出文件路径（相对于项目根目录）
+     *
+     * @default 'src/router.config.ts'
+     */
+    outputPath?: string;
+    /**
+     * 输出文件格式
+     *
+     * @default 'ts'
+     */
+    outputFormat?: OutputFormat;
+    /**
+     * 路由名称生成策略
+     *
+     * @default 'camelCase'
+     */
+    nameStrategy?: NameStrategy;
+    /**
+     * 自定义路由名称生成函数
+     *
+     * @param path - 页面路径
+     * @returns 路由名称
+     */
+    customNameGenerator?: (path: string) => string;
+    /**
+     * 是否包含子包路由
+     *
+     * @default true
+     */
+    includeSubPackages?: boolean;
+    /**
+     * 是否监听 pages.json 变化并自动重新生成
+     *
+     * @default true
+     */
+    watch?: boolean;
+    /**
+     * 额外的元信息字段映射
+     *
+     * @description 将 pages.json 中 style 的字段映射到 meta 中
+     * @example { 'navigationBarTitleText': 'title', 'requireAuth': 'requireAuth' }
+     */
+    metaMapping?: Record<string, string>;
+    /**
+     * 是否导出类型定义
+     *
+     * @default true
+     */
+    exportTypes?: boolean;
+    /**
+     * 是否保留用户对 routes 配置的修改
+     *
+     * @description 开启后，用户在 routes 数组中修改的字段将被保留
+     * @default true
+     */
+    preserveRouteChanges?: boolean;
+}
+
+/**
+ * 生成路由配置插件
+ *
+ * @param {GenerateRouterOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用 - 使用默认配置
+ * generateRouter()
+ *
+ * // 自定义 pages.json 路径
+ * generateRouter({
+ *   pagesJsonPath: 'pages.json'
+ * })
+ *
+ * // 输出 JavaScript 文件
+ * generateRouter({
+ *   outputFormat: 'js',
+ *   outputPath: 'src/router.config.js'
+ * })
+ *
+ * // 使用帕斯卡命名策略
+ * generateRouter({
+ *   nameStrategy: 'pascalCase'
+ * })
+ *
+ * // 自定义路由名称生成
+ * generateRouter({
+ *   nameStrategy: 'custom',
+ *   customNameGenerator: (path) => `route_${path.replace(/\//g, '_')}`
+ * })
+ *
+ * // 自定义元信息映射
+ * generateRouter({
+ *   metaMapping: {
+ *     navigationBarTitleText: 'title',
+ *     requireAuth: 'requireAuth',
+ *     customField: 'custom'
+ *   }
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会读取 uni-app 项目的 pages.json 文件，自动生成路由配置文件：
+ * - 支持主包和子包页面
+ * - 自动识别 tabBar 页面
+ * - 支持多种路由名称生成策略
+ * - 支持自定义元信息字段映射
+ * - 开发模式下自动监听 pages.json 变化并重新生成
+ */
+declare const generateRouter: PluginFactory<GenerateRouterOptions, GenerateRouterOptions>;
+
+/**
+ * 版本号格式类型
+ *
+ * @description
+ * - 'timestamp': 时间戳格式，如 '20260203153000'
+ * - 'date': 日期格式，如 '2026.02.03'
+ * - 'datetime': 日期时间格式，如 '2026.02.03.153000'
+ * - 'semver': 语义化版本格式，如 '1.0.0'
+ * - 'hash': 随机哈希格式，如 'a1b2c3d4'
+ * - 'custom': 自定义格式，需要配合 customFormat 使用
+ */
+type VersionFormat = 'timestamp' | 'date' | 'datetime' | 'semver' | 'hash' | 'custom';
+/**
+ * 版本号输出类型
+ *
+ * @description
+ * - 'file': 输出到文件
+ * - 'define': 通过 Vite 的 define 注入到代码中
+ * - 'both': 同时输出到文件和注入代码
+ */
+type OutputType = 'file' | 'define' | 'both';
+/**
+ * 自动生成版本号插件的配置选项接口
+ *
+ * @interface GenerateVersionOptions
+ */
+interface GenerateVersionOptions extends BasePluginOptions {
+    /**
+     * 版本号格式
+     *
+     * @default 'timestamp'
+     */
+    format?: VersionFormat;
+    /**
+     * 自定义格式模板，仅当 format 为 'custom' 时有效
+     *
+     * @description 支持以下占位符：
+     * - {YYYY}: 四位年份
+     * - {MM}: 两位月份
+     * - {DD}: 两位日期
+     * - {HH}: 两位小时
+     * - {mm}: 两位分钟
+     * - {ss}: 两位秒数
+     * - {timestamp}: 时间戳
+     * - {hash}: 随机哈希
+     * - {major}: 主版本号（需配合 semverBase）
+     * - {minor}: 次版本号（需配合 semverBase）
+     * - {patch}: 补丁版本号（需配合 semverBase）
+     *
+     * @example '{YYYY}.{MM}.{DD}-{hash}'
+     */
+    customFormat?: string;
+    /**
+     * 语义化版本基础值，用于 semver 格式
+     *
+     * @default '1.0.0'
+     */
+    semverBase?: string;
+    /**
+     * 是否自动递增补丁版本号
+     *
+     * @default false
+     */
+    autoIncrement?: boolean;
+    /**
+     * 输出类型
+     *
+     * @default 'file'
+     */
+    outputType?: OutputType;
+    /**
+     * 输出文件路径（相对于构建输出目录）
+     *
+     * @default 'version.json'
+     */
+    outputFile?: string;
+    /**
+     * 注入到代码中的全局变量名
+     *
+     * @default '__APP_VERSION__'
+     */
+    defineName?: string;
+    /**
+     * 哈希长度
+     *
+     * @default 8
+     */
+    hashLength?: number;
+    /**
+     * 版本号前缀
+     *
+     * @example 'v'
+     */
+    prefix?: string;
+    /**
+     * 版本号后缀
+     *
+     * @example '-beta'
+     */
+    suffix?: string;
+    /**
+     * 额外的版本信息，会包含在输出的 JSON 文件中
+     */
+    extra?: Record<string, any>;
+}
+
+/**
+ * 自动生成版本号插件
+ *
+ * @param {GenerateVersionOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用 - 时间戳格式
+ * generateVersion()
+ *
+ * // 日期格式
+ * generateVersion({
+ *   format: 'date'
+ * })
+ *
+ * // 语义化版本格式
+ * generateVersion({
+ *   format: 'semver',
+ *   semverBase: '2.0.0',
+ *   prefix: 'v'
+ * })
+ *
+ * // 自定义格式
+ * generateVersion({
+ *   format: 'custom',
+ *   customFormat: '{YYYY}.{MM}.{DD}-{hash}',
+ *   hashLength: 6
+ * })
+ *
+ * // 注入到代码中
+ * generateVersion({
+ *   outputType: 'define',
+ *   defineName: '__VERSION__'
+ * })
+ *
+ * // 同时输出文件和注入代码
+ * generateVersion({
+ *   outputType: 'both',
+ *   outputFile: 'build-info.json',
+ *   defineName: '__BUILD_VERSION__',
+ *   extra: {
+ *     environment: 'production',
+ *     author: 'MengXi Studio'
+ *   }
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会在 Vite 构建过程中自动生成版本号，支持多种格式：
+ * - timestamp: 时间戳格式 (20260203153000)
+ * - date: 日期格式 (2026.02.03)
+ * - datetime: 日期时间格式 (2026.02.03.153000)
+ * - semver: 语义化版本格式 (1.0.0)
+ * - hash: 随机哈希格式 (a1b2c3d4)
+ * - custom: 自定义格式
+ */
+declare const generateVersion: PluginFactory<GenerateVersionOptions, GenerateVersionOptions>;
+
 /**
  * 图标配置项接口
  *
@@ -207,4 +502,4 @@ interface InjectIcoOptions extends BasePluginOptions {
  */
 declare const injectIco: PluginFactory<InjectIcoOptions, string | InjectIcoOptions>;
 
-export { copyFile, injectIco };
+export { copyFile, generateRouter, generateVersion, injectIco };