tape-six 1.7.11 → 1.7.12

package/README.md

@@ -37,7 +37,7 @@ with existing unit test libraries:
 - The [DX](https://en.wikipedia.org/wiki/User_experience#Developer_experience) in browsers are usually abysmal.
   - Both console-based debugging and a UI to navigate results are properly supported.
   - Integration with browser automation tools is supported for automated testing.
-    - Examples for [Playwright](https://playwright.dev/) and [Puppeteer](https://pptr.dev/) are provided.
+    - Automated testing with [Puppeteer](https://pptr.dev/) and [Playwright](https://playwright.dev/) via dedicated packages (see [Related packages](#related-packages)).
 
 ## How it looks
 
@@ -415,10 +415,17 @@ See [set-up tests](https://github.com/uhop/tape-six/wiki/Set-up-tests) for detai
 
 Test output can be controlled by flags. See [Supported flags](https://github.com/uhop/tape-six/wiki/Supported-flags) for details.
 
+### Related packages
+
+- [tape-six-proc](https://www.npmjs.com/package/tape-six-proc) — runs test files in separate processes instead of worker threads.
+- [tape-six-puppeteer](https://www.npmjs.com/package/tape-six-puppeteer) — automates browser testing with Puppeteer.
+- [tape-six-playwright](https://www.npmjs.com/package/tape-six-playwright) — automates browser testing with Playwright.
+
 ## Release notes
 
 The most recent releases:
 
+- 1.7.12 _Added `--help`/`-h` and `--version`/`-v` options to all CLI utilities. Added flag documentation to help output._
 - 1.7.11 _Documentation consistency: added missing sequential test commands to AI docs, fixed test glob references._
 - 1.7.10 _Switched from workflows to Agent Skills (agentskills.io) for consumer integration. Improved CJS import docs._
 - 1.7.9 _Merged test directories, fixed `.d.ts` typings, added `ts-check` to CI._

package/TESTING.md

@@ -552,10 +552,11 @@ Example with environment-specific tests:
 ```json
 {
   "tape6": {
+    "tests": ["/tests/test-*.*js"],
+    "cli": ["/tests/test-*.cjs"],
     "node": ["/tests/node/test-*.js"],
     "deno": ["/tests/deno/test-*.js"],
-    "browser": ["/tests/web/test-*.html"],
-    "tests": ["/tests/test-*.*js"],
+    "browser": ["/tests/browser/test-*.html"],
     "importmap": {
       "imports": {
         "tape-six": "/node_modules/tape-six/index.js",
@@ -566,7 +567,7 @@ Example with environment-specific tests:
 }
 ```
 
-In this example, running `tape6` on Node will execute tests matching `/tests/node/test-*.js` + `/tests/test-*.*js`. Running in a browser will execute `/tests/web/test-*.html` + `/tests/test-*.*js`.
+In this example, running `tape6` on Node will execute tests matching `/tests/node/test-*.js` + `/tests/test-*.cjs` (cli) + `/tests/test-*.*js` (tests). Running in a browser will execute `/tests/browser/test-*.html` + `/tests/test-*.*js` (tests) — `cli` patterns are skipped.
 
 ## Browser testing
 
@@ -580,7 +581,7 @@ Browser tests use `tape6-server`, a static file server bundled with `tape-six` t
 {
   "tape6": {
     "tests": ["/tests/test-*.*js"],
-    "browser": ["/tests/web/test-*.html"],
+    "browser": ["/tests/browser/test-*.html"],
     "importmap": {
       "imports": {
         "tape-six": "/node_modules/tape-six/index.js",
@@ -653,7 +654,7 @@ Create an HTML file that loads test scripts directly with an inline import map:
 </html>
 ```
 
-Navigate to the HTML file directly (e.g., `http://localhost:3000/tests/web/test-simple.html`). Results appear in the browser console. This approach does not use the web UI.
+Navigate to the HTML file directly (e.g., `http://localhost:3000/tests/browser/test-simple.html`). Results appear in the browser console. This approach does not use the web UI.
 
 ### Flags and parallel execution in the browser
 
@@ -665,19 +666,12 @@ http://localhost:3000/?flags=FO&par=3
 
 ### Browser automation
 
-Use Puppeteer or Playwright to run browser tests from the command line:
+For automated headless browser testing, use the dedicated packages:
 
-```js
-import puppeteer from 'puppeteer';
-const browser = await puppeteer.launch({headless: true});
-const page = await browser.newPage();
-page.on('console', msg => console.log(msg.text()));
-await page.exposeFunction('__tape6_reportResults', async text => {
-  await browser.close();
-  process.exit(text === 'success' ? 0 : 1);
-});
-await page.goto('http://localhost:3000/?flags=M');
-```
+- [tape-six-puppeteer](https://www.npmjs.com/package/tape-six-puppeteer) — runs configured browser tests with Puppeteer.
+- [tape-six-playwright](https://www.npmjs.com/package/tape-six-playwright) — runs configured browser tests with Playwright.
+
+Both integrate with `tape6-server` and the `__tape6_reportResults` callback to report pass/fail from the command line.
 
 ### Browser limitations
 
@@ -749,6 +743,8 @@ test('MyClass', async t => {
 
 ### Writing a CommonJS test
 
+Always use `require()` — it is the correct and idiomatic CJS pattern:
+
 ```cjs
 const {test} = require('tape-six');
 const {myFunction} = require('my-package');
@@ -758,7 +754,9 @@ test('myFunction from CJS', t => {
 });
 ```
 
-If the module under test uses top-level `await`, `require()` cannot load it. Use `await import()` inside async tests instead:
+> **IMPORTANT:** Do NOT use `await import()` as a substitute for `require()`. It is only needed when the module under test uses top-level `await` (which is rare). For local project modules, verify first — e.g., grep for `^await` at the top level of the source file. If it has no top-level `await`, use `require()`.
+
+Rare fallback for modules with top-level `await`:
 
 ```cjs
 const {test} = require('tape-six');
@@ -776,6 +774,12 @@ node tests/test-<name>.js    # run your new test file directly
 npm test                      # run full suite to check for regressions
 ```
 
+## Related packages
+
+- [tape-six-proc](https://www.npmjs.com/package/tape-six-proc) — runs test files in separate processes instead of worker threads. Useful when tests need full process isolation.
+- [tape-six-puppeteer](https://www.npmjs.com/package/tape-six-puppeteer) — automates browser testing with Puppeteer. Runs configured browser tests headlessly from the command line.
+- [tape-six-playwright](https://www.npmjs.com/package/tape-six-playwright) — automates browser testing with Playwright. Same as above but using Playwright.
+
 ## Links
 
 - Full API reference: https://github.com/uhop/tape-six/wiki/Tester

package/bin/tape6-bun.js

@@ -2,7 +2,15 @@
 
 import {fileURLToPath} from 'node:url';
 
-import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
+import {
+  getOptions,
+  initFiles,
+  initReporter,
+  showInfo,
+  printVersion,
+  printHelp,
+  printFlagOptions
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -21,10 +29,30 @@ const showSelf = () => {
   process.exit(0);
 };
 
+const showVersion = () => {
+  printVersion('tape6-bun');
+  process.exit(0);
+};
+
+const showHelp = () => {
+  printHelp('tape6-bun', 'Tape6 test runner for Bun', 'tape6-bun [options] [files...]', [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ]);
+  printFlagOptions();
+  process.exit(0);
+};
+
 const main = async () => {
   const currentOptions = getOptions({
-    '--self': showSelf,
-    '--info': {isValueRequired: false}
+    '--self': {fn: showSelf, isValueRequired: false},
+    '--info': {isValueRequired: false},
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
   });
 
   const [files] = await Promise.all([

package/bin/tape6-deno.js

@@ -3,7 +3,15 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
+import {
+  getOptions,
+  initFiles,
+  initReporter,
+  showInfo,
+  printVersion,
+  printHelp,
+  printFlagOptions
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -22,10 +30,30 @@ const showSelf = () => {
   Deno.exit(0);
 };
 
+const showVersion = () => {
+  printVersion('tape6-deno');
+  Deno.exit(0);
+};
+
+const showHelp = () => {
+  printHelp('tape6-deno', 'Tape6 test runner for Deno', 'tape6-deno [options] [files...]', [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ]);
+  printFlagOptions();
+  Deno.exit(0);
+};
+
 const main = async () => {
   const currentOptions = getOptions({
-    '--self': showSelf,
-    '--info': {isValueRequired: false}
+    '--self': {fn: showSelf, isValueRequired: false},
+    '--info': {isValueRequired: false},
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
   });
 
   const [files] = await Promise.all([

package/bin/tape6-node.js

@@ -3,7 +3,15 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
+import {
+  getOptions,
+  initFiles,
+  initReporter,
+  showInfo,
+  printVersion,
+  printHelp,
+  printFlagOptions
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -22,10 +30,30 @@ const showSelf = () => {
   process.exit(0);
 };
 
+const showVersion = () => {
+  printVersion('tape6-node');
+  process.exit(0);
+};
+
+const showHelp = () => {
+  printHelp('tape6-node', 'Tape6 test runner for Node.js', 'tape6-node [options] [files...]', [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ]);
+  printFlagOptions();
+  process.exit(0);
+};
+
 const main = async () => {
   const currentOptions = getOptions({
-    '--self': showSelf,
-    '--info': {isValueRequired: false}
+    '--self': {fn: showSelf, isValueRequired: false},
+    '--info': {isValueRequired: false},
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
   });
 
   const [files] = await Promise.all([

package/bin/tape6-runner.js

@@ -3,6 +3,26 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
+import {printVersion, printHelp} from '../src/utils/config.js';
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  printHelp(
+    'tape6-runner',
+    'Print the path to a tape6 CLI script',
+    'tape6-runner [options] [runtime]',
+    [
+      ['--help, -h', 'Show this help message and exit'],
+      ['--version, -v', 'Show version and exit']
+    ]
+  );
+  console.log('\nRuntimes: node, deno, bun, seq, server, runner, main (default)');
+  process.exit(0);
+}
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  printVersion('tape6-runner');
+  process.exit(0);
+}
+
 const runtimeFiles = {
   node: 'tape6-node.js',
   deno: 'tape6-deno.js',

package/bin/tape6-seq.js

@@ -3,7 +3,15 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {getOptions, initFiles, initReporter, showInfo} from '../src/utils/config.js';
+import {
+  getOptions,
+  initFiles,
+  initReporter,
+  showInfo,
+  printVersion,
+  printHelp,
+  printFlagOptions
+} from '../src/utils/config.js';
 
 import {getReporter, setReporter, setConfiguredFlag, testRunner} from '../src/test.js';
 import {selectTimer} from '../src/utils/timer.js';
@@ -24,10 +32,35 @@ const showSelf = () => {
   process.exit(0);
 };
 
+const showVersion = () => {
+  printVersion('tape6-seq');
+  process.exit(0);
+};
+
+const showHelp = () => {
+  printHelp(
+    'tape6-seq',
+    'Tape6 test runner (sequential, in-process)',
+    'tape6-seq [options] [files...]',
+    [
+      ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+      ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+      ['--info', 'Show configuration info and exit'],
+      ['--self', 'Print the path to this script and exit'],
+      ['--help, -h', 'Show this help message and exit'],
+      ['--version, -v', 'Show version and exit']
+    ]
+  );
+  printFlagOptions();
+  process.exit(0);
+};
+
 const main = async () => {
   const currentOptions = getOptions({
-    '--self': showSelf,
-    '--info': {isValueRequired: false}
+    '--self': {fn: showSelf, isValueRequired: false},
+    '--info': {isValueRequired: false},
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
   });
 
   const [files] = await Promise.all([

package/bin/tape6-server.js

@@ -6,7 +6,13 @@ import path from 'node:path';
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-import {getConfig, resolveTests, resolvePatterns} from '../src/utils/config.js';
+import {
+  getConfig,
+  resolveTests,
+  resolvePatterns,
+  printVersion,
+  printHelp
+} from '../src/utils/config.js';
 
 const fsp = fs.promises;
 
@@ -26,6 +32,24 @@ const showSelf = () => {
   }
   process.exit(0);
 };
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  printHelp('tape6-server', 'Static file server for browser testing', 'tape6-server [options]', [
+    ['--trace', 'Enable request trace logging'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ]);
+  console.log('\nEnvironment:');
+  console.log('  HOST          Server hostname (default: localhost)');
+  console.log('  PORT          Server port (default: 3000)');
+  console.log('  SERVER_ROOT   Root directory for serving files (default: cwd)');
+  console.log('  WEBAPP_PATH   Path to the web app directory');
+  process.exit(0);
+}
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  printVersion('tape6-server');
+  process.exit(0);
+}
 if (process.argv.includes('--self')) showSelf();
 
 // MIME source: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types

package/bin/tape6.js

@@ -3,7 +3,23 @@
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-if (process.argv.includes('--self')) {
+import {printVersion, printHelp, printFlagOptions} from '../src/utils/config.js';
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  printHelp('tape6', 'Tape6 test runner (auto-detects runtime)', 'tape6 [options] [files...]', [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    ['--info', 'Show configuration info and exit'],
+    ['--self', 'Print the path to this script and exit'],
+    ['--help, -h', 'Show this help message and exit'],
+    ['--version, -v', 'Show version and exit']
+  ]);
+  printFlagOptions();
+  process.exit(0);
+} else if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  printVersion('tape6');
+  process.exit(0);
+} else if (process.argv.includes('--self')) {
   const self = new URL(import.meta.url);
   if (self.protocol === 'file:') {
     console.log(fileURLToPath(self));

package/llms-full.txt

@@ -6,7 +6,7 @@
 - Test files are directly executable: `node test.js`, `bun run test.js`, `deno run -A test.js`
 - Parallel test execution via worker threads
 - TAP, TTY (colored), and JSONL output formats
-- Browser testing with built-in web UI and automation support (Puppeteer, Playwright)
+- Browser testing with built-in web UI; headless automation via tape-six-puppeteer / tape-six-playwright
 - Before/after hooks: `beforeAll`, `afterAll`, `beforeEach`, `afterEach`
 - `test()` is aliased as `suite()`, `describe()`, and `it()` for easy migration
 - When called inside a test body, top-level functions auto-delegate to the current tester
@@ -266,7 +266,7 @@ Configuration is read from `tape6.json` or the `"tape6"` section of `package.jso
   "tape6": {
     "tests": ["/tests/test-*.*js"],
     "cli": ["/tests/test-*.cjs"],
-    "browser": ["/tests/web/test-*.html"],
+    "browser": ["/tests/browser/test-*.html"],
     "importmap": {
       "imports": {
         "tape-six": "/node_modules/tape-six/index.js",
@@ -277,7 +277,7 @@ Configuration is read from `tape6.json` or the `"tape6"` section of `package.jso
 }
 ```
 
-Environment-specific subsections: `node`, `deno`, `bun`, `browser`.
+Environment-specific subsections: `cli` (CLI-only: Node, Bun, Deno), `node`, `deno`, `bun`, `browser`.
 
 ## Command-line utilities
 
@@ -286,12 +286,15 @@ Environment-specific subsections: `node`, `deno`, `bun`, `browser`.
 Runs test files in parallel using worker threads.
 
 ```bash
-tape6 [--flags FLAGS] [--par N] [--info] [tests...]
+tape6 [options...] [tests...]
 ```
 
-- `--flags FLAGS` — output control flags (see below).
-- `--par N` — number of parallel workers (default: all CPU cores).
+- `--flags FLAGS`, `-f FLAGS` — output control flags (see below).
+- `--par N`, `-p N` — number of parallel workers (default: all CPU cores).
 - `--info` — print current configuration and exit without running tests.
+- `--self` — print the path to this script and exit.
+- `--help`, `-h` — show help message and exit.
+- `--version`, `-v` — show version and exit.
 - No arguments: runs tests from configuration.
 - Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 
@@ -304,10 +307,17 @@ Sequential in-process runner. Same options as `tape6` but no threads.
 Web server for browser testing:
 
 ```bash
-tape6-server [--trace] [--port N]
+tape6-server [options...]
 ```
 
-Default port: 3000. Navigate to `http://localhost:3000` for the web UI.
+- `--trace` — enable request trace logging.
+- `--self` — print the path to this script and exit.
+- `--help`, `-h` — show help message and exit.
+- `--version`, `-v` — show version and exit.
+
+Configured via environment variables: `HOST` (default: localhost), `PORT` (default: 3000),
+`SERVER_ROOT` (default: cwd), `WEBAPP_PATH`.
+Navigate to `http://localhost:3000` for the web UI.
 
 ### Runtime-specific runners
 
@@ -351,33 +361,15 @@ Browser: `http://localhost:3000/?flags=FO`
 
 1. Start the server: `npm start` (runs `tape6-server --trace`).
 2. Open `http://localhost:3000` for the web UI.
-3. Or automate with Puppeteer/Playwright:
+3. For automated headless testing use dedicated packages:
+   - tape-six-puppeteer (https://www.npmjs.com/package/tape-six-puppeteer)
+   - tape-six-playwright (https://www.npmjs.com/package/tape-six-playwright)
 
-```js
-// Puppeteer example
-import puppeteer from 'puppeteer';
-const browser = await puppeteer.launch({headless: true});
-const page = await browser.newPage();
-page.on('console', msg => console.log(msg.text()));
-await page.exposeFunction('__tape6_reportResults', async text => {
-  await browser.close();
-  process.exit(text === 'success' ? 0 : 1);
-});
-await page.goto('http://localhost:3000/tests/web/test-simple.html?flags=M');
-```
+## Related packages
 
-```js
-// Playwright example
-import {chromium} from 'playwright';
-const browser = await chromium.launch({headless: true});
-const page = await browser.newPage();
-page.on('console', msg => console.log(msg.text()));
-await page.exposeFunction('__tape6_reportResults', async text => {
-  await browser.close();
-  process.exit(text === 'success' ? 0 : 1);
-});
-await page.goto('http://localhost:3000/tests/web/test-simple.html?flags=M');
-```
+- tape-six-proc (https://www.npmjs.com/package/tape-six-proc) — runs test files in separate processes instead of worker threads.
+- tape-six-puppeteer (https://www.npmjs.com/package/tape-six-puppeteer) — automates browser testing with Puppeteer.
+- tape-six-playwright (https://www.npmjs.com/package/tape-six-playwright) — automates browser testing with Playwright.
 
 ## 3rd-party assertion libraries
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tape-six",
-  "version": "1.7.11",
-  "description": "TAP-based unit test library for Node, Deno, Bun, and browsers. ES modules, TypeScript, zero dependencies.",
+  "version": "1.7.12",
+  "description": "TAP-inspired unit test library for Node, Deno, Bun, and browsers. ES modules, TypeScript, zero dependencies.",
   "type": "module",
   "main": "index.js",
   "module": "index.js",
@@ -33,8 +33,6 @@
     "test:seq": "node ./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-test": "node ./bin/tape6.js --flags FO 'tests/test-*.*ts'",
     "ts-test:bun": "bun run ./bin/tape6-bun.js --flags FO 'tests/test-*.*ts'",
     "ts-test:deno": "deno run -A ./bin/tape6-deno.js --flags FO 'tests/test-*.*ts'",
@@ -92,7 +90,7 @@
       "/tests/test-*.cjs"
     ],
     "browser": [
-      "/tests/web/test-*.html"
+      "/tests/browser/test-*.html"
     ],
     "importmap": {
       "imports": {
@@ -104,10 +102,8 @@
   },
   "devDependencies": {
     "@types/chai": "^5.2.3",
-    "@types/node": "^25.3.5",
+    "@types/node": "^25.5.0",
     "chai": "^6.2.2",
-    "playwright": "^1.58.2",
-    "puppeteer": "^24.38.0",
     "typescript": "^5.9.3"
   }
 }

package/skills/write-tests/SKILL.md

@@ -19,15 +19,22 @@ Write or update tests using the tape-six testing library.
 2. Identify the module or feature to test. Read its source code to understand the public API.
 3. Create or update the test file in `tests/test-<name>.js` (or `.ts` for TypeScript, `.cjs` for CommonJS):
    - **ESM** (`.js`): `import test from 'tape-six'` and import the module under test using the project's package name.
-   - **CJS** (`.cjs`): `const {test} = require('tape-six')` and `const {...} = require('my-package')`. If the module under test uses top-level `await`, `require()` cannot load it — use `await import('my-package')` inside async tests instead.
+   - **CJS** (`.cjs`): `const {test} = require('tape-six')` and `const {...} = require('my-package')`. Always use `require()` — it is the correct CJS pattern. **Do NOT use `await import()` unless you have confirmed** (e.g., grep for `^await` at the top level) that the module under test uses top-level `await`, which is rare.
    - Write one top-level `test()` per logical group.
    - Use embedded `await t.test()` for sub-cases.
    - Use `t.beforeEach`/`t.afterEach` for shared setup/teardown.
    - Cover: normal operation, edge cases, error conditions.
    - Use `t.equal` for primitives, `t.deepEqual` for objects/arrays, `t.throws` for errors, `await t.rejects` for async errors.
    - All `msg` arguments are optional but recommended for clarity.
-4. Run the new test file directly to verify: `node tests/test-<name>.js`
-5. Run the full test suite to check for regressions: `npm test`
+4. **Browser-specific tests** — if the project uses browser testing with `tape6-server`. See the "Browser testing" section in `TESTING.md` for full details.
+   - Browsers run `.js` and `.mjs` only — no TypeScript, no CommonJS.
+   - Browsers can also run `.html` shim files (with inline importmap and `<script type="module">`).
+   - Place browser-only files in a subdirectory (e.g., `tests/browser/`) and add patterns to `"browser"` in the `tape6` config.
+   - Run: `npx tape6-server --trace`, then open `http://localhost:3000`.
+5. **Environment-specific tests** — the `tape6` config in `package.json` supports per-environment patterns (`tests`, `cli`, `node`, `bun`, `deno`, `browser`). All are additive. See "Configuring test discovery" in `TESTING.md`.
+6. **Verify (CLI):** run the new test file directly: `node tests/test-<name>.js`
+   - Run the full suite to check for regressions: `npm test`
    - If debugging, use `npm run test:seq` (runs sequentially, easier to trace issues).
    - To see which files are being run, add `--flags fo` (overrides the default `--flags FO`).
-6. Report results and any failures.
+7. **Verify (browser):** start `npx tape6-server --trace`, then open `http://localhost:3000/?q=/tests/test-<name>.js` to run a specific file. Use multiple `?q=` parameters to run several files. Open `http://localhost:3000/` to run all configured tests.
+8. Report results and any failures.

package/src/utils/config.js

@@ -1,9 +1,58 @@
-import {promises as fsp} from 'node:fs';
+import {promises as fsp, readFileSync} from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
+import {fileURLToPath} from 'node:url';
 
 import {listing, wildToRe} from './listing.js';
 
+export const printVersion = commandName => {
+  const pkgJsonPath = path.resolve(
+      path.dirname(fileURLToPath(import.meta.url)),
+      '../../package.json'
+    ),
+    version = JSON.parse(readFileSync(pkgJsonPath, 'utf8')).version;
+  console.log(commandName + ' ' + version);
+};
+
+export const printHelp = (commandName, description, usage, options) => {
+  const pkgJsonPath = path.resolve(
+      path.dirname(fileURLToPath(import.meta.url)),
+      '../../package.json'
+    ),
+    version = JSON.parse(readFileSync(pkgJsonPath, 'utf8')).version;
+  console.log(commandName + ' ' + version + ' \u2014 ' + description + '\n');
+  console.log('Usage: ' + usage + '\n');
+  if (options) {
+    console.log('Options:');
+    const width = options.reduce((max, [flag]) => Math.max(max, flag.length), 0) + 2;
+    for (const [flag, desc] of options) {
+      console.log('  ' + flag.padEnd(width) + desc);
+    }
+  }
+};
+
+const flagDefs = {
+  f: {name: 'failureOnly', description: 'Show failed tests only'},
+  t: {name: 'showTime', description: 'Show test execution time'},
+  b: {name: 'showBanner', description: 'Show the banner'},
+  d: {name: 'showData', description: 'Show test data'},
+  o: {name: 'failOnce', description: 'Stop after first failure'},
+  s: {name: 'showStack', description: 'Show stack traces'},
+  l: {name: 'showLog', description: 'Show console log output'},
+  n: {name: 'showAssertNumber', description: 'Show assertion numbers'},
+  m: {name: 'monochrome', description: 'Disable colors (monochrome)'},
+  j: {name: 'useJsonL', description: 'Use JSONL reporter'},
+  c: {name: 'noConsoleCapture', description: 'Disable console capture'},
+  h: {name: 'hideStreams', description: 'Hide streams'}
+};
+
+export const printFlagOptions = () => {
+  console.log('\nFlags (uppercase = on, lowercase = off):');
+  for (const [flag, {description}] of Object.entries(flagDefs)) {
+    console.log('  ' + flag.toUpperCase() + '  ' + description);
+  }
+};
+
 const exclude = (files, pattern) => {
   const excluded = new Set();
   for (const file of files) {
@@ -136,20 +185,9 @@ export const getTimeoutValue = () => {
 
 // parsing options
 
-export const flagNames = {
-  f: 'failureOnly',
-  t: 'showTime',
-  b: 'showBanner',
-  d: 'showData',
-  o: 'failOnce',
-  s: 'showStack',
-  l: 'showLog',
-  n: 'showAssertNumber',
-  m: 'monochrome',
-  j: 'useJsonL',
-  c: 'noConsoleCapture',
-  h: 'hideStreams'
-};
+export const flagNames = Object.fromEntries(
+  Object.entries(flagDefs).map(([k, {name}]) => [k, name])
+);
 
 export const processArgs = argOptions => {
   const result = {files: [], flags: {}};
@@ -247,7 +285,7 @@ export const getOptions = extraOptions => {
 
   for (let i = 0; i < flags.length; ++i) {
     const flag = flags[i].toLowerCase(),
-      name = flagNames[flag];
+      name = flagDefs[flag]?.name;
     if (typeof name == 'string') options.flags[name] = flag !== flags[i];
   }