monocart-coverage-reports 3.2.0 → 3.2.1

package/README.md

@@ -14,6 +14,7 @@
 
 * [Usage](#usage)
 * [Best Practices](#best-practices)
+* [AI Agent Skill](#ai-agent-skill)
 * [Options](#options)
 * [Available Reports](#available-reports)
 * [Compare Reports](#compare-reports)
@@ -118,20 +119,21 @@ For detailed setup instructions and examples, see the [best-practices guide](ski
 
 ## AI Agent Skill
 
-For AI-assisted development in a source checkout, start with [AGENTS.md](https://github.com/cenfun/monocart-coverage-reports/blob/main/AGENTS.md). It describes the source layout, development commands, validation, and safety boundaries. `.github/copilot-instructions.md` provides a self-contained summary of the core rules for GitHub Copilot. These checkout-only guides are not included in the npm package and are separate from the reusable integration skill below.
+**Reliable AI-assisted development starts with automated testing.** Test results validate behavior; coverage highlights testing gaps. With **`mcr test`**, AI coding agents can run Node.js tests, collect native V8 coverage, and generate reports without instrumentation. This feedback supports iterative development and CI/CD quality gates, whether an agent assists a developer or works autonomously.
 
-The reusable [Monocart Coverage Reports skill](skills/monocart-coverage-reports/SKILL.md) helps AI coding agents collect coverage, configure the CLI, debug sourcemaps and filters, merge raw reports, and enforce CI thresholds. It uses a main `SKILL.md` with task-specific references loaded on demand, targeting MCR 3.x only and checking its runtime requirements.
+The [Monocart Coverage Reports skill](skills/monocart-coverage-reports/SKILL.md) guides agents through coverage collection, CLI configuration, sourcemap troubleshooting, report merging, and CI thresholds. It targets MCR 3.x and loads task-specific references on demand.
 
-The npm package includes `skills/monocart-coverage-reports/`. Copy this **entire directory**, including `references/`, into your agent's supported skills location, or ask the agent to read `SKILL.md` directly. Installing MCR does not automatically register the skill or modify agent settings. The instructions are in English; requests and responses can use any language.
+The skill ships in the npm package. Copy the **entire `skills/monocart-coverage-reports/` directory**, including `references/`, into your agent's skills directory, or have the agent read `SKILL.md` directly. Installation does not automatically register the skill. The instructions are in English; you can use any language with your agent.
 
-From the host project root, locate the installed skill and package manifest (older releases may not include the skill):
+Locate the installed skill from your project root:
 
 ```sh
 node -p "require.resolve('monocart-coverage-reports/skills/monocart-coverage-reports/SKILL.md')"
-node -p "require.resolve('monocart-coverage-reports/package.json')"
 ```
 
-Read the resolved skill, then follow its relative reference links. Use the installed package's runtime, API, and version requirements rather than assuming all examples apply to older releases. These commands resolve files; they do not import Markdown as JavaScript.
+Follow the skill's reference links and the installed package's version and runtime requirements. Older releases may not include the skill.
+
+For development of MCR itself, see [AGENTS.md](https://github.com/cenfun/monocart-coverage-reports/blob/main/AGENTS.md).
 
 ## Options
 - Default options: [lib/default/options.js](./lib/default/options.js)

package/README.zh-Hans.md

@@ -14,6 +14,7 @@
 
 * [用法](#usage)
 * [最佳实践](#best-practices)
+* [AI Agent Skill](#ai-agent-skill)
 * [选项配置](#options)
 * [所有支持的报告类型](#available-reports)
 * [比较两种报告](#compare-reports)
@@ -118,20 +119,21 @@ mcr node my-app.js -r v8,console-details
 
 ## AI Agent Skill
 
-使用 AI 辅助开发本仓库源码时，请先阅读 [AGENTS.md](https://github.com/cenfun/monocart-coverage-reports/blob/main/AGENTS.md)，了解源码结构、开发命令、验证流程和安全边界。`.github/copilot-instructions.md` 为 GitHub Copilot 提供可独立使用的核心规则摘要。这些指南仅用于源码仓库，不随 npm 包发布，与下面可复用的集成技能相互独立。
+**可靠的 AI 辅助开发离不开自动化测试。** 测试结果验证代码行为，覆盖率帮助识别测试缺口。通过 **`mcr test`**，AI 编程助手可直接运行 Node.js 测试、采集原生 V8 覆盖率并生成报告，无需插桩。测试与覆盖率反馈支持持续迭代，并可结合 CI/CD 质量门禁，用于 AI 辅助或自主开发。
 
-项目提供可复用的 [Monocart Coverage Reports 技能](skills/monocart-coverage-reports/SKILL.md)，帮助 AI coding agent 采集覆盖率、配置 CLI、排查 sourcemap 和过滤问题、合并 raw 报告及设置 CI 阈值。结构为主 `SKILL.md` 加按需加载的专题参考文档，仅面向 MCR 3.x，并检查其运行环境要求。
+[Monocart Coverage Reports 技能](skills/monocart-coverage-reports/SKILL.md) 指导 AI 配置覆盖率采集和 CLI、排查 sourcemap 问题、合并报告及设置 CI 阈值，适用于 MCR 3.x，专题参考文档按需加载。
 
-npm 包包含 `skills/monocart-coverage-reports/`。请将**整个目录**（包括 `references/`）复制到 agent 支持的 skills 目录，或直接让 agent 读取 `SKILL.md`。安装 MCR 不会自动注册技能或修改 agent 配置。技能说明使用英文，但提问和回复可以使用中文或其他语言。
+技能随 npm 包发布。将**整个 `skills/monocart-coverage-reports/` 目录**（含 `references/`）复制到 AI 工具的技能目录，或让 AI 直接读取 `SKILL.md`。安装 MCR 不会自动注册技能。技能说明使用英文，与 AI 交流可使用任意语言。
 
-在使用 MCR 的项目根目录中定位已安装的技能和包配置（旧版本可能尚未包含技能）：
+在项目根目录定位已安装的技能：
 
 ```sh
 node -p "require.resolve('monocart-coverage-reports/skills/monocart-coverage-reports/SKILL.md')"
-node -p "require.resolve('monocart-coverage-reports/package.json')"
 ```
 
-读取定位到的技能文件，再按相对链接读取专题文档。请以已安装包的运行时、API 和版本要求为准，不要假设所有示例都适用于旧版本。以上命令用于定位文件，不是将 Markdown 作为 JavaScript 导入。
+按技能中的链接查阅参考文档，并以已安装包的版本和运行环境要求为准。旧版本可能不包含该技能。
+
+开发 MCR 本身时，请参阅 [AGENTS.md](https://github.com/cenfun/monocart-coverage-reports/blob/main/AGENTS.md)。
 
 ## Options
 - 默认选项: [lib/default/options.js](./lib/default/options.js)

package/lib/converter/ast-visitor.js

@@ -489,6 +489,7 @@ const viteImportDefaultHandler = (node, group) => {
 
 const collectNodes = (ast) => {
     const functionNodes = [];
+    const initializerNodes = [];
     const statementNodes = [];
     const blockNodes = [];
     const branchMap = new Map();
@@ -514,6 +515,12 @@ const collectNodes = (ast) => {
             });
         },
 
+        PropertyDefinition: (node) => {
+            if (node.value) {
+                initializerNodes.push(node);
+            }
+        },
+
         // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes/static
         // as a function "functionName": "<static_initializer>",
         StaticBlock: (node, parents) => {
@@ -646,6 +653,7 @@ const collectNodes = (ast) => {
 
     return {
         functionNodes,
+        initializerNodes,
         statementNodes,
         blockNodes,
         branchMap
@@ -735,12 +743,30 @@ const findFunctionRange = (item, coverageInfo) => {
 const collectAstInfo = (ast, coverageInfo) => {
 
     const {
-        functionNodes, statementNodes, blockNodes, branchMap
+        functionNodes, initializerNodes, statementNodes, blockNodes, branchMap
     } = collectNodes(ast);
 
     // root function state
     const rootState = getRootFunctionState(ast, coverageInfo);
 
+    // V8 groups field values into implicit functions. Use their counts and
+    // block ranges without adding synthetic functions to the report. Keys
+    // execute at class definition time, so only the value gets this state.
+    initializerNodes.forEach((node) => {
+        const ranges = node.static ? coverageInfo.functionStaticRanges : coverageInfo.functionInstanceRanges;
+        const { value } = node;
+        const range = Util.findInRanges(value.start, value.end, ranges, 'startOffset', 'endOffset');
+        if (range) {
+            value._state = {
+                isFunction: true,
+                count: range.count,
+                range
+            };
+        }
+    });
+
+    // Explicit functions (including arrow-valued fields) keep their own
+    // execution state, overriding any initializer state on the value node.
     const functions = [];
     functionNodes.forEach((item) => {
         const { node } = item;

package/lib/converter/ast.js

@@ -9,6 +9,7 @@ const getCoverageInfo = (coverageList) => {
     const functionMap = new Map();
     const functionNameMap = new Map();
     const functionStaticRanges = [];
+    const functionInstanceRanges = [];
     const functionUncoveredRanges = [];
 
     let rootRange;
@@ -66,6 +67,9 @@ const getCoverageInfo = (coverageList) => {
         if (functionName === '<static_initializer>') {
             functionStaticRanges.push(functionRange);
         }
+        if (functionName === '<instance_members_initializer>') {
+            functionInstanceRanges.push(functionRange);
+        }
 
         // cache uncovered
         if (functionRange.count === 0) {
@@ -76,11 +80,14 @@ const getCoverageInfo = (coverageList) => {
 
     // sort ranges
     Util.sortOffsetRanges(functionUncoveredRanges);
+    Util.sortOffsetRanges(functionStaticRanges);
+    Util.sortOffsetRanges(functionInstanceRanges);
 
     return {
         functionMap,
         functionNameMap,
         functionStaticRanges,
+        functionInstanceRanges,
         functionUncoveredRanges,
         rootRange
     };
@@ -220,7 +227,19 @@ const addRule = (item, coverageList, coveredRanges, count = 0) => {
     const endOffset = end.offset;
 
     if (!count) {
-        const coveredRange = Util.findInRanges(startOffset, endOffset, coveredRanges, 'startOffset', 'endOffset');
+        let matchEnd = endOffset;
+        if (item.type === 'rule') {
+            const child = item.nodes?.find((node) => node.type === 'rule' || node.type === 'atrule');
+            if (child) {
+                // Chromium 158 may stop the used parent range before a nested
+                // rule. Keep legacy whole-rule accounting, matching only the
+                // parent's prefix rather than requiring its entire subtree.
+                // TODO: Track native nested rules and trailing declarations
+                // separately, including their sparse sourcemap boundaries.
+                matchEnd = startOffset + source.input.css.slice(startOffset, child.source.start.offset).trimEnd().length;
+            }
+        }
+        const coveredRange = Util.findInRanges(startOffset, matchEnd, coveredRanges, 'startOffset', 'endOffset');
         if (coveredRange) {
             count = 1;
         }