@meng-xi/vite-plugin 0.0.9 → 0.1.1

package/dist/common/validation/index.d.cts

@@ -0,0 +1,93 @@
+export { V as Validator } from '../../shared/vite-plugin.DRRlWY8P.cjs';
+
+/**
+ * 验证全局变量名的合法性（包装 validateIdentifierName，附加字段上下文信息）
+ *
+ * @param name - 全局变量名
+ * @param fieldName - 字段名称，用于错误消息上下文（如 'globalName'、'defineName'）
+ * @throws 当名称不合法时抛出带字段上下文的错误
+ *
+ * @example
+ * ```typescript
+ * validateGlobalName('__LOADING_MANAGER__', 'globalName')
+ * validateGlobalName('__APP_VERSION__', 'defineName')
+ * ```
+ */
+declare function validateGlobalName(name: string | undefined, fieldName: string): void;
+/**
+ * 验证模板字符串不包含 script 标签（XSS 防护）
+ *
+ * @param template - 模板字符串
+ * @param fieldName - 字段名称，用于错误消息上下文
+ * @throws 当模板包含 `<script>` 标签时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNoScriptInTemplate('<div>safe</div>', 'customTemplate')
+ * validateNoScriptInTemplate(options.customPromptTemplate, 'customPromptTemplate')
+ * ```
+ */
+declare function validateNoScriptInTemplate(template: string | undefined, fieldName: string): void;
+/**
+ * 验证回调字段不包含 script 标签
+ *
+ * @param callbacks - 回调配置对象
+ * @param fields - 需要验证的回调字段名数组
+ * @param objectName - 回调所属对象名称，用于错误消息上下文
+ * @throws 当回调字段非字符串类型时抛出错误
+ * @throws 当回调字符串包含 `<script>` 标签时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateCallbackFields(callbacks, ['onShow', 'onHide'], 'callbacks')
+ * validateCallbackFields(options, ['onUpdateAvailable', 'onRefresh'], 'callbacks')
+ * ```
+ */
+declare function validateCallbackFields(callbacks: Record<string, any>, fields: string[], objectName: string): void;
+/**
+ * 验证数值为非负数
+ *
+ * @param value - 待验证的数值
+ * @param fieldName - 字段名称，用于错误消息
+ * @throws 当值存在但不是数字或为负数时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNonNegativeNumber(100, 'zIndex')
+ * validateNonNegativeNumber(-1, 'duration') // 抛出错误
+ * ```
+ */
+declare function validateNonNegativeNumber(value: number | undefined, fieldName: string): void;
+/**
+ * 验证嵌套配置项的 duration 合法性
+ *
+ * @param config - 嵌套配置对象（包含 enabled 和 duration 字段）
+ * @param errorMsg - 验证失败时的错误提示信息
+ * @throws 当 duration 存在但不是非负数时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNestedDuration({ enabled: true, duration: 300 }, 'minDisplayTime.duration 必须是非负数')
+ * ```
+ */
+declare function validateNestedDuration(config: {
+    enabled?: boolean;
+    duration?: number;
+} | undefined, errorMsg: string): void;
+/**
+ * 验证字符串值是否在允许的枚举列表中
+ *
+ * @param value - 待验证的值
+ * @param allowedValues - 允许的值列表
+ * @param fieldName - 字段名称，用于错误消息
+ * @throws 当值存在但不在允许列表中时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateEnumValue('center', ['center', 'top', 'bottom'], 'position')
+ * validateEnumValue('modal', ['modal', 'banner', 'toast'], 'promptStyle')
+ * ```
+ */
+declare function validateEnumValue(value: string | undefined, allowedValues: string[], fieldName: string): void;
+
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber };

package/dist/common/validation/index.d.mts

@@ -0,0 +1,93 @@
+export { V as Validator } from '../../shared/vite-plugin.DRRlWY8P.mjs';
+
+/**
+ * 验证全局变量名的合法性（包装 validateIdentifierName，附加字段上下文信息）
+ *
+ * @param name - 全局变量名
+ * @param fieldName - 字段名称，用于错误消息上下文（如 'globalName'、'defineName'）
+ * @throws 当名称不合法时抛出带字段上下文的错误
+ *
+ * @example
+ * ```typescript
+ * validateGlobalName('__LOADING_MANAGER__', 'globalName')
+ * validateGlobalName('__APP_VERSION__', 'defineName')
+ * ```
+ */
+declare function validateGlobalName(name: string | undefined, fieldName: string): void;
+/**
+ * 验证模板字符串不包含 script 标签（XSS 防护）
+ *
+ * @param template - 模板字符串
+ * @param fieldName - 字段名称，用于错误消息上下文
+ * @throws 当模板包含 `<script>` 标签时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNoScriptInTemplate('<div>safe</div>', 'customTemplate')
+ * validateNoScriptInTemplate(options.customPromptTemplate, 'customPromptTemplate')
+ * ```
+ */
+declare function validateNoScriptInTemplate(template: string | undefined, fieldName: string): void;
+/**
+ * 验证回调字段不包含 script 标签
+ *
+ * @param callbacks - 回调配置对象
+ * @param fields - 需要验证的回调字段名数组
+ * @param objectName - 回调所属对象名称，用于错误消息上下文
+ * @throws 当回调字段非字符串类型时抛出错误
+ * @throws 当回调字符串包含 `<script>` 标签时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateCallbackFields(callbacks, ['onShow', 'onHide'], 'callbacks')
+ * validateCallbackFields(options, ['onUpdateAvailable', 'onRefresh'], 'callbacks')
+ * ```
+ */
+declare function validateCallbackFields(callbacks: Record<string, any>, fields: string[], objectName: string): void;
+/**
+ * 验证数值为非负数
+ *
+ * @param value - 待验证的数值
+ * @param fieldName - 字段名称，用于错误消息
+ * @throws 当值存在但不是数字或为负数时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNonNegativeNumber(100, 'zIndex')
+ * validateNonNegativeNumber(-1, 'duration') // 抛出错误
+ * ```
+ */
+declare function validateNonNegativeNumber(value: number | undefined, fieldName: string): void;
+/**
+ * 验证嵌套配置项的 duration 合法性
+ *
+ * @param config - 嵌套配置对象（包含 enabled 和 duration 字段）
+ * @param errorMsg - 验证失败时的错误提示信息
+ * @throws 当 duration 存在但不是非负数时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNestedDuration({ enabled: true, duration: 300 }, 'minDisplayTime.duration 必须是非负数')
+ * ```
+ */
+declare function validateNestedDuration(config: {
+    enabled?: boolean;
+    duration?: number;
+} | undefined, errorMsg: string): void;
+/**
+ * 验证字符串值是否在允许的枚举列表中
+ *
+ * @param value - 待验证的值
+ * @param allowedValues - 允许的值列表
+ * @param fieldName - 字段名称，用于错误消息
+ * @throws 当值存在但不在允许列表中时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateEnumValue('center', ['center', 'top', 'bottom'], 'position')
+ * validateEnumValue('modal', ['modal', 'banner', 'toast'], 'promptStyle')
+ * ```
+ */
+declare function validateEnumValue(value: string | undefined, allowedValues: string[], fieldName: string): void;
+
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber };

package/dist/common/validation/index.d.ts

@@ -0,0 +1,93 @@
+export { V as Validator } from '../../shared/vite-plugin.DRRlWY8P.js';
+
+/**
+ * 验证全局变量名的合法性（包装 validateIdentifierName，附加字段上下文信息）
+ *
+ * @param name - 全局变量名
+ * @param fieldName - 字段名称，用于错误消息上下文（如 'globalName'、'defineName'）
+ * @throws 当名称不合法时抛出带字段上下文的错误
+ *
+ * @example
+ * ```typescript
+ * validateGlobalName('__LOADING_MANAGER__', 'globalName')
+ * validateGlobalName('__APP_VERSION__', 'defineName')
+ * ```
+ */
+declare function validateGlobalName(name: string | undefined, fieldName: string): void;
+/**
+ * 验证模板字符串不包含 script 标签（XSS 防护）
+ *
+ * @param template - 模板字符串
+ * @param fieldName - 字段名称，用于错误消息上下文
+ * @throws 当模板包含 `<script>` 标签时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNoScriptInTemplate('<div>safe</div>', 'customTemplate')
+ * validateNoScriptInTemplate(options.customPromptTemplate, 'customPromptTemplate')
+ * ```
+ */
+declare function validateNoScriptInTemplate(template: string | undefined, fieldName: string): void;
+/**
+ * 验证回调字段不包含 script 标签
+ *
+ * @param callbacks - 回调配置对象
+ * @param fields - 需要验证的回调字段名数组
+ * @param objectName - 回调所属对象名称，用于错误消息上下文
+ * @throws 当回调字段非字符串类型时抛出错误
+ * @throws 当回调字符串包含 `<script>` 标签时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateCallbackFields(callbacks, ['onShow', 'onHide'], 'callbacks')
+ * validateCallbackFields(options, ['onUpdateAvailable', 'onRefresh'], 'callbacks')
+ * ```
+ */
+declare function validateCallbackFields(callbacks: Record<string, any>, fields: string[], objectName: string): void;
+/**
+ * 验证数值为非负数
+ *
+ * @param value - 待验证的数值
+ * @param fieldName - 字段名称，用于错误消息
+ * @throws 当值存在但不是数字或为负数时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNonNegativeNumber(100, 'zIndex')
+ * validateNonNegativeNumber(-1, 'duration') // 抛出错误
+ * ```
+ */
+declare function validateNonNegativeNumber(value: number | undefined, fieldName: string): void;
+/**
+ * 验证嵌套配置项的 duration 合法性
+ *
+ * @param config - 嵌套配置对象（包含 enabled 和 duration 字段）
+ * @param errorMsg - 验证失败时的错误提示信息
+ * @throws 当 duration 存在但不是非负数时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateNestedDuration({ enabled: true, duration: 300 }, 'minDisplayTime.duration 必须是非负数')
+ * ```
+ */
+declare function validateNestedDuration(config: {
+    enabled?: boolean;
+    duration?: number;
+} | undefined, errorMsg: string): void;
+/**
+ * 验证字符串值是否在允许的枚举列表中
+ *
+ * @param value - 待验证的值
+ * @param allowedValues - 允许的值列表
+ * @param fieldName - 字段名称，用于错误消息
+ * @throws 当值存在但不在允许列表中时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateEnumValue('center', ['center', 'top', 'bottom'], 'position')
+ * validateEnumValue('modal', ['modal', 'banner', 'toast'], 'promptStyle')
+ * ```
+ */
+declare function validateEnumValue(value: string | undefined, allowedValues: string[], fieldName: string): void;
+
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber };

package/dist/common/validation/index.mjs

@@ -0,0 +1 @@
+export{V as Validator}from"../../shared/vite-plugin.DcExl6jd.mjs";import{containsScriptTag as e,validateIdentifierName as n}from"../script/index.mjs";function a(u,t){if(u)try{n(u)}catch(o){throw new Error(`${t} ${o.message}`)}}function f(u,t){if(u&&e(u))throw new Error(`${t} \u4E0D\u5141\u8BB8\u5305\u542B <script> \u6807\u7B7E`)}function d(u,t,o){for(const i of t){const r=u[i];if(r!==void 0&&typeof r!="string")throw new Error(`${o}.${i} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32\u7C7B\u578B`);if(r&&e(r))throw new Error(`${o}.${i} \u4E0D\u5141\u8BB8\u5305\u542B <script> \u6807\u7B7E`)}}function c(u,t){if(u!==void 0&&(typeof u!="number"||u<0))throw new Error(`${t} \u5FC5\u987B\u662F\u975E\u8D1F\u6570`)}function l(u,t){if(u?.duration!==void 0&&(typeof u.duration!="number"||u.duration<0))throw new Error(t)}function B(u,t,o){if(u&&!t.includes(u))throw new Error(`${o} \u5FC5\u987B\u662F ${t.join(", ")}`)}export{d as validateCallbackFields,B as validateEnumValue,a as validateGlobalName,l as validateNestedDuration,f as validateNoScriptInTemplate,c as validateNonNegativeNumber};

package/dist/factory/index.cjs

@@ -1 +1 @@
-"use strict";const index=require("../shared/vite-plugin.CawoITTT.cjs");require("../logger/index.cjs"),require("fs"),require("path"),require("crypto"),require("../shared/vite-plugin.IGZeStMa.cjs"),exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory;
+"use strict";const logger_index=require("../logger/index.cjs"),common_object_index=require("../common/object/index.cjs"),validator=require("../shared/vite-plugin.Bcg6RW2N.cjs");class BasePlugin{options;logger;validator;viteConfig=null;constructor(e,o){this.options=this.mergeOptions(e),this.logger=this.initLogger(o),this.validator=new validator.Validator(this.options),this.safeExecuteSync(()=>this.validateOptions(),"\u63D2\u4EF6\u914D\u7F6E\u9A8C\u8BC1")}getDefaultOptions(){return{}}mergeOptions(e){const o={enabled:!0,verbose:!0,errorStrategy:"throw"},t=this.getDefaultOptions();return common_object_index.deepMerge(o,t,e)}initLogger(e){return logger_index.Logger.create({name:this.getPluginName(),enabled:this.options.verbose,...e}).createPluginLogger(this.getPluginName())}validateOptions(){}getEnforce(){}onConfigResolved(e){this.viteConfig=e,this.logger.info("\u914D\u7F6E\u89E3\u6790\u5B8C\u6210\uFF0C\u63D2\u4EF6\u5DF2\u521D\u59CB\u5316")}destroy(){logger_index.Logger.unregister(this.getPluginName())}safeExecuteSync(e,o){try{return e()}catch(t){return this.handleError(t,o)}}async safeExecute(e,o){try{return await e()}catch(t){return this.handleError(t,o)}}handleError(e,o){let t=`${o}: `;switch(e instanceof Error?t+=e.message:typeof e=="string"?t+=e:t+=String(e),this.options.errorStrategy){case"throw":throw this.logger.error(t),e;case"log":case"ignore":this.logger.error(t);return;default:throw this.logger.error(t),e}}toPlugin(){const e={name:this.getPluginName(),enforce:this.getEnforce()};this.addPluginHooks(e);const o=e.configResolved;e.configResolved=n=>{this.options.enabled&&(this.onConfigResolved(n),typeof o=="function"&&o(n))};const t=this,r=e.closeBundle;return e.closeBundle=function(){typeof r=="function"&&r.call(this),t.destroy()},e}}function createPluginFactory(i,e){return o=>{const t=e?e(o):o,r=new i(t),n=r.toPlugin();return n.pluginInstance=r,n}}exports.BasePlugin=BasePlugin,exports.createPluginFactory=createPluginFactory;

package/dist/factory/index.d.cts

@@ -1,6 +1,6 @@
 import { Plugin, ResolvedConfig } from 'vite';
 import { P as PluginLogger, a as LoggerOptions } from '../shared/vite-plugin.CLr0ttuO.cjs';
-import { V as Validator } from '../shared/vite-plugin.CiHfwMiN.cjs';
+import { V as Validator } from '../shared/vite-plugin.DRRlWY8P.cjs';
 
 /**
  * 带插件实例引用的 Vite 插件类型

package/dist/factory/index.d.mts

@@ -1,6 +1,6 @@
 import { Plugin, ResolvedConfig } from 'vite';
 import { P as PluginLogger, a as LoggerOptions } from '../shared/vite-plugin.CLr0ttuO.mjs';
-import { V as Validator } from '../shared/vite-plugin.CiHfwMiN.mjs';
+import { V as Validator } from '../shared/vite-plugin.DRRlWY8P.mjs';
 
 /**
  * 带插件实例引用的 Vite 插件类型

package/dist/factory/index.d.ts

@@ -1,6 +1,6 @@
 import { Plugin, ResolvedConfig } from 'vite';
 import { P as PluginLogger, a as LoggerOptions } from '../shared/vite-plugin.CLr0ttuO.js';
-import { V as Validator } from '../shared/vite-plugin.CiHfwMiN.js';
+import { V as Validator } from '../shared/vite-plugin.DRRlWY8P.js';
 
 /**
  * 带插件实例引用的 Vite 插件类型

package/dist/factory/index.mjs

@@ -1 +1 @@
-export{B as BasePlugin,c as createPluginFactory}from"../shared/vite-plugin.DSb6XzBn.mjs";import"../logger/index.mjs";import"fs";import"path";import"crypto";import"../shared/vite-plugin.B88RyRN8.mjs";
+import{Logger as s}from"../logger/index.mjs";import{deepMerge as u}from"../common/object/index.mjs";import{V as g}from"../shared/vite-plugin.DcExl6jd.mjs";class a{options;logger;validator;viteConfig=null;constructor(t,o){this.options=this.mergeOptions(t),this.logger=this.initLogger(o),this.validator=new g(this.options),this.safeExecuteSync(()=>this.validateOptions(),"\u63D2\u4EF6\u914D\u7F6E\u9A8C\u8BC1")}getDefaultOptions(){return{}}mergeOptions(t){const o={enabled:!0,verbose:!0,errorStrategy:"throw"},e=this.getDefaultOptions();return u(o,e,t)}initLogger(t){return s.create({name:this.getPluginName(),enabled:this.options.verbose,...t}).createPluginLogger(this.getPluginName())}validateOptions(){}getEnforce(){}onConfigResolved(t){this.viteConfig=t,this.logger.info("\u914D\u7F6E\u89E3\u6790\u5B8C\u6210\uFF0C\u63D2\u4EF6\u5DF2\u521D\u59CB\u5316")}destroy(){s.unregister(this.getPluginName())}safeExecuteSync(t,o){try{return t()}catch(e){return this.handleError(e,o)}}async safeExecute(t,o){try{return await t()}catch(e){return this.handleError(e,o)}}handleError(t,o){let e=`${o}: `;switch(t instanceof Error?e+=t.message:typeof t=="string"?e+=t:e+=String(t),this.options.errorStrategy){case"throw":throw this.logger.error(e),t;case"log":case"ignore":this.logger.error(e);return;default:throw this.logger.error(e),t}}toPlugin(){const t={name:this.getPluginName(),enforce:this.getEnforce()};this.addPluginHooks(t);const o=t.configResolved;t.configResolved=n=>{this.options.enabled&&(this.onConfigResolved(n),typeof o=="function"&&o(n))};const e=this,r=t.closeBundle;return t.closeBundle=function(){typeof r=="function"&&r.call(this),e.destroy()},t}}function l(i,t){return o=>{const e=t?t(o):o,r=new i(e),n=r.toPlugin();return n.pluginInstance=r,n}}export{a as BasePlugin,l as createPluginFactory};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";const format=require("./shared/vite-plugin.Ba9646wL.cjs"),validation=require("./shared/vite-plugin.IGZeStMa.cjs"),index=require("./shared/vite-plugin.CawoITTT.cjs"),logger_index=require("./logger/index.cjs"),index$1=require("./shared/vite-plugin.CsdNNQ-4.cjs");require("fs"),require("path"),require("crypto"),exports.checkSourceExists=format.checkSourceExists,exports.copySourceToTarget=format.copySourceToTarget,exports.ensureTargetDir=format.ensureTargetDir,exports.fileExists=format.fileExists,exports.formatDate=format.formatDate,exports.generateRandomHash=format.generateRandomHash,exports.getDateFormatParams=format.getDateFormatParams,exports.padNumber=format.padNumber,exports.parseTemplate=format.parseTemplate,exports.readDirRecursive=format.readDirRecursive,exports.readFileContent=format.readFileContent,exports.readFileSync=format.readFileSync,exports.runWithConcurrency=format.runWithConcurrency,exports.shouldUpdateFile=format.shouldUpdateFile,exports.stripJsonComments=format.stripJsonComments,exports.toCamelCase=format.toCamelCase,exports.toPascalCase=format.toPascalCase,exports.writeFileContent=format.writeFileContent,exports.Validator=validation.Validator,exports.deepMerge=validation.deepMerge,exports.BasePlugin=index.BasePlugin,exports.createPluginFactory=index.createPluginFactory,exports.Logger=logger_index.Logger,exports.buildProgress=index$1.buildProgress,exports.copyFile=index$1.copyFile,exports.generateRouter=index$1.generateRouter,exports.generateVersion=index$1.generateVersion,exports.injectIco=index$1.injectIco,exports.injectLoading=index$1.injectLoading;
+"use strict";const common_fs_index=require("./common/fs/index.cjs"),common_format_index=require("./common/format/index.cjs"),common_html_index=require("./common/html/index.cjs"),common_object_index=require("./common/object/index.cjs"),common_script_index=require("./common/script/index.cjs"),validator=require("./shared/vite-plugin.Bcg6RW2N.cjs"),common_validation_index=require("./common/validation/index.cjs"),factory_index=require("./factory/index.cjs"),logger_index=require("./logger/index.cjs"),plugins_buildProgress_index=require("./plugins/buildProgress/index.cjs"),plugins_copyFile_index=require("./plugins/copyFile/index.cjs"),plugins_faviconManager_index=require("./plugins/faviconManager/index.cjs"),plugins_generateRouter_index=require("./plugins/generateRouter/index.cjs"),plugins_generateVersion_index=require("./plugins/generateVersion/index.cjs"),plugins_htmlInject_index=require("./plugins/htmlInject/index.cjs"),plugins_loadingManager_index=require("./plugins/loadingManager/index.cjs"),plugins_versionUpdateChecker_index=require("./plugins/versionUpdateChecker/index.cjs");require("fs"),require("path"),require("crypto"),require("node:path"),exports.checkSourceExists=common_fs_index.checkSourceExists,exports.copySourceToTarget=common_fs_index.copySourceToTarget,exports.ensureTargetDir=common_fs_index.ensureTargetDir,exports.fileExists=common_fs_index.fileExists,exports.readDirRecursive=common_fs_index.readDirRecursive,exports.readFileContent=common_fs_index.readFileContent,exports.readFileSync=common_fs_index.readFileSync,exports.runWithConcurrency=common_fs_index.runWithConcurrency,exports.shouldUpdateFile=common_fs_index.shouldUpdateFile,exports.writeFileContent=common_fs_index.writeFileContent,exports.escapeHtmlAttr=common_format_index.escapeHtmlAttr,exports.formatDate=common_format_index.formatDate,exports.generateRandomHash=common_format_index.generateRandomHash,exports.getDateFormatParams=common_format_index.getDateFormatParams,exports.padNumber=common_format_index.padNumber,exports.parseTemplate=common_format_index.parseTemplate,exports.stripJsonComments=common_format_index.stripJsonComments,exports.toCamelCase=common_format_index.toCamelCase,exports.toPascalCase=common_format_index.toPascalCase,exports.injectBeforeTag=common_html_index.injectBeforeTag,exports.injectBeforeTagWithFallback=common_html_index.injectBeforeTagWithFallback,exports.injectHeadAndBody=common_html_index.injectHeadAndBody,exports.injectHtmlByPriority=common_html_index.injectHtmlByPriority,exports.deepMerge=common_object_index.deepMerge,exports.containsScriptTag=common_script_index.containsScriptTag,exports.makeCallback=common_script_index.makeCallback,exports.validateIdentifierName=common_script_index.validateIdentifierName,exports.Validator=validator.Validator,exports.validateCallbackFields=common_validation_index.validateCallbackFields,exports.validateEnumValue=common_validation_index.validateEnumValue,exports.validateGlobalName=common_validation_index.validateGlobalName,exports.validateNestedDuration=common_validation_index.validateNestedDuration,exports.validateNoScriptInTemplate=common_validation_index.validateNoScriptInTemplate,exports.validateNonNegativeNumber=common_validation_index.validateNonNegativeNumber,exports.BasePlugin=factory_index.BasePlugin,exports.createPluginFactory=factory_index.createPluginFactory,exports.Logger=logger_index.Logger,exports.buildProgress=plugins_buildProgress_index.buildProgress,exports.copyFile=plugins_copyFile_index.copyFile,exports.faviconManager=plugins_faviconManager_index.faviconManager,exports.generateRouter=plugins_generateRouter_index.generateRouter,exports.generateVersion=plugins_generateVersion_index.generateVersion,exports.htmlInject=plugins_htmlInject_index.htmlInject,exports.loadingManager=plugins_loadingManager_index.loadingManager,exports.versionUpdateChecker=plugins_versionUpdateChecker_index.versionUpdateChecker;

package/dist/index.d.cts

@@ -1,6 +1,18 @@
-export { DateFormatOptions, checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent } from './common/index.cjs';
-export { V as Validator } from './shared/vite-plugin.CiHfwMiN.cjs';
+export { CopyOptions, CopyResult, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, writeFileContent } from './common/fs/index.cjs';
+export { DateFormatOptions, escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './common/format/index.cjs';
+export { DualInjectResult, HtmlInjectResult, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority } from './common/html/index.cjs';
+export { deepMerge } from './common/object/index.cjs';
+export { containsScriptTag, makeCallback, validateIdentifierName } from './common/script/index.cjs';
+export { V as Validator } from './shared/vite-plugin.DRRlWY8P.cjs';
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './common/validation/index.cjs';
 export { BasePlugin, BasePluginOptions, OptionsNormalizer, PluginFactory, PluginWithInstance, createPluginFactory } from './factory/index.cjs';
 export { L as Logger, P as PluginLogger } from './shared/vite-plugin.CLr0ttuO.cjs';
-export { AutoBindMode, AutoHideOn, BuildPhase, BuildProgressOptions, CopyFileOptions, DebounceHide, DelayShow, GenerateRouterOptions, GenerateVersionOptions, Icon, InjectIcoOptions, InjectLoadingOptions, LoadingCallbacks, LoadingManager, LoadingPosition, LoadingStyle, MinDisplayTime, NameStrategy, OutputFormat, OutputType, ProgressFormat, ProgressTheme, RequestFilter, RouteConfig, RouteMeta, SpinnerType, TransitionConfig, UniAppPageConfig, UniAppPagesJson, UniAppTabBarConfig, VersionFormat, buildProgress, copyFile, generateRouter, generateVersion, injectIco, injectLoading } from './plugins/index.cjs';
+export { BuildPhase, BuildProgressOptions, ProgressFormat, ProgressTheme, buildProgress } from './plugins/buildProgress/index.cjs';
+export { CopyFileOptions, copyFile } from './plugins/copyFile/index.cjs';
+export { FaviconManagerOptions, Icon, faviconManager } from './plugins/faviconManager/index.cjs';
+export { GenerateRouterOptions, NameStrategy, OutputFormat, RouteConfig, RouteMeta, UniAppPageConfig, UniAppPagesJson, UniAppTabBarConfig, generateRouter } from './plugins/generateRouter/index.cjs';
+export { GenerateVersionOptions, OutputType, VersionFormat, VersionInfo, generateVersion } from './plugins/generateVersion/index.cjs';
+export { ConditionType, HtmlInjectOptions, InjectCondition, InjectPosition, InjectRule, InjectionLogEntry, SecurityConfig, SelectorMatch, htmlInject } from './plugins/htmlInject/index.cjs';
+export { AutoBindMode, AutoHideOn, DebounceHide, DelayShow, LoadingCallbacks, LoadingManager, LoadingManagerOptions, LoadingPosition, LoadingStyle, MinDisplayTime, RequestFilter, SpinnerType, TransitionConfig, loadingManager } from './plugins/loadingManager/index.cjs';
+export { PromptStyle, VersionSource, VersionUpdateCheckerOptions, versionUpdateChecker } from './plugins/versionUpdateChecker/index.cjs';
 import 'vite';

package/dist/index.d.mts

@@ -1,6 +1,18 @@
-export { DateFormatOptions, checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent } from './common/index.mjs';
-export { V as Validator } from './shared/vite-plugin.CiHfwMiN.mjs';
+export { CopyOptions, CopyResult, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, writeFileContent } from './common/fs/index.mjs';
+export { DateFormatOptions, escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './common/format/index.mjs';
+export { DualInjectResult, HtmlInjectResult, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority } from './common/html/index.mjs';
+export { deepMerge } from './common/object/index.mjs';
+export { containsScriptTag, makeCallback, validateIdentifierName } from './common/script/index.mjs';
+export { V as Validator } from './shared/vite-plugin.DRRlWY8P.mjs';
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './common/validation/index.mjs';
 export { BasePlugin, BasePluginOptions, OptionsNormalizer, PluginFactory, PluginWithInstance, createPluginFactory } from './factory/index.mjs';
 export { L as Logger, P as PluginLogger } from './shared/vite-plugin.CLr0ttuO.mjs';
-export { AutoBindMode, AutoHideOn, BuildPhase, BuildProgressOptions, CopyFileOptions, DebounceHide, DelayShow, GenerateRouterOptions, GenerateVersionOptions, Icon, InjectIcoOptions, InjectLoadingOptions, LoadingCallbacks, LoadingManager, LoadingPosition, LoadingStyle, MinDisplayTime, NameStrategy, OutputFormat, OutputType, ProgressFormat, ProgressTheme, RequestFilter, RouteConfig, RouteMeta, SpinnerType, TransitionConfig, UniAppPageConfig, UniAppPagesJson, UniAppTabBarConfig, VersionFormat, buildProgress, copyFile, generateRouter, generateVersion, injectIco, injectLoading } from './plugins/index.mjs';
+export { BuildPhase, BuildProgressOptions, ProgressFormat, ProgressTheme, buildProgress } from './plugins/buildProgress/index.mjs';
+export { CopyFileOptions, copyFile } from './plugins/copyFile/index.mjs';
+export { FaviconManagerOptions, Icon, faviconManager } from './plugins/faviconManager/index.mjs';
+export { GenerateRouterOptions, NameStrategy, OutputFormat, RouteConfig, RouteMeta, UniAppPageConfig, UniAppPagesJson, UniAppTabBarConfig, generateRouter } from './plugins/generateRouter/index.mjs';
+export { GenerateVersionOptions, OutputType, VersionFormat, VersionInfo, generateVersion } from './plugins/generateVersion/index.mjs';
+export { ConditionType, HtmlInjectOptions, InjectCondition, InjectPosition, InjectRule, InjectionLogEntry, SecurityConfig, SelectorMatch, htmlInject } from './plugins/htmlInject/index.mjs';
+export { AutoBindMode, AutoHideOn, DebounceHide, DelayShow, LoadingCallbacks, LoadingManager, LoadingManagerOptions, LoadingPosition, LoadingStyle, MinDisplayTime, RequestFilter, SpinnerType, TransitionConfig, loadingManager } from './plugins/loadingManager/index.mjs';
+export { PromptStyle, VersionSource, VersionUpdateCheckerOptions, versionUpdateChecker } from './plugins/versionUpdateChecker/index.mjs';
 import 'vite';

package/dist/index.d.ts

@@ -1,6 +1,18 @@
-export { DateFormatOptions, checkSourceExists, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, writeFileContent } from './common/index.js';
-export { V as Validator } from './shared/vite-plugin.CiHfwMiN.js';
+export { CopyOptions, CopyResult, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, writeFileContent } from './common/fs/index.js';
+export { DateFormatOptions, escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './common/format/index.js';
+export { DualInjectResult, HtmlInjectResult, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority } from './common/html/index.js';
+export { deepMerge } from './common/object/index.js';
+export { containsScriptTag, makeCallback, validateIdentifierName } from './common/script/index.js';
+export { V as Validator } from './shared/vite-plugin.DRRlWY8P.js';
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './common/validation/index.js';
 export { BasePlugin, BasePluginOptions, OptionsNormalizer, PluginFactory, PluginWithInstance, createPluginFactory } from './factory/index.js';
 export { L as Logger, P as PluginLogger } from './shared/vite-plugin.CLr0ttuO.js';
-export { AutoBindMode, AutoHideOn, BuildPhase, BuildProgressOptions, CopyFileOptions, DebounceHide, DelayShow, GenerateRouterOptions, GenerateVersionOptions, Icon, InjectIcoOptions, InjectLoadingOptions, LoadingCallbacks, LoadingManager, LoadingPosition, LoadingStyle, MinDisplayTime, NameStrategy, OutputFormat, OutputType, ProgressFormat, ProgressTheme, RequestFilter, RouteConfig, RouteMeta, SpinnerType, TransitionConfig, UniAppPageConfig, UniAppPagesJson, UniAppTabBarConfig, VersionFormat, buildProgress, copyFile, generateRouter, generateVersion, injectIco, injectLoading } from './plugins/index.js';
+export { BuildPhase, BuildProgressOptions, ProgressFormat, ProgressTheme, buildProgress } from './plugins/buildProgress/index.js';
+export { CopyFileOptions, copyFile } from './plugins/copyFile/index.js';
+export { FaviconManagerOptions, Icon, faviconManager } from './plugins/faviconManager/index.js';
+export { GenerateRouterOptions, NameStrategy, OutputFormat, RouteConfig, RouteMeta, UniAppPageConfig, UniAppPagesJson, UniAppTabBarConfig, generateRouter } from './plugins/generateRouter/index.js';
+export { GenerateVersionOptions, OutputType, VersionFormat, VersionInfo, generateVersion } from './plugins/generateVersion/index.js';
+export { ConditionType, HtmlInjectOptions, InjectCondition, InjectPosition, InjectRule, InjectionLogEntry, SecurityConfig, SelectorMatch, htmlInject } from './plugins/htmlInject/index.js';
+export { AutoBindMode, AutoHideOn, DebounceHide, DelayShow, LoadingCallbacks, LoadingManager, LoadingManagerOptions, LoadingPosition, LoadingStyle, MinDisplayTime, RequestFilter, SpinnerType, TransitionConfig, loadingManager } from './plugins/loadingManager/index.js';
+export { PromptStyle, VersionSource, VersionUpdateCheckerOptions, versionUpdateChecker } from './plugins/versionUpdateChecker/index.js';
 import 'vite';

package/dist/index.mjs

@@ -1 +1 @@
-export{c as checkSourceExists,a as copySourceToTarget,e as ensureTargetDir,f as fileExists,b as formatDate,g as generateRandomHash,d as getDateFormatParams,p as padNumber,h as parseTemplate,r as readDirRecursive,i as readFileContent,j as readFileSync,k as runWithConcurrency,s as shouldUpdateFile,l as stripJsonComments,t as toCamelCase,m as toPascalCase,w as writeFileContent}from"./shared/vite-plugin.C3ejdBNf.mjs";export{V as Validator,d as deepMerge}from"./shared/vite-plugin.B88RyRN8.mjs";export{B as BasePlugin,c as createPluginFactory}from"./shared/vite-plugin.DSb6XzBn.mjs";export{Logger}from"./logger/index.mjs";export{b as buildProgress,c as copyFile,g as generateRouter,a as generateVersion,i as injectIco,d as injectLoading}from"./shared/vite-plugin.BI4kA-bR.mjs";import"fs";import"path";import"crypto";
+export{checkSourceExists,copySourceToTarget,ensureTargetDir,fileExists,readDirRecursive,readFileContent,readFileSync,runWithConcurrency,shouldUpdateFile,writeFileContent}from"./common/fs/index.mjs";export{escapeHtmlAttr,formatDate,generateRandomHash,getDateFormatParams,padNumber,parseTemplate,stripJsonComments,toCamelCase,toPascalCase}from"./common/format/index.mjs";export{injectBeforeTag,injectBeforeTagWithFallback,injectHeadAndBody,injectHtmlByPriority}from"./common/html/index.mjs";export{deepMerge}from"./common/object/index.mjs";export{containsScriptTag,makeCallback,validateIdentifierName}from"./common/script/index.mjs";export{V as Validator}from"./shared/vite-plugin.DcExl6jd.mjs";export{validateCallbackFields,validateEnumValue,validateGlobalName,validateNestedDuration,validateNoScriptInTemplate,validateNonNegativeNumber}from"./common/validation/index.mjs";export{BasePlugin,createPluginFactory}from"./factory/index.mjs";export{Logger}from"./logger/index.mjs";export{buildProgress}from"./plugins/buildProgress/index.mjs";export{copyFile}from"./plugins/copyFile/index.mjs";export{faviconManager}from"./plugins/faviconManager/index.mjs";export{generateRouter}from"./plugins/generateRouter/index.mjs";export{generateVersion}from"./plugins/generateVersion/index.mjs";export{htmlInject}from"./plugins/htmlInject/index.mjs";export{loadingManager}from"./plugins/loadingManager/index.mjs";export{versionUpdateChecker}from"./plugins/versionUpdateChecker/index.mjs";import"fs";import"path";import"crypto";import"node:path";

package/dist/plugins/buildProgress/index.cjs

@@ -0,0 +1,2 @@
+"use strict";const factory_index=require("../../factory/index.cjs");require("../../logger/index.cjs"),require("../../common/object/index.cjs"),require("../../shared/vite-plugin.Bcg6RW2N.cjs");const SPINNER_FRAMES=process.platform==="win32"?["|","/","-","\\"]:["\u280B","\u2819","\u2839","\u2838","\u283C","\u2834","\u2826","\u2827","\u2807","\u280F"],ANSI={reset:"\x1B[0G",clearLine:"\x1B[2K",hideCursor:"\x1B[?25l",showCursor:"\x1B[?25h",green:i=>`\x1B[32m${i}\x1B[39m`,cyan:i=>`\x1B[36m${i}\x1B[39m`,gray:i=>`\x1B[90m${i}\x1B[39m`,bold:i=>`\x1B[1m${i}\x1B[22m`},DEFAULT_THEME={completeColor:ANSI.green,incompleteColor:ANSI.gray,percentageColor:ANSI.bold,phaseColor:ANSI.cyan,moduleColor:ANSI.gray},PHASE_LABELS={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 o extends factory_index.BasePlugin{totalModules=0;transformedModules=0;currentModule="";phase="idle";spinnerIndex=0;spinnerTimer=null;isDev=!1;theme=DEFAULT_THEME;lastPercentage=0;static ANSI_REGEX=/\x1b\[[0-9;]*m/g;static stripAnsi(e){return e.replace(o.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||DEFAULT_THEME}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,s=this.phase==="write"?5:0,n=Math.min(Math.floor(15+e+t+s),99);return this.lastPercentage=Math.max(n,this.lastPercentage),this.lastPercentage}renderBar(e){const t=this.options.width||30,s=this.options.completeChar||"\u2588",n=this.options.incompleteChar||"\u2591",r=Math.round(e/100*t),u=t-r;return this.theme.completeColor(s.repeat(r))+this.theme.incompleteColor(n.repeat(u))}renderSpinner(){const e=SPINNER_FRAMES[this.spinnerIndex%SPINNER_FRAMES.length];return this.spinnerIndex++,this.theme.phaseColor(e)}render(e){const t=this.options.format||"bar",s=this.theme.phaseColor(PHASE_LABELS[this.phase]),n=this.theme.percentageColor(`${e}%`);let r="";if(t==="bar"?r=`${this.renderSpinner()} ${s} ${this.renderBar(e)} ${n}`:t==="spinner"?r=`${this.renderSpinner()} ${s} ${n}`:r=`${s} ${n}`,this.options.showModuleName&&this.currentModule&&this.phase==="transform"){const u=o.stripAnsi(r).length,l=Math.max((process.stdout.columns||80)-u-3,20),a=this.currentModule.length>l?"..."+this.currentModule.slice(-l+3):this.currentModule;r+=` ${this.theme.moduleColor(a)}`}return r}update(){if(!process.stdout.isTTY)return;const e=this.getPercentage(),t=this.render(e);this.safeExecuteSync(()=>{process.stdout.write(ANSI.clearLine+ANSI.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(ANSI.clearLine+ANSI.reset)},"\u6E05\u9664\u8FDB\u5EA6\u884C");else{const e=this.render(100);this.safeExecuteSync(()=>{process.stdout.write(ANSI.clearLine+ANSI.reset+e+`
+`)},"\u8F93\u51FA\u5B8C\u6210\u8FDB\u5EA6")}this.safeExecuteSync(()=>{process.stdout.write(ANSI.showCursor)},"\u6062\u590D\u5149\u6807\u663E\u793A")}addPluginHooks(e){e.config=(t,{command:s})=>(this.isDev=s==="serve",null),e.configResolved=()=>{this.options.enabled&&(this.phase="config",process.stdout.isTTY&&this.safeExecuteSync(()=>{process.stdout.write(ANSI.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,s)=>{this.options.enabled&&(s.includes("node_modules")||s.includes(".virtual")||(this.phase="transform",this.transformedModules++,this.currentModule=s))}},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(ANSI.showCursor)},"\u6062\u590D\u5149\u6807\u663E\u793A")}}const buildProgress=factory_index.createPluginFactory(o);exports.buildProgress=buildProgress;

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