@plugjs/cov8 0.1.0

package/dist/analysis.mjs

@@ -0,0 +1,212 @@
+// analysis.ts
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { assert } from "@plugjs/plug/asserts";
+import { readFile } from "@plugjs/plug/fs";
+import { $gry, $p } from "@plugjs/plug/logging";
+import { SourceMapConsumer } from "source-map";
+var CoverageAnalyserImpl = class {
+  constructor(_log) {
+    this._log = _log;
+  }
+};
+var CoverageResultAnalyser = class extends CoverageAnalyserImpl {
+  constructor(log, _result) {
+    super(log);
+    this._result = _result;
+    const _coverage = [];
+    for (const coveredFunction of _result.functions) {
+      for (const range of coveredFunction.ranges) {
+        for (let i = range.startOffset; i < range.endOffset; i++) {
+          _coverage[i] = range.count;
+        }
+      }
+    }
+    this._coverage = _coverage;
+  }
+  _coverage;
+  _lineLengths;
+  async init() {
+    const filename = fileURLToPath(this._result.url);
+    const source = await readFile(filename, "utf-8");
+    this._lineLengths = source.split("\n").map((line) => line.length);
+    return this;
+  }
+  destroy() {
+  }
+  coverage(source, line, column) {
+    assert(this._lineLengths, "Analyser not initialized");
+    assert(source === this._result.url, `Wrong source ${source} (should be ${this._result.url})`);
+    const { _lineLengths, _coverage } = this;
+    let offset = 0;
+    for (let l = line - 2; l >= 0; l--)
+      offset += _lineLengths[l] + 1;
+    return _coverage[offset + column] || 0;
+  }
+};
+var CoverageSitemapAnalyser = class extends CoverageResultAnalyser {
+  constructor(log, result, _sourceMapCache, _sourceMapBias) {
+    super(log, result);
+    this._sourceMapCache = _sourceMapCache;
+    this._sourceMapBias = _sourceMapBias;
+    this._lineLengths = _sourceMapCache.lineLengths;
+  }
+  _preciseMappings = /* @__PURE__ */ new Map();
+  _sourceMap;
+  _key(source, line, column) {
+    return `${line}:${column}:${source}`;
+  }
+  async init() {
+    const sourceMap = this._sourceMapCache.data;
+    assert(sourceMap, "Missing source map data from cache");
+    this._sourceMap = await new SourceMapConsumer(sourceMap);
+    if (this._sourceMapBias === "none") {
+      this._sourceMap.eachMapping((m) => {
+        const location = { line: m.generatedLine, column: m.generatedColumn };
+        const key = this._key(m.source, m.originalLine, m.originalColumn);
+        this._preciseMappings.set(key, location);
+      });
+    }
+    return this;
+  }
+  destroy() {
+    var _a;
+    (_a = this._sourceMap) == null ? void 0 : _a.destroy();
+  }
+  coverage(source, line, column) {
+    assert(this._sourceMap, "Analyser not initialized");
+    if (this._sourceMapBias === "none") {
+      const key = this._key(source, line, column);
+      const location = this._preciseMappings.get(key);
+      if (!location) {
+        this._log.debug(`No precise mapping for ${source}:${line}:${column}`);
+        return 0;
+      } else {
+        return super.coverage(this._result.url, location.line, location.column);
+      }
+    }
+    const bias = this._sourceMapBias === "greatest_lower_bound" ? SourceMapConsumer.GREATEST_LOWER_BOUND : this._sourceMapBias === "least_upper_bound" ? SourceMapConsumer.LEAST_UPPER_BOUND : void 0;
+    const generated = this._sourceMap.generatedPositionFor({ source, line, column, bias });
+    if (!generated) {
+      this._log.debug(`No position generated for ${source}:${line}:${column}`);
+      return 0;
+    }
+    if (generated.line == null) {
+      this._log.debug(`No line generated for ${source}:${line}:${column}`);
+      return 0;
+    }
+    if (generated.column == null) {
+      this._log.debug(`No column generated for ${source}:${line}:${column}`);
+      return 0;
+    }
+    return super.coverage(this._result.url, generated.line, generated.column);
+  }
+};
+function combineCoverage(analysers, source, line, column) {
+  let coverage = 0;
+  if (!analysers)
+    return coverage;
+  for (const analyser of analysers) {
+    coverage += analyser.coverage(source, line, column);
+  }
+  return coverage;
+}
+var SourcesCoverageAnalyser = class extends CoverageAnalyserImpl {
+  constructor(log, _filename) {
+    super(log);
+    this._filename = _filename;
+  }
+  _mappings = /* @__PURE__ */ new Map();
+  hasMappings() {
+    return this._mappings.size > 0;
+  }
+  add(source, analyser) {
+    const analysers = this._mappings.get(source) || /* @__PURE__ */ new Set();
+    analysers.add(analyser);
+    this._mappings.set(source, analysers);
+  }
+  async init() {
+    this._log.debug("SourcesCoverageAnalyser", $p(this._filename), $gry(`(${this._mappings.size} mappings)`));
+    for (const analysers of this._mappings.values()) {
+      for (const analyser of analysers) {
+        await analyser.init();
+      }
+    }
+    return this;
+  }
+  destroy() {
+    for (const analysers of this._mappings.values()) {
+      for (const analyser of analysers) {
+        analyser.destroy();
+      }
+    }
+  }
+  coverage(source, line, column) {
+    const analysers = this._mappings.get(source);
+    return combineCoverage(analysers, source, line, column);
+  }
+};
+var CombiningCoverageAnalyser = class extends CoverageAnalyserImpl {
+  _analysers = /* @__PURE__ */ new Set();
+  add(analyser) {
+    this._analysers.add(analyser);
+  }
+  async init() {
+    this._log.debug("CombiningCoverageAnalyser", $gry(`(${this._analysers.size} analysers)`));
+    this._log.enter();
+    try {
+      for (const analyser of this._analysers)
+        await analyser.init();
+      return this;
+    } finally {
+      this._log.leave();
+    }
+  }
+  destroy() {
+    for (const analyser of this._analysers)
+      analyser.destroy();
+  }
+  coverage(source, line, column) {
+    return combineCoverage(this._analysers, source, line, column);
+  }
+};
+async function createAnalyser(sourceFiles, coverageFiles, sourceMapBias, log) {
+  var _a;
+  const urls = sourceFiles.map((path) => pathToFileURL(path).toString());
+  const analyser = new CombiningCoverageAnalyser(log);
+  for await (const coverageFile of coverageFiles) {
+    const coverageFileAnalyser = new SourcesCoverageAnalyser(log, coverageFile);
+    log.info("Parsing coverage file", $p(coverageFile));
+    const contents = await readFile(coverageFile, "utf-8");
+    const coverage = JSON.parse(contents);
+    for (const result of coverage.result) {
+      if (!result.url.startsWith("node:")) {
+        log.debug("Found coverage data for", result.url);
+      }
+      const mapping = (_a = coverage["source-map-cache"]) == null ? void 0 : _a[result.url];
+      if (mapping) {
+        log.debug("Found source mapping for", result.url, mapping.data);
+        const matches = urls.filter((url) => {
+          var _a2;
+          return (_a2 = mapping.data) == null ? void 0 : _a2.sources.includes(url);
+        });
+        if (matches.length) {
+          log.debug("Found source mapping matches", matches);
+          const sourceAnalyser = new CoverageSitemapAnalyser(log, result, mapping, sourceMapBias);
+          for (const match of matches)
+            coverageFileAnalyser.add(match, sourceAnalyser);
+        }
+      } else if (urls.includes(result.url)) {
+        coverageFileAnalyser.add(result.url, new CoverageResultAnalyser(log, result));
+      }
+    }
+    if (coverageFileAnalyser.hasMappings())
+      analyser.add(coverageFileAnalyser);
+  }
+  return await analyser.init();
+}
+export {
+  CombiningCoverageAnalyser,
+  SourcesCoverageAnalyser,
+  createAnalyser
+};
+//# sourceMappingURL=analysis.mjs.map

package/dist/analysis.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/analysis.ts"],
+  "mappings": "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",
+  "names": ["_a"]
+}

package/dist/coverage.cjs

@@ -0,0 +1,150 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// coverage.ts
+var coverage_exports = {};
+__export(coverage_exports, {
+  Coverage: () => Coverage
+});
+module.exports = __toCommonJS(coverage_exports);
+var import_node_path = require("node:path");
+var import_cov8_html = require("@plugjs/cov8-html");
+var import_files = require("@plugjs/plug/files");
+var import_logging = require("@plugjs/plug/logging");
+var import_paths = require("@plugjs/plug/paths");
+var import_utils = require("@plugjs/plug/utils");
+var import_analysis = require("./analysis.cjs");
+var import_report = require("./report.cjs");
+var Coverage = class {
+  constructor(_coverageDir, _options = {}) {
+    this._coverageDir = _coverageDir;
+    this._options = _options;
+  }
+  async pipe(files, context) {
+    const coverageDir = context.resolve(this._coverageDir);
+    const coverageFiles = [];
+    for await (const file of (0, import_utils.walk)(coverageDir, ["coverage-*.json"])) {
+      coverageFiles.push((0, import_paths.resolveAbsolutePath)(coverageDir, file));
+    }
+    if (coverageFiles.length === 0) {
+      throw context.log.fail(`No coverage files found in ${(0, import_logging.$p)(coverageDir)}`);
+    }
+    const sourceFiles = [...files.absolutePaths()];
+    const ms1 = Date.now();
+    const analyser = await (0, import_analysis.createAnalyser)(
+      sourceFiles,
+      coverageFiles,
+      this._options.sourceMapBias || "least_upper_bound",
+      context.log
+    );
+    context.log.info("Parsed", coverageFiles.length, "coverage files", (0, import_logging.$ms)(Date.now() - ms1));
+    const ms2 = Date.now();
+    const report = await (0, import_report.coverageReport)(analyser, sourceFiles, context.log);
+    context.log.info("Analysed", sourceFiles.length, "source files", (0, import_logging.$ms)(Date.now() - ms2));
+    analyser.destroy();
+    const {
+      minimumCoverage = 50,
+      minimumFileCoverage = minimumCoverage,
+      optimalCoverage = Math.round((100 + minimumCoverage) / 2),
+      optimalFileCoverage = Math.round((100 + minimumFileCoverage) / 2)
+    } = this._options;
+    let max = 0;
+    for (const file in report) {
+      if (file.length > max)
+        max = file.length;
+    }
+    let maxLength = 0;
+    for (const file in report.results) {
+      if (file.length > maxLength)
+        maxLength = file.length;
+    }
+    let fileErrors = 0;
+    let fileWarnings = 0;
+    const _report = context.log.report("Coverage report");
+    for (const [_file, result] of Object.entries(report.results)) {
+      const { coverage } = result.nodeCoverage;
+      const file = _file;
+      if (coverage == null) {
+        _report.annotate(import_logging.NOTICE, file, "n/a");
+      } else if (coverage < minimumFileCoverage) {
+        _report.annotate(import_logging.ERROR, file, `${coverage} %`);
+        fileErrors++;
+      } else if (coverage < optimalFileCoverage) {
+        _report.annotate(import_logging.WARN, file, `${coverage} %`);
+        fileWarnings++;
+      } else {
+        _report.annotate(import_logging.NOTICE, file, `${coverage} %`);
+      }
+    }
+    if (report.nodes.coverage == null) {
+      const message = "No coverage data collected";
+      _report.add({ level: import_logging.WARN, message });
+    } else if (report.nodes.coverage < minimumCoverage) {
+      const message = `${(0, import_logging.$red)(`${report.nodes.coverage}%`)} does not meet minimum coverage ${(0, import_logging.$gry)(`(${minimumCoverage}%)`)}`;
+      _report.add({ level: import_logging.ERROR, message });
+    } else if (report.nodes.coverage < optimalCoverage) {
+      const message = `${(0, import_logging.$ylw)(`${report.nodes.coverage}%`)} does not meet optimal coverage ${(0, import_logging.$gry)(`(${optimalCoverage}%)`)}`;
+      _report.add({ level: import_logging.WARN, message });
+    }
+    if (fileErrors) {
+      const message = `${(0, import_logging.$red)(fileErrors)} files do not meet minimum file coverage ${(0, import_logging.$gry)(`(${minimumFileCoverage}%)`)}`;
+      _report.add({ level: import_logging.ERROR, message });
+    }
+    if (fileWarnings) {
+      const message = `${(0, import_logging.$ylw)(fileWarnings)} files do not meet optimal file coverage ${(0, import_logging.$gry)(`(${optimalFileCoverage}%)`)}`;
+      _report.add({ level: import_logging.WARN, message });
+    }
+    if (this._options.reportDir == null)
+      return _report.done(false);
+    const reportDir = context.resolve(this._options.reportDir);
+    const builder = import_files.Files.builder(reportDir);
+    const date = new Date().toISOString();
+    const thresholds = {
+      minimumCoverage,
+      minimumFileCoverage,
+      optimalCoverage,
+      optimalFileCoverage
+    };
+    await builder.write("report.json", JSON.stringify({ ...report, thresholds, date }));
+    await builder.write("index.html", import_cov8_html.html);
+    const results = {};
+    for (const [rel, abs] of files.pathMappings()) {
+      results[rel] = report.results[abs];
+    }
+    const tree = {};
+    for (const relative of Object.keys(results)) {
+      const directories = relative.split(import_node_path.sep);
+      const file = directories.pop();
+      let node = tree;
+      for (const dir of directories) {
+        node = node[dir] = node[dir] || {};
+      }
+      node[file] = relative;
+    }
+    const jsonp = JSON.stringify({ ...report, results, thresholds, tree, date });
+    await builder.write("report.js", `${import_cov8_html.initFunction}(${jsonp});`);
+    _report.done(false);
+    return builder.build();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Coverage
+});
+//# sourceMappingURL=coverage.cjs.map

package/dist/coverage.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/coverage.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/coverage.d.ts

@@ -0,0 +1,9 @@
+/// <reference path="index.d.ts" />
+import { Files } from '@plugjs/plug/files';
+import type { Context, PipeParameters, Plug } from '@plugjs/plug/pipe';
+export declare class Coverage implements Plug<Files | undefined> {
+    private readonly _coverageDir;
+    private readonly _options;
+    constructor(...args: PipeParameters<'coverage'>);
+    pipe(files: Files, context: Context): Promise<Files | undefined>;
+}

package/dist/coverage.mjs

@@ -0,0 +1,125 @@
+// coverage.ts
+import { sep } from "node:path";
+import { html, initFunction } from "@plugjs/cov8-html";
+import { Files } from "@plugjs/plug/files";
+import { $gry, $ms, $p, $red, $ylw, ERROR, NOTICE, WARN } from "@plugjs/plug/logging";
+import { resolveAbsolutePath } from "@plugjs/plug/paths";
+import { walk } from "@plugjs/plug/utils";
+import { createAnalyser } from "./analysis.mjs";
+import { coverageReport } from "./report.mjs";
+var Coverage = class {
+  constructor(_coverageDir, _options = {}) {
+    this._coverageDir = _coverageDir;
+    this._options = _options;
+  }
+  async pipe(files, context) {
+    const coverageDir = context.resolve(this._coverageDir);
+    const coverageFiles = [];
+    for await (const file of walk(coverageDir, ["coverage-*.json"])) {
+      coverageFiles.push(resolveAbsolutePath(coverageDir, file));
+    }
+    if (coverageFiles.length === 0) {
+      throw context.log.fail(`No coverage files found in ${$p(coverageDir)}`);
+    }
+    const sourceFiles = [...files.absolutePaths()];
+    const ms1 = Date.now();
+    const analyser = await createAnalyser(
+      sourceFiles,
+      coverageFiles,
+      this._options.sourceMapBias || "least_upper_bound",
+      context.log
+    );
+    context.log.info("Parsed", coverageFiles.length, "coverage files", $ms(Date.now() - ms1));
+    const ms2 = Date.now();
+    const report = await coverageReport(analyser, sourceFiles, context.log);
+    context.log.info("Analysed", sourceFiles.length, "source files", $ms(Date.now() - ms2));
+    analyser.destroy();
+    const {
+      minimumCoverage = 50,
+      minimumFileCoverage = minimumCoverage,
+      optimalCoverage = Math.round((100 + minimumCoverage) / 2),
+      optimalFileCoverage = Math.round((100 + minimumFileCoverage) / 2)
+    } = this._options;
+    let max = 0;
+    for (const file in report) {
+      if (file.length > max)
+        max = file.length;
+    }
+    let maxLength = 0;
+    for (const file in report.results) {
+      if (file.length > maxLength)
+        maxLength = file.length;
+    }
+    let fileErrors = 0;
+    let fileWarnings = 0;
+    const _report = context.log.report("Coverage report");
+    for (const [_file, result] of Object.entries(report.results)) {
+      const { coverage } = result.nodeCoverage;
+      const file = _file;
+      if (coverage == null) {
+        _report.annotate(NOTICE, file, "n/a");
+      } else if (coverage < minimumFileCoverage) {
+        _report.annotate(ERROR, file, `${coverage} %`);
+        fileErrors++;
+      } else if (coverage < optimalFileCoverage) {
+        _report.annotate(WARN, file, `${coverage} %`);
+        fileWarnings++;
+      } else {
+        _report.annotate(NOTICE, file, `${coverage} %`);
+      }
+    }
+    if (report.nodes.coverage == null) {
+      const message = "No coverage data collected";
+      _report.add({ level: WARN, message });
+    } else if (report.nodes.coverage < minimumCoverage) {
+      const message = `${$red(`${report.nodes.coverage}%`)} does not meet minimum coverage ${$gry(`(${minimumCoverage}%)`)}`;
+      _report.add({ level: ERROR, message });
+    } else if (report.nodes.coverage < optimalCoverage) {
+      const message = `${$ylw(`${report.nodes.coverage}%`)} does not meet optimal coverage ${$gry(`(${optimalCoverage}%)`)}`;
+      _report.add({ level: WARN, message });
+    }
+    if (fileErrors) {
+      const message = `${$red(fileErrors)} files do not meet minimum file coverage ${$gry(`(${minimumFileCoverage}%)`)}`;
+      _report.add({ level: ERROR, message });
+    }
+    if (fileWarnings) {
+      const message = `${$ylw(fileWarnings)} files do not meet optimal file coverage ${$gry(`(${optimalFileCoverage}%)`)}`;
+      _report.add({ level: WARN, message });
+    }
+    if (this._options.reportDir == null)
+      return _report.done(false);
+    const reportDir = context.resolve(this._options.reportDir);
+    const builder = Files.builder(reportDir);
+    const date = new Date().toISOString();
+    const thresholds = {
+      minimumCoverage,
+      minimumFileCoverage,
+      optimalCoverage,
+      optimalFileCoverage
+    };
+    await builder.write("report.json", JSON.stringify({ ...report, thresholds, date }));
+    await builder.write("index.html", html);
+    const results = {};
+    for (const [rel, abs] of files.pathMappings()) {
+      results[rel] = report.results[abs];
+    }
+    const tree = {};
+    for (const relative of Object.keys(results)) {
+      const directories = relative.split(sep);
+      const file = directories.pop();
+      let node = tree;
+      for (const dir of directories) {
+        node = node[dir] = node[dir] || {};
+      }
+      node[file] = relative;
+    }
+    const jsonp = JSON.stringify({ ...report, results, thresholds, tree, date });
+    await builder.write("report.js", `${initFunction}(${jsonp});`);
+    _report.done(false);
+    return builder.build();
+  }
+};
+export {
+  Coverage
+};
+//# sourceMappingURL=coverage.mjs.map

package/dist/coverage.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/coverage.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/index.cjs

@@ -0,0 +1,22 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);
+var import_pipe = require("@plugjs/plug/pipe");
+var import_coverage = require("./coverage.cjs");
+(0, import_pipe.install)("coverage", import_coverage.Coverage);
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,kBAAwB;AAExB,sBAAyB;AAAA,IA2DzB,qBAAQ,YAAY,wBAAQ;",
+  "names": []
+}

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import type { SourceMapBias } from './analysis';
+/** Options to analyse coverage reports */
+export interface CoverageOptions {
+    /** The bias for source map analisys (defaults to `greatest_lower_bound`) */
+    sourceMapBias?: SourceMapBias;
+    /** Minimum _overall_ coverage (as a percentage, defaults to 50) */
+    minimumCoverage?: number;
+    /** Optimal _overall_ coverage (as a percentage, defaults to 50)  */
+    optimalCoverage?: number;
+    /** Minimum _per-file_ coverage (as a percentage, defaults to 75) */
+    minimumFileCoverage?: number;
+    /** Optimal _per-file_ coverage (as a percentage, defaults to 75) */
+    optimalFileCoverage?: number;
+}
+export interface CoverageReportOptions extends CoverageOptions {
+    /** If specified, a JSON and HTML report will be written to this directory */
+    reportDir: string;
+}
+declare module '@plugjs/plug' {
+    interface Pipe {
+        /**
+         * Analyse coverage using files generated by V8/NodeJS.
+         *
+         * @param coverageDir The directory where the `coverage-XXX.json` files
+         *                    generated by V8/NodeJS can be found.
+         */
+        coverage(coverageDir: string): Promise<undefined>;
+        /**
+         * Analyse coverage using files generated by V8/NodeJS.
+         *
+         * @param coverageDir The directory where the `coverage-XXX.json` files
+         *                    generated by V8/NodeJS can be found.
+         * @param options Extra {@link CoverageOptions | options} allowing to
+         *                specify coverage thresholds.
+         */
+        coverage(coverageDir: string, options: CoverageOptions): Promise<undefined>;
+        /**
+         * Analyse coverage using files generated by V8/NodeJS and produce an HTML
+         * report in the directory specified in `options`.
+         *
+         * @param coverageDir The directory where the `coverage-XXX.json` files
+         *                    generated by V8/NodeJS can be found.
+         * @param options Extra {@link CoverageOptions | options} allowing to
+         *                specify coverage thresholds where the HTML report should
+         *                be written to.
+         */
+        coverage(coverageDir: string, options: CoverageReportOptions): Pipe;
+    }
+}

package/dist/index.mjs

@@ -0,0 +1,5 @@
+// index.ts
+import { install } from "@plugjs/plug/pipe";
+import { Coverage } from "./coverage.mjs";
+install("coverage", Coverage);
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "mappings": ";AAAA,SAAS,eAAe;AAExB,SAAS,gBAAgB;AA2DzB,QAAQ,YAAY,QAAQ;",
+  "names": []
+}