@meng-xi/vite-plugin 0.1.4 → 0.1.5

package/dist/shared/vite-plugin.CLr0ttuO.d.cts

@@ -1,135 +0,0 @@
-/**
- * 构造函数参数接口
- */
-interface LoggerOptions {
-    /**
-     * 插件名称
-     */
-    name: string;
-    /**
-     * 是否启用日志
-     */
-    enabled?: boolean;
-}
-
-/**
- * 日志工具类（单例模式）
- * @description 全局单例日志管理器，统一管理所有插件的日志输出
- */
-declare class Logger {
-    /**
-     * 单例实例
-     */
-    private static instance;
-    /**
-     * 库名称
-     */
-    private readonly libName;
-    /**
-     * 插件日志配置映射表
-     * @description 存储每个插件的日志开关状态
-     */
-    private pluginConfigs;
-    /**
-     * 日志类型映射
-     */
-    private readonly logTypes;
-    /**
-     * 私有构造函数，防止外部实例化
-     */
-    private constructor();
-    /**
-     * 获取单例实例
-     * @returns Logger 单例实例
-     */
-    private static getInstance;
-    /**
-     * 创建日志记录器（工厂方法）
-     * @param options 配置选项
-     * @returns Logger 单例实例
-     * @description 为插件创建日志记录器，实际返回单例实例并注册插件配置
-     */
-    static create(options: LoggerOptions): Logger;
-    /**
-     * 注册插件日志配置
-     * @param pluginName 插件名称
-     * @param enabled 是否启用日志
-     */
-    private registerPlugin;
-    /**
-     * 注销插件日志配置
-     * @param pluginName 插件名称
-     */
-    private unregisterPlugin;
-    /**
-     * 注销指定插件的日志配置
-     * @param pluginName 插件名称
-     * @description 从单例中移除指定插件的日志配置，通常在插件销毁时调用
-     */
-    static unregister(pluginName: string): void;
-    /**
-     * 销毁单例实例，释放所有资源
-     * @description 清除所有已注册的插件配置，重置单例实例。主要用于测试场景
-     */
-    static destroy(): void;
-    /**
-     * 生成日志前缀
-     * @param pluginName 插件名称
-     * @returns 格式化的日志前缀
-     */
-    private formatPrefix;
-    /**
-     * 检查插件日志是否启用
-     * @param pluginName 插件名称
-     * @returns 是否启用
-     */
-    private isPluginEnabled;
-    /**
-     * 统一日志输出方法
-     * @param pluginName 插件名称
-     * @param type 日志类型
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    private log;
-    /**
-     * 创建插件日志代理对象
-     * @param pluginName 插件名称
-     * @returns 插件日志代理对象
-     * @internal 供 BasePlugin 内部使用
-     */
-    createPluginLogger(pluginName: string): PluginLogger;
-}
-/**
- * 插件日志代理接口
- * @description 为每个插件提供独立的日志接口
- */
-interface PluginLogger {
-    /**
-     * 输出成功日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    success(message: string, data?: any): void;
-    /**
-     * 输出信息日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    info(message: string, data?: any): void;
-    /**
-     * 输出警告日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    warn(message: string, data?: any): void;
-    /**
-     * 输出错误日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    error(message: string, data?: any): void;
-}
-
-export { Logger as L };
-export type { PluginLogger as P, LoggerOptions as a };

package/dist/shared/vite-plugin.CLr0ttuO.d.mts

@@ -1,135 +0,0 @@
-/**
- * 构造函数参数接口
- */
-interface LoggerOptions {
-    /**
-     * 插件名称
-     */
-    name: string;
-    /**
-     * 是否启用日志
-     */
-    enabled?: boolean;
-}
-
-/**
- * 日志工具类（单例模式）
- * @description 全局单例日志管理器，统一管理所有插件的日志输出
- */
-declare class Logger {
-    /**
-     * 单例实例
-     */
-    private static instance;
-    /**
-     * 库名称
-     */
-    private readonly libName;
-    /**
-     * 插件日志配置映射表
-     * @description 存储每个插件的日志开关状态
-     */
-    private pluginConfigs;
-    /**
-     * 日志类型映射
-     */
-    private readonly logTypes;
-    /**
-     * 私有构造函数，防止外部实例化
-     */
-    private constructor();
-    /**
-     * 获取单例实例
-     * @returns Logger 单例实例
-     */
-    private static getInstance;
-    /**
-     * 创建日志记录器（工厂方法）
-     * @param options 配置选项
-     * @returns Logger 单例实例
-     * @description 为插件创建日志记录器，实际返回单例实例并注册插件配置
-     */
-    static create(options: LoggerOptions): Logger;
-    /**
-     * 注册插件日志配置
-     * @param pluginName 插件名称
-     * @param enabled 是否启用日志
-     */
-    private registerPlugin;
-    /**
-     * 注销插件日志配置
-     * @param pluginName 插件名称
-     */
-    private unregisterPlugin;
-    /**
-     * 注销指定插件的日志配置
-     * @param pluginName 插件名称
-     * @description 从单例中移除指定插件的日志配置，通常在插件销毁时调用
-     */
-    static unregister(pluginName: string): void;
-    /**
-     * 销毁单例实例，释放所有资源
-     * @description 清除所有已注册的插件配置，重置单例实例。主要用于测试场景
-     */
-    static destroy(): void;
-    /**
-     * 生成日志前缀
-     * @param pluginName 插件名称
-     * @returns 格式化的日志前缀
-     */
-    private formatPrefix;
-    /**
-     * 检查插件日志是否启用
-     * @param pluginName 插件名称
-     * @returns 是否启用
-     */
-    private isPluginEnabled;
-    /**
-     * 统一日志输出方法
-     * @param pluginName 插件名称
-     * @param type 日志类型
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    private log;
-    /**
-     * 创建插件日志代理对象
-     * @param pluginName 插件名称
-     * @returns 插件日志代理对象
-     * @internal 供 BasePlugin 内部使用
-     */
-    createPluginLogger(pluginName: string): PluginLogger;
-}
-/**
- * 插件日志代理接口
- * @description 为每个插件提供独立的日志接口
- */
-interface PluginLogger {
-    /**
-     * 输出成功日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    success(message: string, data?: any): void;
-    /**
-     * 输出信息日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    info(message: string, data?: any): void;
-    /**
-     * 输出警告日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    warn(message: string, data?: any): void;
-    /**
-     * 输出错误日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    error(message: string, data?: any): void;
-}
-
-export { Logger as L };
-export type { PluginLogger as P, LoggerOptions as a };

package/dist/shared/vite-plugin.CLr0ttuO.d.ts

@@ -1,135 +0,0 @@
-/**
- * 构造函数参数接口
- */
-interface LoggerOptions {
-    /**
-     * 插件名称
-     */
-    name: string;
-    /**
-     * 是否启用日志
-     */
-    enabled?: boolean;
-}
-
-/**
- * 日志工具类（单例模式）
- * @description 全局单例日志管理器，统一管理所有插件的日志输出
- */
-declare class Logger {
-    /**
-     * 单例实例
-     */
-    private static instance;
-    /**
-     * 库名称
-     */
-    private readonly libName;
-    /**
-     * 插件日志配置映射表
-     * @description 存储每个插件的日志开关状态
-     */
-    private pluginConfigs;
-    /**
-     * 日志类型映射
-     */
-    private readonly logTypes;
-    /**
-     * 私有构造函数，防止外部实例化
-     */
-    private constructor();
-    /**
-     * 获取单例实例
-     * @returns Logger 单例实例
-     */
-    private static getInstance;
-    /**
-     * 创建日志记录器（工厂方法）
-     * @param options 配置选项
-     * @returns Logger 单例实例
-     * @description 为插件创建日志记录器，实际返回单例实例并注册插件配置
-     */
-    static create(options: LoggerOptions): Logger;
-    /**
-     * 注册插件日志配置
-     * @param pluginName 插件名称
-     * @param enabled 是否启用日志
-     */
-    private registerPlugin;
-    /**
-     * 注销插件日志配置
-     * @param pluginName 插件名称
-     */
-    private unregisterPlugin;
-    /**
-     * 注销指定插件的日志配置
-     * @param pluginName 插件名称
-     * @description 从单例中移除指定插件的日志配置，通常在插件销毁时调用
-     */
-    static unregister(pluginName: string): void;
-    /**
-     * 销毁单例实例，释放所有资源
-     * @description 清除所有已注册的插件配置，重置单例实例。主要用于测试场景
-     */
-    static destroy(): void;
-    /**
-     * 生成日志前缀
-     * @param pluginName 插件名称
-     * @returns 格式化的日志前缀
-     */
-    private formatPrefix;
-    /**
-     * 检查插件日志是否启用
-     * @param pluginName 插件名称
-     * @returns 是否启用
-     */
-    private isPluginEnabled;
-    /**
-     * 统一日志输出方法
-     * @param pluginName 插件名称
-     * @param type 日志类型
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    private log;
-    /**
-     * 创建插件日志代理对象
-     * @param pluginName 插件名称
-     * @returns 插件日志代理对象
-     * @internal 供 BasePlugin 内部使用
-     */
-    createPluginLogger(pluginName: string): PluginLogger;
-}
-/**
- * 插件日志代理接口
- * @description 为每个插件提供独立的日志接口
- */
-interface PluginLogger {
-    /**
-     * 输出成功日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    success(message: string, data?: any): void;
-    /**
-     * 输出信息日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    info(message: string, data?: any): void;
-    /**
-     * 输出警告日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    warn(message: string, data?: any): void;
-    /**
-     * 输出错误日志
-     * @param message 日志消息
-     * @param data 附加数据
-     */
-    error(message: string, data?: any): void;
-}
-
-export { Logger as L };
-export type { PluginLogger as P, LoggerOptions as a };

package/dist/shared/vite-plugin.CmtcnItg.d.cts

@@ -1,261 +0,0 @@
-/**
- * 环境变量验证模块
- *
- * @module common/validation/env
- * @description 提供环境变量的类型校验、范围验证、长度验证和批量验证等功能，
- * 支持 string、number、url、boolean、enum、json、semver、path 等多种类型，
- * 为 envGuard 等插件提供统一的环境变量校验能力。
- */
-/**
- * 环境变量值类型
- *
- * @description 定义环境变量支持的所有值类型：
- * - `string`：普通字符串（默认类型）
- * - `number`：数字类型
- * - `url`：URL 地址
- * - `boolean`：布尔值
- * - `enum`：枚举值
- * - `json`：JSON 字符串
- * - `semver`：语义化版本号
- * - `path`：文件路径
- */
-type EnvType = 'string' | 'number' | 'url' | 'boolean' | 'enum' | 'json' | 'semver' | 'path';
-/**
- * 环境变量字段校验规则
- *
- * @description 定义单个环境变量的校验规则，包括类型约束、范围限制、
- * 自定义验证函数和元数据信息等。
- *
- * @example
- * ```typescript
- * // 基本字符串字段
- * const rule: EnvFieldRule = { type: 'string', required: true }
- *
- * // 带范围的数字字段
- * const portRule: EnvFieldRule = { type: 'number', required: true, minValue: 1, maxValue: 65535 }
- *
- * // 枚举字段
- * const envRule: EnvFieldRule = { type: 'enum', required: true, enumValues: ['development', 'staging', 'production'] }
- *
- * // 自定义验证
- * const customRule: EnvFieldRule = {
- *   type: 'string',
- *   required: true,
- *   validator: (v) => v.startsWith('https://') || '必须使用 HTTPS'
- * }
- * ```
- */
-interface EnvFieldRule {
-    /** 值类型，默认为 `'string'` */
-    type?: EnvType;
-    /** 是否为必需字段，默认为 `true` */
-    required?: boolean;
-    /** 正则表达式，值必须匹配此模式 */
-    pattern?: RegExp;
-    /**
-     * 自定义验证函数
-     *
-     * @description 返回 `true` 表示验证通过，返回字符串表示验证失败且字符串为错误消息
-     */
-    validator?: (value: string) => boolean | string;
-    /** 自定义错误消息，覆盖默认的错误提示 */
-    message?: string;
-    /** 当值为空时使用的默认值 */
-    default?: string;
-    /** 枚举值列表（仅 `enum` 类型需要） */
-    enumValues?: string[];
-    /** 数值最小值（仅 `number` 类型） */
-    minValue?: number;
-    /** 数值最大值（仅 `number` 类型） */
-    maxValue?: number;
-    /** 字符串最小长度（仅字符串类类型） */
-    minLength?: number;
-    /** 字符串最大长度（仅字符串类类型） */
-    maxLength?: number;
-    /** 变量分组名称，用于模板生成时的分组显示 */
-    group?: string;
-    /** 变量描述信息，用于模板生成时的说明文本 */
-    description?: string;
-    /** 是否为敏感变量，模板中会隐藏实际值 */
-    sensitive?: boolean;
-}
-/**
- * 环境变量验证结果
- *
- * @description 表示单个环境变量的验证结果，包含验证状态、错误消息和有效值。
- */
-interface EnvValidationResult {
-    /** 环境变量名 */
-    key: string;
-    /**
-     * 验证状态：
-     * - `pass`：验证通过
-     * - `missing`：必需变量缺失
-     * - `type_error`：类型不匹配
-     * - `custom_error`：自定义验证失败或正则不匹配
-     * - `enum_mismatch`：枚举值不匹配
-     * - `range_error`：数值超出范围
-     * - `length_error`：字符串长度不符合要求
-     */
-    status: 'pass' | 'missing' | 'type_error' | 'custom_error' | 'enum_mismatch' | 'range_error' | 'length_error';
-    /** 验证消息（验证通过时为空字符串，失败时为错误描述） */
-    message: string;
-    /** 环境变量的有效值（缺失时可能为 `undefined` 或默认值） */
-    value: string | undefined;
-    /** 应用的校验规则（含默认值填充后的完整规则） */
-    rule: EnvFieldRule;
-}
-/**
- * 字符串类类型集合
- *
- * @description 包含所有以字符串形式存储的值类型（以及未指定类型的默认情况），
- * 用于在长度验证时判断是否需要检查 `minLength`/`maxLength`。
- * 非字符串类类型（如 `number`、`boolean`、`json`）不进行长度验证。
- */
-declare const STRING_LIKE_TYPES: ReadonlySet<EnvType | undefined>;
-/**
- * 验证环境变量值的类型
- *
- * @param value - 环境变量值的字符串表示
- * @param rule - 校验规则（需包含 `type` 字段）
- * @returns 验证结果对象，包含是否合法、状态码和错误消息
- *
- * @description 根据规则中指定的类型对值进行类型校验：
- * - `string`：始终通过（默认类型）
- * - `number`：必须为合法数字
- * - `url`：必须能被 `URL` 构造函数解析
- * - `boolean`：必须为 `true`/`false`/`1`/`0`/`yes`/`no`（不区分大小写）
- * - `enum`：必须在 `enumValues` 列表中
- * - `json`：必须能被 `JSON.parse` 解析
- * - `semver`：必须匹配 `x.y.z` 格式（支持 prerelease 和 build metadata）
- * - `path`：必须以 `./`、`/`、`\\` 或盘符开头
- *
- * @example
- * ```typescript
- * validateType('123', { type: 'number' })  // { valid: true, status: 'pass', message: '' }
- * validateType('abc', { type: 'number' })  // { valid: false, status: 'type_error', message: '...' }
- * validateType('d', { type: 'enum', enumValues: ['a', 'b', 'c'] })
- * // { valid: false, status: 'enum_mismatch', message: '...' }
- * ```
- */
-declare function validateType(value: string, rule: EnvFieldRule): {
-    valid: boolean;
-    status: 'type_error' | 'enum_mismatch' | 'pass';
-    message: string;
-};
-/**
- * 验证数值范围
- *
- * @param value - 环境变量值的字符串表示
- * @param rule - 校验规则（需包含 `minValue`/`maxValue` 字段）
- * @returns 验证结果对象，包含是否合法、状态码和错误消息
- *
- * @description 仅对 `number` 类型进行范围验证，检查值是否在 `minValue` 和 `maxValue` 之间。
- * 非 `number` 类型始终返回验证通过。
- *
- * @example
- * ```typescript
- * validateRange('5', { type: 'number', minValue: 1, maxValue: 10 })
- * // { valid: true, status: 'pass', message: '' }
- *
- * validateRange('0', { type: 'number', minValue: 1 })
- * // { valid: false, status: 'range_error', message: '数值 0 小于最小值 1' }
- * ```
- */
-declare function validateRange(value: string, rule: EnvFieldRule): {
-    valid: boolean;
-    status: 'range_error' | 'pass';
-    message: string;
-};
-/**
- * 验证字符串长度
- *
- * @param value - 环境变量值
- * @param rule - 校验规则（需包含 `minLength`/`maxLength` 字段）
- * @returns 验证结果对象，包含是否合法、状态码和错误消息
- *
- * @description 仅对字符串类类型（`string`、`url`、`path`、`enum`、`semver` 及未指定类型）
- * 进行长度验证。非字符串类类型（如 `number`、`boolean`、`json`）始终返回验证通过。
- *
- * @example
- * ```typescript
- * validateLength('hello', { type: 'string', minLength: 1, maxLength: 10 })
- * // { valid: true, status: 'pass', message: '' }
- *
- * validateLength('hi', { type: 'string', minLength: 5 })
- * // { valid: false, status: 'length_error', message: '字符串长度 2 小于最小长度 5' }
- * ```
- */
-declare function validateLength(value: string, rule: EnvFieldRule): {
-    valid: boolean;
-    status: 'length_error' | 'pass';
-    message: string;
-};
-/**
- * 验证单个环境变量值
- *
- * @param key - 环境变量名
- * @param value - 环境变量值（可能为 `undefined`）
- * @param rule - 校验规则
- * @returns 验证结果对象
- *
- * @description 按顺序执行以下验证步骤：
- * 1. **缺失检查**：必需变量为空时返回 `missing` 状态，非必需变量为空时使用默认值
- * 2. **类型验证**：调用 `validateType` 检查值的类型
- * 3. **范围验证**：调用 `validateRange` 检查数值范围
- * 4. **长度验证**：调用 `validateLength` 检查字符串长度
- * 5. **正则验证**：检查值是否匹配 `pattern` 正则
- * 6. **自定义验证**：执行 `validator` 函数
- *
- * 所有验证步骤中，自定义 `message` 会覆盖默认的错误消息。
- *
- * @example
- * ```typescript
- * // 必需变量缺失
- * validateValue('API_KEY', undefined, { type: 'string', required: true })
- * // { key: 'API_KEY', status: 'missing', message: '缺少必需的环境变量: API_KEY', ... }
- *
- * // 类型错误
- * validateValue('PORT', 'abc', { type: 'number', required: true })
- * // { key: 'PORT', status: 'type_error', message: '...', ... }
- *
- * // 使用默认值
- * validateValue('DEBUG', undefined, { type: 'boolean', required: false, default: 'false' })
- * // { key: 'DEBUG', status: 'pass', value: 'false', ... }
- * ```
- */
-declare function validateValue(key: string, value: string | undefined, rule: EnvFieldRule): EnvValidationResult;
-/**
- * 批量验证环境变量
- *
- * @param env - 环境变量键值对对象
- * @param rules - 环境变量校验规则映射
- * @returns 所有变量的验证结果数组
- *
- * @description 遍历所有规则，对每个环境变量调用 `validateValue` 进行验证，
- * 返回包含所有验证结果的数组。可用于汇总展示所有验证错误。
- *
- * @example
- * ```typescript
- * const results = validateEnvironment(
- *   { API_URL: 'https://api.example.com', PORT: 'abc', MISSING_VAR: undefined },
- *   {
- *     API_URL: { type: 'url', required: true },
- *     PORT: { type: 'number', required: true },
- *     MISSING_VAR: { type: 'string', required: true }
- *   }
- * )
- * // [
- * //   { key: 'API_URL', status: 'pass', ... },
- * //   { key: 'PORT', status: 'type_error', ... },
- * //   { key: 'MISSING_VAR', status: 'missing', ... }
- * // ]
- *
- * // 检查是否有错误
- * const hasErrors = results.some(r => r.status !== 'pass')
- * ```
- */
-declare function validateEnvironment(env: Record<string, string | undefined>, rules: Record<string, EnvFieldRule>): EnvValidationResult[];
-
-export { STRING_LIKE_TYPES as S, validateLength as c, validateRange as d, validateType as e, validateValue as f, validateEnvironment as v };
-export type { EnvFieldRule as E, EnvType as a, EnvValidationResult as b };