@meng-xi/vite-plugin 0.1.2 → 0.1.4

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

@@ -0,0 +1,261 @@
+/**
+ * 环境变量验证模块
+ *
+ * @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 };

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

@@ -0,0 +1,261 @@
+/**
+ * 环境变量验证模块
+ *
+ * @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 };

package/dist/shared/vite-plugin.DnFDPjNf.mjs

@@ -0,0 +1 @@
+const i=new Set(["string","url","path","enum","semver",void 0]);function m(e,u){switch(u.type){case"number":{if(isNaN(Number(e))||e.trim()==="")return{valid:!1,status:"type_error",message:`\u73AF\u5883\u53D8\u91CF\u503C "${e}" \u4E0D\u662F\u5408\u6CD5\u6570\u5B57`};break}case"url":{try{new URL(e)}catch{return{valid:!1,status:"type_error",message:`\u73AF\u5883\u53D8\u91CF\u503C "${e}" \u4E0D\u662F\u5408\u6CD5 URL`}}break}case"boolean":{const s=e.toLowerCase();if(!["true","false","1","0","yes","no"].includes(s))return{valid:!1,status:"type_error",message:`\u73AF\u5883\u53D8\u91CF\u503C "${e}" \u4E0D\u662F\u5408\u6CD5\u5E03\u5C14\u503C (true/false/1/0/yes/no)`};break}case"enum":{if(!u.enumValues||u.enumValues.length===0)return{valid:!1,status:"enum_mismatch",message:"enum \u7C7B\u578B\u5FC5\u987B\u6307\u5B9A enumValues"};if(!u.enumValues.includes(e))return{valid:!1,status:"enum_mismatch",message:`\u73AF\u5883\u53D8\u91CF\u503C "${e}" \u4E0D\u5728\u5141\u8BB8\u7684\u679A\u4E3E\u503C\u4E2D: ${u.enumValues.join(", ")}`};break}case"json":{try{JSON.parse(e)}catch{return{valid:!1,status:"type_error",message:"\u73AF\u5883\u53D8\u91CF\u503C\u4E0D\u662F\u5408\u6CD5 JSON"}}break}case"semver":{if(!/^\d+\.\d+\.\d+(-[\w.]+)?(\+[\w.]+)?$/.test(e))return{valid:!1,status:"type_error",message:`\u73AF\u5883\u53D8\u91CF\u503C "${e}" \u4E0D\u662F\u5408\u6CD5\u8BED\u4E49\u5316\u7248\u672C\u53F7 (x.y.z)`};break}case"path":{if(!/^(?:[./\\]|(?:[a-zA-Z]:))/.test(e))return{valid:!1,status:"type_error",message:`\u73AF\u5883\u53D8\u91CF\u503C "${e}" \u4E0D\u662F\u5408\u6CD5\u6587\u4EF6\u8DEF\u5F84`};break}}return{valid:!0,status:"pass",message:""}}function g(e,u){if(u.type!=="number")return{valid:!0,status:"pass",message:""};const s=Number(e);return u.minValue!==void 0&&s<u.minValue?{valid:!1,status:"range_error",message:`\u6570\u503C ${s} \u5C0F\u4E8E\u6700\u5C0F\u503C ${u.minValue}`}:u.maxValue!==void 0&&s>u.maxValue?{valid:!1,status:"range_error",message:`\u6570\u503C ${s} \u5927\u4E8E\u6700\u5927\u503C ${u.maxValue}`}:{valid:!0,status:"pass",message:""}}function o(e,u){return i.has(u.type)?u.minLength!==void 0&&e.length<u.minLength?{valid:!1,status:"length_error",message:`\u5B57\u7B26\u4E32\u957F\u5EA6 ${e.length} \u5C0F\u4E8E\u6700\u5C0F\u957F\u5EA6 ${u.minLength}`}:u.maxLength!==void 0&&e.length>u.maxLength?{valid:!1,status:"length_error",message:`\u5B57\u7B26\u4E32\u957F\u5EA6 ${e.length} \u5927\u4E8E\u6700\u5927\u957F\u5EA6 ${u.maxLength}`}:{valid:!0,status:"pass",message:""}:{valid:!0,status:"pass",message:""}}function v(e,u,s){const a={type:"string",required:!0,...s};if(u===void 0||u==="")return a.required!==!1?{key:e,status:"missing",message:a.message||`\u7F3A\u5C11\u5FC5\u9700\u7684\u73AF\u5883\u53D8\u91CF: ${e}`,value:u,rule:a}:{key:e,status:"pass",message:"",value:a.default??u,rule:a};const t=m(u,a);if(!t.valid)return{key:e,status:t.status,message:a.message||t.message,value:u,rule:a};const r=g(u,a);if(!r.valid)return{key:e,status:r.status,message:a.message||r.message,value:u,rule:a};const n=o(u,a);if(!n.valid)return{key:e,status:n.status,message:a.message||n.message,value:u,rule:a};if(a.pattern&&!a.pattern.test(u))return{key:e,status:"custom_error",message:a.message||`\u73AF\u5883\u53D8\u91CF ${e} \u4E0D\u5339\u914D\u6B63\u5219: ${a.pattern.source}`,value:u,rule:a};if(a.validator){const l=a.validator(u);if(l!==!0){const d=typeof l=="string"?l:"";return{key:e,status:"custom_error",message:a.message||d||`\u73AF\u5883\u53D8\u91CF ${e} \u81EA\u5B9A\u4E49\u6821\u9A8C\u5931\u8D25`,value:u,rule:a}}}return{key:e,status:"pass",message:"",value:u,rule:a}}function C(e,u){const s=[];for(const[a,t]of Object.entries(u)){const r=e[a];s.push(v(a,r,t))}return s}export{i as S,o as a,g as b,m as c,v as d,C as v};

package/dist/shared/vite-plugin.Dumot0up.mjs

@@ -0,0 +1 @@
+import{containsScriptTag as e,validateIdentifierName as a}from"../common/script/index.mjs";function n(u,t){if(u)try{a(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 c(u,t,o){for(const r of t){const i=u[r];if(i!==void 0&&typeof i!="string")throw new Error(`${o}.${r} \u5FC5\u987B\u662F\u5B57\u7B26\u4E32\u7C7B\u578B`);if(i&&e(i))throw new Error(`${o}.${r} \u4E0D\u5141\u8BB8\u5305\u542B <script> \u6807\u7B7E`)}}function d(u,t){if(u!==void 0&&(typeof u!="number"||u<0))throw new Error(`${t} \u5FC5\u987B\u662F\u975E\u8D1F\u6570`)}function s(u,t){if(u?.duration!==void 0&&(typeof u.duration!="number"||u.duration<0))throw new Error(t)}function l(u,t,o){if(u&&!t.includes(u))throw new Error(`${o} \u5FC5\u987B\u662F ${t.join(", ")}`)}export{l as a,n as b,s as c,f as d,d as e,c as v};

package/dist/shared/vite-plugin.FfJ-Wwfu.d.cts

@@ -0,0 +1,143 @@
+/**
+ * HTML 注入与安全相关类型定义
+ *
+ * @module common/html/type
+ * @description 定义 HTML 注入位置、选择器匹配模式、条件判断、安全配置等核心类型，
+ * 为 HTML 注入和安全过滤功能提供统一的类型约束。
+ */
+/**
+ * HTML 单点注入结果
+ *
+ * @description 表示在 HTML 中进行单点注入操作后的结果，
+ * 包含注入后的 HTML 内容和是否成功注入的标志。
+ */
+interface HtmlInjectResult {
+    /** 注入后的 HTML 内容 */
+    html: string;
+    /** 是否成功注入 */
+    injected: boolean;
+}
+/**
+ * HTML 双区域注入结果
+ *
+ * @description 表示在 HTML 的 head 和 body 两个区域同时注入后的结果，
+ * 包含各区域的注入状态和是否使用了回退策略。
+ */
+interface DualInjectResult {
+    /** 注入后的 HTML 内容 */
+    html: string;
+    /** 是否成功注入到 head 区域 */
+    headInjected: boolean;
+    /** 是否成功注入到 body 区域 */
+    bodyInjected: boolean;
+    /** body 注入是否使用了回退策略（追加到末尾） */
+    usedFallback: boolean;
+}
+/**
+ * HTML 注入位置类型
+ *
+ * @description 定义内容在 HTML 中可注入的所有位置：
+ * - `head-start`：`<head>` 标签开始后
+ * - `head-end`：`</head>` 标签前
+ * - `body-start`：`<body>` 标签开始后
+ * - `body-end`：`</body>` 标签前
+ * - `before-selector`：选择器匹配位置前
+ * - `after-selector`：选择器匹配位置后
+ * - `replace-selector`：替换选择器匹配的内容
+ */
+type InjectPosition = 'head-start' | 'head-end' | 'body-start' | 'body-end' | 'before-selector' | 'after-selector' | 'replace-selector';
+/**
+ * 选择器匹配模式
+ *
+ * @description 定义 HTML 选择器的匹配方式：
+ * - `string`：使用字符串精确匹配（默认）
+ * - `regex`：使用正则表达式匹配
+ */
+type SelectorMatch = 'string' | 'regex';
+/**
+ * 条件判断类型
+ *
+ * @description 定义注入条件的类型：
+ * - `env`：基于环境变量是否存在且为真值
+ * - `file-contains`：基于 HTML 内容是否包含指定字符串
+ * - `custom`：基于自定义函数的返回值
+ */
+type ConditionType = 'env' | 'file-contains' | 'custom';
+/**
+ * 注入条件配置
+ *
+ * @description 定义 HTML 内容注入的条件判断规则，
+ * 支持环境变量检测、内容包含检测和自定义函数判断，
+ * 可通过 `negate` 字段取反结果。
+ *
+ * @example
+ * ```typescript
+ * // 当环境变量 ENABLE_ANALYTICS 存在时注入
+ * { type: 'env', value: 'ENABLE_ANALYTICS' }
+ *
+ * // 当 HTML 不包含特定元素时注入（取反）
+ * { type: 'file-contains', value: '<div id="app">', negate: true }
+ *
+ * // 使用自定义函数判断
+ * { type: 'custom', value: () => process.env.NODE_ENV === 'production' }
+ * ```
+ */
+interface InjectCondition {
+    /** 条件类型 */
+    type: ConditionType;
+    /**
+     * 条件值：
+     * - `env` 类型：环境变量名
+     * - `file-contains` 类型：要搜索的字符串
+     * - `custom` 类型：返回布尔值的自定义函数
+     */
+    value: string | ((...args: any[]) => boolean);
+    /** 是否取反条件结果，默认为 `false` */
+    negate?: boolean;
+}
+/**
+ * 按位置注入结果
+ *
+ * @description 表示按指定位置注入内容后的详细结果，
+ * 包含注入后的 HTML、是否成功标志和失败原因。
+ */
+interface PositionInjectResult {
+    /** 注入后的 HTML 内容 */
+    html: string;
+    /** 是否成功注入 */
+    injected: boolean;
+    /** 注入失败时的原因说明（仅在 `injected` 为 `false` 时存在） */
+    reason?: string;
+}
+/**
+ * HTML 安全配置
+ *
+ * @description 控制 HTML 内容注入时的安全过滤策略，
+ * 可配置是否阻止危险标签和属性，以及自定义允许/阻止列表。
+ *
+ * @example
+ * ```typescript
+ * // 完全禁用安全过滤（不推荐）
+ * const config: SecurityConfig = { blockDangerousTags: false, blockDangerousAttributes: false }
+ *
+ * // 允许特定标签
+ * const config: SecurityConfig = { allowedTags: ['iframe'] }
+ *
+ * // 自定义阻止属性列表
+ * const config: SecurityConfig = { blockedAttributes: ['onclick', 'onerror'] }
+ * ```
+ */
+interface SecurityConfig {
+    /** 是否阻止危险 HTML 标签（如 script、iframe），默认为 `true` */
+    blockDangerousTags?: boolean;
+    /** 是否阻止危险 HTML 属性（如 onclick、onerror），默认为 `true` */
+    blockDangerousAttributes?: boolean;
+    /** 允许的标签列表，设置后将从默认阻止列表中排除这些标签 */
+    allowedTags?: string[];
+    /** 自定义阻止的标签列表，覆盖默认阻止列表 */
+    blockedTags?: string[];
+    /** 自定义阻止的属性列表，覆盖默认阻止属性列表 */
+    blockedAttributes?: string[];
+}
+
+export type { ConditionType as C, DualInjectResult as D, HtmlInjectResult as H, InjectCondition as I, PositionInjectResult as P, SecurityConfig as S, InjectPosition as a, SelectorMatch as b };