@matter/tools 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/testing/chip/pics-file.js

@@ -0,0 +1,79 @@
+"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);
+var pics_file_exports = {};
+__export(pics_file_exports, {
+  PicsFile: () => PicsFile
+});
+module.exports = __toCommonJS(pics_file_exports);
+var import_fs = require("fs");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function readValue(line) {
+  const valueMatch = line.match(/^(\S+)=(.*)$/);
+  if (valueMatch) {
+    return { key: valueMatch[1], value: valueMatch[2] };
+  }
+  return { key: void 0, value: void 0 };
+}
+class PicsFile {
+  #lines;
+  #values;
+  constructor(pathOrBody, inline = false) {
+    if (inline === false) {
+      pathOrBody = (0, import_fs.readFileSync)(pathOrBody, "utf-8");
+    }
+    this.#lines = pathOrBody.split("\n").map((l) => l.trim());
+  }
+  get lines() {
+    return this.#lines;
+  }
+  get values() {
+    if (!this.#values) {
+      const values = {};
+      for (const line of this.lines) {
+        const { key, value } = readValue(line);
+        if (key !== void 0) {
+          values[key] = value;
+        }
+      }
+      this.#values = values;
+    }
+    return this.#values;
+  }
+  patch(other) {
+    this.#lines = this.lines.map((line) => {
+      const { key } = readValue(line);
+      if (key === void 0) {
+        return line;
+      }
+      const otherValue = other.values[key];
+      if (otherValue === void 0) {
+        return line;
+      }
+      return `${key}=${otherValue}`;
+    });
+  }
+  save(path) {
+    (0, import_fs.writeFileSync)(path, this.lines.join("\n"));
+  }
+}
+//# sourceMappingURL=pics-file.js.map

package/dist/cjs/testing/chip/pics-file.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/testing/chip/pics-file.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,gBAA4C;AAN5C;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,UAAU,MAAc;AAC7B,QAAM,aAAa,KAAK,MAAM,cAAc;AAC5C,MAAI,YAAY;AACZ,WAAO,EAAE,KAAK,WAAW,CAAC,GAAG,OAAO,WAAW,CAAC,EAAE;AAAA,EACtD;AACA,SAAO,EAAE,KAAK,QAAW,OAAO,OAAU;AAC9C;AAQO,MAAM,SAAS;AAAA,EAClB;AAAA,EACA;AAAA,EAEA,YAAY,YAAoB,SAAS,OAAO;AAC5C,QAAI,WAAW,OAAO;AAClB,uBAAa,wBAAa,YAAY,OAAO;AAAA,IACjD;AACA,SAAK,SAAS,WAAW,MAAM,IAAI,EAAE,IAAI,OAAK,EAAE,KAAK,CAAC;AAAA,EAC1D;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,SAAS;AACT,QAAI,CAAC,KAAK,SAAS;AACf,YAAM,SAAS,CAAC;AAChB,iBAAW,QAAQ,KAAK,OAAO;AAC3B,cAAM,EAAE,KAAK,MAAM,IAAI,UAAU,IAAI;AACrC,YAAI,QAAQ,QAAW;AACnB,iBAAO,GAAG,IAAI;AAAA,QAClB;AAAA,MACJ;AACA,WAAK,UAAU;AAAA,IACnB;AACA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,MAAM,OAAiB;AACnB,SAAK,SAAS,KAAK,MAAM,IAAI,UAAQ;AACjC,YAAM,EAAE,IAAI,IAAI,UAAU,IAAI;AAC9B,UAAI,QAAQ,QAAW;AACnB,eAAO;AAAA,MACX;AAEA,YAAM,aAAa,MAAM,OAAO,GAAG;AACnC,UAAI,eAAe,QAAW;AAC1B,eAAO;AAAA,MACX;AAEA,aAAO,GAAG,GAAG,IAAI,UAAU;AAAA,IAC/B,CAAC;AAAA,EACL;AAAA,EAEA,KAAK,MAAc;AACf,iCAAc,MAAM,KAAK,MAAM,KAAK,IAAI,CAAC;AAAA,EAC7C;AACJ;",
+  "names": []
+}

package/dist/cjs/testing/chip.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type TestRunner } from "./runner.js";
+/**
+ * CHIP testing controller.  "CHIP tests" are official tests implemented in the connectedhomeip repository.
+ */
+export declare const Chip: {
+    /**
+     * Configure CHIP testing.  Invoke prior to use of other methods.
+     */
+    config: Chip.Options;
+    /**
+     * Initialize.  This must run before defining tests to enable test definition via globs.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Define YAML tests.  This is a declarative CHIP test defined in a YAML file.
+     */
+    yaml(testee: Chip.Testee, includeGlob: string, excludeGlob?: string): void;
+    /**
+     * Define a "python" test.  This is a CHIP test implemented as a python script.
+     */
+    python(testee: Chip.Testee, tester: Chip.TestSelection, excludeGlob?: string): void;
+};
+export declare namespace Chip {
+    /**
+     * The test subject.
+     */
+    interface Testee {
+        setup(): Promise<void>;
+        start(): Promise<void>;
+        stop(): Promise<void>;
+    }
+    /**
+     * The test implementation.
+     */
+    type TestSelection = Tester | string;
+    /**
+     * Configuration required from testing program.
+     */
+    interface Options {
+        runner: TestRunner;
+    }
+    /**
+     * Details of how to run a specific test.
+     */
+    interface Tester {
+        name: string;
+        description?: string;
+        command?: string[];
+        args?: Record<string, string>;
+        timeout?: number;
+        environment?: Record<string, string>;
+    }
+}
+export type Chip = typeof Chip;
+//# sourceMappingURL=chip.d.ts.map

package/dist/cjs/testing/chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chip.d.ts","sourceRoot":"","sources":["../../../src/testing/chip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAqE9C;;GAEG;AACH,eAAO,MAAM,IAAI;IACb;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;iBACU,IAAI,CAAC,MAAM,eAAe,MAAM,gBAAgB,MAAM;IA0BnE;;OAEG;mBACY,IAAI,CAAC,MAAM,UAAU,IAAI,CAAC,aAAa,gBAAgB,MAAM;CAgC/E,CAAC;AAqDF,yBAAiB,IAAI,CAAC;IAClB;;OAEG;IACH,UAAiB,MAAM;QACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB;IAED;;OAEG;IACH,KAAY,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;IAE5C;;OAEG;IACH,UAAiB,OAAO;QACpB,MAAM,EAAE,UAAU,CAAC;KACtB;IAED;;OAEG;IACH,UAAiB,MAAM;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACxC;CACJ;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC"}

package/dist/cjs/testing/chip.js

@@ -0,0 +1,306 @@
+"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);
+var chip_exports = {};
+__export(chip_exports, {
+  Chip: () => Chip
+});
+module.exports = __toCommonJS(chip_exports);
+var import_path = require("path");
+var import_docker = require("../util/docker.js");
+var import_package = require("../util/package.js");
+var import_pics_file = require("./chip/pics-file.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var Constants;
+((Constants2) => {
+  Constants2.chip = "/connectedhomeip";
+  Constants2.chipTool = `${Constants2.chip}/scripts/tests/chipyaml/chiptool.py`;
+  Constants2.yamlTests = `${Constants2.chip}/src/app/tests/suites/certification`;
+  Constants2.pythonTests = `${Constants2.chip}/src/python_testing`;
+  Constants2.python = ["/usr/bin/env", "-S", "python3", "-B"];
+  Constants2.pythonRunner = `${Constants2.chip}/scripts/tests/run_python_test.py`;
+  Constants2.pics = "/matter.js/packages/tools/build/pics.properties";
+  Constants2.chipPics = "/connectedhomeip/src/app/tests/suites/certification/ci-pics-values";
+  Constants2.buildTimeout = 6e5;
+  Constants2.defaultTimeout = 6e4;
+  Constants2.dockerBuildPath = "chip";
+  Constants2.dockerName = "matterjs-chip";
+})(Constants || (Constants = {}));
+const State = {
+  configured: false,
+  options: void 0,
+  docker: void 0,
+  yamlTests: Array(),
+  pythonTests: Array()
+};
+const Config = {
+  set options(options) {
+    State.options = options;
+  },
+  get runner() {
+    const runner = State.options?.runner;
+    if (runner === void 0) {
+      throw new Error("No test runner configured");
+    }
+    return runner;
+  },
+  async docker() {
+    if (State.docker) {
+      return State.docker;
+    }
+    const docker = new import_docker.Docker();
+    const { progress } = Config.runner;
+    await progress.run(
+      `Build ${progress.emphasize("CHIP image")}`,
+      () => docker.buildImage(Constants.dockerName, import_package.Package.tools.resolve(Constants.dockerBuildPath))
+    );
+    State.docker = docker;
+    return docker;
+  }
+};
+const Chip = {
+  /**
+   * Configure CHIP testing.  Invoke prior to use of other methods.
+   */
+  set config(config) {
+    Config.options = config;
+  },
+  /**
+   * Initialize.  This must run before defining tests to enable test definition via globs.
+   */
+  async initialize() {
+    await initialize();
+  },
+  /**
+   * Define YAML tests.  This is a declarative CHIP test defined in a YAML file.
+   */
+  yaml(testee, includeGlob, excludeGlob) {
+    let tests = filterWithGlob(State.yamlTests, includeGlob);
+    if (excludeGlob !== void 0) {
+      tests = filterWithGlob(tests, excludeGlob, true);
+    }
+    if (tests.length === 0) {
+      throw new Error(`YAML test glob ${includeGlob} matched no tests`);
+    }
+    for (const file of tests) {
+      implementTest(testee, {
+        name: (0, import_path.parse)(file).base,
+        command: [Constants.pythonRunner, file],
+        // TODO - complete argument set
+        args: {
+          "--pics-file": Constants.pics,
+          "--discriminator": "1234",
+          "--passcode": "20202021"
+        }
+      });
+    }
+  },
+  /**
+   * Define a "python" test.  This is a CHIP test implemented as a python script.
+   */
+  python(testee, tester, excludeGlob) {
+    if (typeof tester === "string") {
+      tester = {
+        name: tester
+      };
+    } else {
+      tester = { ...tester };
+    }
+    tester.args = {
+      "--commissioning-method": "on-network",
+      "--PICS": Constants.pics,
+      "--discriminator": "1234",
+      "--passcode": "20202021",
+      ...tester.args
+    };
+    let files = filterWithGlob(State.pythonTests, tester.name, false);
+    if (excludeGlob !== void 0) {
+      files = filterWithGlob(files, excludeGlob, true);
+    }
+    if (files.length === 0) {
+      throw new Error(`Python test glob ${tester.name} matched no tests`);
+    }
+    for (const file of files) {
+      const name = (0, import_path.parse)(file).name;
+      implementTest(testee, { ...tester, name, command: [file] });
+    }
+  }
+};
+let containerInitializerInstalled = false;
+function implementTest(testee, tester) {
+  if (!containerInitializerInstalled) {
+    containerInitializerInstalled = true;
+    before(async function() {
+      this.timeout(Constants.buildTimeout);
+      await initialize();
+    });
+  }
+  it(tester.description ?? tester.name, async () => {
+    await testee.setup();
+    await testee.start();
+    try {
+      await invokeTester(tester);
+    } finally {
+      try {
+        await testee.stop();
+      } catch (e) {
+        console.warn("Error stopping test subject", e);
+      }
+    }
+  }).timeout(tester.timeout ?? Constants.defaultTimeout);
+}
+async function invokeTester(tester) {
+  const docker = await Config.docker();
+  const args = Array();
+  if (tester.command) {
+    args.push(...tester.command);
+  }
+  if (tester.args) {
+    args.push(...Object.entries(tester.args).flat());
+  }
+  const output = docker.run(Constants.dockerName, {
+    args,
+    env: tester.environment,
+    binds: {
+      [import_package.Package.workspace.path]: "/matter.js"
+    },
+    network: "host"
+  });
+  await translateTestOutput(Config.runner, output);
+}
+function deansify(text) {
+  return text.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, "");
+}
+async function translateTestOutput(runner, output) {
+  let testCount = 0;
+  let capture = Array();
+  let partial;
+  function reportFailures() {
+    let testName;
+    let testLogs;
+    for (const line of capture) {
+      const subtestBoundary = deansify(line).match(/\*{5} (Test Step \d+|Test Failure) : (.*)/);
+      if (subtestBoundary) {
+        if (subtestBoundary[1] === "Test Failure") {
+          if (testName === void 0) {
+            continue;
+          }
+          runner.reporter.failTest(testName, {
+            message: subtestBoundary[2],
+            logs: testLogs?.join("\n")
+          });
+        } else {
+          testName = subtestBoundary[2];
+          testLogs = [];
+        }
+      } else if (testLogs) {
+        const appOut = line.match(/^.* APP {2}OUT {2}: (.*)$/);
+        if (appOut) {
+          testLogs.push(appOut[1]);
+          continue;
+        }
+        const testOut = line.match(/(\d{4}-\d\d-\d\d) .*(\d\d:\d\d:\d\d\.\d\d\d) - TEST OUT {2}: (.*)$/);
+        if (testOut) {
+          if (deansify(testOut[3]).match(/^(?:✗ \d+.\d+ms$|\s+\d+\. Running )/)) {
+            continue;
+          }
+          const date = testOut[1];
+          const time = testOut[2];
+          const message = testOut[3].replace("		    ", "").replace(/\t/g, "  ");
+          testLogs.push(`CHIP ${date} ${time} ${message}`);
+          continue;
+        }
+        testLogs.push(line);
+      }
+    }
+  }
+  function processLine(line) {
+    MockLogger.injectExternalMessage("CHIP", line);
+    line = line.trim();
+    const plain = deansify(line);
+    const testBoundary = plain.match(
+      /^\d{4}-\d\d-\d\d \d\d:\d\d:\d\d\.\d{3} [A-Z ]{7} ([a-zA-Z0-9_]+)\s+- (Starting test|(?:Completed|FAILED) in \d+\.\d+ seconds)$/
+    );
+    if (testBoundary) {
+      if (testBoundary[2].startsWith("Start")) {
+        testCount++;
+        capture = [];
+        runner.reporter.beginRun(testBoundary[1], void 0, false);
+      } else if (testBoundary[2].startsWith("Completed")) {
+        runner.reporter.endRun();
+      } else {
+        reportFailures();
+        runner.reporter.endRun();
+      }
+    }
+    capture.push(line);
+  }
+  for await (const chunk of output) {
+    const lines = chunk.split("\n");
+    if (partial) {
+      lines[0] = partial + lines[0];
+    }
+    partial = lines.pop();
+    for (const line of lines) {
+      processLine(line);
+    }
+  }
+  if (partial !== void 0) {
+    processLine(partial);
+  }
+}
+async function initialize() {
+  if (State.configured) {
+    return;
+  }
+  await Config.docker();
+  await configurePics();
+  await configureYaml();
+  await configurePython();
+  State.configured = true;
+}
+async function configurePics() {
+  const docker = await Config.docker();
+  const ciPics = await docker.readFileFromImage(Constants.dockerName, Constants.chipPics);
+  const pics = new import_pics_file.PicsFile(ciPics, true);
+  const overrides = new import_pics_file.PicsFile(import_package.Package.tools.resolve("src/testing/chip/pics.properties"));
+  pics.patch(overrides);
+  pics.save(import_package.Package.tools.resolve("build/pics.properties"));
+}
+async function configureYaml() {
+  const docker = await Config.docker();
+  const tests = await docker.resolveGlobFromImage(Constants.dockerName, `${Constants.yamlTests}/Test_*.yaml`);
+  State.yamlTests.push(...tests);
+}
+async function configurePython() {
+  const docker = await Config.docker();
+  const tests = (await docker.resolveGlobFromImage(Constants.dockerName, `${Constants.pythonTests}/*.py`)).filter(
+    (name) => name.match(/(?:TC_|Test)[^/]\.py$/)
+  );
+  State.pythonTests.push(...tests);
+}
+function filterWithGlob(list, glob, invert = false) {
+  const globPattern = glob.replace(/\*/g, "[^\\/]+");
+  const pattern = new RegExp(`^.*/(?:Test_TC_|TC|Test)${globPattern}\\.(?:py|yaml)$`);
+  return list.filter((s) => !!s.match(pattern) === !invert);
+}
+//# sourceMappingURL=chip.js.map

package/dist/cjs/testing/chip.js.map

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

package/dist/cjs/testing/cli.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import "../util/node-shims.js";
+import "./global-definitions.js";
+export declare function main(argv?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cjs/testing/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/testing/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,uBAAuB,CAAC;AAC/B,OAAO,yBAAyB,CAAC;AAiBjC,wBAAsB,IAAI,CAAC,IAAI,WAAe,iBAiG7C"}

package/dist/cjs/testing/cli.js

@@ -0,0 +1,117 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cli_exports = {};
+__export(cli_exports, {
+  main: () => main
+});
+module.exports = __toCommonJS(cli_exports);
+var import_node_shims = require("../util/node-shims.js");
+var import_global_definitions = require("./global-definitions.js");
+var import_yargs = __toESM(require("yargs"), 1);
+var import_helpers = require("yargs/helpers");
+var import_builder = require("../building/builder.js");
+var import_graph = require("../building/graph.js");
+var import_project = require("../building/project.js");
+var import_runner = require("./runner.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var TestType = /* @__PURE__ */ ((TestType2) => {
+  TestType2["esm"] = "esm";
+  TestType2["cjs"] = "cjs";
+  TestType2["web"] = "web";
+  return TestType2;
+})(TestType || {});
+Error.stackTraceLimit = 50;
+async function main(argv = process.argv) {
+  const testTypes = /* @__PURE__ */ new Set();
+  let manual = false;
+  const args = await (0, import_yargs.default)((0, import_helpers.hideBin)(argv)).usage("Runs tests in packages adhering to matter.js standards.").option("prefix", {
+    alias: "p",
+    default: ".",
+    type: "string",
+    describe: "specify directory of package to test"
+  }).option("web", {
+    alias: "w",
+    default: false,
+    type: "boolean",
+    describe: "enable web tests in default test mode"
+  }).option("spec", {
+    type: "array",
+    string: true,
+    describe: "One or more paths of tests to run",
+    default: "./test/**/*Test.ts"
+  }).option("all-logs", { type: "boolean", describe: "Emit log messages in real time" }).option("debug", { type: "boolean", describe: "Enable Mocha debugging" }).option("environment", { alias: "e", type: "string", describe: "Select named test environment" }).option("fgrep", { alias: "f", type: "string", describe: "Only run tests matching this string" }).option("force-exit", { type: "boolean", describe: "Force Node to exit after tests complete" }).option("grep", { alias: "g", type: "string", describe: "Only run tests matching this regexp" }).option("invert", { alias: "i", type: "boolean", describe: "Inverts --grep and --fgrep matches" }).option("profile", { type: "boolean", describe: "Write profiling data to build/profiles (node only)" }).option("wtf", { type: "boolean", describe: "Enlist wtfnode to detect test leaks" }).option("trace-unhandled", { type: "boolean", describe: "Detail unhandled rejections with trace-unhandled" }).command("*", "run all supported test types").command("esm", "run tests on node (ES6 modules)", () => testTypes.add("esm" /* esm */)).command("cjs", "run tests on node (CommonJS modules)", () => testTypes.add("cjs" /* cjs */)).command("web", "run tests in web browser", () => testTypes.add("web" /* web */)).command("manual", "start test server and print URL for manual testing", () => {
+    testTypes.add("web" /* web */);
+    manual = true;
+  }).strict().argv;
+  let packageLocation = args.prefix;
+  if (packageLocation === "." && args.spec) {
+    const firstSpec = Array.isArray(args.spec) ? args.spec[0] : args.spec;
+    packageLocation = firstSpec;
+  }
+  const project = new import_project.Project(packageLocation);
+  process.chdir(project.pkg.path);
+  if (!testTypes.size) {
+    if (project.pkg.supportsEsm) {
+      testTypes.add("esm" /* esm */);
+    }
+    if (project.pkg.supportsCjs) {
+      testTypes.add("cjs" /* cjs */);
+    }
+    if (args.web) {
+      testTypes.add("web" /* web */);
+    }
+  }
+  const builder = new import_builder.Builder();
+  const dependencies = await import_graph.Graph.forProject(packageLocation);
+  if (dependencies) {
+    await dependencies.build(builder, false);
+  } else {
+    await builder.build(project);
+  }
+  const progress = project.pkg.start("Testing");
+  const runner = new import_runner.TestRunner(project.pkg, progress, args);
+  if (testTypes.has("esm" /* esm */)) {
+    await runner.runNode("esm");
+  }
+  if (testTypes.has("cjs" /* cjs */)) {
+    await runner.runNode("cjs");
+  }
+  if (testTypes.has("web" /* web */)) {
+    await runner.runWeb(manual);
+  }
+  progress.shutdown();
+  if (args.forceExit) {
+    process.exit(0);
+  }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cjs/testing/cli.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/testing/cli.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,wBAAO;AACP,gCAAO;AAEP,mBAAkB;AAClB,qBAAwB;AACxB,qBAAwB;AACxB,mBAAsB;AACtB,qBAAwB;AACxB,oBAA2B;AAd3B;AAAA;AAAA;AAAA;AAAA;AAgBA,IAAK,WAAL,kBAAKA,cAAL;AACI,EAAAA,UAAA,SAAM;AACN,EAAAA,UAAA,SAAM;AACN,EAAAA,UAAA,SAAM;AAHL,SAAAA;AAAA,GAAA;AAML,MAAM,kBAAkB;AAExB,eAAsB,KAAK,OAAO,QAAQ,MAAM;AAC5C,QAAM,YAAY,oBAAI,IAAc;AAEpC,MAAI,SAAS;AAEb,QAAM,OAAO,UAAM,aAAAC,aAAM,wBAAQ,IAAI,CAAC,EACjC,MAAM,yDAAyD,EAC/D,OAAO,UAAU;AAAA,IACd,OAAO;AAAA,IACP,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,EACd,CAAC,EACA,OAAO,OAAO;AAAA,IACX,OAAO;AAAA,IACP,SAAS;AAAA,IACT,MAAM;AAAA,IACN,UAAU;AAAA,EACd,CAAC,EACA,OAAO,QAAQ;AAAA,IACZ,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS;AAAA,EACb,CAAC,EACA,OAAO,YAAY,EAAE,MAAM,WAAW,UAAU,iCAAiC,CAAC,EAClF,OAAO,SAAS,EAAE,MAAM,WAAW,UAAU,yBAAyB,CAAC,EACvE,OAAO,eAAe,EAAE,OAAO,KAAK,MAAM,UAAU,UAAU,gCAAgC,CAAC,EAC/F,OAAO,SAAS,EAAE,OAAO,KAAK,MAAM,UAAU,UAAU,sCAAsC,CAAC,EAC/F,OAAO,cAAc,EAAE,MAAM,WAAW,UAAU,0CAA0C,CAAC,EAC7F,OAAO,QAAQ,EAAE,OAAO,KAAK,MAAM,UAAU,UAAU,sCAAsC,CAAC,EAC9F,OAAO,UAAU,EAAE,OAAO,KAAK,MAAM,WAAW,UAAU,qCAAqC,CAAC,EAChG,OAAO,WAAW,EAAE,MAAM,WAAW,UAAU,qDAAqD,CAAC,EACrG,OAAO,OAAO,EAAE,MAAM,WAAW,UAAU,sCAAsC,CAAC,EAClF,OAAO,mBAAmB,EAAE,MAAM,WAAW,UAAU,mDAAmD,CAAC,EAC3G,QAAQ,KAAK,8BAA8B,EAC3C,QAAQ,OAAO,mCAAmC,MAAM,UAAU,IAAI,eAAY,CAAC,EACnF,QAAQ,OAAO,wCAAwC,MAAM,UAAU,IAAI,eAAY,CAAC,EACxF,QAAQ,OAAO,4BAA4B,MAAM,UAAU,IAAI,eAAY,CAAC,EAC5E,QAAQ,UAAU,sDAAsD,MAAM;AAC3E,cAAU,IAAI,eAAY;AAC1B,aAAS;AAAA,EACb,CAAC,EACA,OAAO,EAAE;AAGd,MAAI,kBAAkB,KAAK;AAC3B,MAAI,oBAAoB,OAAO,KAAK,MAAM;AACtC,UAAM,YAAY,MAAM,QAAQ,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK;AACjE,sBAAkB;AAAA,EACtB;AAEA,QAAM,UAAU,IAAI,uBAAQ,eAAe;AAE3C,UAAQ,MAAM,QAAQ,IAAI,IAAI;AAG9B,MAAI,CAAC,UAAU,MAAM;AACjB,QAAI,QAAQ,IAAI,aAAa;AACzB,gBAAU,IAAI,eAAY;AAAA,IAC9B;AACA,QAAI,QAAQ,IAAI,aAAa;AACzB,gBAAU,IAAI,eAAY;AAAA,IAC9B;AACA,QAAI,KAAK,KAAK;AACV,gBAAU,IAAI,eAAY;AAAA,IAC9B;AAAA,EACJ;AAEA,QAAM,UAAU,IAAI,uBAAQ;AAC5B,QAAM,eAAe,MAAM,mBAAM,WAAW,eAAe;AAC3D,MAAI,cAAc;AACd,UAAM,aAAa,MAAM,SAAS,KAAK;AAAA,EAC3C,OAAO;AACH,UAAM,QAAQ,MAAM,OAAO;AAAA,EAC/B;AAEA,QAAM,WAAW,QAAQ,IAAI,MAAM,SAAS;AAC5C,QAAM,SAAS,IAAI,yBAAW,QAAQ,KAAK,UAAU,IAAI;AAEzD,MAAI,UAAU,IAAI,eAAY,GAAG;AAC7B,UAAM,OAAO,QAAQ,KAAK;AAAA,EAC9B;AAEA,MAAI,UAAU,IAAI,eAAY,GAAG;AAC7B,UAAM,OAAO,QAAQ,KAAK;AAAA,EAC9B;AAEA,MAAI,UAAU,IAAI,eAAY,GAAG;AAC7B,UAAM,OAAO,OAAO,MAAM;AAAA,EAC9B;AAEA,WAAS,SAAS;AAElB,MAAI,KAAK,WAAW;AAChB,YAAQ,KAAK,CAAC;AAAA,EAClB;AACJ;",
+  "names": ["TestType", "yargs"]
+}

package/dist/cjs/testing/failure-detail.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface FailureDetail {
+    message: string;
+    stack?: string;
+    diff?: string;
+    logs?: string;
+    cause?: FailureDetail;
+    errors?: FailureDetail[];
+}
+export declare function FailureDetail(error: any, logs?: string[]): FailureDetail;
+export declare namespace FailureDetail {
+    function dump(failure: FailureDetail, prefix?: string): void;
+    let diff: undefined | ((actual: string, expected: string) => string);
+}
+//# sourceMappingURL=failure-detail.d.ts.map

package/dist/cjs/testing/failure-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-detail.d.ts","sourceRoot":"","sources":["../../../src/testing/failure-detail.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,iBAgCxD;AAED,yBAAiB,aAAa,CAAC;IAC3B,SAAgB,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,MAAW,QA2B/D;IAEM,IAAI,IAAI,EAAE,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAC/E"}