@react-x11/components 0.1.0 → 0.2.0

package/dist/embed/host.js

@@ -0,0 +1,266 @@
+// The operating system, as an interface — because `<Terminal>` and
+// `<MediaPlayer>` are the first things in this package that run somebody
+// else's program.
+//
+// Two reasons this is an interface and not five `import`s:
+//
+//  1. **`src/` may not name node's types.** `tsconfig.build.json` sets
+//     `types: []` on purpose, so a `process` or a `Buffer` in a shipped module
+//     fails the build rather than becoming an `@types/node` dependency a
+//     consumer has to satisfy. The slice of `child_process`, `fs`, `net` and
+//     `os` used here is therefore written out structurally and reached
+//     through a dynamic `import()` with a specifier built at run time —
+//     exactly what `../desktop-calendar/ical.ts` does for `ical.js`, and what
+//     react-x11 does for `dbus-native`.
+//  2. **It is the seam the components are tested through.** A fake host
+//     records argv and hands back a process that never existed, which is the
+//     only way to assert "xterm would have been spawned with `-into 42`"
+//     without an xterm. It is public rather than private because the same
+//     seam is what an app needs to run the child somewhere else — inside a
+//     container, over ssh, under a sandbox — and none of that should require
+//     forking the component.
+import { delay } from './timers.js';
+/**
+ * Load a node builtin without naming it to the compiler.
+ *
+ * The specifier is a variable on purpose: a literal `import('node:net')`
+ * would need `@types/node` in the build program, which is the thing
+ * `tsconfig.build.json` refuses. It also keeps a bundler from trying to
+ * resolve a node builtin for a target that has none.
+ */
+const builtins = new Map();
+function builtin(name) {
+    let mod = builtins.get(name);
+    if (!mod) {
+        const specifier = name;
+        mod = import(/* @vite-ignore */ specifier);
+        builtins.set(name, mod);
+    }
+    return mod;
+}
+/** `process`, if there is one. `globalThis` because `process` is not typed. */
+function nodeProcess() {
+    const g = globalThis;
+    return g.process ?? null;
+}
+/** Executable-by-anyone, `fs.constants.X_OK`. Spelled out rather than read
+ *  off the module, which would be a second await for a constant that is 1 on
+ *  every platform this package can run on. */
+const X_OK = 1;
+/** Thrown when a control socket does not appear. */
+export class IpcConnectError extends Error {
+    constructor(path, cause) {
+        super(`@react-x11/components: could not connect to ${path}`, { cause });
+        this.name = 'IpcConnectError';
+    }
+}
+class NodeSpawnedProcess {
+    #child;
+    constructor(child) {
+        this.#child = child;
+    }
+    get pid() {
+        return this.#child.pid ?? null;
+    }
+    kill(signal = 'SIGTERM') {
+        if (this.#child.killed)
+            return false;
+        try {
+            return this.#child.kill(signal);
+        }
+        catch {
+            // already reaped, or a pid we no longer own
+            return false;
+        }
+    }
+    onExit(listener) {
+        this.#child.on('exit', (code, signal) => listener({ code, signal }));
+    }
+    onError(listener) {
+        this.#child.on('error', listener);
+    }
+}
+class NodeIpcSocket {
+    #socket;
+    #closed = false;
+    constructor(socket) {
+        this.#socket = socket;
+        socket.setEncoding('utf8');
+    }
+    write(data) {
+        if (this.#closed)
+            return;
+        try {
+            this.#socket.write(data);
+        }
+        catch {
+            // the player exited between the last event and this command
+        }
+    }
+    onData(listener) {
+        this.#socket.on('data', (chunk) => listener(String(chunk)));
+    }
+    onClose(listener) {
+        const fire = () => {
+            if (this.#closed)
+                return;
+            this.#closed = true;
+            listener();
+        };
+        this.#socket.on('close', fire);
+        // a socket that errors also closes, but not before something has
+        // listened for `error` — an unhandled one on a node socket throws
+        this.#socket.on('error', () => { });
+    }
+    close() {
+        this.#closed = true;
+        try {
+            this.#socket.end();
+            this.#socket.destroy();
+        }
+        catch {
+            // already gone
+        }
+    }
+}
+let sharedHost = null;
+/**
+ * The real one: node's `child_process`, `fs`, `net` and `os`.
+ *
+ * Cached, because it holds nothing per-caller and the module loads it does are
+ * worth doing once. An app that wants a *different* host (a container, a
+ * remote shell) passes it as the `processes` prop instead of replacing this.
+ */
+export function nodeProcessHost() {
+    if (sharedHost)
+        return sharedHost;
+    const host = {
+        environment() {
+            return nodeProcess()?.env ?? {};
+        },
+        async which(command) {
+            if (!command)
+                return null;
+            const path = await builtin('node:path');
+            const fs = await builtin('node:fs/promises');
+            const runnable = async (candidate) => {
+                try {
+                    await fs.access(candidate, X_OK);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            };
+            // A path, not a name: PATH is not consulted, exactly as a shell would
+            // not consult it.
+            if (command.includes('/')) {
+                return (await runnable(command)) ? command : null;
+            }
+            const search = host.environment().PATH ?? '';
+            for (const dir of search.split(':')) {
+                if (!dir)
+                    continue;
+                const candidate = path.join(dir, command);
+                if (await runnable(candidate))
+                    return candidate;
+            }
+            return null;
+        },
+        async spawn(command, args, options = {}) {
+            const cp = await builtin('node:child_process');
+            const env = options.env
+                ? { ...host.environment(), ...options.env }
+                : undefined;
+            const child = cp.spawn(command, args, {
+                cwd: options.cwd,
+                env,
+                // The child draws into an X window; its stdio is not ours to show,
+                // and an inherited one would interleave with the app's own output.
+                // A pipe nobody reads fills and blocks the child, which is worse.
+                stdio: 'ignore',
+            });
+            return new NodeSpawnedProcess(child);
+        },
+        async socketPath(prefix) {
+            const [os, path, fs] = await Promise.all([
+                builtin('node:os'),
+                builtin('node:path'),
+                builtin('node:fs/promises'),
+            ]);
+            const dir = await fs.mkdtemp(path.join(os.tmpdir(), `${prefix}-`));
+            return {
+                // The directory is what is private, not the socket: a unix socket's
+                // own mode is not honoured on every kernel, and a predictable path in
+                // a shared /tmp is how another user gets a command channel to the
+                // player.
+                path: path.join(dir, 'sock'),
+                async dispose() {
+                    try {
+                        await fs.rm(dir, { recursive: true, force: true });
+                    }
+                    catch {
+                        // /tmp is allowed to have been cleaned already
+                    }
+                },
+            };
+        },
+        async connect(socketPath) {
+            const net = await builtin('node:net');
+            return new Promise((resolve, reject) => {
+                let socket;
+                try {
+                    socket = net.createConnection({ path: socketPath });
+                }
+                catch (err) {
+                    reject(new IpcConnectError(socketPath, err));
+                    return;
+                }
+                const onConnect = () => {
+                    socket.removeListener('error', onError);
+                    resolve(new NodeIpcSocket(socket));
+                };
+                const onError = (err) => {
+                    socket.removeListener('connect', onConnect);
+                    try {
+                        socket.destroy();
+                    }
+                    catch {
+                        // nothing to close
+                    }
+                    reject(new IpcConnectError(socketPath, err));
+                };
+                socket.once('connect', onConnect);
+                socket.once('error', onError);
+            });
+        },
+    };
+    sharedHost = host;
+    return host;
+}
+/**
+ * Retry `connect` until the child has created its socket.
+ *
+ * Every player here is given a socket path and creates it *itself*, some
+ * milliseconds after it starts — so the first connect always loses the race,
+ * and "the socket is not there yet" and "the player failed to start" look
+ * identical for that window. Polling with a deadline is what separates them.
+ */
+export async function connectWhenReady(host, path, options = {}) {
+    const { timeoutMs = 5000, intervalMs = 50 } = options;
+    const deadline = Date.now() + timeoutMs;
+    let last;
+    for (;;) {
+        try {
+            return await host.connect(path);
+        }
+        catch (err) {
+            last = err;
+            if (Date.now() >= deadline)
+                break;
+            await delay(intervalMs);
+        }
+    }
+    throw last instanceof Error ? last : new IpcConnectError(path, last);
+}
+//# sourceMappingURL=host.js.map

package/dist/embed/host.js.map

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

package/dist/embed/index.d.ts

@@ -0,0 +1,5 @@
+export { BackendUnavailableError, resolveBackend, useEmbeddedClient, } from './client.js';
+export type { EmbedStatus, EmbeddedClient, LaunchPlan, PlanContext, PlanFactory, UseEmbeddedClientOptions, } from './client.js';
+export { IpcConnectError, connectWhenReady, nodeProcessHost } from './host.js';
+export type { ExitInfo, IpcSocket, ProcessHost, ScratchSocket, SpawnOptions, SpawnedProcess, } from './host.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/embed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embed/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC"}

package/dist/embed/index.js

@@ -0,0 +1,13 @@
+// `@react-x11/components/embed` — running somebody else's program inside a
+// `<foreign>`, without the vocabulary of any particular program.
+//
+// A **shared module**, not a component: it registers no element, renders
+// nothing at import time, and exists because `<Terminal>` and `<MediaPlayer>`
+// are the same lifecycle with different argv (AGENTS.md, "Shared modules are
+// directories too"). It is exported rather than kept private for two
+// reasons — `ProcessHost` is the seam an app needs to run the child somewhere
+// else (a container, an ssh host, a sandbox), and a fourth wrapper around some
+// other `-into WID` program should not have to copy this file to exist.
+export { BackendUnavailableError, resolveBackend, useEmbeddedClient, } from './client.js';
+export { IpcConnectError, connectWhenReady, nodeProcessHost } from './host.js';
+//# sourceMappingURL=index.js.map

package/dist/embed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embed/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,6EAA6E;AAC7E,qEAAqE;AACrE,8EAA8E;AAC9E,+EAA+E;AAC/E,wEAAwE;AACxE,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAUrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/embed/timers.d.ts

@@ -0,0 +1,6 @@
+export type TimerId = unknown;
+export declare function startTimeout(fn: () => void, ms: number): TimerId;
+export declare function stopTimeout(id: TimerId): void;
+/** `await delay(50)` — the polling half of `connectWhenReady`. */
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=timers.d.ts.map

package/dist/embed/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/embed/timers.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC;AAE9B,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED,kEAAkE;AAClE,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C"}

package/dist/embed/timers.js

@@ -0,0 +1,16 @@
+const g = globalThis;
+export function startTimeout(fn, ms) {
+    return g.setTimeout?.(fn, ms) ?? null;
+}
+export function stopTimeout(id) {
+    if (id != null)
+        g.clearTimeout?.(id);
+}
+/** `await delay(50)` — the polling half of `connectWhenReady`. */
+export function delay(ms) {
+    return new Promise((resolve) => {
+        if (!startTimeout(() => resolve(), ms))
+            resolve();
+    });
+}
+//# sourceMappingURL=timers.js.map

package/dist/embed/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../src/embed/timers.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,GAAG,UAA0B,CAAC;AAIrC,MAAM,UAAU,YAAY,CAAC,EAAc,EAAE,EAAU;IACrD,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAW;IACrC,IAAI,EAAE,IAAI,IAAI;QAAE,CAAC,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/flow/draw.d.ts

@@ -0,0 +1,45 @@
+import type { FlowPainter, TextOptions } from './types.js';
+interface LayoutLike {
+    width: number;
+    height: number;
+    draw(ctx: unknown, x: number, y: number): void;
+}
+/** One shaped string, kept between frames. */
+export interface CachedText {
+    width: number;
+    height: number;
+    layout: LayoutLike;
+}
+/** ntk's font cache, reached through `app.fonts`. */
+export interface FontsLike {
+    layout(content: string | Array<Record<string, unknown>>, style: Record<string, unknown>, options?: Record<string, unknown>): LayoutLike;
+}
+export interface PainterOptions {
+    fonts: FontsLike | null;
+    /** The face unstyled text comes out in — the theme's `fontFamily`. */
+    family: string;
+    /** Ink for text that names no colour. */
+    color: string;
+    /**
+     * Laid-out text, keyed by face, size, weight, colour and the string.
+     *
+     * Owned by the pane rather than the painter because a painter lives for
+     * one repaint and a label does not change between them. The *layout* is
+     * cached rather than only its width because shaping is the expensive half
+     * and a `LayoutLike` can be drawn as many times as you like: a graph of
+     * three hundred labels was shaping three hundred strings a frame, which
+     * no amount of batching on the wire would have fixed.
+     */
+    cache: Map<string, CachedText>;
+}
+export declare function measureText(opts: PainterOptions, text: string, options?: TextOptions): {
+    width: number;
+    height: number;
+};
+/**
+ * A painter over this context, or `null` when the backend cannot draw paths
+ * — which is the signal to skip drawing entirely rather than to throw.
+ */
+export declare function createPainter(ctx: unknown, options: PainterOptions): FlowPainter | null;
+export {};
+//# sourceMappingURL=draw.d.ts.map

package/dist/flow/draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draw.d.ts","sourceRoot":"","sources":["../../src/flow/draw.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,WAAW,EAGX,WAAW,EAEZ,MAAM,YAAY,CAAC;AA0BpB,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,MAAM,CACJ,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAChD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,UAAU,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;OASG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAChC;AAwDD,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,WAAW,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CASnC;AAgQD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,cAAc,GACtB,WAAW,GAAG,IAAI,CAGpB"}