@gtkx/vitest 0.11.0 → 0.12.0

package/dist/plugin.d.ts

@@ -1,3 +1,22 @@
 import type { Plugin } from "vitest/config";
+/**
+ * Creates the GTKX Vitest plugin for running GTK tests.
+ *
+ * Manages Xvfb virtual display instances for headless GTK testing.
+ * Each worker thread gets its own display to avoid interference.
+ *
+ * @returns Vitest plugin configuration
+ *
+ * @example
+ * ```ts
+ * // vitest.config.ts
+ * import { defineConfig } from "vitest/config";
+ * import gtkx from "@gtkx/vitest";
+ *
+ * export default defineConfig({
+ *   plugins: [gtkx()],
+ * });
+ * ```
+ */
 declare const gtkx: () => Plugin;
 export default gtkx;

package/dist/plugin.js

@@ -2,7 +2,8 @@ import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { availableParallelism, tmpdir } from "node:os";
 import { join } from "node:path";
-const getStateDir = () => join(tmpdir(), `gtkx-vitest-${process.pid}`);
+const getRuntimeDir = () => process.env.XDG_RUNTIME_DIR ?? tmpdir();
+const getStateDir = () => join(getRuntimeDir(), `gtkx-vitest-${process.pid}`);
 const getBaseDisplay = () => {
     const slot = process.pid % 500;
     return 50 + slot * 10;
@@ -36,6 +37,25 @@ const startXvfb = async (display) => {
     }
     return xvfb;
 };
+/**
+ * Creates the GTKX Vitest plugin for running GTK tests.
+ *
+ * Manages Xvfb virtual display instances for headless GTK testing.
+ * Each worker thread gets its own display to avoid interference.
+ *
+ * @returns Vitest plugin configuration
+ *
+ * @example
+ * ```ts
+ * // vitest.config.ts
+ * import { defineConfig } from "vitest/config";
+ * import gtkx from "@gtkx/vitest";
+ *
+ * export default defineConfig({
+ *   plugins: [gtkx()],
+ * });
+ * ```
+ */
 const gtkx = () => {
     const workerSetupPath = join(import.meta.dirname, "setup.js");
     const stateDir = getStateDir();

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@gtkx/vitest",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Vitest plugin for GTKX applications with Xvfb display isolation",
   "keywords": [
+    "gtkx",
     "gtk",
     "gtk4",
     "vitest",
     "testing",
-    "xvfb"
+    "plugin",
+    "xvfb",
+    "linux",
+    "desktop"
   ],
   "homepage": "https://eugeniodepalo.github.io/gtkx",
   "bugs": {