@meng-xi/vite-plugin 0.1.4 → 0.1.5

package/README-en.md

@@ -15,8 +15,8 @@
 
 ## Features
 
-- **Ready to Use** - 11 practical plugins covering build progress, bundle analysis & compression, file copying, environment variable validation, route generation, version management, HTML injection, favicon management,
-  global Loading, and more
+- **Ready to Use** - 12 practical plugins covering auto-import, build progress, bundle analysis & compression, file copying, environment variable validation, route generation, version management, HTML injection, favicon
+  management, global Loading, and more
 - **Plugin Development Framework** - Exports core components like BasePlugin, Logger, and Validator to quickly build custom Vite plugins
 - **Common Utility Library** - Built-in Common utility modules supporting on-demand sub-path imports
 - **Type Safe** - Complete TypeScript type definitions with configuration validators
@@ -41,10 +41,11 @@ pnpm add @meng-xi/vite-plugin -D
 
 ```typescript
 import { defineConfig } from 'vite'
-import { buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager } from '@meng-xi/vite-plugin'
+import { buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager, autoImport } from '@meng-xi/vite-plugin'
 
 export default defineConfig({
 	plugins: [
+		autoImport({ imports: { vue: ['ref', 'reactive', 'computed'] }, dts: 'src/auto-imports.d.ts' }),
 		buildProgress(),
 		bundleAnalyzer({ outputFormat: 'both' }),
 		compressAssets({ algorithm: 'gzip' }),
@@ -64,6 +65,7 @@ export default defineConfig({
 
 | Plugin                                                                                                     | Description                                                                                                                           |
 | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
+| [autoImport](https://mengxi-studio.github.io/vite-plugin/en/plugins/auto-import.html)                      | Auto-inject import statements with preset mappings, directory scanning, and Vue template auto-import                                  |
 | [buildProgress](https://mengxi-studio.github.io/vite-plugin/en/plugins/build-progress.html)                | Real-time terminal build progress bar, supports bar / spinner / minimal                                                               |
 | [bundleAnalyzer](https://mengxi-studio.github.io/vite-plugin/en/plugins/bundle-analyzer.html)              | Bundle volume analysis with JSON/HTML reports, gzip calculation, threshold alerts, and build diff                                     |
 | [compressAssets](https://mengxi-studio.github.io/vite-plugin/en/plugins/compress-assets.html)              | Asset compression with gzip / brotli / both, concurrent compression and statistics report                                             |
@@ -132,19 +134,16 @@ Built-in general-purpose utility function library, organized by functional modul
 ```typescript
 import { formatFileSize } from '@meng-xi/vite-plugin/common/format'
 import { scanDirectory } from '@meng-xi/vite-plugin/common/fs'
-import { calculateGzipSize } from '@meng-xi/vite-plugin/common/compress'
+import { injectBeforeTag } from '@meng-xi/vite-plugin/common/html'
 ```
 
 | Sub-path                                                                                     | Description             |
 | -------------------------------------------------------------------------------------------- | ----------------------- |
-| [`common/compress`](https://mengxi-studio.github.io/vite-plugin/en/common/compress.html)     | Compression utilities   |
 | [`common/format`](https://mengxi-studio.github.io/vite-plugin/en/common/format.html)         | Formatting utilities    |
 | [`common/fs`](https://mengxi-studio.github.io/vite-plugin/en/common/fs.html)                 | File system utilities   |
 | [`common/html`](https://mengxi-studio.github.io/vite-plugin/en/common/html.html)             | HTML injection utils    |
-| [`common/object`](https://mengxi-studio.github.io/vite-plugin/en/common/object.html)         | Object operation utils  |
-| [`common/path`](https://mengxi-studio.github.io/vite-plugin/en/common/path.html)             | Path handling utils     |
 | [`common/script`](https://mengxi-studio.github.io/vite-plugin/en/common/script.html)         | Script generation utils |
-| [`common/ui`](https://mengxi-studio.github.io/vite-plugin/en/common/)                        | Terminal UI utils       |
+| [`common/ui`](https://mengxi-studio.github.io/vite-plugin/en/common/ui.html)                 | Terminal UI utils       |
 | [`common/validation`](https://mengxi-studio.github.io/vite-plugin/en/common/validation.html) | Validation utilities    |
 
 ## Sub-path Exports
@@ -157,6 +156,7 @@ import { calculateGzipSize } from '@meng-xi/vite-plugin/common/compress'
 | `@meng-xi/vite-plugin/plugins`                        | All plugins                          |
 | `@meng-xi/vite-plugin/common`                         | All utility functions                |
 | `@meng-xi/vite-plugin/common/*`                       | Utility sub-modules                  |
+| `@meng-xi/vite-plugin/plugins/auto-import`            | autoImport plugin                    |
 | `@meng-xi/vite-plugin/plugins/build-progress`         | buildProgress plugin                 |
 | `@meng-xi/vite-plugin/plugins/bundle-analyzer`        | bundleAnalyzer plugin                |
 | `@meng-xi/vite-plugin/plugins/compress-assets`        | compressAssets plugin                |

package/README.md

@@ -15,7 +15,7 @@
 
 ## 特性
 
-- **开箱即用** - 11 个实用插件，覆盖构建进度、产物分析与压缩、文件复制、环境变量校验、路由生成、版本管理、HTML 注入、图标管理、全局 Loading 等场景
+- **开箱即用** - 12 个实用插件，覆盖自动导入、构建进度、产物分析与压缩、文件复制、环境变量校验、路由生成、版本管理、HTML 注入、图标管理、全局 Loading 等场景
 - **插件开发框架** - 导出 BasePlugin、Logger、Validator 等核心组件，快速构建自定义 Vite 插件
 - **通用工具库** - 内置 Common 工具模块，支持按需子路径导入
 - **类型安全** - 完整 TypeScript 类型定义与配置验证器
@@ -40,10 +40,11 @@ pnpm add @meng-xi/vite-plugin -D
 
 ```typescript
 import { defineConfig } from 'vite'
-import { buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager } from '@meng-xi/vite-plugin'
+import { buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager, autoImport } from '@meng-xi/vite-plugin'
 
 export default defineConfig({
 	plugins: [
+		autoImport({ imports: { vue: ['ref', 'reactive', 'computed'] }, dts: 'src/auto-imports.d.ts' }),
 		buildProgress(),
 		bundleAnalyzer({ outputFormat: 'both' }),
 		compressAssets({ algorithm: 'gzip' }),
@@ -63,6 +64,7 @@ export default defineConfig({
 
 | 插件                                                                                                    | 说明                                                                  |
 | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
+| [autoImport](https://mengxi-studio.github.io/vite-plugin/plugins/auto-import.html)                      | 自动注入 import 语句，支持预设映射、目录扫描和 Vue 模板自动导入       |
 | [buildProgress](https://mengxi-studio.github.io/vite-plugin/plugins/build-progress.html)                | 终端实时构建进度条，支持 bar / spinner / minimal                      |
 | [bundleAnalyzer](https://mengxi-studio.github.io/vite-plugin/plugins/bundle-analyzer.html)              | 构建产物体积分析，支持 JSON/HTML 报告、gzip 计算、阈值告警和构建对比  |
 | [compressAssets](https://mengxi-studio.github.io/vite-plugin/plugins/compress-assets.html)              | 构建产物压缩，支持 gzip / brotli / both，并发压缩和统计报告           |
@@ -131,19 +133,16 @@ export const myPlugin = createPluginFactory(MyPlugin)
 ```typescript
 import { formatFileSize } from '@meng-xi/vite-plugin/common/format'
 import { scanDirectory } from '@meng-xi/vite-plugin/common/fs'
-import { calculateGzipSize } from '@meng-xi/vite-plugin/common/compress'
+import { injectBeforeTag } from '@meng-xi/vite-plugin/common/html'
 ```
 
 | 子路径                                                                                    | 描述          |
 | ----------------------------------------------------------------------------------------- | ------------- |
-| [`common/compress`](https://mengxi-studio.github.io/vite-plugin/common/compress.html)     | 压缩算法工具  |
 | [`common/format`](https://mengxi-studio.github.io/vite-plugin/common/format.html)         | 格式化工具    |
 | [`common/fs`](https://mengxi-studio.github.io/vite-plugin/common/fs.html)                 | 文件系统工具  |
 | [`common/html`](https://mengxi-studio.github.io/vite-plugin/common/html.html)             | HTML 注入工具 |
-| [`common/object`](https://mengxi-studio.github.io/vite-plugin/common/object.html)         | 对象操作工具  |
-| [`common/path`](https://mengxi-studio.github.io/vite-plugin/common/path.html)             | 路径处理工具  |
 | [`common/script`](https://mengxi-studio.github.io/vite-plugin/common/script.html)         | 脚本生成工具  |
-| [`common/ui`](https://mengxi-studio.github.io/vite-plugin/common/)                        | 终端 UI 工具  |
+| [`common/ui`](https://mengxi-studio.github.io/vite-plugin/common/ui.html)                 | 终端 UI 工具  |
 | [`common/validation`](https://mengxi-studio.github.io/vite-plugin/common/validation.html) | 参数验证工具  |
 
 ## 子路径导出
@@ -156,6 +155,7 @@ import { calculateGzipSize } from '@meng-xi/vite-plugin/common/compress'
 | `@meng-xi/vite-plugin/plugins`                        | 所有插件                  |
 | `@meng-xi/vite-plugin/common`                         | 所有工具函数              |
 | `@meng-xi/vite-plugin/common/*`                       | 各工具子模块              |
+| `@meng-xi/vite-plugin/plugins/auto-import`            | autoImport 插件           |
 | `@meng-xi/vite-plugin/plugins/build-progress`         | buildProgress 插件        |
 | `@meng-xi/vite-plugin/plugins/bundle-analyzer`        | bundleAnalyzer 插件       |
 | `@meng-xi/vite-plugin/plugins/compress-assets`        | compressAssets 插件       |

package/dist/common/format/index.cjs

@@ -1 +1 @@
-"use strict";const crypto=require("crypto"),a=require("node:path");function _interopDefaultCompat(e){return e&&typeof e=="object"&&"default"in e?e.default:e}const a__default=_interopDefaultCompat(a);function padNumber(e,t=2){return e.toString().padStart(t,"0")}function generateRandomHash(e=8){const t=Math.max(1,Math.min(64,e));return crypto.randomBytes(Math.ceil(t/2)).toString("hex").slice(0,t)}function getDateFormatParams(e=new Date){return{YYYY:e.getFullYear().toString(),YY:e.getFullYear().toString().slice(-2),MM:padNumber(e.getMonth()+1),DD:padNumber(e.getDate()),HH:padNumber(e.getHours()),mm:padNumber(e.getMinutes()),ss:padNumber(e.getSeconds()),SSS:padNumber(e.getMilliseconds(),3),timestamp:e.getTime().toString()}}function formatDate(e,t){const r=getDateFormatParams(e);let o=t;for(const[n,s]of Object.entries(r))o=o.replace(new RegExp(`\\{${n}\\}`,"g"),s);return o}function parseTemplate(e,t){let r=e;for(const[o,n]of Object.entries(t))r=r.replace(new RegExp(`\\{${o}\\}`,"g"),n);return r}function toCamelCase(e,t=/[/-]/){return e.replace(/^\/+/,"").split(t).filter(Boolean).map((r,o)=>o===0?r.toLowerCase():r.charAt(0).toUpperCase()+r.slice(1).toLowerCase()).join("")}function toPascalCase(e,t=/[/-]/){return e.replace(/^\/+/,"").split(t).filter(Boolean).map(r=>r.charAt(0).toUpperCase()+r.slice(1).toLowerCase()).join("")}function stripJsonComments(e){return e.replace(/\/\/.*$/gm,"").replace(/\/\*[\s\S]*?\*\//g,"")}function escapeHtmlAttr(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function formatFileSize(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}function getExtension(e){return a__default.extname(e).toLowerCase()}exports.escapeHtmlAttr=escapeHtmlAttr,exports.formatDate=formatDate,exports.formatFileSize=formatFileSize,exports.generateRandomHash=generateRandomHash,exports.getDateFormatParams=getDateFormatParams,exports.getExtension=getExtension,exports.padNumber=padNumber,exports.parseTemplate=parseTemplate,exports.stripJsonComments=stripJsonComments,exports.toCamelCase=toCamelCase,exports.toPascalCase=toPascalCase;
+"use strict";function r(e,t=2){return e.toString().padStart(t,"0")}function getDateFormatParams(e=new Date){return{YYYY:e.getFullYear().toString(),YY:e.getFullYear().toString().slice(-2),MM:r(e.getMonth()+1),DD:r(e.getDate()),HH:r(e.getHours()),mm:r(e.getMinutes()),ss:r(e.getSeconds()),SSS:r(e.getMilliseconds(),3),timestamp:e.getTime().toString()}}function formatFileSize(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}exports.formatFileSize=formatFileSize,exports.getDateFormatParams=getDateFormatParams;

package/dist/common/format/index.d.cts

@@ -22,34 +22,6 @@ interface DateFormatOptions {
     timestamp: 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;
 /**
  * 获取日期格式化参数
  *
@@ -63,94 +35,6 @@ declare function generateRandomHash(length?: number): string;
  * ```
  */
 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;
-/**
- * 转义 HTML 属性值中的特殊字符，防止 XSS 注入
- *
- * @param str - 需要转义的字符串
- * @returns 转义后的安全字符串
- *
- * @example
- * ```typescript
- * escapeHtmlAttr('hello "world"')
- * // 'hello &quot;world&quot;'
- *
- * escapeHtmlAttr('<script>alert(1)</script>')
- * // '&lt;script&gt;alert(1)&lt;/script&gt;'
- * ```
- */
-declare function escapeHtmlAttr(str: string): string;
 /**
  * 将字节数格式化为人类可读的文件大小字符串
  *
@@ -170,19 +54,6 @@ declare function escapeHtmlAttr(str: string): string;
  * ```
  */
 declare function formatFileSize(bytes: number): string;
-/**
- * 获取文件扩展名
- *
- * @param {string} filePath - 文件路径
- * @returns {string} 小写的文件扩展名（如 '.js'）
- *
- * @example
- * ```typescript
- * getExtension('dist/app.js')  // '.js'
- * getExtension('dist/style.CSS') // '.css'
- * ```
- */
-declare function getExtension(filePath: string): string;
 
-export { escapeHtmlAttr, formatDate, formatFileSize, generateRandomHash, getDateFormatParams, getExtension, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase };
+export { formatFileSize, getDateFormatParams };
 export type { DateFormatOptions };

package/dist/common/format/index.d.mts

@@ -22,34 +22,6 @@ interface DateFormatOptions {
     timestamp: 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;
 /**
  * 获取日期格式化参数
  *
@@ -63,94 +35,6 @@ declare function generateRandomHash(length?: number): string;
  * ```
  */
 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;
-/**
- * 转义 HTML 属性值中的特殊字符，防止 XSS 注入
- *
- * @param str - 需要转义的字符串
- * @returns 转义后的安全字符串
- *
- * @example
- * ```typescript
- * escapeHtmlAttr('hello "world"')
- * // 'hello &quot;world&quot;'
- *
- * escapeHtmlAttr('<script>alert(1)</script>')
- * // '&lt;script&gt;alert(1)&lt;/script&gt;'
- * ```
- */
-declare function escapeHtmlAttr(str: string): string;
 /**
  * 将字节数格式化为人类可读的文件大小字符串
  *
@@ -170,19 +54,6 @@ declare function escapeHtmlAttr(str: string): string;
  * ```
  */
 declare function formatFileSize(bytes: number): string;
-/**
- * 获取文件扩展名
- *
- * @param {string} filePath - 文件路径
- * @returns {string} 小写的文件扩展名（如 '.js'）
- *
- * @example
- * ```typescript
- * getExtension('dist/app.js')  // '.js'
- * getExtension('dist/style.CSS') // '.css'
- * ```
- */
-declare function getExtension(filePath: string): string;
 
-export { escapeHtmlAttr, formatDate, formatFileSize, generateRandomHash, getDateFormatParams, getExtension, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase };
+export { formatFileSize, getDateFormatParams };
 export type { DateFormatOptions };

package/dist/common/format/index.d.ts

@@ -22,34 +22,6 @@ interface DateFormatOptions {
     timestamp: 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;
 /**
  * 获取日期格式化参数
  *
@@ -63,94 +35,6 @@ declare function generateRandomHash(length?: number): string;
  * ```
  */
 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;
-/**
- * 转义 HTML 属性值中的特殊字符，防止 XSS 注入
- *
- * @param str - 需要转义的字符串
- * @returns 转义后的安全字符串
- *
- * @example
- * ```typescript
- * escapeHtmlAttr('hello "world"')
- * // 'hello &quot;world&quot;'
- *
- * escapeHtmlAttr('<script>alert(1)</script>')
- * // '&lt;script&gt;alert(1)&lt;/script&gt;'
- * ```
- */
-declare function escapeHtmlAttr(str: string): string;
 /**
  * 将字节数格式化为人类可读的文件大小字符串
  *
@@ -170,19 +54,6 @@ declare function escapeHtmlAttr(str: string): string;
  * ```
  */
 declare function formatFileSize(bytes: number): string;
-/**
- * 获取文件扩展名
- *
- * @param {string} filePath - 文件路径
- * @returns {string} 小写的文件扩展名（如 '.js'）
- *
- * @example
- * ```typescript
- * getExtension('dist/app.js')  // '.js'
- * getExtension('dist/style.CSS') // '.css'
- * ```
- */
-declare function getExtension(filePath: string): string;
 
-export { escapeHtmlAttr, formatDate, formatFileSize, generateRandomHash, getDateFormatParams, getExtension, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase };
+export { formatFileSize, getDateFormatParams };
 export type { DateFormatOptions };

package/dist/common/format/index.mjs

@@ -1 +1 @@
-import{randomBytes as c}from"crypto";import l from"node:path";function o(e,t=2){return e.toString().padStart(t,"0")}function p(e=8){const t=Math.max(1,Math.min(64,e));return c(Math.ceil(t/2)).toString("hex").slice(0,t)}function i(e=new Date){return{YYYY:e.getFullYear().toString(),YY:e.getFullYear().toString().slice(-2),MM:o(e.getMonth()+1),DD:o(e.getDate()),HH:o(e.getHours()),mm:o(e.getMinutes()),ss:o(e.getSeconds()),SSS:o(e.getMilliseconds(),3),timestamp:e.getTime().toString()}}function g(e,t){const r=i(e);let n=t;for(const[a,s]of Object.entries(r))n=n.replace(new RegExp(`\\{${a}\\}`,"g"),s);return n}function m(e,t){let r=e;for(const[n,a]of Object.entries(t))r=r.replace(new RegExp(`\\{${n}\\}`,"g"),a);return r}function u(e,t=/[/-]/){return e.replace(/^\/+/,"").split(t).filter(Boolean).map((r,n)=>n===0?r.toLowerCase():r.charAt(0).toUpperCase()+r.slice(1).toLowerCase()).join("")}function f(e,t=/[/-]/){return e.replace(/^\/+/,"").split(t).filter(Boolean).map(r=>r.charAt(0).toUpperCase()+r.slice(1).toLowerCase()).join("")}function S(e){return e.replace(/\/\/.*$/gm,"").replace(/\/\*[\s\S]*?\*\//g,"")}function C(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function x(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}function M(e){return l.extname(e).toLowerCase()}export{C as escapeHtmlAttr,g as formatDate,x as formatFileSize,p as generateRandomHash,i as getDateFormatParams,M as getExtension,o as padNumber,m as parseTemplate,S as stripJsonComments,u as toCamelCase,f as toPascalCase};
+function t(e,r=2){return e.toString().padStart(r,"0")}function n(e=new Date){return{YYYY:e.getFullYear().toString(),YY:e.getFullYear().toString().slice(-2),MM:t(e.getMonth()+1),DD:t(e.getDate()),HH:t(e.getHours()),mm:t(e.getMinutes()),ss:t(e.getSeconds()),SSS:t(e.getMilliseconds(),3),timestamp:e.getTime().toString()}}function i(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}export{i as formatFileSize,n as getDateFormatParams};

package/dist/common/fs/index.cjs

@@ -1 +1 @@
-"use strict";const s=require("fs"),f=require("path");function _interopDefaultCompat(u){return u&&typeof u=="object"&&"default"in u?u.default:u}const s__default=_interopDefaultCompat(s),f__default=_interopDefaultCompat(f),S=10;async function checkSourceExists(u){try{await s__default.promises.access(u,s__default.constants.F_OK)}catch(t){const e=t;throw e.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${u}`):e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${u}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function ensureTargetDir(u){try{await s__default.promises.mkdir(u,{recursive:!0})}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${u}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function readDirRecursive(u,t){const e=await s__default.promises.readdir(u,{withFileTypes:!0}),r=[];for(const n of e){const a=f__default.join(u,n.name),F=n.isFile(),c=n.isDirectory();if(r.push({path:a,isFile:F,isDirectory:c}),c&&t){const l=await readDirRecursive(a,t);r.push(...l)}}return r}async function shouldUpdateFile(u,t){try{const[e,r]=await Promise.all([s__default.promises.stat(u),s__default.promises.stat(t)]);return e.mtimeMs>r.mtimeMs||e.size!==r.size}catch{return!0}}async function fileExists(u){try{return await s__default.promises.access(u,s__default.constants.F_OK),!0}catch{return!1}}async function runWithConcurrency(u,t,e){const r=[];let n=0;async function a(){for(;n<u.length;){const c=n++,l=await t(u[c]);r[c]=l}}const F=Array(Math.min(e,u.length)).fill(null).map(()=>a());return await Promise.all(F),r}async function copySourceToTarget(u,t,e){const r=Date.now(),{recursive:n,overwrite:a,incremental:F=!1,parallelLimit:c=S}=e;let l=0,p=0,E=0;if((await s__default.promises.stat(u)).isDirectory()){await ensureTargetDir(t);const o=await readDirRecursive(u,n),w=o.filter(i=>i.isFile);E=o.filter(i=>i.isDirectory).length;const h=new Set;for(const i of w){const D=f__default.relative(u,i.path),y=f__default.dirname(f__default.join(t,D));h.add(y)}await Promise.all([...h].map(i=>ensureTargetDir(i)));const A=await runWithConcurrency(w,async i=>{const D=f__default.relative(u,i.path),y=f__default.join(t,D);let m=a;return m||(m=!await fileExists(y)),F&&m&&(m=await shouldUpdateFile(i.path,y)),m?(await s__default.promises.copyFile(i.path,y),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},c);for(const i of A)i.copied&&l++,i.skipped&&p++}else{await ensureTargetDir(f__default.dirname(t));let o=a;o||(o=!await fileExists(t)),F&&o&&(o=await shouldUpdateFile(u,t)),o?(await s__default.promises.copyFile(u,t),l++):p++}const d=Date.now()-r;return{copiedFiles:l,skippedFiles:p,copiedDirs:E,executionTime:d}}async function writeFileContent(u,t){try{await s__default.promises.writeFile(u,t,"utf-8")}catch(e){const r=e;throw r.code==="EACCES"?new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u5199\u5165\u6587\u4EF6 - ${u}`):new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u5199\u5165\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${r.message}`)}}async function readFileContent(u){try{return await s__default.promises.readFile(u,"utf-8")}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${u}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}function readFileSync(u){try{return s__default.readFileSync(u,"utf-8")}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${u}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function scanDirectory(u,t={}){const{includeExtensions:e=[],excludePatterns:r=[],filter:n}=t,a=[];async function F(c){const l=await s__default.promises.readdir(c,{withFileTypes:!0});for(const p of l){const E=f__default.join(c,p.name);if(p.isDirectory()){await F(E);continue}if(!p.isFile()||r.some(w=>w.startsWith("*")?E.endsWith(w.slice(1)):E.includes(w)))continue;const d=f__default.extname(p.name).toLowerCase();if(e.length>0&&!e.includes(d))continue;const o=await s__default.promises.stat(E);n&&!n(E,d,o.size)||a.push({filePath:E,size:o.size,extension:d})}}return await F(u),a}async function writeJsonReport(u,t,e=2){await writeFileContent(u,JSON.stringify(t,null,e))}exports.checkSourceExists=checkSourceExists,exports.copySourceToTarget=copySourceToTarget,exports.ensureTargetDir=ensureTargetDir,exports.fileExists=fileExists,exports.readDirRecursive=readDirRecursive,exports.readFileContent=readFileContent,exports.readFileSync=readFileSync,exports.runWithConcurrency=runWithConcurrency,exports.scanDirectory=scanDirectory,exports.shouldUpdateFile=shouldUpdateFile,exports.writeFileContent=writeFileContent,exports.writeJsonReport=writeJsonReport;
+"use strict";const n=require("fs"),m=require("path");function _interopDefaultCompat(t){return t&&typeof t=="object"&&"default"in t?t.default:t}const n__default=_interopDefaultCompat(n),m__default=_interopDefaultCompat(m),R=10;async function checkSourceExists(t){try{await n__default.promises.access(t,n__default.constants.F_OK)}catch(u){const e=u;throw e.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${t}`):e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${t}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function h(t){try{await n__default.promises.mkdir(t,{recursive:!0})}catch(u){const e=u;throw e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${t}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function C(t,u){const e=await n__default.promises.readdir(t,{withFileTypes:!0}),s=[];for(const o of e){const a=m__default.join(t,o.name),F=o.isFile(),c=o.isDirectory();if(s.push({path:a,isFile:F,isDirectory:c}),c&&u){const l=await C(a,u);s.push(...l)}}return s}async function S(t,u){try{const[e,s]=await Promise.all([n__default.promises.stat(t),n__default.promises.stat(u)]);return e.mtimeMs>s.mtimeMs||e.size!==s.size}catch{return!0}}async function D(t){try{return await n__default.promises.access(t,n__default.constants.F_OK),!0}catch{return!1}}async function T(t,u,e){const s=[];let o=0;async function a(){for(;o<t.length;){const c=o++,l=await u(t[c]);s[c]=l}}const F=Array(Math.min(e,t.length)).fill(null).map(()=>a());return await Promise.all(F),s}async function copySourceToTarget(t,u,e){const s=Date.now(),{recursive:o,overwrite:a,incremental:F=!1,parallelLimit:c=R}=e;let l=0,E=0,p=0;if((await n__default.promises.stat(t)).isDirectory()){await h(u);const r=await C(t,o),w=r.filter(i=>i.isFile);p=r.filter(i=>i.isDirectory).length;const x=new Set;for(const i of w){const A=m__default.relative(t,i.path),d=m__default.dirname(m__default.join(u,A));x.add(d)}await Promise.all([...x].map(i=>h(i)));const g=await T(w,async i=>{const A=m__default.relative(t,i.path),d=m__default.join(u,A);let y=a;return y||(y=!await D(d)),F&&y&&(y=await S(i.path,d)),y?(await n__default.promises.copyFile(i.path,d),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},c);for(const i of g)i.copied&&l++,i.skipped&&E++}else{await h(m__default.dirname(u));let r=a;r||(r=!await D(u)),F&&r&&(r=await S(t,u)),r?(await n__default.promises.copyFile(t,u),l++):E++}const f=Date.now()-s;return{copiedFiles:l,skippedFiles:E,copiedDirs:p,executionTime:f}}async function writeFileContent(t,u){try{await n__default.promises.writeFile(t,u,"utf-8")}catch(e){const s=e;throw s.code==="EACCES"?new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u5199\u5165\u6587\u4EF6 - ${t}`):new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u5199\u5165\u6587\u4EF6\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${s.message}`)}}async function scanDirectory(t,u={}){const{includeExtensions:e=[],excludePatterns:s=[],filter:o}=u,a=[];async function F(c){const l=await n__default.promises.readdir(c,{withFileTypes:!0});for(const E of l){const p=m__default.join(c,E.name);if(E.isDirectory()){await F(p);continue}if(!E.isFile()||s.some(w=>w.startsWith("*")?p.endsWith(w.slice(1)):p.includes(w)))continue;const f=m__default.extname(E.name).toLowerCase();if(e.length>0&&!e.includes(f))continue;const r=await n__default.promises.stat(p);o&&!o(p,f,r.size)||a.push({filePath:p,size:r.size,extension:f})}}return await F(t),a}async function writeJsonReport(t,u,e=2){await writeFileContent(t,JSON.stringify(u,null,e))}exports.checkSourceExists=checkSourceExists,exports.copySourceToTarget=copySourceToTarget,exports.scanDirectory=scanDirectory,exports.writeFileContent=writeFileContent,exports.writeJsonReport=writeJsonReport;