@meng-xi/vite-plugin 0.1.0 → 0.1.1

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

@@ -0,0 +1,187 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.cjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.cjs';
+import '../../shared/vite-plugin.DRRlWY8P.cjs';
+
+/**
+ * 进度条显示格式类型
+ *
+ * @description
+ * - 'bar': 完整进度条模式，显示旋转动画 + 阶段标签 + 进度条 + 百分比 + 模块名
+ * - 'spinner': 旋转动画模式，显示旋转动画 + 阶段标签 + 百分比
+ * - 'minimal': 精简模式，仅显示阶段标签 + 百分比
+ */
+type ProgressFormat = 'bar' | 'spinner' | 'minimal';
+/**
+ * 构建进度插件的配置选项接口
+ *
+ * @interface BuildProgressOptions
+ */
+interface BuildProgressOptions extends BasePluginOptions {
+    /**
+     * 进度条宽度（字符数）
+     *
+     * @default 30
+     */
+    width?: number;
+    /**
+     * 进度条显示格式
+     *
+     * @default 'bar'
+     */
+    format?: ProgressFormat;
+    /**
+     * 已完成部分的填充字符
+     *
+     * @default '█'
+     * @example '█'、'■'、'='
+     */
+    completeChar?: string;
+    /**
+     * 未完成部分的填充字符
+     *
+     * @default '░'
+     * @example '░'、'□'、'-'
+     */
+    incompleteChar?: string;
+    /**
+     * 构建完成后是否清除进度条
+     *
+     * @default true
+     * @description 设为 false 时，构建完成后保留 100% 进度条在终端中
+     */
+    clearOnComplete?: boolean;
+    /**
+     * 是否显示当前正在处理的模块名称
+     *
+     * @default true
+     * @description 仅在 transform 阶段显示，模块名超长时自动截断
+     */
+    showModuleName?: boolean;
+    /**
+     * 自定义颜色主题
+     *
+     * @remarks
+     * 每个属性是一个接受字符串并返回带 ANSI 颜色码字符串的函数。
+     * 未提供的属性将使用默认主题。
+     */
+    theme?: ProgressTheme;
+}
+/**
+ * 进度条颜色主题接口
+ *
+ * @interface ProgressTheme
+ * @description 定义进度条各部分的颜色渲染函数，每个函数接受文本并返回带 ANSI 颜色码的字符串
+ */
+interface ProgressTheme {
+    /**
+     * 已完成部分的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    completeColor: (text: string) => string;
+    /**
+     * 未完成部分的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    incompleteColor: (text: string) => string;
+    /**
+     * 百分比数字的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    percentageColor: (text: string) => string;
+    /**
+     * 阶段标签的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    phaseColor: (text: string) => string;
+    /**
+     * 模块名称的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    moduleColor: (text: string) => string;
+}
+/**
+ * 构建阶段类型
+ *
+ * @description
+ * - 'idle': 空闲状态，插件尚未开始工作
+ * - 'config': 读取配置阶段
+ * - 'resolve': 解析模块依赖阶段
+ * - 'transform': 转换模块阶段
+ * - 'bundle': 打包阶段（仅生产构建）
+ * - 'write': 写入文件阶段
+ * - 'done': 构建完成
+ */
+type BuildPhase = 'idle' | 'config' | 'resolve' | 'transform' | 'bundle' | 'write' | 'done';
+
+/**
+ * 构建进度条插件
+ *
+ * @param {BuildProgressOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用 - 默认进度条格式
+ * buildProgress()
+ *
+ * // 旋转动画格式
+ * buildProgress({
+ *   format: 'spinner'
+ * })
+ *
+ * // 精简格式
+ * buildProgress({
+ *   format: 'minimal'
+ * })
+ *
+ * // 自定义进度条外观
+ * buildProgress({
+ *   width: 40,
+ *   completeChar: '■',
+ *   incompleteChar: '□',
+ *   clearOnComplete: false
+ * })
+ *
+ * // 自定义颜色主题
+ * buildProgress({
+ *   theme: {
+ *     completeColor: (t) => `\x1b[32m${t}\x1b[39m`,
+ *     incompleteColor: (t) => `\x1b[90m${t}\x1b[39m`,
+ *     percentageColor: (t) => `\x1b[1m${t}\x1b[22m`,
+ *     phaseColor: (t) => `\x1b[36m${t}\x1b[39m`,
+ *     moduleColor: (t) => `\x1b[90m${t}\x1b[39m`
+ *   }
+ * })
+ *
+ * // 禁用模块名显示
+ * buildProgress({
+ *   showModuleName: false
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件在 Vite 构建过程中实时显示终端进度条，支持三种显示格式：
+ * - bar: 完整进度条（默认），包含旋转动画、阶段标签、进度条和百分比
+ * - spinner: 旋转动画模式，仅显示动画、阶段标签和百分比
+ * - minimal: 精简模式，仅显示阶段标签和百分比
+ *
+ * 进度计算基于 Vite 构建生命周期：
+ * 1. config 阶段（5%）→ resolve 阶段（10%）→ transform 阶段（15%-85%）→ bundle 阶段（+10%）→ write 阶段（+5%）→ 完成（100%）
+ *
+ * 在非 TTY 终端环境下（如 CI/CD），自动降级为日志输出模式。
+ */
+declare const buildProgress: PluginFactory<BuildProgressOptions, BuildProgressOptions>;
+
+export { buildProgress };
+export type { BuildPhase, BuildProgressOptions, ProgressFormat, ProgressTheme };

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

@@ -0,0 +1,187 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.mjs';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.mjs';
+import '../../shared/vite-plugin.DRRlWY8P.mjs';
+
+/**
+ * 进度条显示格式类型
+ *
+ * @description
+ * - 'bar': 完整进度条模式，显示旋转动画 + 阶段标签 + 进度条 + 百分比 + 模块名
+ * - 'spinner': 旋转动画模式，显示旋转动画 + 阶段标签 + 百分比
+ * - 'minimal': 精简模式，仅显示阶段标签 + 百分比
+ */
+type ProgressFormat = 'bar' | 'spinner' | 'minimal';
+/**
+ * 构建进度插件的配置选项接口
+ *
+ * @interface BuildProgressOptions
+ */
+interface BuildProgressOptions extends BasePluginOptions {
+    /**
+     * 进度条宽度（字符数）
+     *
+     * @default 30
+     */
+    width?: number;
+    /**
+     * 进度条显示格式
+     *
+     * @default 'bar'
+     */
+    format?: ProgressFormat;
+    /**
+     * 已完成部分的填充字符
+     *
+     * @default '█'
+     * @example '█'、'■'、'='
+     */
+    completeChar?: string;
+    /**
+     * 未完成部分的填充字符
+     *
+     * @default '░'
+     * @example '░'、'□'、'-'
+     */
+    incompleteChar?: string;
+    /**
+     * 构建完成后是否清除进度条
+     *
+     * @default true
+     * @description 设为 false 时，构建完成后保留 100% 进度条在终端中
+     */
+    clearOnComplete?: boolean;
+    /**
+     * 是否显示当前正在处理的模块名称
+     *
+     * @default true
+     * @description 仅在 transform 阶段显示，模块名超长时自动截断
+     */
+    showModuleName?: boolean;
+    /**
+     * 自定义颜色主题
+     *
+     * @remarks
+     * 每个属性是一个接受字符串并返回带 ANSI 颜色码字符串的函数。
+     * 未提供的属性将使用默认主题。
+     */
+    theme?: ProgressTheme;
+}
+/**
+ * 进度条颜色主题接口
+ *
+ * @interface ProgressTheme
+ * @description 定义进度条各部分的颜色渲染函数，每个函数接受文本并返回带 ANSI 颜色码的字符串
+ */
+interface ProgressTheme {
+    /**
+     * 已完成部分的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    completeColor: (text: string) => string;
+    /**
+     * 未完成部分的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    incompleteColor: (text: string) => string;
+    /**
+     * 百分比数字的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    percentageColor: (text: string) => string;
+    /**
+     * 阶段标签的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    phaseColor: (text: string) => string;
+    /**
+     * 模块名称的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    moduleColor: (text: string) => string;
+}
+/**
+ * 构建阶段类型
+ *
+ * @description
+ * - 'idle': 空闲状态，插件尚未开始工作
+ * - 'config': 读取配置阶段
+ * - 'resolve': 解析模块依赖阶段
+ * - 'transform': 转换模块阶段
+ * - 'bundle': 打包阶段（仅生产构建）
+ * - 'write': 写入文件阶段
+ * - 'done': 构建完成
+ */
+type BuildPhase = 'idle' | 'config' | 'resolve' | 'transform' | 'bundle' | 'write' | 'done';
+
+/**
+ * 构建进度条插件
+ *
+ * @param {BuildProgressOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用 - 默认进度条格式
+ * buildProgress()
+ *
+ * // 旋转动画格式
+ * buildProgress({
+ *   format: 'spinner'
+ * })
+ *
+ * // 精简格式
+ * buildProgress({
+ *   format: 'minimal'
+ * })
+ *
+ * // 自定义进度条外观
+ * buildProgress({
+ *   width: 40,
+ *   completeChar: '■',
+ *   incompleteChar: '□',
+ *   clearOnComplete: false
+ * })
+ *
+ * // 自定义颜色主题
+ * buildProgress({
+ *   theme: {
+ *     completeColor: (t) => `\x1b[32m${t}\x1b[39m`,
+ *     incompleteColor: (t) => `\x1b[90m${t}\x1b[39m`,
+ *     percentageColor: (t) => `\x1b[1m${t}\x1b[22m`,
+ *     phaseColor: (t) => `\x1b[36m${t}\x1b[39m`,
+ *     moduleColor: (t) => `\x1b[90m${t}\x1b[39m`
+ *   }
+ * })
+ *
+ * // 禁用模块名显示
+ * buildProgress({
+ *   showModuleName: false
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件在 Vite 构建过程中实时显示终端进度条，支持三种显示格式：
+ * - bar: 完整进度条（默认），包含旋转动画、阶段标签、进度条和百分比
+ * - spinner: 旋转动画模式，仅显示动画、阶段标签和百分比
+ * - minimal: 精简模式，仅显示阶段标签和百分比
+ *
+ * 进度计算基于 Vite 构建生命周期：
+ * 1. config 阶段（5%）→ resolve 阶段（10%）→ transform 阶段（15%-85%）→ bundle 阶段（+10%）→ write 阶段（+5%）→ 完成（100%）
+ *
+ * 在非 TTY 终端环境下（如 CI/CD），自动降级为日志输出模式。
+ */
+declare const buildProgress: PluginFactory<BuildProgressOptions, BuildProgressOptions>;
+
+export { buildProgress };
+export type { BuildPhase, BuildProgressOptions, ProgressFormat, ProgressTheme };

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

@@ -0,0 +1,187 @@
+import { BasePluginOptions, PluginFactory } from '../../factory/index.js';
+import 'vite';
+import '../../shared/vite-plugin.CLr0ttuO.js';
+import '../../shared/vite-plugin.DRRlWY8P.js';
+
+/**
+ * 进度条显示格式类型
+ *
+ * @description
+ * - 'bar': 完整进度条模式，显示旋转动画 + 阶段标签 + 进度条 + 百分比 + 模块名
+ * - 'spinner': 旋转动画模式，显示旋转动画 + 阶段标签 + 百分比
+ * - 'minimal': 精简模式，仅显示阶段标签 + 百分比
+ */
+type ProgressFormat = 'bar' | 'spinner' | 'minimal';
+/**
+ * 构建进度插件的配置选项接口
+ *
+ * @interface BuildProgressOptions
+ */
+interface BuildProgressOptions extends BasePluginOptions {
+    /**
+     * 进度条宽度（字符数）
+     *
+     * @default 30
+     */
+    width?: number;
+    /**
+     * 进度条显示格式
+     *
+     * @default 'bar'
+     */
+    format?: ProgressFormat;
+    /**
+     * 已完成部分的填充字符
+     *
+     * @default '█'
+     * @example '█'、'■'、'='
+     */
+    completeChar?: string;
+    /**
+     * 未完成部分的填充字符
+     *
+     * @default '░'
+     * @example '░'、'□'、'-'
+     */
+    incompleteChar?: string;
+    /**
+     * 构建完成后是否清除进度条
+     *
+     * @default true
+     * @description 设为 false 时，构建完成后保留 100% 进度条在终端中
+     */
+    clearOnComplete?: boolean;
+    /**
+     * 是否显示当前正在处理的模块名称
+     *
+     * @default true
+     * @description 仅在 transform 阶段显示，模块名超长时自动截断
+     */
+    showModuleName?: boolean;
+    /**
+     * 自定义颜色主题
+     *
+     * @remarks
+     * 每个属性是一个接受字符串并返回带 ANSI 颜色码字符串的函数。
+     * 未提供的属性将使用默认主题。
+     */
+    theme?: ProgressTheme;
+}
+/**
+ * 进度条颜色主题接口
+ *
+ * @interface ProgressTheme
+ * @description 定义进度条各部分的颜色渲染函数，每个函数接受文本并返回带 ANSI 颜色码的字符串
+ */
+interface ProgressTheme {
+    /**
+     * 已完成部分的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    completeColor: (text: string) => string;
+    /**
+     * 未完成部分的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    incompleteColor: (text: string) => string;
+    /**
+     * 百分比数字的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    percentageColor: (text: string) => string;
+    /**
+     * 阶段标签的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    phaseColor: (text: string) => string;
+    /**
+     * 模块名称的颜色渲染函数
+     *
+     * @param text - 需要着色的文本
+     * @returns 带 ANSI 颜色码的字符串
+     */
+    moduleColor: (text: string) => string;
+}
+/**
+ * 构建阶段类型
+ *
+ * @description
+ * - 'idle': 空闲状态，插件尚未开始工作
+ * - 'config': 读取配置阶段
+ * - 'resolve': 解析模块依赖阶段
+ * - 'transform': 转换模块阶段
+ * - 'bundle': 打包阶段（仅生产构建）
+ * - 'write': 写入文件阶段
+ * - 'done': 构建完成
+ */
+type BuildPhase = 'idle' | 'config' | 'resolve' | 'transform' | 'bundle' | 'write' | 'done';
+
+/**
+ * 构建进度条插件
+ *
+ * @param {BuildProgressOptions} options - 插件配置选项
+ * @returns {Plugin} 一个 Vite 插件实例
+ *
+ * @example
+ * ```typescript
+ * // 基本使用 - 默认进度条格式
+ * buildProgress()
+ *
+ * // 旋转动画格式
+ * buildProgress({
+ *   format: 'spinner'
+ * })
+ *
+ * // 精简格式
+ * buildProgress({
+ *   format: 'minimal'
+ * })
+ *
+ * // 自定义进度条外观
+ * buildProgress({
+ *   width: 40,
+ *   completeChar: '■',
+ *   incompleteChar: '□',
+ *   clearOnComplete: false
+ * })
+ *
+ * // 自定义颜色主题
+ * buildProgress({
+ *   theme: {
+ *     completeColor: (t) => `\x1b[32m${t}\x1b[39m`,
+ *     incompleteColor: (t) => `\x1b[90m${t}\x1b[39m`,
+ *     percentageColor: (t) => `\x1b[1m${t}\x1b[22m`,
+ *     phaseColor: (t) => `\x1b[36m${t}\x1b[39m`,
+ *     moduleColor: (t) => `\x1b[90m${t}\x1b[39m`
+ *   }
+ * })
+ *
+ * // 禁用模块名显示
+ * buildProgress({
+ *   showModuleName: false
+ * })
+ * ```
+ *
+ * @remarks
+ * 该插件在 Vite 构建过程中实时显示终端进度条，支持三种显示格式：
+ * - bar: 完整进度条（默认），包含旋转动画、阶段标签、进度条和百分比
+ * - spinner: 旋转动画模式，仅显示动画、阶段标签和百分比
+ * - minimal: 精简模式，仅显示阶段标签和百分比
+ *
+ * 进度计算基于 Vite 构建生命周期：
+ * 1. config 阶段（5%）→ resolve 阶段（10%）→ transform 阶段（15%-85%）→ bundle 阶段（+10%）→ write 阶段（+5%）→ 完成（100%）
+ *
+ * 在非 TTY 终端环境下（如 CI/CD），自动降级为日志输出模式。
+ */
+declare const buildProgress: PluginFactory<BuildProgressOptions, BuildProgressOptions>;
+
+export { buildProgress };
+export type { BuildPhase, BuildProgressOptions, ProgressFormat, ProgressTheme };

package/dist/plugins/buildProgress/index.mjs

@@ -0,0 +1,2 @@
+import{createPluginFactory as c,BasePlugin as m}from"../../factory/index.mjs";import"../../logger/index.mjs";import"../../common/object/index.mjs";import"../../shared/vite-plugin.DcExl6jd.mjs";const h=process.platform==="win32"?["|","/","-","\\"]:["\u280B","\u2819","\u2839","\u2838","\u283C","\u2834","\u2826","\u2827","\u2807","\u280F"],s={reset:"\x1B[0G",clearLine:"\x1B[2K",hideCursor:"\x1B[?25l",showCursor:"\x1B[?25h",green:o=>`\x1B[32m${o}\x1B[39m`,cyan:o=>`\x1B[36m${o}\x1B[39m`,gray:o=>`\x1B[90m${o}\x1B[39m`,bold:o=>`\x1B[1m${o}\x1B[22m`},d={completeColor:s.green,incompleteColor:s.gray,percentageColor:s.bold,phaseColor:s.cyan,moduleColor:s.gray},f={idle:"\u7B49\u5F85\u4E2D",config:"\u8BFB\u53D6\u914D\u7F6E",resolve:"\u89E3\u6790\u6A21\u5757",transform:"\u8F6C\u6362\u6A21\u5757",bundle:"\u6253\u5305\u4E2D",write:"\u5199\u5165\u6587\u4EF6",done:"\u6784\u5EFA\u5B8C\u6210"};class u extends m{totalModules=0;transformedModules=0;currentModule="";phase="idle";spinnerIndex=0;spinnerTimer=null;isDev=!1;theme=d;lastPercentage=0;static ANSI_REGEX=/\x1b\[[0-9;]*m/g;static stripAnsi(e){return e.replace(u.ANSI_REGEX,"")}getDefaultOptions(){return{width:30,format:"bar",completeChar:"\u2588",incompleteChar:"\u2591",clearOnComplete:!0,showModuleName:!0}}validateOptions(){this.validator.field("width").number().minValue(1).field("format").enum(["bar","spinner","minimal"]).field("completeChar").string().field("incompleteChar").string().field("clearOnComplete").boolean().field("showModuleName").boolean().validate()}getPluginName(){return"build-progress"}onConfigResolved(e){super.onConfigResolved(e),this.theme=this.options.theme||d}getPercentage(){if(this.phase==="done")return this.lastPercentage=100;if(this.phase==="config")return this.lastPercentage=5;if(this.phase==="resolve")return this.lastPercentage=10;if(this.totalModules===0)return this.lastPercentage=15;const e=Math.min(this.transformedModules/this.totalModules*70,70),t=this.phase==="bundle"?10:0,r=this.phase==="write"?5:0,n=Math.min(Math.floor(15+e+t+r),99);return this.lastPercentage=Math.max(n,this.lastPercentage),this.lastPercentage}renderBar(e){const t=this.options.width||30,r=this.options.completeChar||"\u2588",n=this.options.incompleteChar||"\u2591",i=Math.round(e/100*t),l=t-i;return this.theme.completeColor(r.repeat(i))+this.theme.incompleteColor(n.repeat(l))}renderSpinner(){const e=h[this.spinnerIndex%h.length];return this.spinnerIndex++,this.theme.phaseColor(e)}render(e){const t=this.options.format||"bar",r=this.theme.phaseColor(f[this.phase]),n=this.theme.percentageColor(`${e}%`);let i="";if(t==="bar"?i=`${this.renderSpinner()} ${r} ${this.renderBar(e)} ${n}`:t==="spinner"?i=`${this.renderSpinner()} ${r} ${n}`:i=`${r} ${n}`,this.options.showModuleName&&this.currentModule&&this.phase==="transform"){const l=u.stripAnsi(i).length,a=Math.max((process.stdout.columns||80)-l-3,20),p=this.currentModule.length>a?"..."+this.currentModule.slice(-a+3):this.currentModule;i+=` ${this.theme.moduleColor(p)}`}return i}update(){if(!process.stdout.isTTY)return;const e=this.getPercentage(),t=this.render(e);this.safeExecuteSync(()=>{process.stdout.write(s.clearLine+s.reset+t)},"\u66F4\u65B0\u8FDB\u5EA6\u663E\u793A")}startSpinner(){this.spinnerTimer||process.stdout.isTTY&&(this.spinnerTimer=setInterval(()=>this.update(),80))}stopSpinner(){this.spinnerTimer&&(clearInterval(this.spinnerTimer),this.spinnerTimer=null)}complete(){if(this.phase="done",this.stopSpinner(),!process.stdout.isTTY){this.logger.success("\u6784\u5EFA\u5B8C\u6210");return}if(this.options.clearOnComplete)this.safeExecuteSync(()=>{process.stdout.write(s.clearLine+s.reset)},"\u6E05\u9664\u8FDB\u5EA6\u884C");else{const e=this.render(100);this.safeExecuteSync(()=>{process.stdout.write(s.clearLine+s.reset+e+`
+`)},"\u8F93\u51FA\u5B8C\u6210\u8FDB\u5EA6")}this.safeExecuteSync(()=>{process.stdout.write(s.showCursor)},"\u6062\u590D\u5149\u6807\u663E\u793A")}addPluginHooks(e){e.config=(t,{command:r})=>(this.isDev=r==="serve",null),e.configResolved=()=>{this.options.enabled&&(this.phase="config",process.stdout.isTTY&&this.safeExecuteSync(()=>{process.stdout.write(s.hideCursor)},"\u9690\u85CF\u5149\u6807"),this.startSpinner())},e.buildStart=()=>{this.options.enabled&&(this.phase="resolve",this.totalModules=0,this.transformedModules=0)},e.resolveId={handler:t=>{this.options.enabled&&(t.includes("node_modules")||t.includes(".virtual")||this.totalModules++)}},e.transform={handler:(t,r)=>{this.options.enabled&&(r.includes("node_modules")||r.includes(".virtual")||(this.phase="transform",this.transformedModules++,this.currentModule=r))}},e.writeBundle=()=>{this.options.enabled&&(this.phase="write",this.update())},e.closeBundle=()=>{this.options.enabled&&this.complete()},e.buildEnd=()=>{this.options.enabled&&(this.isDev||(this.phase="bundle",this.update()))},e.configureServer=()=>{this.options.enabled&&this.isDev&&this.complete()}}destroy(){super.destroy(),this.stopSpinner(),process.stdout.isTTY&&this.safeExecuteSync(()=>{process.stdout.write(s.showCursor)},"\u6062\u590D\u5149\u6807\u663E\u793A")}}const g=c(u);export{g as buildProgress};

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 };