@meng-xi/vite-plugin 0.0.1

package/README.md

@@ -0,0 +1,138 @@
+# @meng-xi/vite-plugin [![npm](https://img.shields.io/npm/v/@meng-xi/vite-plugin?color=blue)](https://www.npmjs.com/package/@meng-xi/vite-plugin) ![GitHub](https://img.shields.io/github/license/MengXi-Studio/vite-plugin?color=orange)
+
+> - 这是一个为 Vite 提供实用插件的工具包，帮助开发者简化构建流程，提高开发效率。
+> - 扩展 Vite 构建流程的功能，提供常见构建任务的自动化处理方案。
+> - 所有插件都支持详细的配置选项，可根据项目需求自定义行为，满足不同场景的使用需求。
+> - 插件提供错误处理机制，确保构建流程能捕获到错误，提高构建的可靠性。
+> - 采用模块化设计，插件可以单独使用，也可以组合使用，灵活应对不同项目的需求。
+
+---
+
+开始阅读[文档](https://mengxi-studio.github.io/vite-plugin/)。
+
+## 快速入门
+
+### 安装
+
+使用包管理器安装 `@meng-xi/vite-plugin`：
+
+```bash
+# 使用 npm
+npm install @meng-xi/vite-plugin --save-dev
+
+# 使用 yarn
+yarn add @meng-xi/vite-plugin --save-dev
+
+# 使用 pnpm
+pnpm add @meng-xi/vite-plugin --save-dev
+```
+
+### 基本使用
+
+在 Vite 配置文件中引入并使用插件：
+
+```typescript
+import { defineConfig } from 'vite'
+import { copyFile, injectIco } from '@meng-xi/vite-plugin'
+
+export default defineConfig({
+	plugins: [
+		// 复制文件插件
+		copyFile({
+			sourceDir: 'src/assets',
+			targetDir: 'dist/assets'
+		}),
+
+		// 注入图标插件
+		injectIco({
+			base: '/assets'
+		})
+	]
+})
+```
+
+### 全部引入
+
+也可以使用默认导入的方式全部引入：
+
+```typescript
+import { defineConfig } from 'vite'
+import vitePlugin from '@meng-xi/vite-plugin'
+
+export default defineConfig({
+	plugins: [
+		// 复制文件插件
+		vitePlugin.copyFile({
+			sourceDir: 'src/assets',
+			targetDir: 'dist/assets'
+		}),
+
+		// 注入图标插件
+		vitePlugin.injectIco({
+			base: '/assets'
+		})
+	]
+})
+```
+
+## 插件详情
+
+### copyFile 插件
+
+用于在 Vite 构建完成后复制文件或目录到指定位置。
+
+**配置选项**：
+
+- `sourceDir`：源目录路径（必填）
+- `targetDir`：目标目录路径（必填）
+- `overwrite`：是否覆盖已存在的文件，默认为 `true`
+- `recursive`：是否递归复制子目录，默认为 `true`
+- `verbose`：是否输出详细日志，默认为 `true`
+- `enabled`：是否启用插件，默认为 `true`
+
+### injectIco 插件
+
+用于在 Vite 构建过程中注入网站图标链接到 HTML 文件的头部。
+
+**配置选项**：
+
+- `base`：图标文件的基础路径
+- `url`：图标的完整 URL
+- `link`：自定义的完整 link 标签 HTML
+- `icons`：自定义图标数组
+- `verbose`：是否输出详细日志，默认为 `true`
+- `enabled`：是否启用插件，默认为 `true`
+- `copyOptions`：图标文件复制配置
+
+## 贡献
+
+欢迎为 `@meng-xi/vite-plugin` 贡献代码。以下是贡献代码的步骤：
+
+1. Fork 项目：在 GitHub 上 Fork 此项目。
+2. 克隆代码：将 Fork 后的项目克隆到您的本地机器。
+
+```bash
+git clone https://github.com/your-username/vite-plugin.git
+cd vite-plugin
+```
+
+3. 创建新分支：基于 `master` 分支创建一个新的功能分支。
+
+```bash
+git checkout -b feature/your-feature
+```
+
+4. 提交变更：确保您的代码通过了测试，并使用清晰的提交消息提交您的变更。
+
+```bash
+git add .
+git commit -m "feat: add your feature description"
+```
+
+5. Push 变更：将您的本地分支推送到 GitHub。
+
+```bash
+git push origin feature/your-feature
+```
+
+6. 创建 PR：在 GitHub 上创建一个 Pull Request，并等待审核。

package/dist/index.cjs

@@ -0,0 +1,3 @@
+"use strict";const i=require("fs");function _interopDefaultCompat(u){return u&&typeof u=="object"&&"default"in u?u.default:u}const i__default=_interopDefaultCompat(i);async function checkSourceExists(u){try{await i__default.promises.access(u,i__default.constants.F_OK)}catch(r){const e=r;throw e.code==="ENOENT"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${u}`):e.code==="EACCES"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${u}`):new Error(`\u274C \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 i__default.promises.mkdir(u,{recursive:!0})}catch(r){const e=r;throw e.code==="EACCES"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${u}`):new Error(`\u274C \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 copySourceToTarget(u,r,e){try{await i__default.promises.cp(u,r,{recursive:e.recursive,force:e.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 - ${u}`):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 - ${u} -> ${r}`):F.code==="EPERM"?new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u590D\u5236\u8FC7\u7A0B\u4E2D\u64CD\u4F5C\u88AB\u62D2\u7EDD - ${u} -> ${r}`):new Error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u590D\u5236\u6587\u4EF6\u65F6\u51FA\u9519 - ${u} -> ${r}\uFF0C\u9519\u8BEF\uFF1A${F.message}`)}}function generateIconTags(u){const r=[];if(u.link)return r.push(u.link),r;if(u.icons&&u.icons.length>0)r.push(...u.icons.map(e=>{let o=`<link rel="${e.rel}" href="${e.href}"`;return e.sizes&&(o+=` sizes="${e.sizes}"`),e.type&&(o+=` type="${e.type}"`),o+=" />",o}));else if(u.url)r.push(`<link rel="icon" href="${u.url}" />`);else{const e=u.base||"/",o=e.endsWith("/")?`${e}favicon.ico`:`${e}/favicon.ico`;r.push(`<link rel="icon" href="${o}" />`)}return r}function copyFile(u){const{sourceDir:r,targetDir:e,overwrite:o=!0,recursive:F=!0,verbose:n=!0,enabled:t=!0}=u;return{name:"copy-file",enforce:"post",async writeBundle(){if(!t){n&&console.log(`\u2139 \u590D\u5236\u6587\u4EF6\u529F\u80FD\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${r} \u5230 ${e}`);return}try{await checkSourceExists(r),await ensureTargetDir(e),await copySourceToTarget(r,e,{recursive:F,overwrite:o}),n&&console.log(`\u2705 \u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${r} \u5230 ${e}`)}catch(c){throw n&&(c instanceof Error?console.error(c.message):console.error(`\u274C \u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${r} -> ${e}`,c)),c}}}}function injectIco(u){const r=typeof u=="string"?{base:u}:u||{},{verbose:e=!0,enabled:o=!0}=r;return{name:"inject-ico",transformIndexHtml(F){if(!o)return e&&console.log("\u2139 inject-ico: \u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),F;const n=generateIconTags(r);if(n.length===0)return e&&console.log("\u2139 inject-ico: \u6CA1\u6709\u751F\u6210\u56FE\u6807\u6807\u7B7E\uFF0C\u8DF3\u8FC7\u6CE8\u5165"),F;let t=F;const c=t.indexOf("</head>");if(c!==-1){const s=n.join(`
+`)+`
+`;t=t.substring(0,c)+s+t.substring(c),e&&(console.log(`\u2705 inject-ico: \u6210\u529F\u6CE8\u5165 ${n.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`),n.forEach(E=>{console.log(`  - ${E}`)}))}else e&&console.warn("\u26A0 inject-ico: \u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165");return t},async writeBundle(){if(!o){e&&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:t,overwrite:c=!0,recursive:s=!0}=F;try{await checkSourceExists(n),await ensureTargetDir(t),await copySourceToTarget(n,t,{recursive:s,overwrite:c}),e&&console.log(`\u2705 inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${n} \u5230 ${t}`)}catch(E){throw e&&(E instanceof Error?console.error(E.message):console.error(`\u274C inject-ico: \u56FE\u6807\u6587\u4EF6\u590D\u5236\u5931\u8D25\uFF1A\u672A\u77E5\u9519\u8BEF - ${n} -> ${t}`,E)),E}}}}exports.copyFile=copyFile,exports.injectIco=injectIco;

package/dist/index.d.cts

@@ -0,0 +1,282 @@
+import { Plugin } from 'vite';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+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;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @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 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录
+ */
+declare function copyFile(options: CopyFileOptions): Plugin;
+
+/**
+ * 图标配置项接口
+ *
+ * @interface Icon
+ */
+interface Icon {
+    /**
+     * 图标关系类型
+     */
+    rel: string;
+    /**
+     * 图标 URL
+     */
+    href: string;
+    /**
+     * 图标尺寸
+     */
+    sizes?: string;
+    /**
+     * 图标 MIME 类型
+     */
+    type?: string;
+}
+/**
+ * 图标文件复制配置选项接口
+ *
+ * @interface CopyOptions
+ */
+interface CopyOptions {
+    /**
+     * 图标源文件目录，用于复制图标到打包目录
+     *
+     * @example 'src/assets/icons'
+     */
+    sourceDir: string;
+    /**
+     * 图标目标目录（打包目录），用于复制图标到打包目录
+     *
+     * @example 'dist/assets/icons'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @defaultValue true
+     * @example false
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @defaultValue true
+     * @example false
+     */
+    recursive?: boolean;
+}
+/**
+ * 注入网站图标链接的配置选项接口
+ *
+ * @interface InjectIcoOptions
+ */
+interface InjectIcoOptions {
+    /**
+     * 图标文件的基础路径，默认为根路径 `/`
+     *
+     * @defaultValue `/`
+     * @example '/assets'
+     */
+    base?: string;
+    /**
+     * 图标的完整 URL，如果提供则优先使用（覆盖 base + favicon.ico）
+     *
+     * @example 'https://example.com/favicon.ico'
+     */
+    url?: string;
+    /**
+     * 自定义的完整 link 标签 HTML，如果提供则优先使用（覆盖 url 和 base）
+     *
+     * @example '<link rel="icon" href="/favicon.svg" type="image/svg+xml" />'
+     */
+    link?: string;
+    /**
+     * 自定义图标数组，支持多种图标格式和尺寸
+     *
+     * @example
+     * [
+     *   { 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' }
+     * ]
+     */
+    icons?: Icon[];
+    /**
+     * 是否显示详细日志
+     *
+     * @defaultValue true
+     * @example false
+     */
+    verbose?: boolean;
+    /**
+     * 是否启用图标注入和文件复制功能
+     *
+     * @defaultValue true
+     * @example false
+     */
+    enabled?: boolean;
+    /**
+     * 图标文件复制配置选项
+     *
+     * @remarks
+     * 当此对象存在时，才会开启图标文件复制功能
+     */
+    copyOptions?: CopyOptions;
+}
+
+/**
+ * 注入网站图标链接到 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'
+ *   }
+ * })
+ * ```
+ */
+declare function injectIco(options?: InjectIcoOptions | string): Plugin;
+
+export { copyFile, injectIco };

package/dist/index.d.mts

@@ -0,0 +1,282 @@
+import { Plugin } from 'vite';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+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;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @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 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录
+ */
+declare function copyFile(options: CopyFileOptions): Plugin;
+
+/**
+ * 图标配置项接口
+ *
+ * @interface Icon
+ */
+interface Icon {
+    /**
+     * 图标关系类型
+     */
+    rel: string;
+    /**
+     * 图标 URL
+     */
+    href: string;
+    /**
+     * 图标尺寸
+     */
+    sizes?: string;
+    /**
+     * 图标 MIME 类型
+     */
+    type?: string;
+}
+/**
+ * 图标文件复制配置选项接口
+ *
+ * @interface CopyOptions
+ */
+interface CopyOptions {
+    /**
+     * 图标源文件目录，用于复制图标到打包目录
+     *
+     * @example 'src/assets/icons'
+     */
+    sourceDir: string;
+    /**
+     * 图标目标目录（打包目录），用于复制图标到打包目录
+     *
+     * @example 'dist/assets/icons'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @defaultValue true
+     * @example false
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @defaultValue true
+     * @example false
+     */
+    recursive?: boolean;
+}
+/**
+ * 注入网站图标链接的配置选项接口
+ *
+ * @interface InjectIcoOptions
+ */
+interface InjectIcoOptions {
+    /**
+     * 图标文件的基础路径，默认为根路径 `/`
+     *
+     * @defaultValue `/`
+     * @example '/assets'
+     */
+    base?: string;
+    /**
+     * 图标的完整 URL，如果提供则优先使用（覆盖 base + favicon.ico）
+     *
+     * @example 'https://example.com/favicon.ico'
+     */
+    url?: string;
+    /**
+     * 自定义的完整 link 标签 HTML，如果提供则优先使用（覆盖 url 和 base）
+     *
+     * @example '<link rel="icon" href="/favicon.svg" type="image/svg+xml" />'
+     */
+    link?: string;
+    /**
+     * 自定义图标数组，支持多种图标格式和尺寸
+     *
+     * @example
+     * [
+     *   { 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' }
+     * ]
+     */
+    icons?: Icon[];
+    /**
+     * 是否显示详细日志
+     *
+     * @defaultValue true
+     * @example false
+     */
+    verbose?: boolean;
+    /**
+     * 是否启用图标注入和文件复制功能
+     *
+     * @defaultValue true
+     * @example false
+     */
+    enabled?: boolean;
+    /**
+     * 图标文件复制配置选项
+     *
+     * @remarks
+     * 当此对象存在时，才会开启图标文件复制功能
+     */
+    copyOptions?: CopyOptions;
+}
+
+/**
+ * 注入网站图标链接到 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'
+ *   }
+ * })
+ * ```
+ */
+declare function injectIco(options?: InjectIcoOptions | string): Plugin;
+
+export { copyFile, injectIco };