@wtf/platform-suite 0.0.0-stage → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mikael Karon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @wtf/platform-suite
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The test suites that every implementation of a `@wtf/platform` member passes, for Vitest. If you
+write your own timers, `crypto`, `Path`, locks, channels, workers, `spawn` or a whole platform, run
+these suites in your tests: they hold it to what Node's members, a page's, the memory platform's and
+the test doubles do, so code that takes a `Platform` runs the same on yours. For a member from a
+web standard, a suite covers the helpers over it and what they rely on from the standard; the Web
+Platform Tests cover the rest.
+
+Each suite registers its tests with Vitest's `describe` and `it` when you call it, in a test file
+of your own. It takes a name for its tests, and what it tests, made fresh for each test:
+
+```ts
+import { locksSuite, processSuite, suiteScript } from '@wtf/platform-suite/suites'
+import { memoryLocks } from '@wtf/platform/locks'
+import { memoryPlatform } from '@wtf/platform-memory/platform'
+
+locksSuite('memoryLocks', memoryLocks)
+processSuite('memoryPlatform', ({ env }) => memoryPlatform({ env, spawn: suiteScript }), [
+  'program'
+])
+```
+
+| Suite                   | What it tests                                                                                             |
+| ----------------------- | --------------------------------------------------------------------------------------------------------- |
+| `timersSuite`           | Timers and `performance`: `sleep`, an aborted sleep, a cleared timer, `wallTime`                          |
+| `cryptoSuite`           | A `crypto`: `randomInt`, `randomFloat`, `randomBytes` beyond the quota, `randomId`, a UUID                |
+| `pathSuite`             | A `Path`: every call, on many paths and on each pair, returns what `node:path` returns                    |
+| `locksSuite`            | A `LockManager`: exclusive, shared, `ifAvailable` and aborted requests, as the Web Locks API defines them |
+| `broadcastChannelSuite` | A `BroadcastChannel`: a message reaches every other channel with the same name, not the sender, as a copy |
+| `workerSuite`           | A `Worker`: a message to its script and back, as a copy, and a transferred buffer                         |
+| `processSuite`          | A `spawn`: output, input of bytes, streams, `env`, `cwd`, a signal, `kill`, a command not there, no throw |
+| `platformSuite`         | A whole `Platform`: its members, `dirs.cwd` and `navigator.storage.getDirectory()`                        |
+
+`processSuite(name, make, program)` runs a program you name, which does what its next argument
+says (`SuiteProgram`): `cat`, `print`, `env`, `cwd` or `wait`. To test the `spawn` of a real
+platform, write a small script that does each, and name it with what runs it, as
+`[process.execPath, 'program.mjs']`. To test one in memory, answer it with `suiteScript`, which does
+each as a script does.
+
+## Install
+
+```sh
+npm install --save-dev @wtf/platform-suite vitest
+```
+
+The package publishes the built `dist`, depends on `@wtf/platform`, and takes your own Vitest, 5 or
+later, as a peer, so its tests register with the run of yours.

package/dist/suites.d.ts

@@ -0,0 +1,106 @@
+/**
+ * The suites every implementation of a member of `@wtf/platform` passes, each of one member,
+ * registered in a test's own run: {@link timersSuite}, {@link cryptoSuite}, {@link pathSuite},
+ * {@link locksSuite}, {@link broadcastChannelSuite}, {@link workerSuite} and, of a platform that
+ * starts processes, {@link processSuite}; and of a platform whole, {@link platformSuite}, which
+ * each of `nodePlatform`, `browserPlatform`, `memoryPlatform` and `testPlatform` passes. Where a
+ * member is a web standard's, its suite holds our helpers over it and what they rely on of the
+ * standard; the standard's own tests, the WPT, hold the rest. The tests of each package run them
+ * against its own implementations, so Node's, a page's, one in memory and a test's double behave
+ * alike.
+ *
+ * @packageDocumentation
+ */
+import type { Platform, ProcessPlatform } from '@wtf/platform';
+import type { BroadcastChannelConstructor } from '@wtf/platform/channel';
+import type { Env } from '@wtf/platform/env';
+import type { LockManager } from '@wtf/platform/locks';
+import type { ParsedPath, Path } from '@wtf/platform/path';
+import { type Crypto } from '@wtf/platform/random';
+import { type Performance, type Timers } from '@wtf/platform/timers';
+import type { WorkerConstructor } from '@wtf/platform/worker';
+/** Timers, and the `performance` of the same platform. */
+export type TimersOf = Timers & {
+    readonly performance: Pick<Performance, 'now' | 'timeOrigin'>;
+};
+/**
+ * That timers wait, and their `performance` reads the time: `advance` moves the timers of a test
+ * on, and is none of a platform's, whose waits are short.
+ */
+export declare const timersSuite: (name: string, make: () => TimersOf, advance?: (timers: TimersOf, ms: number) => Promise<void>) => void;
+/** That a `crypto` draws what our helpers ask of it, and fails as the standard says. */
+export declare const cryptoSuite: (name: string, make: () => Crypto) => void;
+/** What a {@link pathSuite} compares a path of, as `node:path` has it. */
+export type ReferencePath = Pick<Path, 'normalize' | 'resolve' | 'join' | 'isAbsolute' | 'relative' | 'dirname' | 'basename' | 'extname' | 'format'> & {
+    parse(path: string): ParsedPath;
+};
+/**
+ * That a path does what `reference`, `node:path`'s `posix` or `win32`, does, of a working folder
+ * `cwd`: each call of each of many paths, and of each two. Where Node's differs of the base of a
+ * root of a suffix (`//`, `C:\`), and the extension of `/..` in `parse`, the suite
+ * keeps what the rest of Node's calls say.
+ */
+export declare const pathSuite: (name: string, path: Path, { reference, cwd, kind }: {
+    reference: ReferencePath;
+    cwd: string;
+    kind: "posix" | "win32";
+}) => void;
+/** That locks are held as the Web Locks API holds them. */
+export declare const locksSuite: (name: string, make: () => LockManager) => void;
+/** That channels of a name give a message to each other, not to the one that posted it. */
+export declare const broadcastChannelSuite: (name: string, BroadcastChannel: BroadcastChannelConstructor) => void;
+/**
+ * That workers of `url`, a script that posts back each message it is given, are given and post
+ * messages as a `Worker` is: a copy of each, its transferables moved, until it is terminated.
+ */
+export declare const workerSuite: (name: string, Worker: WorkerConstructor, url: URL | string) => void;
+/**
+ * That a platform is one, whole: each member there, `navigator`'s `locks` and `storage` too; the
+ * folder it works in, `dirs.cwd`, an absolute path, which its `path` resolves a relative one
+ * against; and the root of its file system, `navigator.storage.getDirectory()`, a folder's handle,
+ * the same folder each call, from which a program walks down to a path.
+ */
+export declare const platformSuite: (name: string, make: () => Platform) => void;
+/**
+ * The program a {@link processSuite} runs, as its command and the arguments before its own: what it
+ * does is its next argument.
+ *
+ * - `cat`: writes what it reads to its stdout, until its stdin ends;
+ * - `print <out> <err> <code>`: writes `out` to its stdout and `err` to its stderr, and exits with
+ *   `code`;
+ * - `env <name>`: writes the variable `name` of its environment, or nothing, of none;
+ * - `cwd`: writes the folder it works in;
+ * - `wait`: runs until it is ended.
+ */
+export type SuiteProgram = readonly [command: string, ...args: string[]];
+/**
+ * The {@link SuiteProgram} `program`, as a script of a platform in memory answers it, of the
+ * input, the folder and the environment it is run with: a command but `program` it does not
+ * answer, as one not there. Its `wait` ends at once, as a script cannot wait; the suite ends one
+ * by its signal before its stdin ends.
+ */
+export declare const suiteScript: (command: string, args: readonly string[], { input, cwd, env }: {
+    readonly input: string;
+    readonly cwd: string;
+    readonly env: Readonly<Record<string, string>>;
+}) => {
+    stdout?: string;
+    stderr?: string;
+    code?: number;
+} | undefined;
+/**
+ * That a platform's `spawn` starts processes as `./process` of `@wtf/platform` has them, by
+ * `program`, a {@link SuiteProgram}: what it writes, as text, and its code, of `exec`; its input on
+ * a stdin that ends, of bytes alone; its outputs and its status as streams and a promise; the
+ * environment given, whole, or the platform's; the folder given, or the platform's working folder;
+ * a process its signal aborts ended by `SIGTERM`, and one its `kill` sends a signal ended by it; and
+ * a command not there a `SystemError` of `NotFound`, of a `spawn` that never throws. `make`
+ * gives the platform of an environment. `realpath` gives the real path of a folder, its links
+ * followed, as a process reports its working folder: `/private/var/…` of macOS's `/var/…`. A
+ * platform of no links, as one in memory, needs none.
+ */
+export declare const processSuite: (name: string, make: (members: {
+    readonly env: Env;
+}) => ProcessPlatform, program: SuiteProgram, { realpath }?: {
+    readonly realpath?: (folder: string) => string;
+}) => void;

package/dist/suites.js

@@ -0,0 +1,586 @@
+import { BadArgument } from '@wtf/platform/errors';
+import { exec } from '@wtf/platform/process';
+import { randomBytes, randomFloat, randomId, randomInt } from '@wtf/platform/random';
+import { sleep, wallTime } from '@wtf/platform/timers';
+import { describe, expect, it } from 'vitest';
+/**
+ * That timers wait, and their `performance` reads the time: `advance` moves the timers of a test
+ * on, and is none of a platform's, whose waits are short.
+ */
+export const timersSuite = (name, make, advance = async () => { }) => {
+    describe(`${name}, timers`, () => {
+        it('read the wall’s time of the performance, in milliseconds', () => {
+            const timers = make();
+            expect(Number.isFinite(wallTime(timers))).toBe(true);
+            expect(wallTime(timers)).toBeGreaterThanOrEqual(timers.performance.timeOrigin);
+        });
+        it('sleep, and the time has moved on by it', async () => {
+            const timers = make();
+            const before = timers.performance.now();
+            const waited = sleep(5, timers);
+            await advance(timers, 5);
+            await waited;
+            expect(timers.performance.now() - before).toBeGreaterThanOrEqual(4);
+        });
+        it('reject a sleep aborted, before or during it, with the reason', async () => {
+            const timers = make();
+            const reason = new Error('stop');
+            await expect(sleep(5, timers, AbortSignal.abort(reason))).rejects.toBe(reason);
+            const stop = new AbortController();
+            const waiting = sleep(60_000, timers, stop.signal);
+            stop.abort(reason);
+            await expect(waiting).rejects.toBe(reason);
+        });
+        it('stop a timer cleared, and clear an id of none', async () => {
+            const timers = make();
+            let ran = false;
+            const id = timers.setTimeout(() => {
+                ran = true;
+            }, 1);
+            timers.clearTimeout(id);
+            timers.clearTimeout(undefined);
+            const after = sleep(5, timers);
+            await advance(timers, 5);
+            await after;
+            expect(ran).toBe(false);
+        });
+    });
+};
+/** That a `crypto` draws what our helpers ask of it, and fails as the standard says. */
+export const cryptoSuite = (name, make) => {
+    describe(`${name}, a crypto`, () => {
+        it('draws an integer of its bound, its end not included, and a number below 1', () => {
+            const source = { crypto: make() };
+            const integers = new Set(Array.from({ length: 300 }, () => randomInt(6, source)));
+            expect([...integers].toSorted()).toEqual([0, 1, 2, 3, 4, 5]);
+            const numbers = Array.from({ length: 200 }, () => randomFloat(source));
+            expect(numbers.every((each) => each >= 0 && each < 1)).toBe(true);
+        });
+        it('draws bytes of the length asked, past a quota of a call', () => {
+            const source = { crypto: make() };
+            expect(randomBytes(70_000, source)).toHaveLength(70_000);
+            expect(randomBytes(0, source)).toEqual(new Uint8Array());
+        });
+        it('draws an id of its alphabet and size, and a UUID of version 4', () => {
+            const crypto = make();
+            expect(randomId({ crypto })).toMatch(/^[\w-]{21}$/);
+            expect(randomId({ crypto }, { size: 8, alphabet: '01' })).toMatch(/^[01]{8}$/);
+            expect(crypto.randomUUID()).toMatch(/^[\da-f]{8}-[\da-f]{4}-4[\da-f]{3}-[89ab][\da-f]{3}-[\da-f]{12}$/);
+        });
+        it('refuses a bound, a length or an alphabet that is none, as a BadArgument', () => {
+            const source = { crypto: make() };
+            expect(() => randomInt(0, source)).toThrow(BadArgument);
+            expect(() => randomBytes(-1, source)).toThrow(BadArgument);
+            expect(() => randomId(source, { alphabet: 'a' })).toThrow(BadArgument);
+        });
+        it('refuses to fill more than a quota, as a QuotaExceededError', () => {
+            expect(() => make().getRandomValues(new Uint8Array(65_537))).toThrow(expect.objectContaining({ name: 'QuotaExceededError' }));
+        });
+        it('digests bytes by SHA-1, SHA-256, SHA-384 and SHA-512, of a name of any case', async () => {
+            const { subtle } = make();
+            const hex = async (algorithm, text) => [...new Uint8Array(await subtle.digest(algorithm, new TextEncoder().encode(text)))]
+                .map((byte) => byte.toString(16).padStart(2, '0'))
+                .join('');
+            expect(await hex('SHA-1', 'abc')).toBe('a9993e364706816aba3e25717850c26c9cd0d89d');
+            expect(await hex({ name: 'sha-256' }, '')).toBe('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855');
+            expect(await hex('SHA-256', 'abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq')).toBe('248d6a61d20638b8e5c026930c3e6039a33ce45964ff2167f6ecedd419db06c1');
+            expect(await hex('SHA-384', 'abc')).toBe('cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7');
+            expect(await hex('SHA-512', 'abc')).toBe('ddaf35a193617abacc417349ae20413112e6fa4e89a97ea20a9eeee64b55d39a2192992a274fc1a836ba3c23a3feebbd454d4423643ce80e2a9ac94fa54ca49f');
+            expect(await hex('SHA-256', 'a'.repeat(1000))).toBe('41edece42d63e8d9bf515a9ba6932e1c20cbc9f5a5d134645adb5db1b9737ea3');
+            await expect(subtle.digest('MD5', new Uint8Array())).rejects.toMatchObject({
+                name: 'NotSupportedError'
+            });
+        });
+    });
+};
+/** The paths a {@link pathSuite} compares, as each of its kind writes them. */
+const POSIX = [
+    '',
+    '.',
+    '..',
+    '/',
+    '//',
+    '///a',
+    'a',
+    'a/',
+    'a//b',
+    '/a//b',
+    '/a/b/',
+    'a/b/../c',
+    '../a',
+    '../../a/..',
+    './a/./b',
+    '/..',
+    '/../a',
+    'a/..',
+    'a/../',
+    '.a',
+    '..a',
+    'a.',
+    '.a.b',
+    'a.b.c',
+    '/a/.b',
+    'a/b.c/',
+    '...',
+    'a/...',
+    'file.tar.gz',
+    '/x/.',
+    'a/./',
+    '/a/b/c/..'
+];
+const WIN32 = [
+    '',
+    '.',
+    '..',
+    '\\',
+    '/',
+    'C:',
+    'C:\\',
+    'C:/',
+    'c:\\a',
+    'C:a',
+    'C:..\\a',
+    'D:\\x\\y',
+    'a',
+    'a\\',
+    'a/b',
+    'a\\\\b',
+    '\\a\\b\\',
+    '/a/b/../c',
+    '..\\a',
+    '\\\\server\\share',
+    '\\\\server\\share\\',
+    '\\\\server\\share\\a\\b',
+    '//server/share/a',
+    'a\\..',
+    'a\\..\\',
+    'C:\\a\\b.txt',
+    '.bashrc',
+    'C:\\..',
+    'C:\\a\\..\\..',
+    'a/./b',
+    'C:\\a\\B'
+];
+/**
+ * That a path does what `reference`, `node:path`'s `posix` or `win32`, does, of a working folder
+ * `cwd`: each call of each of many paths, and of each two. Where Node's differs of the base of a
+ * root of a suffix (`//`, `C:\`), and the extension of `/..` in `parse`, the suite
+ * keeps what the rest of Node's calls say.
+ */
+export const pathSuite = (name, path, { reference, cwd, kind }) => {
+    const inputs = kind === 'posix' ? POSIX : WIN32;
+    describe(`${name}, a Path of ${kind}`, () => {
+        it.each(inputs)('takes %j apart as the reference does', (input) => {
+            expect(path.normalize(input)).toBe(reference.normalize(input));
+            expect(path.dirname(input)).toBe(reference.dirname(input));
+            expect(path.basename(input)).toBe(reference.basename(input));
+            // Node's gives a root as a base of a suffix, and none without one: the suite takes none.
+            if (!['//', 'C:\\', 'C:/'].includes(input))
+                expect(path.basename(input, '.c')).toBe(reference.basename(input, '.c'));
+            expect(path.extname(input)).toBe(reference.extname(input));
+            expect(path.isAbsolute(input)).toBe(reference.isAbsolute(input));
+            if (input !== '/..') {
+                expect(path.parse(input)).toEqual({ ...reference.parse(input) });
+                expect(path.format(path.parse(input))).toBe(reference.format(reference.parse(input)));
+            }
+        });
+        it.each(inputs)('joins, resolves and relates %j to each as the reference does', (input) => {
+            for (const other of inputs) {
+                expect(path.join(input, other)).toBe(reference.join(input, other));
+                expect(path.resolve(input, other)).toBe(reference.resolve(cwd, input, other));
+                expect(path.relative(input, other)).toBe(reference.relative(reference.resolve(cwd, input), reference.resolve(cwd, other)));
+            }
+        });
+        it('gives the file URL of a path, and the path of it', () => {
+            const file = kind === 'posix' ? '/a b/c#d?e%f' : 'C:\\a b\\c#d?e%f';
+            const url = path.toFileUrl(file);
+            expect(url.protocol).toBe('file:');
+            expect(url.pathname).toMatch(/a%20b\/c%23d%3Fe%25f$/);
+            expect(path.fromFileUrl(url)).toBe(file);
+        });
+        it('refuses a URL that is no file URL, as a BadArgument', () => {
+            expect(() => path.fromFileUrl('https://example.com/a')).toThrow(BadArgument);
+        });
+    });
+};
+/** A promise, and what resolves it. */
+const deferred = () => Promise.withResolvers();
+/** That locks are held as the Web Locks API holds them. */
+export const locksSuite = (name, make) => {
+    describe(`${name}, Locks`, () => {
+        it('runs a request holding the lock, and gives what its callback gave', async () => {
+            const locks = make();
+            expect(await locks.request('a', (lock) => lock && { name: lock.name, mode: lock.mode })).toEqual({
+                name: 'a',
+                mode: 'exclusive'
+            });
+            expect(await locks.request('a', async () => 3)).toBe(3);
+        });
+        it('runs exclusive requests one at a time, in order', async () => {
+            const locks = make();
+            const order = [];
+            const first = deferred();
+            const one = locks.request('suite-a', async () => {
+                order.push('one');
+                await first.promise;
+                order.push('one done');
+            });
+            const two = locks.request('suite-a', () => order.push('two'));
+            await locks.request('suite-b', () => order.push('other'));
+            expect(order).toEqual(['one', 'other']);
+            first.resolve();
+            await Promise.all([one, two]);
+            expect(order).toEqual(['one', 'other', 'one done', 'two']);
+        });
+        it('holds a shared lock with others that share it, and an exclusive one waits', async () => {
+            const locks = make();
+            const held = deferred();
+            const order = [];
+            const a = locks.request('suite-s', { mode: 'shared' }, () => held.promise.then(() => order.push('a')));
+            await locks.request('suite-s', { mode: 'shared' }, () => order.push('b'));
+            const c = locks.request('suite-s', () => order.push('c'));
+            expect(order).toEqual(['b']);
+            held.resolve();
+            await Promise.all([a, c]);
+            expect(order).toEqual(['b', 'a', 'c']);
+        });
+        it('gives null at once, if it is not available', async () => {
+            const locks = make();
+            const held = deferred();
+            const holding = locks.request('suite-i', () => held.promise);
+            expect(await locks.request('suite-i', { ifAvailable: true }, (lock) => lock)).toBeNull();
+            held.resolve();
+            await holding;
+        });
+        it('says the locks held and asked for', async () => {
+            const locks = make();
+            const held = deferred();
+            const holding = locks.request('suite-q', () => held.promise);
+            const waiting = locks.request('suite-q', { mode: 'shared' }, () => 0);
+            const { held: holders = [], pending = [] } = await locks.query();
+            expect(holders.filter((each) => each.name === 'suite-q').map(({ mode }) => mode)).toEqual([
+                'exclusive'
+            ]);
+            expect(pending.filter((each) => each.name === 'suite-q').map(({ mode }) => mode)).toEqual([
+                'shared'
+            ]);
+            held.resolve();
+            await Promise.all([holding, waiting]);
+        });
+        it('refuse a name that starts with -, as a NotSupportedError', async () => {
+            await expect(make().request('-reserved', () => 0)).rejects.toMatchObject({
+                name: 'NotSupportedError'
+            });
+        });
+        it('rejects a wait aborted, and releases a lock its callback threw in', async () => {
+            const locks = make();
+            const reason = new Error('stop');
+            const held = deferred();
+            const holding = locks.request('suite-r', () => held.promise);
+            const stop = new AbortController();
+            const waiting = locks.request('suite-r', { signal: stop.signal }, () => 1);
+            stop.abort(reason);
+            await expect(waiting).rejects.toBe(reason);
+            held.resolve();
+            await holding;
+            await expect(locks.request('suite-r', () => {
+                throw reason;
+            })).rejects.toBe(reason);
+            expect(await locks.request('suite-r', () => 'free')).toBe('free');
+        });
+    });
+};
+/** The next message of a target. */
+const nextOf = (target) => new Promise((resolve) => target.addEventListener('message', ({ data }) => resolve(data)));
+/** That channels of a name give a message to each other, not to the one that posted it. */
+export const broadcastChannelSuite = (name, BroadcastChannel) => {
+    describe(`${name}, a BroadcastChannel`, () => {
+        it('gives a message to each other channel of the name, and not to itself', async () => {
+            const [a, b, c] = [
+                new BroadcastChannel('suite'),
+                new BroadcastChannel('suite'),
+                new BroadcastChannel('suite')
+            ];
+            const own = [];
+            a.addEventListener('message', ({ data }) => own.push(data));
+            const [toB, toC] = [nextOf(b), nextOf(c)];
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin
+            a.postMessage('hello');
+            expect(await Promise.all([toB, toC])).toEqual(['hello', 'hello']);
+            expect(own).toEqual([]);
+            for (const each of [a, b, c])
+                each.close();
+        });
+        it('gives nothing to a listener removed, nor to a channel of another name', async () => {
+            const [a, b, other] = [
+                new BroadcastChannel('suite-r'),
+                new BroadcastChannel('suite-r'),
+                new BroadcastChannel('suite-other')
+            ];
+            const seen = [];
+            const listener = ({ data }) => seen.push(data);
+            b.addEventListener('message', listener);
+            b.removeEventListener('message', listener);
+            other.addEventListener('message', listener);
+            const last = nextOf(b);
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin
+            a.postMessage('one');
+            await last;
+            expect(seen).toEqual([]);
+            for (const each of [a, b, other])
+                each.close();
+        });
+        it('gives each a copy, by structuredClone, and refuses what cannot be copied', async () => {
+            const [a, b] = [new BroadcastChannel('suite-c'), new BroadcastChannel('suite-c')];
+            const sent = { list: [1, 2], when: new Date(0) };
+            const received = nextOf(b);
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin
+            a.postMessage(sent);
+            const copy = await received;
+            expect(copy).toEqual(sent);
+            expect(copy).not.toBe(sent);
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin
+            expect(() => a.postMessage(() => { })).toThrow(expect.objectContaining({ name: 'DataCloneError' }));
+            for (const each of [a, b])
+                each.close();
+        });
+        it('refuses a post to a channel closed, as an InvalidStateError', () => {
+            const a = new BroadcastChannel('suite-closed');
+            a.close();
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin
+            expect(() => a.postMessage('late')).toThrow(expect.objectContaining({ name: 'InvalidStateError' }));
+        });
+    });
+};
+/**
+ * That workers of `url`, a script that posts back each message it is given, are given and post
+ * messages as a `Worker` is: a copy of each, its transferables moved, until it is terminated.
+ */
+export const workerSuite = (name, Worker, url) => {
+    describe(`${name}, a Worker`, () => {
+        it('gives the script a copy of a message, and is given what it posts', async () => {
+            const worker = new Worker(url);
+            const sent = { list: [1, 2] };
+            const echoed = nextOf(worker);
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a worker's post takes no origin
+            worker.postMessage(sent);
+            expect(await echoed).toEqual(sent);
+            worker.terminate();
+        });
+        it('moves what is transferred', async () => {
+            const worker = new Worker(url);
+            const buffer = new Uint8Array([1, 2, 3]).buffer;
+            const echoed = nextOf(worker);
+            // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a worker's post takes no origin
+            worker.postMessage(buffer, [buffer]);
+            expect(buffer.byteLength).toBe(0);
+            expect(new Uint8Array((await echoed))).toEqual(new Uint8Array([1, 2, 3]));
+            worker.terminate();
+        });
+    });
+};
+/** The members of a {@link Platform}, of the web standards and our own. */
+const MEMBERS = [
+    'setTimeout',
+    'clearTimeout',
+    'performance',
+    'crypto',
+    'console',
+    'navigator',
+    'BroadcastChannel',
+    'MessageChannel',
+    'Worker',
+    'fetch',
+    'env',
+    'path',
+    'dirs',
+    'terminal',
+    'open'
+];
+/**
+ * That a platform is one, whole: each member there, `navigator`'s `locks` and `storage` too; the
+ * folder it works in, `dirs.cwd`, an absolute path, which its `path` resolves a relative one
+ * against; and the root of its file system, `navigator.storage.getDirectory()`, a folder's handle,
+ * the same folder each call, from which a program walks down to a path.
+ */
+export const platformSuite = (name, make) => {
+    describe(`${name}, a Platform`, () => {
+        it('has each member', () => {
+            const platform = make();
+            for (const member of MEMBERS)
+                expect(platform[member], member).toBeDefined();
+            expect(typeof platform.navigator.locks.request).toBe('function');
+            expect(typeof platform.navigator.storage.getDirectory).toBe('function');
+        });
+        it('works in the folder of an absolute path, which its paths resolve against', () => {
+            const { dirs, path } = make();
+            expect(path.isAbsolute(dirs.cwd)).toBe(true);
+            expect(path.resolve('a', 'b')).toBe(path.join(dirs.cwd, 'a', 'b'));
+        });
+        it('gives the root of its file system, a folder, the same each call', async () => {
+            const { storage } = make().navigator;
+            const root = await storage.getDirectory();
+            expect(root.kind).toBe('directory');
+            expect(await root.isSameEntry(await storage.getDirectory())).toBe(true);
+            expect(await root.resolve(root)).toEqual([]);
+        });
+    });
+};
+/**
+ * The {@link SuiteProgram} `program`, as a script of a platform in memory answers it, of the
+ * input, the folder and the environment it is run with: a command but `program` it does not
+ * answer, as one not there. Its `wait` ends at once, as a script cannot wait; the suite ends one
+ * by its signal before its stdin ends.
+ */
+export const suiteScript = (command, args, { input, cwd, env }) => {
+    if (command !== 'program')
+        return undefined;
+    const [mode, first = '', second = '', third = '0'] = args;
+    if (mode === 'cat')
+        return { stdout: input };
+    if (mode === 'print')
+        return { stdout: first, stderr: second, code: Number(third) };
+    if (mode === 'env')
+        return { stdout: env[first] ?? '' };
+    if (mode === 'cwd')
+        return { stdout: cwd };
+    return {};
+};
+/** The text of a stream of bytes, to its end. */
+const textOf = async (stream) => {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let text = '';
+    for (;;) {
+        // oxlint-disable-next-line no-await-in-loop -- a stream is read one chunk at a time
+        const { done, value } = await reader.read();
+        if (done)
+            return text + decoder.decode();
+        text += decoder.decode(value, { stream: true });
+    }
+};
+/**
+ * That a platform's `spawn` starts processes as `./process` of `@wtf/platform` has them, by
+ * `program`, a {@link SuiteProgram}: what it writes, as text, and its code, of `exec`; its input on
+ * a stdin that ends, of bytes alone; its outputs and its status as streams and a promise; the
+ * environment given, whole, or the platform's; the folder given, or the platform's working folder;
+ * a process its signal aborts ended by `SIGTERM`, and one its `kill` sends a signal ended by it; and
+ * a command not there a `SystemError` of `NotFound`, of a `spawn` that never throws. `make`
+ * gives the platform of an environment. `realpath` gives the real path of a folder, its links
+ * followed, as a process reports its working folder: `/private/var/…` of macOS's `/var/…`. A
+ * platform of no links, as one in memory, needs none.
+ */
+export const processSuite = (name, make, program, { realpath = (folder) => folder } = {}) => {
+    const [command, ...before] = program;
+    const run = (platform, args, options) => exec(platform.spawn, command, [...before, ...args], options);
+    describe(`${name}, processes`, () => {
+        it('runs a program to its end, and gives what it wrote, as text, and its code', async () => {
+            expect(await run(make({ env: {} }), ['print', 'out ü', 'err', '3'])).toEqual({
+                stdout: 'out ü',
+                stderr: 'err',
+                code: 3
+            });
+            expect(await run(make({ env: {} }), ['print', '', '', '0'])).toEqual({
+                stdout: '',
+                stderr: '',
+                code: 0
+            });
+        });
+        it('gives a program its input, and ends its stdin', async () => {
+            const platform = make({ env: {} });
+            expect((await run(platform, ['cat'], { input: 'one\ntwo ü' })).stdout).toBe('one\ntwo ü');
+            expect((await run(platform, ['cat'], { input: new Uint8Array([104, 105]) })).stdout).toBe('hi');
+            expect((await run(platform, ['cat'])).stdout).toBe('');
+        });
+        it('streams what a process reads and writes, and resolves how it ended', async () => {
+            const child = make({ env: {} }).spawn(command, [...before, 'cat']);
+            const writer = child.stdin.getWriter();
+            await writer.write(new TextEncoder().encode('streamed, '));
+            await writer.write(new TextEncoder().encode('in parts'));
+            await writer.close();
+            const [stdout, stderr, status] = await Promise.all([
+                textOf(child.stdout),
+                textOf(child.stderr),
+                child.status
+            ]);
+            expect({ stdout, stderr, status }).toEqual({
+                stdout: 'streamed, in parts',
+                stderr: '',
+                status: { code: 0 }
+            });
+        });
+        it('gives a process the environment given, whole, or else the platform’s', async () => {
+            const platform = make({ env: { SUITE_PLATFORM: 'platform', SUITE_UNSET: undefined } });
+            expect((await run(platform, ['env', 'SUITE_PLATFORM'])).stdout).toBe('platform');
+            expect((await run(platform, ['env', 'SUITE_UNSET'])).stdout).toBe('');
+            const env = { SUITE_GIVEN: 'given' };
+            expect((await run(platform, ['env', 'SUITE_GIVEN'], { env })).stdout).toBe('given');
+            expect((await run(platform, ['env', 'SUITE_PLATFORM'], { env })).stdout).toBe('');
+        });
+        it('runs a process in the folder given, or else the platform’s working folder', async () => {
+            const platform = make({ env: {} });
+            expect((await run(platform, ['cwd'])).stdout).toBe(realpath(platform.dirs.cwd));
+            const cwd = platform.dirs.temp;
+            expect((await run(platform, ['cwd'], { cwd })).stdout).toBe(realpath(cwd));
+        });
+        it('ends a process its signal aborts, by SIGTERM, of the code a shell gives it', async () => {
+            const stop = new AbortController();
+            const child = make({ env: {} }).spawn(command, [...before, 'wait'], { signal: stop.signal });
+            stop.abort();
+            const [status] = await Promise.all([child.status, textOf(child.stdout), textOf(child.stderr)]);
+            expect(status).toEqual({ code: 143, signal: 'SIGTERM' });
+            const reason = new Error('stop');
+            await expect(run(make({ env: {} }), ['cat'], { signal: AbortSignal.abort(reason) })).rejects.toBe(reason);
+        });
+        it('sends a process a signal by kill, SIGTERM by default, and the status says it', async () => {
+            const platform = make({ env: {} });
+            const ended = async (signal) => {
+                const child = platform.spawn(command, [...before, 'wait']);
+                child.kill(signal);
+                const [status] = await Promise.all([
+                    child.status,
+                    textOf(child.stdout),
+                    textOf(child.stderr)
+                ]);
+                return status;
+            };
+            expect(await ended('SIGKILL')).toEqual({ code: 137, signal: 'SIGKILL' });
+            expect(await ended()).toEqual({ code: 143, signal: 'SIGTERM' });
+        });
+        it('sends a process that has ended nothing, and refuses a name of no signal', async () => {
+            const child = make({ env: {} }).spawn(command, [...before, 'print', 'out', '', '2']);
+            await child.stdin.close();
+            const [status] = await Promise.all([child.status, textOf(child.stdout), textOf(child.stderr)]);
+            child.kill('SIGKILL');
+            expect(await child.status).toEqual(status);
+            expect(status).toEqual({ code: 2 });
+            expect(() => child.kill('SIGNOPE')).toThrow(BadArgument);
+        });
+        it('refuses a chunk of stdin that is no bytes, and ends the process’s input', async () => {
+            const child = make({ env: {} }).spawn(command, [...before, 'cat']);
+            const writer = child.stdin.getWriter();
+            await writer.write(new TextEncoder().encode('before '));
+            await expect(writer.write('text')).rejects.toThrow(TypeError);
+            await expect(writer.closed).rejects.toThrow(TypeError);
+            const [stdout, status] = await Promise.all([
+                textOf(child.stdout),
+                child.status,
+                textOf(child.stderr)
+            ]);
+            expect({ stdout, status }).toEqual({ stdout: 'before ', status: { code: 0 } });
+        });
+        it('rejects a command not there, as a SystemError of NotFound', async () => {
+            await expect(exec(make({ env: {} }).spawn, 'platform-suite-no-such-command', [])).rejects.toMatchObject({ _tag: 'SystemError', reason: 'NotFound', module: 'Process' });
+        });
+        it('gives a process that could not start, and never throws: its outputs end', async () => {
+            const child = make({ env: {} }).spawn('platform-suite-no-such-command', []);
+            // Its input ends, as exec ends it: of a process that never started, it may refuse to.
+            await child.stdin.close().catch(() => { });
+            expect(await textOf(child.stdout)).toBe('');
+            expect(await textOf(child.stderr)).toBe('');
+            await expect(child.status).rejects.toMatchObject({ _tag: 'SystemError', reason: 'NotFound' });
+            expect(() => child.kill()).not.toThrow();
+        });
+    });
+};
+//# sourceMappingURL=suites.js.map

package/dist/suites.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suites.js","sourceRoot":"","sources":["../src/suites.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The suites every implementation of a member of `@wtf/platform` passes, each of one member,\n * registered in a test's own run: {@link timersSuite}, {@link cryptoSuite}, {@link pathSuite},\n * {@link locksSuite}, {@link broadcastChannelSuite}, {@link workerSuite} and, of a platform that\n * starts processes, {@link processSuite}; and of a platform whole, {@link platformSuite}, which\n * each of `nodePlatform`, `browserPlatform`, `memoryPlatform` and `testPlatform` passes. Where a\n * member is a web standard's, its suite holds our helpers over it and what they rely on of the\n * standard; the standard's own tests, the WPT, hold the rest. The tests of each package run them\n * against its own implementations, so Node's, a page's, one in memory and a test's double behave\n * alike.\n *\n * @packageDocumentation\n */\nimport type { Platform, ProcessPlatform } from '@wtf/platform'\nimport type { BroadcastChannelConstructor } from '@wtf/platform/channel'\nimport type { Env } from '@wtf/platform/env'\nimport { BadArgument } from '@wtf/platform/errors'\nimport type { LockManager } from '@wtf/platform/locks'\nimport type { ParsedPath, Path } from '@wtf/platform/path'\nimport { exec, type ProcessSignal } from '@wtf/platform/process'\nimport { type Crypto, randomBytes, randomFloat, randomId, randomInt } from '@wtf/platform/random'\nimport { type Performance, sleep, type Timers, wallTime } from '@wtf/platform/timers'\nimport type { MessageEvent, WorkerConstructor } from '@wtf/platform/worker'\nimport { describe, expect, it } from 'vitest'\n\n/** Timers, and the `performance` of the same platform. */\nexport type TimersOf = Timers & { readonly performance: Pick<Performance, 'now' | 'timeOrigin'> }\n\n/**\n * That timers wait, and their `performance` reads the time: `advance` moves the timers of a test\n * on, and is none of a platform's, whose waits are short.\n */\nexport const timersSuite = (\n  name: string,\n  make: () => TimersOf,\n  advance: (timers: TimersOf, ms: number) => Promise<void> = async () => {}\n): void => {\n  describe(`${name}, timers`, () => {\n    it('read the wall’s time of the performance, in milliseconds', () => {\n      const timers = make()\n      expect(Number.isFinite(wallTime(timers))).toBe(true)\n      expect(wallTime(timers)).toBeGreaterThanOrEqual(timers.performance.timeOrigin)\n    })\n\n    it('sleep, and the time has moved on by it', async () => {\n      const timers = make()\n      const before = timers.performance.now()\n      const waited = sleep(5, timers)\n      await advance(timers, 5)\n      await waited\n      expect(timers.performance.now() - before).toBeGreaterThanOrEqual(4)\n    })\n\n    it('reject a sleep aborted, before or during it, with the reason', async () => {\n      const timers = make()\n      const reason = new Error('stop')\n      await expect(sleep(5, timers, AbortSignal.abort(reason))).rejects.toBe(reason)\n      const stop = new AbortController()\n      const waiting = sleep(60_000, timers, stop.signal)\n      stop.abort(reason)\n      await expect(waiting).rejects.toBe(reason)\n    })\n\n    it('stop a timer cleared, and clear an id of none', async () => {\n      const timers = make()\n      let ran = false\n      const id = timers.setTimeout(() => {\n        ran = true\n      }, 1)\n      timers.clearTimeout(id)\n      timers.clearTimeout(undefined)\n      const after = sleep(5, timers)\n      await advance(timers, 5)\n      await after\n      expect(ran).toBe(false)\n    })\n  })\n}\n\n/** That a `crypto` draws what our helpers ask of it, and fails as the standard says. */\nexport const cryptoSuite = (name: string, make: () => Crypto): void => {\n  describe(`${name}, a crypto`, () => {\n    it('draws an integer of its bound, its end not included, and a number below 1', () => {\n      const source = { crypto: make() }\n      const integers = new Set(Array.from({ length: 300 }, () => randomInt(6, source)))\n      expect([...integers].toSorted()).toEqual([0, 1, 2, 3, 4, 5])\n      const numbers = Array.from({ length: 200 }, () => randomFloat(source))\n      expect(numbers.every((each) => each >= 0 && each < 1)).toBe(true)\n    })\n\n    it('draws bytes of the length asked, past a quota of a call', () => {\n      const source = { crypto: make() }\n      expect(randomBytes(70_000, source)).toHaveLength(70_000)\n      expect(randomBytes(0, source)).toEqual(new Uint8Array())\n    })\n\n    it('draws an id of its alphabet and size, and a UUID of version 4', () => {\n      const crypto = make()\n      expect(randomId({ crypto })).toMatch(/^[\\w-]{21}$/)\n      expect(randomId({ crypto }, { size: 8, alphabet: '01' })).toMatch(/^[01]{8}$/)\n      expect(crypto.randomUUID()).toMatch(\n        /^[\\da-f]{8}-[\\da-f]{4}-4[\\da-f]{3}-[89ab][\\da-f]{3}-[\\da-f]{12}$/\n      )\n    })\n\n    it('refuses a bound, a length or an alphabet that is none, as a BadArgument', () => {\n      const source = { crypto: make() }\n      expect(() => randomInt(0, source)).toThrow(BadArgument)\n      expect(() => randomBytes(-1, source)).toThrow(BadArgument)\n      expect(() => randomId(source, { alphabet: 'a' })).toThrow(BadArgument)\n    })\n\n    it('refuses to fill more than a quota, as a QuotaExceededError', () => {\n      expect(() => make().getRandomValues(new Uint8Array(65_537))).toThrow(\n        expect.objectContaining({ name: 'QuotaExceededError' })\n      )\n    })\n\n    it('digests bytes by SHA-1, SHA-256, SHA-384 and SHA-512, of a name of any case', async () => {\n      const { subtle } = make()\n      const hex = async (algorithm: string | { name: string }, text: string) =>\n        [...new Uint8Array(await subtle.digest(algorithm, new TextEncoder().encode(text)))]\n          .map((byte) => byte.toString(16).padStart(2, '0'))\n          .join('')\n      expect(await hex('SHA-1', 'abc')).toBe('a9993e364706816aba3e25717850c26c9cd0d89d')\n      expect(await hex({ name: 'sha-256' }, '')).toBe(\n        'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'\n      )\n      expect(await hex('SHA-256', 'abcdbcdecdefdefgefghfghighijhijkijkljklmklmnlmnomnopnopq')).toBe(\n        '248d6a61d20638b8e5c026930c3e6039a33ce45964ff2167f6ecedd419db06c1'\n      )\n      expect(await hex('SHA-384', 'abc')).toBe(\n        'cb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7'\n      )\n      expect(await hex('SHA-512', 'abc')).toBe(\n        'ddaf35a193617abacc417349ae20413112e6fa4e89a97ea20a9eeee64b55d39a2192992a274fc1a836ba3c23a3feebbd454d4423643ce80e2a9ac94fa54ca49f'\n      )\n      expect(await hex('SHA-256', 'a'.repeat(1000))).toBe(\n        '41edece42d63e8d9bf515a9ba6932e1c20cbc9f5a5d134645adb5db1b9737ea3'\n      )\n      await expect(subtle.digest('MD5', new Uint8Array())).rejects.toMatchObject({\n        name: 'NotSupportedError'\n      })\n    })\n  })\n}\n\n/** The paths a {@link pathSuite} compares, as each of its kind writes them. */\nconst POSIX = [\n  '',\n  '.',\n  '..',\n  '/',\n  '//',\n  '///a',\n  'a',\n  'a/',\n  'a//b',\n  '/a//b',\n  '/a/b/',\n  'a/b/../c',\n  '../a',\n  '../../a/..',\n  './a/./b',\n  '/..',\n  '/../a',\n  'a/..',\n  'a/../',\n  '.a',\n  '..a',\n  'a.',\n  '.a.b',\n  'a.b.c',\n  '/a/.b',\n  'a/b.c/',\n  '...',\n  'a/...',\n  'file.tar.gz',\n  '/x/.',\n  'a/./',\n  '/a/b/c/..'\n]\nconst WIN32 = [\n  '',\n  '.',\n  '..',\n  '\\\\',\n  '/',\n  'C:',\n  'C:\\\\',\n  'C:/',\n  'c:\\\\a',\n  'C:a',\n  'C:..\\\\a',\n  'D:\\\\x\\\\y',\n  'a',\n  'a\\\\',\n  'a/b',\n  'a\\\\\\\\b',\n  '\\\\a\\\\b\\\\',\n  '/a/b/../c',\n  '..\\\\a',\n  '\\\\\\\\server\\\\share',\n  '\\\\\\\\server\\\\share\\\\',\n  '\\\\\\\\server\\\\share\\\\a\\\\b',\n  '//server/share/a',\n  'a\\\\..',\n  'a\\\\..\\\\',\n  'C:\\\\a\\\\b.txt',\n  '.bashrc',\n  'C:\\\\..',\n  'C:\\\\a\\\\..\\\\..',\n  'a/./b',\n  'C:\\\\a\\\\B'\n]\n\n/** What a {@link pathSuite} compares a path of, as `node:path` has it. */\nexport type ReferencePath = Pick<\n  Path,\n  | 'normalize'\n  | 'resolve'\n  | 'join'\n  | 'isAbsolute'\n  | 'relative'\n  | 'dirname'\n  | 'basename'\n  | 'extname'\n  | 'format'\n> & { parse(path: string): ParsedPath }\n\n/**\n * That a path does what `reference`, `node:path`'s `posix` or `win32`, does, of a working folder\n * `cwd`: each call of each of many paths, and of each two. Where Node's differs of the base of a\n * root of a suffix (`//`, `C:\\`), and the extension of `/..` in `parse`, the suite\n * keeps what the rest of Node's calls say.\n */\nexport const pathSuite = (\n  name: string,\n  path: Path,\n  { reference, cwd, kind }: { reference: ReferencePath; cwd: string; kind: 'posix' | 'win32' }\n): void => {\n  const inputs = kind === 'posix' ? POSIX : WIN32\n  describe(`${name}, a Path of ${kind}`, () => {\n    it.each(inputs)('takes %j apart as the reference does', (input) => {\n      expect(path.normalize(input)).toBe(reference.normalize(input))\n      expect(path.dirname(input)).toBe(reference.dirname(input))\n      expect(path.basename(input)).toBe(reference.basename(input))\n      // Node's gives a root as a base of a suffix, and none without one: the suite takes none.\n      if (!['//', 'C:\\\\', 'C:/'].includes(input))\n        expect(path.basename(input, '.c')).toBe(reference.basename(input, '.c'))\n      expect(path.extname(input)).toBe(reference.extname(input))\n      expect(path.isAbsolute(input)).toBe(reference.isAbsolute(input))\n      if (input !== '/..') {\n        expect(path.parse(input)).toEqual({ ...reference.parse(input) })\n        expect(path.format(path.parse(input))).toBe(reference.format(reference.parse(input)))\n      }\n    })\n\n    it.each(inputs)('joins, resolves and relates %j to each as the reference does', (input) => {\n      for (const other of inputs) {\n        expect(path.join(input, other)).toBe(reference.join(input, other))\n        expect(path.resolve(input, other)).toBe(reference.resolve(cwd, input, other))\n        expect(path.relative(input, other)).toBe(\n          reference.relative(reference.resolve(cwd, input), reference.resolve(cwd, other))\n        )\n      }\n    })\n\n    it('gives the file URL of a path, and the path of it', () => {\n      const file = kind === 'posix' ? '/a b/c#d?e%f' : 'C:\\\\a b\\\\c#d?e%f'\n      const url = path.toFileUrl(file)\n      expect(url.protocol).toBe('file:')\n      expect(url.pathname).toMatch(/a%20b\\/c%23d%3Fe%25f$/)\n      expect(path.fromFileUrl(url)).toBe(file)\n    })\n\n    it('refuses a URL that is no file URL, as a BadArgument', () => {\n      expect(() => path.fromFileUrl('https://example.com/a')).toThrow(BadArgument)\n    })\n  })\n}\n\n/** A promise, and what resolves it. */\nconst deferred = () => Promise.withResolvers<void>()\n\n/** That locks are held as the Web Locks API holds them. */\nexport const locksSuite = (name: string, make: () => LockManager): void => {\n  describe(`${name}, Locks`, () => {\n    it('runs a request holding the lock, and gives what its callback gave', async () => {\n      const locks = make()\n      expect(\n        await locks.request('a', (lock) => lock && { name: lock.name, mode: lock.mode })\n      ).toEqual({\n        name: 'a',\n        mode: 'exclusive'\n      })\n      expect(await locks.request('a', async () => 3)).toBe(3)\n    })\n\n    it('runs exclusive requests one at a time, in order', async () => {\n      const locks = make()\n      const order: string[] = []\n      const first = deferred()\n      const one = locks.request('suite-a', async () => {\n        order.push('one')\n        await first.promise\n        order.push('one done')\n      })\n      const two = locks.request('suite-a', () => order.push('two'))\n      await locks.request('suite-b', () => order.push('other'))\n      expect(order).toEqual(['one', 'other'])\n      first.resolve()\n      await Promise.all([one, two])\n      expect(order).toEqual(['one', 'other', 'one done', 'two'])\n    })\n\n    it('holds a shared lock with others that share it, and an exclusive one waits', async () => {\n      const locks = make()\n      const held = deferred()\n      const order: string[] = []\n      const a = locks.request('suite-s', { mode: 'shared' }, () =>\n        held.promise.then(() => order.push('a'))\n      )\n      await locks.request('suite-s', { mode: 'shared' }, () => order.push('b'))\n      const c = locks.request('suite-s', () => order.push('c'))\n      expect(order).toEqual(['b'])\n      held.resolve()\n      await Promise.all([a, c])\n      expect(order).toEqual(['b', 'a', 'c'])\n    })\n\n    it('gives null at once, if it is not available', async () => {\n      const locks = make()\n      const held = deferred()\n      const holding = locks.request('suite-i', () => held.promise)\n      expect(await locks.request('suite-i', { ifAvailable: true }, (lock) => lock)).toBeNull()\n      held.resolve()\n      await holding\n    })\n\n    it('says the locks held and asked for', async () => {\n      const locks = make()\n      const held = deferred()\n      const holding = locks.request('suite-q', () => held.promise)\n      const waiting = locks.request('suite-q', { mode: 'shared' }, () => 0)\n      const { held: holders = [], pending = [] } = await locks.query()\n      expect(holders.filter((each) => each.name === 'suite-q').map(({ mode }) => mode)).toEqual([\n        'exclusive'\n      ])\n      expect(pending.filter((each) => each.name === 'suite-q').map(({ mode }) => mode)).toEqual([\n        'shared'\n      ])\n      held.resolve()\n      await Promise.all([holding, waiting])\n    })\n\n    it('refuse a name that starts with -, as a NotSupportedError', async () => {\n      await expect(make().request('-reserved', () => 0)).rejects.toMatchObject({\n        name: 'NotSupportedError'\n      })\n    })\n\n    it('rejects a wait aborted, and releases a lock its callback threw in', async () => {\n      const locks = make()\n      const reason = new Error('stop')\n      const held = deferred()\n      const holding = locks.request('suite-r', () => held.promise)\n      const stop = new AbortController()\n      const waiting = locks.request('suite-r', { signal: stop.signal }, () => 1)\n      stop.abort(reason)\n      await expect(waiting).rejects.toBe(reason)\n      held.resolve()\n      await holding\n      await expect(\n        locks.request('suite-r', () => {\n          throw reason\n        })\n      ).rejects.toBe(reason)\n      expect(await locks.request('suite-r', () => 'free')).toBe('free')\n    })\n  })\n}\n\n/** The next message of a target. */\nconst nextOf = (target: {\n  addEventListener(type: 'message', listener: (event: MessageEvent) => void): void\n}) =>\n  new Promise<unknown>((resolve) => target.addEventListener('message', ({ data }) => resolve(data)))\n\n/** That channels of a name give a message to each other, not to the one that posted it. */\nexport const broadcastChannelSuite = (\n  name: string,\n  BroadcastChannel: BroadcastChannelConstructor\n): void => {\n  describe(`${name}, a BroadcastChannel`, () => {\n    it('gives a message to each other channel of the name, and not to itself', async () => {\n      const [a, b, c] = [\n        new BroadcastChannel('suite'),\n        new BroadcastChannel('suite'),\n        new BroadcastChannel('suite')\n      ]\n      const own: unknown[] = []\n      a.addEventListener('message', ({ data }) => own.push(data))\n      const [toB, toC] = [nextOf(b), nextOf(c)]\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin\n      a.postMessage('hello')\n      expect(await Promise.all([toB, toC])).toEqual(['hello', 'hello'])\n      expect(own).toEqual([])\n      for (const each of [a, b, c]) each.close()\n    })\n\n    it('gives nothing to a listener removed, nor to a channel of another name', async () => {\n      const [a, b, other] = [\n        new BroadcastChannel('suite-r'),\n        new BroadcastChannel('suite-r'),\n        new BroadcastChannel('suite-other')\n      ]\n      const seen: unknown[] = []\n      const listener = ({ data }: MessageEvent) => seen.push(data)\n      b.addEventListener('message', listener)\n      b.removeEventListener('message', listener)\n      other.addEventListener('message', listener)\n      const last = nextOf(b)\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin\n      a.postMessage('one')\n      await last\n      expect(seen).toEqual([])\n      for (const each of [a, b, other]) each.close()\n    })\n\n    it('gives each a copy, by structuredClone, and refuses what cannot be copied', async () => {\n      const [a, b] = [new BroadcastChannel('suite-c'), new BroadcastChannel('suite-c')]\n      const sent = { list: [1, 2], when: new Date(0) }\n      const received = nextOf(b)\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin\n      a.postMessage(sent)\n      const copy = await received\n      expect(copy).toEqual(sent)\n      expect(copy).not.toBe(sent)\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin\n      expect(() => a.postMessage(() => {})).toThrow(\n        expect.objectContaining({ name: 'DataCloneError' })\n      )\n      for (const each of [a, b]) each.close()\n    })\n\n    it('refuses a post to a channel closed, as an InvalidStateError', () => {\n      const a = new BroadcastChannel('suite-closed')\n      a.close()\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a channel's post takes no origin\n      expect(() => a.postMessage('late')).toThrow(\n        expect.objectContaining({ name: 'InvalidStateError' })\n      )\n    })\n  })\n}\n\n/**\n * That workers of `url`, a script that posts back each message it is given, are given and post\n * messages as a `Worker` is: a copy of each, its transferables moved, until it is terminated.\n */\nexport const workerSuite = (name: string, Worker: WorkerConstructor, url: URL | string): void => {\n  describe(`${name}, a Worker`, () => {\n    it('gives the script a copy of a message, and is given what it posts', async () => {\n      const worker = new Worker(url)\n      const sent = { list: [1, 2] }\n      const echoed = nextOf(worker)\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a worker's post takes no origin\n      worker.postMessage(sent)\n      expect(await echoed).toEqual(sent)\n      worker.terminate()\n    })\n\n    it('moves what is transferred', async () => {\n      const worker = new Worker(url)\n      const buffer = new Uint8Array([1, 2, 3]).buffer\n      const echoed = nextOf(worker)\n      // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a worker's post takes no origin\n      worker.postMessage(buffer, [buffer])\n      expect(buffer.byteLength).toBe(0)\n      expect(new Uint8Array((await echoed) as ArrayBuffer)).toEqual(new Uint8Array([1, 2, 3]))\n      worker.terminate()\n    })\n  })\n}\n\n/** The members of a {@link Platform}, of the web standards and our own. */\nconst MEMBERS = [\n  'setTimeout',\n  'clearTimeout',\n  'performance',\n  'crypto',\n  'console',\n  'navigator',\n  'BroadcastChannel',\n  'MessageChannel',\n  'Worker',\n  'fetch',\n  'env',\n  'path',\n  'dirs',\n  'terminal',\n  'open'\n] as const satisfies readonly (keyof Platform)[]\n\n/**\n * That a platform is one, whole: each member there, `navigator`'s `locks` and `storage` too; the\n * folder it works in, `dirs.cwd`, an absolute path, which its `path` resolves a relative one\n * against; and the root of its file system, `navigator.storage.getDirectory()`, a folder's handle,\n * the same folder each call, from which a program walks down to a path.\n */\nexport const platformSuite = (name: string, make: () => Platform): void => {\n  describe(`${name}, a Platform`, () => {\n    it('has each member', () => {\n      const platform = make()\n      for (const member of MEMBERS) expect(platform[member], member).toBeDefined()\n      expect(typeof platform.navigator.locks.request).toBe('function')\n      expect(typeof platform.navigator.storage.getDirectory).toBe('function')\n    })\n\n    it('works in the folder of an absolute path, which its paths resolve against', () => {\n      const { dirs, path } = make()\n      expect(path.isAbsolute(dirs.cwd)).toBe(true)\n      expect(path.resolve('a', 'b')).toBe(path.join(dirs.cwd, 'a', 'b'))\n    })\n\n    it('gives the root of its file system, a folder, the same each call', async () => {\n      const { storage } = make().navigator\n      const root = await storage.getDirectory()\n      expect(root.kind).toBe('directory')\n      expect(await root.isSameEntry(await storage.getDirectory())).toBe(true)\n      expect(await root.resolve(root)).toEqual([])\n    })\n  })\n}\n\n/**\n * The program a {@link processSuite} runs, as its command and the arguments before its own: what it\n * does is its next argument.\n *\n * - `cat`: writes what it reads to its stdout, until its stdin ends;\n * - `print <out> <err> <code>`: writes `out` to its stdout and `err` to its stderr, and exits with\n *   `code`;\n * - `env <name>`: writes the variable `name` of its environment, or nothing, of none;\n * - `cwd`: writes the folder it works in;\n * - `wait`: runs until it is ended.\n */\nexport type SuiteProgram = readonly [command: string, ...args: string[]]\n\n/**\n * The {@link SuiteProgram} `program`, as a script of a platform in memory answers it, of the\n * input, the folder and the environment it is run with: a command but `program` it does not\n * answer, as one not there. Its `wait` ends at once, as a script cannot wait; the suite ends one\n * by its signal before its stdin ends.\n */\nexport const suiteScript = (\n  command: string,\n  args: readonly string[],\n  {\n    input,\n    cwd,\n    env\n  }: {\n    readonly input: string\n    readonly cwd: string\n    readonly env: Readonly<Record<string, string>>\n  }\n): { stdout?: string; stderr?: string; code?: number } | undefined => {\n  if (command !== 'program') return undefined\n  const [mode, first = '', second = '', third = '0'] = args\n  if (mode === 'cat') return { stdout: input }\n  if (mode === 'print') return { stdout: first, stderr: second, code: Number(third) }\n  if (mode === 'env') return { stdout: env[first] ?? '' }\n  if (mode === 'cwd') return { stdout: cwd }\n  return {}\n}\n\n/** The text of a stream of bytes, to its end. */\nconst textOf = async (stream: ReadableStream<Uint8Array>): Promise<string> => {\n  const reader = stream.getReader()\n  const decoder = new TextDecoder()\n  let text = ''\n  for (;;) {\n    // oxlint-disable-next-line no-await-in-loop -- a stream is read one chunk at a time\n    const { done, value } = await reader.read()\n    if (done) return text + decoder.decode()\n    text += decoder.decode(value, { stream: true })\n  }\n}\n\n/**\n * That a platform's `spawn` starts processes as `./process` of `@wtf/platform` has them, by\n * `program`, a {@link SuiteProgram}: what it writes, as text, and its code, of `exec`; its input on\n * a stdin that ends, of bytes alone; its outputs and its status as streams and a promise; the\n * environment given, whole, or the platform's; the folder given, or the platform's working folder;\n * a process its signal aborts ended by `SIGTERM`, and one its `kill` sends a signal ended by it; and\n * a command not there a `SystemError` of `NotFound`, of a `spawn` that never throws. `make`\n * gives the platform of an environment. `realpath` gives the real path of a folder, its links\n * followed, as a process reports its working folder: `/private/var/…` of macOS's `/var/…`. A\n * platform of no links, as one in memory, needs none.\n */\nexport const processSuite = (\n  name: string,\n  make: (members: { readonly env: Env }) => ProcessPlatform,\n  program: SuiteProgram,\n  { realpath = (folder: string) => folder }: { readonly realpath?: (folder: string) => string } = {}\n): void => {\n  const [command, ...before] = program\n  const run = (\n    platform: ProcessPlatform,\n    args: readonly string[],\n    options?: Parameters<typeof exec>[3]\n  ) => exec(platform.spawn, command, [...before, ...args], options)\n\n  describe(`${name}, processes`, () => {\n    it('runs a program to its end, and gives what it wrote, as text, and its code', async () => {\n      expect(await run(make({ env: {} }), ['print', 'out ü', 'err', '3'])).toEqual({\n        stdout: 'out ü',\n        stderr: 'err',\n        code: 3\n      })\n      expect(await run(make({ env: {} }), ['print', '', '', '0'])).toEqual({\n        stdout: '',\n        stderr: '',\n        code: 0\n      })\n    })\n\n    it('gives a program its input, and ends its stdin', async () => {\n      const platform = make({ env: {} })\n      expect((await run(platform, ['cat'], { input: 'one\\ntwo ü' })).stdout).toBe('one\\ntwo ü')\n      expect((await run(platform, ['cat'], { input: new Uint8Array([104, 105]) })).stdout).toBe(\n        'hi'\n      )\n      expect((await run(platform, ['cat'])).stdout).toBe('')\n    })\n\n    it('streams what a process reads and writes, and resolves how it ended', async () => {\n      const child = make({ env: {} }).spawn(command, [...before, 'cat'])\n      const writer = child.stdin.getWriter()\n      await writer.write(new TextEncoder().encode('streamed, '))\n      await writer.write(new TextEncoder().encode('in parts'))\n      await writer.close()\n      const [stdout, stderr, status] = await Promise.all([\n        textOf(child.stdout),\n        textOf(child.stderr),\n        child.status\n      ])\n      expect({ stdout, stderr, status }).toEqual({\n        stdout: 'streamed, in parts',\n        stderr: '',\n        status: { code: 0 }\n      })\n    })\n\n    it('gives a process the environment given, whole, or else the platform’s', async () => {\n      const platform = make({ env: { SUITE_PLATFORM: 'platform', SUITE_UNSET: undefined } })\n      expect((await run(platform, ['env', 'SUITE_PLATFORM'])).stdout).toBe('platform')\n      expect((await run(platform, ['env', 'SUITE_UNSET'])).stdout).toBe('')\n      const env = { SUITE_GIVEN: 'given' }\n      expect((await run(platform, ['env', 'SUITE_GIVEN'], { env })).stdout).toBe('given')\n      expect((await run(platform, ['env', 'SUITE_PLATFORM'], { env })).stdout).toBe('')\n    })\n\n    it('runs a process in the folder given, or else the platform’s working folder', async () => {\n      const platform = make({ env: {} })\n      expect((await run(platform, ['cwd'])).stdout).toBe(realpath(platform.dirs.cwd))\n      const cwd = platform.dirs.temp\n      expect((await run(platform, ['cwd'], { cwd })).stdout).toBe(realpath(cwd))\n    })\n\n    it('ends a process its signal aborts, by SIGTERM, of the code a shell gives it', async () => {\n      const stop = new AbortController()\n      const child = make({ env: {} }).spawn(command, [...before, 'wait'], { signal: stop.signal })\n      stop.abort()\n      const [status] = await Promise.all([child.status, textOf(child.stdout), textOf(child.stderr)])\n      expect(status).toEqual({ code: 143, signal: 'SIGTERM' })\n      const reason = new Error('stop')\n      await expect(\n        run(make({ env: {} }), ['cat'], { signal: AbortSignal.abort(reason) })\n      ).rejects.toBe(reason)\n    })\n\n    it('sends a process a signal by kill, SIGTERM by default, and the status says it', async () => {\n      const platform = make({ env: {} })\n      const ended = async (signal?: ProcessSignal) => {\n        const child = platform.spawn(command, [...before, 'wait'])\n        child.kill(signal)\n        const [status] = await Promise.all([\n          child.status,\n          textOf(child.stdout),\n          textOf(child.stderr)\n        ])\n        return status\n      }\n      expect(await ended('SIGKILL')).toEqual({ code: 137, signal: 'SIGKILL' })\n      expect(await ended()).toEqual({ code: 143, signal: 'SIGTERM' })\n    })\n\n    it('sends a process that has ended nothing, and refuses a name of no signal', async () => {\n      const child = make({ env: {} }).spawn(command, [...before, 'print', 'out', '', '2'])\n      await child.stdin.close()\n      const [status] = await Promise.all([child.status, textOf(child.stdout), textOf(child.stderr)])\n      child.kill('SIGKILL')\n      expect(await child.status).toEqual(status)\n      expect(status).toEqual({ code: 2 })\n      expect(() => child.kill('SIGNOPE' as ProcessSignal)).toThrow(BadArgument)\n    })\n\n    it('refuses a chunk of stdin that is no bytes, and ends the process’s input', async () => {\n      const child = make({ env: {} }).spawn(command, [...before, 'cat'])\n      const writer = child.stdin.getWriter()\n      await writer.write(new TextEncoder().encode('before '))\n      await expect(writer.write('text' as unknown as Uint8Array)).rejects.toThrow(TypeError)\n      await expect(writer.closed).rejects.toThrow(TypeError)\n      const [stdout, status] = await Promise.all([\n        textOf(child.stdout),\n        child.status,\n        textOf(child.stderr)\n      ])\n      expect({ stdout, status }).toEqual({ stdout: 'before ', status: { code: 0 } })\n    })\n\n    it('rejects a command not there, as a SystemError of NotFound', async () => {\n      await expect(\n        exec(make({ env: {} }).spawn, 'platform-suite-no-such-command', [])\n      ).rejects.toMatchObject({ _tag: 'SystemError', reason: 'NotFound', module: 'Process' })\n    })\n\n    it('gives a process that could not start, and never throws: its outputs end', async () => {\n      const child = make({ env: {} }).spawn('platform-suite-no-such-command', [])\n      // Its input ends, as exec ends it: of a process that never started, it may refuse to.\n      await child.stdin.close().catch(() => {})\n      expect(await textOf(child.stdout)).toBe('')\n      expect(await textOf(child.stderr)).toBe('')\n      await expect(child.status).rejects.toMatchObject({ _tag: 'SystemError', reason: 'NotFound' })\n      expect(() => child.kill()).not.toThrow()\n    })\n  })\n}\n"]}

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@wtf/platform-suite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "The test suites every implementation of a @wtf/platform member passes, for Vitest: hold your own timers, crypto, path, locks, channels, workers, spawn or whole platform to them, so it behaves as Node's, a page's, the memory platform and the test doubles do.",
+  "homepage": "https://gitlab.com/wetryfun/platform/platform/-/tree/main/packages/platform-suite",
+  "bugs": {
+    "url": "https://gitlab.com/wetryfun/platform/platform/-/issues"
+  },
+  "license": "MIT",
+  "author": "Mikael Karon <mikael@karon.se>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/wetryfun/platform/platform.git",
+    "directory": "packages/platform-suite"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./suites": {
+      "types": "./dist/suites.d.ts",
+      "default": "./dist/suites.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@wtf/platform": "2.0.0"
+  },
+  "devDependencies": {
+    "vitest": "5.1.0"
+  },
+  "peerDependencies": {
+    "vitest": "^5.0.0"
+  }
+}