@meng-xi/vite-plugin 0.0.1 → 0.0.2

package/dist/index.d.mts

@@ -1,11 +1,43 @@
 import { Plugin } from 'vite';
 
+/**
+ * 基础插件配置
+ *
+ * @interface BasePluginOptions
+ */
+interface BasePluginOptions {
+    /**
+     * 是否启用插件
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 是否启用日志
+     *
+     * @default true
+     */
+    verbose?: boolean;
+    /**
+     * 错误处理策略
+     *
+     * @default 'throw'
+     */
+    errorStrategy?: 'throw' | 'log' | 'ignore';
+}
+/**
+ * 插件工厂函数类型
+ *
+ * @template T 插件配置类型，默认继承自 BasePluginOptions
+ */
+type PluginFactory<T extends BasePluginOptions = BasePluginOptions> = (options?: T) => Plugin;
+
 /**
  * 复制文件插件的配置选项接口
  *
  * @interface CopyFileOptions
  */
-interface CopyFileOptions {
+interface CopyFileOptions extends BasePluginOptions {
     /**
      * 源文件目录的路径
      *
@@ -21,38 +53,28 @@ interface CopyFileOptions {
     /**
      * 是否覆盖同名文件
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     overwrite?: boolean;
     /**
      * 是否支持递归复制
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     recursive?: boolean;
     /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用复制功能
+     * 是否启用增量复制
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
-    enabled?: boolean;
+    incremental?: boolean;
 }
 
 /**
  * 复制文件插件
  *
- * @param options - 配置参数
- * @returns 一个 Vite 插件实例
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
  *
  * @example
  * ```typescript
@@ -62,34 +84,24 @@ interface CopyFileOptions {
  *   targetDir: 'dist/assets'
  * })
  *
- * // 自定义配置
+ * // 高级配置
  * copyFile({
  *   sourceDir: 'src/static',
  *   targetDir: 'dist/static',
  *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
  *   verbose: true,
- *   recursive: false
- * })
- *
- * // 根据环境启用
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets',
- *   enabled: process.env.NODE_ENV === 'production'
- * })
- *
- * // 禁用复制功能
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets',
- *   enabled: false
+ *   errorStrategy: 'throw'
  * })
  * ```
  *
  * @remarks
- * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
  */
-declare function copyFile(options: CopyFileOptions): Plugin;
+declare const copyFile: PluginFactory<CopyFileOptions>;
 
 /**
  * 图标配置项接口
@@ -135,15 +147,13 @@ interface CopyOptions {
     /**
      * 是否覆盖同名文件
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     overwrite?: boolean;
     /**
      * 是否支持递归复制
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     recursive?: boolean;
 }
@@ -152,11 +162,11 @@ interface CopyOptions {
  *
  * @interface InjectIcoOptions
  */
-interface InjectIcoOptions {
+interface InjectIcoOptions extends BasePluginOptions {
     /**
-     * 图标文件的基础路径，默认为根路径 `/`
+     * 图标文件的基础路径，默认为根路径 '/'
      *
-     * @defaultValue `/`
+     * @default '/'
      * @example '/assets'
      */
     base?: string;
@@ -183,20 +193,6 @@ interface InjectIcoOptions {
      * ]
      */
     icons?: Icon[];
-    /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用图标注入和文件复制功能
-     *
-     * @defaultValue true
-     * @example false
-     */
-    enabled?: boolean;
     /**
      * 图标文件复制配置选项
      *
@@ -207,76 +203,39 @@ interface InjectIcoOptions {
 }
 
 /**
- * 注入网站图标链接到 HTML 文件的头部
- *
- * @param options - 配置选项（字符串时视为 base）
- * @returns 一个 Vite 插件实例，用于在构建过程中修改 HTML 文件
+ * 创建注入图标插件实例
  *
+ * @export
+ * @param {string | InjectIcoOptions} [options] - 插件配置选项，可以是字符串形式的 base 路径或完整的配置对象
+ * @returns {Plugin} Vite 插件实例，用于在构建过程中注入图标链接到 HTML 文件
  * @example
  * ```typescript
  * // 基本使用
- * injectIco({ base: '/assets' })
- *
- * // 自定义图标
- * injectIco({
- *   icons: [
- *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
- *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' },
- *     { rel: 'icon', href: '/favicon-16x16.png', sizes: '16x16', type: 'image/png' }
- *   ]
- * })
- *
- * // 带文件复制功能（适用于 uni-app 等框架）
- * injectIco({
- *   base: '/assets',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- *
- * // 带完整复制配置的使用
- * injectIco({
- *   base: '/assets',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons',
- *     overwrite: false,
- *     recursive: true
- *   }
- * })
- *
- * // 关闭日志输出
- * injectIco({
- *   base: '/assets',
- *   verbose: false,
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
+ * injectIco() // 使用默认配置
  *
- * // 根据环境启用
- * injectIco({
- *   base: '/assets',
- *   enabled: process.env.NODE_ENV === 'production',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
+ * // 使用字符串配置 base 路径
+ * injectIco('/assets')
  *
- * // 禁用插件
+ * // 使用完整配置
  * injectIco({
  *   base: '/assets',
- *   enabled: false,
+ *   icons: [
+ *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
+ *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' }
+ *   ],
  *   copyOptions: {
  *     sourceDir: 'src/assets/icons',
  *     targetDir: 'dist/assets/icons'
  *   }
  * })
  * ```
+ * @remarks
+ * 该函数创建并返回一个 Vite 插件实例，该实例会在构建过程中：
+ * 1. 将图标链接注入到 HTML 文件的 `<head>` 标签中
+ * 2. 如果配置了 copyOptions，将图标文件复制到目标目录
+ *
+ * 支持自定义图标链接、图标数组配置以及图标文件复制功能。
  */
-declare function injectIco(options?: InjectIcoOptions | string): Plugin;
+declare function injectIco(options?: string | InjectIcoOptions): Plugin;
 
 export { copyFile, injectIco };

package/dist/index.d.ts

@@ -1,11 +1,43 @@
 import { Plugin } from 'vite';
 
+/**
+ * 基础插件配置
+ *
+ * @interface BasePluginOptions
+ */
+interface BasePluginOptions {
+    /**
+     * 是否启用插件
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 是否启用日志
+     *
+     * @default true
+     */
+    verbose?: boolean;
+    /**
+     * 错误处理策略
+     *
+     * @default 'throw'
+     */
+    errorStrategy?: 'throw' | 'log' | 'ignore';
+}
+/**
+ * 插件工厂函数类型
+ *
+ * @template T 插件配置类型，默认继承自 BasePluginOptions
+ */
+type PluginFactory<T extends BasePluginOptions = BasePluginOptions> = (options?: T) => Plugin;
+
 /**
  * 复制文件插件的配置选项接口
  *
  * @interface CopyFileOptions
  */
-interface CopyFileOptions {
+interface CopyFileOptions extends BasePluginOptions {
     /**
      * 源文件目录的路径
      *
@@ -21,38 +53,28 @@ interface CopyFileOptions {
     /**
      * 是否覆盖同名文件
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     overwrite?: boolean;
     /**
      * 是否支持递归复制
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     recursive?: boolean;
     /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用复制功能
+     * 是否启用增量复制
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
-    enabled?: boolean;
+    incremental?: boolean;
 }
 
 /**
  * 复制文件插件
  *
- * @param options - 配置参数
- * @returns 一个 Vite 插件实例
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
  *
  * @example
  * ```typescript
@@ -62,34 +84,24 @@ interface CopyFileOptions {
  *   targetDir: 'dist/assets'
  * })
  *
- * // 自定义配置
+ * // 高级配置
  * copyFile({
  *   sourceDir: 'src/static',
  *   targetDir: 'dist/static',
  *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
  *   verbose: true,
- *   recursive: false
- * })
- *
- * // 根据环境启用
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets',
- *   enabled: process.env.NODE_ENV === 'production'
- * })
- *
- * // 禁用复制功能
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets',
- *   enabled: false
+ *   errorStrategy: 'throw'
  * })
  * ```
  *
  * @remarks
- * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
  */
-declare function copyFile(options: CopyFileOptions): Plugin;
+declare const copyFile: PluginFactory<CopyFileOptions>;
 
 /**
  * 图标配置项接口
@@ -135,15 +147,13 @@ interface CopyOptions {
     /**
      * 是否覆盖同名文件
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     overwrite?: boolean;
     /**
      * 是否支持递归复制
      *
-     * @defaultValue true
-     * @example false
+     * @default true
      */
     recursive?: boolean;
 }
@@ -152,11 +162,11 @@ interface CopyOptions {
  *
  * @interface InjectIcoOptions
  */
-interface InjectIcoOptions {
+interface InjectIcoOptions extends BasePluginOptions {
     /**
-     * 图标文件的基础路径，默认为根路径 `/`
+     * 图标文件的基础路径，默认为根路径 '/'
      *
-     * @defaultValue `/`
+     * @default '/'
      * @example '/assets'
      */
     base?: string;
@@ -183,20 +193,6 @@ interface InjectIcoOptions {
      * ]
      */
     icons?: Icon[];
-    /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用图标注入和文件复制功能
-     *
-     * @defaultValue true
-     * @example false
-     */
-    enabled?: boolean;
     /**
      * 图标文件复制配置选项
      *
@@ -207,76 +203,39 @@ interface InjectIcoOptions {
 }
 
 /**
- * 注入网站图标链接到 HTML 文件的头部
- *
- * @param options - 配置选项（字符串时视为 base）
- * @returns 一个 Vite 插件实例，用于在构建过程中修改 HTML 文件
+ * 创建注入图标插件实例
  *
+ * @export
+ * @param {string | InjectIcoOptions} [options] - 插件配置选项，可以是字符串形式的 base 路径或完整的配置对象
+ * @returns {Plugin} Vite 插件实例，用于在构建过程中注入图标链接到 HTML 文件
  * @example
  * ```typescript
  * // 基本使用
- * injectIco({ base: '/assets' })
- *
- * // 自定义图标
- * injectIco({
- *   icons: [
- *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
- *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' },
- *     { rel: 'icon', href: '/favicon-16x16.png', sizes: '16x16', type: 'image/png' }
- *   ]
- * })
- *
- * // 带文件复制功能（适用于 uni-app 等框架）
- * injectIco({
- *   base: '/assets',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- *
- * // 带完整复制配置的使用
- * injectIco({
- *   base: '/assets',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons',
- *     overwrite: false,
- *     recursive: true
- *   }
- * })
- *
- * // 关闭日志输出
- * injectIco({
- *   base: '/assets',
- *   verbose: false,
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
+ * injectIco() // 使用默认配置
  *
- * // 根据环境启用
- * injectIco({
- *   base: '/assets',
- *   enabled: process.env.NODE_ENV === 'production',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
+ * // 使用字符串配置 base 路径
+ * injectIco('/assets')
  *
- * // 禁用插件
+ * // 使用完整配置
  * injectIco({
  *   base: '/assets',
- *   enabled: false,
+ *   icons: [
+ *     { rel: 'icon', href: '/favicon.svg', type: 'image/svg+xml' },
+ *     { rel: 'icon', href: '/favicon-32x32.png', sizes: '32x32', type: 'image/png' }
+ *   ],
  *   copyOptions: {
  *     sourceDir: 'src/assets/icons',
  *     targetDir: 'dist/assets/icons'
  *   }
  * })
  * ```
+ * @remarks
+ * 该函数创建并返回一个 Vite 插件实例，该实例会在构建过程中：
+ * 1. 将图标链接注入到 HTML 文件的 `<head>` 标签中
+ * 2. 如果配置了 copyOptions，将图标文件复制到目标目录
+ *
+ * 支持自定义图标链接、图标数组配置以及图标文件复制功能。
  */
-declare function injectIco(options?: InjectIcoOptions | string): Plugin;
+declare function injectIco(options?: string | InjectIcoOptions): Plugin;
 
 export { copyFile, injectIco };

package/dist/index.mjs

@@ -1,3 +1,5 @@
-import s from"fs";async function a(e){try{await s.promises.access(e,s.constants.F_OK)}catch(r){const u=r;throw u.code==="ENOENT"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${e}`):u.code==="EACCES"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${e}`):new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${e}\uFF0C\u9519\u8BEF\uFF1A${u.message}`)}}async function D(e){try{await s.promises.mkdir(e,{recursive:!0})}catch(r){const u=r;throw u.code==="EACCES"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${e}`):new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${e}\uFF0C\u9519\u8BEF\uFF1A${u.message}`)}}async function C(e,r,u){try{await s.promises.cp(e,r,{recursive:u.recursive,force:u.overwrite})}catch(o){const F=o;throw F.code==="ENOENT"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u590D\u5236\u8FC7\u7A0B\u4E2D\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${e}`):F.code==="EACCES"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u590D\u5236\u8FC7\u7A0B\u4E2D\u6743\u9650\u4E0D\u8DB3\uFF0C\u65E0\u6CD5\u8BBF\u95EE\u6E90\u6587\u4EF6\u6216\u5199\u5165\u76EE\u6807\u76EE\u5F55 - ${e} -> ${r}`):F.code==="EPERM"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u590D\u5236\u8FC7\u7A0B\u4E2D\u64CD\u4F5C\u88AB\u62D2\u7EDD - ${e} -> ${r}`):new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u590D\u5236\u6587\u4EF6\u65F6\u51FA\u9519 - ${e} -> ${r}\uFF0C\u9519\u8BEF\uFF1A${F.message}`)}}function l(e){const r=[];if(e.link)return r.push(e.link),r;if(e.icons&&e.icons.length>0)r.push(...e.icons.map(u=>{let o=`<link rel="${u.rel}" href="${u.href}"`;return u.sizes&&(o+=` sizes="${u.sizes}"`),u.type&&(o+=` type="${u.type}"`),o+=" />",o}));else if(e.url)r.push(`<link rel="icon" href="${e.url}" />`);else{const u=e.base||"/",o=u.endsWith("/")?`${u}favicon.ico`:`${u}/favicon.ico`;r.push(`<link rel="icon" href="${o}" />`)}return r}function A(e){const{sourceDir:r,targetDir:u,overwrite:o=!0,recursive:F=!0,verbose:n=!0,enabled:E=!0}=e;return{name:"copy-file",enforce:"post",async writeBundle(){if(!E){n&&console.log(`\u2139 \u590D\u5236\u6587\u4EF6\u529F\u80FD\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${r} \u5230 ${u}`);return}try{await a(r),await D(u),await C(r,u,{recursive:F,overwrite:o}),n&&console.log(`\u2705 \u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${r} \u5230 ${u}`)}catch(t){throw n&&(t instanceof Error?console.error(t.message):console.error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${r} -> ${u}`,t)),t}}}}function $(e){const r=typeof e=="string"?{base:e}:e||{},{verbose:u=!0,enabled:o=!0}=r;return{name:"inject-ico",transformIndexHtml(F){if(!o)return u&&console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),F;const n=l(r);if(n.length===0)return u&&console.log("\u2139 inject-ico: \u6CA1\u6709\u751F\u6210\u56FE\u6807\u6807\u7B7E\uFF0C\u8DF3\u8FC7\u6CE8\u5165"),F;let E=F;const t=E.indexOf("</head>");if(t!==-1){const i=n.join(`
+import a from"fs";import p from"path";class C{libName="@meng-xi/vite-plugin";name;enabled;logTypes={info:{method:console.log,icon:"",color:"",reset:""},success:{method:console.log,icon:"\u2705",color:"\x1B[32m",reset:"\x1B[0m"},warn:{method:console.warn,icon:"\u26A0\uFE0F",color:"\x1B[33m",reset:"\x1B[0m"},error:{method:console.error,icon:"\u274C",color:"\x1B[31m",reset:"\x1B[0m"}};constructor(u){this.name=u.name,this.enabled=u.enabled??!1}formatPrefix(){let u=`[${this.libName}:${this.name}]`;return u=`[${new Date().toLocaleString()}] ${u}`,u}log(u,e,t){if(!this.enabled)return;const i=this.formatPrefix(),s=this.logTypes[u],{method:o,icon:l,color:F,reset:h}=s,E=l?`${l} ${i}`:i;o("=================================="),t!=null?o(F+E+h,F+e+h,t):o(F+E+h,F+e+h),o("==================================")}success(u,e){this.log("success",u,e)}info(u,e){this.log("info",u,e)}warn(u,e){this.log("warn",u,e)}error(u,e){this.log("error",u,e)}}async function m(r){try{await a.promises.access(r,a.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 - ${r}`):e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${r}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${r}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function B(r){try{await a.promises.mkdir(r,{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 - ${r}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${r}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function w(r,u){const e=await a.promises.readdir(r,{withFileTypes:!0});let t=[];for(const i of e){const s=p.join(r,i.name);if(i.isDirectory()){if(t.push(s),u){const o=await w(s,u);t=[...t,...o]}}else t.push(s)}return t}async function D(r,u){try{const e=await a.promises.stat(r),t=await a.promises.stat(u);return e.mtimeMs>t.mtimeMs||e.size!==t.size}catch{return!0}}async function y(r,u,e){const t=Date.now(),{recursive:i,overwrite:s,incremental:o=!1}=e;let l=0,F=0,h=0;if((await a.promises.stat(r)).isDirectory()){await B(u);const c=await w(r,i),b=(await Promise.all(c.map(async n=>{const f=await a.promises.stat(n);return{path:n,isFile:f.isFile()}}))).filter(n=>n.isFile).map(n=>n.path);for(const n of b){const f=p.relative(r,n),g=p.join(u,f);await B(p.dirname(g));let d=s;if(!d)try{await a.promises.access(g,a.constants.F_OK),d=!1}catch{d=!0}o&&d&&(d=await D(n,g)),d?(await a.promises.copyFile(n,g),l++):F++}h=(await Promise.all(c.map(async n=>{const f=await a.promises.stat(n);return{path:n,isDirectory:f.isDirectory()}}))).filter(n=>n.isDirectory).length}else{await B(p.dirname(u));let c=s;if(!c)try{await a.promises.access(u,a.constants.F_OK),c=!1}catch{c=!0}o&&c&&(c=await D(r,u)),c?(await a.promises.copyFile(r,u),l++):F++}const E=Date.now()-t;return{copiedFiles:l,skippedFiles:F,copiedDirs:h,executionTime:E}}function A(...r){const u={};for(const e of r)if(e)for(const t in e){const i=e[t],s=u[t];typeof i=="object"&&i!==null&&!Array.isArray(i)&&typeof s=="object"&&s!==null&&!Array.isArray(s)?u[t]=A(s,i):u[t]=i}return u}class ${options;currentField=null;errors=[];constructor(u){this.options=u}field(u){return this.currentField=u,this}required(){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");return this.options[this.currentField]==null&&this.errors.push(`${this.currentField} \u662F\u5FC5\u586B\u5B57\u6BB5`),this}string(){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");const u=this.options[this.currentField];return u!=null&&typeof u!="string"&&this.errors.push(`${this.currentField} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32\u7C7B\u578B`),this}boolean(){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");const u=this.options[this.currentField];return u!=null&&typeof u!="boolean"&&this.errors.push(`${this.currentField} \u5FC5\u987B\u662F\u5E03\u5C14\u7C7B\u578B`),this}number(){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");const u=this.options[this.currentField];return u!=null&&typeof u!="number"&&this.errors.push(`${this.currentField} \u5FC5\u987B\u662F\u6570\u5B57\u7C7B\u578B`),this}array(){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");const u=this.options[this.currentField];return u!=null&&!Array.isArray(u)&&this.errors.push(`${this.currentField} \u5FC5\u987B\u662F\u6570\u7EC4\u7C7B\u578B`),this}object(){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");const u=this.options[this.currentField];return u!=null&&typeof u!="object"&&!Array.isArray(u)&&this.errors.push(`${this.currentField} \u5FC5\u987B\u662F\u5BF9\u8C61\u7C7B\u578B`),this}default(u){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");return this.options[this.currentField]==null&&(this.options[this.currentField]=u),this}custom(u,e){if(!this.currentField)throw new Error("\u5FC5\u987B\u5148\u8C03\u7528 field() \u65B9\u6CD5\u6307\u5B9A\u8981\u9A8C\u8BC1\u7684\u5B57\u6BB5");const t=this.options[this.currentField];return t!=null&&!u(t)&&this.errors.push(e),this}validate(){if(this.errors.length>0)throw new Error(`\u914D\u7F6E\u9A8C\u8BC1\u5931\u8D25\uFF1A
+${this.errors.map(u=>`- ${u}`).join(`
+`)}`);return this.options}}class v{options;logger;validator;viteConfig=null;constructor(u,e){this.options=this.mergeOptions(u),this.logger=this.initLogger(e),this.validator=new $(this.options),this.validateOptions()}mergeOptions(u){return A({enabled:!0,verbose:!0,errorStrategy:"throw"},u)}initLogger(u){return u instanceof C?u:new C({name:this.getPluginName(),enabled:this.options.verbose,...u})}validateOptions(){}getEnforce(){}onConfigResolved(u){this.viteConfig=u,this.logger.info("\u914D\u7F6E\u89E3\u6790\u5B8C\u6210\uFF0C\u63D2\u4EF6\u5DF2\u521D\u59CB\u5316")}async safeExecute(u,e){try{return await u()}catch(t){return this.handleError(t,e)}}handleError(u,e){let t=`${e}: `;switch(u instanceof Error?t+=u.message:typeof u=="string"?t+=u:t+=String(u),this.options.errorStrategy){case"throw":throw this.logger.error(t),u;case"log":case"ignore":this.logger.error(t);return;default:throw this.logger.error(t),u}}toPlugin(){const u={name:this.getPluginName(),enforce:this.getEnforce(),configResolved:e=>{this.options.enabled&&this.onConfigResolved(e)}};return this.addPluginHooks(u),u}}function x(r){return u=>{const e=u,t=new r(e),i=t.toPlugin();return i.pluginInstance=t,i}}let P=class extends v{validateOptions(){this.validator.field("sourceDir").required().string().custom(u=>u.trim()!=="","sourceDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("targetDir").required().string().custom(u=>u.trim()!=="","targetDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("overwrite").boolean().default(!0).field("recursive").boolean().default(!0).field("incremental").boolean().default(!0).validate()}getPluginName(){return"copy-file"}getEnforce(){return"post"}async copyFiles(){const{sourceDir:u,targetDir:e,overwrite:t=!0,recursive:i=!0,incremental:s=!0,enabled:o=!0}=this.options;if(!o){this.logger.info(`\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${u} \u590D\u5236\u5230 ${e}`);return}await m(u);const l=await y(u,e,{recursive:i,overwrite:t,incremental:s});this.logger.success(`\u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${u} \u5230 ${e}`,`\u590D\u5236\u4E86 ${l.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${l.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${l.executionTime}ms`)}addPluginHooks(u){u.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u590D\u5236\u6587\u4EF6")}}};const O=x(P);function k(r){const u=[];if(r.link)return u.push(r.link),u;if(r.icons&&r.icons.length>0)u.push(...r.icons.map(e=>{let t=`<link rel="${e.rel}" href="${e.href}"`;return e.sizes&&(t+=` sizes="${e.sizes}"`),e.type&&(t+=` type="${e.type}"`),t+=" />",t}));else if(r.url)u.push(`<link rel="icon" href="${r.url}" />`);else{const e=r.base||"/",t=e.endsWith("/")?`${e}favicon.ico`:`${e}/favicon.ico`;u.push(`<link rel="icon" href="${t}" />`)}return u}class T extends v{constructor(u){const e=typeof u=="string"?{base:u}:u||{};super(e)}validateOptions(){this.validator.field("base").string().default("/").field("url").string().field("link").string().field("icons").array(),this.options?.copyOptions&&(this.validator.field("copyOptions").object(),new $(this.options.copyOptions).field("sourceDir").required().string().field("targetDir").required().string().field("overwrite").boolean().default(!0).field("recursive").boolean().default(!0).validate()),this.validator.validate()}getPluginName(){return"inject-ico"}injectIcoTags(u){if(!this.options.enabled)return this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),u;const e=k(this.options);if(e.length===0)return this.logger.info("\u6CA1\u6709\u751F\u6210\u56FE\u6807\u6807\u7B7E\uFF0C\u8DF3\u8FC7\u6CE8\u5165"),u;let t=u;const i=t.indexOf("</head>");if(i!==-1){const s=e.join(`
 `)+`
-`;E=E.substring(0,t)+i+E.substring(t),u&&(console.log(`\u2705 inject-ico: \u6210\u529F\u6CE8\u5165 ${n.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`),n.forEach(c=>{console.log(`  - ${c}`)}))}else u&&console.warn("\u26A0 inject-ico: \u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");return E},async writeBundle(){if(!o){u&&console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");return}const{copyOptions:F}=r;if(!F)return;const{sourceDir:n,targetDir:E,overwrite:t=!0,recursive:i=!0}=F;try{await a(n),await D(E),await C(n,E,{recursive:i,overwrite:t}),u&&console.log(`\u2705 inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${n} \u5230 ${E}`)}catch(c){throw u&&(c instanceof Error?console.error(c.message):console.error(`\u274C inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${n} -> ${E}`,c)),c}}}}export{A as copyFile,$ as injectIco};
+`;t=t.substring(0,i)+s+t.substring(i),this.logger.success(`\u6210\u529F\u6CE8\u5165 ${e.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`),e.forEach(o=>{this.logger.info(`  - ${o}`)})}else this.logger.warn("\u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");return t}async copyFiles(){if(!this.options.enabled){this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");return}const{copyOptions:u}=this.options;if(!u)return;const{sourceDir:e,targetDir:t,overwrite:i=!0,recursive:s=!0}=u;await m(e);const o=await y(e,t,{recursive:s,overwrite:i,incremental:!0});this.logger.success(`\u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${t}`,`\u590D\u5236\u4E86 ${o.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${o.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${o.executionTime}ms`)}addPluginHooks(u){u.transformIndexHtml=e=>this.injectIcoTags(e),u.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u56FE\u6807\u6587\u4EF6\u590D\u5236")}}}function j(r){return new T(r).toPlugin()}export{O as copyFile,j as injectIco};

package/package.json

@@ -1,10 +1,9 @@
 {
 	"name": "@meng-xi/vite-plugin",
 	"type": "module",
-	"version": "0.0.1",
+	"version": "0.0.2",
 	"private": false,
 	"description": "一个为 Vite 提供的插件库",
-	"readme": "README.md",
 	"keywords": [
 		"meng-xi",
 		"vite",
@@ -18,15 +17,12 @@
 			"require": "./dist/index.cjs",
 			"import": "./dist/index.mjs",
 			"types": "./dist/index.d.ts"
-		},
-		"./plugins/*": {
-			"require": "./dist/plugins/*.cjs",
-			"import": "./dist/plugins/*.mjs",
-			"types": "./dist/plugins/*.d.ts"
 		}
 	},
 	"files": [
-		"dist"
+		"dist",
+		"README.md",
+		"README-en.md"
 	],
 	"scripts": {
 		"dev": "unbuild --watch",