@51jbs/incremental-coverage-plugin 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chuanjing Li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# 增量覆盖率插件 (Incremental Coverage Plugin)
+
+> 🎯 **核心目标**: 精准追踪代码变更后的覆盖率情况，为研发自测提供量化数据支撑。
+
+本插件基于 `babel-plugin-istanbul` 和 `istanbul-diff`，通过集成 Git 差异分析，自动计算自测过程中的增量覆盖率。
+
+## ✨ 核心价值
+
+- **🚀 聚焦变更**: 告别冗长的全量覆盖率报告，核心关注你改动的那几行代码。
+- **🛡 质量契约**: 设置增量覆盖率阈值，作为代码合并与上线的硬性质量指标。
+- **🔗 一站式集成**: 深度集成 Git，自动解析 Diff 提取新增行号，无需手动干预。
+- **🔋 生产就绪**: 具备防抖上报、故障重试及报告自动清理机制，保障构建链路稳定。
+
+## 🏗️ 核心模块
+
+| 模块 | 职责 |
+|------|------|
+| **CoverageCollector** | 负责浏览器端数据的收集与内存合并 |
+| **CoverageDiffer** | 使用 istanbul-diff 计算基准与当前的差异 |
+| **GitService** | 自动提取 Git Diff 变更行号 |
+| **CoverageReporter** | 生成可视化 HTML 报告与 JSON 结构化数据 |
+
+## 📦 安装
+
+### 前置要求
+
+- Node.js >= 16.0.0
+- Git 仓库（必需）
+- **Webpack 4 或 5**（完全支持）
+- **webpack-dev-server 3.x 或 4.x**（自动适配）
+
+### 快速安装
+
+```bash
+npm install @51jbs/incremental-coverage-plugin --save-dev
+```
+
+### 验证安装
+
+```bash
+npm ls @51jbs/incremental-coverage-plugin
+```
+
+> 💡 **提示**：插件已内置所有必要依赖（包括 `@babel/core`、`istanbul-lib-*`），无需额外安装。
+
+## 📚 快速导航
+
+- [**安装指南**](./docs/installation.md): 详细的安装步骤和前置要求检查。
+- [**快速开始**](./docs/quick-start.md): 15 分钟完成 Webpack 项目接入。
+- [**功能特性**](./docs/features.md): 深入了解增量计算与生产级保护机制。
+- [**故障排查**](./docs/troubleshooting.md): 常见问题诊断和解决方案。
+- [**技术架构**](./docs/architecture.md): 查看整体设计方案与时序图。
+- [**API 参考**](./docs/api.md): 查看详细的配置项说明。
+
+---
+
+## 📄 许可证
+
+本项目采用 [MIT](https://github.com/chuanjing729-glitch/fe-workspace/blob/main/packages/incremental-coverage-plugin/LICENSE) 许可证发布。

package/dist/index.d.mts

@@ -0,0 +1,314 @@
+import * as unplugin from 'unplugin';
+import { I as IncrementalCoverageOptions, C as CoverageMap, a as IncrementalCoverageResult, G as GitDiffResult } from './types-PPxtKDSr.mjs';
+
+/**
+ * Incremental Coverage Plugin
+ *
+ * 轻量级增量覆盖率插件，基于以下技术：
+ * - babel-plugin-istanbul: 代码插桩
+ * - istanbul-diff: 增量覆盖率计算
+ * - unplugin: 多构建工具支持
+ *
+ * @example
+ * // Webpack
+ * new WebpackIncrementalCoveragePlugin({ include: ['src/**'] })
+ *
+ * // Vite
+ * ViteIncrementalCoveragePlugin({ include: ['src/**'] })
+ */
+declare const IncrementalCoveragePlugin: unplugin.UnpluginInstance<IncrementalCoverageOptions | undefined, boolean>;
+
+/**
+ * 覆盖率收集器
+ *
+ * 负责接收和合并来自浏览器的覆盖率数据
+ * 维护全局的覆盖率状态，支持多次上报的数据累加
+ *
+ * @module collector
+ */
+
+/**
+ * Coverage Collector - 覆盖率收集器
+ *
+ * 核心职责：
+ * 1. 接收浏览器上报的覆盖率数据
+ * 2. 合并多次上报的数据（累加执行次数）
+ * 3. 维护全局覆盖率状态
+ *
+ * @example
+ * const collector = new CoverageCollector();
+ * const merged = collector.merge(newCoverageData);
+ */
+declare class CoverageCollector {
+    /**
+     * 全局覆盖率映射表
+     *
+     * 键是文件路径，值是该文件的覆盖率数据
+     * 这个对象会随着数据上报不断更新
+     */
+    private coverageMap;
+    /**
+     * 合并新的覆盖率数据
+     *
+     * 算法说明：
+     * 1. 遍历新数据中的每个文件
+     * 2. 如果是首次出现的文件，直接存储
+     * 3. 如果文件已存在，合并执行次数（累加）
+     *
+     * 为什么要累加？
+     * - 用户可能多次执行同一段代码
+     * - 需要记录总的执行次数，而不是覆盖
+     *
+     * @param newCoverage - 新上报的覆盖率数据
+     * @returns 合并后的完整覆盖率数据
+     *
+     * @example
+     * // 第一次上报
+     * collector.merge({ 'src/utils.ts': { s: { '0': 1 } } });
+     * // 第二次上报（同一文件）
+     * collector.merge({ 'src/utils.ts': { s: { '0': 2 } } });
+     * // 结果：s['0'] = 3（累加）
+     */
+    merge(newCoverage: CoverageMap): CoverageMap;
+    /**
+     * 获取当前的覆盖率数据
+     *
+     * @returns 当前的完整覆盖率映射表
+     */
+    getCoverage(): CoverageMap;
+    /**
+     * 重置覆盖率数据
+     *
+     * 清空所有已收集的数据，重新开始
+     * 通常在需要重新计算覆盖率时使用
+     */
+    reset(): void;
+    /**
+     * 合并两个覆盖率数据对象
+     *
+     * 合并策略：
+     * 1. 语句覆盖（s）：执行次数累加
+     * 2. 函数覆盖（f）：执行次数累加
+     * 3. 分支覆盖（b）：数组元素逐个累加
+     *
+     * 注意：
+     * - statementMap、fnMap、branchMap 不需要合并（它们是静态的位置信息）
+     * - 只有执行次数（s、f、b）需要累加
+     *
+     * @param existing - 已存在的覆盖率数据
+     * @param newData - 新的覆盖率数据
+     * @returns 合并后的覆盖率数据
+     *
+     * @private
+     */
+    private mergeCoverageData;
+}
+
+/**
+ * 覆盖率差异计算器
+ *
+ * 负责计算增量覆盖率，这是插件的核心模块
+ *
+ * 工作流程：
+ * 1. 加载 baseline 覆盖率（参考基准）
+ * 2. 使用 istanbul-diff 计算差异
+ * 3. 结合 Git diff 获取变更的文件和行号
+ * 4. 计算每个变更文件的覆盖率
+ * 5. 汇总整体覆盖率
+ * 6. 保存新的 baseline（可选）
+ *
+ * @module differ
+ */
+
+/**
+ * Coverage Differ - 覆盖率差异计算器
+ *
+ * 核心职责：
+ * 1. 管理 baseline 覆盖率（加载/保存）
+ * 2. 使用 istanbul-diff 计算覆盖率差异
+ * 3. 结合 Git diff 确定需要检查的代码行
+ * 4. 计算增量覆盖率百分比
+ *
+ * @example
+ * const differ = new CoverageDiffer(options);
+ * const result = await differ.calculate(currentCoverage);
+ */
+declare class CoverageDiffer {
+    private options;
+    constructor(options: IncrementalCoverageOptions);
+    /**
+     * 计算增量覆盖率
+     *
+     * 这是最核心的方法，完整的计算流程：
+     *
+     * 1. 加载 baseline（如果存在）
+     * 2. 使用 istanbul-diff 计算差异
+     * 3. 获取 Git 变更的文件和行号
+     * 4. 对每个变更文件：
+     *    a. 获取该文件的覆盖率数据
+     *    b. 找出变更的行号
+     *    c. 检查这些行是否被覆盖
+     *    d. 计算覆盖率百分比
+     * 5. 汇总所有文件的覆盖率
+     * 6. 保存新的 baseline（如果需要）
+     *
+     * @param currentCoverage - 当前的覆盖率数据
+     * @returns 增量覆盖率计算结果
+     *
+     * @example
+     * const result = await differ.calculate(coverageMap);
+     * console.log(`Overall coverage: ${result.overall.coverageRate}%`);
+     */
+    calculate(currentCoverage: CoverageMap): Promise<IncrementalCoverageResult>;
+    /**
+     * 从文件加载 baseline 覆盖率
+     *
+     * Baseline 是参考基准，用于对比当前覆盖率的变化
+     * 通常在首次运行时创建，之后保持不变（除非手动更新）
+     *
+     * @returns baseline 覆盖率数据，如果文件不存在则返回 null
+     * @private
+     */
+    private loadBaseline;
+    /**
+     * 保存 baseline 覆盖率到文件
+     *
+     * 将当前的覆盖率数据保存为 baseline，供后续对比使用
+     *
+     * 注意：
+     * - 会自动创建目录（如果不存在）
+     * - 使用 JSON 格式，便于查看和调试
+     * - 格式化输出（2 空格缩进）
+     *
+     * @param coverage - 要保存的覆盖率数据
+     * @private
+     */
+    private saveBaseline;
+    /**
+     * 获取未覆盖的行号列表
+     *
+     * 算法说明：
+     * 1. 遍历每一个变更的行号
+     * 2. 检查是否有语句（statement）覆盖这一行
+     * 3. 如果有语句覆盖且执行次数 > 0，则该行被覆盖
+     * 4. 否则，该行未被覆盖
+     *
+     * 为什么检查 statementMap？
+     * - Istanbul 的覆盖率是基于语句（statement）的
+     * - statementMap 记录了每个语句的位置（起始行、结束行）
+     * - 通过检查语句的位置，可以知道某一行是否被覆盖
+     *
+     * 为什么检查执行次数？
+     * - coverage.s[stmtId] 记录了语句的执行次数
+     * - 如果执行次数 > 0，说明这个语句被执行过
+     * - 如果执行次数 = 0，说明这个语句没有被执行
+     *
+     * @param coverage - 文件的覆盖率数据
+     * @param changedLines - 变更的行号列表
+     * @returns 未覆盖的行号列表
+     *
+     * @example
+     * const uncovered = this.getUncoveredLines(coverage, [10, 11, 12]);
+     * // 返回: [11] （假设第 11 行没有被覆盖）
+     *
+     * @private
+     */
+    private getUncoveredLines;
+    /**
+     * 判断是否为有效的源码文件
+     * 用于过滤 node_modules, lockfiles 和非源码文件
+     * @private
+     */
+    private isValidSourceFile;
+}
+
+/**
+ * 覆盖率报告生成器
+ *
+ * 负责生成各种格式的覆盖率报告
+ *
+ * 核心功能：
+ * 1. 生成 HTML 格式的可视化报告
+ * 2. 生成 JSON 格式的数据报告
+ * 3. 维护报告文件（最新报告、历史报告及自动清理）
+ *
+ * @module reporter
+ */
+
+/**
+ * Coverage Reporter - 覆盖率报告生成器
+ */
+declare class CoverageReporter {
+    private options;
+    private outputDir;
+    constructor(options: IncrementalCoverageOptions);
+    /**
+     * 生成增量覆盖率报告
+     *
+     * @param result 增量计算结果
+     * @returns 报告保存的路径
+     */
+    generate(result: IncrementalCoverageResult): Promise<string>;
+    /**
+     * 渲染 HTML 模板
+     *
+     * @param result 计算结果
+     * @private
+     */
+    private renderHtml;
+    /**
+     * 清理超出保留数量的历史报告
+     * @private
+     */
+    private cleanupOldReports;
+}
+
+/**
+ * Git 服务模块
+ *
+ * 负责与 Git 交互，获取代码变更信息
+ *
+ * 核心功能：
+ * 1. 获取变更的文件列表
+ * 2. 解析 Git diff 输出
+ * 3. 提取新增和删除的行号
+ *
+ * @module git
+ */
+
+/**
+ * 获取 Git diff 信息
+ *
+ * 对比当前分支（HEAD）与指定基准分支的差异
+ * 返回变更的文件列表和具体的行号信息
+ *
+ * 工作流程：
+ * 1. 使用 git.diffSummary() 获取变更文件列表
+ * 2. 对每个文件使用 git.diff() 获取详细差异
+ * 3. 解析 diff 输出，提取行号
+ *
+ * @param base - 对比的基准分支（例如：'main', 'develop'）
+ * @returns Git diff 结果，包含文件列表和行号信息
+ *
+ * @example
+ * const diff = await getGitDiff('main');
+ * console.log('Changed files:', diff.files);
+ * console.log('Added lines in file.ts:', diff.additions['file.ts']);
+ */
+declare function getGitDiff(base?: string): Promise<GitDiffResult>;
+/**
+ * 获取变更的文件列表
+ *
+ * 这是 getGitDiff 的简化版本，只返回文件列表
+ * 适用于只需要知道哪些文件变更了，不需要具体行号的场景
+ *
+ * @param base - 对比的基准分支
+ * @returns 变更的文件路径列表
+ *
+ * @example
+ * const files = await getChangedFiles('main');
+ * console.log('Changed files:', files);
+ */
+declare function getChangedFiles(base?: string): Promise<string[]>;
+
+export { CoverageCollector, CoverageDiffer, CoverageReporter, IncrementalCoverageOptions, IncrementalCoveragePlugin, getChangedFiles, getGitDiff };

package/dist/index.d.ts

@@ -0,0 +1,314 @@
+import * as unplugin from 'unplugin';
+import { I as IncrementalCoverageOptions, C as CoverageMap, a as IncrementalCoverageResult, G as GitDiffResult } from './types-PPxtKDSr.js';
+
+/**
+ * Incremental Coverage Plugin
+ *
+ * 轻量级增量覆盖率插件，基于以下技术：
+ * - babel-plugin-istanbul: 代码插桩
+ * - istanbul-diff: 增量覆盖率计算
+ * - unplugin: 多构建工具支持
+ *
+ * @example
+ * // Webpack
+ * new WebpackIncrementalCoveragePlugin({ include: ['src/**'] })
+ *
+ * // Vite
+ * ViteIncrementalCoveragePlugin({ include: ['src/**'] })
+ */
+declare const IncrementalCoveragePlugin: unplugin.UnpluginInstance<IncrementalCoverageOptions | undefined, boolean>;
+
+/**
+ * 覆盖率收集器
+ *
+ * 负责接收和合并来自浏览器的覆盖率数据
+ * 维护全局的覆盖率状态，支持多次上报的数据累加
+ *
+ * @module collector
+ */
+
+/**
+ * Coverage Collector - 覆盖率收集器
+ *
+ * 核心职责：
+ * 1. 接收浏览器上报的覆盖率数据
+ * 2. 合并多次上报的数据（累加执行次数）
+ * 3. 维护全局覆盖率状态
+ *
+ * @example
+ * const collector = new CoverageCollector();
+ * const merged = collector.merge(newCoverageData);
+ */
+declare class CoverageCollector {
+    /**
+     * 全局覆盖率映射表
+     *
+     * 键是文件路径，值是该文件的覆盖率数据
+     * 这个对象会随着数据上报不断更新
+     */
+    private coverageMap;
+    /**
+     * 合并新的覆盖率数据
+     *
+     * 算法说明：
+     * 1. 遍历新数据中的每个文件
+     * 2. 如果是首次出现的文件，直接存储
+     * 3. 如果文件已存在，合并执行次数（累加）
+     *
+     * 为什么要累加？
+     * - 用户可能多次执行同一段代码
+     * - 需要记录总的执行次数，而不是覆盖
+     *
+     * @param newCoverage - 新上报的覆盖率数据
+     * @returns 合并后的完整覆盖率数据
+     *
+     * @example
+     * // 第一次上报
+     * collector.merge({ 'src/utils.ts': { s: { '0': 1 } } });
+     * // 第二次上报（同一文件）
+     * collector.merge({ 'src/utils.ts': { s: { '0': 2 } } });
+     * // 结果：s['0'] = 3（累加）
+     */
+    merge(newCoverage: CoverageMap): CoverageMap;
+    /**
+     * 获取当前的覆盖率数据
+     *
+     * @returns 当前的完整覆盖率映射表
+     */
+    getCoverage(): CoverageMap;
+    /**
+     * 重置覆盖率数据
+     *
+     * 清空所有已收集的数据，重新开始
+     * 通常在需要重新计算覆盖率时使用
+     */
+    reset(): void;
+    /**
+     * 合并两个覆盖率数据对象
+     *
+     * 合并策略：
+     * 1. 语句覆盖（s）：执行次数累加
+     * 2. 函数覆盖（f）：执行次数累加
+     * 3. 分支覆盖（b）：数组元素逐个累加
+     *
+     * 注意：
+     * - statementMap、fnMap、branchMap 不需要合并（它们是静态的位置信息）
+     * - 只有执行次数（s、f、b）需要累加
+     *
+     * @param existing - 已存在的覆盖率数据
+     * @param newData - 新的覆盖率数据
+     * @returns 合并后的覆盖率数据
+     *
+     * @private
+     */
+    private mergeCoverageData;
+}
+
+/**
+ * 覆盖率差异计算器
+ *
+ * 负责计算增量覆盖率，这是插件的核心模块
+ *
+ * 工作流程：
+ * 1. 加载 baseline 覆盖率（参考基准）
+ * 2. 使用 istanbul-diff 计算差异
+ * 3. 结合 Git diff 获取变更的文件和行号
+ * 4. 计算每个变更文件的覆盖率
+ * 5. 汇总整体覆盖率
+ * 6. 保存新的 baseline（可选）
+ *
+ * @module differ
+ */
+
+/**
+ * Coverage Differ - 覆盖率差异计算器
+ *
+ * 核心职责：
+ * 1. 管理 baseline 覆盖率（加载/保存）
+ * 2. 使用 istanbul-diff 计算覆盖率差异
+ * 3. 结合 Git diff 确定需要检查的代码行
+ * 4. 计算增量覆盖率百分比
+ *
+ * @example
+ * const differ = new CoverageDiffer(options);
+ * const result = await differ.calculate(currentCoverage);
+ */
+declare class CoverageDiffer {
+    private options;
+    constructor(options: IncrementalCoverageOptions);
+    /**
+     * 计算增量覆盖率
+     *
+     * 这是最核心的方法，完整的计算流程：
+     *
+     * 1. 加载 baseline（如果存在）
+     * 2. 使用 istanbul-diff 计算差异
+     * 3. 获取 Git 变更的文件和行号
+     * 4. 对每个变更文件：
+     *    a. 获取该文件的覆盖率数据
+     *    b. 找出变更的行号
+     *    c. 检查这些行是否被覆盖
+     *    d. 计算覆盖率百分比
+     * 5. 汇总所有文件的覆盖率
+     * 6. 保存新的 baseline（如果需要）
+     *
+     * @param currentCoverage - 当前的覆盖率数据
+     * @returns 增量覆盖率计算结果
+     *
+     * @example
+     * const result = await differ.calculate(coverageMap);
+     * console.log(`Overall coverage: ${result.overall.coverageRate}%`);
+     */
+    calculate(currentCoverage: CoverageMap): Promise<IncrementalCoverageResult>;
+    /**
+     * 从文件加载 baseline 覆盖率
+     *
+     * Baseline 是参考基准，用于对比当前覆盖率的变化
+     * 通常在首次运行时创建，之后保持不变（除非手动更新）
+     *
+     * @returns baseline 覆盖率数据，如果文件不存在则返回 null
+     * @private
+     */
+    private loadBaseline;
+    /**
+     * 保存 baseline 覆盖率到文件
+     *
+     * 将当前的覆盖率数据保存为 baseline，供后续对比使用
+     *
+     * 注意：
+     * - 会自动创建目录（如果不存在）
+     * - 使用 JSON 格式，便于查看和调试
+     * - 格式化输出（2 空格缩进）
+     *
+     * @param coverage - 要保存的覆盖率数据
+     * @private
+     */
+    private saveBaseline;
+    /**
+     * 获取未覆盖的行号列表
+     *
+     * 算法说明：
+     * 1. 遍历每一个变更的行号
+     * 2. 检查是否有语句（statement）覆盖这一行
+     * 3. 如果有语句覆盖且执行次数 > 0，则该行被覆盖
+     * 4. 否则，该行未被覆盖
+     *
+     * 为什么检查 statementMap？
+     * - Istanbul 的覆盖率是基于语句（statement）的
+     * - statementMap 记录了每个语句的位置（起始行、结束行）
+     * - 通过检查语句的位置，可以知道某一行是否被覆盖
+     *
+     * 为什么检查执行次数？
+     * - coverage.s[stmtId] 记录了语句的执行次数
+     * - 如果执行次数 > 0，说明这个语句被执行过
+     * - 如果执行次数 = 0，说明这个语句没有被执行
+     *
+     * @param coverage - 文件的覆盖率数据
+     * @param changedLines - 变更的行号列表
+     * @returns 未覆盖的行号列表
+     *
+     * @example
+     * const uncovered = this.getUncoveredLines(coverage, [10, 11, 12]);
+     * // 返回: [11] （假设第 11 行没有被覆盖）
+     *
+     * @private
+     */
+    private getUncoveredLines;
+    /**
+     * 判断是否为有效的源码文件
+     * 用于过滤 node_modules, lockfiles 和非源码文件
+     * @private
+     */
+    private isValidSourceFile;
+}
+
+/**
+ * 覆盖率报告生成器
+ *
+ * 负责生成各种格式的覆盖率报告
+ *
+ * 核心功能：
+ * 1. 生成 HTML 格式的可视化报告
+ * 2. 生成 JSON 格式的数据报告
+ * 3. 维护报告文件（最新报告、历史报告及自动清理）
+ *
+ * @module reporter
+ */
+
+/**
+ * Coverage Reporter - 覆盖率报告生成器
+ */
+declare class CoverageReporter {
+    private options;
+    private outputDir;
+    constructor(options: IncrementalCoverageOptions);
+    /**
+     * 生成增量覆盖率报告
+     *
+     * @param result 增量计算结果
+     * @returns 报告保存的路径
+     */
+    generate(result: IncrementalCoverageResult): Promise<string>;
+    /**
+     * 渲染 HTML 模板
+     *
+     * @param result 计算结果
+     * @private
+     */
+    private renderHtml;
+    /**
+     * 清理超出保留数量的历史报告
+     * @private
+     */
+    private cleanupOldReports;
+}
+
+/**
+ * Git 服务模块
+ *
+ * 负责与 Git 交互，获取代码变更信息
+ *
+ * 核心功能：
+ * 1. 获取变更的文件列表
+ * 2. 解析 Git diff 输出
+ * 3. 提取新增和删除的行号
+ *
+ * @module git
+ */
+
+/**
+ * 获取 Git diff 信息
+ *
+ * 对比当前分支（HEAD）与指定基准分支的差异
+ * 返回变更的文件列表和具体的行号信息
+ *
+ * 工作流程：
+ * 1. 使用 git.diffSummary() 获取变更文件列表
+ * 2. 对每个文件使用 git.diff() 获取详细差异
+ * 3. 解析 diff 输出，提取行号
+ *
+ * @param base - 对比的基准分支（例如：'main', 'develop'）
+ * @returns Git diff 结果，包含文件列表和行号信息
+ *
+ * @example
+ * const diff = await getGitDiff('main');
+ * console.log('Changed files:', diff.files);
+ * console.log('Added lines in file.ts:', diff.additions['file.ts']);
+ */
+declare function getGitDiff(base?: string): Promise<GitDiffResult>;
+/**
+ * 获取变更的文件列表
+ *
+ * 这是 getGitDiff 的简化版本，只返回文件列表
+ * 适用于只需要知道哪些文件变更了，不需要具体行号的场景
+ *
+ * @param base - 对比的基准分支
+ * @returns 变更的文件路径列表
+ *
+ * @example
+ * const files = await getChangedFiles('main');
+ * console.log('Changed files:', files);
+ */
+declare function getChangedFiles(base?: string): Promise<string[]>;
+
+export { CoverageCollector, CoverageDiffer, CoverageReporter, IncrementalCoverageOptions, IncrementalCoveragePlugin, getChangedFiles, getGitDiff };