@meng-xi/vite-plugin 0.1.0 → 0.1.2

package/dist/plugins/compressAssets/index.d.cts

@@ -0,0 +1,132 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.cjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.cjs';
+import '../../shared/vite-plugin.DRRlWY8P.cjs';
+
+/**
+ * 压缩算法类型
+ *
+ * @typedef {('gzip' | 'brotli' | 'both')} CompressAlgorithm
+ * @description 支持的压缩算法：
+ * - `gzip`: 使用 gzip 压缩，输出 `.gz` 文件
+ * - `brotli`: 使用 brotli 压缩，输出 `.br` 文件
+ * - `both`: 同时生成 gzip 和 brotli 两种压缩文件
+ */
+type CompressAlgorithm = 'gzip' | 'brotli' | 'both';
+/**
+ * 单个文件的压缩统计信息
+ *
+ * @interface CompressStats
+ * @description 记录单个文件经过压缩后的详细统计数据
+ */
+interface CompressStats {
+    /** 原始文件路径 */
+    file: string;
+    /** 原始文件大小（字节） */
+    originalSize: number;
+    /** 压缩后文件大小（字节） */
+    compressedSize: number;
+    /** 压缩率百分比（0-100），如 75.3 表示压缩后体积减少 75.3% */
+    ratio: number;
+    /** 使用的压缩算法 */
+    algorithm: 'gzip' | 'brotli';
+}
+/**
+ * 压缩操作的汇总统计信息
+ *
+ * @interface CompressSummary
+ * @description 包含整个压缩操作的总体统计数据，用于报告生成和日志输出
+ */
+interface CompressSummary {
+    /** 压缩的文件总数 */
+    totalFiles: number;
+    /** 所有文件的原始大小总和（字节） */
+    totalOriginalSize: number;
+    /** 所有文件的压缩后大小总和（字节） */
+    totalCompressedSize: number;
+    /** 总体压缩率百分比 */
+    totalRatio: number;
+    /** 使用 gzip 压缩的文件数量 */
+    gzipFiles: number;
+    /** 使用 brotli 压缩的文件数量 */
+    brotliFiles: number;
+    /** 压缩操作总耗时（毫秒） */
+    executionTime: number;
+    /** 每个文件的详细压缩统计 */
+    stats: CompressStats[];
+}
+/**
+ * 构建产物压缩插件的配置选项
+ *
+ * @interface CompressAssetsOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * compressAssets({
+ *   algorithm: 'both',
+ *   threshold: 2048,
+ *   compressionLevel: 9,
+ *   brotliQuality: 11,
+ *   reportOutput: 'compress-report.json'
+ * })
+ * ```
+ */
+interface CompressAssetsOptions extends BasePluginOptions {
+    /** 压缩算法，支持 gzip、brotli 或同时使用两者 */
+    algorithm?: CompressAlgorithm;
+    /** 最小压缩阈值（字节），小于此大小的文件将被跳过 */
+    threshold?: number;
+    /** 是否在压缩后删除原始文件，仅保留压缩版本 */
+    deleteOriginalFile?: boolean;
+    /** 需要压缩的文件扩展名列表，如 ['.js', '.css', '.html'] */
+    includeExtensions?: string[];
+    /** 需要排除的文件扩展名列表，优先级高于 includeExtensions */
+    excludeExtensions?: string[];
+    /** 需要排除的路径前缀列表，匹配到的路径下的文件将跳过压缩 */
+    excludePaths?: string[];
+    /** gzip 压缩级别，范围 1-9，1 最快压缩率最低，9 最慢压缩率最高 */
+    compressionLevel?: number;
+    /** brotli 崩质量参数，范围 1-11，1 最快质量最低，11 最慢质量最高 */
+    brotliQuality?: number;
+    /** 压缩报告输出路径，设为 false 则不生成报告 */
+    reportOutput?: string | false;
+    /** 并发压缩的最大文件数，控制同时进行压缩操作的文件数量 */
+    parallelLimit?: number;
+}
+
+/**
+ * 创建构建产物压缩插件
+ *
+ * @function compressAssets
+ * @param {Partial<CompressAssetsOptions>} [options] - 插件配置选项
+ * @returns {Plugin} Vite 插件实例
+ *
+ * @description 在 Vite 构建完成后自动压缩输出目录中的文件，
+ * 支持 gzip 和 brotli 两种压缩算法，可配置压缩级别、文件过滤规则、
+ * 并发数量等参数，并生成压缩统计报告。
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { compressAssets } from '@meng-xi/vite-plugin'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     compressAssets({
+ *       algorithm: 'both',
+ *       threshold: 2048,
+ *       deleteOriginalFile: false,
+ *       compressionLevel: 9,
+ *       brotliQuality: 11,
+ *       reportOutput: 'compress-report.json',
+ *       parallelLimit: 10
+ *     })
+ *   ]
+ * })
+ * ```
+ */
+declare const compressAssets: PluginFactory<CompressAssetsOptions, CompressAssetsOptions>;
+
+export { compressAssets };
+export type { CompressAlgorithm, CompressAssetsOptions, CompressStats, CompressSummary };

package/dist/plugins/compressAssets/index.d.mts

@@ -0,0 +1,132 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.DRRlWY8P.mjs';
+
+/**
+ * 压缩算法类型
+ *
+ * @typedef {('gzip' | 'brotli' | 'both')} CompressAlgorithm
+ * @description 支持的压缩算法：
+ * - `gzip`: 使用 gzip 压缩，输出 `.gz` 文件
+ * - `brotli`: 使用 brotli 压缩，输出 `.br` 文件
+ * - `both`: 同时生成 gzip 和 brotli 两种压缩文件
+ */
+type CompressAlgorithm = 'gzip' | 'brotli' | 'both';
+/**
+ * 单个文件的压缩统计信息
+ *
+ * @interface CompressStats
+ * @description 记录单个文件经过压缩后的详细统计数据
+ */
+interface CompressStats {
+    /** 原始文件路径 */
+    file: string;
+    /** 原始文件大小（字节） */
+    originalSize: number;
+    /** 压缩后文件大小（字节） */
+    compressedSize: number;
+    /** 压缩率百分比（0-100），如 75.3 表示压缩后体积减少 75.3% */
+    ratio: number;
+    /** 使用的压缩算法 */
+    algorithm: 'gzip' | 'brotli';
+}
+/**
+ * 压缩操作的汇总统计信息
+ *
+ * @interface CompressSummary
+ * @description 包含整个压缩操作的总体统计数据，用于报告生成和日志输出
+ */
+interface CompressSummary {
+    /** 压缩的文件总数 */
+    totalFiles: number;
+    /** 所有文件的原始大小总和（字节） */
+    totalOriginalSize: number;
+    /** 所有文件的压缩后大小总和（字节） */
+    totalCompressedSize: number;
+    /** 总体压缩率百分比 */
+    totalRatio: number;
+    /** 使用 gzip 压缩的文件数量 */
+    gzipFiles: number;
+    /** 使用 brotli 压缩的文件数量 */
+    brotliFiles: number;
+    /** 压缩操作总耗时（毫秒） */
+    executionTime: number;
+    /** 每个文件的详细压缩统计 */
+    stats: CompressStats[];
+}
+/**
+ * 构建产物压缩插件的配置选项
+ *
+ * @interface CompressAssetsOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * compressAssets({
+ *   algorithm: 'both',
+ *   threshold: 2048,
+ *   compressionLevel: 9,
+ *   brotliQuality: 11,
+ *   reportOutput: 'compress-report.json'
+ * })
+ * ```
+ */
+interface CompressAssetsOptions extends BasePluginOptions {
+    /** 压缩算法，支持 gzip、brotli 或同时使用两者 */
+    algorithm?: CompressAlgorithm;
+    /** 最小压缩阈值（字节），小于此大小的文件将被跳过 */
+    threshold?: number;
+    /** 是否在压缩后删除原始文件，仅保留压缩版本 */
+    deleteOriginalFile?: boolean;
+    /** 需要压缩的文件扩展名列表，如 ['.js', '.css', '.html'] */
+    includeExtensions?: string[];
+    /** 需要排除的文件扩展名列表，优先级高于 includeExtensions */
+    excludeExtensions?: string[];
+    /** 需要排除的路径前缀列表，匹配到的路径下的文件将跳过压缩 */
+    excludePaths?: string[];
+    /** gzip 压缩级别，范围 1-9，1 最快压缩率最低，9 最慢压缩率最高 */
+    compressionLevel?: number;
+    /** brotli 崩质量参数，范围 1-11，1 最快质量最低，11 最慢质量最高 */
+    brotliQuality?: number;
+    /** 压缩报告输出路径，设为 false 则不生成报告 */
+    reportOutput?: string | false;
+    /** 并发压缩的最大文件数，控制同时进行压缩操作的文件数量 */
+    parallelLimit?: number;
+}
+
+/**
+ * 创建构建产物压缩插件
+ *
+ * @function compressAssets
+ * @param {Partial<CompressAssetsOptions>} [options] - 插件配置选项
+ * @returns {Plugin} Vite 插件实例
+ *
+ * @description 在 Vite 构建完成后自动压缩输出目录中的文件，
+ * 支持 gzip 和 brotli 两种压缩算法，可配置压缩级别、文件过滤规则、
+ * 并发数量等参数，并生成压缩统计报告。
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { compressAssets } from '@meng-xi/vite-plugin'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     compressAssets({
+ *       algorithm: 'both',
+ *       threshold: 2048,
+ *       deleteOriginalFile: false,
+ *       compressionLevel: 9,
+ *       brotliQuality: 11,
+ *       reportOutput: 'compress-report.json',
+ *       parallelLimit: 10
+ *     })
+ *   ]
+ * })
+ * ```
+ */
+declare const compressAssets: PluginFactory<CompressAssetsOptions, CompressAssetsOptions>;
+
+export { compressAssets };
+export type { CompressAlgorithm, CompressAssetsOptions, CompressStats, CompressSummary };

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

@@ -0,0 +1,132 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.DRRlWY8P.js';
+
+/**
+ * 压缩算法类型
+ *
+ * @typedef {('gzip' | 'brotli' | 'both')} CompressAlgorithm
+ * @description 支持的压缩算法：
+ * - `gzip`: 使用 gzip 压缩，输出 `.gz` 文件
+ * - `brotli`: 使用 brotli 压缩，输出 `.br` 文件
+ * - `both`: 同时生成 gzip 和 brotli 两种压缩文件
+ */
+type CompressAlgorithm = 'gzip' | 'brotli' | 'both';
+/**
+ * 单个文件的压缩统计信息
+ *
+ * @interface CompressStats
+ * @description 记录单个文件经过压缩后的详细统计数据
+ */
+interface CompressStats {
+    /** 原始文件路径 */
+    file: string;
+    /** 原始文件大小（字节） */
+    originalSize: number;
+    /** 压缩后文件大小（字节） */
+    compressedSize: number;
+    /** 压缩率百分比（0-100），如 75.3 表示压缩后体积减少 75.3% */
+    ratio: number;
+    /** 使用的压缩算法 */
+    algorithm: 'gzip' | 'brotli';
+}
+/**
+ * 压缩操作的汇总统计信息
+ *
+ * @interface CompressSummary
+ * @description 包含整个压缩操作的总体统计数据，用于报告生成和日志输出
+ */
+interface CompressSummary {
+    /** 压缩的文件总数 */
+    totalFiles: number;
+    /** 所有文件的原始大小总和（字节） */
+    totalOriginalSize: number;
+    /** 所有文件的压缩后大小总和（字节） */
+    totalCompressedSize: number;
+    /** 总体压缩率百分比 */
+    totalRatio: number;
+    /** 使用 gzip 压缩的文件数量 */
+    gzipFiles: number;
+    /** 使用 brotli 压缩的文件数量 */
+    brotliFiles: number;
+    /** 压缩操作总耗时（毫秒） */
+    executionTime: number;
+    /** 每个文件的详细压缩统计 */
+    stats: CompressStats[];
+}
+/**
+ * 构建产物压缩插件的配置选项
+ *
+ * @interface CompressAssetsOptions
+ * @extends {BasePluginOptions}
+ *
+ * @example
+ * ```typescript
+ * compressAssets({
+ *   algorithm: 'both',
+ *   threshold: 2048,
+ *   compressionLevel: 9,
+ *   brotliQuality: 11,
+ *   reportOutput: 'compress-report.json'
+ * })
+ * ```
+ */
+interface CompressAssetsOptions extends BasePluginOptions {
+    /** 压缩算法，支持 gzip、brotli 或同时使用两者 */
+    algorithm?: CompressAlgorithm;
+    /** 最小压缩阈值（字节），小于此大小的文件将被跳过 */
+    threshold?: number;
+    /** 是否在压缩后删除原始文件，仅保留压缩版本 */
+    deleteOriginalFile?: boolean;
+    /** 需要压缩的文件扩展名列表，如 ['.js', '.css', '.html'] */
+    includeExtensions?: string[];
+    /** 需要排除的文件扩展名列表，优先级高于 includeExtensions */
+    excludeExtensions?: string[];
+    /** 需要排除的路径前缀列表，匹配到的路径下的文件将跳过压缩 */
+    excludePaths?: string[];
+    /** gzip 压缩级别，范围 1-9，1 最快压缩率最低，9 最慢压缩率最高 */
+    compressionLevel?: number;
+    /** brotli 崩质量参数，范围 1-11，1 最快质量最低，11 最慢质量最高 */
+    brotliQuality?: number;
+    /** 压缩报告输出路径，设为 false 则不生成报告 */
+    reportOutput?: string | false;
+    /** 并发压缩的最大文件数，控制同时进行压缩操作的文件数量 */
+    parallelLimit?: number;
+}
+
+/**
+ * 创建构建产物压缩插件
+ *
+ * @function compressAssets
+ * @param {Partial<CompressAssetsOptions>} [options] - 插件配置选项
+ * @returns {Plugin} Vite 插件实例
+ *
+ * @description 在 Vite 构建完成后自动压缩输出目录中的文件，
+ * 支持 gzip 和 brotli 两种压缩算法，可配置压缩级别、文件过滤规则、
+ * 并发数量等参数，并生成压缩统计报告。
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import { compressAssets } from '@meng-xi/vite-plugin'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     compressAssets({
+ *       algorithm: 'both',
+ *       threshold: 2048,
+ *       deleteOriginalFile: false,
+ *       compressionLevel: 9,
+ *       brotliQuality: 11,
+ *       reportOutput: 'compress-report.json',
+ *       parallelLimit: 10
+ *     })
+ *   ]
+ * })
+ * ```
+ */
+declare const compressAssets: PluginFactory<CompressAssetsOptions, CompressAssetsOptions>;
+
+export { compressAssets };
+export type { CompressAlgorithm, CompressAssetsOptions, CompressStats, CompressSummary };

package/dist/plugins/compressAssets/index.mjs

@@ -0,0 +1 @@
+import{createPluginFactory as d,BasePlugin as z}from"../../factory/index.mjs";import{createGzip as S,createBrotliCompress as y,constants as x}from"node:zlib";import{promises as u,createReadStream as h,createWriteStream as f}from"node:fs";import{pipeline as F}from"node:stream/promises";import m from"node:path";import{writeFileContent as E,runWithConcurrency as w}from"../../common/fs/index.mjs";import"../../logger/index.mjs";import"../../common/object/index.mjs";import"../../shared/vite-plugin.DcExl6jd.mjs";import"fs";import"path";async function B(i,t,e){const s=(await u.stat(i)).size,r=S({level:e});await F(h(i),r,f(t));const o=(await u.stat(t)).size;return{file:i,originalSize:s,compressedSize:o,ratio:s>0?Number(((1-o/s)*100).toFixed(1)):0,algorithm:"gzip"}}async function b(i,t,e){const s=(await u.stat(i)).size,r=y({params:{[x.BROTLI_PARAM_QUALITY]:e}});await F(h(i),r,f(t));const o=(await u.stat(t)).size;return{file:i,originalSize:s,compressedSize:o,ratio:s>0?Number(((1-o/s)*100).toFixed(1)):0,algorithm:"brotli"}}async function C(i,t,e,s){const r=i+(t==="gzip"?".gz":".br");return t==="gzip"?B(i,r,e):b(i,r,s)}function O(i,t,e,s){const r=i.replace(/\\/g,"/");if(e<s.threshold||s.excludeExtensions.length>0&&s.excludeExtensions.includes(t)||s.includeExtensions.length>0&&!s.includeExtensions.includes(t))return!1;if(s.excludePaths.length>0)for(const o of s.excludePaths){const l=o.replace(/\\/g,"/");if(r.startsWith(l)||r.includes(l))return!1}return!(t===".gz"||t===".br")}async function A(i,t){const e=[];async function s(r){const o=await u.readdir(r,{withFileTypes:!0});for(const l of o){const a=m.join(r,l.name);if(l.isDirectory())await s(a);else if(l.isFile()){const n=await u.stat(a),p=m.relative(i,a),g=m.extname(l.name).toLowerCase();O(p,g,n.size,t)&&e.push({filePath:a,relativePath:p,size:n.size,ext:g})}}}return await s(i),e}function D(i,t){const e=i.reduce((o,l)=>o+l.originalSize,0),s=i.reduce((o,l)=>o+l.compressedSize,0),r=e>0?Number(((1-s/e)*100).toFixed(1)):0;return{totalFiles:i.length,totalOriginalSize:e,totalCompressedSize:s,totalRatio:r,gzipFiles:i.filter(o=>o.algorithm==="gzip").length,brotliFiles:i.filter(o=>o.algorithm==="brotli").length,executionTime:t,stats:i}}function c(i){return i<1024?`${i}B`:i<1024*1024?`${(i/1024).toFixed(1)}KB`:`${(i/(1024*1024)).toFixed(2)}MB`}async function v(i,t,e){if(!t)return;const s=m.isAbsolute(t)?t:m.join(i,t),r={timestamp:new Date().toISOString(),summary:{totalFiles:e.totalFiles,totalOriginalSize:e.totalOriginalSize,totalCompressedSize:e.totalCompressedSize,totalRatio:e.totalRatio,gzipFiles:e.gzipFiles,brotliFiles:e.brotliFiles,executionTime:e.executionTime},files:e.stats.map(o=>({file:o.file,originalSize:o.originalSize,compressedSize:o.compressedSize,ratio:o.ratio,algorithm:o.algorithm}))};await E(s,JSON.stringify(r,null,2))}async function P(i){const t=[...new Set(i.map(e=>e.file))];for(const e of t)try{await u.unlink(e)}catch{}}class $ extends z{allStats=[];summary=null;getDefaultOptions(){return{algorithm:"gzip",threshold:1024,deleteOriginalFile:!1,includeExtensions:[".js",".css",".html",".svg",".json",".xml",".txt"],excludeExtensions:[],excludePaths:[],compressionLevel:9,brotliQuality:11,reportOutput:"compress-report.json",parallelLimit:10}}validateOptions(){this.validator.field("algorithm").enum(["gzip","brotli","both"]).field("threshold").number().minValue(0).field("deleteOriginalFile").boolean().field("includeExtensions").array().field("excludeExtensions").array().field("excludePaths").array().field("compressionLevel").number().minValue(1).maxValue(9).field("brotliQuality").number().minValue(1).maxValue(11).field("reportOutput").custom(t=>t===!1||typeof t=="string","reportOutput \u5FC5\u987B\u4E3A false \u6216\u5B57\u7B26\u4E32\u8DEF\u5F84").field("parallelLimit").number().minValue(1).maxValue(50).validate()}getPluginName(){return"compress-assets"}getEnforce(){return"post"}addPluginHooks(t){t.writeBundle=async()=>{await this.safeExecute(()=>this.compressAllFiles(),"\u538B\u7F29\u6784\u5EFA\u4EA7\u7269")}}async compressAllFiles(){if(!this.viteConfig)return;const t=this.viteConfig.build.outDir,e=Date.now();this.logger.info(`\u5F00\u59CB\u626B\u63CF\u6784\u5EFA\u4EA7\u7269\u76EE\u5F55: ${t}`);const s=await A(t,this.options);if(s.length===0){this.logger.info("\u672A\u627E\u5230\u9700\u8981\u538B\u7F29\u7684\u6587\u4EF6");return}this.logger.info(`\u53D1\u73B0 ${s.length} \u4E2A\u5F85\u538B\u7F29\u6587\u4EF6`),this.allStats=[];const r=this.options.algorithm==="both"?["gzip","brotli"]:[this.options.algorithm];for(const l of r){const a=await w(s,async n=>C(n.filePath,l,this.options.compressionLevel,this.options.brotliQuality),this.options.parallelLimit);this.allStats.push(...a)}const o=Date.now()-e;this.summary=D(this.allStats,o),this.options.deleteOriginalFile&&(await P(this.allStats),this.logger.info("\u5DF2\u5220\u9664\u539F\u59CB\u6587\u4EF6\uFF0C\u4EC5\u4FDD\u7559\u538B\u7F29\u7248\u672C")),this.options.reportOutput&&(await v(t,this.options.reportOutput,this.summary),this.logger.info(`\u538B\u7F29\u62A5\u544A\u5DF2\u751F\u6210: ${this.options.reportOutput}`)),this.logSummary()}logSummary(){if(!this.summary)return;const{totalFiles:t,totalOriginalSize:e,totalCompressedSize:s,totalRatio:r,executionTime:o}=this.summary;this.logger.success(`\u538B\u7F29\u5B8C\u6210: ${t} \u4E2A\u6587\u4EF6`,`\u539F\u59CB\u4F53\u79EF: ${c(e)} \u2192 \u538B\u7F29\u540E: ${c(s)}\uFF0C\u538B\u7F29\u7387: ${r}%\uFF0C\u8017\u65F6: ${o}ms`);const l=[...this.allStats].sort((a,n)=>n.ratio-a.ratio).slice(0,5);if(l.length>0){this.logger.info("\u538B\u7F29\u7387 Top 5:");for(const a of l)this.logger.info(`  ${a.algorithm.toUpperCase().padEnd(6)} ${a.ratio}%  ${c(a.originalSize)} \u2192 ${c(a.compressedSize)}`)}}getStats(){return[...this.allStats]}getSummary(){return this.summary}}const L=d($);export{L as compressAssets};

package/dist/plugins/copyFile/index.cjs

@@ -0,0 +1 @@
+"use strict";const factory_index=require("../../factory/index.cjs"),common_fs_index=require("../../common/fs/index.cjs");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs"),require("fs"),require("path");class p extends factory_index.BasePlugin{getDefaultOptions(){return{overwrite:!0,recursive:!0,incremental:!0}}validateOptions(){this.validator.field("sourceDir").required().string().custom(e=>e.trim()!=="","sourceDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("targetDir").required().string().custom(e=>e.trim()!=="","targetDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("overwrite").boolean().field("recursive").boolean().field("incremental").boolean().validate()}getPluginName(){return"copy-file"}getEnforce(){return"post"}async copyFiles(){const{sourceDir:e,targetDir:u,overwrite:i=!0,recursive:t=!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 ${e} \u590D\u5236\u5230 ${u}`);return}await common_fs_index.checkSourceExists(e);const r=await common_fs_index.copySourceToTarget(e,u,{recursive:t,overwrite:i,incremental:s});this.logger.success(`\u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${u}`,`\u590D\u5236\u4E86 ${r.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${r.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${r.executionTime}ms`)}addPluginHooks(e){e.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u590D\u5236\u6587\u4EF6")}}}const copyFile=factory_index.createPluginFactory(p);exports.copyFile=copyFile;

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

@@ -0,0 +1,78 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.cjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.cjs';
+import '../../shared/vite-plugin.DRRlWY8P.cjs';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+interface CopyFileOptions extends BasePluginOptions {
+    /**
+     * 源文件目录的路径
+     *
+     * @example 'src/assets'
+     */
+    sourceDir: string;
+    /**
+     * 目标文件目录的路径
+     *
+     * @example 'dist/assets'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * 是否启用增量复制
+     *
+     * @default true
+     */
+    incremental?: boolean;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * copyFile({
+ *   sourceDir: 'src/assets',
+ *   targetDir: 'dist/assets'
+ * })
+ *
+ * // 高级配置
+ * copyFile({
+ *   sourceDir: 'src/static',
+ *   targetDir: 'dist/static',
+ *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
+ *   verbose: true,
+ *   errorStrategy: 'throw'
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
+ */
+declare const copyFile: PluginFactory<CopyFileOptions, CopyFileOptions>;
+
+export { copyFile };
+export type { CopyFileOptions };

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

@@ -0,0 +1,78 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.DRRlWY8P.mjs';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+interface CopyFileOptions extends BasePluginOptions {
+    /**
+     * 源文件目录的路径
+     *
+     * @example 'src/assets'
+     */
+    sourceDir: string;
+    /**
+     * 目标文件目录的路径
+     *
+     * @example 'dist/assets'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * 是否启用增量复制
+     *
+     * @default true
+     */
+    incremental?: boolean;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * copyFile({
+ *   sourceDir: 'src/assets',
+ *   targetDir: 'dist/assets'
+ * })
+ *
+ * // 高级配置
+ * copyFile({
+ *   sourceDir: 'src/static',
+ *   targetDir: 'dist/static',
+ *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
+ *   verbose: true,
+ *   errorStrategy: 'throw'
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
+ */
+declare const copyFile: PluginFactory<CopyFileOptions, CopyFileOptions>;
+
+export { copyFile };
+export type { CopyFileOptions };

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

@@ -0,0 +1,78 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.DRRlWY8P.js';
+
+/**
+ * 复制文件插件的配置选项接口
+ *
+ * @interface CopyFileOptions
+ */
+interface CopyFileOptions extends BasePluginOptions {
+    /**
+     * 源文件目录的路径
+     *
+     * @example 'src/assets'
+     */
+    sourceDir: string;
+    /**
+     * 目标文件目录的路径
+     *
+     * @example 'dist/assets'
+     */
+    targetDir: string;
+    /**
+     * 是否覆盖同名文件
+     *
+     * @default true
+     */
+    overwrite?: boolean;
+    /**
+     * 是否支持递归复制
+     *
+     * @default true
+     */
+    recursive?: boolean;
+    /**
+     * 是否启用增量复制
+     *
+     * @default true
+     */
+    incremental?: boolean;
+}
+
+/**
+ * 复制文件插件
+ *
+ * @param {CopyFileOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用
+ * copyFile({
+ *   sourceDir: 'src/assets',
+ *   targetDir: 'dist/assets'
+ * })
+ *
+ * // 高级配置
+ * copyFile({
+ *   sourceDir: 'src/static',
+ *   targetDir: 'dist/static',
+ *   overwrite: false,
+ *   recursive: true,
+ *   incremental: true,
+ *   enabled: true,
+ *   verbose: true,
+ *   errorStrategy: 'throw'
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件会在 Vite 构建完成后执行，将指定源目录的所有文件和子目录复制到目标目录。
+ * 支持增量复制、递归复制和覆盖控制等功能。
+ */
+declare const copyFile: PluginFactory<CopyFileOptions, CopyFileOptions>;
+
+export { copyFile };
+export type { CopyFileOptions };

package/dist/plugins/copyFile/index.mjs

@@ -0,0 +1 @@
+import{createPluginFactory as c,BasePlugin as n}from"../../factory/index.mjs";import{checkSourceExists as a,copySourceToTarget as l}from"../../common/fs/index.mjs";import"../../logger/index.mjs";import"../../common/object/index.mjs";import"../../shared/vite-plugin.DcExl6jd.mjs";import"fs";import"path";class F extends n{getDefaultOptions(){return{overwrite:!0,recursive:!0,incremental:!0}}validateOptions(){this.validator.field("sourceDir").required().string().custom(e=>e.trim()!=="","sourceDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("targetDir").required().string().custom(e=>e.trim()!=="","targetDir \u4E0D\u80FD\u4E3A\u7A7A\u5B57\u7B26\u4E32").field("overwrite").boolean().field("recursive").boolean().field("incremental").boolean().validate()}getPluginName(){return"copy-file"}getEnforce(){return"post"}async copyFiles(){const{sourceDir:e,targetDir:u,overwrite:t=!0,recursive:i=!0,incremental:o=!0,enabled:s=!0}=this.options;if(!s){this.logger.info(`\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6267\u884C\uFF1A\u4ECE ${e} \u590D\u5236\u5230 ${u}`);return}await a(e);const r=await l(e,u,{recursive:i,overwrite:t,incremental:o});this.logger.success(`\u590D\u5236\u6587\u4EF6\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${u}`,`\u590D\u5236\u4E86 ${r.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${r.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${r.executionTime}ms`)}addPluginHooks(e){e.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u590D\u5236\u6587\u4EF6")}}}const E=c(F);export{E as copyFile};

package/dist/plugins/faviconManager/index.cjs

@@ -0,0 +1 @@
+"use strict";const factory_index=require("../../factory/index.cjs"),common_fs_index=require("../../common/fs/index.cjs"),validator=require("../../shared/vite-plugin.Bcg6RW2N.cjs"),common_html_index=require("../../common/html/index.cjs");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("fs"),require("path");function generateIconTagDescriptors(u){const i=[];if(u.link)return[];if(u.icons&&u.icons.length>0)for(const e of u.icons){const t={rel:e.rel,href:e.href};e.sizes&&(t.sizes=e.sizes),e.type&&(t.type=e.type),i.push({tag:"link",attrs:t,injectTo:"head"})}else if(u.url)i.push({tag:"link",attrs:{rel:"icon",href:u.url},injectTo:"head"});else{const e=u.base||"/",t=e.endsWith("/")?`${e}favicon.ico`:`${e}/favicon.ico`;i.push({tag:"link",attrs:{rel:"icon",href:t},injectTo:"head"})}return i}class f extends factory_index.BasePlugin{getDefaultOptions(){return{base:"/"}}validateOptions(){this.validator.field("base").string().field("url").string().field("link").string().field("icons").array(),this.options?.copyOptions&&(this.validator.field("copyOptions").object(),new validator.Validator(this.options.copyOptions).field("sourceDir").required().string().field("targetDir").required().string().field("overwrite").boolean().field("recursive").boolean().validate()),this.validator.validate()}getPluginName(){return"favicon-manager"}getIconTagDescriptors(){if(!this.options.enabled)return this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),[];const i=generateIconTagDescriptors(this.options);return i.length>0&&this.logger.success(`\u6210\u529F\u6CE8\u5165 ${i.length} \u4E2A\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6`),i}injectCustomLinkTag(i){if(!this.options.enabled||!this.options.link)return i;const e=this.options.link,t=common_html_index.injectBeforeTag(i,"</head>",e);return t.injected?(this.logger.success("\u6210\u529F\u6CE8\u5165\u81EA\u5B9A\u4E49\u56FE\u6807\u6807\u7B7E\u5230 HTML \u6587\u4EF6"),this.logger.info(`  - ${e}`),t.html):(this.logger.warn("\u672A\u627E\u5230 </head> \u6807\u7B7E\uFF0C\u8DF3\u8FC7\u56FE\u6807\u6CE8\u5165"),i)}async copyFiles(){if(!this.options.enabled){this.logger.info("\u63D2\u4EF6\u5DF2\u7981\u7528\uFF0C\u8DF3\u8FC7\u6587\u4EF6\u590D\u5236");return}const{copyOptions:i}=this.options;if(!i)return;const{sourceDir:e,targetDir:t,overwrite:r=!0,recursive:n=!0}=i;await common_fs_index.checkSourceExists(e);const s=await common_fs_index.copySourceToTarget(e,t,{recursive:n,overwrite:r,incremental:!0});this.logger.success(`\u56FE\u6807\u6587\u4EF6\u590D\u5236\u6210\u529F\uFF1A\u4ECE ${e} \u5230 ${t}`,`\u590D\u5236\u4E86 ${s.copiedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8DF3\u8FC7\u4E86 ${s.skippedFiles} \u4E2A\u6587\u4EF6\uFF0C\u8017\u65F6 ${s.executionTime}ms`)}addPluginHooks(i){i.transformIndexHtml={order:"pre",handler:e=>{if(this.options.link)return this.injectCustomLinkTag(e);const t=this.getIconTagDescriptors();return t.length>0?{html:e,tags:t}:e}},i.writeBundle=async()=>{await this.safeExecute(()=>this.copyFiles(),"\u56FE\u6807\u6587\u4EF6\u590D\u5236")}}}const faviconManager=factory_index.createPluginFactory(f,u=>typeof u=="string"?{base:u}:u||{});exports.faviconManager=faviconManager;