@meng-xi/vite-plugin 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/README-en.md +8 -8
  2. package/README.md +7 -7
  3. package/dist/common/format/index.cjs +1 -1
  4. package/dist/common/format/index.d.cts +1 -130
  5. package/dist/common/format/index.d.mts +1 -130
  6. package/dist/common/format/index.d.ts +1 -130
  7. package/dist/common/format/index.mjs +1 -1
  8. package/dist/common/fs/index.cjs +1 -1
  9. package/dist/common/fs/index.d.cts +1 -89
  10. package/dist/common/fs/index.d.mts +1 -89
  11. package/dist/common/fs/index.d.ts +1 -89
  12. package/dist/common/fs/index.mjs +1 -1
  13. package/dist/common/html/index.cjs +2 -2
  14. package/dist/common/html/index.d.cts +4 -315
  15. package/dist/common/html/index.d.mts +4 -315
  16. package/dist/common/html/index.d.ts +4 -315
  17. package/dist/common/html/index.mjs +2 -2
  18. package/dist/common/index.cjs +1 -1
  19. package/dist/common/index.d.cts +7 -11
  20. package/dist/common/index.d.mts +7 -11
  21. package/dist/common/index.d.ts +7 -11
  22. package/dist/common/index.mjs +1 -1
  23. package/dist/common/script/index.cjs +1 -1
  24. package/dist/common/script/index.d.cts +1 -44
  25. package/dist/common/script/index.d.mts +1 -44
  26. package/dist/common/script/index.d.ts +1 -44
  27. package/dist/common/script/index.mjs +1 -1
  28. package/dist/common/ui/index.cjs +1 -1
  29. package/dist/common/ui/index.d.cts +1 -111
  30. package/dist/common/ui/index.d.mts +1 -111
  31. package/dist/common/ui/index.d.ts +1 -111
  32. package/dist/common/ui/index.mjs +1 -1
  33. package/dist/common/validation/index.cjs +1 -1
  34. package/dist/common/validation/index.d.cts +2 -80
  35. package/dist/common/validation/index.d.mts +2 -80
  36. package/dist/common/validation/index.d.ts +2 -80
  37. package/dist/common/validation/index.mjs +1 -1
  38. package/dist/factory/index.cjs +1 -1
  39. package/dist/factory/index.d.cts +1 -1
  40. package/dist/factory/index.d.mts +1 -1
  41. package/dist/factory/index.d.ts +1 -1
  42. package/dist/factory/index.mjs +1 -1
  43. package/dist/index.cjs +1 -1
  44. package/dist/index.d.cts +10 -12
  45. package/dist/index.d.mts +10 -12
  46. package/dist/index.d.ts +10 -12
  47. package/dist/index.mjs +1 -1
  48. package/dist/logger/index.d.cts +92 -1
  49. package/dist/logger/index.d.mts +92 -1
  50. package/dist/logger/index.d.ts +92 -1
  51. package/dist/plugins/autoImport/index.cjs +17 -0
  52. package/dist/plugins/autoImport/index.d.cts +291 -0
  53. package/dist/plugins/autoImport/index.d.mts +291 -0
  54. package/dist/plugins/autoImport/index.d.ts +291 -0
  55. package/dist/plugins/autoImport/index.mjs +17 -0
  56. package/dist/plugins/buildProgress/index.cjs +2 -2
  57. package/dist/plugins/buildProgress/index.d.cts +1 -1
  58. package/dist/plugins/buildProgress/index.d.mts +1 -1
  59. package/dist/plugins/buildProgress/index.d.ts +1 -1
  60. package/dist/plugins/buildProgress/index.mjs +2 -2
  61. package/dist/plugins/bundleAnalyzer/index.cjs +11 -11
  62. package/dist/plugins/bundleAnalyzer/index.d.cts +1 -1
  63. package/dist/plugins/bundleAnalyzer/index.d.mts +1 -1
  64. package/dist/plugins/bundleAnalyzer/index.d.ts +1 -1
  65. package/dist/plugins/bundleAnalyzer/index.mjs +18 -18
  66. package/dist/plugins/compressAssets/index.cjs +1 -1
  67. package/dist/plugins/compressAssets/index.d.cts +1 -1
  68. package/dist/plugins/compressAssets/index.d.mts +1 -1
  69. package/dist/plugins/compressAssets/index.d.ts +1 -1
  70. package/dist/plugins/compressAssets/index.mjs +1 -1
  71. package/dist/plugins/copyFile/index.cjs +1 -1
  72. package/dist/plugins/copyFile/index.d.cts +1 -1
  73. package/dist/plugins/copyFile/index.d.mts +1 -1
  74. package/dist/plugins/copyFile/index.d.ts +1 -1
  75. package/dist/plugins/copyFile/index.mjs +1 -1
  76. package/dist/plugins/envGuard/index.cjs +11 -11
  77. package/dist/plugins/envGuard/index.d.cts +101 -2
  78. package/dist/plugins/envGuard/index.d.mts +101 -2
  79. package/dist/plugins/envGuard/index.d.ts +101 -2
  80. package/dist/plugins/envGuard/index.mjs +8 -8
  81. package/dist/plugins/faviconManager/index.cjs +1 -1
  82. package/dist/plugins/faviconManager/index.d.cts +1 -1
  83. package/dist/plugins/faviconManager/index.d.mts +1 -1
  84. package/dist/plugins/faviconManager/index.d.ts +1 -1
  85. package/dist/plugins/faviconManager/index.mjs +1 -1
  86. package/dist/plugins/generateRouter/index.cjs +4 -4
  87. package/dist/plugins/generateRouter/index.d.cts +1 -1
  88. package/dist/plugins/generateRouter/index.d.mts +1 -1
  89. package/dist/plugins/generateRouter/index.d.ts +1 -1
  90. package/dist/plugins/generateRouter/index.mjs +4 -4
  91. package/dist/plugins/generateVersion/index.cjs +1 -1
  92. package/dist/plugins/generateVersion/index.d.cts +1 -1
  93. package/dist/plugins/generateVersion/index.d.mts +1 -1
  94. package/dist/plugins/generateVersion/index.d.ts +1 -1
  95. package/dist/plugins/generateVersion/index.mjs +1 -1
  96. package/dist/plugins/htmlInject/index.cjs +7 -1
  97. package/dist/plugins/htmlInject/index.d.cts +2 -2
  98. package/dist/plugins/htmlInject/index.d.mts +2 -2
  99. package/dist/plugins/htmlInject/index.d.ts +2 -2
  100. package/dist/plugins/htmlInject/index.mjs +7 -1
  101. package/dist/plugins/index.cjs +1 -1
  102. package/dist/plugins/index.d.cts +3 -3
  103. package/dist/plugins/index.d.mts +3 -3
  104. package/dist/plugins/index.d.ts +3 -3
  105. package/dist/plugins/index.mjs +1 -1
  106. package/dist/plugins/loadingManager/index.cjs +26 -26
  107. package/dist/plugins/loadingManager/index.d.cts +1 -1
  108. package/dist/plugins/loadingManager/index.d.mts +1 -1
  109. package/dist/plugins/loadingManager/index.d.ts +1 -1
  110. package/dist/plugins/loadingManager/index.mjs +11 -11
  111. package/dist/plugins/versionUpdateChecker/index.cjs +2 -2
  112. package/dist/plugins/versionUpdateChecker/index.d.cts +1 -1
  113. package/dist/plugins/versionUpdateChecker/index.d.mts +1 -1
  114. package/dist/plugins/versionUpdateChecker/index.d.ts +1 -1
  115. package/dist/plugins/versionUpdateChecker/index.mjs +3 -3
  116. package/dist/shared/vite-plugin.B8FuZce1.d.cts +45 -0
  117. package/dist/shared/vite-plugin.B8FuZce1.d.mts +45 -0
  118. package/dist/shared/vite-plugin.B8FuZce1.d.ts +45 -0
  119. package/dist/shared/{vite-plugin.FfJ-Wwfu.d.cts → vite-plugin.BI9taN75.d.cts} +1 -22
  120. package/dist/shared/{vite-plugin.FfJ-Wwfu.d.mts → vite-plugin.BI9taN75.d.mts} +1 -22
  121. package/dist/shared/{vite-plugin.FfJ-Wwfu.d.ts → vite-plugin.BI9taN75.d.ts} +1 -22
  122. package/dist/shared/vite-plugin.BPFqtmWa.mjs +1 -0
  123. package/dist/shared/vite-plugin.CnOy46d3.cjs +1 -0
  124. package/package.json +6 -16
  125. package/dist/common/compress/index.cjs +0 -1
  126. package/dist/common/compress/index.d.cts +0 -23
  127. package/dist/common/compress/index.d.mts +0 -23
  128. package/dist/common/compress/index.d.ts +0 -23
  129. package/dist/common/compress/index.mjs +0 -1
  130. package/dist/common/object/index.cjs +0 -1
  131. package/dist/common/object/index.d.cts +0 -30
  132. package/dist/common/object/index.d.mts +0 -30
  133. package/dist/common/object/index.d.ts +0 -30
  134. package/dist/common/object/index.mjs +0 -1
  135. package/dist/common/path/index.cjs +0 -1
  136. package/dist/common/path/index.d.cts +0 -22
  137. package/dist/common/path/index.d.mts +0 -22
  138. package/dist/common/path/index.d.ts +0 -22
  139. package/dist/common/path/index.mjs +0 -1
  140. package/dist/shared/vite-plugin.BCuhU1au.mjs +0 -7
  141. package/dist/shared/vite-plugin.BrI73DHA.cjs +0 -7
  142. package/dist/shared/vite-plugin.CLr0ttuO.d.cts +0 -135
  143. package/dist/shared/vite-plugin.CLr0ttuO.d.mts +0 -135
  144. package/dist/shared/vite-plugin.CLr0ttuO.d.ts +0 -135
  145. package/dist/shared/vite-plugin.CmtcnItg.d.cts +0 -261
  146. package/dist/shared/vite-plugin.CmtcnItg.d.mts +0 -261
  147. package/dist/shared/vite-plugin.CmtcnItg.d.ts +0 -261
  148. package/dist/shared/vite-plugin.DnFDPjNf.mjs +0 -1
  149. package/dist/shared/vite-plugin.Dumot0up.mjs +0 -1
  150. package/dist/shared/vite-plugin.soT9a-KD.cjs +0 -1
  151. package/dist/shared/vite-plugin.vwox4bU0.cjs +0 -1
@@ -1,235 +1,11 @@
1
- import { I as InjectCondition, b as SelectorMatch, a as InjectPosition, P as PositionInjectResult, S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.FfJ-Wwfu.js';
2
- export { C as ConditionType } from '../../shared/vite-plugin.FfJ-Wwfu.js';
1
+ import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.js';
2
+ export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.js';
3
3
 
4
- /**
5
- * HTML 注入工具模块
6
- *
7
- * @module common/html/inject
8
- * @description 提供高级 HTML 内容注入功能,包括选择器匹配、模板变量替换、
9
- * 条件判断、规则排序和多位置注入等能力,为插件提供灵活的 HTML 操作支持。
10
- */
11
-
12
- /**
13
- * 在 HTML 中查找选择器匹配位置
14
- *
15
- * @param html - 要搜索的 HTML 字符串
16
- * @param selector - 选择器字符串(普通字符串或正则表达式字符串)
17
- * @param selectorMatch - 匹配模式,`'string'` 为精确字符串匹配,`'regex'` 为正则匹配
18
- * @returns 匹配结果对象(包含 `index` 和 `length`),未匹配时返回 `null`
19
- *
20
- * @description 根据匹配模式在 HTML 中查找选择器的位置:
21
- * - 字符串模式:使用 `indexOf` 进行精确匹配
22
- * - 正则模式:使用 `RegExp` 进行正则匹配,正则语法错误时返回 `null`
23
- *
24
- * @example
25
- * ```typescript
26
- * // 字符串匹配
27
- * findSelectorMatch('<div id="app">content</div>', '<div id="app">')
28
- * // { index: 0, length: 14 }
29
- *
30
- * // 正则匹配
31
- * findSelectorMatch('<div class="foo">bar</div>', 'class="\\w+"', 'regex')
32
- * // { index: 5, length: 12 }
33
- *
34
- * // 未匹配
35
- * findSelectorMatch('<div>hello</div>', '<span>')
36
- * // null
37
- * ```
38
- */
39
- declare function findSelectorMatch(html: string, selector: string, selectorMatch?: SelectorMatch): {
40
- index: number;
41
- length: number;
42
- } | null;
43
- /**
44
- * 替换模板字符串中的变量占位符
45
- *
46
- * @param content - 包含 `{{变量名}}` 占位符的模板字符串
47
- * @param ruleVars - 规则级变量映射(优先级高于全局变量)
48
- * @param globalVars - 全局变量映射
49
- * @returns 替换所有匹配占位符后的字符串
50
- *
51
- * @description 将模板字符串中形如 `{{key}}` 的占位符替换为对应的值。
52
- * 规则变量(`ruleVars`)优先级高于全局变量(`globalVars`),
53
- * 当两者存在相同键时,规则变量的值会覆盖全局变量的值。
54
- * 变量名中的正则特殊字符会被自动转义,替换值中的 `$` 也会被安全处理。
55
- *
56
- * @example
57
- * ```typescript
58
- * // 基本替换
59
- * applyTemplateVars('<div>{{name}}</div>', { name: 'test' })
60
- * // '<div>test</div>'
61
- *
62
- * // 规则变量覆盖全局变量
63
- * applyTemplateVars('{{a}}-{{b}}', { a: '1' }, { a: '0', b: '2' })
64
- * // '1-2'
65
- *
66
- * // 无匹配占位符
67
- * applyTemplateVars('no vars', { x: 'y' })
68
- * // 'no vars'
69
- * ```
70
- */
71
- declare function applyTemplateVars(content: string, ruleVars?: Record<string, string>, globalVars?: Record<string, string>): string;
72
- /**
73
- * 评估注入条件是否满足
74
- *
75
- * @param condition - 注入条件配置
76
- * @param html - 当前 HTML 内容(用于 `file-contains` 类型判断)
77
- * @returns 条件是否满足(布尔值)
78
- *
79
- * @description 根据条件类型评估注入条件:
80
- * - `env`:检查环境变量是否存在且不为 `'false'` 或 `'0'`
81
- * - `file-contains`:检查 HTML 内容是否包含指定字符串
82
- * - `custom`:执行自定义函数,捕获异常时返回 `false`
83
- * - 支持通过 `negate` 字段对结果取反
84
- *
85
- * @example
86
- * ```typescript
87
- * // 环境变量判断
88
- * evaluateCondition({ type: 'env', value: 'ENABLE_ANALYTICS' }, '')
89
- *
90
- * // 内容包含判断
91
- * evaluateCondition({ type: 'file-contains', value: '<div id="app">' }, html)
92
- *
93
- * // 自定义函数(带取反)
94
- * evaluateCondition(
95
- * { type: 'custom', value: () => isDev(), negate: true },
96
- * html
97
- * )
98
- * ```
99
- */
100
- declare function evaluateCondition(condition: InjectCondition, html: string): boolean;
101
- /**
102
- * 按优先级排序规则列表
103
- *
104
- * @typeParam T - 规则类型,必须包含可选的 `priority` 字段
105
- * @param rules - 待排序的规则数组
106
- * @returns 按 `priority` 升序排列的新数组(不修改原数组)
107
- *
108
- * @description 将规则按 `priority` 字段升序排列,`priority` 越小优先级越高。
109
- * 未指定 `priority` 的规则默认优先级为 100。
110
- * 返回新数组,不修改原数组。
111
- *
112
- * @example
113
- * ```typescript
114
- * const rules = [
115
- * { priority: 30, name: 'C' },
116
- * { priority: 10, name: 'A' },
117
- * { name: 'D' }, // 默认 priority=100
118
- * { priority: 20, name: 'B' }
119
- * ]
120
- * sortRulesByPriority(rules)
121
- * // [{ priority: 10, name: 'A' }, { priority: 20, name: 'B' },
122
- * // { priority: 30, name: 'C' }, { name: 'D' }]
123
- * ```
124
- */
125
- declare function sortRulesByPriority<T extends {
126
- priority?: number;
127
- }>(rules: T[]): T[];
128
- /**
129
- * 在 HTML 的指定位置注入内容
130
- *
131
- * @param html - 原始 HTML 字符串
132
- * @param content - 要注入的内容
133
- * @param position - 注入位置
134
- * @param selector - 选择器字符串(仅 `before-selector`、`after-selector`、`replace-selector` 位置需要)
135
- * @param selectorMatch - 选择器匹配模式(默认为字符串匹配)
136
- * @returns 注入结果对象,包含注入后的 HTML、是否成功标志和失败原因
137
- *
138
- * @description 根据 `position` 参数将内容注入到 HTML 的指定位置:
139
- * - `head-start`:在 `<head>` 标签开始后注入
140
- * - `head-end`:在 `</head>` 标签前注入
141
- * - `body-start`:在 `<body>` 标签开始后注入
142
- * - `body-end`:在 `</body>` 标签前注入
143
- * - `before-selector`:在选择器匹配位置前注入
144
- * - `after-selector`:在选择器匹配位置后注入
145
- * - `replace-selector`:替换选择器匹配的内容
146
- *
147
- * 当目标标签或选择器未找到时,返回 `injected: false` 并附带 `reason` 说明。
148
- *
149
- * @example
150
- * ```typescript
151
- * const html = '<html><head><title>Test</title></head><body><div id="app"></div></body></html>'
152
- *
153
- * // 在 head 开始后注入 meta 标签
154
- * injectAtPosition(html, '<meta charset="utf-8">', 'head-start')
155
- *
156
- * // 在 body 结束前注入脚本
157
- * injectAtPosition(html, '<script>app()</script>', 'body-end')
158
- *
159
- * // 在指定元素前注入
160
- * injectAtPosition(html, '<nav>menu</nav>', 'before-selector', '<div id="app">')
161
- *
162
- * // 替换指定元素
163
- * injectAtPosition(html, '<div id="root"></div>', 'replace-selector', '<div id="app">')
164
- * ```
165
- */
166
- declare function injectAtPosition(html: string, content: string, position: InjectPosition, selector?: string, selectorMatch?: SelectorMatch): PositionInjectResult;
167
-
168
- /**
169
- * HTML 安全过滤模块
170
- *
171
- * @module common/html/security
172
- * @description 提供 HTML 内容安全过滤和验证功能,防止 XSS 攻击和危险内容注入,
173
- * 包括危险标签检测、危险属性过滤和安全配置验证等能力。
174
- */
175
-
176
- /**
177
- * 默认阻止的 HTML 标签列表
178
- *
179
- * @description 包含可能导致安全风险的 HTML 标签:
180
- * - `script`:可执行 JavaScript 代码
181
- * - `iframe`:可嵌入外部页面
182
- * - `object`/`embed`/`applet`:可嵌入插件
183
- * - `form`/`input`/`textarea`/`select`/`button`:可创建表单
184
- */
185
- declare const DEFAULT_BLOCKED_TAGS: string[];
186
- /**
187
- * 默认阻止的 HTML 事件属性列表
188
- *
189
- * @description 包含所有可能导致 JavaScript 执行的事件处理属性,
190
- * 涵盖鼠标事件、键盘事件、表单事件、拖拽事件和动画事件等。
191
- */
192
- declare const DEFAULT_BLOCKED_ATTRIBUTES: string[];
193
- /**
194
- * 验证安全配置的合法性
195
- *
196
- * @param security - 安全配置对象
197
- * @throws 当 `blockedTags` 不是字符串数组时抛出错误
198
- * @throws 当 `allowedTags` 不是字符串数组时抛出错误
199
- * @throws 当 `blockedAttributes` 不是字符串数组时抛出错误
200
- *
201
- * @description 检查安全配置中的数组字段是否为合法的字符串数组类型,
202
- * 传入 `undefined` 时直接跳过验证。
203
- *
204
- * @example
205
- * ```typescript
206
- * // 合法配置
207
- * validateSecurityConfig({ blockedTags: ['iframe'], allowedTags: ['div'] })
208
- *
209
- * // 非法配置(抛出错误)
210
- * validateSecurityConfig({ blockedTags: 'iframe' })
211
- * // Error: security.blockedTags 必须是字符串数组
212
- * ```
213
- */
214
- declare function validateSecurityConfig(security?: SecurityConfig): void;
215
4
  /**
216
5
  * 内容消毒规则选项
217
- *
218
- * @description 定义对单条注入规则内容进行安全过滤时的选项,
219
- * 控制是否允许脚本注入等特殊行为。
220
6
  */
221
7
  interface SanitizeRuleOptions {
222
- /** 规则标识符,用于错误消息和警告日志中标识来源规则 */
223
8
  id?: string;
224
- /**
225
- * 是否允许注入 `<script>` 标签和被阻止的标签/属性
226
- *
227
- * @description 设置为 `true` 时,将跳过对危险标签和属性的安全检查,
228
- * 但仍会输出警告日志提醒开发者注意安全风险。
229
- * 仅在注入内容来源可信时使用此选项。
230
- *
231
- * @default false
232
- */
233
9
  allowScriptInjection?: boolean;
234
10
  }
235
11
  /**
@@ -238,33 +14,8 @@ interface SanitizeRuleOptions {
238
14
  * @param content - 待过滤的 HTML 内容字符串
239
15
  * @param rule - 当前注入规则的消毒选项
240
16
  * @param security - 全局安全配置
241
- * @param logger - 日志记录器(需提供 `warn` 方法),用于输出安全警告
17
+ * @param logger - 日志记录器
242
18
  * @returns 过滤后的安全 HTML 内容字符串
243
- * @throws 当内容包含被阻止的标签且未启用 `allowScriptInjection` 时抛出错误
244
- * @throws 当内容包含危险属性且未启用 `allowScriptInjection` 时抛出错误
245
- *
246
- * @description 对 HTML 内容进行安全过滤,防止 XSS 攻击:
247
- * 1. **标签过滤**:检测并阻止默认阻止列表中的标签(如 script、iframe),
248
- * 可通过 `security.allowedTags` 放行特定标签
249
- * 2. **属性过滤**:检测并阻止事件处理属性(如 onclick、onerror)
250
- * 3. **脚本检测**:特别检测 `<script>` 标签,需要显式启用 `allowScriptInjection`
251
- *
252
- * 当 `rule.allowScriptInjection` 为 `true` 时,跳过安全检查但输出警告日志。
253
- *
254
- * @example
255
- * ```typescript
256
- * // 安全内容直接通过
257
- * sanitizeContent('<div>safe</div>', { id: 'rule1' })
258
- *
259
- * // 包含 script 标签(抛出错误)
260
- * sanitizeContent('<script>alert(1)</script>', { id: 'rule2' })
261
- *
262
- * // 允许脚本注入(通过但输出警告)
263
- * sanitizeContent('<script>alert(1)</script>', { id: 'rule3', allowScriptInjection: true }, undefined, console)
264
- *
265
- * // 自定义安全配置
266
- * sanitizeContent('<iframe>test</iframe>', { id: 'rule4' }, { allowedTags: ['iframe'] })
267
- * ```
268
19
  */
269
20
  declare function sanitizeContent(content: string, rule: SanitizeRuleOptions, security?: SecurityConfig, logger?: {
270
21
  warn: (msg: string) => void;
@@ -277,59 +28,8 @@ declare function sanitizeContent(content: string, rule: SanitizeRuleOptions, sec
277
28
  * @param tag - 目标闭合标签(如 `</head>`、`</body>`、`</html>`)
278
29
  * @param code - 要注入的代码
279
30
  * @returns 注入结果对象
280
- *
281
- * @example
282
- * ```typescript
283
- * // 在 </head> 前注入 CSS
284
- * const result = injectBeforeTag(html, '</head>', '<style>...</style>')
285
- *
286
- * // 在 </body> 前注入 JS
287
- * const result = injectBeforeTag(html, '</body>', '<script>...</script>')
288
- * ```
289
31
  */
290
32
  declare function injectBeforeTag(html: string, tag: string, code: string): HtmlInjectResult;
291
- /**
292
- * 按优先级向 HTML 中注入代码
293
- *
294
- * @description 依次尝试在 `</head>`、`</body>`、`</html>` 前注入代码,
295
- * 优先注入到靠前的标签位置。适用于需要注入到页面中但无特定位置要求的场景
296
- *
297
- * @param html - 原始 HTML 内容
298
- * @param code - 要注入的代码
299
- * @param targets - 目标标签优先级列表,默认为 `['</head>', '</body>', '</html>']`
300
- * @returns 注入结果对象
301
- *
302
- * @example
303
- * ```typescript
304
- * // 优先注入到 </body> 前
305
- * const result = injectHtmlByPriority(html, scriptCode, ['</body>', '</html>'])
306
- * ```
307
- */
308
- declare function injectHtmlByPriority(html: string, code: string, targets?: string[]): HtmlInjectResult;
309
- /**
310
- * 带回退策略的 HTML 注入
311
- *
312
- * @description 依次尝试在 `</body>`、`</html>` 前注入代码,
313
- * 如果均未找到目标标签,则将代码追加到 HTML 末尾。
314
- * 适用于需要注入到页面底部但不确定 HTML 结构是否完整的场景。
315
- *
316
- * @param html - 原始 HTML 内容
317
- * @param code - 要注入的代码
318
- * @param fallbackMessage - 回退到末尾时的警告信息,为空则不输出警告
319
- * @returns 注入结果对象,包含注入后的 HTML、是否成功标志和是否使用了回退策略
320
- *
321
- * @example
322
- * ```typescript
323
- * // 注入 JS 脚本到页面底部
324
- * const result = injectBeforeTagWithFallback(html, '<script>...</script>')
325
- *
326
- * // 带自定义警告信息
327
- * const result = injectBeforeTagWithFallback(html, scriptCode, '未找到 </body> 标签,代码追加到文件末尾')
328
- * ```
329
- */
330
- declare function injectBeforeTagWithFallback(html: string, code: string, _fallbackMessage?: string): HtmlInjectResult & {
331
- usedFallback: boolean;
332
- };
333
33
  /**
334
34
  * 双区域 HTML 注入(head + body)
335
35
  *
@@ -340,19 +40,8 @@ declare function injectBeforeTagWithFallback(html: string, code: string, _fallba
340
40
  * @param headCode - 注入到 `</head>` 前的代码(如 CSS、meta 标签),不提供则跳过 head 注入
341
41
  * @param bodyCode - 注入到 `</body>` 前的代码(如 JS 脚本),回退到 `</html>` 前或末尾
342
42
  * @returns 双区域注入结果对象
343
- *
344
- * @example
345
- * ```typescript
346
- * // CSS 注入到 head,JS 注入到 body
347
- * const result = injectHeadAndBody(html, '<style>...</style>', '<script>...</script>')
348
- * if (!result.headInjected) logger.warn('未找到 </head> 标签')
349
- * if (result.usedFallback) logger.warn('代码追加到文件末尾')
350
- *
351
- * // 仅注入到 body
352
- * const result = injectHeadAndBody(html, undefined, '<script>...</script>')
353
- * ```
354
43
  */
355
44
  declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
356
45
 
357
- export { DEFAULT_BLOCKED_ATTRIBUTES, DEFAULT_BLOCKED_TAGS, DualInjectResult, HtmlInjectResult, InjectCondition, InjectPosition, PositionInjectResult, SecurityConfig, SelectorMatch, applyTemplateVars, evaluateCondition, findSelectorMatch, injectAtPosition, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority, sanitizeContent, sortRulesByPriority, validateSecurityConfig };
46
+ export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
358
47
  export type { SanitizeRuleOptions };
@@ -1,2 +1,2 @@
1
- export{D as DEFAULT_BLOCKED_ATTRIBUTES,a as DEFAULT_BLOCKED_TAGS,b as applyTemplateVars,e as evaluateCondition,f as findSelectorMatch,i as injectAtPosition,s as sanitizeContent,c as sortRulesByPriority,v as validateSecurityConfig}from"../../shared/vite-plugin.BCuhU1au.mjs";import"../script/index.mjs";function c(e,t,i){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${i}
2
- ${t}`),injected:!0}:{html:e,injected:!1}}function s(e,t,i=["</head>","</body>","</html>"]){for(const n of i){const a=c(e,n,t);if(a.injected)return a}return{html:e+t,injected:!0}}function o(e,t,i){const n=c(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const a=c(e,"</html>",t);return a.injected?{...a,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function d(e,t,i){let n=e,a=!1;if(t){const r=c(n,"</head>",t);r.injected&&(n=r.html,a=!0)}const l=o(n,i);return{html:l.html,headInjected:a,bodyInjected:l.injected,usedFallback:l.usedFallback}}export{c as injectBeforeTag,o as injectBeforeTagWithFallback,d as injectHeadAndBody,s as injectHtmlByPriority};
1
+ export{s as sanitizeContent}from"../../shared/vite-plugin.BPFqtmWa.mjs";function a(e,t,l){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${l}
2
+ ${t}`),injected:!0}:{html:e,injected:!1}}function i(e,t,l){const n=a(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const c=a(e,"</html>",t);return c.injected?{...c,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function r(e,t,l){let n=e,c=!1;if(t){const s=a(n,"</head>",t);s.injected&&(n=s.html,c=!0)}const d=i(n,l);return{html:d.html,headInjected:c,bodyInjected:d.injected,usedFallback:d.usedFallback}}export{a as injectBeforeTag,r as injectHeadAndBody};
@@ -1 +1 @@
1
- "use strict";const common_compress_index=require("./compress/index.cjs"),common_format_index=require("./format/index.cjs"),common_fs_index=require("./fs/index.cjs"),common_html_index=require("./html/index.cjs"),common_object_index=require("./object/index.cjs"),common_path_index=require("./path/index.cjs"),common_script_index=require("./script/index.cjs"),common_ui_index=require("./ui/index.cjs"),validator=require("../shared/vite-plugin.Bcg6RW2N.cjs"),validators=require("../shared/vite-plugin.soT9a-KD.cjs"),env=require("../shared/vite-plugin.vwox4bU0.cjs"),security=require("../shared/vite-plugin.BrI73DHA.cjs");require("node:zlib"),require("node:stream/promises"),require("node:stream"),require("crypto"),require("node:path"),require("fs"),require("path"),exports.calculateGzipSize=common_compress_index.calculateGzipSize,exports.escapeHtmlAttr=common_format_index.escapeHtmlAttr,exports.formatDate=common_format_index.formatDate,exports.formatFileSize=common_format_index.formatFileSize,exports.generateRandomHash=common_format_index.generateRandomHash,exports.getDateFormatParams=common_format_index.getDateFormatParams,exports.getExtension=common_format_index.getExtension,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.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.scanDirectory=common_fs_index.scanDirectory,exports.shouldUpdateFile=common_fs_index.shouldUpdateFile,exports.writeFileContent=common_fs_index.writeFileContent,exports.writeJsonReport=common_fs_index.writeJsonReport,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.isNodeModule=common_path_index.isNodeModule,exports.containsScriptTag=common_script_index.containsScriptTag,exports.makeCallback=common_script_index.makeCallback,exports.validateIdentifierName=common_script_index.validateIdentifierName,exports.ANSI=common_ui_index.ANSI,exports.SPINNER_FRAMES=common_ui_index.SPINNER_FRAMES,exports.stripAnsi=common_ui_index.stripAnsi,exports.Validator=validator.Validator,exports.validateCallbackFields=validators.validateCallbackFields,exports.validateEnumValue=validators.validateEnumValue,exports.validateGlobalName=validators.validateGlobalName,exports.validateNestedDuration=validators.validateNestedDuration,exports.validateNoScriptInTemplate=validators.validateNoScriptInTemplate,exports.validateNonNegativeNumber=validators.validateNonNegativeNumber,exports.STRING_LIKE_TYPES=env.STRING_LIKE_TYPES,exports.validateEnvironment=env.validateEnvironment,exports.validateLength=env.validateLength,exports.validateRange=env.validateRange,exports.validateType=env.validateType,exports.validateValue=env.validateValue,exports.DEFAULT_BLOCKED_ATTRIBUTES=security.DEFAULT_BLOCKED_ATTRIBUTES,exports.DEFAULT_BLOCKED_TAGS=security.DEFAULT_BLOCKED_TAGS,exports.applyTemplateVars=security.applyTemplateVars,exports.evaluateCondition=security.evaluateCondition,exports.findSelectorMatch=security.findSelectorMatch,exports.injectAtPosition=security.injectAtPosition,exports.sanitizeContent=security.sanitizeContent,exports.sortRulesByPriority=security.sortRulesByPriority,exports.validateSecurityConfig=security.validateSecurityConfig;
1
+ "use strict";const common_format_index=require("./format/index.cjs"),common_fs_index=require("./fs/index.cjs"),common_html_index=require("./html/index.cjs"),common_script_index=require("./script/index.cjs"),common_ui_index=require("./ui/index.cjs"),validator=require("../shared/vite-plugin.Bcg6RW2N.cjs"),common_validation_index=require("./validation/index.cjs"),security=require("../shared/vite-plugin.CnOy46d3.cjs");require("fs"),require("path"),exports.formatFileSize=common_format_index.formatFileSize,exports.getDateFormatParams=common_format_index.getDateFormatParams,exports.checkSourceExists=common_fs_index.checkSourceExists,exports.copySourceToTarget=common_fs_index.copySourceToTarget,exports.scanDirectory=common_fs_index.scanDirectory,exports.writeFileContent=common_fs_index.writeFileContent,exports.writeJsonReport=common_fs_index.writeJsonReport,exports.injectBeforeTag=common_html_index.injectBeforeTag,exports.injectHeadAndBody=common_html_index.injectHeadAndBody,exports.makeCallback=common_script_index.makeCallback,exports.ANSI=common_ui_index.ANSI,exports.Validator=validator.Validator,exports.validateCallbackFields=common_validation_index.validateCallbackFields,exports.validateGlobalName=common_validation_index.validateGlobalName,exports.validateNoScriptInTemplate=common_validation_index.validateNoScriptInTemplate,exports.sanitizeContent=security.sanitizeContent;
@@ -1,12 +1,8 @@
1
- export { calculateGzipSize } from './compress/index.cjs';
2
- export { DateFormatOptions, escapeHtmlAttr, formatDate, formatFileSize, generateRandomHash, getDateFormatParams, getExtension, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './format/index.cjs';
3
- export { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, scanDirectory, shouldUpdateFile, writeFileContent, writeJsonReport } from './fs/index.cjs';
4
- export { DEFAULT_BLOCKED_ATTRIBUTES, DEFAULT_BLOCKED_TAGS, SanitizeRuleOptions, applyTemplateVars, evaluateCondition, findSelectorMatch, injectAtPosition, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority, sanitizeContent, sortRulesByPriority, validateSecurityConfig } from './html/index.cjs';
5
- export { deepMerge } from './object/index.cjs';
6
- export { isNodeModule } from './path/index.cjs';
7
- export { containsScriptTag, makeCallback, validateIdentifierName } from './script/index.cjs';
8
- export { ANSI, SPINNER_FRAMES, stripAnsi } from './ui/index.cjs';
1
+ export { DateFormatOptions, formatFileSize, getDateFormatParams } from './format/index.cjs';
2
+ export { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile, checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport } from './fs/index.cjs';
3
+ export { SanitizeRuleOptions, injectBeforeTag, injectHeadAndBody, sanitizeContent } from './html/index.cjs';
4
+ export { makeCallback } from './script/index.cjs';
5
+ export { ANSI } from './ui/index.cjs';
9
6
  export { V as Validator } from '../shared/vite-plugin.DRRlWY8P.cjs';
10
- export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './validation/index.cjs';
11
- export { E as EnvFieldRule, a as EnvType, b as EnvValidationResult, S as STRING_LIKE_TYPES, v as validateEnvironment, c as validateLength, d as validateRange, e as validateType, f as validateValue } from '../shared/vite-plugin.CmtcnItg.cjs';
12
- export { C as ConditionType, D as DualInjectResult, H as HtmlInjectResult, I as InjectCondition, a as InjectPosition, P as PositionInjectResult, S as SecurityConfig, b as SelectorMatch } from '../shared/vite-plugin.FfJ-Wwfu.cjs';
7
+ export { validateCallbackFields, validateGlobalName, validateNoScriptInTemplate } from './validation/index.cjs';
8
+ export { C as ConditionType, D as DualInjectResult, H as HtmlInjectResult, I as InjectCondition, a as InjectPosition, S as SecurityConfig, b as SelectorMatch } from '../shared/vite-plugin.BI9taN75.cjs';
@@ -1,12 +1,8 @@
1
- export { calculateGzipSize } from './compress/index.mjs';
2
- export { DateFormatOptions, escapeHtmlAttr, formatDate, formatFileSize, generateRandomHash, getDateFormatParams, getExtension, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './format/index.mjs';
3
- export { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, scanDirectory, shouldUpdateFile, writeFileContent, writeJsonReport } from './fs/index.mjs';
4
- export { DEFAULT_BLOCKED_ATTRIBUTES, DEFAULT_BLOCKED_TAGS, SanitizeRuleOptions, applyTemplateVars, evaluateCondition, findSelectorMatch, injectAtPosition, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority, sanitizeContent, sortRulesByPriority, validateSecurityConfig } from './html/index.mjs';
5
- export { deepMerge } from './object/index.mjs';
6
- export { isNodeModule } from './path/index.mjs';
7
- export { containsScriptTag, makeCallback, validateIdentifierName } from './script/index.mjs';
8
- export { ANSI, SPINNER_FRAMES, stripAnsi } from './ui/index.mjs';
1
+ export { DateFormatOptions, formatFileSize, getDateFormatParams } from './format/index.mjs';
2
+ export { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile, checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport } from './fs/index.mjs';
3
+ export { SanitizeRuleOptions, injectBeforeTag, injectHeadAndBody, sanitizeContent } from './html/index.mjs';
4
+ export { makeCallback } from './script/index.mjs';
5
+ export { ANSI } from './ui/index.mjs';
9
6
  export { V as Validator } from '../shared/vite-plugin.DRRlWY8P.mjs';
10
- export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './validation/index.mjs';
11
- export { E as EnvFieldRule, a as EnvType, b as EnvValidationResult, S as STRING_LIKE_TYPES, v as validateEnvironment, c as validateLength, d as validateRange, e as validateType, f as validateValue } from '../shared/vite-plugin.CmtcnItg.mjs';
12
- export { C as ConditionType, D as DualInjectResult, H as HtmlInjectResult, I as InjectCondition, a as InjectPosition, P as PositionInjectResult, S as SecurityConfig, b as SelectorMatch } from '../shared/vite-plugin.FfJ-Wwfu.mjs';
7
+ export { validateCallbackFields, validateGlobalName, validateNoScriptInTemplate } from './validation/index.mjs';
8
+ export { C as ConditionType, D as DualInjectResult, H as HtmlInjectResult, I as InjectCondition, a as InjectPosition, S as SecurityConfig, b as SelectorMatch } from '../shared/vite-plugin.BI9taN75.mjs';
@@ -1,12 +1,8 @@
1
- export { calculateGzipSize } from './compress/index.js';
2
- export { DateFormatOptions, escapeHtmlAttr, formatDate, formatFileSize, generateRandomHash, getDateFormatParams, getExtension, padNumber, parseTemplate, stripJsonComments, toCamelCase, toPascalCase } from './format/index.js';
3
- export { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile, checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, scanDirectory, shouldUpdateFile, writeFileContent, writeJsonReport } from './fs/index.js';
4
- export { DEFAULT_BLOCKED_ATTRIBUTES, DEFAULT_BLOCKED_TAGS, SanitizeRuleOptions, applyTemplateVars, evaluateCondition, findSelectorMatch, injectAtPosition, injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority, sanitizeContent, sortRulesByPriority, validateSecurityConfig } from './html/index.js';
5
- export { deepMerge } from './object/index.js';
6
- export { isNodeModule } from './path/index.js';
7
- export { containsScriptTag, makeCallback, validateIdentifierName } from './script/index.js';
8
- export { ANSI, SPINNER_FRAMES, stripAnsi } from './ui/index.js';
1
+ export { DateFormatOptions, formatFileSize, getDateFormatParams } from './format/index.js';
2
+ export { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile, checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport } from './fs/index.js';
3
+ export { SanitizeRuleOptions, injectBeforeTag, injectHeadAndBody, sanitizeContent } from './html/index.js';
4
+ export { makeCallback } from './script/index.js';
5
+ export { ANSI } from './ui/index.js';
9
6
  export { V as Validator } from '../shared/vite-plugin.DRRlWY8P.js';
10
- export { validateCallbackFields, validateEnumValue, validateGlobalName, validateNestedDuration, validateNoScriptInTemplate, validateNonNegativeNumber } from './validation/index.js';
11
- export { E as EnvFieldRule, a as EnvType, b as EnvValidationResult, S as STRING_LIKE_TYPES, v as validateEnvironment, c as validateLength, d as validateRange, e as validateType, f as validateValue } from '../shared/vite-plugin.CmtcnItg.js';
12
- export { C as ConditionType, D as DualInjectResult, H as HtmlInjectResult, I as InjectCondition, a as InjectPosition, P as PositionInjectResult, S as SecurityConfig, b as SelectorMatch } from '../shared/vite-plugin.FfJ-Wwfu.js';
7
+ export { validateCallbackFields, validateGlobalName, validateNoScriptInTemplate } from './validation/index.js';
8
+ export { C as ConditionType, D as DualInjectResult, H as HtmlInjectResult, I as InjectCondition, a as InjectPosition, S as SecurityConfig, b as SelectorMatch } from '../shared/vite-plugin.BI9taN75.js';
@@ -1 +1 @@
1
- export{calculateGzipSize}from"./compress/index.mjs";export{escapeHtmlAttr,formatDate,formatFileSize,generateRandomHash,getDateFormatParams,getExtension,padNumber,parseTemplate,stripJsonComments,toCamelCase,toPascalCase}from"./format/index.mjs";export{checkSourceExists,copySourceToTarget,ensureTargetDir,fileExists,readDirRecursive,readFileContent,readFileSync,runWithConcurrency,scanDirectory,shouldUpdateFile,writeFileContent,writeJsonReport}from"./fs/index.mjs";export{injectBeforeTag,injectBeforeTagWithFallback,injectHeadAndBody,injectHtmlByPriority}from"./html/index.mjs";export{deepMerge}from"./object/index.mjs";export{isNodeModule}from"./path/index.mjs";export{containsScriptTag,makeCallback,validateIdentifierName}from"./script/index.mjs";export{ANSI,SPINNER_FRAMES,stripAnsi}from"./ui/index.mjs";export{V as Validator}from"../shared/vite-plugin.DcExl6jd.mjs";export{v as validateCallbackFields,a as validateEnumValue,b as validateGlobalName,c as validateNestedDuration,d as validateNoScriptInTemplate,e as validateNonNegativeNumber}from"../shared/vite-plugin.Dumot0up.mjs";export{S as STRING_LIKE_TYPES,v as validateEnvironment,a as validateLength,b as validateRange,c as validateType,d as validateValue}from"../shared/vite-plugin.DnFDPjNf.mjs";export{D as DEFAULT_BLOCKED_ATTRIBUTES,a as DEFAULT_BLOCKED_TAGS,b as applyTemplateVars,e as evaluateCondition,f as findSelectorMatch,i as injectAtPosition,s as sanitizeContent,c as sortRulesByPriority,v as validateSecurityConfig}from"../shared/vite-plugin.BCuhU1au.mjs";import"node:zlib";import"node:stream/promises";import"node:stream";import"crypto";import"node:path";import"fs";import"path";
1
+ export{formatFileSize,getDateFormatParams}from"./format/index.mjs";export{checkSourceExists,copySourceToTarget,scanDirectory,writeFileContent,writeJsonReport}from"./fs/index.mjs";export{injectBeforeTag,injectHeadAndBody}from"./html/index.mjs";export{makeCallback}from"./script/index.mjs";export{ANSI}from"./ui/index.mjs";export{V as Validator}from"../shared/vite-plugin.DcExl6jd.mjs";export{validateCallbackFields,validateGlobalName,validateNoScriptInTemplate}from"./validation/index.mjs";export{s as sanitizeContent}from"../shared/vite-plugin.BPFqtmWa.mjs";import"fs";import"path";
@@ -1 +1 @@
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;
1
+ "use strict";function makeCallback(c,r="callback",e=""){return c?`function(${e}) { try { ${c} } catch(e) { console.error('[${r}] error:', e); } }`:`function(${e}) {}`}exports.makeCallback=makeCallback;
@@ -5,50 +5,7 @@
5
5
  * @param context - 回调上下文标识,用于错误日志
6
6
  * @param params - 函数参数列表字符串,默认为空
7
7
  * @returns 安全的函数表达式字符串(包含 try-catch 保护)
8
- *
9
- * @example
10
- * ```typescript
11
- * makeCallback('console.log("done")')
12
- * // 'function() { try { console.log("done") } catch(e) { console.error('[callback] error:', e); } }'
13
- *
14
- * makeCallback('console.log(a, b)', 'callback', 'a, b')
15
- * // 'function(a, b) { try { console.log(a, b) } catch(e) { console.error('[callback] error:', e); } }'
16
- *
17
- * makeCallback('')
18
- * // 'function() {}'
19
- * ```
20
8
  */
21
9
  declare function makeCallback(body?: string, context?: string, params?: string): string;
22
- /**
23
- * 检测字符串是否包含 `<script>` 标签
24
- *
25
- * @param str - 待检测的字符串
26
- * @returns 是否包含 script 标签
27
- *
28
- * @example
29
- * ```typescript
30
- * containsScriptTag('<div onclick="alert(1)">') // false
31
- * containsScriptTag('<script>alert(1)</script>') // true
32
- * ```
33
- */
34
- declare function containsScriptTag(str: string): boolean;
35
- /**
36
- * 验证字符串是否为合法的 JavaScript 标识符
37
- *
38
- * @description 检查名称是否以字母、下划线或美元符开头,
39
- * 仅包含字母、数字、下划线和美元符,并排除可能导致原型污染的内置属性
40
- *
41
- * @param name - 待验证的标识符名称
42
- * @throws 当名称不是合法标识符时抛出错误
43
- * @throws 当名称为 JavaScript 内置属性时抛出错误
44
- *
45
- * @example
46
- * ```typescript
47
- * validateIdentifierName('__LOADING_MANAGER__') // 通过
48
- * validateIdentifierName('123abc') // 抛出错误
49
- * validateIdentifierName('__proto__') // 抛出错误(内置属性)
50
- * ```
51
- */
52
- declare function validateIdentifierName(name: string): void;
53
10
 
54
- export { containsScriptTag, makeCallback, validateIdentifierName };
11
+ export { makeCallback };
@@ -5,50 +5,7 @@
5
5
  * @param context - 回调上下文标识,用于错误日志
6
6
  * @param params - 函数参数列表字符串,默认为空
7
7
  * @returns 安全的函数表达式字符串(包含 try-catch 保护)
8
- *
9
- * @example
10
- * ```typescript
11
- * makeCallback('console.log("done")')
12
- * // 'function() { try { console.log("done") } catch(e) { console.error('[callback] error:', e); } }'
13
- *
14
- * makeCallback('console.log(a, b)', 'callback', 'a, b')
15
- * // 'function(a, b) { try { console.log(a, b) } catch(e) { console.error('[callback] error:', e); } }'
16
- *
17
- * makeCallback('')
18
- * // 'function() {}'
19
- * ```
20
8
  */
21
9
  declare function makeCallback(body?: string, context?: string, params?: string): string;
22
- /**
23
- * 检测字符串是否包含 `<script>` 标签
24
- *
25
- * @param str - 待检测的字符串
26
- * @returns 是否包含 script 标签
27
- *
28
- * @example
29
- * ```typescript
30
- * containsScriptTag('<div onclick="alert(1)">') // false
31
- * containsScriptTag('<script>alert(1)</script>') // true
32
- * ```
33
- */
34
- declare function containsScriptTag(str: string): boolean;
35
- /**
36
- * 验证字符串是否为合法的 JavaScript 标识符
37
- *
38
- * @description 检查名称是否以字母、下划线或美元符开头,
39
- * 仅包含字母、数字、下划线和美元符,并排除可能导致原型污染的内置属性
40
- *
41
- * @param name - 待验证的标识符名称
42
- * @throws 当名称不是合法标识符时抛出错误
43
- * @throws 当名称为 JavaScript 内置属性时抛出错误
44
- *
45
- * @example
46
- * ```typescript
47
- * validateIdentifierName('__LOADING_MANAGER__') // 通过
48
- * validateIdentifierName('123abc') // 抛出错误
49
- * validateIdentifierName('__proto__') // 抛出错误(内置属性)
50
- * ```
51
- */
52
- declare function validateIdentifierName(name: string): void;
53
10
 
54
- export { containsScriptTag, makeCallback, validateIdentifierName };
11
+ export { makeCallback };
@@ -5,50 +5,7 @@
5
5
  * @param context - 回调上下文标识,用于错误日志
6
6
  * @param params - 函数参数列表字符串,默认为空
7
7
  * @returns 安全的函数表达式字符串(包含 try-catch 保护)
8
- *
9
- * @example
10
- * ```typescript
11
- * makeCallback('console.log("done")')
12
- * // 'function() { try { console.log("done") } catch(e) { console.error('[callback] error:', e); } }'
13
- *
14
- * makeCallback('console.log(a, b)', 'callback', 'a, b')
15
- * // 'function(a, b) { try { console.log(a, b) } catch(e) { console.error('[callback] error:', e); } }'
16
- *
17
- * makeCallback('')
18
- * // 'function() {}'
19
- * ```
20
8
  */
21
9
  declare function makeCallback(body?: string, context?: string, params?: string): string;
22
- /**
23
- * 检测字符串是否包含 `<script>` 标签
24
- *
25
- * @param str - 待检测的字符串
26
- * @returns 是否包含 script 标签
27
- *
28
- * @example
29
- * ```typescript
30
- * containsScriptTag('<div onclick="alert(1)">') // false
31
- * containsScriptTag('<script>alert(1)</script>') // true
32
- * ```
33
- */
34
- declare function containsScriptTag(str: string): boolean;
35
- /**
36
- * 验证字符串是否为合法的 JavaScript 标识符
37
- *
38
- * @description 检查名称是否以字母、下划线或美元符开头,
39
- * 仅包含字母、数字、下划线和美元符,并排除可能导致原型污染的内置属性
40
- *
41
- * @param name - 待验证的标识符名称
42
- * @throws 当名称不是合法标识符时抛出错误
43
- * @throws 当名称为 JavaScript 内置属性时抛出错误
44
- *
45
- * @example
46
- * ```typescript
47
- * validateIdentifierName('__LOADING_MANAGER__') // 通过
48
- * validateIdentifierName('123abc') // 抛出错误
49
- * validateIdentifierName('__proto__') // 抛出错误(内置属性)
50
- * ```
51
- */
52
- declare function validateIdentifierName(name: string): void;
53
10
 
54
- export { containsScriptTag, makeCallback, validateIdentifierName };
11
+ export { makeCallback };
@@ -1 +1 @@
1
- function r(u,F="callback",t=""){return u?`function(${t}) { try { ${u} } catch(e) { console.error('[${F}] error:', e); } }`:`function(${t}) {}`}function o(u){return/<script\b/i.test(u)}function c(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`)}export{o as containsScriptTag,r as makeCallback,c as validateIdentifierName};
1
+ function o(c,e="callback",r=""){return c?`function(${r}) { try { ${c} } catch(e) { console.error('[${e}] error:', e); } }`:`function(${r}) {}`}export{o as makeCallback};
@@ -1 +1 @@
1
- "use strict";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:r=>`\x1B[32m${r}\x1B[39m`,cyan:r=>`\x1B[36m${r}\x1B[39m`,gray:r=>`\x1B[90m${r}\x1B[39m`,bold:r=>`\x1B[1m${r}\x1B[22m`,red:r=>`\x1B[31m${r}\x1B[39m`,yellow:r=>`\x1B[33m${r}\x1B[39m`,magenta:r=>`\x1B[35m${r}\x1B[39m`},x=/\x1b\[[0-9;]*m/g;function stripAnsi(r){return r.replace(x,"")}exports.ANSI=ANSI,exports.SPINNER_FRAMES=SPINNER_FRAMES,exports.stripAnsi=stripAnsi;
1
+ "use strict";const ANSI={reset:"\x1B[0G",clearLine:"\x1B[2K",hideCursor:"\x1B[?25l",showCursor:"\x1B[?25h",green:x=>`\x1B[32m${x}\x1B[39m`,cyan:x=>`\x1B[36m${x}\x1B[39m`,gray:x=>`\x1B[90m${x}\x1B[39m`,bold:x=>`\x1B[1m${x}\x1B[22m`,red:x=>`\x1B[31m${x}\x1B[39m`,yellow:x=>`\x1B[33m${x}\x1B[39m`,magenta:x=>`\x1B[35m${x}\x1B[39m`};exports.ANSI=ANSI;