@design.estate/wcctools 6.1.0 → 7.0.0

package/dist_ts/classes.hostpolicy.js

@@ -0,0 +1,171 @@
+import * as plugins from './plugins.js';
+/** The interface address `wcctools dev` listens on unless told otherwise. */
+export const defaultListenHost = '127.0.0.1';
+/** The hostnames every dev server answers: the loopback names. */
+const loopbackHostnames = ['localhost', '127.0.0.1', '::1'];
+const wildcardHosts = new Set(['0.0.0.0', '::']);
+/** Methods that never change state, which the Origin check leaves to the Host check alone. */
+const safeMethods = new Set(['GET', 'HEAD', 'OPTIONS']);
+/** Canonical form of a hostname: lower case, IPv6 without brackets, no trailing dot. */
+export const normalizeHostname = (hostnameArg) => {
+    let hostname = hostnameArg.trim().toLowerCase();
+    if (hostname.startsWith('[') && hostname.endsWith(']')) {
+        hostname = hostname.slice(1, -1);
+    }
+    if (hostname.endsWith('.') && hostname.length > 1) {
+        hostname = hostname.slice(0, -1);
+    }
+    return hostname;
+};
+/** Whether the address is the wildcard address of all interfaces. */
+export const isWildcardHost = (hostArg) => wildcardHosts.has(normalizeHostname(hostArg));
+/** Whether a peer address is a loopback address (IPv4, IPv6 or IPv4-mapped IPv6). */
+export const isLoopbackAddress = (addressArg) => {
+    const address = normalizeHostname(addressArg);
+    return address === '::1' || address.startsWith('127.') || address.startsWith('::ffff:127.');
+};
+/** A hostname as it appears in a URL: IPv6 addresses in brackets. */
+export const formatUrlHost = (hostnameArg) => {
+    return hostnameArg.includes(':') ? `[${hostnameArg}]` : hostnameArg;
+};
+/** An invalid `--host` or `--allowed-host` value. */
+export class WccHostPolicyError extends Error {
+    constructor(messageArg) {
+        super(messageArg);
+        this.name = 'WccHostPolicyError';
+    }
+}
+/**
+ * Who may talk to a `wcctools dev` server. The server listens on loopback unless told otherwise
+ * and answers only the hostnames it serves: the loopback names, the address it listens on, the
+ * machine's interface addresses when it listens on all of them, and the hosts allowed explicitly.
+ * Every other Host is refused, which defeats DNS rebinding. Requests that can change state
+ * (any method but GET, HEAD and OPTIONS) and WebSocket connections are further admitted only from
+ * the server's own origin, so other web pages cannot drive the API; a request without an Origin
+ * is admitted only from a loopback peer (local tools, such as the CLI and tests).
+ */
+export class WccHostPolicy {
+    /** The canonical hostnames the server answers. */
+    allowedHostnames;
+    listenHost;
+    port = null;
+    constructor(optionsArg) {
+        this.listenHost = WccHostPolicy.parseHost(optionsArg.listenHost);
+        const hostnames = new Set(loopbackHostnames);
+        if (isWildcardHost(this.listenHost)) {
+            for (const address of WccHostPolicy.getInterfaceAddresses()) {
+                hostnames.add(address);
+            }
+        }
+        else {
+            hostnames.add(this.listenHost);
+        }
+        for (const host of optionsArg.allowedHosts ?? []) {
+            hostnames.add(WccHostPolicy.parseHost(host));
+        }
+        this.allowedHostnames = hostnames;
+    }
+    /** A hostname or address, as a URL would carry it; anything else is refused. */
+    static parseHost(hostArg) {
+        const hostname = normalizeHostname(hostArg);
+        let parsed = null;
+        try {
+            parsed = normalizeHostname(new URL(`http://${formatUrlHost(hostname)}/`).hostname);
+        }
+        catch {
+            parsed = null;
+        }
+        if (!hostname || parsed !== hostname) {
+            throw new WccHostPolicyError(`wcctools: "${hostArg}" is not a hostname or address.`);
+        }
+        return hostname;
+    }
+    /** Every address of the machine's network interfaces. */
+    static getInterfaceAddresses() {
+        const addresses = [];
+        for (const interfaceAddresses of Object.values(plugins.os.networkInterfaces())) {
+            for (const interfaceAddress of interfaceAddresses ?? []) {
+                addresses.push(normalizeHostname(interfaceAddress.address));
+            }
+        }
+        return addresses;
+    }
+    /** The port the server listens on, once it does: origins are compared against it. */
+    setPort(portArg) {
+        this.port = portArg;
+    }
+    /**
+     * The host the server's own tools reach it on: the loopback address when it listens on all
+     * interfaces or on loopback, otherwise the address it listens on.
+     */
+    getLocalHost() {
+        if (isWildcardHost(this.listenHost) || isLoopbackAddress(this.listenHost)) {
+            return '127.0.0.1';
+        }
+        return this.listenHost;
+    }
+    /** The host shown to the user: `localhost` for a loopback or all-interface server. */
+    getDisplayHost() {
+        if (isWildcardHost(this.listenHost) || isLoopbackAddress(this.listenHost) || this.listenHost === 'localhost') {
+            return 'localhost';
+        }
+        return this.listenHost;
+    }
+    /** Server-wide HTTP and WebSocket admission: the Host must be one the server answers. */
+    admitHost = (contextArg) => {
+        const hostname = normalizeHostname(contextArg.url.hostname);
+        if (this.allowedHostnames.has(hostname)) {
+            return true;
+        }
+        return this.refuse(`wcctools: the dev server does not answer the host "${hostname}". Open it on localhost, or restart it with --allowed-host ${hostname}.`);
+    };
+    /** Surface HTTP admission: a request that can change state must come from the server's origin. */
+    admitRequestOrigin = (contextArg) => {
+        if (safeMethods.has(contextArg.method)) {
+            return true;
+        }
+        return this.admitOrigin(contextArg);
+    };
+    /** Surface WebSocket admission: a connection must come from the server's origin. */
+    admitWebsocketOrigin = (contextArg) => {
+        return this.admitOrigin(contextArg);
+    };
+    /** Whether an Origin header names this server: http, an allowed host and the server's port. */
+    isOwnOrigin(originArg) {
+        if (this.port === null) {
+            return false;
+        }
+        let origin;
+        try {
+            origin = new URL(originArg);
+        }
+        catch {
+            return false;
+        }
+        const port = origin.port === '' ? 80 : Number(origin.port);
+        return origin.protocol === 'http:'
+            && port === this.port
+            && this.allowedHostnames.has(normalizeHostname(origin.hostname));
+    }
+    admitOrigin(contextArg) {
+        const origin = contextArg.headers.get('origin');
+        if (origin === null) {
+            const peer = contextArg.connectionInfo?.remoteAddr ?? 'unknown';
+            if (isLoopbackAddress(peer)) {
+                return true;
+            }
+            return this.refuse('wcctools: requests without an Origin are admitted only from this machine.');
+        }
+        if (this.isOwnOrigin(origin)) {
+            return true;
+        }
+        return this.refuse(`wcctools: requests from the origin "${origin}" are not admitted.`);
+    }
+    refuse(messageArg) {
+        return new Response(`${messageArg}\n`, {
+            status: 403,
+            headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5ob3N0cG9saWN5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xhc3Nlcy5ob3N0cG9saWN5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBS3hDLDZFQUE2RTtBQUM3RSxNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxXQUFXLENBQUM7QUFFN0Msa0VBQWtFO0FBQ2xFLE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxXQUFXLEVBQUUsV0FBVyxFQUFFLEtBQUssQ0FBQyxDQUFDO0FBRTVELE1BQU0sYUFBYSxHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsU0FBUyxFQUFFLElBQUksQ0FBQyxDQUFDLENBQUM7QUFFakQsOEZBQThGO0FBQzlGLE1BQU0sV0FBVyxHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsS0FBSyxFQUFFLE1BQU0sRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFDO0FBRXhELHdGQUF3RjtBQUN4RixNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxDQUFDLFdBQW1CLEVBQVUsRUFBRTtJQUMvRCxJQUFJLFFBQVEsR0FBRyxXQUFXLENBQUMsSUFBSSxFQUFFLENBQUMsV0FBVyxFQUFFLENBQUM7SUFDaEQsSUFBSSxRQUFRLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxJQUFJLFFBQVEsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUN2RCxRQUFRLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUNuQyxDQUFDO0lBQ0QsSUFBSSxRQUFRLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxJQUFJLFFBQVEsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDbEQsUUFBUSxHQUFHLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFD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

package/dist_ts/cli.js

@@ -1,6 +1,9 @@
 import * as plugins from './plugins.js';
 import { commitinfo } from './00_commitinfo_data.js';
 import { WccDevServer } from './classes.devserver.js';
+import { WccHostPolicyError } from './classes.hostpolicy.js';
+import { WccCaptureRequestError } from './capture/index.js';
+import { registerScreenshotCommand } from './cli.screenshot.js';
 import { StandardConfigError, StandardUsageError, registerStandardCommands } from './standards/index.js';
 /**
  * Registers the wcctools commands on the given console.
@@ -19,12 +22,32 @@ export const registerCommands = (out) => {
                 type: 'number',
                 description: 'Port to listen on (0 picks a free port); overrides the tswatch configuration',
             },
+            host: {
+                type: 'string',
+                description: 'Interface address to listen on (default 127.0.0.1, this machine only; 0.0.0.0 for every interface)',
+            },
+            allowedHost: {
+                type: 'strings',
+                description: 'A further hostname or address the server answers, besides localhost and the listen address (repeatable)',
+            },
         },
     }, async ({ options }) => {
-        const devServer = new WccDevServer({ port: options.port });
+        const devServer = new WccDevServer({
+            port: options.port,
+            cwd: process.cwd(),
+            host: options.host,
+            allowedHosts: options.allowedHost,
+        });
+        // The entry point owns process signals: SIGINT and SIGTERM run every registered cleanup, the
+        // dev server's stop among them, once within tswatch's shutdown deadline, then exit.
+        plugins.smartexit.ProcessLifecycle.install({ shutdownTimeoutMs: devServer.getShutdownTimeoutMs() });
         const address = await devServer.start();
         await out.log(`wcctools dev: ${address.url}`);
+        if (address.host !== '127.0.0.1' && address.host !== '::1' && address.host !== 'localhost') {
+            await out.log(`wcctools dev: listening on ${address.host}, answering the hosts ${address.allowedHosts.join(', ')}`);
+        }
     });
+    registerScreenshotCommand(out);
     registerStandardCommands(out);
     out.cli.default({}, async () => {
         await out.log(out.cli.renderHelp());
@@ -41,11 +64,13 @@ export const runCli = async () => {
         // Configuration and usage errors exit with 2, every other failure with 1.
         const usageError = error instanceof plugins.smartconsole.CliUsageError
             || error instanceof StandardConfigError
-            || error instanceof StandardUsageError;
+            || error instanceof StandardUsageError
+            || error instanceof WccCaptureRequestError
+            || error instanceof WccHostPolicyError;
         process.exitCode = usageError ? 2 : 1;
     }
     finally {
         await out.dispose();
     }
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xpLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDdEQsT0FBTyxFQUFFLG1CQUFtQixFQUFFLGtCQUFrQixFQUFFLHdCQUF3QixFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFFekc7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLEdBQXNDLEVBQVEsRUFBRTtJQUMvRSxHQUFHLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQztRQUNoQixJQUFJLEVBQUUsVUFBVTtRQUNoQixPQUFPLEVBQUUsVUFBVSxDQUFDLE9BQU87UUFDM0IsV0FBVyxFQUFFLHVEQUF1RDtLQUNyRSxDQUFDLENBQUM7SUFFSCxHQUFHLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQztRQUNkLElBQUksRUFBRSxLQUFLO1FBQ1gsV0FBVyxFQUFFLHdFQUF3RTtRQUNyRixPQUFPLEVBQUU7WUFDUCxJQUFJLEVBQUU7Z0JBQ0osSUFBSSxFQUFFLFFBQVE7Z0JBQ2QsV0FBVyxFQUFFLDhFQUE4RTthQUM1RjtTQUNGO0tBQ0YsRUFBRSxLQUFLLEVBQUUsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3ZCLE1BQU0sU0FBUyxHQUFHLElBQUksWUFBWSxDQUFDLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQzNELE1BQU0sT0FBTyxHQUFHLE1BQU0sU0FBUyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3hDLE1BQU0sR0FBRyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUM7SUFDaEQsQ0FBQyxDQUFDLENBQUM7SUFFSCx3QkFBd0IsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUU5QixHQUFHLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxFQUFFLEVBQUUsS0FBSyxJQUFJLEVBQUU7UUFDN0IsTUFBTSxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsVUFBVSxFQUFFLENBQUMsQ0FBQztJQUN0QyxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxLQUFLLElBQUksRUFBRTtJQUMvQixNQUFNLEdBQUcsR0FBRyxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxFQUFFLENBQUM7SUFDcEQsSUFBSSxDQUFDO1FBQ0gsZ0JBQWdCLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDdEIsTUFBTSxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDO0lBQ3RCLENBQUM7SUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1FBQ2YsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLEtBQUssWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQ3hFLDBFQUEwRTtRQUMxRSxNQUFNLFVBQVUsR0FBRyxLQUFLLFlBQVksT0FBTyxDQUFDLFlBQVksQ0FBQyxhQUFhO2VBQ2pFLEtBQUssWUFBWSxtQkFBbUI7ZUFDcEMsS0FBSyxZQUFZLGtCQUFrQixDQUFDO1FBQ3pDLE9BQU8sQ0FBQyxRQUFRLEdBQUcsVUFBVSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUN4QyxDQUFDO1lBQVMsQ0FBQztRQUNULE1BQU0sR0FBRyxDQUFDLE9BQU8sRUFBRSxDQUFDO0lBQ3RCLENBQUM7QUFDSCxDQUFDLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xpLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDdEQsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDN0QsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDNUQsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDaEUsT0FBTyxFQUFFLG1CQUFtQixFQUFFLGtCQUFrQixFQUFFLHdCQUF3QixFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFFekc7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLEdBQXNDLEVBQVEsRUFBRTtJQUMvRSxHQUFHLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQztRQUNoQixJQUFJLEVBQUUsVUFBVTtRQUNoQixPQUFPLEVBQUUsVUFBVSxDQUFDLE9BQU87UUFDM0IsV0FBVyxFQUFFLHVEQUF1RDtLQUNyRSxDQUFDLENBQUM7SUFFSCxHQUFHLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQztRQUNkLElBQUksRUFBRSxLQUFLO1FBQ1gsV0FBVyxFQUFFLHdFQUF3RTtRQUNyRixPQUFPLEVBQUU7WUFDUCxJQUFJLEVBQUU7Z0JBQ0osSUFBSSxFQUFFLFFBQVE7Z0JBQ2QsV0FBVyxFQUFFLDhFQUE4RTthQUM1RjtZQUNELElBQUksRUFBRTtnQkFDSixJQUFJLEVBQUUsUUFBUTtnQkFDZCxXQUFXLEVBQUUsb0dBQW9HO2FBQ2xIO1lBQ0QsV0FBVyxFQUFFO2dCQUNYLElBQUksRUFBRSxTQUFTO2dCQUNmLFdBQVcsRUFBRSx5R0FBeUc7YUFDdkg7U0FDRjtLQUNGLEVBQUUsS0FBSyxFQUFFLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN2QixNQUFNLFNBQVMsR0FBRyxJQUFJLFlBQVksQ0FBQztZQUNqQyxJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7WUFDbEIsR0FBRyxFQUFFLE9BQU8sQ0FBQyxHQUFHLEVBQUU7WUFDbEIsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1lBQ2xCLFlBQVksRUFBRSxPQUFPLENBQUMsV0FBVztTQUNsQyxDQUFDLENBQUM7UUFDSCw2RkFBNkY7UUFDN0Ysb0ZBQW9GO1FBQ3BGLE9BQU8sQ0FBQyxTQUFTLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxDQUFDLEVBQUUsaUJBQWlCLEVBQUUsU0FBUyxDQUFDLG9CQUFvQixFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ3BHLE1BQU0sT0FBTyxHQUFHLE1BQU0sU0FBUyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3hDLE1BQU0sR0FBRyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUM7UUFDOUMsSUFBSSxPQUFPLENBQUMsSUFBSSxLQUFLLFdBQVcsSUFBSSxPQUFPLENBQUMsSUFBSSxLQUFLLEtBQUssSUFBSSxPQUFPLENBQUMsSUFBSSxLQUFLLFdBQVcsRUFBRSxDQUFDO1lBQzNGLE1BQU0sR0FBRyxDQUFDLEdBQUcsQ0FBQyw4QkFBOEIsT0FBTyxDQUFDLElBQUkseUJBQXlCLE9BQU8sQ0FBQyxZQUFZLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUN0SCxDQUFDO0lBQ0gsQ0FBQyxDQUFDLENBQUM7SUFFSCx5QkFBeUIsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUUvQix3QkFBd0IsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUU5QixHQUFHLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxFQUFFLEVBQUUsS0FBSyxJQUFJLEVBQUU7UUFDN0IsTUFBTSxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsVUFBVSxFQUFFLENBQUMsQ0FBQztJQUN0QyxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxLQUFLLElBQUksRUFBRTtJQUMvQixNQUFNLEdBQUcsR0FBRyxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxFQUFFLENBQUM7SUFDcEQsSUFBSSxDQUFDO1FBQ0gsZ0JBQWdCLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDdEIsTUFBTSxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDO0lBQ3RCLENBQUM7SUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1FBQ2YsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLEtBQUssWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQ3hFLDBFQUEwRTtRQUMxRSxNQUFNLFVBQVUsR0FBRyxLQUFLLFlBQVksT0FBTyxDQUFDLFlBQVksQ0FBQyxhQUFhO2VBQ2pFLEtBQUssWUFBWSxtQkFBbUI7ZUFDcEMsS0FBSyxZQUFZLGtCQUFrQjtlQUNuQyxLQUFLLFlBQVksc0JBQXNCO2VBQ3ZDLEtBQUssWUFBWSxrQkFBa0IsQ0FBQztRQUN6QyxPQUFPLENBQUMsUUFBUSxHQUFHLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDeEMsQ0FBQztZQUFTLENBQUM7UUFDVCxNQUFNLEdBQUcsQ0FBQyxPQUFPLEVBQUUsQ0FBQztJQUN0QixDQUFDO0FBQ0gsQ0FBQyxDQUFDIn0=

package/dist_ts/cli.screenshot.d.ts

@@ -0,0 +1,6 @@
+import * as plugins from './plugins.js';
+/**
+ * `wcctools screenshot`: bundles the catalog of the working directory, serves it on a free
+ * loopback port, screenshots one demo in a headless browser, writes the image and stops.
+ */
+export declare const registerScreenshotCommand: (out: plugins.smartconsole.SmartConsole) => void;

package/dist_ts/cli.screenshot.js

@@ -0,0 +1,89 @@
+import * as plugins from './plugins.js';
+import { WccDevServer } from './classes.devserver.js';
+import { WccCaptureRequestError, captureViewportWidths, resolveScreenshotRequest } from './capture/index.js';
+/** Reads `<item>` or `<section>/<item>`. */
+const parseSubject = (argsArg, demoArg) => {
+    if (argsArg.length !== 1 || argsArg[0].trim() === '') {
+        throw new WccCaptureRequestError('wcctools screenshot: name one catalog entry, as <item> or <section>/<item>.');
+    }
+    const [subject] = argsArg;
+    const slash = subject.indexOf('/');
+    const named = slash === -1
+        ? { itemName: subject }
+        : { sectionName: subject.slice(0, slash), itemName: subject.slice(slash + 1) };
+    return demoArg === undefined ? named : { ...named, demoIndex: demoArg };
+};
+/** Reads a named viewport or a width in pixels. */
+const parseViewport = (valueArg) => {
+    if (valueArg === undefined) {
+        return undefined;
+    }
+    if (Object.hasOwn(captureViewportWidths, valueArg)) {
+        return valueArg;
+    }
+    if (/^\d+$/.test(valueArg)) {
+        return Number(valueArg);
+    }
+    throw new WccCaptureRequestError(`wcctools screenshot: --viewport must be one of ${Object.keys(captureViewportWidths).join(', ')} or a width in pixels.`);
+};
+/** The image format the output file's extension names. */
+const formatForFile = (fileArg) => {
+    const extension = plugins.path.extname(fileArg).toLowerCase();
+    if (extension === '.png') {
+        return 'png';
+    }
+    if (extension === '.jpg' || extension === '.jpeg') {
+        return 'jpeg';
+    }
+    throw new WccCaptureRequestError('wcctools screenshot: --out must name a .png, .jpg or .jpeg file.');
+};
+/**
+ * `wcctools screenshot`: bundles the catalog of the working directory, serves it on a free
+ * loopback port, screenshots one demo in a headless browser, writes the image and stops.
+ */
+export const registerScreenshotCommand = (out) => {
+    out.cli.command({
+        name: 'screenshot',
+        description: 'Screenshot one demo of the catalog in a headless browser: wcctools screenshot <item | section/item> --out <file.png>',
+        options: {
+            out: { type: 'string', required: true, description: 'The image file to write; .png, .jpg or .jpeg' },
+            demo: { type: 'number', description: 'The demo to render, counted from 0 as in the shell URL (default 0)' },
+            viewport: { type: 'string', description: `The width: ${Object.entries(captureViewportWidths).map(([nameArg, widthArg]) => `${nameArg} (${widthArg})`).join(', ')} or pixels (default desktop)` },
+            height: { type: 'number', description: 'The height of the preview window in pixels (default 800)' },
+            theme: { type: 'string', description: 'dark or bright (default dark)' },
+            framing: { type: 'string', description: 'element, viewport or fullpage (default element; fullpage for pages)' },
+            scale: { type: 'number', description: 'Device pixel ratio, 1 or 2 (default 1)' },
+            quality: { type: 'number', description: 'JPEG quality from 1 to 100 (default 80)' },
+        },
+    }, async ({ args, options }) => {
+        const format = formatForFile(options.out);
+        const request = {
+            subject: parseSubject(args, options.demo),
+            viewport: parseViewport(options.viewport),
+            height: options.height,
+            theme: options.theme,
+            framing: options.framing,
+            scale: options.scale,
+            format,
+            quality: options.quality,
+        };
+        // Invalid options are refused before anything is bundled
+        resolveScreenshotRequest(request);
+        const outFile = plugins.path.resolve(options.out);
+        const devServer = new WccDevServer({ port: 0, cwd: process.cwd() });
+        // As for `wcctools dev`: SIGINT and SIGTERM stop the server and the capture browser once
+        plugins.smartexit.ProcessLifecycle.install({ shutdownTimeoutMs: devServer.getShutdownTimeoutMs() });
+        let result;
+        try {
+            await devServer.start();
+            result = await devServer.capture.captureScreenshot(request);
+        }
+        finally {
+            await devServer.stop();
+        }
+        await plugins.fs.writeFile(outFile, Buffer.from(result.image.dataBase64, 'base64'));
+        const { selection, image } = result;
+        await out.log(`wcctools screenshot: wrote ${outFile} (${selection.sectionName}/${selection.itemName} demo ${selection.demoIndex}, ${result.framing}, ${image.width}×${image.height}${result.truncated ? ', cut at the maximum height' : ''})`);
+    });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLnNjcmVlbnNob3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGkuc2NyZWVuc2hvdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDdEQsT0FBTyxFQUFFLHNCQUFzQixFQUFFLHFCQUFxQixFQUFFLHdCQUF3QixFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFN0csNENBQTRDO0FBQzVDLE1BQU0sWUFBWSxHQUFHLENBQUMsT0FBMEIsRUFBRSxPQUEyQixFQUF5QyxFQUFFO0lBQ3RILElBQUksT0FBTyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksRUFBRSxLQUFLLEVBQUUsRUFBRSxDQUFDO1FBQ3JELE1BQU0sSUFBSSxzQkFBc0IsQ0FBQyw2RUFBNkUsQ0FBQyxDQUFDO0lBQ2xILENBQUM7SUFDRCxNQUFNLENBQUMsT0FBTyxDQUFDLEdBQUcsT0FBTyxDQUFDO0lBQzFCLE1BQU0sS0FBSyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDbkMsTUFBTSxLQUFLLEdBQTBDLEtBQUssS0FBSyxDQUFDLENBQUM7UUFDL0QsQ0FBQyxDQUFDLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRTtRQUN2QixDQUFDLENBQUMsRUFBRSxXQUFXLEVBQUUsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLEVBQUUsS0FBSyxDQUFDLEVBQUUsUUFBUSxFQUFFLE9BQU8sQ0FBQyxLQUFLLENBQUMsS0FBSyxHQUFHLENBQUMsQ0FBQyxFQUFFLENBQUM7SUFDakYsT0FBTyxPQUFPLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsR0FBRyxLQUFLLEVBQUUsU0FBUyxFQUFFLE9BQU8sRUFB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

package/dist_ts/index.d.ts

@@ -1,3 +1 @@
 export { runCli } from './cli.js';
-export { WccDevServer, type IWccDevServerOptions, type IWccDevServerAddress } from './classes.devserver.js';
-export { WccDevApi } from './classes.devapi.js';

package/dist_ts/index.js

@@ -1,4 +1,2 @@
 export { runCli } from './cli.js';
-export { WccDevServer } from './classes.devserver.js';
-export { WccDevApi } from './classes.devapi.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQ2xDLE9BQU8sRUFBRSxZQUFZLEVBQXdELE1BQU0sd0JBQXdCLENBQUM7QUFDNUcsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHFCQUFxQixDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sVUFBVSxDQUFDIn0=

package/dist_ts/plugins.d.ts

@@ -1,18 +1,22 @@
 import * as childProcess from 'node:child_process';
 import * as fs from 'node:fs/promises';
 import * as fsSync from 'node:fs';
+import * as os from 'node:os';
 import * as path from 'node:path';
 import * as url from 'node:url';
-export { childProcess, fs, fsSync, path, url };
+export { childProcess, fs, fsSync, os, path, url };
 import * as typedrequest from '@api.global/typedrequest';
 import * as typedserver from '@api.global/typedserver';
 export { typedrequest, typedserver };
+import * as deesDomtools from '@design.estate/dees-domtools';
+export { deesDomtools };
 import * as tswatch from '@git.zone/tswatch';
 export { tswatch };
+import * as smartbrowser from '@push.rocks/smartbrowser/automation';
 import * as smartconfig from '@push.rocks/smartconfig';
 import * as smartconsole from '@push.rocks/smartconsole';
 import * as smartexit from '@push.rocks/smartexit';
-export { smartconfig, smartconsole, smartexit };
+export { smartbrowser, smartconfig, smartconsole, smartexit };
 import typescript from 'typescript';
 export { typescript };
 import * as interfaces from '../dist_ts_interfaces/index.js';

package/dist_ts/plugins.js

@@ -2,21 +2,26 @@
 import * as childProcess from 'node:child_process';
 import * as fs from 'node:fs/promises';
 import * as fsSync from 'node:fs';
+import * as os from 'node:os';
 import * as path from 'node:path';
 import * as url from 'node:url';
-export { childProcess, fs, fsSync, path, url };
+export { childProcess, fs, fsSync, os, path, url };
 // @api.global scope
 import * as typedrequest from '@api.global/typedrequest';
 import * as typedserver from '@api.global/typedserver';
 export { typedrequest, typedserver };
+// @design.estate scope
+import * as deesDomtools from '@design.estate/dees-domtools';
+export { deesDomtools };
 // @git.zone scope
 import * as tswatch from '@git.zone/tswatch';
 export { tswatch };
 // @push.rocks scope
+import * as smartbrowser from '@push.rocks/smartbrowser/automation';
 import * as smartconfig from '@push.rocks/smartconfig';
 import * as smartconsole from '@push.rocks/smartconsole';
 import * as smartexit from '@push.rocks/smartexit';
-export { smartconfig, smartconsole, smartexit };
+export { smartbrowser, smartconfig, smartconsole, smartexit };
 // third party scope
 import typescript from 'typescript';
 export { typescript };
@@ -24,4 +29,4 @@ export { typescript };
 import * as interfaces from '../dist_ts_interfaces/index.js';
 import * as shared from '../dist_ts_shared/index.js';
 export { interfaces, shared };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxZQUFZLE1BQU0sb0JBQW9CLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN2QyxPQUFPLEtBQUssTUFBTSxNQUFNLFNBQVMsQ0FBQztBQUNsQyxPQUFPLEtBQUssSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUNsQyxPQUFPLEtBQUssR0FBRyxNQUFNLFVBQVUsQ0FBQztBQUVoQyxPQUFPLEVBQUUsWUFBWSxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLEdBQUcsRUFBRSxDQUFDO0FBRS9DLG9CQUFvQjtBQUNwQixPQUFPLEtBQUssWUFBWSxNQUFNLDBCQUEwQixDQUFDO0FBQ3pELE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFFdkQsT0FBTyxFQUFFLFlBQVksRUFBRSxXQUFXLEVBQUUsQ0FBQztBQUVyQyxrQkFBa0I7QUFDbEIsT0FBTyxLQUFLLE9BQU8sTUFBTSxtQkFBbUIsQ0FBQztBQUU3QyxPQUFPLEVBQUUsT0FBTyxFQUFFLENBQUM7QUFFbkIsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFDdkQsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEtBQUssU0FBUyxNQUFNLHVCQUF1QixDQUFDO0FBRW5ELE9BQU8sRUFBRSxXQUFXLEVBQUUsWUFBWSxFQUFFLFNBQVMsRUFBRSxDQUFDO0FBRWhELG9CQUFvQjtBQUNwQixPQUFPLFVBQVUsTUFBTSxZQUFZLENBQUM7QUFFcEMsT0FBTyxFQUFFLFVBQVUsRUFBRSxDQUFDO0FBRXRCLGdCQUFnQjtBQUNoQixPQUFPLEtBQUssVUFBVSxNQUFNLDJCQUEyQixDQUFDO0FBQ3hELE9BQU8sS0FBSyxNQUFNLE1BQU0sdUJBQXVCLENBQUM7QUFFaEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLEVBQUUsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxZQUFZLE1BQU0sb0JBQW9CLENBQUM7QUFDbkQsT0FBTyxLQUFLLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUN2QyxPQUFPLEtBQUssTUFBTSxNQUFNLFNBQVMsQ0FBQztBQUNsQyxPQUFPLEtBQUssRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUM5QixPQUFPLEtBQUssSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUNsQyxPQUFPLEtBQUssR0FBRyxNQUFNLFVBQVUsQ0FBQztBQUVoQyxPQUFPLEVBQUUsWUFBWSxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxHQUFHLEVBQUUsQ0FBQztBQUVuRCxvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEtBQUssV0FBVyxNQUFNLHlCQUF5QixDQUFDO0FBRXZELE9BQU8sRUFBRSxZQUFZLEVBQUUsV0FBVyxFQUFFLENBQUM7QUFFckMsdUJBQXVCO0FBQ3ZCLE9BQU8sS0FBSyxZQUFZLE1BQU0sOEJBQThCLENBQUM7QUFFN0QsT0FBTyxFQUFFLFlBQVksRUFBRSxDQUFDO0FBRXhCLGtCQUFrQjtBQUNsQixPQUFPLEtBQUssT0FBTyxNQUFNLG1CQUFtQixDQUFDO0FBRTdDLE9BQU8sRUFBRSxPQUFPLEVBQUUsQ0FBQztBQUVuQixvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLFlBQVksTUFBTSxxQ0FBcUMsQ0FBQztBQUNwRSxPQUFPLEtBQUssV0FBVyxNQUFNLHlCQUF5QixDQUFDO0FBQ3ZELE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUVuRCxPQUFPLEVBQUUsWUFBWSxFQUFFLFdBQVcsRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLENBQUM7QUFFOUQsb0JBQW9CO0FBQ3BCLE9BQU8sVUFBVSxNQUFNLFlBQVksQ0FBQztBQUVwQyxPQUFPLEVBQUUsVUFBVSxFQUFFLENBQUM7QUFFdEIsZ0JBQWdCO0FBQ2hCLE9BQU8sS0FBSyxVQUFVLE1BQU0sMkJBQTJCLENBQUM7QUFDeEQsT0FBTyxLQUFLLE1BQU0sTUFBTSx1QkFBdUIsQ0FBQztBQUVoRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxDQUFDIn0=

package/dist_ts_interfaces/capture.d.ts

@@ -0,0 +1,151 @@
+import type { IWccSelection, TWccTheme } from './bridge.js';
+/**
+ * Captures of the catalog's demos: screenshots and interaction frames the `wcctools dev` server
+ * takes in a headless browser, and frames the shell samples from a recording.
+ */
+/** The named capture widths: the dees-domtools breakpoints. */
+export type TWccCaptureViewportPreset = 'phone' | 'phablet' | 'tablet' | 'desktop';
+/** A named capture width, or a width in CSS pixels. */
+export type TWccCaptureViewport = TWccCaptureViewportPreset | number;
+/**
+ * What a capture shows:
+ * - `element`: the rendered instance of the selected element (the first one its demo renders),
+ * - `viewport`: the visible preview at the capture's width and height,
+ * - `fullpage`: the whole preview document.
+ */
+export type TWccCaptureFraming = 'element' | 'viewport' | 'fullpage';
+export type TWccImageMimeType = 'image/png' | 'image/jpeg';
+/** An encoded image. */
+export interface IWccImage {
+    mimeType: TWccImageMimeType;
+    /** Width in device pixels. */
+    width: number;
+    /** Height in device pixels. */
+    height: number;
+    dataBase64: string;
+}
+/** A frame of a recording or of an observed interaction. */
+export interface IWccTimedFrame extends IWccImage {
+    /** Milliseconds since the start of the recording or observation. */
+    timestampMs: number;
+}
+/**
+ * The catalog entry a capture renders. `itemName` is an entry's name or its element's tag;
+ * without `sectionName` it must name exactly one entry across all sections.
+ */
+export interface IWccCaptureSubject {
+    sectionName?: string;
+    itemName: string;
+    /** 0-based demo index; default 0. */
+    demoIndex?: number;
+}
+/** How the headless preview is set up for a capture. */
+export interface IWccCaptureView {
+    /** Default `desktop`. */
+    viewport?: TWccCaptureViewport;
+    /** Height of the preview window in CSS pixels; default 800. */
+    height?: number;
+    /** Default `dark`. */
+    theme?: TWccTheme;
+    /** Device pixel ratio, 1 or 2; default 1. */
+    scale?: 1 | 2;
+}
+export interface IWccScreenshotRequest extends IWccCaptureView {
+    subject: IWccCaptureSubject;
+    /** Default `element` for element demos and `fullpage` for pages. */
+    framing?: TWccCaptureFraming;
+    /** Default `png`. */
+    format?: 'png' | 'jpeg';
+    /** JPEG quality from 1 to 100; default 80. */
+    quality?: number;
+}
+export interface IWccScreenshotResult {
+    /** The demo the subject resolved to. */
+    selection: IWccSelection;
+    framing: TWccCaptureFraming;
+    image: IWccImage;
+    /** True when a full-page capture was cut at the maximum height. */
+    truncated: boolean;
+}
+/**
+ * One step of a scripted interaction. A selector is a CSS selector matched in the preview
+ * document and in every open shadow root below it; the first match in document order is used,
+ * once it is visible and enabled.
+ */
+export type TWccInteractionStep = {
+    action: 'click';
+    selector: string;
+} | {
+    action: 'hover';
+    selector: string;
+}
+/** Replaces the value of an input, textarea, select or contenteditable element. */
+ | {
+    action: 'fill';
+    selector: string;
+    text: string;
+}
+/** Presses a key (`Enter`, `Tab`, `a`, …), on the matched element when a selector is given. */
+ | {
+    action: 'press';
+    key: string;
+    selector?: string;
+}
+/** Waits until a match is visible, or until none is (`hidden`). */
+ | {
+    action: 'waitFor';
+    selector: string;
+    state?: 'visible' | 'hidden';
+}
+/** Observes for a fixed time, for example an animation. */
+ | {
+    action: 'wait';
+    ms: number;
+};
+export interface IWccInteractionRequest extends IWccCaptureView {
+    subject: IWccCaptureSubject;
+    steps: TWccInteractionStep[];
+    /** How long to keep observing after the last step, in milliseconds; default 500. */
+    observeMs?: number;
+    /** The most frames to return, spread over the observation; default 12. */
+    maxFrames?: number;
+    /** JPEG quality of the frames from 1 to 100; default 70. */
+    frameQuality?: number;
+    /** Also take a screenshot once the steps ran, framed as a screenshot request would be. */
+    finalScreenshot?: {
+        framing?: TWccCaptureFraming;
+        format?: 'png' | 'jpeg';
+        quality?: number;
+    };
+}
+export interface IWccInteractionStepResult {
+    index: number;
+    ok: boolean;
+    /** Why the step failed; the steps after a failed one do not run. */
+    error?: string;
+    /** Milliseconds since the start of the observation. */
+    startMs: number;
+    endMs: number;
+}
+export interface IWccInteractionResult {
+    selection: IWccSelection;
+    /** Viewport frames in time order, timestamped from the start of the observation. */
+    frames: IWccTimedFrame[];
+    steps: IWccInteractionStepResult[];
+    /** True when every step ran. */
+    completed: boolean;
+    finalImage?: IWccImage;
+}
+/** How frames are sampled from a recording. */
+export interface IWccFrameSamplingOptions {
+    /** Number of frames, spread evenly over the range; default 8, at most 32. */
+    count?: number;
+    /** Start of the range in seconds; default the start of the recording. */
+    startS?: number;
+    /** End of the range in seconds; default the end of the recording. */
+    endS?: number;
+    /** Frames wider than this are scaled down; default 960. */
+    maxWidth?: number;
+    /** JPEG quality from 0 to 1; default 0.8. */
+    quality?: number;
+}

package/dist_ts_interfaces/capture.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FwdHVyZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvY2FwdHVyZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist_ts_interfaces/index.d.ts

@@ -1,4 +1,5 @@
 export * from './catalog.js';
 export * from './bridge.js';
+export * from './capture.js';
 export * from './requests.js';
 export * from './standard.js';

package/dist_ts_interfaces/index.js

@@ -1,5 +1,6 @@
 export * from './catalog.js';
 export * from './bridge.js';
+export * from './capture.js';
 export * from './requests.js';
 export * from './standard.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsZUFBZSxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsZUFBZSxDQUFDIn0=