@meng-xi/vite-plugin 0.0.1 → 0.0.3

package/dist/shared/vite-plugin.DSRKYuae.mjs

@@ -0,0 +1,3 @@
+function s(...n){const u={};for(const r of n)if(r)for(const t in r){const i=r[t],e=u[t];typeof i=="object"&&i!==null&&!Array.isArray(i)&&typeof e=="object"&&e!==null&&!Array.isArray(e)?u[t]=s(e,i):u[t]=i}return u}class o{options;currentField=null;errors=[];constructor(u){this.options=u}field(u){const r=this;return r.currentField=u,r}required(){if(this.currentField===null)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(`${String(this.currentField)} \u662F\u5FC5\u586B\u5B57\u6BB5`),this}string(){if(this.currentField===null)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(`${String(this.currentField)} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32\u7C7B\u578B`),this}boolean(){if(this.currentField===null)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(`${String(this.currentField)} \u5FC5\u987B\u662F\u5E03\u5C14\u7C7B\u578B`),this}number(){if(this.currentField===null)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(`${String(this.currentField)} \u5FC5\u987B\u662F\u6570\u5B57\u7C7B\u578B`),this}array(){if(this.currentField===null)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(`${String(this.currentField)} \u5FC5\u987B\u662F\u6570\u7EC4\u7C7B\u578B`),this}object(){if(this.currentField===null)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(`${String(this.currentField)} \u5FC5\u987B\u662F\u5BF9\u8C61\u7C7B\u578B`),this}default(u){if(this.currentField===null)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,r){if(this.currentField===null)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(r),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}}export{o as V,s as d};

package/dist/shared/vite-plugin.DrSzERYS.cjs

@@ -0,0 +1 @@
+"use strict";const s=require("fs"),l=require("path");function _interopDefaultCompat(u){return u&&typeof u=="object"&&"default"in u?u.default:u}const s__default=_interopDefaultCompat(s),l__default=_interopDefaultCompat(l);async function checkSourceExists(u){try{await s__default.promises.access(u,s__default.constants.F_OK)}catch(t){const e=t;throw e.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${u}`):e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${u}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function ensureTargetDir(u){try{await s__default.promises.mkdir(u,{recursive:!0})}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${u}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function readDirRecursive(u,t){const e=await s__default.promises.readdir(u,{withFileTypes:!0});let i=[];for(const F of e){const o=l__default.join(u,F.name);if(F.isDirectory()){if(i.push(o),t){const E=await readDirRecursive(o,t);i=[...i,...E]}}else i.push(o)}return i}async function shouldUpdateFile(u,t){try{const e=await s__default.promises.stat(u),i=await s__default.promises.stat(t);return e.mtimeMs>i.mtimeMs||e.size!==i.size}catch{return!0}}async function copySourceToTarget(u,t,e){const i=Date.now(),{recursive:F,overwrite:o,incremental:E=!1}=e;let w=0,m=0,D=0;if((await s__default.promises.stat(u)).isDirectory()){await ensureTargetDir(t);const a=await readDirRecursive(u,F),y=(await Promise.all(a.map(async r=>{const n=await s__default.promises.stat(r);return{path:r,isFile:n.isFile()}}))).filter(r=>r.isFile).map(r=>r.path);for(const r of y){const n=l__default.relative(u,r),p=l__default.join(t,n);await ensureTargetDir(l__default.dirname(p));let c=o;if(!c)try{await s__default.promises.access(p,s__default.constants.F_OK),c=!1}catch{c=!0}E&&c&&(c=await shouldUpdateFile(r,p)),c?(await s__default.promises.copyFile(r,p),w++):m++}D=(await Promise.all(a.map(async r=>{const n=await s__default.promises.stat(r);return{path:r,isDirectory:n.isDirectory()}}))).filter(r=>r.isDirectory).length}else{await ensureTargetDir(l__default.dirname(t));let a=o;if(!a)try{await s__default.promises.access(t,s__default.constants.F_OK),a=!1}catch{a=!0}E&&a&&(a=await shouldUpdateFile(u,t)),a?(await s__default.promises.copyFile(u,t),w++):m++}const f=Date.now()-i;return{copiedFiles:w,skippedFiles:m,copiedDirs:D,executionTime:f}}async function writeFileContent(u,t){try{await s__default.promises.writeFile(u,t,"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 - ${u}`):new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u5199\u5165\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${i.message}`)}}function readFileSync(u){try{return s__default.readFileSync(u,"utf-8")}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${u}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}exports.checkSourceExists=checkSourceExists,exports.copySourceToTarget=copySourceToTarget,exports.ensureTargetDir=ensureTargetDir,exports.readDirRecursive=readDirRecursive,exports.readFileSync=readFileSync,exports.shouldUpdateFile=shouldUpdateFile,exports.writeFileContent=writeFileContent;

package/dist/shared/vite-plugin.UkE7CdSe.d.cts

@@ -0,0 +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 目标选项类型
+ * @template R 原始选项类型
+ */
+type OptionsNormalizer<T, R = any> = (raw?: R) => T;
+/**
+ * 插件工厂函数类型
+ *
+ * @template T 插件配置类型，默认继承自 BasePluginOptions
+ * @template R 原始配置类型，默认与 T 相同
+ */
+type PluginFactory<T extends BasePluginOptions = BasePluginOptions, R = T> = (options?: R) => Plugin;
+
+export type { BasePluginOptions as B, OptionsNormalizer as O, PluginFactory as P };

package/dist/shared/vite-plugin.UkE7CdSe.d.mts

@@ -0,0 +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 目标选项类型
+ * @template R 原始选项类型
+ */
+type OptionsNormalizer<T, R = any> = (raw?: R) => T;
+/**
+ * 插件工厂函数类型
+ *
+ * @template T 插件配置类型，默认继承自 BasePluginOptions
+ * @template R 原始配置类型，默认与 T 相同
+ */
+type PluginFactory<T extends BasePluginOptions = BasePluginOptions, R = T> = (options?: R) => Plugin;
+
+export type { BasePluginOptions as B, OptionsNormalizer as O, PluginFactory as P };

package/dist/shared/vite-plugin.UkE7CdSe.d.ts

@@ -0,0 +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 目标选项类型
+ * @template R 原始选项类型
+ */
+type OptionsNormalizer<T, R = any> = (raw?: R) => T;
+/**
+ * 插件工厂函数类型
+ *
+ * @template T 插件配置类型，默认继承自 BasePluginOptions
+ * @template R 原始配置类型，默认与 T 相同
+ */
+type PluginFactory<T extends BasePluginOptions = BasePluginOptions, R = T> = (options?: R) => Plugin;
+
+export type { BasePluginOptions as B, OptionsNormalizer as O, PluginFactory as P };

package/package.json

@@ -1,57 +1,72 @@
-{
-	"name": "@meng-xi/vite-plugin",
-	"type": "module",
-	"version": "0.0.1",
-	"private": false,
-	"description": "一个为 Vite 提供的插件库",
-	"readme": "README.md",
-	"keywords": [
-		"meng-xi",
-		"vite",
-		"plugin"
-	],
-	"main": "./dist/index.cjs",
-	"module": "./dist/index.mjs",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"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"
-	],
-	"scripts": {
-		"dev": "unbuild --watch",
-		"build": "unbuild"
-	},
-	"peerDependencies": {
-		"vite": "^5.0.0"
-	},
-	"dependencies": {
-		"vite": "^5.0.0"
-	},
-	"devDependencies": {
-		"@types/node": "^20.0.0",
-		"unbuild": "^3.0.0",
-		"typescript": "^5.2.0"
-	},
-	"author": {
-		"name": "PedroQue99",
-		"email": "ksmengfang@163.com"
-	},
-	"license": "MIT",
-	"homepage": "https://github.com/MengXi-Studio/vite-plugin#readme",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/MengXi-Studio/vite-plugin.git"
-	},
-	"bugs": "https://github.com/MengXi-Studio/vite-plugin/issues"
-}
+{
+	"name": "@meng-xi/vite-plugin",
+	"type": "module",
+	"version": "0.0.3",
+	"private": false,
+	"description": "一个为 Vite 提供的插件库",
+	"keywords": [
+		"@meng-xi/vite-plugin",
+		"meng-xi",
+		"vite",
+		"plugin",
+		"vite-plugin"
+	],
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"require": "./dist/index.cjs",
+			"import": "./dist/index.mjs",
+			"types": "./dist/index.d.ts"
+		},
+		"./common": {
+			"require": "./dist/common/index.cjs",
+			"import": "./dist/common/index.mjs",
+			"types": "./dist/common/index.d.ts"
+		},
+		"./factory": {
+			"require": "./dist/factory/index.cjs",
+			"import": "./dist/factory/index.mjs",
+			"types": "./dist/factory/index.d.ts"
+		},
+		"./logger": {
+			"require": "./dist/logger/index.cjs",
+			"import": "./dist/logger/index.mjs",
+			"types": "./dist/logger/index.d.ts"
+		},
+		"./plugins": {
+			"require": "./dist/plugins/index.cjs",
+			"import": "./dist/plugins/index.mjs",
+			"types": "./dist/plugins/index.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"README-en.md"
+	],
+	"scripts": {
+		"dev": "unbuild --watch",
+		"build": "unbuild"
+	},
+	"peerDependencies": {
+		"vite": "^5.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"unbuild": "^3.0.0",
+		"typescript": "^5.2.0"
+	},
+	"author": {
+		"name": "PedroQue99",
+		"email": "ksmengfang@163.com"
+	},
+	"license": "MIT",
+	"homepage": "https://github.com/MengXi-Studio/vite-plugin#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/MengXi-Studio/vite-plugin.git"
+	},
+	"bugs": "https://github.com/MengXi-Studio/vite-plugin/issues"
+}

package/dist/plugins/copyFile/index.d.ts

@@ -1,44 +0,0 @@
-import { type Plugin } from 'vite';
-import type { CopyFileOptions } from './type';
-/**
- * 复制文件插件
- *
- * @param options - 配置参数
- * @returns 一个 Vite 插件实例
- *
- * @example
- * ```typescript
- * // 基本使用
- * copyFile({
- *   sourceDir: 'src/assets',
- *   targetDir: 'dist/assets'
- * })
- *
- * // 自定义配置
- * copyFile({
- *   sourceDir: 'src/static',
- *   targetDir: 'dist/static',
- *   overwrite: false,
- *   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
- * })
- * ```
- *
- * @remarks
- * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录
- */
-export declare function copyFile(options: CopyFileOptions): Plugin;

package/dist/plugins/copyFile/index.mjs

@@ -1,43 +0,0 @@
-import { checkSourceExists, ensureTargetDir, copySourceToTarget } from "@/utils";
-export function copyFile(options) {
-  const { sourceDir, targetDir, overwrite = true, recursive = true, verbose = true, enabled = true } = options;
-  return {
-    // 插件名称
-    name: "copy-file",
-    // 插件在构建流程的最后阶段执行，确保其他构建任务完成后再进行文件复制
-    enforce: "post",
-    /**
-     * Vite 构建完成后触发的钩子函数，执行文件复制操作
-     *
-     * @remarks
-     * 该钩子在 Vite 构建流程的最后阶段执行，确保所有构建任务完成后再进行文件复制
-     *
-     * @throws 当源文件不存在、权限不足或复制过程中出现其他错误时抛出异常
-     */
-    async writeBundle() {
-      if (!enabled) {
-        if (verbose) {
-          console.log(`\u2139 \u590D\u5236\u6587\u4EF6\u529F\u80FD\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${sourceDir} \u5230 ${targetDir}`);
-        }
-        return;
-      }
-      try {
-        await checkSourceExists(sourceDir);
-        await ensureTargetDir(targetDir);
-        await copySourceToTarget(sourceDir, targetDir, { recursive, overwrite });
-        if (verbose) {
-          console.log(`\u2705 \u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${sourceDir} \u5230 ${targetDir}`);
-        }
-      } catch (err) {
-        if (verbose) {
-          if (err instanceof Error) {
-            console.error(err.message);
-          } else {
-            console.error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${sourceDir} -> ${targetDir}`, err);
-          }
-        }
-        throw err;
-      }
-    }
-  };
-}

package/dist/plugins/copyFile/type.d.ts

@@ -1,47 +0,0 @@
-/**
- * 复制文件插件的配置选项接口
- *
- * @interface CopyFileOptions
- */
-export interface CopyFileOptions {
-    /**
-     * 源文件目录的路径
-     *
-     * @example 'src/assets'
-     */
-    sourceDir: string;
-    /**
-     * 目标文件目录的路径
-     *
-     * @example 'dist/assets'
-     */
-    targetDir: string;
-    /**
-     * 是否覆盖同名文件
-     *
-     * @defaultValue true
-     * @example false
-     */
-    overwrite?: boolean;
-    /**
-     * 是否支持递归复制
-     *
-     * @defaultValue true
-     * @example false
-     */
-    recursive?: boolean;
-    /**
-     * 是否显示详细日志
-     *
-     * @defaultValue true
-     * @example false
-     */
-    verbose?: boolean;
-    /**
-     * 是否启用复制功能
-     *
-     * @defaultValue true
-     * @example false
-     */
-    enabled?: boolean;
-}

package/dist/plugins/injectIco/index.d.ts

@@ -1,74 +0,0 @@
-import { type Plugin } from 'vite';
-import type { InjectIcoOptions } from './type';
-/**
- * 注入网站图标链接到 HTML 文件的头部
- *
- * @param options - 配置选项（字符串时视为 base）
- * @returns 一个 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({
- *   base: '/assets',
- *   enabled: process.env.NODE_ENV === 'production',
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- *
- * // 禁用插件
- * injectIco({
- *   base: '/assets',
- *   enabled: false,
- *   copyOptions: {
- *     sourceDir: 'src/assets/icons',
- *     targetDir: 'dist/assets/icons'
- *   }
- * })
- * ```
- */
-export declare function injectIco(options?: InjectIcoOptions | string): Plugin;

package/dist/plugins/injectIco/index.mjs

@@ -1,82 +0,0 @@
-import { checkSourceExists, ensureTargetDir, copySourceToTarget, generateIconTags } from "@/utils";
-export function injectIco(options) {
-  const normalizedOptions = typeof options === "string" ? { base: options } : options || {};
-  const { verbose = true, enabled = true } = normalizedOptions;
-  return {
-    name: "inject-ico",
-    /**
-     * 转换 HTML 入口文件的钩子函数
-     *
-     * @param html - 原始的 HTML 内容
-     * @returns 经过修改后的 HTML 内容，在 `</head>` 标签前注入图标链接
-     */
-    transformIndexHtml(html) {
-      if (!enabled) {
-        if (verbose) {
-          console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");
-        }
-        return html;
-      }
-      const iconTags = generateIconTags(normalizedOptions);
-      if (iconTags.length === 0) {
-        if (verbose) {
-          console.log("\u2139 inject-ico: \u6CA1\u6709\u751F\u6210\u56FE\u6807\u6807\u7B7E\uFF0C\u8DF3\u8FC7\u6CE8\u5165");
-        }
-        return html;
-      }
-      let modifiedHtml = html;
-      const headCloseIndex = modifiedHtml.indexOf("</head>");
-      if (headCloseIndex !== -1) {
-        const tagsHtml = iconTags.join("\n") + "\n";
-        modifiedHtml = modifiedHtml.substring(0, headCloseIndex) + tagsHtml + modifiedHtml.substring(headCloseIndex);
-        if (verbose) {
-          console.log(`\u2705 inject-ico: \u6210\u529F\u6CE8\u5165 ${iconTags.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`);
-          iconTags.forEach((tag) => {
-            console.log(`  - ${tag}`);
-          });
-        }
-      } else {
-        if (verbose) {
-          console.warn("\u26A0 inject-ico: \u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");
-        }
-      }
-      return modifiedHtml;
-    },
-    /**
-     * 构建完成后执行的钩子函数，用于复制图标文件到打包目录
-     *
-     * @remarks
-     * 只有当配置了 copyOptions 对象且 enabled 为 true 时才会执行复制操作
-     *
-     * @throws 当源文件不存在、权限不足或复制过程中出现其他错误时抛出异常
-     */
-    async writeBundle() {
-      if (!enabled) {
-        if (verbose) {
-          console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");
-        }
-        return;
-      }
-      const { copyOptions } = normalizedOptions;
-      if (!copyOptions) return;
-      const { sourceDir, targetDir, overwrite = true, recursive = true } = copyOptions;
-      try {
-        await checkSourceExists(sourceDir);
-        await ensureTargetDir(targetDir);
-        await copySourceToTarget(sourceDir, targetDir, { recursive, overwrite });
-        if (verbose) {
-          console.log(`\u2705 inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${sourceDir} \u5230 ${targetDir}`);
-        }
-      } catch (err) {
-        if (verbose) {
-          if (err instanceof Error) {
-            console.error(err.message);
-          } else {
-            console.error(`\u274C inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${sourceDir} -> ${targetDir}`, err);
-          }
-        }
-        throw err;
-      }
-    }
-  };
-}