@meng-xi/vite-plugin 0.0.9 → 0.1.1

package/dist/common/format/index.cjs

@@ -0,0 +1 @@
+"use strict";const crypto=require("crypto");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 a=t;for(const[o,n]of Object.entries(r))a=a.replace(new RegExp(`\\{${o}\\}`,"g"),n);return a}function parseTemplate(e,t){let r=e;for(const[a,o]of Object.entries(t))r=r.replace(new RegExp(`\\{${a}\\}`,"g"),o);return r}function toCamelCase(e,t=/[/-]/){return e.replace(/^\/+/,"").split(t).filter(Boolean).map((r,a)=>a===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;")}exports.escapeHtmlAttr=escapeHtmlAttr,exports.formatDate=formatDate,exports.generateRandomHash=generateRandomHash,exports.getDateFormatParams=getDateFormatParams,exports.padNumber=padNumber,exports.parseTemplate=parseTemplate,exports.stripJsonComments=stripJsonComments,exports.toCamelCase=toCamelCase,exports.toPascalCase=toPascalCase;

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

@@ -0,0 +1,156 @@
+/**
+ * 日期格式化选项
+ */
+interface DateFormatOptions {
+    /** 四位年份 */
+    YYYY: string;
+    /** 两位年份 */
+    YY: string;
+    /** 两位月份 */
+    MM: string;
+    /** 两位日期 */
+    DD: string;
+    /** 两位小时（24小时制） */
+    HH: string;
+    /** 两位分钟 */
+    mm: string;
+    /** 两位秒数 */
+    ss: string;
+    /** 三位毫秒 */
+    SSS: string;
+    /** 时间戳（毫秒） */
+    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;
+/**
+ * 获取日期格式化参数
+ *
+ * @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;
+/**
+ * 转义 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;
+
+export { escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase };
+export type { DateFormatOptions };

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

@@ -0,0 +1,156 @@
+/**
+ * 日期格式化选项
+ */
+interface DateFormatOptions {
+    /** 四位年份 */
+    YYYY: string;
+    /** 两位年份 */
+    YY: string;
+    /** 两位月份 */
+    MM: string;
+    /** 两位日期 */
+    DD: string;
+    /** 两位小时（24小时制） */
+    HH: string;
+    /** 两位分钟 */
+    mm: string;
+    /** 两位秒数 */
+    ss: string;
+    /** 三位毫秒 */
+    SSS: string;
+    /** 时间戳（毫秒） */
+    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;
+/**
+ * 获取日期格式化参数
+ *
+ * @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;
+/**
+ * 转义 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;
+
+export { escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase };
+export type { DateFormatOptions };

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

@@ -0,0 +1,156 @@
+/**
+ * 日期格式化选项
+ */
+interface DateFormatOptions {
+    /** 四位年份 */
+    YYYY: string;
+    /** 两位年份 */
+    YY: string;
+    /** 两位月份 */
+    MM: string;
+    /** 两位日期 */
+    DD: string;
+    /** 两位小时（24小时制） */
+    HH: string;
+    /** 两位分钟 */
+    mm: string;
+    /** 两位秒数 */
+    ss: string;
+    /** 三位毫秒 */
+    SSS: string;
+    /** 时间戳（毫秒） */
+    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;
+/**
+ * 获取日期格式化参数
+ *
+ * @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;
+/**
+ * 转义 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;
+
+export { escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase };
+export type { DateFormatOptions };

package/dist/common/format/index.mjs

@@ -0,0 +1 @@
+import{randomBytes as i}from"crypto";function o(e,t=2){return e.toString().padStart(t,"0")}function l(e=8){const t=Math.max(1,Math.min(64,e));return i(Math.ceil(t/2)).toString("hex").slice(0,t)}function s(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 p(e,t){const r=s(e);let n=t;for(const[a,c]of Object.entries(r))n=n.replace(new RegExp(`\\{${a}\\}`,"g"),c);return n}function g(e,t){let r=e;for(const[n,a]of Object.entries(t))r=r.replace(new RegExp(`\\{${n}\\}`,"g"),a);return r}function m(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 u(e,t=/[/-]/){return e.replace(/^\/+/,"").split(t).filter(Boolean).map(r=>r.charAt(0).toUpperCase()+r.slice(1).toLowerCase()).join("")}function f(e){return e.replace(/\/\/.*$/gm,"").replace(/\/\*[\s\S]*?\*\//g,"")}function S(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}export{S as escapeHtmlAttr,p as formatDate,l as generateRandomHash,s as getDateFormatParams,o as padNumber,g as parseTemplate,f as stripJsonComments,m as toCamelCase,u as toPascalCase};

package/dist/common/fs/index.cjs

@@ -0,0 +1 @@
+"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),S=10;async function checkSourceExists(t){try{await s__default.promises.access(t,s__default.constants.F_OK)}catch(e){const r=e;throw r.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${t}`):r.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${r.message}`)}}async function ensureTargetDir(t){try{await s__default.promises.mkdir(t,{recursive:!0})}catch(e){const r=e;throw r.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${r.message}`)}}async function readDirRecursive(t,e){const r=await s__default.promises.readdir(t,{withFileTypes:!0}),i=[];for(const n of r){const c=u__default.join(t,n.name),l=n.isFile(),F=n.isDirectory();if(i.push({path:c,isFile:l,isDirectory:F}),F&&e){const E=await readDirRecursive(c,e);i.push(...E)}}return i}async function shouldUpdateFile(t,e){try{const[r,i]=await Promise.all([s__default.promises.stat(t),s__default.promises.stat(e)]);return r.mtimeMs>i.mtimeMs||r.size!==i.size}catch{return!0}}async function fileExists(t){try{return await s__default.promises.access(t,s__default.constants.F_OK),!0}catch{return!1}}async function runWithConcurrency(t,e,r){const i=[];let n=0;async function c(){for(;n<t.length;){const F=n++,E=await e(t[F]);i[F]=E}}const l=Array(Math.min(r,t.length)).fill(null).map(()=>c());return await Promise.all(l),i}async function copySourceToTarget(t,e,r){const i=Date.now(),{recursive:n,overwrite:c,incremental:l=!1,parallelLimit:F=S}=r;let E=0,f=0,m=0;if((await s__default.promises.stat(t)).isDirectory()){await ensureTargetDir(e);const a=await readDirRecursive(t,n),D=a.filter(o=>o.isFile);m=a.filter(o=>o.isDirectory).length;const y=new Set;for(const o of D){const d=u__default.relative(t,o.path),p=u__default.dirname(u__default.join(e,d));y.add(p)}await Promise.all([...y].map(o=>ensureTargetDir(o)));const h=await runWithConcurrency(D,async o=>{const d=u__default.relative(t,o.path),p=u__default.join(e,d);let w=c;return w||(w=!await fileExists(p)),l&&w&&(w=await shouldUpdateFile(o.path,p)),w?(await s__default.promises.copyFile(o.path,p),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},F);for(const o of h)o.copied&&E++,o.skipped&&f++}else{await ensureTargetDir(u__default.dirname(e));let a=c;a||(a=!await fileExists(e)),l&&a&&(a=await shouldUpdateFile(t,e)),a?(await s__default.promises.copyFile(t,e),E++):f++}const A=Date.now()-i;return{copiedFiles:E,skippedFiles:f,copiedDirs:m,executionTime:A}}async function writeFileContent(t,e){try{await s__default.promises.writeFile(t,e,"utf-8")}catch(r){const i=r;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 readFileContent(t){try{return await s__default.promises.readFile(t,"utf-8")}catch(e){const r=e;throw r.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${t}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${r.message}`)}}function readFileSync(t){try{return s__default.readFileSync(t,"utf-8")}catch(e){const r=e;throw r.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${t}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${r.message}`)}}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.shouldUpdateFile=shouldUpdateFile,exports.writeFileContent=writeFileContent;

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

@@ -0,0 +1,150 @@
+/**
+ * 复制操作的选项接口
+ */
+interface CopyOptions {
+    /**
+     * 是否支持递归复制
+     */
+    recursive: boolean;
+    /**
+     * 是否覆盖同名文件
+     */
+    overwrite: boolean;
+    /**
+     * 是否启用增量复制
+     */
+    incremental?: boolean;
+    /**
+     * 并行处理的最大文件数
+     */
+    parallelLimit?: number;
+    /**
+     * 是否跳过空目录
+     */
+    skipEmptyDirs?: boolean;
+}
+/**
+ * 复制结果接口
+ */
+interface CopyResult {
+    /**
+     * 复制的文件数量
+     */
+    copiedFiles: number;
+    /**
+     * 跳过的文件数量
+     */
+    skippedFiles: number;
+    /**
+     * 复制的目录数量
+     */
+    copiedDirs: number;
+    /**
+     * 总执行时间（毫秒）
+     */
+    executionTime: number;
+}
+
+/**
+ * 文件/目录条目信息
+ */
+interface FileEntry {
+    /** 完整路径 */
+    path: string;
+    /** 是否为文件 */
+    isFile: boolean;
+    /** 是否为目录 */
+    isDirectory: boolean;
+}
+/**
+ * 检查源文件是否存在
+ * @param sourcePath 源文件路径
+ * @throws 当源文件不存在或无法访问时抛出异常
+ */
+declare function checkSourceExists(sourcePath: string): Promise<void>;
+/**
+ * 创建目标目录
+ * @param targetPath 目标目录路径
+ * @throws 当无法创建目标目录时抛出异常
+ */
+declare function ensureTargetDir(targetPath: string): Promise<void>;
+/**
+ * 读取目录内容（优化版：一次性获取文件类型信息）
+ * @param dirPath 目录路径
+ * @param recursive 是否递归读取
+ * @returns 文件和目录条目列表
+ */
+declare function readDirRecursive(dirPath: string, recursive: boolean): Promise<FileEntry[]>;
+/**
+ * 检查文件是否需要更新
+ * @param sourceFile 源文件路径
+ * @param targetFile 目标文件路径
+ * @returns 是否需要更新
+ */
+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 复制选项
+ * @returns 复制结果
+ * @throws 当复制过程中出现错误时抛出异常
+ */
+declare function copySourceToTarget(sourcePath: string, targetPath: string, options: CopyOptions): Promise<CopyResult>;
+/**
+ * 写入文件内容
+ * @param filePath 文件路径
+ * @param content 文件内容
+ * @throws 当写入过程中出现错误时抛出异常
+ */
+declare function writeFileContent(filePath: string, content: string): Promise<void>;
+/**
+ * 读取文件内容
+ * @param filePath 文件路径
+ * @returns 文件内容字符串
+ * @throws 当读取过程中出现错误时抛出异常
+ */
+declare function readFileContent(filePath: string): Promise<string>;
+/**
+ * 同步读取文件内容
+ * @param filePath 文件路径
+ * @returns 文件内容字符串
+ * @throws 当读取过程中出现错误时抛出异常
+ * @deprecated 请使用异步版本 readFileContent
+ */
+declare function readFileSync(filePath: string): string;
+
+export { checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, writeFileContent };
+export type { CopyOptions, CopyResult };