@meng-xi/vite-plugin 0.1.3 → 0.1.5

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

@@ -45,75 +45,12 @@ interface CopyResult {
     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 源文件或目录路径
@@ -130,21 +67,6 @@ declare function copySourceToTarget(sourcePath: string, targetPath: string, opti
  * @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;
 /**
  * 扫描目录中的文件信息
  */
@@ -177,20 +99,11 @@ interface ScanDirectoryOptions {
  *
  * @description 递归遍历指定目录下的所有文件，收集每个文件的大小和扩展名信息，
  * 支持按扩展名、路径模式和自定义过滤函数进行过滤。
- * 这是通用的目录扫描函数，可被不同插件复用。
  *
  * @example
  * ```typescript
- * // 扫描所有 .js 文件
  * const jsFiles = await scanDirectory('dist', { includeExtensions: ['.js'] })
- *
- * // 排除 node_modules
  * const files = await scanDirectory('dist', { excludePatterns: ['node_modules'] })
- *
- * // 使用自定义过滤
- * const largeFiles = await scanDirectory('dist', {
- *   filter: (filePath, ext, size) => size > 1024
- * })
  * ```
  */
 declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions): Promise<ScannedFile[]>;
@@ -209,10 +122,9 @@ declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions):
  * @example
  * ```typescript
  * await writeJsonReport('dist/report.json', { timestamp: Date.now(), stats: [] })
- * await writeJsonReport('dist/report.json', data, 4)
  * ```
  */
 declare function writeJsonReport(filePath: string, data: object, indent?: number): Promise<void>;
 
-export { checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, scanDirectory, shouldUpdateFile, writeFileContent, writeJsonReport };
+export { checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport };
 export type { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile };

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

@@ -45,75 +45,12 @@ interface CopyResult {
     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 源文件或目录路径
@@ -130,21 +67,6 @@ declare function copySourceToTarget(sourcePath: string, targetPath: string, opti
  * @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;
 /**
  * 扫描目录中的文件信息
  */
@@ -177,20 +99,11 @@ interface ScanDirectoryOptions {
  *
  * @description 递归遍历指定目录下的所有文件，收集每个文件的大小和扩展名信息，
  * 支持按扩展名、路径模式和自定义过滤函数进行过滤。
- * 这是通用的目录扫描函数，可被不同插件复用。
  *
  * @example
  * ```typescript
- * // 扫描所有 .js 文件
  * const jsFiles = await scanDirectory('dist', { includeExtensions: ['.js'] })
- *
- * // 排除 node_modules
  * const files = await scanDirectory('dist', { excludePatterns: ['node_modules'] })
- *
- * // 使用自定义过滤
- * const largeFiles = await scanDirectory('dist', {
- *   filter: (filePath, ext, size) => size > 1024
- * })
  * ```
  */
 declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions): Promise<ScannedFile[]>;
@@ -209,10 +122,9 @@ declare function scanDirectory(dirPath: string, options?: ScanDirectoryOptions):
  * @example
  * ```typescript
  * await writeJsonReport('dist/report.json', { timestamp: Date.now(), stats: [] })
- * await writeJsonReport('dist/report.json', data, 4)
  * ```
  */
 declare function writeJsonReport(filePath: string, data: object, indent?: number): Promise<void>;
 
-export { checkSourceExists, copySourceToTarget, ensureTargetDir, fileExists, readDirRecursive, readFileContent, readFileSync, runWithConcurrency, scanDirectory, shouldUpdateFile, writeFileContent, writeJsonReport };
+export { checkSourceExists, copySourceToTarget, scanDirectory, writeFileContent, writeJsonReport };
 export type { CopyOptions, CopyResult, ScanDirectoryOptions, ScannedFile };

package/dist/common/fs/index.mjs

@@ -1 +1 @@
-import r from"fs";import w from"path";const T=10;async function k(u){try{await r.promises.access(u,r.constants.F_OK)}catch(t){const e=t;throw e.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${u}`):e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${u}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function D(u){try{await r.promises.mkdir(u,{recursive:!0})}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${u}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function h(u,t){const e=await r.promises.readdir(u,{withFileTypes:!0}),i=[];for(const n of e){const a=w.join(u,n.name),F=n.isFile(),c=n.isDirectory();if(i.push({path:a,isFile:F,isDirectory:c}),c&&t){const E=await h(a,t);i.push(...E)}}return i}async function B(u,t){try{const[e,i]=await Promise.all([r.promises.stat(u),r.promises.stat(t)]);return e.mtimeMs>i.mtimeMs||e.size!==i.size}catch{return!0}}async function C(u){try{return await r.promises.access(u,r.constants.F_OK),!0}catch{return!1}}async function g(u,t,e){const i=[];let n=0;async function a(){for(;n<u.length;){const c=n++,E=await t(u[c]);i[c]=E}}const F=Array(Math.min(e,u.length)).fill(null).map(()=>a());return await Promise.all(F),i}async function v(u,t,e){const i=Date.now(),{recursive:n,overwrite:a,incremental:F=!1,parallelLimit:c=T}=e;let E=0,p=0,l=0;if((await r.promises.stat(u)).isDirectory()){await D(t);const o=await h(u,n),f=o.filter(s=>s.isFile);l=o.filter(s=>s.isDirectory).length;const $=new Set;for(const s of f){const A=w.relative(u,s.path),y=w.dirname(w.join(t,A));$.add(y)}await Promise.all([...$].map(s=>D(s)));const x=await g(f,async s=>{const A=w.relative(u,s.path),y=w.join(t,A);let d=a;return d||(d=!await C(y)),F&&d&&(d=await B(s.path,y)),d?(await r.promises.copyFile(s.path,y),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},c);for(const s of x)s.copied&&E++,s.skipped&&p++}else{await D(w.dirname(t));let o=a;o||(o=!await C(t)),F&&o&&(o=await B(u,t)),o?(await r.promises.copyFile(u,t),E++):p++}const m=Date.now()-i;return{copiedFiles:E,skippedFiles:p,copiedDirs:l,executionTime:m}}async function S(u,t){try{await r.promises.writeFile(u,t,"utf-8")}catch(e){const i=e;throw i.code==="EACCES"?new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u5199\u5165\u6587\u4EF6 - ${u}`):new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u5199\u5165\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${i.message}`)}}async function z(u){try{return await r.promises.readFile(u,"utf-8")}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${u}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}function P(u){try{return r.readFileSync(u,"utf-8")}catch(t){const e=t;throw e.code==="EACCES"?new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BFB\u53D6\u6587\u4EF6 - ${u}`):new Error(`\u8BFB\u53D6\u6587\u4EF6\u5931\u8D25\uFF1A\u8BFB\u53D6\u6587\u4EF6\u65F6\u51FA\u9519 - ${u}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function j(u,t={}){const{includeExtensions:e=[],excludePatterns:i=[],filter:n}=t,a=[];async function F(c){const E=await r.promises.readdir(c,{withFileTypes:!0});for(const p of E){const l=w.join(c,p.name);if(p.isDirectory()){await F(l);continue}if(!p.isFile()||i.some(f=>f.startsWith("*")?l.endsWith(f.slice(1)):l.includes(f)))continue;const m=w.extname(p.name).toLowerCase();if(e.length>0&&!e.includes(m))continue;const o=await r.promises.stat(l);n&&!n(l,m,o.size)||a.push({filePath:l,size:o.size,extension:m})}}return await F(u),a}async function O(u,t,e=2){await S(u,JSON.stringify(t,null,e))}export{k as checkSourceExists,v as copySourceToTarget,D as ensureTargetDir,C as fileExists,h as readDirRecursive,z as readFileContent,P as readFileSync,g as runWithConcurrency,j as scanDirectory,B as shouldUpdateFile,S as writeFileContent,O as writeJsonReport};
+import n from"fs";import p from"path";const S=10;async function T(t){try{await n.promises.access(t,n.constants.F_OK)}catch(u){const e=u;throw e.code==="ENOENT"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6E90\u6587\u4EF6\u4E0D\u5B58\u5728 - ${t}`):e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u8BBF\u95EE\u6E90\u6587\u4EF6 - ${t}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u68C0\u67E5\u6E90\u6587\u4EF6\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function D(t){try{await n.promises.mkdir(t,{recursive:!0})}catch(u){const e=u;throw e.code==="EACCES"?new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u521B\u5EFA\u76EE\u6807\u76EE\u5F55 - ${t}`):new Error(`\u590D\u5236\u6587\u4EF6\u5931\u8D25\uFF1A\u521B\u5EFA\u76EE\u6807\u76EE\u5F55\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${e.message}`)}}async function C(t,u){const e=await n.promises.readdir(t,{withFileTypes:!0}),i=[];for(const o of e){const r=p.join(t,o.name),F=o.isFile(),c=o.isDirectory();if(i.push({path:r,isFile:F,isDirectory:c}),c&&u){const l=await C(r,u);i.push(...l)}}return i}async function g(t,u){try{const[e,i]=await Promise.all([n.promises.stat(t),n.promises.stat(u)]);return e.mtimeMs>i.mtimeMs||e.size!==i.size}catch{return!0}}async function $(t){try{return await n.promises.access(t,n.constants.F_OK),!0}catch{return!1}}async function k(t,u,e){const i=[];let o=0;async function r(){for(;o<t.length;){const c=o++,l=await u(t[c]);i[c]=l}}const F=Array(Math.min(e,t.length)).fill(null).map(()=>r());return await Promise.all(F),i}async function v(t,u,e){const i=Date.now(),{recursive:o,overwrite:r,incremental:F=!1,parallelLimit:c=S}=e;let l=0,w=0,E=0;if((await n.promises.stat(t)).isDirectory()){await D(u);const a=await C(t,o),f=a.filter(s=>s.isFile);E=a.filter(s=>s.isDirectory).length;const A=new Set;for(const s of f){const h=p.relative(t,s.path),y=p.dirname(p.join(u,h));A.add(y)}await Promise.all([...A].map(s=>D(s)));const B=await k(f,async s=>{const h=p.relative(t,s.path),y=p.join(u,h);let d=r;return d||(d=!await $(y)),F&&d&&(d=await g(s.path,y)),d?(await n.promises.copyFile(s.path,y),{copied:!0,skipped:!1}):{copied:!1,skipped:!0}},c);for(const s of B)s.copied&&l++,s.skipped&&w++}else{await D(p.dirname(u));let a=r;a||(a=!await $(u)),F&&a&&(a=await g(t,u)),a?(await n.promises.copyFile(t,u),l++):w++}const m=Date.now()-i;return{copiedFiles:l,skippedFiles:w,copiedDirs:E,executionTime:m}}async function x(t,u){try{await n.promises.writeFile(t,u,"utf-8")}catch(e){const i=e;throw i.code==="EACCES"?new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u6CA1\u6709\u6743\u9650\u5199\u5165\u6587\u4EF6 - ${t}`):new Error(`\u5199\u5165\u6587\u4EF6\u5931\u8D25\uFF1A\u5199\u5165\u6587\u4EF6\u65F6\u51FA\u9519 - ${t}\uFF0C\u9519\u8BEF\uFF1A${i.message}`)}}async function z(t,u={}){const{includeExtensions:e=[],excludePatterns:i=[],filter:o}=u,r=[];async function F(c){const l=await n.promises.readdir(c,{withFileTypes:!0});for(const w of l){const E=p.join(c,w.name);if(w.isDirectory()){await F(E);continue}if(!w.isFile()||i.some(f=>f.startsWith("*")?E.endsWith(f.slice(1)):E.includes(f)))continue;const m=p.extname(w.name).toLowerCase();if(e.length>0&&!e.includes(m))continue;const a=await n.promises.stat(E);o&&!o(E,m,a.size)||r.push({filePath:E,size:a.size,extension:m})}}return await F(t),r}async function P(t,u,e=2){await x(t,JSON.stringify(u,null,e))}export{T as checkSourceExists,v as copySourceToTarget,z as scanDirectory,x as writeFileContent,P as writeJsonReport};

package/dist/common/html/index.cjs

@@ -1,2 +1,2 @@
-"use strict";function injectBeforeTag(e,t,l){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${l}
-${t}`),injected:!0}:{html:e,injected:!1}}function injectHtmlByPriority(e,t,l=["</head>","</body>","</html>"]){for(const n of l){const c=injectBeforeTag(e,n,t);if(c.injected)return c}return{html:e+t,injected:!0}}function injectBeforeTagWithFallback(e,t,l){const n=injectBeforeTag(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const c=injectBeforeTag(e,"</html>",t);return c.injected?{...c,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function injectHeadAndBody(e,t,l){let n=e,c=!1;if(t){const i=injectBeforeTag(n,"</head>",t);i.injected&&(n=i.html,c=!0)}const r=injectBeforeTagWithFallback(n,l);return{html:r.html,headInjected:c,bodyInjected:r.injected,usedFallback:r.usedFallback}}exports.injectBeforeTag=injectBeforeTag,exports.injectBeforeTagWithFallback=injectBeforeTagWithFallback,exports.injectHeadAndBody=injectHeadAndBody,exports.injectHtmlByPriority=injectHtmlByPriority;
+"use strict";const security=require("../../shared/vite-plugin.CnOy46d3.cjs");function injectBeforeTag(e,t,s){const n=new RegExp(t,"i");return n.test(e)?{html:e.replace(n,`${s}
+${t}`),injected:!0}:{html:e,injected:!1}}function c(e,t,s){const n=injectBeforeTag(e,"</body>",t);if(n.injected)return{...n,usedFallback:!1};const i=injectBeforeTag(e,"</html>",t);return i.injected?{...i,usedFallback:!1}:{html:e+t,injected:!0,usedFallback:!0}}function injectHeadAndBody(e,t,s){let n=e,i=!1;if(t){const d=injectBeforeTag(n,"</head>",t);d.injected&&(n=d.html,i=!0)}const l=c(n,s);return{html:l.html,headInjected:i,bodyInjected:l.injected,usedFallback:l.usedFallback}}exports.sanitizeContent=security.sanitizeContent,exports.injectBeforeTag=injectBeforeTag,exports.injectHeadAndBody=injectHeadAndBody;

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

@@ -1,25 +1,25 @@
+import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.cjs';
+export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.cjs';
+
 /**
- * HTML 注入结果
+ * 内容消毒规则选项
  */
-interface HtmlInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** 是否成功注入 */
-    injected: boolean;
+interface SanitizeRuleOptions {
+    id?: string;
+    allowScriptInjection?: boolean;
 }
 /**
- * 双区域 HTML 注入结果
+ * 对注入内容进行安全过滤
+ *
+ * @param content - 待过滤的 HTML 内容字符串
+ * @param rule - 当前注入规则的消毒选项
+ * @param security - 全局安全配置
+ * @param logger - 日志记录器
+ * @returns 过滤后的安全 HTML 内容字符串
  */
-interface DualInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** head 区域是否成功注入 */
-    headInjected: boolean;
-    /** body 区域是否成功注入 */
-    bodyInjected: boolean;
-    /** body 注入是否使用了回退策略（追加到末尾） */
-    usedFallback: boolean;
-}
+declare function sanitizeContent(content: string, rule: SanitizeRuleOptions, security?: SecurityConfig, logger?: {
+    warn: (msg: string) => void;
+}): string;
 
 /**
  * 在 HTML 中指定闭合标签前注入代码
@@ -28,59 +28,8 @@ interface DualInjectResult {
  * @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;
-/**
- * 带回退策略的 HTML 注入
- *
- * @description 依次尝试在 `</body>`、`</html>` 前注入代码，
- * 如果均未找到目标标签，则将代码追加到 HTML 末尾。
- * 适用于需要注入到页面底部但不确定 HTML 结构是否完整的场景。
- *
- * @param html - 原始 HTML 内容
- * @param code - 要注入的代码
- * @param fallbackMessage - 回退到末尾时的警告信息，为空则不输出警告
- * @returns 注入结果对象，包含注入后的 HTML、是否成功标志和是否使用了回退策略
- *
- * @example
- * ```typescript
- * // 注入 JS 脚本到页面底部
- * const result = injectBeforeTagWithFallback(html, '<script>...</script>')
- *
- * // 带自定义警告信息
- * const result = injectBeforeTagWithFallback(html, scriptCode, '未找到 </body> 标签，代码追加到文件末尾')
- * ```
- */
-declare function injectBeforeTagWithFallback(html: string, code: string, _fallbackMessage?: string): HtmlInjectResult & {
-    usedFallback: boolean;
-};
 /**
  * 双区域 HTML 注入（head + body）
  *
@@ -91,19 +40,8 @@ declare function injectBeforeTagWithFallback(html: string, code: string, _fallba
  * @param headCode - 注入到 `</head>` 前的代码（如 CSS、meta 标签），不提供则跳过 head 注入
  * @param bodyCode - 注入到 `</body>` 前的代码（如 JS 脚本），回退到 `</html>` 前或末尾
  * @returns 双区域注入结果对象
- *
- * @example
- * ```typescript
- * // CSS 注入到 head，JS 注入到 body
- * const result = injectHeadAndBody(html, '<style>...</style>', '<script>...</script>')
- * if (!result.headInjected) logger.warn('未找到 </head> 标签')
- * if (result.usedFallback) logger.warn('代码追加到文件末尾')
- *
- * // 仅注入到 body
- * const result = injectHeadAndBody(html, undefined, '<script>...</script>')
- * ```
  */
 declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
 
-export { injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority };
-export type { DualInjectResult, HtmlInjectResult };
+export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
+export type { SanitizeRuleOptions };

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

@@ -1,25 +1,25 @@
+import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.mjs';
+export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.mjs';
+
 /**
- * HTML 注入结果
+ * 内容消毒规则选项
  */
-interface HtmlInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** 是否成功注入 */
-    injected: boolean;
+interface SanitizeRuleOptions {
+    id?: string;
+    allowScriptInjection?: boolean;
 }
 /**
- * 双区域 HTML 注入结果
+ * 对注入内容进行安全过滤
+ *
+ * @param content - 待过滤的 HTML 内容字符串
+ * @param rule - 当前注入规则的消毒选项
+ * @param security - 全局安全配置
+ * @param logger - 日志记录器
+ * @returns 过滤后的安全 HTML 内容字符串
  */
-interface DualInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** head 区域是否成功注入 */
-    headInjected: boolean;
-    /** body 区域是否成功注入 */
-    bodyInjected: boolean;
-    /** body 注入是否使用了回退策略（追加到末尾） */
-    usedFallback: boolean;
-}
+declare function sanitizeContent(content: string, rule: SanitizeRuleOptions, security?: SecurityConfig, logger?: {
+    warn: (msg: string) => void;
+}): string;
 
 /**
  * 在 HTML 中指定闭合标签前注入代码
@@ -28,59 +28,8 @@ interface DualInjectResult {
  * @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;
-/**
- * 带回退策略的 HTML 注入
- *
- * @description 依次尝试在 `</body>`、`</html>` 前注入代码，
- * 如果均未找到目标标签，则将代码追加到 HTML 末尾。
- * 适用于需要注入到页面底部但不确定 HTML 结构是否完整的场景。
- *
- * @param html - 原始 HTML 内容
- * @param code - 要注入的代码
- * @param fallbackMessage - 回退到末尾时的警告信息，为空则不输出警告
- * @returns 注入结果对象，包含注入后的 HTML、是否成功标志和是否使用了回退策略
- *
- * @example
- * ```typescript
- * // 注入 JS 脚本到页面底部
- * const result = injectBeforeTagWithFallback(html, '<script>...</script>')
- *
- * // 带自定义警告信息
- * const result = injectBeforeTagWithFallback(html, scriptCode, '未找到 </body> 标签，代码追加到文件末尾')
- * ```
- */
-declare function injectBeforeTagWithFallback(html: string, code: string, _fallbackMessage?: string): HtmlInjectResult & {
-    usedFallback: boolean;
-};
 /**
  * 双区域 HTML 注入（head + body）
  *
@@ -91,19 +40,8 @@ declare function injectBeforeTagWithFallback(html: string, code: string, _fallba
  * @param headCode - 注入到 `</head>` 前的代码（如 CSS、meta 标签），不提供则跳过 head 注入
  * @param bodyCode - 注入到 `</body>` 前的代码（如 JS 脚本），回退到 `</html>` 前或末尾
  * @returns 双区域注入结果对象
- *
- * @example
- * ```typescript
- * // CSS 注入到 head，JS 注入到 body
- * const result = injectHeadAndBody(html, '<style>...</style>', '<script>...</script>')
- * if (!result.headInjected) logger.warn('未找到 </head> 标签')
- * if (result.usedFallback) logger.warn('代码追加到文件末尾')
- *
- * // 仅注入到 body
- * const result = injectHeadAndBody(html, undefined, '<script>...</script>')
- * ```
  */
 declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
 
-export { injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority };
-export type { DualInjectResult, HtmlInjectResult };
+export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
+export type { SanitizeRuleOptions };

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

@@ -1,25 +1,25 @@
+import { S as SecurityConfig, H as HtmlInjectResult, D as DualInjectResult } from '../../shared/vite-plugin.BI9taN75.js';
+export { C as ConditionType, I as InjectCondition, a as InjectPosition, b as SelectorMatch } from '../../shared/vite-plugin.BI9taN75.js';
+
 /**
- * HTML 注入结果
+ * 内容消毒规则选项
  */
-interface HtmlInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** 是否成功注入 */
-    injected: boolean;
+interface SanitizeRuleOptions {
+    id?: string;
+    allowScriptInjection?: boolean;
 }
 /**
- * 双区域 HTML 注入结果
+ * 对注入内容进行安全过滤
+ *
+ * @param content - 待过滤的 HTML 内容字符串
+ * @param rule - 当前注入规则的消毒选项
+ * @param security - 全局安全配置
+ * @param logger - 日志记录器
+ * @returns 过滤后的安全 HTML 内容字符串
  */
-interface DualInjectResult {
-    /** 注入后的 HTML 内容 */
-    html: string;
-    /** head 区域是否成功注入 */
-    headInjected: boolean;
-    /** body 区域是否成功注入 */
-    bodyInjected: boolean;
-    /** body 注入是否使用了回退策略（追加到末尾） */
-    usedFallback: boolean;
-}
+declare function sanitizeContent(content: string, rule: SanitizeRuleOptions, security?: SecurityConfig, logger?: {
+    warn: (msg: string) => void;
+}): string;
 
 /**
  * 在 HTML 中指定闭合标签前注入代码
@@ -28,59 +28,8 @@ interface DualInjectResult {
  * @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;
-/**
- * 带回退策略的 HTML 注入
- *
- * @description 依次尝试在 `</body>`、`</html>` 前注入代码，
- * 如果均未找到目标标签，则将代码追加到 HTML 末尾。
- * 适用于需要注入到页面底部但不确定 HTML 结构是否完整的场景。
- *
- * @param html - 原始 HTML 内容
- * @param code - 要注入的代码
- * @param fallbackMessage - 回退到末尾时的警告信息，为空则不输出警告
- * @returns 注入结果对象，包含注入后的 HTML、是否成功标志和是否使用了回退策略
- *
- * @example
- * ```typescript
- * // 注入 JS 脚本到页面底部
- * const result = injectBeforeTagWithFallback(html, '<script>...</script>')
- *
- * // 带自定义警告信息
- * const result = injectBeforeTagWithFallback(html, scriptCode, '未找到 </body> 标签，代码追加到文件末尾')
- * ```
- */
-declare function injectBeforeTagWithFallback(html: string, code: string, _fallbackMessage?: string): HtmlInjectResult & {
-    usedFallback: boolean;
-};
 /**
  * 双区域 HTML 注入（head + body）
  *
@@ -91,19 +40,8 @@ declare function injectBeforeTagWithFallback(html: string, code: string, _fallba
  * @param headCode - 注入到 `</head>` 前的代码（如 CSS、meta 标签），不提供则跳过 head 注入
  * @param bodyCode - 注入到 `</body>` 前的代码（如 JS 脚本），回退到 `</html>` 前或末尾
  * @returns 双区域注入结果对象
- *
- * @example
- * ```typescript
- * // CSS 注入到 head，JS 注入到 body
- * const result = injectHeadAndBody(html, '<style>...</style>', '<script>...</script>')
- * if (!result.headInjected) logger.warn('未找到 </head> 标签')
- * if (result.usedFallback) logger.warn('代码追加到文件末尾')
- *
- * // 仅注入到 body
- * const result = injectHeadAndBody(html, undefined, '<script>...</script>')
- * ```
  */
 declare function injectHeadAndBody(html: string, headCode: string | undefined, bodyCode: string): DualInjectResult;
 
-export { injectBeforeTag, injectBeforeTagWithFallback, injectHeadAndBody, injectHtmlByPriority };
-export type { DualInjectResult, HtmlInjectResult };
+export { DualInjectResult, HtmlInjectResult, SecurityConfig, injectBeforeTag, injectHeadAndBody, sanitizeContent };
+export type { SanitizeRuleOptions };