@gtkx/vitest 0.20.0 → 1.0.0-rc.1

package/README.md

@@ -1,106 +1,173 @@
 <p align="center">
- <img src="https://raw.githubusercontent.com/eugeniodepalo/gtkx/main/logo.svg" alt="GTKX" width="60" height="60">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/logo.svg" alt="GTKX" width="100" />
 </p>
 
 <h1 align="center">GTKX</h1>
 
 <p align="center">
- <strong>Build native GTK4 desktop applications with React and TypeScript.</strong>
+  The React framework for Linux.<br />
+  Build GTK4 and Adwaita apps in TypeScript, with React components and hooks driving GNOME's own widgets. What you ship is a GNOME app.
 </p>
 
 <p align="center">
- <a href="https://www.npmjs.com/package/@gtkx/react"><img src="https://img.shields.io/npm/v/@gtkx/react.svg" alt="npm version"></a>
- <a href="https://github.com/gtkx-org/gtkx/actions"><img src="https://img.shields.io/github/actions/workflow/status/eugeniodepalo/gtkx/ci.yml" alt="CI"></a>
- <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License"></a>
- <a href="https://github.com/gtkx-org/gtkx/discussions"><img src="https://img.shields.io/badge/discussions-GitHub-blue" alt="GitHub Discussions"></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/v/create-gtkx?color=cb3837&logo=npm&label=create-gtkx" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/create-gtkx"><img src="https://img.shields.io/npm/dm/create-gtkx?color=cb3837&logo=npm&label=downloads" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/node-%E2%89%A524-339933?logo=node.js&logoColor=white" alt="Node >= 24" />
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MPL--2.0-blue.svg" alt="License: MPL-2.0" /></a>
+  <a href="https://github.com/gtkx-org/gtkx/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/gtkx-org/gtkx/ci.yml?branch=main&logo=github&label=CI" alt="CI status" /></a>
+  <img src="https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white" alt="TypeScript" />
+</p>
+
+<p align="center">
+  <a href="https://gtkx.dev">Homepage</a> &middot;
+  <a href="https://gtkx.dev/guide/why-gtkx">Documentation</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/tree/main/examples">Examples</a> &middot;
+  <a href="https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md">Contributing</a>
 </p>
 
 ---
 
-GTKX lets you write Linux desktop applications using React. Your components render as native GTK4 widgets through a Rust FFI bridge—no webviews, no Electron, just native performance with the developer experience you already know.
+GTKX generates fully typed bindings for the entire GTK4 and Adwaita surface directly from GObject-Introspection. On top of those bindings you get the React programming model: components and hooks driving GObject instances, with Fast Refresh while you develop.
 
-## Quick Start
+<p align="center">
+  <img src="https://raw.githubusercontent.com/gtkx-org/gtkx/main/examples/tutorial/assets/screenshot.png" alt="The Tasks app: an Adwaita window with a sidebar of smart views and colored lists on the left, and a boxed task list on the right." />
+</p>
 
-```bash
-npx @gtkx/cli create my-app
-cd my-app
-npm run dev
-```
+<p align="center">
+  <em>The Tasks app you build in the <a href="https://gtkx.dev/tutorial/">tutorial</a>.</em>
+</p>
+
+## Demo
 
-## Example
+The intrinsic elements in this snippet render GTK4 widgets, and ordinary React hooks and events drive them:
 
 ```tsx
-import {
-  GtkApplicationWindow,
-  GtkBox,
-  GtkButton,
-  GtkLabel,
-  quit,
-  render,
-} from "@gtkx/react";
-import * as Gtk from "@gtkx/ffi/gtk";
+import * as Gtk from "@gtkx/gi/gtk";
+import { GtkApplication, GtkApplicationWindow, GtkBox, GtkButton, GtkLabel } from "@gtkx/jsx/gtk";
+import { createRoot, quit } from "@gtkx/react";
 import { useState } from "react";
 
-const App = () => {
+const Counter = () => {
   const [count, setCount] = useState(0);
 
   return (
     <GtkApplicationWindow
-      title="Counter"
-      defaultWidth={300}
-      defaultHeight={200}
-      onClose={quit}
+      title="Hello GTKX"
+      defaultWidth={400}
+      defaultHeight={300}
+      onCloseRequest={quit}
     >
       <GtkBox
         orientation={Gtk.Orientation.VERTICAL}
         spacing={20}
+        marginTop={40}
+        marginBottom={40}
+        marginStart={40}
+        marginEnd={40}
         valign={Gtk.Align.CENTER}
+        halign={Gtk.Align.CENTER}
       >
-        <GtkLabel label={`Count: ${count}`} cssClasses={["title-1"]} />
-        <GtkButton label="Increment" onClicked={() => setCount((c) => c + 1)} />
+        <GtkLabel cssClasses={["title-1"]}>Welcome to GTKX!</GtkLabel>
+        <GtkLabel cssClasses={["title-2"]}>{`Count: ${count}`}</GtkLabel>
+        <GtkButton
+          label="Increment"
+          onClicked={() => setCount((c) => c + 1)}
+          cssClasses={["suggested-action", "pill"]}
+        />
       </GtkBox>
     </GtkApplicationWindow>
   );
 };
 
-render(<App />, "com.example.counter");
+const App = () => (
+  <GtkApplication>
+    <Counter />
+  </GtkApplication>
+);
+
+createRoot().render(<App />);
 ```
 
-## Features
+This is the [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world) example, with `app.tsx` and `index.tsx` combined into a single snippet. `@gtkx/gi` and `@gtkx/jsx` are per-project bindings generated by the CLI, not packages you install from npm.
 
-- **React 19** — Hooks, concurrent features, and the component model you know
-- **Native GTK4 widgets** — Real native controls, not web components in a webview
-- **Adwaita support** — Modern GNOME styling with Libadwaita components
-- **Declarative animations** — Framer Motion-like API using native Adwaita animations
-- **Hot Module Replacement** — Fast refresh during development
-- **TypeScript first** — Full type safety with auto-generated bindings
-- **CSS-in-JS styling** — Familiar styling patterns adapted for GTK
-- **Testing utilities** — Component testing similar to Testing Library
+## Why GTKX
 
-## Examples
+### A declarative layer for the GNOME stack
+
+GTK4 is mature, and GtkBuilder XML can lay out a static interface, but nothing re-renders that interface when your application state changes, and nothing hot-reloads it as you work. GTKX adds that missing layer, and the tooling around it, on top of the stack you already know:
+
+- a React reconciler that exposes every GObject as a JSX element,
+- a CLI for scaffolding, development, and production builds,
+- a dev server with Fast Refresh that patches your running UI in place,
+- CSS-in-JS styling and high-level list, grid, and dialog components,
+- a Testing Library-style API for querying and driving your widgets in tests,
+- and a Model Context Protocol (MCP) server that exposes your live app to AI agents.
+
+### The full GNOME API surface
+
+React Native and similar frameworks hide the native toolkit so one API can run everywhere. GTKX exposes it: GTK4, Adwaita, and any other GObject-Introspection library on your system. Linux-only by design.
+
+### Why Node.js, and why generated bindings
+
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [why-gtkx guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
+
+GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
+
+At runtime, the native Rust core calls straight into the system GTK4, Adwaita, and GLib libraries through libffi, without loading libgirepository at all.
 
-Explore complete applications in the [`examples/`](./examples) directory:
+## Quick start
 
-- **[gtk-demo](./examples/gtk-demo)** — Full replica of the official GTK demo app
-- **[hello-world](./examples/hello-world)** — Minimal application showing a counter
-- **[todo](./examples/todo)** — Full-featured todo application with Adwaita styling and testing
-- **[x-showcase](./examples/x-showcase)** — Showcase of all x.\* virtual components
-- **[browser](./examples/browser)** — Simple browser using WebKitWebView
-- **[deploying](./examples/deploying)** — Example of packaging and distributing a GTKX app
+GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requirements).
+
+Scaffold a new app with the `create-gtkx` initializer:
+
+```sh
+npm create gtkx@rc
+```
+
+The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+
+Then run your new app:
+
+```sh
+cd my-app
+npm run dev
+```
+
+To go further, follow the [tutorial](https://gtkx.dev/tutorial/).
 
 ## Documentation
 
-Visit [https://gtkx.dev](https://gtkx.dev) for the full documentation.
+The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tutorial that builds a complete GNOME app, from scaffolding to packaging and shipping, plus guides and a full API reference.
 
-## Contributing
+**[Read the docs &rarr;](https://gtkx.dev/guide/why-gtkx)**
 
-Contributions are welcome! Please see the [contributing guidelines](./CONTRIBUTING.md) and check out the [good first issues](https://github.com/gtkx-org/gtkx/labels/good%20first%20issue).
+## Requirements
 
-## Community
+GTKX is Linux-only. You need:
+
+- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Node.js 24 or later
+
+The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
+
+## Examples
+
+Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
+
+- [`hello-world`](https://github.com/gtkx-org/gtkx/tree/main/examples/hello-world): the counter above.
+- [`gtk-demo`](https://github.com/gtkx-org/gtkx/tree/main/examples/gtk-demo): a React port of the official GTK4 widget showcase, covering lists, dialogs, gestures, CSS, and OpenGL.
+- [`browser`](https://github.com/gtkx-org/gtkx/tree/main/examples/browser): a WebKitWebView-based web browser.
+- [`tutorial`](https://github.com/gtkx-org/gtkx/tree/main/examples/tutorial): the Tasks app the documentation builds.
+
+## Status
+
+GTKX 1.0 is at the release candidate stage.
+
+## Contributing
 
-- [GitHub Discussions](https://github.com/gtkx-org/gtkx/discussions) — Questions, ideas, and general discussion
-- [Issue Tracker](https://github.com/gtkx-org/gtkx/issues) — Bug reports and feature requests
+Contributions are welcome. See [CONTRIBUTING.md](https://github.com/gtkx-org/gtkx/blob/main/CONTRIBUTING.md), the [Code of Conduct](https://github.com/gtkx-org/gtkx/blob/main/CODE_OF_CONDUCT.md), and the [security policy](https://github.com/gtkx-org/gtkx/blob/main/SECURITY.md). Building the repo needs Node.js 24 or later, pnpm, and a Rust toolchain.
 
 ## License
 
-[MPL-2.0](./LICENSE)
+GTKX is licensed under [MPL-2.0](https://github.com/gtkx-org/gtkx/blob/main/LICENSE).

package/dist/headless-display.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Wayland compositors that can back a headless display.
+ */
+export type CompositorId = "sway" | "weston";
+export declare const DEFAULT_HEADLESS_SIZE = "1024x768";
+/**
+ * Settings for the per-worker headless Wayland display.
+ */
+export type HeadlessOptions = {
+    /** Output resolution as a "WIDTHxHEIGHT" string, for example "1024x768". */
+    size: string;
+    /** Wayland compositor used to back the headless display. */
+    compositor: CompositorId;
+};
+export declare const resolveHeadlessOptions: (provided: Partial<HeadlessOptions>) => HeadlessOptions;
+export declare const readHeadlessOptions: (params: URLSearchParams) => Partial<HeadlessOptions>;
+export declare const STATIC_HEADLESS_ENV: {
+    GDK_BACKEND: string;
+    GDK_DISABLE: string;
+    GDK_DEBUG: string;
+    GSK_RENDERER: string;
+    GTK_A11Y: string;
+    LIBGL_ALWAYS_SOFTWARE: string;
+    GST_GL_WINDOW: string;
+    GSETTINGS_BACKEND: string;
+    ALSOFT_DRIVERS: string;
+    ALSOFT_LOGLEVEL: string;
+};
+export declare const startHeadlessDisplay: (options: HeadlessOptions) => Promise<() => void>;
+//# sourceMappingURL=headless-display.d.ts.map

package/dist/headless-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-display.d.ts","sourceRoot":"","sources":["../src/headless-display.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7C,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,EAAE,YAAY,CAAC;CAC5B,CAAC;AAIF,eAAO,MAAM,sBAAsB,aAAc,OAAO,CAAC,eAAe,CAAC,KAAG,eAG1E,CAAC;AAyFH,eAAO,MAAM,mBAAmB,WAAY,eAAe,KAAG,OAAO,CAAC,eAAe,CAOpF,CAAC;AAkGF,eAAO,MAAM,mBAAmB;IAC5B,WAAW;IACX,WAAW;IACX,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,qBAAqB;IACrB,aAAa;IACb,iBAAiB;IACjB,cAAc;IACd,eAAe;CAClB,CAAC;AAyCF,eAAO,MAAM,oBAAoB,YAAmB,eAAe,KAAG,OAAO,CAAC,MAAM,IAAI,CAsDvF,CAAC"}

package/dist/headless-display.js

@@ -0,0 +1,250 @@
+import { spawn, spawnSync } from "node:child_process";
+import { chmodSync, createWriteStream, existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { Socket } from "node:net";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { startNotificationService } from "./notification-service.js";
+export const DEFAULT_HEADLESS_SIZE = "1024x768";
+const DEFAULT_HEADLESS_COMPOSITOR = "weston";
+export const resolveHeadlessOptions = (provided) => ({
+    size: provided.size ?? DEFAULT_HEADLESS_SIZE,
+    compositor: provided.compositor ?? DEFAULT_HEADLESS_COMPOSITOR,
+});
+const applyEnv = (snapshot, values) => {
+    for (const [name, value] of Object.entries(values)) {
+        if (!(name in snapshot))
+            snapshot[name] = process.env[name];
+        process.env[name] = value;
+    }
+};
+const restoreEnv = (snapshot) => {
+    for (const [name, previous] of Object.entries(snapshot)) {
+        if (previous === undefined)
+            delete process.env[name];
+        else
+            process.env[name] = previous;
+    }
+};
+const spawnWithParentDeathSignal = (command, args, stdio) => {
+    const child = spawn("setpriv", ["--pdeathsig", "SIGKILL", command, ...args], { stdio });
+    child.unref();
+    return child;
+};
+let westonFakeSeatSupport;
+const westonSupportsFakeSeat = () => {
+    if (westonFakeSeatSupport === undefined) {
+        const help = spawnSync("weston", ["--help"], { encoding: "utf8" });
+        westonFakeSeatSupport = `${help.stdout}${help.stderr}`.includes("--fake-seat");
+    }
+    return westonFakeSeatSupport;
+};
+const compositorRegistry = {
+    sway: {
+        socket: "wayland-1",
+        env: {
+            WLR_BACKENDS: "headless",
+            WLR_RENDERER: "pixman",
+            WLR_RENDERER_ALLOW_SOFTWARE: "1",
+            WLR_LIBINPUT_NO_DEVICES: "1",
+            WLR_HEADLESS_OUTPUTS: "1",
+        },
+        start: (runtimeDir, width, height) => {
+            const configPath = join(runtimeDir, "sway.conf");
+            writeFileSync(configPath, [
+                "xwayland disable",
+                "default_border none",
+                "default_floating_border none",
+                `output HEADLESS-1 resolution ${width}x${height}`,
+                "output HEADLESS-1 bg #000000 solid_color",
+                'for_window [app_id=".*"] floating enable, border none',
+                'for_window [title=".*"] floating enable, border none',
+                "",
+            ].join("\n"));
+            return spawnWithParentDeathSignal("sway", ["-c", configPath], ["ignore", "ignore", "pipe"]);
+        },
+    },
+    weston: {
+        socket: "wayland-0",
+        env: {},
+        start: (_runtimeDir, width, height) => spawnWithParentDeathSignal("weston", [
+            "--backend=headless",
+            "--renderer=pixman",
+            ...(westonSupportsFakeSeat() ? ["--fake-seat"] : []),
+            `--width=${width}`,
+            `--height=${height}`,
+            "--socket=wayland-0",
+        ], ["ignore", "ignore", "pipe"]),
+    },
+};
+const isCompositorId = (value) => Object.hasOwn(compositorRegistry, value);
+export const readHeadlessOptions = (params) => {
+    const options = {};
+    const size = params.get("size");
+    if (size !== null)
+        options.size = size;
+    const compositor = params.get("compositor");
+    if (compositor !== null && isCompositorId(compositor))
+        options.compositor = compositor;
+    return options;
+};
+const startCompositor = (runtimeDir, options, env) => {
+    const descriptor = compositorRegistry[options.compositor];
+    const [width = "", height = ""] = options.size.split("x");
+    applyEnv(env, descriptor.env);
+    return { child: descriptor.start(runtimeDir, width, height), socket: descriptor.socket };
+};
+const writeBusConfig = (busConfigPath, busSocketPath) => {
+    writeFileSync(busConfigPath, `<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN" "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
+<busconfig>
+  <type>session</type>
+  <listen>unix:path=${busSocketPath}</listen>
+  <auth>EXTERNAL</auth>
+  <policy context="default">
+    <allow send_destination="*" eavesdrop="true"/>
+    <allow eavesdrop="true"/>
+    <allow own="*"/>
+  </policy>
+</busconfig>`);
+};
+const waitForSocket = (path, { label, timeout = 15000, child, signal }) => new Promise((resolve, reject) => {
+    let log = "";
+    const stderr = child?.stderr ?? null;
+    stderr?.setEncoding("utf8");
+    stderr?.on("data", (chunk) => {
+        log += chunk;
+    });
+    let timer;
+    let poll;
+    const stopListening = () => {
+        clearTimeout(timer);
+        clearInterval(poll);
+        child?.removeListener("exit", onExit);
+        child?.removeListener("error", onError);
+        signal?.removeEventListener("abort", onAbort);
+        stderr?.removeAllListeners("data");
+        stderr?.resume();
+        if (stderr instanceof Socket)
+            stderr.unref();
+    };
+    const onExit = (code, terminationSignal) => {
+        stopListening();
+        reject(new Error(`${label} exited (code ${code ?? "null"}, signal ${terminationSignal ?? "null"}) before ${path} appeared\n${log}`));
+    };
+    const onError = (cause) => {
+        stopListening();
+        reject(new Error(`${label} failed to spawn: ${cause.message}\n${log}`));
+    };
+    const onAbort = () => {
+        stopListening();
+        reject(new Error(`${label} startup aborted before ${path} appeared`));
+    };
+    poll = setInterval(() => {
+        if (existsSync(path)) {
+            stopListening();
+            resolve();
+        }
+    }, 50);
+    timer = setTimeout(() => {
+        stopListening();
+        const suffix = child ? `\n${log}` : "";
+        reject(new Error(`${label} did not become available within ${timeout}ms${suffix}`));
+    }, timeout);
+    child?.on("exit", onExit);
+    child?.on("error", onError);
+    if (signal) {
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        signal.addEventListener("abort", onAbort);
+    }
+});
+export const STATIC_HEADLESS_ENV = {
+    GDK_BACKEND: "wayland",
+    GDK_DISABLE: "vulkan",
+    GDK_DEBUG: "no-vsync",
+    GSK_RENDERER: "cairo",
+    GTK_A11Y: "test",
+    LIBGL_ALWAYS_SOFTWARE: "1",
+    GST_GL_WINDOW: "none",
+    GSETTINGS_BACKEND: "memory",
+    ALSOFT_DRIVERS: "null",
+    ALSOFT_LOGLEVEL: "0",
+};
+const captureCompositorStderr = (child, logPath) => {
+    const captured = [];
+    const stderr = child.stderr;
+    if (stderr !== null) {
+        stderr.setEncoding("utf8");
+        const logStream = createWriteStream(logPath);
+        logStream.on("error", () => { });
+        stderr.on("data", (chunk) => {
+            captured.push(chunk);
+            logStream.write(chunk);
+        });
+    }
+    return captured;
+};
+const reportUnexpectedCompositorExit = (child, capturedStderr) => {
+    if (child.exitCode === null && child.signalCode === null)
+        return;
+    process.stderr.write(`[gtkx] headless compositor died before teardown (code ${child.exitCode ?? "null"}, ` +
+        `signal ${child.signalCode ?? "null"}); the worker's Wayland client was severed.\n${capturedStderr.join("")}`);
+};
+const makeTeardown = (compositor, capturedStderr, stopNotifications, removeRuntime) => {
+    let torndown = false;
+    return () => {
+        if (torndown)
+            return;
+        torndown = true;
+        reportUnexpectedCompositorExit(compositor, capturedStderr);
+        stopNotifications();
+        removeRuntime();
+    };
+};
+export const startHeadlessDisplay = async (options) => {
+    const env = {};
+    const runtimeDir = mkdtempSync(join(tmpdir(), "gtkx-xdg-"));
+    chmodSync(runtimeDir, 0o700);
+    const spawned = [];
+    const removeRuntime = () => {
+        restoreEnv(env);
+        rmSync(runtimeDir, { recursive: true, force: true });
+    };
+    try {
+        applyEnv(env, { XDG_RUNTIME_DIR: runtimeDir });
+        const busConfigPath = join(runtimeDir, "session.conf");
+        const busSocketPath = join(runtimeDir, "bus");
+        writeBusConfig(busConfigPath, busSocketPath);
+        const busChild = spawnWithParentDeathSignal("dbus-daemon", [`--config-file=${busConfigPath}`], ["ignore", "ignore", "pipe"]);
+        spawned.push(busChild);
+        applyEnv(env, { DBUS_SESSION_BUS_ADDRESS: `unix:path=${busSocketPath}` });
+        const compositor = startCompositor(runtimeDir, options, env);
+        spawned.push(compositor.child);
+        applyEnv(env, { WAYLAND_DISPLAY: compositor.socket });
+        const abort = new AbortController();
+        try {
+            await Promise.all([
+                waitForSocket(join(runtimeDir, compositor.socket), {
+                    label: "Compositor",
+                    child: compositor.child,
+                    signal: abort.signal,
+                }),
+                waitForSocket(busSocketPath, { label: "D-Bus session bus", child: busChild, signal: abort.signal }),
+            ]);
+        }
+        finally {
+            abort.abort();
+        }
+        const stopNotifications = await startNotificationService(`unix:path=${busSocketPath}`);
+        const capturedStderr = captureCompositorStderr(compositor.child, join(runtimeDir, "weston.stderr.log"));
+        return makeTeardown(compositor.child, capturedStderr, stopNotifications, removeRuntime);
+    }
+    catch (cause) {
+        for (const child of spawned)
+            child.kill("SIGKILL");
+        removeRuntime();
+        throw cause;
+    }
+};
+//# sourceMappingURL=headless-display.js.map

package/dist/headless-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-display.js","sourceRoot":"","sources":["../src/headless-display.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcess, type StdioOptions, spawn, spawnSync } from \"node:child_process\";\nimport { chmodSync, createWriteStream, existsSync, mkdtempSync, rmSync, writeFileSync } from \"node:fs\";\nimport { Socket } from \"node:net\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { startNotificationService } from \"./notification-service.js\";\n\n/**\n * Wayland compositors that can back a headless display.\n */\nexport type CompositorId = \"sway\" | \"weston\";\n\nexport const DEFAULT_HEADLESS_SIZE = \"1024x768\";\n\n/**\n * Settings for the per-worker headless Wayland display.\n */\nexport type HeadlessOptions = {\n    /** Output resolution as a \"WIDTHxHEIGHT\" string, for example \"1024x768\". */\n    size: string;\n    /** Wayland compositor used to back the headless display. */\n    compositor: CompositorId;\n};\n\nconst DEFAULT_HEADLESS_COMPOSITOR: CompositorId = \"weston\";\n\nexport const resolveHeadlessOptions = (provided: Partial<HeadlessOptions>): HeadlessOptions => ({\n    size: provided.size ?? DEFAULT_HEADLESS_SIZE,\n    compositor: provided.compositor ?? DEFAULT_HEADLESS_COMPOSITOR,\n});\n\ntype EnvSnapshot = { [name: string]: string | undefined };\n\nconst applyEnv = (snapshot: EnvSnapshot, values: { [name: string]: string }): void => {\n    for (const [name, value] of Object.entries(values)) {\n        if (!(name in snapshot)) snapshot[name] = process.env[name];\n        process.env[name] = value;\n    }\n};\n\nconst restoreEnv = (snapshot: EnvSnapshot): void => {\n    for (const [name, previous] of Object.entries(snapshot)) {\n        if (previous === undefined) delete process.env[name];\n        else process.env[name] = previous;\n    }\n};\n\nconst spawnWithParentDeathSignal = (command: string, args: string[], stdio: StdioOptions): ChildProcess => {\n    const child = spawn(\"setpriv\", [\"--pdeathsig\", \"SIGKILL\", command, ...args], { stdio });\n    child.unref();\n    return child;\n};\n\nlet westonFakeSeatSupport: boolean | undefined;\n\nconst westonSupportsFakeSeat = (): boolean => {\n    if (westonFakeSeatSupport === undefined) {\n        const help = spawnSync(\"weston\", [\"--help\"], { encoding: \"utf8\" });\n        westonFakeSeatSupport = `${help.stdout}${help.stderr}`.includes(\"--fake-seat\");\n    }\n    return westonFakeSeatSupport;\n};\n\ntype CompositorDescriptor = {\n    socket: string;\n    env: { [name: string]: string };\n    start: (runtimeDir: string, width: string, height: string) => ChildProcess;\n};\n\nconst compositorRegistry: { [K in CompositorId]: CompositorDescriptor } = {\n    sway: {\n        socket: \"wayland-1\",\n        env: {\n            WLR_BACKENDS: \"headless\",\n            WLR_RENDERER: \"pixman\",\n            WLR_RENDERER_ALLOW_SOFTWARE: \"1\",\n            WLR_LIBINPUT_NO_DEVICES: \"1\",\n            WLR_HEADLESS_OUTPUTS: \"1\",\n        },\n        start: (runtimeDir, width, height) => {\n            const configPath = join(runtimeDir, \"sway.conf\");\n            writeFileSync(\n                configPath,\n                [\n                    \"xwayland disable\",\n                    \"default_border none\",\n                    \"default_floating_border none\",\n                    `output HEADLESS-1 resolution ${width}x${height}`,\n                    \"output HEADLESS-1 bg #000000 solid_color\",\n                    'for_window [app_id=\".*\"] floating enable, border none',\n                    'for_window [title=\".*\"] floating enable, border none',\n                    \"\",\n                ].join(\"\\n\"),\n            );\n            return spawnWithParentDeathSignal(\"sway\", [\"-c\", configPath], [\"ignore\", \"ignore\", \"pipe\"]);\n        },\n    },\n    weston: {\n        socket: \"wayland-0\",\n        env: {},\n        start: (_runtimeDir, width, height) =>\n            spawnWithParentDeathSignal(\n                \"weston\",\n                [\n                    \"--backend=headless\",\n                    \"--renderer=pixman\",\n                    ...(westonSupportsFakeSeat() ? [\"--fake-seat\"] : []),\n                    `--width=${width}`,\n                    `--height=${height}`,\n                    \"--socket=wayland-0\",\n                ],\n                [\"ignore\", \"ignore\", \"pipe\"],\n            ),\n    },\n};\n\nconst isCompositorId = (value: string): value is CompositorId => Object.hasOwn(compositorRegistry, value);\n\nexport const readHeadlessOptions = (params: URLSearchParams): Partial<HeadlessOptions> => {\n    const options: Partial<HeadlessOptions> = {};\n    const size = params.get(\"size\");\n    if (size !== null) options.size = size;\n    const compositor = params.get(\"compositor\");\n    if (compositor !== null && isCompositorId(compositor)) options.compositor = compositor;\n    return options;\n};\n\ntype SpawnedCompositor = {\n    child: ChildProcess;\n    socket: string;\n};\n\nconst startCompositor = (runtimeDir: string, options: HeadlessOptions, env: EnvSnapshot): SpawnedCompositor => {\n    const descriptor = compositorRegistry[options.compositor];\n\n    const [width = \"\", height = \"\"] = options.size.split(\"x\");\n    applyEnv(env, descriptor.env);\n\n    return { child: descriptor.start(runtimeDir, width, height), socket: descriptor.socket };\n};\n\nconst writeBusConfig = (busConfigPath: string, busSocketPath: string): void => {\n    writeFileSync(\n        busConfigPath,\n        `<!DOCTYPE busconfig PUBLIC \"-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN\" \"http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd\">\n<busconfig>\n  <type>session</type>\n  <listen>unix:path=${busSocketPath}</listen>\n  <auth>EXTERNAL</auth>\n  <policy context=\"default\">\n    <allow send_destination=\"*\" eavesdrop=\"true\"/>\n    <allow eavesdrop=\"true\"/>\n    <allow own=\"*\"/>\n  </policy>\n</busconfig>`,\n    );\n};\n\ntype WaitForSocketOptions = {\n    label: string;\n    timeout?: number;\n    child?: ChildProcess;\n    signal?: AbortSignal;\n};\n\nconst waitForSocket = (path: string, { label, timeout = 15000, child, signal }: WaitForSocketOptions): Promise<void> =>\n    new Promise((resolve, reject) => {\n        let log = \"\";\n        const stderr = child?.stderr ?? null;\n        stderr?.setEncoding(\"utf8\");\n        stderr?.on(\"data\", (chunk: string) => {\n            log += chunk;\n        });\n        let timer: ReturnType<typeof setTimeout>;\n        let poll: ReturnType<typeof setInterval>;\n        const stopListening = (): void => {\n            clearTimeout(timer);\n            clearInterval(poll);\n            child?.removeListener(\"exit\", onExit);\n            child?.removeListener(\"error\", onError);\n            signal?.removeEventListener(\"abort\", onAbort);\n            stderr?.removeAllListeners(\"data\");\n            stderr?.resume();\n            if (stderr instanceof Socket) stderr.unref();\n        };\n        const onExit = (code: number | null, terminationSignal: NodeJS.Signals | null): void => {\n            stopListening();\n            reject(\n                new Error(\n                    `${label} exited (code ${code ?? \"null\"}, signal ${terminationSignal ?? \"null\"}) before ${path} appeared\\n${log}`,\n                ),\n            );\n        };\n        const onError = (cause: Error): void => {\n            stopListening();\n            reject(new Error(`${label} failed to spawn: ${cause.message}\\n${log}`));\n        };\n        const onAbort = (): void => {\n            stopListening();\n            reject(new Error(`${label} startup aborted before ${path} appeared`));\n        };\n        poll = setInterval(() => {\n            if (existsSync(path)) {\n                stopListening();\n                resolve();\n            }\n        }, 50);\n        timer = setTimeout(() => {\n            stopListening();\n            const suffix = child ? `\\n${log}` : \"\";\n            reject(new Error(`${label} did not become available within ${timeout}ms${suffix}`));\n        }, timeout);\n        child?.on(\"exit\", onExit);\n        child?.on(\"error\", onError);\n        if (signal) {\n            if (signal.aborted) {\n                onAbort();\n                return;\n            }\n            signal.addEventListener(\"abort\", onAbort);\n        }\n    });\n\nexport const STATIC_HEADLESS_ENV = {\n    GDK_BACKEND: \"wayland\",\n    GDK_DISABLE: \"vulkan\",\n    GDK_DEBUG: \"no-vsync\",\n    GSK_RENDERER: \"cairo\",\n    GTK_A11Y: \"test\",\n    LIBGL_ALWAYS_SOFTWARE: \"1\",\n    GST_GL_WINDOW: \"none\",\n    GSETTINGS_BACKEND: \"memory\",\n    ALSOFT_DRIVERS: \"null\",\n    ALSOFT_LOGLEVEL: \"0\",\n};\n\nconst captureCompositorStderr = (child: ChildProcess, logPath: string): string[] => {\n    const captured: string[] = [];\n    const stderr = child.stderr;\n    if (stderr !== null) {\n        stderr.setEncoding(\"utf8\");\n        const logStream = createWriteStream(logPath);\n        logStream.on(\"error\", () => {});\n        stderr.on(\"data\", (chunk: string) => {\n            captured.push(chunk);\n            logStream.write(chunk);\n        });\n    }\n    return captured;\n};\n\nconst reportUnexpectedCompositorExit = (child: ChildProcess, capturedStderr: string[]): void => {\n    if (child.exitCode === null && child.signalCode === null) return;\n    process.stderr.write(\n        `[gtkx] headless compositor died before teardown (code ${child.exitCode ?? \"null\"}, ` +\n            `signal ${child.signalCode ?? \"null\"}); the worker's Wayland client was severed.\\n${capturedStderr.join(\"\")}`,\n    );\n};\n\nconst makeTeardown = (\n    compositor: ChildProcess,\n    capturedStderr: string[],\n    stopNotifications: () => void,\n    removeRuntime: () => void,\n): (() => void) => {\n    let torndown = false;\n    return (): void => {\n        if (torndown) return;\n        torndown = true;\n        reportUnexpectedCompositorExit(compositor, capturedStderr);\n        stopNotifications();\n        removeRuntime();\n    };\n};\n\nexport const startHeadlessDisplay = async (options: HeadlessOptions): Promise<() => void> => {\n    const env: EnvSnapshot = {};\n    const runtimeDir = mkdtempSync(join(tmpdir(), \"gtkx-xdg-\"));\n    chmodSync(runtimeDir, 0o700);\n    const spawned: ChildProcess[] = [];\n\n    const removeRuntime = (): void => {\n        restoreEnv(env);\n        rmSync(runtimeDir, { recursive: true, force: true });\n    };\n\n    try {\n        applyEnv(env, { XDG_RUNTIME_DIR: runtimeDir });\n\n        const busConfigPath = join(runtimeDir, \"session.conf\");\n        const busSocketPath = join(runtimeDir, \"bus\");\n        writeBusConfig(busConfigPath, busSocketPath);\n\n        const busChild = spawnWithParentDeathSignal(\n            \"dbus-daemon\",\n            [`--config-file=${busConfigPath}`],\n            [\"ignore\", \"ignore\", \"pipe\"],\n        );\n        spawned.push(busChild);\n        applyEnv(env, { DBUS_SESSION_BUS_ADDRESS: `unix:path=${busSocketPath}` });\n\n        const compositor = startCompositor(runtimeDir, options, env);\n        spawned.push(compositor.child);\n\n        applyEnv(env, { WAYLAND_DISPLAY: compositor.socket });\n\n        const abort = new AbortController();\n        try {\n            await Promise.all([\n                waitForSocket(join(runtimeDir, compositor.socket), {\n                    label: \"Compositor\",\n                    child: compositor.child,\n                    signal: abort.signal,\n                }),\n                waitForSocket(busSocketPath, { label: \"D-Bus session bus\", child: busChild, signal: abort.signal }),\n            ]);\n        } finally {\n            abort.abort();\n        }\n\n        const stopNotifications = await startNotificationService(`unix:path=${busSocketPath}`);\n\n        const capturedStderr = captureCompositorStderr(compositor.child, join(runtimeDir, \"weston.stderr.log\"));\n        return makeTeardown(compositor.child, capturedStderr, stopNotifications, removeRuntime);\n    } catch (cause) {\n        for (const child of spawned) child.kill(\"SIGKILL\");\n        removeRuntime();\n        throw cause;\n    }\n};\n"]}

package/dist/index.d.ts

@@ -1,2 +1,20 @@
-export { default } from "./plugin.js";
+import type { Plugin } from "vitest/config";
+import { type CompositorId, type HeadlessOptions } from "./headless-display.js";
+export type { CompositorId, HeadlessOptions };
+export declare const GTKX_INLINE_DEPS: RegExp[];
+/**
+ * Options accepted by the {@link gtkx} Vitest plugin. Every headless display
+ * setting is optional and falls back to a built-in default when omitted.
+ */
+export type GtkxPluginOptions = Partial<HeadlessOptions>;
+/**
+ * Vitest plugin that runs each test worker against its own isolated headless
+ * Wayland display. It configures the forks pool, injects the worker preload and
+ * setup files, and sets the environment needed for headless GTK4 rendering.
+ *
+ * @param options Headless display settings (size, compositor) forwarded to each worker.
+ * @returns A Vitest config plugin.
+ */
+declare const gtkx: (options?: GtkxPluginOptions) => Plugin;
+export default gtkx;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAuB,MAAM,uBAAuB,CAAC;AAErG,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AAE9C,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAA8C,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAqBzD;;;;;;;GAOG;AACH,QAAA,MAAM,IAAI,aAAa,iBAAiB,KAAQ,MAqB1C,CAAC;eAEQ,IAAI"}

package/dist/index.js

@@ -1,2 +1,54 @@
-export { default } from "./plugin.js";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import createConfigPlugin from "@gtkx/config/vite-plugin";
+import { STATIC_HEADLESS_ENV } from "./headless-display.js";
+export const GTKX_INLINE_DEPS = [/@gtkx\/(?!native)/, /[/\\]\.gtkx[/\\]/];
+const workerPreloadUrl = () => {
+    const sibling = join(import.meta.dirname, "worker-preload.js");
+    const path = existsSync(sibling) ? sibling : join(import.meta.dirname, "..", "dist", "worker-preload.js");
+    return pathToFileURL(path);
+};
+const headlessPreloadSpecifier = (options) => {
+    const url = workerPreloadUrl();
+    for (const [key, value] of Object.entries(options)) {
+        if (value !== undefined)
+            url.searchParams.set(key, value);
+    }
+    return url.href;
+};
+const workerSetupPath = () => {
+    const sibling = join(import.meta.dirname, "worker-setup.js");
+    return existsSync(sibling) ? sibling : join(import.meta.dirname, "..", "dist", "worker-setup.js");
+};
+/**
+ * Vitest plugin that runs each test worker against its own isolated headless
+ * Wayland display. It configures the forks pool, injects the worker preload and
+ * setup files, and sets the environment needed for headless GTK4 rendering.
+ *
+ * @param options Headless display settings (size, compositor) forwarded to each worker.
+ * @returns A Vitest config plugin.
+ */
+const gtkx = (options = {}) => createConfigPlugin({
+    name: "gtkx:vitest",
+    config() {
+        return {
+            test: {
+                globals: true,
+                execArgv: ["--import", headlessPreloadSpecifier(options)],
+                setupFiles: [workerSetupPath()],
+                testTimeout: 30000,
+                hookTimeout: 30000,
+                pool: "forks",
+                env: STATIC_HEADLESS_ENV,
+                server: {
+                    deps: {
+                        inline: GTKX_INLINE_DEPS,
+                    },
+                },
+            },
+        };
+    },
+});
+export default gtkx;
 //# sourceMappingURL=index.js.map