@meng-xi/vite-plugin 0.1.0 → 0.1.1

package/dist/common/index.d.ts

@@ -1,417 +1,7 @@
-export { V as Validator } from '../shared/vite-plugin.CiHfwMiN.js';
-
-/**
- * 复制操作的选项接口
- */
-interface CopyOptions {
-    /**
-     * 是否支持递归复制
-     */
-    recursive: boolean;
-    /**
-     * 是否覆盖同名文件
-     */
-    overwrite: boolean;
-    /**
-     * 是否启用增量复制
-     */
-    incremental?: boolean;
-    /**
-     * 并行处理的最大文件数
-     */
-    parallelLimit?: number;
-    /**
-     * 是否跳过空目录
-     */
-    skipEmptyDirs?: boolean;
-}
-/**
- * 复制结果接口
- */
-interface CopyResult {
-    /**
-     * 复制的文件数量
-     */
-    copiedFiles: number;
-    /**
-     * 跳过的文件数量
-     */
-    skippedFiles: number;
-    /**
-     * 复制的目录数量
-     */
-    copiedDirs: number;
-    /**
-     * 总执行时间（毫秒）
-     */
-    executionTime: number;
-}
-
-/**
- * 文件/目录条目信息
- */
-interface FileEntry {
-    /** 完整路径 */
-    path: string;
-    /** 是否为文件 */
-    isFile: boolean;
-    /** 是否为目录 */
-    isDirectory: boolean;
-}
-/**
- * 检查源文件是否存在
- * @param sourcePath 源文件路径
- * @throws 当源文件不存在或无法访问时抛出异常
- */
-declare function checkSourceExists(sourcePath: string): Promise<void>;
-/**
- * 创建目标目录
- * @param targetPath 目标目录路径
- * @throws 当无法创建目标目录时抛出异常
- */
-declare function ensureTargetDir(targetPath: string): Promise<void>;
-/**
- * 读取目录内容（优化版：一次性获取文件类型信息）
- * @param dirPath 目录路径
- * @param recursive 是否递归读取
- * @returns 文件和目录条目列表
- */
-declare function readDirRecursive(dirPath: string, recursive: boolean): Promise<FileEntry[]>;
-/**
- * 检查文件是否需要更新
- * @param sourceFile 源文件路径
- * @param targetFile 目标文件路径
- * @returns 是否需要更新
- */
-declare function shouldUpdateFile(sourceFile: string, targetFile: string): Promise<boolean>;
-/**
- * 检查文件是否存在
- * @param filePath 文件路径
- * @returns 是否存在
- *
- * @example
- * ```typescript
- * if (await fileExists('/path/to/file')) {
- *   console.log('文件存在')
- * }
- * ```
- */
-declare function fileExists(filePath: string): Promise<boolean>;
-/**
- * 带并发限制的批量执行
- *
- * @param items 待处理项
- * @param handler 处理函数
- * @param concurrency 并发数
- * @returns 处理结果数组，顺序与输入项对应
- *
- * @example
- * ```typescript
- * const urls = ['url1', 'url2', 'url3', 'url4', 'url5']
- * const results = await runWithConcurrency(
- *   urls,
- *   async (url) => fetch(url),
- *   3 // 最多同时处理3个请求
- * )
- * ```
- */
-declare function runWithConcurrency<T, R>(items: T[], handler: (item: T) => Promise<R>, concurrency: number): Promise<R[]>;
-/**
- * 执行文件复制操作（优化版：并行IO）
- * @param sourcePath 源文件或目录路径
- * @param targetPath 目标文件或目录路径
- * @param options 复制选项
- * @returns 复制结果
- * @throws 当复制过程中出现错误时抛出异常
- */
-declare function copySourceToTarget(sourcePath: string, targetPath: string, options: CopyOptions): Promise<CopyResult>;
-/**
- * 写入文件内容
- * @param filePath 文件路径
- * @param content 文件内容
- * @throws 当写入过程中出现错误时抛出异常
- */
-declare function writeFileContent(filePath: string, content: string): Promise<void>;
-/**
- * 读取文件内容
- * @param filePath 文件路径
- * @returns 文件内容字符串
- * @throws 当读取过程中出现错误时抛出异常
- */
-declare function readFileContent(filePath: string): Promise<string>;
-/**
- * 同步读取文件内容
- * @param filePath 文件路径
- * @returns 文件内容字符串
- * @throws 当读取过程中出现错误时抛出异常
- * @deprecated 请使用异步版本 readFileContent
- */
-declare function readFileSync(filePath: string): string;
-
-/**
- * 数字补零格式化
- *
- * @param num 要格式化的数字
- * @param length 目标长度
- * @returns 补零后的字符串
- *
- * @example
- * ```typescript
- * padNumber(5, 2)  // '05'
- * padNumber(12, 3) // '012'
- * padNumber(123, 2) // '123'
- * ```
- */
-declare function padNumber(num: number, length?: number): string;
-/**
- * 生成随机哈希字符串
- *
- * @param length 哈希长度，范围 1-64
- * @returns 随机哈希字符串
- *
- * @example
- * ```typescript
- * generateRandomHash(8)  // 'a1b2c3d4'
- * generateRandomHash(16) // 'a1b2c3d4e5f6g7h8'
- * ```
- */
-declare function generateRandomHash(length?: number): string;
-/**
- * 日期格式化选项
- */
-interface DateFormatOptions {
-    /** 四位年份 */
-    YYYY: string;
-    /** 两位年份 */
-    YY: string;
-    /** 两位月份 */
-    MM: string;
-    /** 两位日期 */
-    DD: string;
-    /** 两位小时（24小时制） */
-    HH: string;
-    /** 两位分钟 */
-    mm: string;
-    /** 两位秒数 */
-    ss: string;
-    /** 三位毫秒 */
-    SSS: string;
-    /** 时间戳（毫秒） */
-    timestamp: string;
-}
-/**
- * 获取日期格式化参数
- *
- * @param date 日期对象
- * @returns 日期格式化参数对象
- *
- * @example
- * ```typescript
- * const params = getDateFormatParams(new Date())
- * // { YYYY: '2026', MM: '02', DD: '03', HH: '15', mm: '30', ss: '00', ... }
- * ```
- */
-declare function getDateFormatParams(date?: Date): DateFormatOptions;
-/**
- * 格式化日期
- *
- * @param date 日期对象
- * @param format 格式模板
- * @returns 格式化后的日期字符串
- *
- * @example
- * ```typescript
- * formatDate(new Date(), '{YYYY}-{MM}-{DD}')         // '2026-02-03'
- * formatDate(new Date(), '{YYYY}{MM}{DD}{HH}{mm}{ss}') // '20260203153000'
- * formatDate(new Date(), '{YYYY}.{MM}.{DD}')         // '2026.02.03'
- * ```
- */
-declare function formatDate(date: Date, format: string): string;
-/**
- * 解析模板字符串，替换占位符
- *
- * @param template 模板字符串
- * @param values 占位符值映射
- * @returns 替换后的字符串
- *
- * @example
- * ```typescript
- * parseTemplate('{name}-{version}', { name: 'app', version: '1.0.0' })
- * // 'app-1.0.0'
- * ```
- */
-declare function parseTemplate(template: string, values: Record<string, string>): string;
-/**
- * 将字符串转换为驼峰命名（camelCase）
- *
- * @param str 输入字符串
- * @param separators 分隔符正则，默认为斜杠和横线
- * @returns 驼峰命名字符串
- *
- * @example
- * ```typescript
- * toCamelCase('pages/user/profile')  // 'pagesUserProfile'
- * toCamelCase('user-profile-page')   // 'userProfilePage'
- * toCamelCase('/pages/index')        // 'pagesIndex'
- * ```
- */
-declare function toCamelCase(str: string, separators?: RegExp): string;
-/**
- * 将字符串转换为帕斯卡命名（PascalCase）
- *
- * @param str 输入字符串
- * @param separators 分隔符正则，默认为斜杠和横线
- * @returns 帕斯卡命名字符串
- *
- * @example
- * ```typescript
- * toPascalCase('pages/user/profile')  // 'PagesUserProfile'
- * toPascalCase('user-profile-page')   // 'UserProfilePage'
- * toPascalCase('/pages/index')        // 'PagesIndex'
- * ```
- */
-declare function toPascalCase(str: string, separators?: RegExp): string;
-/**
- * 移除 JSON 字符串中的注释
- *
- * @param jsonString 包含注释的 JSON 字符串
- * @returns 移除注释后的 JSON 字符串
- *
- * @example
- * ```typescript
- * stripJsonComments('{\n  // comment\n  "name": "test"\n}')
- * // '{\n  "name": "test"\n}'
- * ```
- */
-declare function stripJsonComments(jsonString: string): string;
-
-/**
- * HTML 注入结果
- */
-interface HtmlInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** 是否成功注入 */
-    injected: boolean;
-}
-/**
- * 在 HTML 中指定闭合标签前注入代码
- *
- * @param html - 原始 HTML 内容
- * @param tag - 目标闭合标签（如 `</head>`、`</body>`、`</html>`）
- * @param code - 要注入的代码
- * @returns 注入结果对象
- *
- * @example
- * ```typescript
- * // 在 </head> 前注入 CSS
- * const result = injectBeforeTag(html, '</head>', '<style>...</style>')
- *
- * // 在 </body> 前注入 JS
- * const result = injectBeforeTag(html, '</body>', '<script>...</script>')
- * ```
- */
-declare function injectBeforeTag(html: string, tag: string, code: string): HtmlInjectResult;
-/**
- * 按优先级向 HTML 中注入代码
- *
- * @description 依次尝试在 `</head>`、`</body>`、`</html>` 前注入代码，
- * 优先注入到靠前的标签位置。适用于需要注入到页面中但无特定位置要求的场景
- *
- * @param html - 原始 HTML 内容
- * @param code - 要注入的代码
- * @param targets - 目标标签优先级列表，默认为 `['</head>', '</body>', '</html>']`
- * @returns 注入结果对象
- *
- * @example
- * ```typescript
- * // 优先注入到 </body> 前
- * const result = injectHtmlByPriority(html, scriptCode, ['</body>', '</html>'])
- * ```
- */
-declare function injectHtmlByPriority(html: string, code: string, targets?: string[]): HtmlInjectResult;
-
-/**
- * 深度合并对象
- *
- * @description 将多个源对象深度合并到一个新对象中。
- * - undefined 值会被跳过，不会覆盖已有值
- * - 嵌套对象会递归合并
- * - 数组会直接覆盖，不会合并
- * - null 值会覆盖已有值
- *
- * @param sources 源对象列表
- * @returns 合并后的对象
- *
- * @example
- * ```typescript
- * // 基本合并
- * deepMerge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
- *
- * // undefined 不覆盖
- * deepMerge({ a: 1 }, { a: undefined }) // { a: 1 }
- *
- * // 嵌套对象合并
- * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
- *
- * // 数组覆盖
- * deepMerge({ a: [1, 2] }, { a: [3, 4] }) // { a: [3, 4] }
- * ```
- */
-declare function deepMerge<T extends Record<string, any>>(...sources: Partial<T>[]): T;
-
-/**
- * 将回调函数体字符串包装为安全的函数表达式
- *
- * @param body - 函数体代码字符串
- * @param context - 回调上下文标识，用于错误日志
- * @param params - 函数参数列表字符串，默认为空
- * @returns 安全的函数表达式字符串（包含 try-catch 保护）
- *
- * @example
- * ```typescript
- * makeCallback('console.log("done")')
- * // 'function() { try { console.log("done") } catch(e) { console.error('[callback] error:', e); } }'
- *
- * makeCallback('console.log(a, b)', 'callback', 'a, b')
- * // 'function(a, b) { try { console.log(a, b) } catch(e) { console.error('[callback] error:', e); } }'
- *
- * makeCallback('')
- * // 'function() {}'
- * ```
- */
-declare function makeCallback(body?: string, context?: string, params?: string): string;
-/**
- * 检测字符串是否包含 `<script>` 标签
- *
- * @param str - 待检测的字符串
- * @returns 是否包含 script 标签
- *
- * @example
- * ```typescript
- * containsScriptTag('<div onclick="alert(1)">') // false
- * containsScriptTag('<script>alert(1)</script>') // true
- * ```
- */
-declare function containsScriptTag(str: string): boolean;
-/**
- * 验证字符串是否为合法的 JavaScript 标识符
- *
- * @description 检查名称是否以字母、下划线或美元符开头，
- * 仅包含字母、数字、下划线和美元符，并排除可能导致原型污染的内置属性
- *
- * @param name - 待验证的标识符名称
- * @throws 当名称不是合法标识符时抛出错误
- * @throws 当名称为 JavaScript 内置属性时抛出错误
- *
- * @example
- * ```typescript
- * validateIdentifierName('__LOADING_MANAGER__') // 通过
- * validateIdentifierName('123abc')              // 抛出错误
- * validateIdentifierName('__proto__')           // 抛出错误（内置属性）
- * ```
- */
-declare function validateIdentifierName(name: string): void;
-
-export { checkSourceExists, containsScriptTag, copySourceToTarget, deepMerge, ensureTargetDir, fileExists, formatDate, generateRandomHash, getDateFormatParams, injectBeforeTag, injectHtmlByPriority, makeCallback, padNumber, parseTemplate, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, stripJsonComments, toCamelCase, toPascalCase, validateIdentifierName, writeFileContent };
-export type { DateFormatOptions, HtmlInjectResult };
+export { CopyOptions, CopyResult, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, shouldUpdateFile, writeFileContent } from './fs/index.js';
+export { DateFormatOptions, escapeHtmlAttr, formatDate, generateRandomHash, getDateFormatParams, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './format/index.js';
+export { DualInjectResult, HtmlInjectResult, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority } from './html/index.js';
+export { deepMerge } from './object/index.js';
+export { containsScriptTag, makeCallback, validateIdentifierName } from './script/index.js';
+export { V as Validator } from '../shared/vite-plugin.DRRlWY8P.js';
+export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './validation/index.js';

package/dist/common/index.mjs

@@ -1 +1 @@
-export{c as checkSourceExists,a as containsScriptTag,b as copySourceToTarget,e as ensureTargetDir,f as fileExists,d as formatDate,g as generateRandomHash,h as getDateFormatParams,i as injectBeforeTag,j as injectHtmlByPriority,m as makeCallback,p as padNumber,k as parseTemplate,r as readDirRecursive,l as readFileContent,n as readFileSync,o as runWithConcurrency,s as shouldUpdateFile,q as stripJsonComments,t as toCamelCase,u as toPascalCase,v as validateIdentifierName,w as writeFileContent}from"../shared/vite-plugin.DFjf9wFM.mjs";export{V as Validator,d as deepMerge}from"../shared/vite-plugin.B88RyRN8.mjs";import"fs";import"path";import"crypto";
+export{checkSourceExists,copySourceToTarget,ensureTargetDir,fileExists,readDirRecursive,readFileContent,readFileSync,runWithConcurrency,shouldUpdateFile,writeFileContent}from"./fs/index.mjs";export{escapeHtmlAttr,formatDate,generateRandomHash,getDateFormatParams,padNumber,parseTemplate,stripJsonComments,toCamelCase,toPascalCase}from"./format/index.mjs";export{injectBeforeTag,injectBeforeTagWithFallback,injectHeadAndBody,injectHtmlByPriority}from"./html/index.mjs";export{deepMerge}from"./object/index.mjs";export{containsScriptTag,makeCallback,validateIdentifierName}from"./script/index.mjs";export{V as Validator}from"../shared/vite-plugin.DcExl6jd.mjs";export{validateCallbackFields,validateEnumValue,validateGlobalName,validateNestedDuration,validateNoScriptInTemplate,validateNonNegativeNumber}from"./validation/index.mjs";import"fs";import"path";import"crypto";

package/dist/common/object/index.cjs

@@ -0,0 +1 @@
+"use strict";function i(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)&&Object.prototype.toString.call(e)==="[object Object]"}function deepMerge(...e){const t={};for(const r of e)if(r)for(const o in r){if(!Object.prototype.hasOwnProperty.call(r,o))continue;const n=r[o],c=t[o];n!==void 0&&(i(n)&&i(c)?t[o]=deepMerge(c,n):t[o]=n)}return t}exports.deepMerge=deepMerge;

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

@@ -0,0 +1,30 @@
+/**
+ * 深度合并对象
+ *
+ * @description 将多个源对象深度合并到一个新对象中。
+ * - undefined 值会被跳过，不会覆盖已有值
+ * - 嵌套对象会递归合并
+ * - 数组会直接覆盖，不会合并
+ * - null 值会覆盖已有值
+ *
+ * @param sources 源对象列表
+ * @returns 合并后的对象
+ *
+ * @example
+ * ```typescript
+ * // 基本合并
+ * deepMerge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * // undefined 不覆盖
+ * deepMerge({ a: 1 }, { a: undefined }) // { a: 1 }
+ *
+ * // 嵌套对象合并
+ * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+ *
+ * // 数组覆盖
+ * deepMerge({ a: [1, 2] }, { a: [3, 4] }) // { a: [3, 4] }
+ * ```
+ */
+declare function deepMerge<T extends Record<string, any>>(...sources: Partial<T>[]): T;
+
+export { deepMerge };

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

@@ -0,0 +1,30 @@
+/**
+ * 深度合并对象
+ *
+ * @description 将多个源对象深度合并到一个新对象中。
+ * - undefined 值会被跳过，不会覆盖已有值
+ * - 嵌套对象会递归合并
+ * - 数组会直接覆盖，不会合并
+ * - null 值会覆盖已有值
+ *
+ * @param sources 源对象列表
+ * @returns 合并后的对象
+ *
+ * @example
+ * ```typescript
+ * // 基本合并
+ * deepMerge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * // undefined 不覆盖
+ * deepMerge({ a: 1 }, { a: undefined }) // { a: 1 }
+ *
+ * // 嵌套对象合并
+ * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+ *
+ * // 数组覆盖
+ * deepMerge({ a: [1, 2] }, { a: [3, 4] }) // { a: [3, 4] }
+ * ```
+ */
+declare function deepMerge<T extends Record<string, any>>(...sources: Partial<T>[]): T;
+
+export { deepMerge };

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

@@ -0,0 +1,30 @@
+/**
+ * 深度合并对象
+ *
+ * @description 将多个源对象深度合并到一个新对象中。
+ * - undefined 值会被跳过，不会覆盖已有值
+ * - 嵌套对象会递归合并
+ * - 数组会直接覆盖，不会合并
+ * - null 值会覆盖已有值
+ *
+ * @param sources 源对象列表
+ * @returns 合并后的对象
+ *
+ * @example
+ * ```typescript
+ * // 基本合并
+ * deepMerge({ a: 1 }, { b: 2 }) // { a: 1, b: 2 }
+ *
+ * // undefined 不覆盖
+ * deepMerge({ a: 1 }, { a: undefined }) // { a: 1 }
+ *
+ * // 嵌套对象合并
+ * deepMerge({ a: { b: 1 } }, { a: { c: 2 } }) // { a: { b: 1, c: 2 } }
+ *
+ * // 数组覆盖
+ * deepMerge({ a: [1, 2] }, { a: [3, 4] }) // { a: [3, 4] }
+ * ```
+ */
+declare function deepMerge<T extends Record<string, any>>(...sources: Partial<T>[]): T;
+
+export { deepMerge };

package/dist/common/object/index.mjs

@@ -0,0 +1 @@
+function i(o){return typeof o=="object"&&o!==null&&!Array.isArray(o)&&Object.prototype.toString.call(o)==="[object Object]"}function f(...o){const e={};for(const r of o)if(r)for(const t in r){if(!Object.prototype.hasOwnProperty.call(r,t))continue;const n=r[t],c=e[t];n!==void 0&&(i(n)&&i(c)?e[t]=f(c,n):e[t]=n)}return e}export{f as deepMerge};

package/dist/common/script/index.cjs

@@ -0,0 +1 @@
+"use strict";function makeCallback(u,r="callback",t=""){return u?`function(${t}) { try { ${u} } catch(e) { console.error('[${r}] error:', e); } }`:`function(${t}) {}`}function containsScriptTag(u){return/<script\b/i.test(u)}function validateIdentifierName(u){if(!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(u))throw new Error(`"${u}" \u4E0D\u662F\u5408\u6CD5\u7684 JavaScript \u6807\u8BC6\u7B26\uFF0C\u5FC5\u987B\u4EE5\u5B57\u6BCD\u3001\u4E0B\u5212\u7EBF\u6216\u7F8E\u5143\u7B26\u5F00\u5934\uFF0C\u4EC5\u5305\u542B\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u548C\u7F8E\u5143\u7B26`);if(["__proto__","constructor","prototype"].includes(u))throw new Error(`"${u}" \u662F JavaScript \u5185\u7F6E\u5C5E\u6027\uFF0C\u53EF\u80FD\u5BFC\u81F4\u539F\u578B\u6C61\u67D3\uFF0C\u8BF7\u4F7F\u7528\u5176\u4ED6\u540D\u79F0`)}exports.containsScriptTag=containsScriptTag,exports.makeCallback=makeCallback,exports.validateIdentifierName=validateIdentifierName;

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

@@ -0,0 +1,54 @@
+/**
+ * 将回调函数体字符串包装为安全的函数表达式
+ *
+ * @param body - 函数体代码字符串
+ * @param context - 回调上下文标识，用于错误日志
+ * @param params - 函数参数列表字符串，默认为空
+ * @returns 安全的函数表达式字符串（包含 try-catch 保护）
+ *
+ * @example
+ * ```typescript
+ * makeCallback('console.log("done")')
+ * // 'function() { try { console.log("done") } catch(e) { console.error('[callback] error:', e); } }'
+ *
+ * makeCallback('console.log(a, b)', 'callback', 'a, b')
+ * // 'function(a, b) { try { console.log(a, b) } catch(e) { console.error('[callback] error:', e); } }'
+ *
+ * makeCallback('')
+ * // 'function() {}'
+ * ```
+ */
+declare function makeCallback(body?: string, context?: string, params?: string): string;
+/**
+ * 检测字符串是否包含 `<script>` 标签
+ *
+ * @param str - 待检测的字符串
+ * @returns 是否包含 script 标签
+ *
+ * @example
+ * ```typescript
+ * containsScriptTag('<div onclick="alert(1)">') // false
+ * containsScriptTag('<script>alert(1)</script>') // true
+ * ```
+ */
+declare function containsScriptTag(str: string): boolean;
+/**
+ * 验证字符串是否为合法的 JavaScript 标识符
+ *
+ * @description 检查名称是否以字母、下划线或美元符开头，
+ * 仅包含字母、数字、下划线和美元符，并排除可能导致原型污染的内置属性
+ *
+ * @param name - 待验证的标识符名称
+ * @throws 当名称不是合法标识符时抛出错误
+ * @throws 当名称为 JavaScript 内置属性时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateIdentifierName('__LOADING_MANAGER__') // 通过
+ * validateIdentifierName('123abc')              // 抛出错误
+ * validateIdentifierName('__proto__')           // 抛出错误（内置属性）
+ * ```
+ */
+declare function validateIdentifierName(name: string): void;
+
+export { containsScriptTag, makeCallback, validateIdentifierName };

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

@@ -0,0 +1,54 @@
+/**
+ * 将回调函数体字符串包装为安全的函数表达式
+ *
+ * @param body - 函数体代码字符串
+ * @param context - 回调上下文标识，用于错误日志
+ * @param params - 函数参数列表字符串，默认为空
+ * @returns 安全的函数表达式字符串（包含 try-catch 保护）
+ *
+ * @example
+ * ```typescript
+ * makeCallback('console.log("done")')
+ * // 'function() { try { console.log("done") } catch(e) { console.error('[callback] error:', e); } }'
+ *
+ * makeCallback('console.log(a, b)', 'callback', 'a, b')
+ * // 'function(a, b) { try { console.log(a, b) } catch(e) { console.error('[callback] error:', e); } }'
+ *
+ * makeCallback('')
+ * // 'function() {}'
+ * ```
+ */
+declare function makeCallback(body?: string, context?: string, params?: string): string;
+/**
+ * 检测字符串是否包含 `<script>` 标签
+ *
+ * @param str - 待检测的字符串
+ * @returns 是否包含 script 标签
+ *
+ * @example
+ * ```typescript
+ * containsScriptTag('<div onclick="alert(1)">') // false
+ * containsScriptTag('<script>alert(1)</script>') // true
+ * ```
+ */
+declare function containsScriptTag(str: string): boolean;
+/**
+ * 验证字符串是否为合法的 JavaScript 标识符
+ *
+ * @description 检查名称是否以字母、下划线或美元符开头，
+ * 仅包含字母、数字、下划线和美元符，并排除可能导致原型污染的内置属性
+ *
+ * @param name - 待验证的标识符名称
+ * @throws 当名称不是合法标识符时抛出错误
+ * @throws 当名称为 JavaScript 内置属性时抛出错误
+ *
+ * @example
+ * ```typescript
+ * validateIdentifierName('__LOADING_MANAGER__') // 通过
+ * validateIdentifierName('123abc')              // 抛出错误
+ * validateIdentifierName('__proto__')           // 抛出错误（内置属性）
+ * ```
+ */
+declare function validateIdentifierName(name: string): void;
+
+export { containsScriptTag, makeCallback, validateIdentifierName };