@meng-xi/vite-plugin 0.0.1 → 0.0.3

package/dist/factory/index.d.ts

@@ -0,0 +1,260 @@
+import { ResolvedConfig, Plugin } from 'vite';
+import { B as BasePluginOptions, O as OptionsNormalizer, P as PluginFactory } from '../shared/vite-plugin.UkE7CdSe.js';
+import { P as PluginLogger, a as LoggerOptions } from '../shared/vite-plugin.B3PARlU9.js';
+import { V as Validator } from '../shared/vite-plugin.CiHfwMiN.js';
+
+/**
+ * 基础插件抽象类，提供插件开发的核心功能和生命周期管理
+ *
+ * @class BasePlugin
+ * @template T - 插件配置类型，必须继承自 BasePluginOptions
+ * @abstract
+ * @description 该类是所有插件的基类，提供了插件配置管理、日志记录、生命周期管理等核心功能
+ * @example
+ * ```typescript
+ * class MyPlugin extends BasePlugin<MyPluginOptions> {
+ *   protected getPluginName() {
+ *     return 'my-plugin'
+ *   }
+ *
+ *   protected addPluginHooks(plugin: Plugin) {
+ *     // 添加插件钩子
+ *   }
+ * }
+ * ```
+ */
+declare abstract class BasePlugin<T extends BasePluginOptions = BasePluginOptions> {
+    /**
+     * 插件配置
+     *
+     * @protected
+     * @description 插件配置，包含插件的运行参数和选项
+     */
+    protected options: Required<T>;
+    /**
+     * 插件日志记录器
+     *
+     * @protected
+     * @description 插件日志记录器，用于记录插件运行时的日志信息
+     */
+    protected logger: PluginLogger;
+    /**
+     * 插件配置验证器
+     *
+     * @protected
+     * @description 插件配置验证器，用于验证插件配置参数是否符合要求
+     */
+    protected validator: Validator<T>;
+    /**
+     * Vite 配置
+     *
+     * @protected
+     * @description Vite 配置，包含 Vite 构建的运行参数和选项
+     */
+    protected viteConfig: ResolvedConfig | null;
+    /**
+     * 插件构造函数
+     *
+     * @param options 插件配置
+     * @param loggerConfig 日志配置，可选
+     *
+     * @protected
+     * @description 插件构造函数，初始化插件配置、日志记录器和验证插件参数
+     */
+    constructor(options: T, loggerConfig?: LoggerOptions);
+    /**
+     * 获取插件的默认配置选项
+     *
+     * @protected
+     * @abstract
+     * @returns {Partial<T>} 插件特定的默认配置
+     * @description 子类必须实现此方法，以提供插件特定的默认配置值
+     */
+    protected abstract getDefaultOptions(): Partial<T>;
+    /**
+     * 合并插件配置，将用户提供的配置与默认配置合并
+     *
+     * @protected
+     * @template T - 插件配置类型，必须继承自 BasePluginOptions
+     * @param {T} options - 用户提供的插件配置
+     * @returns {Required<T>} 合并后的完整插件配置，包含所有必填字段
+     * @description 将用户提供的配置与基础默认值、插件特定默认值进行深度合并，确保所有必填字段都有值
+     * @example
+     * ```typescript
+     * const userOptions = { enabled: false }
+     * const mergedOptions = this.mergeOptions(userOptions)
+     * // mergedOptions 将包含基础默认值和插件特定默认值
+     * ```
+     */
+    protected mergeOptions(options: T): Required<T>;
+    /**
+     * 初始化日志记录器
+     *
+     * @private
+     * @param {LoggerOptions} loggerConfig - 日志配置对象，可选
+     * @returns {PluginLogger} 插件日志代理对象，用于记录插件日志
+     * @description 使用单例 Logger 创建插件特定的日志代理对象
+     */
+    private initLogger;
+    /**
+     * 验证插件配置参数，确保配置符合要求
+     *
+     * @protected
+     * @virtual
+     * @returns {void} 无返回值
+     * @throws {Error} 如果配置参数无效，抛出包含错误信息的异常
+     * @description 该方法在插件初始化时被调用，用于验证插件配置的有效性。子类可以重写此方法以添加自定义验证逻辑
+     * @example
+     * ```typescript
+     * protected validateOptions(): void {
+     *   if (!this.options.sourceDir) {
+     *     throw new Error('sourceDir 是必填项')
+     *   }
+     *
+     *   if (!this.options.targetDir) {
+     *     throw new Error('targetDir 是必填项')
+     *   }
+     * }
+     * ```
+     */
+    protected validateOptions(): void;
+    /**
+     * 获取插件名称
+     *
+     * @protected
+     * @returns {string} 插件的名称，用于 Vite 插件系统识别
+     */
+    protected abstract getPluginName(): string;
+    /**
+     * 获取插件执行时机
+     *
+     * @protected
+     * @returns {Plugin['enforce']} 插件的执行时机，可选值为 'pre'、'post' 或 undefined
+     * @description 'post' 表示插件在 Vite 构建后期执行
+     */
+    protected getEnforce(): Plugin['enforce'];
+    /**
+     * 处理配置解析完成事件
+     *
+     * @param config 解析后的 Vite 配置
+     *
+     * @protected
+     * @description 处理 Vite 配置解析完成事件，将解析后的配置存储到插件实例中
+     */
+    protected onConfigResolved(config: ResolvedConfig): void;
+    /**
+     * 添加插件钩子到 Vite 插件对象
+     *
+     * @protected
+     * @abstract
+     * @param {Plugin} plugin - Vite 插件对象，用于添加钩子
+     * @returns {void} 无返回值
+     * @description 添加插件钩子到 Vite 插件对象，用于在构建过程中执行插件逻辑
+     */
+    protected abstract addPluginHooks(plugin: Plugin): void;
+    /**
+     * 安全执行同步函数，自动处理执行过程中可能出现的错误
+     *
+     * @protected
+     * @template T - 函数的返回值类型
+     * @param {() => T} fn - 要执行的同步函数
+     * @param {string} context - 执行上下文描述，用于错误日志记录
+     * @returns {T | undefined} 函数的执行结果，如果执行过程中发生错误，根据错误策略返回 undefined 或抛出错误
+     * @description 该方法封装了同步函数的执行，自动处理可能出现的错误，根据插件配置的 errorStrategy 决定如何处理错误
+     * @example
+     * ```typescript
+     * // 安全执行同步操作
+     * const result = this.safeExecuteSync(() => {
+     *   return someSyncOperation()
+     * }, '执行同步操作')
+     *
+     * // 如果 someSyncOperation() 抛出错误，会根据 errorStrategy 处理
+     * ```
+     */
+    protected safeExecuteSync<T>(fn: () => T, context: string): T | undefined;
+    /**
+     * 安全执行异步函数，自动处理执行过程中可能出现的错误
+     *
+     * @protected
+     * @async
+     * @template T - 异步函数的返回值类型
+     * @param {() => Promise<T>} fn - 要执行的异步函数
+     * @param {string} context - 执行上下文描述，用于错误日志记录
+     * @returns {Promise<T | undefined>} 异步函数的执行结果，如果执行过程中发生错误，根据错误策略返回 undefined 或抛出错误
+     * @description 该方法封装了异步函数的执行，自动处理可能出现的错误，根据插件配置的 errorStrategy 决定如何处理错误
+     * @example
+     * ```typescript
+     * // 安全执行异步操作
+     * const result = await this.safeExecute(async () => {
+     *   return await someAsyncOperation()
+     * }, '执行异步操作')
+     *
+     * // 如果 someAsyncOperation() 抛出错误，会根据 errorStrategy 处理
+     * ```
+     */
+    protected safeExecute<T>(fn: () => Promise<T>, context: string): Promise<T | undefined>;
+    /**
+     * 处理插件执行过程中出现的错误，根据配置的错误策略决定如何处理
+     *
+     * @protected
+     * @template T - 返回值类型，仅当错误策略为 'log' 或 'ignore' 时返回 undefined
+     * @param {unknown} error - 捕获到的错误对象
+     * @param {string} context - 错误发生的上下文描述，用于错误日志记录
+     * @returns {T | undefined} 当错误策略为 'log' 或 'ignore' 时返回 undefined，否则抛出错误
+     * @description 根据插件配置的 errorStrategy 处理错误：
+     * - 'throw': 记录错误日志并抛出错误，中断执行
+     * - 'log': 记录错误日志但不抛出错误，继续执行
+     * - 'ignore': 记录错误日志但不抛出错误，继续执行
+     * - 默认：记录错误日志并抛出错误
+     * @example
+     * ```typescript
+     * // 当 errorStrategy 为 'throw' 时
+     * this.handleError(new Error('测试错误'), '测试上下文') // 记录错误日志并抛出错误
+     *
+     * // 当 errorStrategy 为 'log' 时
+     * this.handleError(new Error('测试错误'), '测试上下文') // 记录错误日志并返回 undefined
+     * ```
+     */
+    protected handleError<T>(error: unknown, context: string): T | undefined;
+    /**
+     * 将插件实例转换为 Vite 插件对象，用于 Vite 构建系统
+     *
+     * @public
+     * @returns {Plugin} Vite 插件对象，包含插件名称、执行时机和各种钩子函数
+     * @description 该方法创建并返回一个符合 Vite 插件规范的对象，设置了插件的基本信息和 configResolved 钩子，然后调用 addPluginHooks 方法添加插件特定的钩子
+     * @example
+     * ```typescript
+     * // 创建插件实例
+     * const pluginInstance = new MyPlugin(options)
+     *
+     * // 转换为 Vite 插件
+     * const vitePlugin = pluginInstance.toPlugin()
+     *
+     * // 导出 Vite 插件
+     * export const myPlugin = vitePlugin
+     * ```
+     */
+    toPlugin(): Plugin;
+}
+/**
+ * 创建插件工厂函数，用于生成 Vite 插件实例
+ *
+ * @template T - 插件配置类型，必须继承自 BasePluginOptions
+ * @template P - 插件实例类型，必须继承自 BasePlugin<T>
+ * @template R - 原始配置类型
+ * @param {new (options: T, loggerConfig?: LoggerOptions) => P} PluginClass - 插件类构造函数
+ * @param {OptionsNormalizer<T, R>} [normalizer] - 选项标准化器，可选
+ * @returns {PluginFactory<T, R>} 插件工厂函数，接收插件配置并返回 Vite 插件实例
+ * @description 该函数创建一个插件工厂，用于生成 Vite 插件实例。工厂函数接收插件配置，支持可选的标准化器，创建插件实例，转换为 Vite 插件对象，并在插件对象上添加对原始插件实例的引用
+ * @example
+ * ```typescript
+ * // 基本使用
+ * const myPluginFactory = createPluginFactory(MyPlugin)
+ *
+ * // 带标准化器的使用（支持字符串或对象）
+ * const myPluginWithNormalizer = createPluginFactory(MyPlugin, (opt) => typeof opt === 'string' ? { path: opt } : opt)
+ * ```
+ */
+declare function createPluginFactory<T extends BasePluginOptions, P extends BasePlugin<T>, R = T>(PluginClass: new (options: T, loggerConfig?: LoggerOptions) => P, normalizer?: OptionsNormalizer<T, R>): PluginFactory<T, R>;
+
+export { BasePlugin, createPluginFactory };

package/dist/factory/index.mjs

@@ -0,0 +1 @@
+export{B as BasePlugin,c as createPluginFactory}from"../shared/vite-plugin.ClHiVXD6.mjs";import"../logger/index.mjs";import"fs";import"path";import"../shared/vite-plugin.DSRKYuae.mjs";

package/dist/index.cjs

@@ -1,3 +1 @@
-"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;
+"use strict";const index=require("./shared/vite-plugin.DrSzERYS.cjs"),validation=require("./shared/vite-plugin.BTKhc7n7.cjs"),index$1=require("./shared/vite-plugin.BT1oHRKK.cjs"),logger_index=require("./logger/index.cjs"),index$2=require("./shared/vite-plugin.Bn8mcCzy.cjs");require("fs"),require("path"),exports.checkSourceExists=index.checkSourceExists,exports.copySourceToTarget=index.copySourceToTarget,exports.ensureTargetDir=index.ensureTargetDir,exports.readDirRecursive=index.readDirRecursive,exports.readFileSync=index.readFileSync,exports.shouldUpdateFile=index.shouldUpdateFile,exports.writeFileContent=index.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge,exports.BasePlugin=index$1.BasePlugin,exports.createPluginFactory=index$1.createPluginFactory,exports.Logger=logger_index.Logger,exports.copyFile=index$2.copyFile,exports.injectIco=index$2.injectIco;

package/dist/index.d.cts

@@ -1,282 +1,7 @@
-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 };
+export { checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, readDirRecursive, readFileSync, shouldUpdateFile, writeFileContent } from './common/index.cjs';
+export { V as Validator } from './shared/vite-plugin.CiHfwMiN.cjs';
+export { BasePlugin, createPluginFactory } from './factory/index.cjs';
+export { L as Logger, P as PluginLogger } from './shared/vite-plugin.B3PARlU9.cjs';
+export { copyFile, injectIco } from './plugins/index.cjs';
+import 'vite';
+import './shared/vite-plugin.UkE7CdSe.cjs';