@quiesco/ui 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quiesco contributors
+
+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,21 @@
-# Temporary Holding Version
+# @quiesco/ui
 
-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 UI behind `quiesco ui`: run tests from the browser and watch them live — the test tree, run all /
+a file / a test with a click, progress per device, failures with Quiesco's evidence (screenshot with the
+asserted element outlined, element tree, idle state, logs), console output and the test's source. In
+English, 简体中文 and 日本語, dark or light.
+
+```sh
+npm i -D @quiesco/ui
+npx quiesco ui --platform web
+```
+
+The CLI loads this package; it is not used directly. Works with cucumber-js, Vitest (add `quiescoPlugin()`
+from `@quiesco/vitest/config`) and Jest (the `@quiesco/jest` preset). Served on 127.0.0.1 only, behind a
+token. Details: [test UI](https://shift-14cc7601.mintlify.site/ui).
+
+Part of [Quiesco](https://github.com/h2nology/quiesco): gray-box end-to-end testing for Expo apps on iOS, Android and the web. Setup: `npx quiesco init` ([quick start](https://github.com/h2nology/quiesco#quick-start-web-about-10-minutes)).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @quiesco/ui: the test UI behind `quiesco ui` — run tests from the browser and watch them live.
+ * The CLI loads it; it is not meant to be used directly.
+ */
+export { startUiServer } from './server.js';
+export type { UiServer, UiServerOptions } from './server.js';
+export { spawnRun } from './spawn.js';
+export type { RunHandle, SpawnRunOptions } from './spawn.js';
+export { targetArgs } from './targets.js';
+export type { RunTarget } from './targets.js';
+export type { ClientMessage, NoticeCode, RunningInfo, ServerMessage, UiInfo } from './messages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * @quiesco/ui: the test UI behind `quiesco ui` — run tests from the browser and watch them live.
+ * The CLI loads it; it is not meant to be used directly.
+ */
+export { startUiServer } from './server.js';
+export { spawnRun } from './spawn.js';
+export { targetArgs } from './targets.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Messages between the `quiesco ui` server and the browser, over a WebSocket at `/ws` (JSON, one
+ * message per frame). Types only: the web app imports them too.
+ */
+import type { RunStateSnapshot } from '@quiesco/core/run-state';
+import type { RunEvent, RunnerName, TestList } from '@quiesco/protocol';
+import type { RunTarget } from './targets.js';
+export type { RunTarget };
+export interface UiInfo {
+    /** The project directory's name. */
+    project: string;
+    runner: RunnerName;
+    platform: string;
+    /** Version of @quiesco/ui. */
+    version: string;
+}
+export type ServerMessage = 
+/** First message on a connection, with everything needed to draw the page. */
+{
+    type: 'welcome';
+    info: UiInfo;
+    list: TestList | null;
+    listing: boolean;
+    state: RunStateSnapshot;
+    running: RunningInfo | null;
+    output: string;
+}
+/** Listing the tests started (`listing: true`) or finished (with the list). */
+ | {
+    type: 'list';
+    list: TestList | null;
+    listing: boolean;
+}
+/** A run event from the runner (apply it to the RunState). */
+ | {
+    type: 'event';
+    event: RunEvent;
+}
+/** A run started (`running` set) or ended (`running: null`, the final state). */
+ | {
+    type: 'run';
+    running: RunningInfo | null;
+    exitCode?: number;
+    state?: RunStateSnapshot;
+}
+/** The runner's own output (stdout / stderr). */
+ | {
+    type: 'output';
+    stream: 'stdout' | 'stderr';
+    text: string;
+}
+/** `code` lets the page show the notice in its language; `message` is the English text. */
+ | {
+    type: 'notice';
+    level: 'info' | 'error';
+    code?: NoticeCode;
+    message: string;
+};
+export type NoticeCode = 'busy' | 'unknown-tests';
+export interface RunningInfo {
+    target: RunTarget;
+    /** The runner arguments chosen for the target. */
+    args: string[];
+    startedAt: number;
+}
+export type ClientMessage = {
+    type: 'run';
+    target: RunTarget;
+} | {
+    type: 'cancel';
+} | {
+    type: 'list';
+};
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,MAAM;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa;AACvB,8EAA8E;AAC5E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAClJ,+EAA+E;GAC7E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AAC3D,8DAA8D;GAC5D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE;AACpC,iFAAiF;GAC/E;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE;AAC3F,iDAAiD;GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC/D,2FAA2F;GACzF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,eAAe,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+import type { RunnerName, TestList } from '@quiesco/protocol';
+import type { RunHandle } from './spawn.js';
+export interface UiServerOptions {
+    cwd: string;
+    runner: RunnerName;
+    platform: string;
+    /** Start the runner with `args` added (the target) and `env` added (QUIESCO_EVENTS). */
+    startRun(args: string[], env: Record<string, string>, onOutput: (stream: 'stdout' | 'stderr', text: string) => void): RunHandle;
+    listTests(): Promise<TestList>;
+    /** Absolute path of the artifacts directory (evidence files). */
+    artifactsDir: string;
+    /** The built web app; null serves a minimal page (tests of the server). */
+    staticDir: string | null;
+    port?: number;
+    host?: string;
+    token?: string;
+}
+export interface UiServer {
+    readonly url: string;
+    readonly port: number;
+    readonly token: string;
+    close(): Promise<void>;
+}
+export declare function startUiServer(options: UiServerOptions): Promise<UiServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAY,UAAU,EAAE,QAAQ,EAAW,MAAM,mBAAmB,CAAC;AAKjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,CAAC;IAChI,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAwCD,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiO/E"}

package/dist/server.js

@@ -0,0 +1,289 @@
+/**
+ * The `quiesco ui` server (P5): serves the web app, lists the tests, runs what the browser asks for
+ * (one run at a time: one device), and streams the run events to every open page.
+ *
+ * Local only: it listens on 127.0.0.1, refuses other Host / Origin headers (DNS rebinding) and requires
+ * the token from the URL it prints (kept in a cookie after the first page load). Files are served only
+ * from the artifacts directory (evidence) and the listed test files (source view).
+ */
+import { randomBytes } from 'node:crypto';
+import fs from 'node:fs';
+import http from 'node:http';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { RunEventServer, RunState } from '@quiesco/core';
+import { WebSocketServer } from 'ws';
+import { targetArgs } from './targets.js';
+const OUTPUT_KEEP = 200_000;
+const COOKIE = 'quiesco_ui';
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.woff2': 'font/woff2',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.json': 'application/json; charset=utf-8',
+    '.ico': 'image/x-icon',
+};
+/** Evidence and source files: media as such, everything else as plain text (never HTML: no script). */
+function fileType(file) {
+    const ext = path.extname(file).toLowerCase();
+    return ['.png', '.jpg', '.jpeg', '.webp', '.mp4', '.webm', '.json'].includes(ext) ? MIME[ext] : 'text/plain; charset=utf-8';
+}
+function version() {
+    return createRequire(import.meta.url)('../package.json').version;
+}
+/** `child` is `root` or inside it, after resolving symlinks. */
+function inside(root, child) {
+    try {
+        const r = fs.realpathSync(root);
+        const c = fs.realpathSync(child);
+        return c === r || c.startsWith(r + path.sep);
+    }
+    catch {
+        return false;
+    }
+}
+export async function startUiServer(options) {
+    const host = options.host ?? '127.0.0.1';
+    const token = options.token ?? randomBytes(16).toString('hex');
+    const info = { project: path.basename(options.cwd), runner: options.runner, platform: options.platform, version: version() };
+    const state = new RunState();
+    const clients = new Set();
+    let list = null;
+    let listing = false;
+    let relistQueued = false;
+    let running = null;
+    let handle = null;
+    let output = '';
+    let port = 0;
+    const send = (ws, m) => {
+        if (ws.readyState === ws.OPEN)
+            ws.send(JSON.stringify(m));
+    };
+    const broadcast = (m) => {
+        const data = JSON.stringify(m);
+        for (const ws of clients)
+            if (ws.readyState === ws.OPEN)
+                ws.send(data);
+    };
+    /**
+     * Running chosen tests: Vitest and Jest report the other tests of their files as skipped (filtered
+     * out). Those reports are dropped, so a test keeps its last real result, and the total is the
+     * number of chosen tests.
+     */
+    let chosen = null;
+    const filtered = (event) => {
+        if (chosen === null)
+            return event;
+        if (event.type === 'run:start' || event.type === 'total:update')
+            return { ...event, total: chosen.size, totalIsEstimate: false };
+        if ((event.type === 'test:start' || event.type === 'test:end') && !chosen.has(event.test.id)) {
+            if (event.type === 'test:start' || event.status === 'skipped')
+                return null;
+        }
+        return event;
+    };
+    const events = new RunEventServer({
+        onEvent: (raw) => {
+            const event = filtered(raw);
+            if (event === null)
+                return;
+            state.apply(event);
+            broadcast({ type: 'event', event });
+        },
+    });
+    await events.listen();
+    const knownTests = () => {
+        const m = new Map();
+        for (const t of list?.tests ?? [])
+            m.set(t.id, t);
+        for (const t of state.tests.values())
+            m.set(t.test.id, { ...m.get(t.test.id), ...t.test });
+        return m;
+    };
+    const relist = async () => {
+        if (listing || running !== null) {
+            relistQueued = true;
+            return;
+        }
+        listing = true;
+        broadcast({ type: 'list', list, listing: true });
+        try {
+            list = await options.listTests();
+        }
+        catch (e) {
+            list = { runner: options.runner, files: [], tests: [], errors: [{ message: e.message }] };
+        }
+        listing = false;
+        broadcast({ type: 'list', list, listing: false });
+        watchFiles();
+    };
+    const run = (target) => {
+        if (running !== null)
+            return { code: 'busy', message: 'A run is already in progress (one device: one run at a time).' };
+        let args;
+        try {
+            args = targetArgs(options.runner, target, knownTests());
+        }
+        catch (e) {
+            return { code: 'unknown-tests', message: e.message };
+        }
+        output = '';
+        chosen = target.kind === 'tests' ? new Set(target.ids) : null;
+        running = { target, args, startedAt: Date.now() };
+        broadcast({ type: 'run', running });
+        const h = options.startRun(args, events.env(), (stream, text) => {
+            output = (output + text).slice(-OUTPUT_KEEP);
+            broadcast({ type: 'output', stream, text });
+        });
+        handle = h;
+        void h.exited.then(async (code) => {
+            await events.drain();
+            state.runnerExited(code);
+            running = null;
+            handle = null;
+            broadcast({ type: 'run', running: null, exitCode: code, state: state.snapshot() });
+            if (relistQueued) {
+                relistQueued = false;
+                void relist();
+            }
+        });
+        return null;
+    };
+    // Test files changed: list again (debounced).
+    let watchers = [];
+    let relistTimer = null;
+    function watchFiles() {
+        for (const w of watchers)
+            w.close();
+        watchers = [];
+        const dirs = new Set((list?.files ?? []).map((f) => path.dirname(path.resolve(options.cwd, f))));
+        for (const dir of dirs) {
+            try {
+                const w = fs.watch(dir, () => {
+                    if (relistTimer !== null)
+                        clearTimeout(relistTimer);
+                    relistTimer = setTimeout(() => void relist(), 400);
+                });
+                w.unref();
+                watchers.push(w);
+            }
+            catch {
+                // A directory that went away: the next listing drops it.
+            }
+        }
+    }
+    const allowedHost = (h) => h !== undefined && [`127.0.0.1:${port}`, `localhost:${port}`, `[::1]:${port}`].includes(h);
+    const cookieToken = (req) => /(?:^|;\s*)quiesco_ui=([0-9a-f]+)/.exec(req.headers.cookie ?? '')?.[1];
+    const httpServer = http.createServer((req, res) => {
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? host}`);
+        const headers = { 'X-Content-Type-Options': 'nosniff', 'Referrer-Policy': 'no-referrer', 'Cache-Control': 'no-store' };
+        if (!allowedHost(req.headers.host)) {
+            res.writeHead(403, headers).end('Forbidden host');
+            return;
+        }
+        const queryToken = url.searchParams.get('token');
+        const authorized = queryToken === token || cookieToken(req) === token;
+        if (!authorized) {
+            res.writeHead(401, { ...headers, 'Content-Type': 'text/plain; charset=utf-8' }).end('Open the URL quiesco ui printed (it carries the token).');
+            return;
+        }
+        const setCookie = queryToken === token ? { 'Set-Cookie': `${COOKIE}=${token}; HttpOnly; SameSite=Strict; Path=/` } : {};
+        if (url.pathname === '/api/file' || url.pathname === '/api/source') {
+            const p = url.searchParams.get('path') ?? '';
+            const file = path.resolve(options.cwd, p);
+            const ok = url.pathname === '/api/file'
+                ? inside(options.artifactsDir, file)
+                : (list?.files ?? []).some((f) => path.resolve(options.cwd, f) === file) && inside(options.cwd, file);
+            if (!ok || !fs.existsSync(file) || !fs.statSync(file).isFile()) {
+                res.writeHead(404, headers).end('Not found');
+                return;
+            }
+            res.writeHead(200, { ...headers, 'Content-Type': fileType(file), 'Content-Security-Policy': "default-src 'none'; img-src 'self'; media-src 'self'; style-src 'unsafe-inline'" });
+            fs.createReadStream(file).pipe(res);
+            return;
+        }
+        const csp = `default-src 'self'; connect-src 'self' ws://${req.headers.host}; img-src 'self' data: blob:; media-src 'self'; style-src 'self' 'unsafe-inline'; font-src 'self'; frame-ancestors 'none'`;
+        if (options.staticDir === null) {
+            res.writeHead(200, { ...headers, ...setCookie, 'Content-Type': 'text/html; charset=utf-8', 'Content-Security-Policy': csp }).end('<!doctype html><title>Quiesco</title><p>Quiesco UI</p>');
+            return;
+        }
+        const rel = decodeURIComponent(url.pathname).replace(/^\/+/, '');
+        let file = path.join(options.staticDir, rel === '' ? 'index.html' : rel);
+        if (!inside(options.staticDir, file) || !fs.existsSync(file) || fs.statSync(file).isDirectory())
+            file = path.join(options.staticDir, 'index.html');
+        const type = MIME[path.extname(file).toLowerCase()] ?? 'application/octet-stream';
+        res.writeHead(200, { ...headers, ...setCookie, 'Content-Type': type, 'Content-Security-Policy': csp });
+        fs.createReadStream(file).pipe(res);
+    });
+    const wss = new WebSocketServer({ noServer: true, maxPayload: 64 * 1024 });
+    httpServer.on('upgrade', (req, socket, head) => {
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? host}`);
+        const origin = req.headers.origin;
+        const originOk = origin === undefined || [`http://127.0.0.1:${port}`, `http://localhost:${port}`, `http://[::1]:${port}`].includes(origin);
+        const tokenOk = url.searchParams.get('token') === token || cookieToken(req) === token;
+        if (url.pathname !== '/ws' || !allowedHost(req.headers.host) || !originOk || !tokenOk) {
+            socket.write('HTTP/1.1 403 Forbidden\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        wss.handleUpgrade(req, socket, head, (ws) => {
+            clients.add(ws);
+            ws.on('close', () => clients.delete(ws));
+            ws.on('message', (data) => {
+                let m;
+                try {
+                    m = JSON.parse(String(data));
+                }
+                catch {
+                    return;
+                }
+                if (m.type === 'run') {
+                    const problem = run(m.target);
+                    if (problem !== null)
+                        send(ws, { type: 'notice', level: 'error', ...problem });
+                }
+                else if (m.type === 'cancel') {
+                    handle?.stop();
+                }
+                else if (m.type === 'list') {
+                    void relist();
+                }
+            });
+            send(ws, { type: 'welcome', info, list, listing, state: state.snapshot(), running, output });
+        });
+    });
+    await new Promise((resolve, reject) => {
+        httpServer.once('error', reject);
+        httpServer.listen(options.port ?? 0, host, () => resolve());
+    });
+    port = httpServer.address().port;
+    void relist();
+    return {
+        url: `http://${host === '127.0.0.1' ? '127.0.0.1' : host}:${port}/?token=${token}`,
+        port,
+        token,
+        async close() {
+            handle?.stop(2000);
+            if (handle !== null)
+                await handle.exited;
+            for (const w of watchers)
+                w.close();
+            if (relistTimer !== null)
+                clearTimeout(relistTimer);
+            for (const ws of clients)
+                ws.terminate();
+            wss.close();
+            await new Promise((resolve) => httpServer.close(() => resolve()));
+            await events.close();
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/spawn.d.ts

@@ -0,0 +1,13 @@
+export interface RunHandle {
+    /** Resolves with the exit code (130 when stopped with SIGINT). */
+    readonly exited: Promise<number>;
+    /** Ctrl-C to the whole process tree; SIGKILL after `graceMs` if it is still there. */
+    stop(graceMs?: number): void;
+}
+export interface SpawnRunOptions {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    onOutput: (stream: 'stdout' | 'stderr', text: string) => void;
+}
+export declare function spawnRun(command: string, args: readonly string[], options: SpawnRunOptions): RunHandle;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,sFAAsF;IACtF,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,CA8BtG"}

package/dist/spawn.js

@@ -0,0 +1,42 @@
+/**
+ * Start a test run as a child process: its output to a callback, stoppable as a whole (the runner runs
+ * under npx, so stopping must reach the runner and its workers, not only npx).
+ */
+import { spawn } from 'node:child_process';
+const isWindows = process.platform === 'win32';
+export function spawnRun(command, args, options) {
+    // Its own process group (POSIX), so stop() reaches npx, the runner and its workers.
+    const child = spawn(command, [...args], { cwd: options.cwd, env: options.env, stdio: ['ignore', 'pipe', 'pipe'], detached: !isWindows, shell: isWindows });
+    child.stdout.setEncoding('utf8').on('data', (t) => options.onOutput('stdout', t));
+    child.stderr.setEncoding('utf8').on('data', (t) => options.onOutput('stderr', t));
+    const exited = new Promise((resolve) => {
+        child.on('error', (e) => {
+            options.onOutput('stderr', `${e.message}\n`);
+            resolve(127);
+        });
+        child.on('close', (code, signal) => resolve(code ?? (signal === 'SIGINT' ? 130 : signal !== null ? 143 : 1)));
+    });
+    const signal = (s) => {
+        if (child.pid === undefined || child.exitCode !== null || child.signalCode !== null)
+            return;
+        try {
+            if (isWindows)
+                spawn('taskkill', ['/pid', String(child.pid), '/T', ...(s === 'SIGKILL' ? ['/F'] : [])]);
+            else
+                process.kill(-child.pid, s);
+        }
+        catch {
+            // Already gone.
+        }
+    };
+    return {
+        exited,
+        stop(graceMs = 10_000) {
+            signal('SIGINT');
+            const timer = setTimeout(() => signal('SIGKILL'), graceMs);
+            timer.unref();
+            void exited.then(() => clearTimeout(timer));
+        },
+    };
+}
+//# sourceMappingURL=spawn.js.map

package/dist/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAe3C,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAE/C,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAuB,EAAE,OAAwB;IACzF,oFAAoF;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3J,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1F,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC7C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChH,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,CAAiB,EAAE,EAAE;QACnC,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAAE,OAAO;QAC5F,IAAI,CAAC;YACH,IAAI,SAAS;gBAAE,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;;gBACnG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC,CAAC;IACF,OAAO;QACL,MAAM;QACN,IAAI,CAAC,OAAO,GAAG,MAAM;YACnB,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;YAC3D,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/targets.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What to run, as runner arguments (findings P0): the UI asks for all tests, one file, or some tests;
+ * each runner selects them its own way.
+ *
+ * - cucumber: `file:line[:line…]` (a Scenario line, or an Examples row's line). NOTE: cucumber-js adds
+ *   command line paths to the `paths` of its config instead of replacing them, so a config with `paths`
+ *   runs more than asked (Quiesco's init no longer writes `paths`).
+ * - vitest: `file:line` (a `test.each` line runs every row).
+ * - jest: `--runTestsByPath <files>` and `-t '^(full name|…)$'` (titles joined with spaces; Jest matches
+ *   case-insensitively, so a test with the same name in another chosen file runs too).
+ */
+import type { RunnerName, TestRef } from '@quiesco/protocol';
+export type RunTarget = {
+    kind: 'all';
+} | {
+    kind: 'file';
+    file: string;
+} | {
+    kind: 'tests';
+    ids: readonly string[];
+};
+/** Runner arguments selecting `target`; `tests` resolves test ids to their file and line. */
+export declare function targetArgs(runner: RunnerName, target: RunTarget, tests: ReadonlyMap<string, TestRef>): string[];
+//# sourceMappingURL=targets.d.ts.map

package/dist/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAIrH,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CA4B/G"}

package/dist/targets.js

@@ -0,0 +1,37 @@
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/** Runner arguments selecting `target`; `tests` resolves test ids to their file and line. */
+export function targetArgs(runner, target, tests) {
+    if (target.kind === 'all')
+        return [];
+    if (target.kind === 'file')
+        return runner === 'jest' ? ['--runTestsByPath', target.file] : [target.file];
+    const refs = target.ids.flatMap((id) => {
+        const t = tests.get(id);
+        return t !== undefined ? [t] : [];
+    });
+    if (refs.length === 0)
+        throw new Error('none of the chosen tests is known (list the tests again)');
+    const byFile = new Map();
+    for (const t of refs)
+        byFile.set(t.file, [...(byFile.get(t.file) ?? []), t]);
+    if (runner === 'jest') {
+        const names = [...new Set(refs.map((t) => escapeRegExp(t.path.join(' '))))];
+        return ['--runTestsByPath', ...byFile.keys(), '-t', `^(${names.join('|')})$`];
+    }
+    const out = [];
+    for (const [file, ts] of byFile) {
+        const lines = [...new Set(ts.flatMap((t) => (t.line !== undefined ? [t.line] : [])))].sort((a, b) => a - b);
+        if (lines.length === 0 || lines.length < ts.length) {
+            out.push(file); // a test without a line: the whole file
+        }
+        else if (runner === 'cucumber') {
+            out.push(`${file}:${lines.join(':')}`);
+        }
+        else {
+            for (const l of lines)
+                out.push(`${file}:${l}`);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=targets.js.map