@meng-xi/vite-plugin 0.1.5 → 0.1.6

package/README-en.md

@@ -18,7 +18,7 @@
 - **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
+- **Common Utility Library** - Built-in 6 Common utility modules supporting on-demand sub-path imports
 - **Type Safe** - Complete TypeScript type definitions with configuration validators
 - **On-demand Import** - Supports sub-path exports to reduce bundle size
 
@@ -41,7 +41,7 @@ pnpm add @meng-xi/vite-plugin -D
 
 ```typescript
 import { defineConfig } from 'vite'
-import { buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager, autoImport } from '@meng-xi/vite-plugin'
+import { autoImport, buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager } from '@meng-xi/vite-plugin'
 
 export default defineConfig({
 	plugins: [
@@ -70,9 +70,9 @@ export default defineConfig({
 | [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                                             |
 | [copyFile](https://mengxi-studio.github.io/vite-plugin/en/plugins/copy-file.html)                          | Copy files or directories after build, supports incremental copying                                                                   |
-| [envGuard](https://mengxi-studio.github.io/vite-plugin/en/plugins/)                                        | Environment variable validation with type checking, range validation, custom rules and runtime guard                                  |
+| [envGuard](https://mengxi-studio.github.io/vite-plugin/en/plugins/env-guard.html)                          | Environment variable validation with type checking, range validation, custom rules and runtime guard                                  |
 | [faviconManager](https://mengxi-studio.github.io/vite-plugin/en/plugins/favicon-manager.html)              | Manage website favicon link injection and file copying, supports string shorthand config                                              |
-| [generateRouter](https://mengxi-studio.github.io/vite-plugin/en/plugins/generate-router.html)              | Auto-generate route config from pages.json (uni-app)                                                                                  |
+| [generateRouter](https://mengxi-studio.github.io/vite-plugin/en/plugins/generate-router.html)              | Auto-generate route config and type declarations from pages.json (uni-app)                                                            |
 | [generateVersion](https://mengxi-studio.github.io/vite-plugin/en/plugins/generate-version.html)            | Auto-generate version numbers with file output and global variable injection                                                          |
 | [htmlInject](https://mengxi-studio.github.io/vite-plugin/en/plugins/html-inject.html)                      | HTML content injection with multiple positions, selector targeting, conditional injection, template variables, and security filtering |
 | [loadingManager](https://mengxi-studio.github.io/vite-plugin/en/plugins/loading-manager.html)              | Global Loading state management with request interception, debounce, transition animations, and white-screen Loading                  |
@@ -132,19 +132,33 @@ export const myPlugin = createPluginFactory(MyPlugin)
 Built-in general-purpose utility function library, organized by functional modules, supporting on-demand sub-path imports.
 
 ```typescript
-import { formatFileSize } from '@meng-xi/vite-plugin/common/format'
-import { scanDirectory } from '@meng-xi/vite-plugin/common/fs'
-import { injectBeforeTag } from '@meng-xi/vite-plugin/common/html'
+// Formatting: date params, template variable replacement, file size, date formatting
+import { getDateFormatParams, parseTemplate, formatDate, formatFileSize } from '@meng-xi/vite-plugin/common/format'
+
+// File system: file copy, directory scan, safe write, change detection
+import { copySourceToTarget, scanDirectory, writeFileSyncSafely, shouldUpdateFileContent } from '@meng-xi/vite-plugin/common/fs'
+
+// HTML: tag injection, content sanitization, attribute escaping
+import { injectBeforeTag, injectHeadAndBody, sanitizeContent, escapeHtmlAttr } from '@meng-xi/vite-plugin/common/html'
+
+// Script generation: callback function wrapping
+import { makeCallback } from '@meng-xi/vite-plugin/common/script'
+
+// Terminal UI: ANSI color codes
+import { ANSI } from '@meng-xi/vite-plugin/common/ui'
+
+// Validation: chain validator, common validation functions
+import { Validator, validateGlobalName, validateNoScriptInTemplate } from '@meng-xi/vite-plugin/common/validation'
 ```
 
-| Sub-path                                                                                     | Description             |
-| -------------------------------------------------------------------------------------------- | ----------------------- |
-| [`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/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/ui.html)                 | Terminal UI utils       |
-| [`common/validation`](https://mengxi-studio.github.io/vite-plugin/en/common/validation.html) | Validation utilities    |
+| Sub-path                                                                                     | Description                                                                                         |
+| -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| [`common/format`](https://mengxi-studio.github.io/vite-plugin/en/common/format.html)         | Date param extraction, template variable replacement `{{key}}`, date formatting `{YYYY}`, file size |
+| [`common/fs`](https://mengxi-studio.github.io/vite-plugin/en/common/fs.html)                 | File/directory copy, directory scan, sync safe write, file change detection                         |
+| [`common/html`](https://mengxi-studio.github.io/vite-plugin/en/common/html.html)             | HTML tag injection, dual-zone injection, content sanitization, HTML attribute value escaping        |
+| [`common/script`](https://mengxi-studio.github.io/vite-plugin/en/common/script.html)         | Callback body wrapping into safe function expressions (with try-catch)                              |
+| [`common/ui`](https://mengxi-studio.github.io/vite-plugin/en/common/ui.html)                 | Terminal ANSI color code constants                                                                  |
+| [`common/validation`](https://mengxi-studio.github.io/vite-plugin/en/common/validation.html) | Chain-style config validator, global name validation, script detection, callback field validation   |
 
 ## Sub-path Exports
 

package/README.md

@@ -17,7 +17,7 @@
 
 - **开箱即用** - 12 个实用插件，覆盖自动导入、构建进度、产物分析与压缩、文件复制、环境变量校验、路由生成、版本管理、HTML 注入、图标管理、全局 Loading 等场景
 - **插件开发框架** - 导出 BasePlugin、Logger、Validator 等核心组件，快速构建自定义 Vite 插件
-- **通用工具库** - 内置 Common 工具模块，支持按需子路径导入
+- **通用工具库** - 内置 6 大 Common 工具模块，支持按需子路径导入
 - **类型安全** - 完整 TypeScript 类型定义与配置验证器
 - **按需导入** - 支持子路径导出，减少打包体积
 
@@ -40,7 +40,7 @@ pnpm add @meng-xi/vite-plugin -D
 
 ```typescript
 import { defineConfig } from 'vite'
-import { buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager, autoImport } from '@meng-xi/vite-plugin'
+import { autoImport, buildProgress, bundleAnalyzer, compressAssets, copyFile, envGuard, generateRouter, generateVersion, versionUpdateChecker, htmlInject, faviconManager, loadingManager } from '@meng-xi/vite-plugin'
 
 export default defineConfig({
 	plugins: [
@@ -69,9 +69,9 @@ export default defineConfig({
 | [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，并发压缩和统计报告           |
 | [copyFile](https://mengxi-studio.github.io/vite-plugin/plugins/copy-file.html)                          | 构建完成后复制文件或目录，支持增量复制                                |
-| [envGuard](https://mengxi-studio.github.io/vite-plugin/plugins/)                                        | 环境变量校验，支持类型检查、范围验证、自定义规则和运行时守卫          |
+| [envGuard](https://mengxi-studio.github.io/vite-plugin/plugins/env-guard.html)                          | 环境变量校验，支持类型检查、范围验证、自定义规则和运行时守卫          |
 | [faviconManager](https://mengxi-studio.github.io/vite-plugin/plugins/favicon-manager.html)              | 管理网站图标链接注入和文件复制，支持字符串简写配置                    |
-| [generateRouter](https://mengxi-studio.github.io/vite-plugin/plugins/generate-router.html)              | 根据 pages.json 自动生成路由配置（uni-app）                           |
+| [generateRouter](https://mengxi-studio.github.io/vite-plugin/plugins/generate-router.html)              | 根据 pages.json 自动生成路由配置与类型声明（uni-app）                 |
 | [generateVersion](https://mengxi-studio.github.io/vite-plugin/plugins/generate-version.html)            | 自动生成版本号，支持文件输出和全局变量注入                            |
 | [htmlInject](https://mengxi-studio.github.io/vite-plugin/plugins/html-inject.html)                      | HTML 内容注入，支持多种位置、选择器定位、条件注入、模板变量和安全过滤 |
 | [loadingManager](https://mengxi-studio.github.io/vite-plugin/plugins/loading-manager.html)              | 全局 Loading 状态管理，支持请求拦截、防抖、过渡动画和白屏 Loading     |
@@ -131,19 +131,33 @@ 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 { injectBeforeTag } from '@meng-xi/vite-plugin/common/html'
+// 格式化：日期参数、模板变量替换、文件大小、日期格式化
+import { getDateFormatParams, parseTemplate, formatDate, formatFileSize } from '@meng-xi/vite-plugin/common/format'
+
+// 文件系统：文件复制、目录扫描、安全写入、变更检测
+import { copySourceToTarget, scanDirectory, writeFileSyncSafely, shouldUpdateFileContent } from '@meng-xi/vite-plugin/common/fs'
+
+// HTML：标签注入、内容消毒、属性转义
+import { injectBeforeTag, injectHeadAndBody, sanitizeContent, escapeHtmlAttr } from '@meng-xi/vite-plugin/common/html'
+
+// 脚本生成：回调函数包装
+import { makeCallback } from '@meng-xi/vite-plugin/common/script'
+
+// 终端 UI：ANSI 颜色码
+import { ANSI } from '@meng-xi/vite-plugin/common/ui'
+
+// 参数验证：链式验证器、通用校验函数
+import { Validator, validateGlobalName, validateNoScriptInTemplate } from '@meng-xi/vite-plugin/common/validation'
 ```
 
-| 子路径                                                                                    | 描述          |
-| ----------------------------------------------------------------------------------------- | ------------- |
-| [`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/script`](https://mengxi-studio.github.io/vite-plugin/common/script.html)         | 脚本生成工具  |
-| [`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) | 参数验证工具  |
+| 子路径                                                                                    | 描述                                                                      |
+| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| [`common/format`](https://mengxi-studio.github.io/vite-plugin/common/format.html)         | 日期参数提取、模板变量替换 `{{key}}`、日期格式化 `{YYYY}`、文件大小格式化 |
+| [`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 标签注入、双区域注入、内容安全消毒、HTML 属性值转义                  |
+| [`common/script`](https://mengxi-studio.github.io/vite-plugin/common/script.html)         | 回调函数体包装为安全的函数表达式（含 try-catch）                          |
+| [`common/ui`](https://mengxi-studio.github.io/vite-plugin/common/ui.html)                 | 终端 ANSI 颜色码常量                                                      |
+| [`common/validation`](https://mengxi-studio.github.io/vite-plugin/common/validation.html) | 链式配置验证器、全局名称校验、脚本检测、回调字段校验                      |
 
 ## 子路径导出
 

package/dist/common/format/index.cjs

@@ -1 +1 @@
-"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;
+"use strict";function t(e,r=2){return e.toString().padStart(r,"0")}function getDateFormatParams(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 parseTemplate(e,r){let o=e;for(const[n,a]of Object.entries(r)){const s=n.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),i=a.replace(/\$/g,"$$$$");o=o.replace(new RegExp(`\\{\\{${s}\\}\\}`,"g"),i)}return o}function formatDate(e,r){const o=getDateFormatParams(e);let n=r;for(const[a,s]of Object.entries(o))n=n.replace(new RegExp(`\\{${a}\\}`,"g"),s);return n}function formatFileSize(e){return e<1024?`${e}B`:e<1024*1024?`${(e/1024).toFixed(1)}KB`:`${(e/(1024*1024)).toFixed(2)}MB`}exports.formatDate=formatDate,exports.formatFileSize=formatFileSize,exports.getDateFormatParams=getDateFormatParams,exports.parseTemplate=parseTemplate;

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

@@ -35,6 +35,40 @@ interface DateFormatOptions {
  * ```
  */
 declare function getDateFormatParams(date?: Date): DateFormatOptions;
+/**
+ * 替换模板字符串中的变量占位符
+ *
+ * @param template - 包含 `{{key}}` 占位符的模板字符串
+ * @param values - 占位符键值映射，支持合并多组变量（后者覆盖前者）
+ * @returns 替换占位符后的字符串
+ *
+ * @description 将模板中的 `{{key}}` 占位符替换为对应的值。
+ * 键名中的正则特殊字符会被自动转义，值中的 `$` 也会被安全处理。
+ *
+ * @example
+ * ```typescript
+ * parseTemplate('Hello {{name}}!', { name: 'World' })
+ * // 'Hello World!'
+ *
+ * parseTemplate('{{YYYY}}-{{MM}}-{{DD}}', getDateFormatParams())
+ * // '2026-06-06'
+ * ```
+ */
+declare function parseTemplate(template: string, values: Record<string, string>): string;
+/**
+ * 格式化日期字符串
+ *
+ * @param date - 日期对象
+ * @param format - 格式字符串，支持 `{YYYY}`、`{MM}`、`{DD}`、`{HH}`、`{mm}`、`{ss}` 等占位符
+ * @returns 格式化后的日期字符串
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date(), '{YYYY}-{MM}-{DD}T{HH}:{mm}:{ss}')
+ * // '2026-06-06T15:30:00'
+ * ```
+ */
+declare function formatDate(date: Date, format: string): string;
 /**
  * 将字节数格式化为人类可读的文件大小字符串
  *
@@ -55,5 +89,5 @@ declare function getDateFormatParams(date?: Date): DateFormatOptions;
  */
 declare function formatFileSize(bytes: number): string;
 
-export { formatFileSize, getDateFormatParams };
+export { formatDate, formatFileSize, getDateFormatParams, parseTemplate };
 export type { DateFormatOptions };

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

@@ -35,6 +35,40 @@ interface DateFormatOptions {
  * ```
  */
 declare function getDateFormatParams(date?: Date): DateFormatOptions;
+/**
+ * 替换模板字符串中的变量占位符
+ *
+ * @param template - 包含 `{{key}}` 占位符的模板字符串
+ * @param values - 占位符键值映射，支持合并多组变量（后者覆盖前者）
+ * @returns 替换占位符后的字符串
+ *
+ * @description 将模板中的 `{{key}}` 占位符替换为对应的值。
+ * 键名中的正则特殊字符会被自动转义，值中的 `$` 也会被安全处理。
+ *
+ * @example
+ * ```typescript
+ * parseTemplate('Hello {{name}}!', { name: 'World' })
+ * // 'Hello World!'
+ *
+ * parseTemplate('{{YYYY}}-{{MM}}-{{DD}}', getDateFormatParams())
+ * // '2026-06-06'
+ * ```
+ */
+declare function parseTemplate(template: string, values: Record<string, string>): string;
+/**
+ * 格式化日期字符串
+ *
+ * @param date - 日期对象
+ * @param format - 格式字符串，支持 `{YYYY}`、`{MM}`、`{DD}`、`{HH}`、`{mm}`、`{ss}` 等占位符
+ * @returns 格式化后的日期字符串
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date(), '{YYYY}-{MM}-{DD}T{HH}:{mm}:{ss}')
+ * // '2026-06-06T15:30:00'
+ * ```
+ */
+declare function formatDate(date: Date, format: string): string;
 /**
  * 将字节数格式化为人类可读的文件大小字符串
  *
@@ -55,5 +89,5 @@ declare function getDateFormatParams(date?: Date): DateFormatOptions;
  */
 declare function formatFileSize(bytes: number): string;
 
-export { formatFileSize, getDateFormatParams };
+export { formatDate, formatFileSize, getDateFormatParams, parseTemplate };
 export type { DateFormatOptions };

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

@@ -35,6 +35,40 @@ interface DateFormatOptions {
  * ```
  */
 declare function getDateFormatParams(date?: Date): DateFormatOptions;
+/**
+ * 替换模板字符串中的变量占位符
+ *
+ * @param template - 包含 `{{key}}` 占位符的模板字符串
+ * @param values - 占位符键值映射，支持合并多组变量（后者覆盖前者）
+ * @returns 替换占位符后的字符串
+ *
+ * @description 将模板中的 `{{key}}` 占位符替换为对应的值。
+ * 键名中的正则特殊字符会被自动转义，值中的 `$` 也会被安全处理。
+ *
+ * @example
+ * ```typescript
+ * parseTemplate('Hello {{name}}!', { name: 'World' })
+ * // 'Hello World!'
+ *
+ * parseTemplate('{{YYYY}}-{{MM}}-{{DD}}', getDateFormatParams())
+ * // '2026-06-06'
+ * ```
+ */
+declare function parseTemplate(template: string, values: Record<string, string>): string;
+/**
+ * 格式化日期字符串
+ *
+ * @param date - 日期对象
+ * @param format - 格式字符串，支持 `{YYYY}`、`{MM}`、`{DD}`、`{HH}`、`{mm}`、`{ss}` 等占位符
+ * @returns 格式化后的日期字符串
+ *
+ * @example
+ * ```typescript
+ * formatDate(new Date(), '{YYYY}-{MM}-{DD}T{HH}:{mm}:{ss}')
+ * // '2026-06-06T15:30:00'
+ * ```
+ */
+declare function formatDate(date: Date, format: string): string;
 /**
  * 将字节数格式化为人类可读的文件大小字符串
  *
@@ -55,5 +89,5 @@ declare function getDateFormatParams(date?: Date): DateFormatOptions;
  */
 declare function formatFileSize(bytes: number): string;
 
-export { formatFileSize, getDateFormatParams };
+export { formatDate, formatFileSize, getDateFormatParams, parseTemplate };
 export type { DateFormatOptions };

package/dist/common/format/index.mjs

@@ -1 +1 @@
-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};
+function e(t,n=2){return t.toString().padStart(n,"0")}function g(t=new Date){return{YYYY:t.getFullYear().toString(),YY:t.getFullYear().toString().slice(-2),MM:e(t.getMonth()+1),DD:e(t.getDate()),HH:e(t.getHours()),mm:e(t.getMinutes()),ss:e(t.getSeconds()),SSS:e(t.getMilliseconds(),3),timestamp:t.getTime().toString()}}function c(t,n){let r=t;for(const[o,i]of Object.entries(n)){const a=o.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),s=i.replace(/\$/g,"$$$$");r=r.replace(new RegExp(`\\{\\{${a}\\}\\}`,"g"),s)}return r}function l(t,n){const r=g(t);let o=n;for(const[i,a]of Object.entries(r))o=o.replace(new RegExp(`\\{${i}\\}`,"g"),a);return o}function u(t){return t<1024?`${t}B`:t<1024*1024?`${(t/1024).toFixed(1)}KB`:`${(t/(1024*1024)).toFixed(2)}MB`}export{l as formatDate,u as formatFileSize,g as getDateFormatParams,c as parseTemplate};

package/dist/common/fs/index.cjs

@@ -1 +1 @@
-"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;
+"use strict";const s=require("fs"),u=require("path");function _interopDefaultCompat(t){return t&&typeof t=="object"&&"default"in t?t.default:t}const s__default=_interopDefaultCompat(s),u__default=_interopDefaultCompat(u),R=10;async function checkSourceExists(t){try{await s__default.promises.access(t,s__default.constants.F_OK)}catch(e){const i=e;throw i.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${t}`):i.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${i.message}`)}}async function g(t){try{await s__default.promises.mkdir(t,{recursive:!0})}catch(e){const i=e;throw i.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${i.message}`)}}async function h(t,e){const i=await s__default.promises.readdir(t,{withFileTypes:!0}),r=[];for(const o of i){const c=u__default.join(t,o.name),l=o.isFile(),F=o.isDirectory();if(r.push({path:c,isFile:l,isDirectory:F}),F&&e){const p=await h(c,e);r.push(...p)}}return r}async function C(t,e){try{const[i,r]=await Promise.all([s__default.promises.stat(t),s__default.promises.stat(e)]);return i.mtimeMs>r.mtimeMs||i.size!==r.size}catch{return!0}}async function D(t){try{return await s__default.promises.access(t,s__default.constants.F_OK),!0}catch{return!1}}async function T(t,e,i){const r=[];let o=0;async function c(){for(;o<t.length;){const F=o++,p=await e(t[F]);r[F]=p}}const l=Array(Math.min(i,t.length)).fill(null).map(()=>c());return await Promise.all(l),r}async function copySourceToTarget(t,e,i){const r=Date.now(),{recursive:o,overwrite:c,incremental:l=!1,parallelLimit:F=R}=i;let p=0,w=0,f=0;if((await s__default.promises.stat(t)).isDirectory()){await g(e);const a=await h(t,o),E=a.filter(n=>n.isFile);f=a.filter(n=>n.isDirectory).length;const S=new Set;for(const n of E){const A=u__default.relative(t,n.path),d=u__default.dirname(u__default.join(e,A));S.add(d)}await Promise.all([...S].map(n=>g(n)));const x=await T(E,async n=>{const A=u__default.relative(t,n.path),d=u__default.join(e,A);let m=c;return m||(m=!await D(d)),l&&m&&(m=await C(n.path,d)),m?(await s__default.promises.copyFile(n.path,d),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},F);for(const n of x)n.copied&&p++,n.skipped&&w++}else{await g(u__default.dirname(e));let a=c;a||(a=!await D(e)),l&&a&&(a=await C(t,e)),a?(await s__default.promises.copyFile(t,e),p++):w++}const y=Date.now()-r;return{copiedFiles:p,skippedFiles:w,copiedDirs:f,executionTime:y}}async function writeFileContent(t,e){try{await s__default.promises.writeFile(t,e,"utf-8")}catch(i){const r=i;throw r.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${r.message}`)}}async function scanDirectory(t,e={}){const{includeExtensions:i=[],excludePatterns:r=[],filter:o}=e,c=[];async function l(F){const p=await s__default.promises.readdir(F,{withFileTypes:!0});for(const w of p){const f=u__default.join(F,w.name);if(w.isDirectory()){await l(f);continue}if(!w.isFile()||r.some(E=>E.startsWith("*")?f.endsWith(E.slice(1)):f.includes(E)))continue;const y=u__default.extname(w.name).toLowerCase();if(i.length>0&&!i.includes(y))continue;const a=await s__default.promises.stat(f);o&&!o(f,y,a.size)||c.push({filePath:f,size:a.size,extension:y})}}return await l(t),c}async function writeJsonReport(t,e,i=2){await writeFileContent(t,JSON.stringify(e,null,i))}function writeFileSyncSafely(t,e){const i=u__default.dirname(t);s__default.existsSync(i)||s__default.mkdirSync(i,{recursive:!0}),s__default.writeFileSync(t,e,"utf-8")}function shouldUpdateFileContent(t,e){if(!s__default.existsSync(t))return!0;try{return s__default.readFileSync(t,"utf-8")!==e}catch{return!0}}exports.checkSourceExists=checkSourceExists,exports.copySourceToTarget=copySourceToTarget,exports.scanDirectory=scanDirectory,exports.shouldUpdateFileContent=shouldUpdateFileContent,exports.writeFileContent=writeFileContent,exports.writeFileSyncSafely=writeFileSyncSafely,exports.writeJsonReport=writeJsonReport;

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

@@ -125,6 +125,41 @@ declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions):
  * ```
  */
 declare function writeJsonReport(filePath: string, data: object, indent?: number): Promise<void>;
+/**
+ * 同步写入文件内容，自动创建不存在的目录
+ *
+ * @param filePath 文件路径
+ * @param content 文件内容
+ *
+ * @description 同步写入文件，如果目标目录不存在会自动递归创建。
+ * 适用于构建钩子中需要同步写入的场景（如 `transform` 钩子）。
+ *
+ * @throws 当文件写入失败时（如权限不足），抛出 `NodeJS.ErrnoException`
+ *
+ * @example
+ * ```typescript
+ * writeFileSyncSafely('/project/src/auto-imports.d.ts', 'declare global { ... }')
+ * ```
+ */
+declare function writeFileSyncSafely(filePath: string, content: string): void;
+/**
+ * 检查文件内容是否需要更新（同步版本）
+ *
+ * @param filePath 文件路径
+ * @param newContent 新生成的文件内容
+ * @returns 如果需要更新返回 `true`，否则返回 `false`
+ *
+ * @description 对比现有文件内容与新生成的内容，
+ * 仅在内容发生变化时才需要写入，减少不必要的文件 IO 操作。
+ *
+ * @example
+ * ```typescript
+ * if (shouldUpdateFileContent('/project/src/auto-imports.d.ts', newContent)) {
+ *   writeFileSyncSafely('/project/src/auto-imports.d.ts', newContent)
+ * }
+ * ```
+ */
+declare function shouldUpdateFileContent(filePath: string, newContent: string): boolean;
 
-export { checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport };
+export { checkSourceExists, copySourceToTarget, scanDirectory, shouldUpdateFileContent, writeFileContent, writeFileSyncSafely, writeJsonReport };
 export type { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile };

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

@@ -125,6 +125,41 @@ declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions):
  * ```
  */
 declare function writeJsonReport(filePath: string, data: object, indent?: number): Promise<void>;
+/**
+ * 同步写入文件内容，自动创建不存在的目录
+ *
+ * @param filePath 文件路径
+ * @param content 文件内容
+ *
+ * @description 同步写入文件，如果目标目录不存在会自动递归创建。
+ * 适用于构建钩子中需要同步写入的场景（如 `transform` 钩子）。
+ *
+ * @throws 当文件写入失败时（如权限不足），抛出 `NodeJS.ErrnoException`
+ *
+ * @example
+ * ```typescript
+ * writeFileSyncSafely('/project/src/auto-imports.d.ts', 'declare global { ... }')
+ * ```
+ */
+declare function writeFileSyncSafely(filePath: string, content: string): void;
+/**
+ * 检查文件内容是否需要更新（同步版本）
+ *
+ * @param filePath 文件路径
+ * @param newContent 新生成的文件内容
+ * @returns 如果需要更新返回 `true`，否则返回 `false`
+ *
+ * @description 对比现有文件内容与新生成的内容，
+ * 仅在内容发生变化时才需要写入，减少不必要的文件 IO 操作。
+ *
+ * @example
+ * ```typescript
+ * if (shouldUpdateFileContent('/project/src/auto-imports.d.ts', newContent)) {
+ *   writeFileSyncSafely('/project/src/auto-imports.d.ts', newContent)
+ * }
+ * ```
+ */
+declare function shouldUpdateFileContent(filePath: string, newContent: string): boolean;
 
-export { checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport };
+export { checkSourceExists, copySourceToTarget, scanDirectory, shouldUpdateFileContent, writeFileContent, writeFileSyncSafely, writeJsonReport };
 export type { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile };

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

@@ -125,6 +125,41 @@ declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions):
  * ```
  */
 declare function writeJsonReport(filePath: string, data: object, indent?: number): Promise<void>;
+/**
+ * 同步写入文件内容，自动创建不存在的目录
+ *
+ * @param filePath 文件路径
+ * @param content 文件内容
+ *
+ * @description 同步写入文件，如果目标目录不存在会自动递归创建。
+ * 适用于构建钩子中需要同步写入的场景（如 `transform` 钩子）。
+ *
+ * @throws 当文件写入失败时（如权限不足），抛出 `NodeJS.ErrnoException`
+ *
+ * @example
+ * ```typescript
+ * writeFileSyncSafely('/project/src/auto-imports.d.ts', 'declare global { ... }')
+ * ```
+ */
+declare function writeFileSyncSafely(filePath: string, content: string): void;
+/**
+ * 检查文件内容是否需要更新（同步版本）
+ *
+ * @param filePath 文件路径
+ * @param newContent 新生成的文件内容
+ * @returns 如果需要更新返回 `true`，否则返回 `false`
+ *
+ * @description 对比现有文件内容与新生成的内容，
+ * 仅在内容发生变化时才需要写入，减少不必要的文件 IO 操作。
+ *
+ * @example
+ * ```typescript
+ * if (shouldUpdateFileContent('/project/src/auto-imports.d.ts', newContent)) {
+ *   writeFileSyncSafely('/project/src/auto-imports.d.ts', newContent)
+ * }
+ * ```
+ */
+declare function shouldUpdateFileContent(filePath: string, newContent: string): boolean;
 
-export { checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport };
+export { checkSourceExists, copySourceToTarget, scanDirectory, shouldUpdateFileContent, writeFileContent, writeFileSyncSafely, writeJsonReport };
 export type { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile };

package/dist/common/fs/index.mjs

@@ -1 +1 @@
-import n from"fs";import p from"path";const S=10;async function T(t){try{await n.promises.access(t,n.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 D(t){try{await n.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.promises.readdir(t,{withFileTypes:!0}),i=[];for(const o of e){const r=p.join(t,o.name),F=o.isFile(),c=o.isDirectory();if(i.push({path:r,isFile:F,isDirectory:c}),c&&u){const l=await C(r,u);i.push(...l)}}return i}async function g(t,u){try{const[e,i]=await Promise.all([n.promises.stat(t),n.promises.stat(u)]);return e.mtimeMs>i.mtimeMs||e.size!==i.size}catch{return!0}}async function $(t){try{return await n.promises.access(t,n.constants.F_OK),!0}catch{return!1}}async function k(t,u,e){const i=[];let o=0;async function r(){for(;o<t.length;){const c=o++,l=await u(t[c]);i[c]=l}}const F=Array(Math.min(e,t.length)).fill(null).map(()=>r());return await Promise.all(F),i}async function v(t,u,e){const i=Date.now(),{recursive:o,overwrite:r,incremental:F=!1,parallelLimit:c=S}=e;let l=0,w=0,E=0;if((await n.promises.stat(t)).isDirectory()){await D(u);const a=await C(t,o),f=a.filter(s=>s.isFile);E=a.filter(s=>s.isDirectory).length;const A=new Set;for(const s of f){const h=p.relative(t,s.path),y=p.dirname(p.join(u,h));A.add(y)}await Promise.all([...A].map(s=>D(s)));const B=await k(f,async s=>{const h=p.relative(t,s.path),y=p.join(u,h);let d=r;return d||(d=!await $(y)),F&&d&&(d=await g(s.path,y)),d?(await n.promises.copyFile(s.path,y),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},c);for(const s of B)s.copied&&l++,s.skipped&&w++}else{await D(p.dirname(u));let a=r;a||(a=!await $(u)),F&&a&&(a=await g(t,u)),a?(await n.promises.copyFile(t,u),l++):w++}const m=Date.now()-i;return{copiedFiles:l,skippedFiles:w,copiedDirs:E,executionTime:m}}async function x(t,u){try{await n.promises.writeFile(t,u,"utf-8")}catch(e){const i=e;throw i.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${i.message}`)}}async function z(t,u={}){const{includeExtensions:e=[],excludePatterns:i=[],filter:o}=u,r=[];async function F(c){const l=await n.promises.readdir(c,{withFileTypes:!0});for(const w of l){const E=p.join(c,w.name);if(w.isDirectory()){await F(E);continue}if(!w.isFile()||i.some(f=>f.startsWith("*")?E.endsWith(f.slice(1)):E.includes(f)))continue;const m=p.extname(w.name).toLowerCase();if(e.length>0&&!e.includes(m))continue;const a=await n.promises.stat(E);o&&!o(E,m,a.size)||r.push({filePath:E,size:a.size,extension:m})}}return await F(t),r}async function P(t,u,e=2){await x(t,JSON.stringify(u,null,e))}export{T as checkSourceExists,v as copySourceToTarget,z as scanDirectory,x as writeFileContent,P as writeJsonReport};
+import e from"fs";import F from"path";const B=10;async function k(t){try{await e.promises.access(t,e.constants.F_OK)}catch(u){const i=u;throw i.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${t}`):i.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${i.message}`)}}async function D(t){try{await e.promises.mkdir(t,{recursive:!0})}catch(u){const i=u;throw i.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${i.message}`)}}async function C(t,u){const i=await e.promises.readdir(t,{withFileTypes:!0}),r=[];for(const n of i){const a=F.join(t,n.name),l=n.isFile(),c=n.isDirectory();if(r.push({path:a,isFile:l,isDirectory:c}),c&&u){const p=await C(a,u);r.push(...p)}}return r}async function S(t,u){try{const[i,r]=await Promise.all([e.promises.stat(t),e.promises.stat(u)]);return i.mtimeMs>r.mtimeMs||i.size!==r.size}catch{return!0}}async function x(t){try{return await e.promises.access(t,e.constants.F_OK),!0}catch{return!1}}async function v(t,u,i){const r=[];let n=0;async function a(){for(;n<t.length;){const c=n++,p=await u(t[c]);r[c]=p}}const l=Array(Math.min(i,t.length)).fill(null).map(()=>a());return await Promise.all(l),r}async function T(t,u,i){const r=Date.now(),{recursive:n,overwrite:a,incremental:l=!1,parallelLimit:c=B}=i;let p=0,E=0,w=0;if((await e.promises.stat(t)).isDirectory()){await D(u);const o=await C(t,n),f=o.filter(s=>s.isFile);w=o.filter(s=>s.isDirectory).length;const A=new Set;for(const s of f){const h=F.relative(t,s.path),y=F.dirname(F.join(u,h));A.add(y)}await Promise.all([...A].map(s=>D(s)));const $=await v(f,async s=>{const h=F.relative(t,s.path),y=F.join(u,h);let d=a;return d||(d=!await x(y)),l&&d&&(d=await S(s.path,y)),d?(await e.promises.copyFile(s.path,y),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},c);for(const s of $)s.copied&&p++,s.skipped&&E++}else{await D(F.dirname(u));let o=a;o||(o=!await x(u)),l&&o&&(o=await S(t,u)),o?(await e.promises.copyFile(t,u),p++):E++}const m=Date.now()-r;return{copiedFiles:p,skippedFiles:E,copiedDirs:w,executionTime:m}}async function g(t,u){try{await e.promises.writeFile(t,u,"utf-8")}catch(i){const r=i;throw r.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${r.message}`)}}async function z(t,u={}){const{includeExtensions:i=[],excludePatterns:r=[],filter:n}=u,a=[];async function l(c){const p=await e.promises.readdir(c,{withFileTypes:!0});for(const E of p){const w=F.join(c,E.name);if(E.isDirectory()){await l(w);continue}if(!E.isFile()||r.some(f=>f.startsWith("*")?w.endsWith(f.slice(1)):w.includes(f)))continue;const m=F.extname(E.name).toLowerCase();if(i.length>0&&!i.includes(m))continue;const o=await e.promises.stat(w);n&&!n(w,m,o.size)||a.push({filePath:w,size:o.size,extension:m})}}return await l(t),a}async function P(t,u,i=2){await g(t,JSON.stringify(u,null,i))}function j(t,u){const i=F.dirname(t);e.existsSync(i)||e.mkdirSync(i,{recursive:!0}),e.writeFileSync(t,u,"utf-8")}function O(t,u){if(!e.existsSync(t))return!0;try{return e.readFileSync(t,"utf-8")!==u}catch{return!0}}export{k as checkSourceExists,T as copySourceToTarget,z as scanDirectory,O as shouldUpdateFileContent,g as writeFileContent,j as writeFileSyncSafely,P as writeJsonReport};

package/dist/common/html/index.cjs

@@ -1,2 +1,2 @@
-"use strict";const security=require("../../shared/vite-plugin.CnOy46d3.cjs");function injectBeforeTag(e,t,s){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${s}
-${t}`),injected:!0}:{html:e,injected:!1}}function c(e,t,s){const n=injectBeforeTag(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const i=injectBeforeTag(e,"</html>",t);return i.injected?{...i,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function injectHeadAndBody(e,t,s){let n=e,i=!1;if(t){const d=injectBeforeTag(n,"</head>",t);d.injected&&(n=d.html,i=!0)}const l=c(n,s);return{html:l.html,headInjected:i,bodyInjected:l.injected,usedFallback:l.usedFallback}}exports.sanitizeContent=security.sanitizeContent,exports.injectBeforeTag=injectBeforeTag,exports.injectHeadAndBody=injectHeadAndBody;
+"use strict";const security=require("../../shared/vite-plugin.CcvHfrL8.cjs");function injectBeforeTag(e,t,l){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${l}
+${t}`),injected:!0}:{html:e,injected:!1}}function c(e,t,l){const n=injectBeforeTag(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const s=injectBeforeTag(e,"</html>",t);return s.injected?{...s,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function injectHeadAndBody(e,t,l){let n=e,s=!1;if(t){const r=injectBeforeTag(n,"</head>",t);r.injected&&(n=r.html,s=!0)}const i=c(n,l);return{html:i.html,headInjected:s,bodyInjected:i.injected,usedFallback:i.usedFallback}}exports.escapeHtmlAttr=security.escapeHtmlAttr,exports.sanitizeContent=security.sanitizeContent,exports.injectBeforeTag=injectBeforeTag,exports.injectHeadAndBody=injectHeadAndBody;

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

@@ -1,6 +1,22 @@
 import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.cjs';
 export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.cjs';
 
+/**
+ * 转义 HTML 属性值中的特殊字符
+ *
+ * @param str - 需要转义的字符串
+ * @returns 转义后的安全字符串
+ *
+ * @description 将字符串中的 `&`、`"`、`'`、`<`、`>` 转义为对应的 HTML 实体，
+ * 防止在 HTML 属性值中注入恶意代码。
+ *
+ * @example
+ * ```typescript
+ * escapeHtmlAttr('hello "world" & <friends>')
+ * // 'hello &quot;world&quot; &amp; &lt;friends&gt;'
+ * ```
+ */
+declare function escapeHtmlAttr(str: string): string;
 /**
  * 内容消毒规则选项
  */
@@ -43,5 +59,5 @@ declare function injectBeforeTag(html: string, tag: string, code: string): HtmlI
  */
 declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
 
-export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
+export { DualInjectResult, HtmlInjectResult, SecurityConfig, escapeHtmlAttr, injectBeforeTag, injectHeadAndBody, sanitizeContent };
 export type { SanitizeRuleOptions };

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

@@ -1,6 +1,22 @@
 import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.mjs';
 export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.mjs';
 
+/**
+ * 转义 HTML 属性值中的特殊字符
+ *
+ * @param str - 需要转义的字符串
+ * @returns 转义后的安全字符串
+ *
+ * @description 将字符串中的 `&`、`"`、`'`、`<`、`>` 转义为对应的 HTML 实体，
+ * 防止在 HTML 属性值中注入恶意代码。
+ *
+ * @example
+ * ```typescript
+ * escapeHtmlAttr('hello "world" & <friends>')
+ * // 'hello &quot;world&quot; &amp; &lt;friends&gt;'
+ * ```
+ */
+declare function escapeHtmlAttr(str: string): string;
 /**
  * 内容消毒规则选项
  */
@@ -43,5 +59,5 @@ declare function injectBeforeTag(html: string, tag: string, code: string): HtmlI
  */
 declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
 
-export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
+export { DualInjectResult, HtmlInjectResult, SecurityConfig, escapeHtmlAttr, injectBeforeTag, injectHeadAndBody, sanitizeContent };
 export type { SanitizeRuleOptions };

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

@@ -1,6 +1,22 @@
 import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.js';
 export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.js';
 
+/**
+ * 转义 HTML 属性值中的特殊字符
+ *
+ * @param str - 需要转义的字符串
+ * @returns 转义后的安全字符串
+ *
+ * @description 将字符串中的 `&`、`"`、`'`、`<`、`>` 转义为对应的 HTML 实体，
+ * 防止在 HTML 属性值中注入恶意代码。
+ *
+ * @example
+ * ```typescript
+ * escapeHtmlAttr('hello "world" & <friends>')
+ * // 'hello &quot;world&quot; &amp; &lt;friends&gt;'
+ * ```
+ */
+declare function escapeHtmlAttr(str: string): string;
 /**
  * 内容消毒规则选项
  */
@@ -43,5 +59,5 @@ declare function injectBeforeTag(html: string, tag: string, code: string): HtmlI
  */
 declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
 
-export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
+export { DualInjectResult, HtmlInjectResult, SecurityConfig, escapeHtmlAttr, injectBeforeTag, injectHeadAndBody, sanitizeContent };
 export type { SanitizeRuleOptions };

package/dist/common/html/index.mjs

@@ -1,2 +1,2 @@
-export{s as sanitizeContent}from"../../shared/vite-plugin.BPFqtmWa.mjs";function a(e,t,l){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${l}
-${t}`),injected:!0}:{html:e,injected:!1}}function i(e,t,l){const n=a(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const c=a(e,"</html>",t);return c.injected?{...c,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function r(e,t,l){let n=e,c=!1;if(t){const s=a(n,"</head>",t);s.injected&&(n=s.html,c=!0)}const d=i(n,l);return{html:d.html,headInjected:c,bodyInjected:d.injected,usedFallback:d.usedFallback}}export{a as injectBeforeTag,r as injectHeadAndBody};
+export{e as escapeHtmlAttr,s as sanitizeContent}from"../../shared/vite-plugin.CuXEJAWX.mjs";function a(e,t,l){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${l}
+${t}`),injected:!0}:{html:e,injected:!1}}function r(e,t,l){const n=a(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const c=a(e,"</html>",t);return c.injected?{...c,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function i(e,t,l){let n=e,c=!1;if(t){const s=a(n,"</head>",t);s.injected&&(n=s.html,c=!0)}const d=r(n,l);return{html:d.html,headInjected:c,bodyInjected:d.injected,usedFallback:d.usedFallback}}export{a as injectBeforeTag,i as injectHeadAndBody};