tape-six-playwright 1.0.1 → 1.0.3

package/README.md

@@ -106,6 +106,8 @@ LLM-friendly documentation is available:
 
 The most recent releases:
 
+- 1.0.3 _Replaced `process.exit()` with `process.exitCode` to prevent truncated output._
+- 1.0.2 _Added `--help`/`-h` and `--version`/`-v` CLI options._
 - 1.0.1 _Updated dependencies, added `npm run browser` script, improved workflows._
 - 1.0.0 _The first official release._
 

package/bin/tape6-playwright-node.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 
+import {readFileSync} from 'node:fs';
+import path, {join} from 'node:path';
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 import {spawn} from 'node:child_process';
 
-import {getOptions, initReporter, showInfo} from 'tape-six/utils/config.js';
+import {getOptions, initReporter, showInfo, printFlagOptions} from 'tape-six/utils/config.js';
 
 import {getReporter, setReporter} from 'tape-six/test.js';
 import {selectTimer} from 'tape-six/utils/timer.js';
@@ -13,6 +15,11 @@ import TestWorker from '../src/TestWorker.js';
 
 const rootFolder = process.cwd();
 
+const getVersion = () => {
+  const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../package.json');
+  return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+};
+
 const showSelf = () => {
   const self = new URL(import.meta.url);
   if (self.protocol === 'file:') {
@@ -23,6 +30,40 @@ const showSelf = () => {
   process.exit(0);
 };
 
+const showVersion = () => {
+  console.log('tape6-playwright ' + getVersion());
+  process.exit(0);
+};
+
+const showHelp = () => {
+  console.log(
+    'tape6-playwright ' +
+      getVersion() +
+      ' \u2014 Playwright-based browser test runner for tape-six\n'
+  );
+  console.log('Usage: tape6-playwright [options] [patterns...]\n');
+  const options = [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    [
+      '--server-url, -u <url>',
+      'Server URL (env: TAPE6_SERVER_URL, default: http://localhost:3000)'
+    ],
+    ['--start-server', 'Auto-start tape6-server'],
+    ['--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']
+  ];
+  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);
+  }
+  printFlagOptions();
+  process.exit(0);
+};
+
 const getServerUrl = () => {
   if (process.env.TAPE6_SERVER_URL) return process.env.TAPE6_SERVER_URL;
   const host = process.env.HOST || 'localhost',
@@ -50,17 +91,16 @@ const ensureServer = async (serverUrl, startServer) => {
   }
 
   // start the server
-  const serverBin = fileURLToPath(
-    new URL('../node_modules/tape-six/bin/tape6-server.js', import.meta.url)
-  );
-  const host = new URL(serverUrl).hostname,
-    port = new URL(serverUrl).port || '3000';
-  const child = spawn(process.execPath, [serverBin], {
-    cwd: rootFolder,
-    stdio: ['ignore', 'ignore', 'pipe'],
-    detached: false,
-    env: {...process.env, HOST: host, PORT: port}
-  });
+  const serverBin = join(rootFolder, 'node_modules/tape-six/bin/tape6-server.js'),
+    serverParts = new URL(serverUrl),
+    host = serverParts.hostname,
+    port = serverParts.port || '3000',
+    child = spawn(process.execPath, [serverBin], {
+      cwd: rootFolder,
+      stdio: ['ignore', 'ignore', 'pipe'],
+      detached: false,
+      env: {...process.env, HOST: host, PORT: port}
+    });
 
   let exited = false,
     exitCode = null,
@@ -100,10 +140,12 @@ const ensureServer = async (serverUrl, startServer) => {
 
 const main = async () => {
   const options = getOptions({
-    '--self': showSelf,
+    '--self': {fn: showSelf, isValueRequired: false},
     '--start-server': {isValueRequired: false},
     '--info': {isValueRequired: false},
-    '--server-url': {aliases: ['-u'], initialValue: getServerUrl(), isValueRequired: true}
+    '--server-url': {aliases: ['-u'], initialValue: getServerUrl(), isValueRequired: true},
+    '--help': {aliases: ['-h'], fn: showHelp, isValueRequired: false},
+    '--version': {aliases: ['-v'], fn: showVersion, isValueRequired: false}
   });
   options.flags.serverUrl = options.optionFlags['--server-url'];
 
@@ -111,7 +153,9 @@ const main = async () => {
 
   if (options.optionFlags['--info'] === '') {
     showInfo(options, []);
-    process.exit(0);
+    await new Promise(r => process.stdout.write('', r));
+    process.exitCode = 0;
+    return;
   }
 
   const startServer = options.optionFlags['--start-server'] === '';
@@ -185,7 +229,9 @@ const main = async () => {
 
   await worker.cleanup();
 
-  shutdown(hasFailed ? 1 : 0);
+  serverChild?.kill();
+  await new Promise(r => process.stdout.write('', r));
+  process.exitCode = hasFailed ? 1 : 0;
 };
 
 main().catch(error => console.error('ERROR:', error));

package/bin/tape6-playwright.js

@@ -1,9 +1,48 @@
 #!/usr/bin/env node
 
+import {readFileSync} from 'node:fs';
+import path from 'node:path';
 import process from 'node:process';
 import {fileURLToPath} from 'node:url';
 
-if (process.argv.includes('--self')) {
+import {printFlagOptions} from 'tape-six/utils/config.js';
+
+const getVersion = () => {
+  const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../package.json');
+  return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+};
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(
+    'tape6-playwright ' +
+      getVersion() +
+      ' \u2014 Playwright-based browser test runner for tape-six\n'
+  );
+  console.log('Usage: tape6-playwright [options] [patterns...]\n');
+  const options = [
+    ['--flags, -f <flags>', 'Set reporter flags (env: TAPE6_FLAGS)'],
+    ['--par, -p <n>', 'Set parallelism level (env: TAPE6_PAR)'],
+    [
+      '--server-url, -u <url>',
+      'Server URL (env: TAPE6_SERVER_URL, default: http://localhost:3000)'
+    ],
+    ['--start-server', 'Auto-start tape6-server'],
+    ['--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']
+  ];
+  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);
+  }
+  printFlagOptions();
+  process.exit(0);
+} else if (process.argv.includes('--version') || process.argv.includes('-v')) {
+  console.log('tape6-playwright ' + getVersion());
+  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

@@ -44,7 +44,7 @@ tape6-playwright --start-server --flags FO
 Runs test files in parallel, each in its own iframe inside headless Chromium.
 
 ```bash
-tape6-playwright [--flags FLAGS] [--par N] [--start-server] [--server-url URL] [--info] [tests...]
+tape6-playwright [options] [patterns...]
 ```
 
 ### Options
@@ -55,6 +55,8 @@ tape6-playwright [--flags FLAGS] [--par N] [--start-server] [--server-url URL] [
 - `--server-url URL` (`-u`) — server URL. Overrides `TAPE6_SERVER_URL` and `HOST`/`PORT`.
 - `--self` — prints the absolute path to `tape6-playwright.js` and exits. Used in cross-runtime scripts.
 - `--info` — prints runtime, reporter, flags, parallelism, and resolved test files, then exits. Does not require a running server.
+- `--help` (`-h`) — shows help message with all options and flag descriptions, then exits.
+- `--version` (`-v`) — shows version and exits.
 - Positional arguments: test file glob patterns. If none given, resolved from configuration.
 - Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 
@@ -156,6 +158,8 @@ The `importmap` section is served by `tape6-server` at `/--importmap` and inject
 
 `bin/tape6-playwright.js` is the CLI entry point:
 
+- With `--help`/`-h`: prints usage and all options, then exits.
+- With `--version`/`-v`: prints version, then exits.
 - With `--self`: prints its own absolute path and exits.
 - Otherwise: delegates to `bin/tape6-playwright-node.js`.
 
@@ -204,7 +208,7 @@ iframe tape-six → ProxyReporter → window.parent.__tape6_reporter(id, event)
 
 ## Dependencies
 
-- **`tape-six`** — the core test library. Imports: `State.js`, `utils/EventServer.js`, `utils/config.js` (`getOptions`, `initReporter`, `showInfo`), `test.js`, `utils/timer.js`.
+- **`tape-six`** — the core test library. Imports: `State.js`, `utils/EventServer.js`, `utils/config.js` (`getOptions`, `initReporter`, `showInfo`, `printFlagOptions`), `test.js`, `utils/timer.js`.
 - **`playwright`** — headless browser automation. Bundled Chromium installed via `postinstall`.
 
 ## Writing tests

package/llms.txt

@@ -54,7 +54,7 @@ test('DOM test', t => {
 ## CLI: tape6-playwright
 
 ```bash
-tape6-playwright [--flags FLAGS] [--par N] [--start-server] [--server-url URL] [--info] [tests...]
+tape6-playwright [options] [patterns...]
 ```
 
 ### Options
@@ -65,6 +65,8 @@ tape6-playwright [--flags FLAGS] [--par N] [--start-server] [--server-url URL] [
 - `--server-url URL` (`-u`) — server URL (overrides `TAPE6_SERVER_URL`).
 - `--self` — prints the path to `tape6-playwright.js` (for cross-runtime scripts).
 - `--info` — prints runtime, reporter, flags, parallelism, and resolved test files, then exits.
+- `--help` (`-h`) — shows help message and exits.
+- `--version` (`-v`) — shows version and exits.
 - No arguments: runs tests from configuration.
 - Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tape-six-playwright",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Playwright-based browser test runner for tape-six. Runs each test file in its own iframe inside headless Chromium. Works with Node, Deno, and Bun.",
   "type": "module",
   "bin": {
@@ -60,7 +60,7 @@
   ],
   "dependencies": {
     "playwright": "^1.58.2",
-    "tape-six": "^1.7.10"
+    "tape-six": "^1.7.13"
   },
   "tape6": {
     "browser": [