tape-six 1.7.0 → 1.7.1

package/README.md

@@ -99,11 +99,29 @@ And:
 
 <img width="240" height="329" alt="image" src="https://github.com/user-attachments/assets/f3d8ac65-9e6a-499d-837f-0271146da1de" />
 
+## Project structure
+
+```
+tape-six/
+├── index.js          # Main entry point, exports test, hooks, aliases
+├── index.d.ts        # TypeScript definitions for the public API
+├── package.json      # Package config; "tape6" section configures test discovery
+├── bin/              # CLI utilities: tape6, tape6-server, tape6-node, tape6-bun, tape6-deno, tape6-seq
+├── src/              # Source code (test engine, reporters, runners, utilities)
+├── web-app/          # Browser test UI application
+├── tests/            # Test files
+├── ts-tests/         # TypeScript test files
+├── wiki/             # GitHub wiki documentation (submodule)
+└── vendors/          # Git submodules (deep6)
+```
+
 ## Docs
 
 The documentation can be found in the [wiki](https://github.com/uhop/tape-six/wiki).
 See how it can be used in [tests/](https://github.com/uhop/tape-six/tree/master/tests).
 
+For AI assistants: see [llms.txt](https://github.com/uhop/tape-six/blob/master/llms.txt) and [llms-full.txt](https://github.com/uhop/tape-six/blob/master/llms-full.txt) for LLM-optimized documentation.
+
 The whole API is based on two objects: `test` and `Tester`.
 
 ### `test`
@@ -247,6 +265,8 @@ The following methods are available (all `msg` arguments are optional):
     - `notStrictEquals()` &mdash; an alias of `notStrictEqual()`.
     - `doesNotEqual()` &mdash; an alias of `notStrictEqual()`.
     - `isUnequal()` &mdash; an alias of `notStrictEqual()`.
+    - `isNotEqual()` &mdash; an alias of `notStrictEqual()`.
+    - `isNot()` &mdash; an alias of `notStrictEqual()`.
   - `looseEqual(a, b, msg)` &mdash; asserts that `a` and `b` are loosely equal.
     - Loose equality is defined as `a == b`.
     - `looseEquals()` &mdash; an alias of `looseEqual()`.
@@ -290,6 +310,7 @@ The following methods are available (all `msg` arguments are optional):
 - Miscellaneous:
   - `any` &mdash; returns the `any` object. It can be used in deep equivalency asserts to match any value.
     See [deep6's any](https://github.com/uhop/deep6/wiki/any) for details.
+    - `_` &mdash; an alias of `any`.
   - `plan(n)` &mdash; sets the number of tests in the test suite. Rarely used.
   - `comment(msg)` &mdash; sends a comment to the test harness. Rarely used.
   - `skipTest(...args, msg)` &mdash; skips the current test yet sends a message to the test harness.
@@ -390,6 +411,7 @@ Test output can be controlled by flags. See [Supported flags](https://github.com
 
 The most recent releases:
 
+- 1.7.1 _Added AI support, added timeout to start test runners, fixed some bugs in the sequential test runner._
 - 1.7.0 _New features: after/before hooks for tests, aliases for `suite()`, `describe()`, `it()`, `tape6-seq` &mdash; an in-process sequential test runner. Improvements: stricter monochrome detection, refactoring, bugfixes, updated dev dependencies and the documentation._
 - 1.6.0 _New features: support for `AssertionError` and 3rd-party assertion libraries based on it like `node:assert` and `chai`, support for `console.assert()`, support for `signal` to cancel asynchronous operations, tests wait for embedded tests, improved reporting of errors, updated dev dependencies._
 - 1.5.1 _Better support for stopping parallel tests, better support for "failed to load" errors._

package/bin/tape6-bun.js

@@ -2,7 +2,12 @@
 
 import {fileURLToPath} from 'node:url';
 
-import {resolveTests, resolvePatterns, getReporterType} from '../src/utils/config.js';
+import {
+  resolveTests,
+  resolvePatterns,
+  getReporterFileName,
+  getReporterType
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -85,17 +90,11 @@ const config = () => {
   if (!parallel) parallel = globalThis.navigator?.hardwareConcurrency || 1;
 };
 
-const reporters = {
-  jsonl: 'JSONLReporter.js',
-  tap: 'TapReporter.js',
-  tty: 'TTYReporter.js'
-};
-
 const init = async () => {
   const currentReporter = getReporter();
   if (!currentReporter) {
     const reporterType = getReporterType(),
-      reporterFile = reporters[reporterType] || reporters.tty,
+      reporterFile = getReporterFileName(reporterType),
       CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
       hasColors = !(
         options.monochrome ||

package/bin/tape6-deno.js

@@ -2,7 +2,12 @@
 
 import {fileURLToPath} from 'node:url';
 
-import {resolveTests, resolvePatterns, getReporterType} from '../src/utils/config.js';
+import {
+  resolveTests,
+  resolvePatterns,
+  getReporterFileName,
+  getReporterType
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -85,17 +90,11 @@ const config = () => {
   if (!parallel) parallel = globalThis.navigator?.hardwareConcurrency || 1;
 };
 
-const reporters = {
-  jsonl: 'JSONLReporter.js',
-  tap: 'TapReporter.js',
-  tty: 'TTYReporter.js'
-};
-
 const init = async () => {
   const currentReporter = getReporter();
   if (!currentReporter) {
     const reporterType = getReporterType(),
-      reporterFile = reporters[reporterType] || reporters.tty,
+      reporterFile = getReporterFileName(reporterType),
       CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
       hasColors = !(
         options.monochrome ||

package/bin/tape6-node.js

@@ -3,7 +3,12 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {resolveTests, resolvePatterns, getReporterType} from '../src/utils/config.js';
+import {
+  resolveTests,
+  resolvePatterns,
+  getReporterFileName,
+  getReporterType
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -86,17 +91,11 @@ const config = () => {
   if (!parallel) parallel = globalThis.navigator?.hardwareConcurrency || 1;
 };
 
-const reporters = {
-  jsonl: 'JSONLReporter.js',
-  tap: 'TapReporter.js',
-  tty: 'TTYReporter.js'
-};
-
 const init = async () => {
   const currentReporter = getReporter();
   if (!currentReporter) {
     const reporterType = getReporterType(),
-      reporterFile = reporters[reporterType] || reporters.tty,
+      reporterFile = getReporterFileName(reporterType),
       CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
       hasColors = !(
         options.monochrome ||
@@ -125,6 +124,11 @@ const main = async () => {
     console.error('UNHANDLED ERROR:', origin, error)
   );
 
+  if (!files.length) {
+    console.log('No files found.');
+    process.exit(1);
+  }
+
   const reporter = getReporter(),
     worker = new TestWorker(reporter, parallel, options);
 

package/bin/tape6-seq.js

@@ -3,7 +3,12 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {resolveTests, resolvePatterns, getReporterType} from '../src/utils/config.js';
+import {
+  resolveTests,
+  resolvePatterns,
+  getReporterFileName,
+  getReporterType
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter, setConfiguredFlag, testRunner} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -68,17 +73,11 @@ const config = () => {
   options.flags = flags;
 };
 
-const reporters = {
-  jsonl: 'JSONLReporter.js',
-  tap: 'TapReporter.js',
-  tty: 'TTYReporter.js'
-};
-
 const init = async () => {
   const currentReporter = getReporter();
   if (!currentReporter) {
     const reporterType = getReporterType(),
-      reporterFile = reporters[reporterType] || reporters.tty,
+      reporterFile = getReporterFileName(reporterType),
       CustomReporter = (await import('../src/reporters/' + reporterFile)).default,
       hasColors = !(
         options.monochrome ||

package/index.d.ts

@@ -629,7 +629,7 @@ export declare interface Tester {
   is(a: unknown, b: unknown, message?: string): void;
 
   /**
-   * Asserts that `actual` is deeply equal to `expected`. Alias of `strictEqual`.
+   * Asserts that `actual` is strictly equal to `expected`. Alias of `strictEqual`.
    * @param actual - The actual value
    * @param expected - The expected value
    * @param message - Optional message to display if the assertion fails

package/index.js

@@ -110,6 +110,9 @@ const init = async () => {
       if (Deno.env.get('TAPE6_JSONL')) {
         const {JSONLReporter} = await import('./src/reporters/JSONLReporter.js');
         reporter = new JSONLReporter({...options, originalConsole, hasColors});
+      } else if (Deno.env.get('TAPE6_MIN')) {
+        const {MinReporter} = await import('./src/reporters/MinReporter.js');
+        reporter = new MinReporter({...options, originalConsole});
       } else if (!Deno.env.get('TAPE6_TAP')) {
         const {TTYReporter} = await import('./src/reporters/TTYReporter.js');
         reporter = new TTYReporter({...options, originalConsole, hasColors});
@@ -124,6 +127,9 @@ const init = async () => {
       if (Bun.env.TAPE6_JSONL) {
         const {JSONLReporter} = await import('./src/reporters/JSONLReporter.js');
         reporter = new JSONLReporter({...options, originalConsole, hasColors});
+      } else if (Bun.env.TAPE6_MIN) {
+        const {MinReporter} = await import('./src/reporters/MinReporter.js');
+        reporter = new MinReporter({...options, originalConsole});
       } else if (!Bun.env.TAPE6_TAP) {
         const {TTYReporter} = await import('./src/reporters/TTYReporter.js');
         reporter = new TTYReporter({...options, originalConsole, hasColors});
@@ -138,6 +144,9 @@ const init = async () => {
       if (process.env.TAPE6_JSONL) {
         const {JSONLReporter} = await import('./src/reporters/JSONLReporter.js');
         reporter = new JSONLReporter({...options, originalConsole, hasColors});
+      } else if (process.env.TAPE6_MIN) {
+        const {MinReporter} = await import('./src/reporters/MinReporter.js');
+        reporter = new MinReporter({...options, originalConsole});
       } else if (!process.env.TAPE6_TAP) {
         const {TTYReporter} = await import('./src/reporters/TTYReporter.js');
         reporter = new TTYReporter({...options, originalConsole, hasColors});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tape-six",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "The test harness for the modern JavaScript and TypeScript.",
   "type": "module",
   "main": "index.js",
@@ -13,6 +13,7 @@
   },
   "bin": {
     "tape6": "bin/tape6.js",
+    "tape6-node": "bin/tape6-node.js",
     "tape6-bun": "bin/tape6-bun.js",
     "tape6-deno": "bin/tape6-deno.js",
     "tape6-seq": "bin/tape6-seq.js",
@@ -30,8 +31,8 @@
     "test:bun": "bun run ./bin/tape6-bun.js --flags FO",
     "test:deno": "deno run -A ./bin/tape6-deno.js --flags FO",
     "test:seq": "node ./bin/tape6-seq.js --flags FO",
-    "test:bun:seq": "bun run ./bin/tape6-seq.js --flags FO",
-    "test:deno:seq": "deno run -A ./bin/tape6-seq.js --flags FO",
+    "test:seq:bun": "bun run ./bin/tape6-seq.js --flags FO",
+    "test:seq:deno": "deno run -A ./bin/tape6-seq.js --flags FO",
     "test:puppeteer": "node tests/puppeteer-chrome.js",
     "test:playwright": "node tests/playwright-chrome.js",
     "ts-check": "tsc --noEmit",
@@ -49,7 +50,18 @@
     "test",
     "harness",
     "assert",
-    "browser"
+    "browser",
+    "unit-test",
+    "testing",
+    "test-runner",
+    "esm",
+    "es-modules",
+    "typescript",
+    "deno",
+    "bun",
+    "nodejs",
+    "tap-protocol",
+    "cross-runtime"
   ],
   "author": "Eugene Lazutkin <eugene.lazutkin@gmail.com> (https://www.lazutkin.com/)",
   "funding": "https://github.com/sponsors/uhop",
@@ -58,6 +70,8 @@
     "url": "https://github.com/uhop/tape-six/issues"
   },
   "homepage": "https://github.com/uhop/tape-six#readme",
+  "llms": "https://raw.githubusercontent.com/uhop/tape-six/master/llms.txt",
+  "llmsFull": "https://raw.githubusercontent.com/uhop/tape-six/master/llms-full.txt",
   "files": [
     "index.*",
     "bin",
@@ -85,10 +99,10 @@
   },
   "devDependencies": {
     "@types/chai": "^5.2.3",
-    "@types/node": "^25.2.1",
+    "@types/node": "^25.3.0",
     "chai": "^6.2.2",
     "playwright": "^1.58.2",
-    "puppeteer": "^24.37.2",
+    "puppeteer": "^24.37.5",
     "typescript": "^5.9.3"
   }
 }

package/src/reporters/MinReporter.js

@@ -0,0 +1,37 @@
+import Reporter from './Reporter.js';
+
+const getEnvVar = name => {
+  if (typeof Deno == 'object' && Deno?.version) {
+    return Deno.env.get(name);
+  } else if (typeof Bun == 'object' && Bun?.version) {
+    return Bun.env[name];
+  } else if (typeof process == 'object' && process?.versions?.node) {
+    return process.env[name];
+  }
+  return undefined;
+};
+
+export class MinReporter extends Reporter {
+  constructor({failOnce = false, originalConsole} = {}) {
+    super({failOnce});
+    this.console = originalConsole || console;
+  }
+  report(event) {
+    event = this.state?.preprocess(event) || event;
+    const handler = Reporter.EVENT_MAP[event.type];
+    typeof handler == 'string' && this[handler]?.(event);
+    this.console.log(
+      'Test:',
+      event.test,
+      'Type:',
+      event.type,
+      'Name:',
+      event.name,
+      'Fail:',
+      event.fail
+    );
+    this.state?.postprocess(event);
+  }
+}
+
+export default MinReporter;

package/src/reporters/TTYReporter.js

@@ -58,7 +58,7 @@ export class TTYReporter extends Reporter {
     this.hasColors =
       hasColors &&
       this.output.isTTY &&
-      (typeof this.output.hasColors == 'function' ? this.output.hasColors(256) : true);
+      (typeof this.output.hasColors == 'function' ? this.output.hasColors(16) : true);
     this.renumberAsserts = renumberAsserts;
     this.failureOnly = failureOnly;
     this.showBanner = showBanner;
@@ -221,7 +221,7 @@ export class TTYReporter extends Reporter {
               paint = method === 'error' || method === 'assert' ? 'stderrPaint' : 'stdoutPaint',
               prefix = this[paint](consoleDict[method] + ':') + ' ';
             for (const line of lines) {
-              this.out(prefix + line);
+              this.out(prefix + line, this.failureOnly);
             }
           }
         }
@@ -231,7 +231,7 @@ export class TTYReporter extends Reporter {
           const lines = event.name.split(/\r?\n/),
             prefix = this.stdoutPaint('stdout:') + ' ';
           for (const line of lines) {
-            this.out(prefix + line);
+            this.out(prefix + line, this.failureOnly);
           }
         }
         break;
@@ -240,7 +240,7 @@ export class TTYReporter extends Reporter {
           const lines = event.name.split(/\r?\n/),
             prefix = this.stderrPaint('stderr:') + ' ';
           for (const line of lines) {
-            this.out(prefix + line);
+            this.out(prefix + line, this.failureOnly);
           }
         }
         break;

package/src/runners/bun/worker.js

@@ -1,8 +1,36 @@
-const reportToParent = fileName => msg => {
-  if ((msg.type === 'test' || msg.type === 'end') && !msg.test && !msg.name) {
-    msg.name = 'FILE: /' + fileName;
-  }
-  postMessage(msg);
+const DEFAULT_START_TIMEOUT = 5_000;
+
+const getTimeout = () => {
+  const timeoutValue = Bun.env.TAPE6_WORKER_START_TIMEOUT;
+  if (!timeoutValue) return DEFAULT_START_TIMEOUT;
+  let timeout = Number(timeoutValue);
+  if (isNaN(timeout) || timeout <= 0 || timeout === Infinity) timeout = DEFAULT_START_TIMEOUT;
+  return timeout;
+};
+
+const reportToParent = fileName => {
+  const timeout = getTimeout();
+  let timeoutBeforeStartId = setTimeout(() => {
+    postMessage({type: 'test', test: 0, name: 'FILE: /' + fileName});
+    postMessage({
+      name: `No tests found in ${timeout}ms`,
+      test: 0,
+      marker: new Error(),
+      operator: 'error',
+      fail: true
+    });
+    postMessage({type: 'end', test: 0, name: 'FILE: /' + fileName, fail: true});
+  }, timeout);
+  return msg => {
+    if (timeoutBeforeStartId) {
+      clearTimeout(timeoutBeforeStartId);
+      timeoutBeforeStartId = null;
+    }
+    if ((msg.type === 'test' || msg.type === 'end') && !msg.test && !msg.name) {
+      msg.name = 'FILE: /' + fileName;
+    }
+    postMessage(msg);
+  };
 };
 
 addEventListener('message', async event => {

package/src/runners/deno/worker.js

@@ -1,8 +1,36 @@
-const reportToParent = fileName => msg => {
-  if ((msg.type === 'test' || msg.type === 'end') && !msg.test && !msg.name) {
-    msg.name = 'FILE: /' + fileName;
-  }
-  postMessage(msg);
+const DEFAULT_START_TIMEOUT = 5_000;
+
+const getTimeout = () => {
+  const timeoutValue = Deno.env.get('TAPE6_WORKER_START TIMEOUT');
+  if (!timeoutValue) return DEFAULT_START_TIMEOUT;
+  let timeout = Number(timeoutValue);
+  if (isNaN(timeout) || timeout <= 0 || timeout === Infinity) timeout = DEFAULT_START_TIMEOUT;
+  return timeout;
+};
+
+const reportToParent = fileName => {
+  const timeout = getTimeout();
+  let timeoutBeforeStartId = setTimeout(() => {
+    postMessage({type: 'test', test: 0, name: 'FILE: /' + fileName});
+    postMessage({
+      name: `No tests found in ${timeout}ms`,
+      test: 0,
+      marker: new Error(),
+      operator: 'error',
+      fail: true
+    });
+    postMessage({type: 'end', test: 0, name: 'FILE: /' + fileName, fail: true});
+  }, timeout);
+  return msg => {
+    if (timeoutBeforeStartId) {
+      clearTimeout(timeoutBeforeStartId);
+      timeoutBeforeStartId = null;
+    }
+    if ((msg.type === 'test' || msg.type === 'end') && !msg.test && !msg.name) {
+      msg.name = 'FILE: /' + fileName;
+    }
+    postMessage(msg);
+  };
 };
 
 addEventListener('message', async event => {

package/src/runners/node/worker.js

@@ -1,10 +1,39 @@
+import process from 'node:process';
 import {parentPort} from 'node:worker_threads';
 
-const reportToParent = fileName => msg => {
-  if ((msg.type === 'test' || msg.type === 'end') && !msg.test && !msg.name) {
-    msg.name = 'FILE: /' + fileName;
-  }
-  parentPort.postMessage(msg);
+const DEFAULT_START_TIMEOUT = 5_000;
+
+const getTimeout = () => {
+  const timeoutValue = process.env.TAPE6_WORKER_START_TIMEOUT;
+  if (!timeoutValue) return DEFAULT_START_TIMEOUT;
+  let timeout = Number(timeoutValue);
+  if (isNaN(timeout) || timeout <= 0 || timeout === Infinity) timeout = DEFAULT_START_TIMEOUT;
+  return timeout;
+};
+
+const reportToParent = fileName => {
+  const timeout = getTimeout();
+  let timeoutBeforeStartId = setTimeout(() => {
+    parentPort.postMessage({type: 'test', test: 0, name: 'FILE: /' + fileName});
+    parentPort.postMessage({
+      name: `No tests found in ${timeout}ms`,
+      test: 0,
+      marker: new Error(),
+      operator: 'error',
+      fail: true
+    });
+    parentPort.postMessage({type: 'end', test: 0, name: 'FILE: /' + fileName, fail: true});
+  }, timeout);
+  return msg => {
+    if (timeoutBeforeStartId) {
+      clearTimeout(timeoutBeforeStartId);
+      timeoutBeforeStartId = null;
+    }
+    if ((msg.type === 'test' || msg.type === 'end') && !msg.test && !msg.name) {
+      msg.name = 'FILE: /' + fileName;
+    }
+    parentPort.postMessage(msg);
+  };
 };
 
 parentPort.on('message', async msg => {

package/src/runners/seq/TestWorker.js

@@ -4,6 +4,7 @@ import {pathToFileURL} from 'node:url';
 
 import {isStopTest} from '../../State.js';
 import EventServer from '../../utils/EventServer.js';
+import {getTimeoutValue} from '../../utils/config.js';
 import {getOriginalConsole, setCurrentReporter} from '../../utils/capture-console.js';
 import {
   clearBeforeAll,
@@ -11,7 +12,8 @@ import {
   clearBeforeEach,
   clearAfterEach,
   setReporter,
-  registerNotifyCallback
+  registerNotifyCallback,
+  unregisterNotifyCallback
 } from '../../test.js';
 import BypassReporter from './BypassReporter.js';
 
@@ -23,10 +25,16 @@ export default class TestWorker extends EventServer {
     this.testRunner = options.testRunner;
     this.counter = 0;
     this.originalConsole = getOriginalConsole() || globalThis.console;
+    this.timeout = getTimeoutValue();
+    this.timeoutId = null;
   }
   makeTask(fileName) {
     const id = String(++this.counter),
       reporter = new BypassReporter(this.reporter, event => {
+        if (this.timeoutId) {
+          clearTimeout(this.timeoutId);
+          this.timeoutId = null;
+        }
         try {
           this.report(id, event);
         } catch (error) {
@@ -39,33 +47,22 @@ export default class TestWorker extends EventServer {
     setReporter(reporter);
     setCurrentReporter(this.reporter);
     process.env.TAPE6_TEST_FILE_NAME = fileName;
-    import(new URL(fileName, baseName))
+    const url = new URL(fileName, baseName);
+    import(url)
       .then(async () => {
         const testRunner = await this.testRunner;
         registerNotifyCallback(testRunner);
-      })
-      .catch(error => {
-        this.report(id, {
-          type: 'comment',
-          name: 'fail to load: ' + (error.message || 'Worker error'),
-          test: 0
-        });
-        try {
-          this.report(id, {
-            name: String(error),
-            test: 0,
-            marker: new Error(),
-            operator: 'error',
-            fail: true,
-            data: {
-              actual: error
-            }
-          });
-        } catch (error) {
-          if (!isStopTest(error)) throw error;
+        if (this.timeoutId) {
+          clearTimeout(this.timeoutId);
+          this.timeoutId = null;
         }
-        this.close(id);
-      });
+        this.timeoutId = setTimeout(() => {
+          this.timeoutId = null;
+          unregisterNotifyCallback(testRunner);
+          this.#reportTimeout(id, fileName);
+        }, this.timeout);
+      })
+      .catch(error => this.#reportError(id, error));
     return id;
   }
   destroyTask() {
@@ -76,4 +73,51 @@ export default class TestWorker extends EventServer {
     clearBeforeEach();
     clearAfterEach();
   }
+  #reportError(id, error) {
+    this.report(id, {
+      type: 'comment',
+      name: 'fail to load: ' + (error.message || 'Worker error'),
+      test: 0
+    });
+    try {
+      this.report(id, {
+        name: String(error),
+        test: 0,
+        marker: new Error(),
+        operator: 'error',
+        fail: true,
+        data: {
+          actual: error
+        }
+      });
+    } catch (error) {
+      if (!isStopTest(error)) throw error;
+    }
+    this.close(id);
+  }
+  #reportTimeout(id, fileName) {
+    this.report(id, {
+      type: 'test',
+      test: 0,
+      name: 'FILE: /' + fileName
+    });
+    try {
+      this.report(id, {
+        name: `No tests found in ${this.timeout}ms`,
+        test: 0,
+        marker: new Error(),
+        operator: 'error',
+        fail: true
+      });
+    } catch (error) {
+      if (!isStopTest(error)) throw error;
+    }
+    this.report(id, {
+      type: 'end',
+      test: 0,
+      name: 'FILE: /' + fileName,
+      fail: true
+    });
+    this.close(id);
+  }
 }

package/src/test.js

@@ -12,7 +12,7 @@ let tests = [],
   reporter = null,
   testCounter = 0,
   isConfigured = false,
-  notifyCallback = [];
+  notifyCallback = new Set();
 
 export const getConfiguredFlag = () => isConfigured;
 export const setConfiguredFlag = value => (isConfigured = !!value);
@@ -26,10 +26,12 @@ export const registerNotifyCallback = callback => {
   if (tests.length) {
     defer(callback);
   } else {
-    notifyCallback.push(callback);
+    notifyCallback.add(callback);
   }
 };
 
+export const unregisterNotifyCallback = callback => notifyCallback.delete(callback);
+
 const testers = [];
 
 export const getTesters = () => testers;
@@ -86,9 +88,9 @@ export const test = async (name, options, testFn) => {
     isTimerSet = true;
   }
   const deferred = makeDeferred();
-  if (tests.push({options, deferred}) === 1 && notifyCallback.length) {
+  if (tests.push({options, deferred}) === 1 && notifyCallback.size) {
     for (const callback of notifyCallback) defer(callback);
-    notifyCallback = [];
+    notifyCallback = new Set();
   }
 
   return deferred.promise;

package/src/utils/config.js

@@ -2,18 +2,32 @@ import {promises as fsp} from 'node:fs';
 import path from 'node:path';
 
 import {listing, wildToRe} from './listing.js';
-import {union, exclude} from './fileSets.js';
+
+const exclude = (files, pattern) => {
+  const excluded = new Set();
+  for (const file of files) {
+    if (pattern.test(file)) excluded.add(file);
+  }
+  return files.difference(excluded);
+};
 
 export const resolvePatterns = async (rootFolder, patterns) => {
-  let result = [];
+  let result = new Set();
   for (const item of patterns) {
     if (item.length && item[0] == '!') {
       result = exclude(result, wildToRe(rootFolder, item.substring(1)));
     } else {
-      result = union(result, await listing(rootFolder, item));
+      for await (const file of listing(rootFolder, item)) {
+        result.add(file);
+      }
     }
   }
-  return result.map(fileName => path.relative(rootFolder, fileName));
+
+  const files = [];
+  for (const file of result) {
+    files.push(path.relative(rootFolder, file));
+  }
+  return files;
 };
 
 export const getConfig = async (rootFolder, traceFn) => {
@@ -88,9 +102,33 @@ if (typeof Deno == 'object' && Deno?.version) {
   runtime.name = 'browser';
 }
 
+export const reporterFileNames = {
+  jsonl: 'JSONLReporter.js',
+  min: 'MinReporter.js',
+  tap: 'TapReporter.js',
+  tty: 'TTYReporter.js'
+};
+
 export const getReporterType = () => {
   if (runtime.name === 'browser') return null;
   if (runtime.getEnvVar('TAPE6_JSONL')) return 'jsonl';
+  if (runtime.getEnvVar('TAPE6_MIN')) return 'min';
   if (runtime.getEnvVar('TAPE6_TAP')) return 'tap';
   return 'tty';
 };
+
+export const getReporterFileName = type => {
+  const reporterType = type || getReporterType();
+  return reporterFileNames[reporterType] || reporterFileNames.tty;
+};
+
+export const DEFAULT_START_TIMEOUT = 5_000;
+
+export const getTimeoutValue = () => {
+  if (runtime.name === 'browser') return DEFAULT_START_TIMEOUT;
+  const timeoutValue = runtime.getEnvVar('TAPE6_WORKER_START_TIMEOUT');
+  if (!timeoutValue) return DEFAULT_START_TIMEOUT;
+  let timeout = Number(timeoutValue);
+  if (isNaN(timeout) || timeout <= 0 || timeout === Infinity) timeout = DEFAULT_START_TIMEOUT;
+  return timeout;
+};

package/src/utils/listing.js

@@ -17,44 +17,36 @@ const mergeWildcards = folders =>
     []
   );
 
-const listFiles = async (rootFolder, folders, baseRe, parents) => {
+const listFiles = async function* (rootFolder, folders, baseRe, parents) {
   const dir = path.join(rootFolder, parents.join(path.sep)),
     files = await fsp.readdir(dir, {withFileTypes: true});
 
-  let result = [];
-
   if (!folders.length) {
     for (const file of files) {
-      if (file.isFile() && baseRe.test(file.name)) result.push(path.join(dir, file.name));
+      if (file.isFile() && baseRe.test(file.name)) yield path.join(dir, file.name);
     }
-    return result;
+    return;
   }
 
   const theRest = folders.slice(1);
 
   if (folders[0]) {
     for (const file of files) {
-      if (file.isDirectory() && folders[0].test(file.name)) {
-        result = result.concat(
-          await listFiles(rootFolder, theRest, baseRe, parents.concat(file.name))
-        );
-      }
+      if (file.isDirectory() && folders[0].test(file.name))
+        yield* listFiles(rootFolder, theRest, baseRe, parents.concat(file.name));
     }
-    return result;
+    return;
   }
 
-  result = result.concat(await listFiles(rootFolder, theRest, baseRe, parents));
+  yield* listFiles(rootFolder, theRest, baseRe, parents);
   for (const file of files) {
-    if (file.isDirectory()) {
-      result = result.concat(
-        await listFiles(rootFolder, folders, baseRe, parents.concat(file.name))
-      );
-    }
+    if (file.isDirectory())
+      yield* listFiles(rootFolder, folders, baseRe, parents.concat(file.name));
   }
-  return result;
+  return;
 };
 
-export const listing = async (rootFolder, wildcard) => {
+export const listing = async function* (rootFolder, wildcard) {
   const parsed = path.parse(path.normalize(wildcard)),
     baseRe = new RegExp('^' + prepRe(parsed.name, '.*') + prepRe(parsed.ext, '.*', true) + '$'),
     folders = mergeWildcards(
@@ -63,7 +55,7 @@ export const listing = async (rootFolder, wildcard) => {
         .filter(part => part)
         .map(part => (part === '**' ? null : new RegExp('^' + prepRe(part, notSep) + '$')))
     );
-  return listFiles(rootFolder, folders, baseRe, []);
+  yield* listFiles(rootFolder, folders, baseRe, []);
 };
 
 export const wildToRe = (rootFolder, wildcard) => {

package/src/utils/fileSets.js

@@ -1,114 +0,0 @@
-// file sets are represented as sorted name lists with no duplicated items
-
-export const normalize = fileSet =>
-  fileSet.sort().filter((name, i, list) => !i || list[i - 1] !== name);
-
-export const union = (a, b) => {
-  if (!a.length) return b.slice(0);
-  if (!b.length) return a.slice(0);
-
-  let i = 0,
-    j = 0,
-    x = a[0],
-    y = b[0];
-
-  const result = [];
-  for (;;) {
-    if (x < y) {
-      result.push(x);
-      ++i;
-      if (i >= a.length) break;
-      x = a[i];
-    } else if (x > y) {
-      result.push(y);
-      ++j;
-      if (j >= b.length) break;
-      y = b[j];
-    } else {
-      result.push(x);
-      ++i;
-      ++j;
-      if (i >= a.length || j >= b.length) break;
-      x = a[i];
-      y = b[j];
-    }
-  }
-
-  if (i < a.length) {
-    result.push(...a.slice(i));
-  } else if (j < b.length) {
-    result.push(...b.slice(j));
-  }
-
-  return result;
-};
-
-export const intersection = (a, b) => {
-  if (!a.length || !b.length) return [];
-
-  let i = 0,
-    j = 0,
-    x = a[0],
-    y = b[0];
-
-  const result = [];
-  for (;;) {
-    if (x < y) {
-      ++i;
-      if (i >= a.length) break;
-      x = a[i];
-    } else if (x > y) {
-      ++j;
-      if (j >= b.length) break;
-      y = b[j];
-    } else {
-      result.push(x);
-      ++i;
-      ++j;
-      if (i >= a.length || j >= b.length) break;
-      x = a[i];
-      y = b[j];
-    }
-  }
-
-  return result;
-};
-
-export const difference = (a, b) => {
-  if (!a.length) return [];
-  if (!b.length) return a.slice(0);
-
-  let i = 0,
-    j = 0,
-    x = a[0],
-    y = b[0];
-
-  const result = [];
-  for (;;) {
-    if (x < y) {
-      result.push(x);
-      ++i;
-      if (i >= a.length) break;
-      x = a[i];
-    } else if (x > y) {
-      ++j;
-      if (j >= b.length) break;
-      y = b[j];
-    } else {
-      ++i;
-      ++j;
-      if (i >= a.length || j >= b.length) break;
-      x = a[i];
-      y = b[j];
-    }
-  }
-
-  if (i < a.length) {
-    result.push(...a.slice(i));
-  }
-
-  return result;
-};
-
-export const filter = (a, re) => a.filter(item => re.test(item));
-export const exclude = (a, re) => a.filter(item => !re.test(item));